PHPackages                             pianotell/flarum-ext-flamoji - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. pianotell/flarum-ext-flamoji

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

pianotell/flarum-ext-flamoji
============================

Simple emoji manager for Flarum. Fork of the-turk/flarum-flamoji, originally created for PianoTell, but now available to all.

v2.4.0(3w ago)21.2k—8.7%2MITJavaScriptPHP ^8.3

Since Jul 14Pushed 3w agoCompare

[ Source](https://github.com/PrimateCoder/flarum-flamoji)[ Packagist](https://packagist.org/packages/pianotell/flarum-ext-flamoji)[ RSS](/packages/pianotell-flarum-ext-flamoji/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (4)Versions (17)Used By (0)

Flamoji
=======

[](#flamoji)

[![MIT license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/PrimateCoder/flarum-flamoji/blob/master/LICENSE) [![Latest Stable Version](https://camo.githubusercontent.com/e49abc810d85ea445cfe37a9f14bb8726ff21cf5ebd533e2b9bbb0cfa6fe50dc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7069616e6f74656c6c2f666c6172756d2d6578742d666c616d6f6a692e737667)](https://packagist.org/packages/pianotell/flarum-ext-flamoji) [![Total Downloads](https://camo.githubusercontent.com/7d7b08810ff8263ff2e8ca2482ed42e9c52be64fca1177245d8bd83c901c26bf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7069616e6f74656c6c2f666c6172756d2d6578742d666c616d6f6a692e737667)](https://packagist.org/packages/pianotell/flarum-ext-flamoji)

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`](https://discuss.flarum.org/d/28095-flamoji) (originally by [Hasan Özbey](https://github.com/the-turk)). This fork is published as [`pianotell/flarum-ext-flamoji`](https://github.com/PrimateCoder/flarum-flamoji) and was originally created for [🎹 Piano | Tell](https://pianotell.com), but now available to all. It has substantial changes from the original including replacing [emoji-button](https://github.com/joeattardi/emoji-button) with [emoji-mart](https://github.com/missive/emoji-mart). All credit for the original extension belongs to the original author.

Screenshot:

[![Picker](https://raw.githubusercontent.com/PrimateCoder/flarum-flamoji/main/docs/screenshots/picker.png)](https://raw.githubusercontent.com/PrimateCoder/flarum-flamoji/main/docs/screenshots/picker.png)

Sticker mode — custom emojis organized into categories and rendered large in posts:

[![Sticker mode](https://raw.githubusercontent.com/PrimateCoder/flarum-flamoji/main/docs/screenshots/sticker-mode.png)](https://raw.githubusercontent.com/PrimateCoder/flarum-flamoji/main/docs/screenshots/sticker-mode.png)

Features
--------

[](#features)

- Built on [emoji-mart](https://github.com/missive/emoji-mart) (Missive, MIT). Originally based on [joeattardi/emoji-button](https://github.com/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](https://github.com/jdecked/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`](https://github.com/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. Each category is also exposed on rendered emoji so you can style them per category from your own CSS (see [Styling emojis by category](#styling-emojis-by-category)).
- **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
------------

[](#installation)

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

Updating
--------

[](#updating)

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

Styling emojis by category
--------------------------

[](#styling-emojis-by-category)

Custom emojis render with their category on the wrapping `` as a `data-flamoji-category` attribute (the exact category name you set in the admin panel). This lets you size or style emojis per category from your own theme/CSS — for example, to make everything in a "Stickers" category larger:

```
span.flamoji[data-flamoji-category="Stickers"] img {
  height: 35px;
  vertical-align: bottom;
}
```

Uncategorized emojis render as plain `` with no attribute, so they're unaffected.

Links
-----

[](#links)

- [Source code on GitHub](https://github.com/PrimateCoder/flarum-flamoji)
- [Changelog](https://github.com/PrimateCoder/flarum-flamoji/blob/main/CHANGELOG.md)
- [Report an issue](https://github.com/PrimateCoder/flarum-flamoji/issues)
- [Download via Packagist](https://packagist.org/packages/pianotell/flarum-ext-flamoji)
- [Original project](https://discuss.flarum.org/d/28095-flamoji)

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance95

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

15

Last Release

24d ago

Major Versions

v0.1.0 → v2.0.0-alpha.12026-04-24

v1.1.0 → v2.1.02026-05-04

v1.3.0 → v2.4.02026-07-01

PHP version history (2 changes)v0.1.0PHP >=8.1

v2.0.0-alpha.1PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1000312?v=4)[Navindra](/maintainers/navindra)[@navindra](https://github.com/navindra)

---

Top Contributors

[![PrimateCoder](https://avatars.githubusercontent.com/u/58794586?v=4)](https://github.com/PrimateCoder "PrimateCoder (35 commits)")[![iamdarkle](https://avatars.githubusercontent.com/u/15818451?v=4)](https://github.com/iamdarkle "iamdarkle (5 commits)")[![hasan-ozbey](https://avatars.githubusercontent.com/u/48382593?v=4)](https://github.com/hasan-ozbey "hasan-ozbey (3 commits)")[![AlexDicy](https://avatars.githubusercontent.com/u/11839341?v=4)](https://github.com/AlexDicy "AlexDicy (1 commits)")[![huoxin233](https://avatars.githubusercontent.com/u/23447157?v=4)](https://github.com/huoxin233 "huoxin233 (1 commits)")

---

Tags

pickeremojiflarum

### Embed Badge

![Health badge](/badges/pianotell-flarum-ext-flamoji/health.svg)

```
[![Health](https://phpackages.com/badges/pianotell-flarum-ext-flamoji/health.svg)](https://phpackages.com/packages/pianotell-flarum-ext-flamoji)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k14](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k7](/packages/fof-discussion-language)[fof/gamification

Upvotes and downvotes for your Flarum community

4166.1k10](/packages/fof-gamification)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/best-answer

Mark a post as the best answer in a discussion

25154.0k22](/packages/fof-best-answer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)