shortcodes Tomasz Kowalczyk / @tmmx supercharge your views with 

No content

[ introduction ] 

[image src=”...” /] [post title=”Article” width=600] [related items=2 /] [quote=”Tommy”] Hi! [/quote] [footer] 

UBB phpBB WordPress 

dynamic content 

[ challenges ] 

regex vs parser regex approach has several constraints 

proper nesting possible only with dedicated parser 

alternate syntax take into account all shortcode variants 

performance very important for high load applications 

Shortcode say hello to 

open source, MIT license over 130k downloads over 9000 monthly ~200 GitHub stars 

No content

composer require thunderer/shortcode=^0.6.5 

$handlers = new HandlerContainer(); $handlers->add('b', function(ShortcodeInterface $s) { return ''.$s->getContent().''; }); $parser = new RegularParser(); $processor = new Processor($handlers, $parser); $text = 'My name is Bold. Text [b]Bold[/b].'; $result = $processor->process($text); // My name is Bold. Text Bold. 

complete README with code examples 

No content

No content

No content

multiple parsers i want you to have the power to choose 

$wordpress = new WordpressParser(); $regex = new RegexParser(); $regular = new RegularParser(); 

custom syntax can handle virtually all known variants 

$syntax = new Syntax('[[', ']]', '//', '==', '""'); $parser = new RegexParser($syntax); $processor = new Processor($handlers, $parser); $text = 'My name is Bold. Text [[b]]Bold[[//b]].'; $result = $processor->process($text); 

events subsystem altering the text processing flow 

FilterShortcodesEvent ReplaceShortcodesEvent FilterRawEventHandler ReplaceJoinEventHandler 

$eventHandler = function(FilterShortcodesEvent $event) { $p = $event->getParent(); if($p && ($p->getName() === 'raw' || $p->hasAncestor('raw'))) { $event->setShortcodes([]); } }; $events = new EventContainer(); $events->addListener(Events::FILTER_SHORTCODES, $eventHandler); $processor = new Processor(new RegularParser(), new HandlerContainer()); $processor = $processor->withEventContainer($events); assert(' [name /] ' === $processor->process('[raw] [name /] [/raw]')); 

built-in handlers no need to reinvent the wheel 

NameHandler ContentHandler RawHandler NullHandler DeclareHandler EmailHandler PlaceholderHandler SerializerHandler UrlHandler WrapHandler 

extensible interface for every abstraction 

HandlerContainerInterface ParserInterface ProcessorInterface SerializerInterface ShortcodeInterface SyntaxInterface 

easy to integrate framework agnostic, transparent implementation 

final class ShortcodeTwigExtension extends \Twig_Extension { public function getFilters() { return [new \Twig_SimpleFilter('shortcode', [$this, 'processShortcodes'])]; } public function processShortcodes($text) { $handlers = new HandlerContainer(); $handlers->add('b', new WrapHandler('', '')); $parser = new RegularParser(); $processor = new Processor($handlers, $parser); return $processor->process($text); } } 

// template.html.twig {% block content %} {{ article.content|shortcode }} {% endblock %} 

[ summary ] 

[ questions? ] Packagist thunderer/shortcode Twitter @tmmx GitHub /thunderer 

Resources: https://github.com/thunderer/Shortcode (github) https://en.wikipedia.org/wiki/BBCode https://codex.wordpress.org/Shortcode Pictures (Creative Commons): https://www.flickr.com/photos/x1brett/9493399534 (bg) 

Thanks! Packagist thunderer/shortcode Twitter @tmmx GitHub /thunderer