linkrobins / html-widget
HTML widget for fof/forum-widgets-core
Package info
github.com/linkrobins/html-widget
Language:JavaScript
Type:flarum-extension
pkg:composer/linkrobins/html-widget
Requires
- php: ^8.3
- flarum/core: ^2.0
- fof/forum-widgets-core: ^2.0.0-beta.3
README
A simple HTML widget for Flarum 2.0, built as a widget for fof/forum-widgets-core. Same skeleton as linkrobins/shoutbox.
What it does
Adds one configurable HTML widget to the FoF Forum Widgets placement editor. Admin sets:
- Title — optional, shown above the body
- Icon — FontAwesome class (e.g.
fas fa-bullhorn) - HTML body — rendered as HTML, sanitised before display
Drag and place it from the FoF Forum Widgets admin page like any other widget.
Requirements
- Flarum 2.0 or later
fof/forum-widgets-coreinstalled and enabled
The HTML sanitiser (DOMPurify) is bundled into the extension — nothing is fetched from a CDN at runtime.
Installation
composer require linkrobins/html-widget
php flarum cache:clear
In Flarum admin → Extensions, find Link Robins HTML Widget under the Forum Widgets category and enable it. Configure title/icon/body, then go to FoF Forum Widgets settings and place it where you want it.
Security note
The HTML body is passed through DOMPurify before display, so <script> tags, event-handler attributes, javascript: URLs, and unsafe elements such as <iframe> are stripped. The body is still admin-only — treat it like any other admin-controlled content.
License
MIT