Download the PHP package ernestdefoe/tag-covers without Composer
On this page you can find all versions of the php package ernestdefoe/tag-covers. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ernestdefoe/tag-covers
More information about ernestdefoe/tag-covers
Files in ernestdefoe/tag-covers
Package tag-covers
Short Description Cover images for Flarum tags — upload a cover per tag and use it anywhere a tag is rendered as a card.
License MIT
Informations about the package tag-covers
Tag Covers
Give every Flarum tag a cover image and a logo. Upload them in the tag's own edit dialog, and they show up anywhere a tag is drawn as a card.
- A cover image per tag. Landscape works best, around 1200×480. It runs as a band across the top of the tag's tile on
/tags. - A logo per tag. A crest or mark, square works best and a transparent PNG sits on any colour. It replaces the icon on the tag's tile and appears inside the tag's label wherever one is shown: a discussion's header, a list row, a search result.
- Picked where you edit the tag. Admin → Tags → click a tag → Cover image or Logo. A brand-new tag can have its images chosen in the same dialog that creates it; they upload as soon as the tag is saved.
- Small files. PNG, JPEG, WebP or GIF up to 8MB, re-encoded to WebP (covers to at most 1200px wide, logos to 256px), so a 2MB upload from an image generator lands as roughly 100KB.
- Stock tiles stay stock. A tag with neither image keeps Flarum's own tile, untouched.
Settings
There are none. Everything is set per tag, in the tag's edit dialog under Admin → Tags.
For themes
Each tag gains coverUrl and logoUrl attributes on the API, and the forum
publishes every tag's images as custom properties:
They are set on:
[data-tag-cover="<slug>"], which also paints the cover as a background[data-tag-vars="<slug>"], which only declares the properties and paints nothing, for an element that wants the logo or cover as a background of its own choosing- a
.TagTilefor the tag - a
.BespokeForumcard or.BespokeForum-subchip for the tag (Bespoke) - a Page Builder tag card (
a.PB-tagCard) for the tag
[data-tag-logo] paints --tag-logo with background-size: contain, so a
crest is never cropped.
So a card only has to read the property:
Nothing here knows what a card looks like, which is why the extension does not depend on any particular theme.
Good to know
- Every tag, not just the ones loaded. The images for all tags are sent with the page in one small query, so a team tag's crest appears even on a page that never loaded that tag.
- Files live on the
flarum-assetsdisk beside the logo and favicon, namedtag-cover-<tagId>-<random>.webpandtag-logo-<tagId>-<random>.webp. - No orphaned files. Removing or replacing an image sweeps every file of that kind for the tag by filename, rather than trusting the path in the database, so an upload that failed halfway cannot leave a file nothing points at.
- Requires Flarum 2,
flarum/tagsand PHP 8.3.
Installation
Then enable Tag Covers in the admin panel.
Updating
Licence
MIT.