PHPackages                             vadkuz/flarum2-tag-favicon-and-file - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. vadkuz/flarum2-tag-favicon-and-file

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

vadkuz/flarum2-tag-favicon-and-file
===================================

Adds favicon URL support for tag/category icons as an alternative to Font Awesome classes.

v0.1.14(2mo ago)131↓50%MITPHP

Since Feb 17Pushed 2mo agoCompare

[ Source](https://github.com/vadkuz/flarum2-tag-favicon-and-file)[ Packagist](https://packagist.org/packages/vadkuz/flarum2-tag-favicon-and-file)[ RSS](/packages/vadkuz-flarum2-tag-favicon-and-file/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (16)Used By (0)

flarum2-tag-favicon-and-file
============================

[](#flarum2-tag-favicon-and-file)

Tag/category icon extension for Flarum 2.x.

Supports 3 icon sources:

- Font Awesome class
- favicon by URL or domain
- custom uploaded file (including SVG, PNG, ICO, etc.)

Also supports additional icon libraries in the `Icon` field:

- Remix Icon (`ri-*`)
- Material Design Icons (`mdi mdi-*`)
- Bootstrap Icons (`bi bi-*`)
- Iconify (`iconify:collection:icon`, for example `iconify:mdi:home`)

Composer Package
----------------

[](#composer-package)

`vadkuz/flarum2-tag-favicon-and-file`

🇷🇺 Русский
----------

[](#-русский)

### Возможности

[](#возможности)

- Автоопределение favicon по домену: `flarum.org` или `https://flarum.org`
- Поддержка URL изображений: `.ico .png .svg .jpg .jpeg .webp .avif .gif .bmp`
- Внешние favicon URL/домены проксируются через серверный кэш и оптимизацию
- Кнопка в админке для принудительного обновления кэша favicon у конкретного тега
- Загрузка собственного файла иконки из админки
- Автооптимизация загруженных растровых файлов (ресайз до 128px и сжатие)
- Поддержка Remix Icon, Material Design Icons, Bootstrap Icons и Iconify в поле `Иконка`
- Единый размер отображения иконки для всех вариантов
- Приоритет: загруженный файл -> favicon URL/домен -> Font Awesome
- Оптимизация: CSS-библиотеки иконок подгружаются только при необходимости

### Установка (через Packagist)

[](#установка-через-packagist)

```
composer require vadkuz/flarum2-tag-favicon-and-file
php flarum extension:enable vadkuz-flarum2-tag-favicon-and-file
php flarum cache:clear
php flarum assets:publish
```

### Использование

[](#использование)

Откройте тег в админке и заполните одно из полей:

- `Иконка` (Font Awesome класс)
- `Иконка` (также: `ri-*`, `mdi mdi-*`, `bi bi-*`, `iconify:mdi:home`)
- `Favicon (URL или домен)`
- `Загрузить файл`

### Удаление

[](#удаление)

```
composer remove vadkuz/flarum2-tag-favicon-and-file
php flarum cache:clear
php flarum assets:publish
```

🇬🇧 English
----------

[](#-english)

### Features

[](#features)

- Automatic favicon detection by domain: `flarum.org` or `https://flarum.org`
- Supported image URL formats: `.ico .png .svg .jpg .jpeg .webp .avif .gif .bmp`
- External favicon URL/domain is proxied through server-side cache and optimization
- Admin button to force refresh favicon cache for a specific tag
- Upload custom icon file from admin panel
- Automatic optimization for uploaded raster files (resize to 128px and compression)
- Supports Remix Icon, Material Design Icons, Bootstrap Icons, and Iconify in the `Icon` field
- Unified icon display size for all methods
- Priority: uploaded file -> favicon URL/domain -> Font Awesome
- Optimized: external icon CSS libraries are loaded only when needed

### Installation (via Packagist)

[](#installation-via-packagist)

```
composer require vadkuz/flarum2-tag-favicon-and-file
php flarum extension:enable vadkuz-flarum2-tag-favicon-and-file
php flarum cache:clear
php flarum assets:publish
```

### Usage

[](#usage)

Open a tag in admin panel and fill one of these fields:

- `Icon` (Font Awesome class)
- `Icon` (also: `ri-*`, `mdi mdi-*`, `bi bi-*`, `iconify:mdi:home`)
- `Favicon (URL or domain)`
- `Upload icon file`

### Removal

[](#removal)

```
composer remove vadkuz/flarum2-tag-favicon-and-file
php flarum cache:clear
php flarum assets:publish
```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance86

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

15

Last Release

75d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1765685?v=4)[vadkuz](/maintainers/vadkuz)[@vadkuz](https://github.com/vadkuz)

---

Top Contributors

[![vadkuz](https://avatars.githubusercontent.com/u/1765685?v=4)](https://github.com/vadkuz "vadkuz (19 commits)")

### Embed Badge

![Health badge](/badges/vadkuz-flarum2-tag-favicon-and-file/health.svg)

```
[![Health](https://phpackages.com/badges/vadkuz-flarum2-tag-favicon-and-file/health.svg)](https://phpackages.com/packages/vadkuz-flarum2-tag-favicon-and-file)
```

###  Alternatives

[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[fof/best-answer

Mark a post as the best answer in a discussion

26135.2k15](/packages/fof-best-answer)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[flarum/extension-manager

An extension manager to install, update and remove extension packages from the interface (Wrapper around composer).

12211.5k](/packages/flarum-extension-manager)[flarum/nicknames

Allow users to set nicknames.

10288.4k9](/packages/flarum-nicknames)[fof/drafts

Allow users to create post and discussion drafts

1771.1k5](/packages/fof-drafts)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)