README

This is a simple but intuitive emoji picker for Flarum 1.x and 2.x.

About this fork: This is a fork of the-turk/flarum-flamoji (originally by Hasan Özbey). This fork is published as pianotell/flarum-ext-flamoji and was originally created for 🎹 Piano | Tell, but now available to all. It has substantial changes from the original including replacing emoji-button with emoji-mart. All credit for the original extension belongs to the original author.

Screenshot:

Features

• Built on emoji-mart (Missive, MIT). Originally based on joeattardi/emoji-button — migrated in this fork after the upstream picker was archived.
• Add an emoji picker to the text editor (compatible with dark mode).
• Picker style is configurable — choose Twemoji glyphs (sourced from a jsDelivr-hosted spritesheet) or your operating system's native emoji font, or leave the picker on Auto to mirror what posts actually display (Twemoji when flarum/emoji is enabled, native otherwise).
• Add custom emojis to the picker.
• Organize custom emojis into named categories — assign each a freeform category and it gets its own tab in the picker.
• Sticker mode — an optional admin toggle that renders custom emojis as large stickers in posts, the composer preview, and the picker.
• Import and export custom emoji configurations.
• Picker code and emoji data load lazily on first open (no impact on initial page load); when Twemoji is selected, the image spritesheet is fetched from jsDelivr on first picker render. Native mode adds zero image bytes.

Installation

composer require pianotell/flarum-ext-flamoji
php flarum extension:enable pianotell-flamoji

Updating

composer update pianotell/flarum-ext-flamoji
php flarum migrate
php flarum assets:publish
php flarum cache:clear

Links

• Source code on GitHub
• Changelog
• Report an issue
• Download via Packagist
• Original project