An emoji/smileys pack for phpBB 3.X, using the free Twemoji SVG files from Twitter (https://twemoji.twitter.com/)

Gwyneth Llewelyn 36daedf19f Added the missing license & instructions. 3 years ago
twemoji-pack b75cefcc75 Starting the long process of cleaning up short names (the rest is being done on MySQL) 3 years ago
.gitignore 9a48a6ba51 First commit 3 years ago
LICENSE.md 830600fb45 Fixed a few Markdown issues 3 years ago
README.md 36daedf19f Added the missing license & instructions. 3 years ago
emoji-test.txt 9a48a6ba51 First commit 3 years ago

README.md

Twemoji pack for phpBB 3+

This is basically just the full collection of Twemoji icons from Twitter, all of which are free to distribute under the following license:

Copyright 2020 Twitter, Inc and other contributors

Code licensed under the MIT License: https://opensource.org/licenses/MIT

Graphics licensed under CC-BY 4.0: https://creativecommons.org/licenses/by/4.0/

The Unicode organisation keeps a list of official Unicode Emojis and names.

Basically, the work I've done was to sync the filenames with the Emoji names with their 'shortnames', which phpBB3 understands (at least, most of them; the list was last updated on 2017 and there are a few hundreds more). Believe me, I thought that this would be far easier — it took me days and practically had to change one by one, using both complex regular expressions and database queries. But... I did it! 😄 Now you can enjoy them all on phpBB3, too!

I've selected vector graphics (SVG) because they are about the same size in bytes as the equivalent high-quality PNGs, and, of course, are infinitely scalable without the least loss of quality. If you really prefer PNGs, you can always download them from Twitter's Twemoji site and do a search & replace on the twemoji.pak file, replacing .svg with .png. Done!

Released publicly under a MIT license.

Installation

As far as I know, all you need to do is to unpack all these files somewhere, and copy them all (including the twemoji.pak) into the images/smilies directory and then, on the ACP, go to Posting > Messages > Smilies and select Install smilies package — you should see twemoji.pak as an option, just click to install.

If you don't have that option, there is also a way to install them by writing directly to the phpBB3 database 😏 but I won't tell you how to do that...