FoF Blog

A Flarum extension that adds a blog section to your forum — a dedicated blog overview, article pages, and an article composer, built on top of your existing discussions and tags.

Documentation

Full documentation lives in the docs/ folder:

• Installation
• Features & configuration
• Permissions & the review workflow
• Developer reference

Requirements

• Flarum 2.0 or above (PHP requirements follow Flarum's)
• flarum/tags — articles are tag-based
• flarum/lock — powers per-article comment locking

Looking for the Flarum 1.x compatible version? Use the 1.x branch / fof/blog ^1.0.

Installation

composer require fof/blog:"*"

Updating

composer update fof/blog
php flarum migrate
php flarum cache:clear

Migrating from v17development/flarum-blog

This extension was transferred to FriendsOfFlarum and was previously published as v17development/flarum-blog.

For forum admins, migration is a one-line change — swap the package, keep your settings and existing blog articles:

composer remove v17development/flarum-blog
composer require fof/blog
php flarum migrate
php flarum cache:clear
php flarum assets:publish

fof/blog declares replace: { "v17development/flarum-blog": "*" }, so anything that depended on the old package is satisfied by the new one, and the two can never be installed at once.

Third-party extension authors should update any references from the V17Development\FlarumBlog PHP namespace to FoF\Blog, and from the v17development/blog / v17development-flarum-blog frontend modules to fof/blog.

Note: SEO integration now targets fof/seo (FoF\Seo). If you relied on SEO tags for your blog, ensure fof/seo is installed and enabled.

Upgrading from 1.x

Version 2.0 targets Flarum 2.0 and modernises the extension throughout. Notable changes for integrators and theme authors:

• CSS classes were consolidated onto the FoFBlog- prefix (previously a mix of FlarumBlog-, Flarum-Blog- and V17Blog-). Custom themes targeting the old classes need updating.
• API: the discussion index no longer includes blogMeta/firstPost by default — request ?include=blogMeta explicitly. Single-discussion responses still include blogMeta. When creating an article via POST /api/discussions, the blog metadata travels as the write-only newBlogMeta attribute (previously blogMeta).
• PHP: several classes moved to conventional namespaces (e.g. the model is now FoF\Blog\BlogMeta). See the developer reference.
• New domain events (ArticleApproved, ArticleFeatured, ArticleUnfeatured, BlogMetaUpdated) and an optional flarum/audit integration.
• Users with approve posts can now publish pending articles without also holding write articles.

Features

• Adds a Blog overview page and article detail pages to your forum
• An article composer for writing blog posts
• Builds on the flarum/tags extension — articles are tag-driven discussions
• Per-article summary and featured image
• Highlighted (featured) posts on the overview
• Categories sidebar, with optional category hierarchy
• Optionally disable or allow comments by default
• Optional review workflow — articles can require approval before publishing, with dedicated write/approve permissions
• Set the blog overview as the forum home page
• Works with already-existing discussions/articles
• Ghost (skeleton) loading states
• Configurable default article image, stored on the flarum-assets filesystem disk

Works with

Compatible — but not required — alongside:

• flarum/sticky — sticky indicator on articles
• flarum/audit — audit log entries for article creation, approval, (un)featuring and meta edits
• fof/seo — SEO meta & structured data for blog pages
• fof/upload — pick a featured image from your uploaded files
• fof/rich-text — rich-text editing in the composer
• fof/discussion-language — per-language blog overviews

Screenshots

Blog overview page

Blog article

Blog tools

Blog settings

Admin settings

Credits

This extension was originally created and maintained by V17 Development as v17development/flarum-blog. FriendsOfFlarum is grateful for their work and continues development with their blessing.

Sponsored by Glowing Blue.

Links

• Packagist
• GitHub
• Issues
• Support

License

This extension is licensed under the MIT License. See the LICENSE.md file for details.