FriendsOfFlarum Categories

huseyinfiliz

Categories by FriendsOfFlarum

A Flarum extension. Traditional category layout for Flarum.

Desktop

On Desktop

Mobile

On Mobile

Installation

Install with composer:

composer require fof/categories:"*"

Updating

composer update fof/categories

Links

An extension by FriendsOfFlarum.

Umutcan

Congratulations @huseyinfiliz 💫💫💯

FoF Bot

🚀 New Release: 1.0.0

Author: huseyinfiliz
Release URL: FriendsOfFlarum/categoriesreleases/tag/1.0.0

Changelog

Full Changelog: FriendsOfFlarum/categoriescommits/1.0.0

huseyinfiliz

The original flarum-categories extension developed by @askvortsov (original discussion) has been successfully migrated to the FriendsOfFlarum (FoF) namespace! It has been brought up to current Flarum 1.8 standards, and I'm excited to share that the Flarum 2.x version is also officially published! 🎉

Please give it a try, and don't hesitate to report any bugs or issues you might encounter.

A few quick notes for existing users on upgrading:

Data Migration: Your database tables (category data) will be safely kept and migrated. However, your previous extension settings will not be carried over, so you'll need to reconfigure those in the admin panel.
Installation: You do not need to manually uninstall the old extension. Simply install this new FoF version, and Flarum (via Composer) will automatically replace and remove the old one for you.

Enjoy!

FoF Bot

🚀 New Release: 2.0.0-beta.1

Author: @IanM
Release URL: FriendsOfFlarum/categoriesreleases/tag/2.0.0-beta.1

Changelog

Full Changelog: FriendsOfFlarum/categoriescommits/2.0.0-beta.1

navindra

Woohoo! Thank you! I can't wait to try this for PianoTell on Flarum 2.x!

Thanks so much for performing this service!

I just noticed that this supports Flarum 1.8.x as well, so it seems I don't even have to wait to upgrade. Were there any code changes other than the namespace update for the 1.x branch?

GreXXL

navindra I just noticed that this supports Flarum 1.8.x as well, so it seems I don't even have to wait to upgrade. Were there any code changes other than the namespace update for the 1.x branch?

Yes you should change to the FoF version in 1.x as it will allow you to update to 2.x once released more easily. This is why we are porting extensinos to FoF also in version 1.x. There aren't any additional changes other then the namespace change though.

huseyinfiliz

navindra You're very welcome!

There weren't any changes that will affect how you use it. The updates mostly involved general maintenance, like ensuring full compatibility with Flarum 1.8.x and newer PHP versions. Some under-the-hood improvements were also added to make future maintenance easier.

I highly recommend switching to this version before you make the jump to Flarum 2.x. It will make the upgrade process much smoother for you when the time comes.

Let me know how it goes!

Capybara

It seems the extension uses its own contrast rule, which makes some tags hard to read. It would be better to override the custom rules using the standard var, since that’s how tags normally work 👀

huseyinfiliz

Capybara Is this related to Flarum 2.x? I have a few questions. First of all, is this behavior the same as the original extension, or is it a newly emerged bug? I will conduct a detailed review once I have these answers.

Capybara

huseyinfiliz Yep – 2.x. But it seems to be an old issue — I think that’s the reason I didn’t end up using this extension back on 1.x

navindra

GreXXL huseyinfiliz That's really great indeed, thank you both!

I tested this on my dev server and it worked great. It's a bit scary at first because when you install the new extension it defaults to off, so the landing page renders a blank body. Once enabled, it works!

On my production server I had another scare where initially I got this error:

[2026-02-21 07:04:22] flarum.ERROR: ReflectionException: Class "FoF\Categories\Content\Categories" does not exist in /var/www/html/vendor/illuminate/container/Container.php:877
Stack trace:
#0 /var/www/html/vendor/illuminate/container/Container.php(877): ReflectionClass->__construct()
#1 /var/www/html/vendor/illuminate/container/Container.php(758): Illuminate\Container\Container->build()
#2 /var/www/html/vendor/illuminate/container/Container.php(694): Illuminate\Container\Container->resolve()
#3 /var/www/html/vendor/flarum/core/src/Http/RouteHandlerFactory.php(55): Illuminate\Container\Container->make()
#4 /var/www/html/vendor/illuminate/container/BoundMethod.php(36): Flarum\Http\RouteHandlerFactory->Flarum\Http{closure}()
#5 /var/www/html/vendor/illuminate/container/Util.php(40): Illuminate\Container\BoundMethod::Illuminate\Container{closure}()
#6 /var/www/html/vendor/illuminate/container/BoundMethod.php(81): Illuminate\Container\Util::unwrapIfClosure()
#7 /var/www/html/vendor/illuminate/container/BoundMethod.php(35): Illuminate\Container\BoundMethod::callBoundMethod()
#8 /var/www/html/vendor/illuminate/container/Container.php(653): Illuminate\Container\BoundMethod::call()
#9 /var/www/html/vendor/flarum/core/src/Http/RouteHandlerFactory.php(75): Illuminate\Container\Container->call()
#10 /var/www/html/vendor/flarum/core/src/Http/RouteHandlerFactory.php(37): Flarum\Http\RouteHandlerFactory->resolveController()
#11 /var/www/html/vendor/flarum/core/src/Http/Middleware/ExecuteRoute.php(27): Flarum\Http\RouteHandlerFactory->Flarum\Http{closure}()
#12 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ExecuteRoute->process()
#13 /var/www/html/vendor/fof/anti-spam/src/Middleware/CheckLoginMiddleware.php(86): Laminas\Stratigility\Next->handle()
#14 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): FoF\AntiSpam\Middleware\CheckLoginMiddleware->process()
#15 /var/www/html/vendor/fof/byobu/src/Middleware/GuestAccessToPrivateRoutePrevention.php(32): Laminas\Stratigility\Next->handle()
#16 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): FoF\Byobu\Middleware\GuestAccessToPrivateRoutePrevention->process()
#17 /var/www/html/vendor/flarum/core/src/Http/Middleware/ContentTypeOptionsHeader.php(21): Laminas\Stratigility\Next->handle()
#18 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ContentTypeOptionsHeader->process()
#19 /var/www/html/vendor/flarum/core/src/Http/Middleware/ReferrerPolicyHeader.php(30): Laminas\Stratigility\Next->handle()
#20 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ReferrerPolicyHeader->process()
#21 /var/www/html/vendor/flarum/core/src/Http/Middleware/FlarumPromotionHeader.php(30): Laminas\Stratigility\Next->handle()
#22 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\FlarumPromotionHeader->process()
#23 /var/www/html/vendor/flarum/core/src/Http/Middleware/ShareErrorsFromSession.php(57): Laminas\Stratigility\Next->handle()
#24 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ShareErrorsFromSession->process()
#25 /var/www/html/vendor/flarum/core/src/Http/Middleware/CheckCsrfToken.php(36): Laminas\Stratigility\Next->handle()
#26 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\CheckCsrfToken->process()
#27 /var/www/html/vendor/flarum/core/src/Http/Middleware/ResolveRoute.php(69): Laminas\Stratigility\Next->handle()
#28 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ResolveRoute->process()
#29 /var/www/html/vendor/flamarkt/backoffice/src/Middleware/SubForumRouter.php(37): Laminas\Stratigility\Next->handle()
#30 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flamarkt\Backoffice\Middleware\SubForumRouter->process()
#31 /var/www/html/vendor/flarum/core/src/Http/Middleware/SetLocale.php(51): Laminas\Stratigility\Next->handle()
#32 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\SetLocale->process()
#33 /var/www/html/vendor/flarum/core/src/Http/Middleware/AuthenticateWithSession.php(31): Laminas\Stratigility\Next->handle()
#34 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\AuthenticateWithSession->process()
#35 /var/www/html/vendor/flarum/core/src/Http/Middleware/RememberFromCookie.php(63): Laminas\Stratigility\Next->handle()
#36 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\RememberFromCookie->process()
#37 /var/www/html/vendor/flarum/core/src/Http/Middleware/StartSession.php(61): Laminas\Stratigility\Next->handle()
#38 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\StartSession->process()
#39 /var/www/html/vendor/flarum/core/src/Http/Middleware/CollectGarbage.php(46): Laminas\Stratigility\Next->handle()
#40 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\CollectGarbage->process()
#41 /var/www/html/vendor/flarum/core/src/Http/Middleware/ParseJsonBody.php(28): Laminas\Stratigility\Next->handle()
#42 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ParseJsonBody->process()
#43 /var/www/html/vendor/migratetoflarum/canonical/src/Middlewares/CanonicalRedirectMiddleware.php(49): Laminas\Stratigility\Next->handle()
#44 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): MigrateToFlarum\Canonical\Middlewares\CanonicalRedirectMiddleware->process()
#45 /var/www/html/vendor/flarum/core/src/Http/Middleware/HandleErrors.php(57): Laminas\Stratigility\Next->handle()
#46 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\HandleErrors->process()
#47 /var/www/html/vendor/flarum/core/src/Http/Middleware/InjectActorReference.php(25): Laminas\Stratigility\Next->handle()
#48 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\InjectActorReference->process()
#49 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(81): Laminas\Stratigility\Next->handle()
#50 /var/www/html/vendor/middlewares/request-handler/src/RequestHandler.php(84): Laminas\Stratigility\MiddlewarePipe->process()
#51 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Middlewares\RequestHandler->process()
#52 /var/www/html/vendor/middlewares/base-path-router/src/BasePathRouter.php(97): Laminas\Stratigility\Next->handle()
#53 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Middlewares\BasePathRouter->process()
#54 /var/www/html/vendor/laminas/laminas-stratigility/src/Middleware/OriginalMessages.php(36): Laminas\Stratigility\Next->handle()
#55 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Laminas\Stratigility\Middleware\OriginalMessages->process()
#56 /var/www/html/vendor/middlewares/base-path/src/BasePath.php(73): Laminas\Stratigility\Next->handle()
#57 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Middlewares\BasePath->process()
#58 /var/www/html/vendor/flarum/core/src/Http/Middleware/ProcessIp.php(24): Laminas\Stratigility\Next->handle()
#59 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(49): Flarum\Http\Middleware\ProcessIp->process()
#60 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(81): Laminas\Stratigility\Next->handle()
#61 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(70): Laminas\Stratigility\MiddlewarePipe->process()
#62 /var/www/html/vendor/laminas/laminas-httphandlerrunner/src/RequestHandlerRunner.php(73): Laminas\Stratigility\MiddlewarePipe->handle()
#63 /var/www/html/vendor/flarum/core/src/Http/Server.php(45): Laminas\HttpHandlerRunner\RequestHandlerRunner->run()
#64 /var/www/html/public/index.php(26): Flarum\Http\Server->listen()
#65 {main}

This is not the first time this has happened to me, so I know it's not specific to this extension. Restarting the server worked. Not sure why this happens though. Please enlighten me if you know!

Then I ran into another issue. On the original extension, I had customized some of the text so that Categories is Forums instead. I had used FoF Linguist for this. Unfortunately, that customization doesn't carry over, but I was able to find the equivalent strings that needed updating.

PianoTell is now running FriendsOfFlarum Categories, thank you!

It looks I should see if the other extensions need to be upgraded to their FoF equivalents.

huseyinfiliz

navindra Awesome, glad to hear the migration went smoothly and PianoTell is now running FoF Categories!

Regarding that ReflectionException error: it is a very common caching quirk. When you swap or install new extensions, Composer's autoloader or PHP's OPcache sometimes holds onto the old file paths in memory. Because the application can't find the newly mapped class right away, it throws that exact error. Usually, running composer dump-autoload and php flarum cache:clear resolves it. Restarting your server entirely flushes the PHP OPcache, which is exactly why that did the trick for you!

As for FoF Linguist, since the extension's underlying namespace changed, the translation keys changed along with it. It’s expected that the old overrides wouldn't carry over automatically, but great job on tracking down the new strings.

Good luck with checking your other extensions for FoF equivalents!

navindra

huseyinfiliz Thank you!

On Flarum 2, the "Full page desktop?" option doesn't seem to be working as expected:

Flarum 1 looks good:

Known issue? Thanks again! 🙂