fof / rich-text
Rich Text Editor for Flarum
Fund package maintenance!
Website
Installs: 16
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Language:JavaScript
Type:flarum-extension
pkg:composer/fof/rich-text
Requires
- php: ^8.1
- flarum/core: ^1.8.3
- flarum/markdown: ^1.2.0
Replaces
README
A Flarum extension. Fully integrated Rich Text Editor for Flarum.
Installation
Install manually with composer:
composer require fof/rich-text:*
Updating
composer update fof/rich-text
FAQ
Is it a bundled extension?
No. This extension is published and maintained by the Friends of Flarum community. The editor driver is part of Flarum's public API, and the editor implementations are mostly pure JS, so it shouldn't experience issues with Flarum updates for the foreseeable future.
What does it support?
By default, everything from https://s9etextformatter.readthedocs.io/Plugins/Litedown/Syntax/ except indented codeblocks and lines under headers. The tables and checklists extensions add support for https://s9etextformatter.readthedocs.io/Plugins/PipeTables/Syntax/ (currently not for compact tables) and https://s9etextformatter.readthedocs.io/Plugins/TaskLists/Synopsis/.
BBCodes will not be WYSIWYD'ed. However, symbols used for them shouldn't be escaped so you should still be able to use them.
What's it written in?
It's based on the excellent ProseMirror editor framework.
Is it extensible?
Yes! The markdown tables and tasklists extensions are meant as a proof of concept of how flexible it is. However, ProseMirror is quite challenging to work with, so these kinds of extensions are quite advanced.
If you're interested in extending it and are very familiar with JS, feel free to open an issue or discussion on our GitHub repository.
Does it work with mentions, emoji, and fof upload?
Yes.
Can users opt out?
Yes, on their settings page there's a preference. You can also enable a setting in the admin dashboard that will add a toggle directly to the editor.
Are there any cons?
This extension has substantial bundle size, about 350kb minified (gzipped will be smaller). For most (especially nontechnical) communities this will be worth it, for others, it might not be. We are looking into code splitting opportunities to reduce the TTFB impact, but that is quite challenging and will likely take a while. Note that this is still considerably less than Flarum competitors.