Emoji are ideograms and smileys standardized by the Unicode Consortium. The Emoji plugin renders them as images using Twemoji assets. Please consult the Twemoji website for license terms and attribution requirements.

Examples

Using the default set

$configurator = new s9e\TextFormatter\Configurator;
$configurator->Emoji;

// Get an instance of the parser and the renderer
extract($configurator->finalize());

$text = 'Hello world 😀';
$xml  = $parser->parse($text);
$html = $renderer->render($xml);

echo $html;
Hello world <img alt="😀" class="emoji" draggable="false" src="https://twemoji.maxcdn.com/2/svg/1f600.svg">

Using JoyPixels

Check out JoyPixels's website for license and attribution requirements.

$configurator = new s9e\TextFormatter\Configurator;

$tag = $configurator->Emoji->getTag();
$tag->template = '<img src="https://cdn.jsdelivr.net/gh/joypixels/emoji-assets@master/png/64/{@seq}.png">';

// Get an instance of the parser and the renderer
extract($configurator->finalize());

$text = '😍 JoyPixels';
$xml  = $parser->parse($text);
$html = $renderer->render($xml);

echo $html;
<img src="https://cdn.jsdelivr.net/gh/joypixels/emoji-assets@master/png/64/1f60d.png"> JoyPixels

Inputting emoji as codepoints

In some cases, it may be desirable to input emoji as a sequence of codepoints instead of Unicode characters. Codepoints must be expressed in lowercase hexadecimal and be separated by a single dash. For example: :1f44b-1f3fb:. For compatibility with Twemoji, the fully-qualified sequence using zero-width joiners and variation selectors 16 should be used.

$configurator = new s9e\TextFormatter\Configurator;
$configurator->Emoji;

// Get an instance of the parser and the renderer
extract($configurator->finalize());

$text = 'Hello world :1f937-1f3fe-200d-2640-fe0f:';
$xml  = $parser->parse($text);
$html = $renderer->render($xml);

echo $html;
Hello world <img alt=":1f937-1f3fe-200d-2640-fe0f:" class="emoji" draggable="false" src="https://twemoji.maxcdn.com/2/svg/1f937-1f3fe-200d-2640-fe0f.svg">