README

This bundle allows you to replace emojis on a web page with emojis from the Twitter Emojis library (Twemoji). Usually, the emojis used come from your system and they are different from one system to another.

Based on Avris\Twemoji.

Note

Since 2023, @jdecked no longer works for Twitter but continues to maintain the package on Jdecked/Twemoji. To get the most up-to-date emojis, we use the latest version of the CDN by default.

What is Twemoji ?

Twemoji is a great way to make emoji's on your website independent of system and browser (old repository).

Unless you just use this library to replace emojis with <img> tags in your backend.

Note: it will, of course, increase the server response time (instead removing a flash of system emojis before JS loads). Therefore, it's better suited for generated static websites or HTTP cached requests.

Installation

1. To install this bundle, run the following Composer command :

composer require pyrrah/twemoji

1. If you're using Symfony with autowiring, just register the service(s) :

# config/services.yaml
  Pyrrah\Twemoji\TwemojiService: ~
  Pyrrah\Twemoji\TwemojiExtension: ~

Usage

In your controller :

$twemoji->replace('Hello! 👋');
// Hello! <img draggable="false" class="emoji" alt="👋" src="https://cdn.jsdelivr.net/gh/jdecked/twemoji@latest/assets/svg/1f44b.svg">

Using Twig:

{% filter twemoji %}
  <p>
      Hello! 👋
  </p>
{% endfilter %}

yourBestVar|twemoji

Tests

vendor/bin/phpunit

Credits

• Pierre-Yves Dick
• Andrea Prusinowski
• All Contributors

License

This bundle is under the MIT license. For the full copyright and license information please view the License File that was distributed with this source code.