README

Stickers

Stickers for Flarum posts, animated ones included.

Stickers brings a sticker picker to the post composer. Upload your library in the admin panel, organize it in categories, and your users drop stickers into posts with one click. Each sticker also gets a text code like :smile: that is rewritten when the post renders.

The fun part is animation support. Lottie JSON and Telegram TGS files play natively in posts, right alongside plain PNG, GIF, WebP, APNG and JPEG.

What it does

• Floating sticker picker in the composer toolbar
• Categories with drag and drop ordering
• Native playback of Lottie and TGS animations via lottie-web
• Bulk upload by dropping several files at once
• Export of the whole library as a ZIP, importable on another forum with duplicates skipped
• Optional hover only mode that keeps animations paused until the cursor is on them
• Works on Flarum 1.8 and 2.x

Installation

composer require ramon/stickers
php flarum migrate
php flarum assets:publish
php flarum cache:clear

Then enable Stickers on the Extensions page and start uploading.

About TGS files

TGS support is a technical format feature, nothing more. Telegram sticker packs belong to their authors, so only upload packs you made, have permission to redistribute, or that carry a license allowing it. That responsibility sits with the forum administrator.

License

MIT. Bugs and suggestions go in the issue tracker.