kvothe / tag-hero-backgrounds
Allows you to set a background for each individual tag hero.
Package info
github.com/oaklinq/tag-hero-backgrounds
Type:flarum-extension
pkg:composer/kvothe/tag-hero-backgrounds
v1.0.2
2026-11-15 17:03 UTC
Requires
- flarum/core: ^2.0.0-beta
- flarum/tags: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-15 17:03:46 UTC
README
A Flarum extension. Allows you to set a background for each individual tag hero.
Features
- Upload one background image per tag in the admin panel: Tags → edit a tag → Hero Background.
- The image is shown behind the tag's hero and the hero of discussions whose first tag has it.
- Uploads may be JPEG, PNG, BMP, GIF or WebP files up to 10 MB. They are converted to WebP; animated images are kept as GIF.
- Replacing or removing a background, or deleting its tag, also deletes the image file.
The tag's color stays visible while the image loads and through transparent parts of it.
Settings
The extension's settings page controls how the text stands out on heroes that have a background image. Heroes without an image are not affected.
| Setting | Default | Description |
|---|---|---|
| Overlay color | #000000 |
Color laid over the image. |
| Overlay opacity | 40 |
Strength of the overlay in percent. 0 turns it off. |
| Text shadow | Soft | None, soft or strong. |
| Text shadow color | #000000 |
Color of the text shadow. |
| Text color | Light | Light, dark, or automatic based on the tag color. |
Installation
Install with composer:
composer require kvothe/tag-hero-backgrounds:"*"
php flarum migrate
php flarum cache:clear
Updating
composer update kvothe/tag-hero-backgrounds php flarum migrate php flarum cache:clear