Emoji for NodeBB
Adds extensible emoji functionality to NodeBB
- Multiple sets of emoji available for use
- Intelligent auto-completion while composing posts and chat messages
- Ability to convert common emoticons like
- Convenient dialog to view and insert all available emoji
- First-party support for custom emoji (available in the ACP)
For best results, install
nodebb-plugin-emoji and emoji packs through the NodeBB Admin Panel.
The following emoji packs are known to be compatible with
To add custom emoji, visit the Emoji ACP page and click on the pencil button in the bottom left.
In version two of the emoji plugin, a completely new API is now used to create emoji sets. Now, an emoji set defines its emojis via a hook that is emoitted by the emoji plugin when a build of emoji assets is run.
To use this, you must listen for the hook by adding it to
plugin.json like so:
And then providing the
defineEmoji function in your library file (
In the above case, we define the emoji pack "My Emoji Pack" and one emoji:
custom which has an alias of
personalized, with an image named
custom.png in the
emoji directory. For full documentation, I suggest going to the interface definitions for
On an emoji build, initiated either on first install of the plugin or through the plugin ACP page, the emoji plugin will fire that hook and gather all emoji packs, then process them to produce metadata files it uses on the client side.
nodebb-plugin-emoji is not available through the ACP, you can install it manually with NPM
npm install nodebb-plugin-emoji