README

Self hosted Twemoji images

Description

Local Twemoji is a WordPress plugin to serve fallback emoji images from your own site URL rather than the WordPress.org CDN.

The purpose of this plugin is to aid sites served over a CDN as browsers now cache requests on a per site basis rather than globally.

The effect of this is that the WordPress.org CDN's splat image is treated as two different images if downloaded from site-one.example and site-two.example. You can read more about this in the Chrome post on cache partitioning.

For sites served over a CDN, downloading the image from your own URL will be quicker as it reduces the number of servers the visitor's browser needs to connect to.

WordPress version support

A new version of Twemoji is released each time the emoji are added to the Unicode specification, each major version bump of Twemoji will contain new images.

To avoid the risk of serving broken images to your visitors, this plugin should be kept up to date.

• WordPress 6.9 requires Local Twemoji 1.3.1 or later
• Earlier versions of WordPress require Local Twemoji 1.1.0 or later

Installation

Local Twemoji can be installed via the following methods.

Composer

composer require peterwilsoncc/local-twemoji

Downloads

• Via WordPress.org
• Via GitHub

Licenses

The plugin code is licensed under the MIT License.

The Emoji SVG and PNG assets are licensed under the CC-BY 4.0 License. Copyright Twitter Inc. and other contributors.