Alias HTML elements to other tags
Usually, HTML is meant to be presented to the user as-is. However, sometimes you may want to alias HTML elements and HTML attributes to other tags and attributes. Here is a concrete example: let's say you want to limit the number of links to 3 per text but users can post links many different ways via the [url]
BBCode, as an <a href>
element or even in plain text, letting the Autolink plugin linkify them. Your solution is to use the same tag for the 3 different plugins.
In the following example, we configure the HTMLElements plugin to alias <a href>
to use the same tag as the BBCodes and Autolink plugins. Then we see that despite using 3 different syntaxes, only the first 3 URLs are linked.
$configurator = new s9e\TextFormatter\Configurator;
// The [url] BBCode uses a tag named "URL" with an attribute of the same name
$configurator->BBCodes->addFromRepository('URL');
$configurator->Autolink;
// <a> will use the "URL" tag
$configurator->HTMLElements->aliasElement('a', 'URL');
// The "href" attribute will use the "url" attribute
$configurator->HTMLElements->aliasAttribute('a', 'href', 'url');
// Limit the number of URL tags to 3
$configurator->tags['URL']->tagLimit = 3;
// Get an instance of the parser and the renderer
extract($configurator->finalize());
$text = 'http://example.org/1
[url=http://example.org/2]Second link[/url]
<a href="http://example.org/3">The third and last</a>
<a href="http://example.org/4">This one will not be linkified</a>';
$xml = $parser->parse($text);
$html = $renderer->render($xml);
echo $html;
<a href="http://example.org/1">http://example.org/1</a>
<a href="http://example.org/2">Second link</a>
<a href="http://example.org/3">The third and last</a>
<a href="http://example.org/4">This one will not be linkified</a>