Search by

kvothe / tag-hero-backgrounds

Kvothe

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

Statistics

Installs: 8

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.2 2026-11-15 17:03 UTC

This package is auto-updated.

Last update: 2026-11-15 17:03:46 UTC


README

License Latest Stable Version Total Downloads

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

Links