README

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:

Requirements

PHP 8.2 or above
Flarum 1.8 or above
flarum/tags

Installation

composer require fof/blog:"*"

Updating

composer update fof/blog
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.

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/tags — required; articles are tag-based
flarum/sticky — sticky indicator on articles
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.

License

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

fof/blog

包简介

README 文档