PHPackages                             fof/taxonomies - 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. fof/taxonomies

Abandoned → [flamarkt/taxonomies](/?search=flamarkt%2Ftaxonomies)ArchivedFlarum-extension[Utility & Helpers](/categories/utility)

fof/taxonomies
==============

Create custom discussion taxonomies and terms

0.1.0-beta.2(5y ago)11261MITJavaScript

Since Oct 14Pushed 4y ago2 watchersCompare

[ Source](https://github.com/FriendsOfFlarum/taxonomies)[ Packagist](https://packagist.org/packages/fof/taxonomies)[ Fund](https://opencollective.com/fof)[ RSS](/packages/fof-taxonomies/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (4)Used By (0)

Taxonomies by FriendsOfFlarum
=============================

[](#taxonomies-by-friendsofflarum)

> Migrated to a new namespace. See

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/6ab1a3c9192a3a563737f758cef4637c5f18bc1a66e0777398076d21ddf38f28/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f7461786f6e6f6d6965732e737667)](https://packagist.org/packages/fof/taxonomies)

Adds custom taxonomies to discussions.

Taxonomies are like tag sets. Taxonomy "tags" are called Terms.

Each Taxonomy has its own rules on how many Terms are required/allowed.

You can allow the users to create custom Terms under some Taxonomies.

Taxonomies and Terms can be used to filter the list of discussions or just store and display particular information about discussion.

A global permission controls who can see and use all taxonomies. Per-taxonomy permissions are currently not available.

The Taxonomies extension can work alongside Flarum's Tags extension, or be used in place of it. Unfortunately all extensions that implement custom Tag feature won't automatically work with Taxonomies (like the ability to follow Tags).

Installation
------------

[](#installation)

```
composer require fof/taxonomies
```

Updating
--------

[](#updating)

```
composer require fof/taxonomies
php flarum migrate
php flarum cache:clear
```

Configuration
-------------

[](#configuration)

Once enabled, a new Taxonomies tab will show up in the admin.

Taxonomies are shown as tabs, while Terms are shown in a list in the Taxonomy tab.

Taxonomies and Terms can be re-ordered by drag-and-drop (horizontally for Taxonomies, vertically for Terms).

If you don't re-order Terms, they will appear alphabetically. If you have a large number of Terms or allow user-created Terms, it's recommended to not order them and leave them in automatic ordering.

An identical Term can be created in multiple Taxonomies. Even slugs can be re-used across Taxonomies, they only need to be unique inside of that Taxonomy.

Slugs are used for search queries and as part of some URLs. You should avoid reserved terms in Taxonomy slugs, like `tag`, `tags`, `page`, `limit`, `include`, `sort`, `q` as these might conflict with Flarum or other extensions.

The Taxonomy and Term descriptions are shown in the "choose terms" modal. Taxonomy description appears above the search field, while Term description appears next to the term. The descriptions might also be used for SEO improvements in a future release.

When a Term is deleted from the admin panel, it is removed from all discussions that used it. When a Taxonomy is deleted from the admin panel, all its Terms are removed from discussions that used it. Discussions are not deleted.

Possible improvements
---------------------

[](#possible-improvements)

The terms API currently doesn't use pagination. With large numbers of user-created terms, loading the "choose term" modal or filter dropdown for those taxonomies could hit performance issues.

More integration with Tags is possible, but requires a lot of work. Restricting a Taxonomy to particular Tags, or linking Terms to Tags to gain Tag-compatible features won't be easy to implement.

Links
-----

[](#links)

- [Flarum Discuss post](https://discuss.flarum.org/)
- [Source code on GitHub](https://github.com/FriendsOfFlarum/taxonomies)
- [Report an issue](https://github.com/FriendsOfFlarum/taxonomies/issues)
- [Download via Packagist](https://packagist.org/packages/fof/taxonomies)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum)

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 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 ~101 days

Total

2

Last Release

1943d ago

### Community

Maintainers

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

![](https://avatars.githubusercontent.com/u/1630413?v=4)[Gregor Hammerschmidt](/maintainers/GreXXL)[@GreXXL](https://github.com/GreXXL)

![](https://www.gravatar.com/avatar/0538135c1debcef5602dce7ece027909cc832b7a6284ab9189a19aa8de98d60d?d=identicon)[clarkwinkelmann](/maintainers/clarkwinkelmann)

![](https://www.gravatar.com/avatar/1298cdc0b2402a1aa34fb75a254947d655e090d62bd0531311331d369cac934e?d=identicon)[datitisev](/maintainers/datitisev)

---

Top Contributors

[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (24 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/fof-taxonomies/health.svg)

```
[![Health](https://phpackages.com/badges/fof-taxonomies/health.svg)](https://phpackages.com/packages/fof-taxonomies)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/gamification

Upvotes and downvotes for your Flarum community

4066.1k8](/packages/fof-gamification)[fof/best-answer

Mark a post as the best answer in a discussion

25154.0k20](/packages/fof-best-answer)

PHPackages © 2026

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