FoF SEO

FriendsOfFlarum · 2026-06-04T19:36:12+00:00

FoF SEO A Flarum extension that adds SEO tags to your forum — meta description, Open Graph, Twitter cards, and schema.org structured data. Documentation Full documentation lives in the docs/ folder: Installation Features & configuration Per-item SEO (the Configure SEO dialog) Do-follow link list Sitemap & robots.txt Developers: SeoMeta objects · the SeoProperties class Contributing Installation composer require fof/seo:"^3" if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Updating composer update fof/seo php flarum cache:clear if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Migrating from v17development/flarum-seo This extension was transferred to FriendsOfFlarum and was previously published as v17development/flarum-seo. The FriendsOfFlarum line begins at 3.0.0, continuing the version history (the previous package reached 2.0.9). For forum admins, migration is a one-line change — swap the package, keep your settings and stored SEO data: composer remove v17development/flarum-seo composer require fof/seo:"^3" php flarum cache:clear if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } fof/seo declares replace: { "v17development/flarum-seo": "*" }, so anything that depended on the old package is satisfied by the new one, and the two can never be installed at once. Existing v17development/flarum-seo releases (≤ 2.0.9) remain installable from Packagist for anyone not yet ready to switch. Third-party extension authors should update any references from the V17Development\FlarumSeo namespace to FoF\Seo, and from the v17development-seo frontend module to fof-seo. See the developer documentation. Features SEO tags are generated for the following pages: Home page Tags page (if flarum/tags is enabled) Discussion page User profile Pages page (if fof/pages is enabled) Methods used: HTML meta tags (application-name, description, keywords, language) Open Graph tags (og:type, og:title, og:description, og:url, article:published_time, article:updated_time) Twitter cards inLanguage on every page Schema.org structured data: WebPage + WebSite SearchAction DiscussionForumPosting — with headline, text and comment/like/view interactionStatistics QAPage for Q&A discussions (with fof/best-answer) CollectionPage — with an ItemList of the tag's discussions ProfilePage — with a rich Person (identity + activity stats) Uses the first image in the post as the social-media image when one is present, falling back to the configured default. Your robots.txt and XML sitemap are provided by fof/sitemap. See Sitemap & robots.txt. Works with Compatible — but not required — alongside: flarum/likes — like counts in the interaction statistics flarum/tags fof/best-answer — Q&A (QAPage) structured data fof/sitemap — sitemap & robots.txt fof/pages fof/discussion-views — view counts in the structured data fof/discussion-language — per-discussion inLanguage for multi-language forums Extending Third-party extensions have three integration points: Page drivers — emit/replace structured data for your own routes by extending FoF\Seo\Extend\SEO and implementing FoF\Seo\Page\PageDriverInterface. SeoMeta objects — give your own models managed, per-object metadata that appears in the Configure SEO dialog. The PreparingPageMeta event — intercept and override the prepared metadata (language, description, any schema.org property) on any page. See the developer guides for details: SeoMeta objects — developer guide The SeoProperties class Extending & intercepting the metadata Credits This extension was originally created and maintained by V17 Development as v17development/flarum-seo. FriendsOfFlarum is grateful for their work bringing SEO support to the Flarum ecosystem and continues development with their blessing. Links Documentation Packagist GitHub Issues Support License This extension is licensed under the MIT License. See the LICENSE.md file for details.

FoF Bot

🚀 New Release: 4.0.0-beta.1

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.1

Flarum 2.0 upgrade by @IanM in FriendsOfFlarum/seo137
[2.x] fix: emit Open Graph article dates as property tags, add og:locale and og:image:alt by @IanM in FriendsOfFlarum/seo138
[2.x] docs: correct Open Graph article tag references by @IanM in FriendsOfFlarum/seo139

Full Changelog: FriendsOfFlarum/seo3.0.1 → 4.0.0-beta.1

FoF Bot

🚀 New Release: 3.0.2

Targets Flarum 1.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/3.0.2

[1.x] fix: always emit author on comment/answer nodes for deleted users by @IanM in FriendsOfFlarum/seo143

Full Changelog: FriendsOfFlarum/seo3.0.1 → 3.0.2

ClaudiusH

A bunch of references to "Twitter" still in the Admin interface. We are now in year 3 after the rename to "𝕏" so we should probably amend the copy accordingly.

IanM

ClaudiusH good shout. Yes, I'll get that changed in the next releases for both versions

FriendsOfFlarum/seo146

FoF Bot

🚀 New Release: 3.0.3

Targets Flarum 1.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/3.0.3

[1.x] i18n: refer to X (formerly Twitter) in user-facing strings by @IanM in FriendsOfFlarum/seo148

Full Changelog: FriendsOfFlarum/seo3.0.2 → 3.0.3

yunyun-3782

终于来了

FoF Bot

🚀 New Release: 3.0.4

Targets Flarum 1.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/3.0.4

[1.x] i18n: capitalize Sitemap extension name and fix robots.txt button label by @IanM in FriendsOfFlarum/seo155
[1.x] fix: don't auto-select SVG images for og:image, add backfill command by @IanM in FriendsOfFlarum/seo156
[1.x] i18n: reword health-check labels to describe the check, not assert a result by @IanM in FriendsOfFlarum/seo160
[1.x] fix: add bottom margin to SEO admin page container by @IanM in FriendsOfFlarum/seo162
[1.x] fix: restore SeoWidget CTA contrast on the dashboard by @IanM in FriendsOfFlarum/seo164

Full Changelog: FriendsOfFlarum/seo3.0.3 → 3.0.4

FoF Bot

🚀 New Release: 4.0.0-beta.2

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.2

[2.x] fix: emit datePublished on comment/posting nodes and cap crawled replies by @IanM in FriendsOfFlarum/seo141
[2.x] fix: always emit author on comment/answer nodes for deleted users by @IanM in FriendsOfFlarum/seo142
[2.x] feat: emit QAPage for answered Q&A discussions even with the crawler off by @IanM in FriendsOfFlarum/seo144
[2.x] fix: render QAPage question/answer text to plain text by @IanM in FriendsOfFlarum/seo145
[2.x] i18n: refer to X (formerly Twitter) in user-facing strings by @IanM in FriendsOfFlarum/seo147
[2.x] fix: don't auto-select SVG images for og:image, add backfill command by @IanM in FriendsOfFlarum/seo150
[2.x] i18n: capitalize Sitemap extension name and fix robots.txt button label by @IanM in FriendsOfFlarum/seo153
[2.x] docs: document SVG image exclusion and the fix-svg-images command by @IanM in FriendsOfFlarum/seo157
[2.x] i18n: reword health-check labels to describe the check, not assert a result by @IanM in FriendsOfFlarum/seo158
[2.x] fix: add bottom margin to SEO admin page container by @IanM in FriendsOfFlarum/seo161
[2.x] fix: restore SeoWidget CTA contrast on the dashboard by @IanM in FriendsOfFlarum/seo163

Full Changelog: FriendsOfFlarum/seo4.0.0-beta.1 → 4.0.0-beta.2

FoF Bot

🚀 New Release: 3.0.5

Targets Flarum 1.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/3.0.5

[1.x] fix: restore SeoWidget CTA white pill on the dashboard by @IanM in FriendsOfFlarum/seo168

Full Changelog: FriendsOfFlarum/seo3.0.4 → 3.0.5

FoF Bot

🚀 New Release: 4.0.0-beta.3

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.3

[2.x] fix: Omit author when the user is deleted in structured data by @IanM in FriendsOfFlarum/seo170
[2.x] fix: lazy load modals for reduced js bundle size by @IanM in FriendsOfFlarum/seo171
[2.x] fix: Emit image/video on comment and Q&A nodes with no text by @IanM in FriendsOfFlarum/seo172
[2.x] feat: Rich, hierarchical, extensible breadcrumbs by @IanM in FriendsOfFlarum/seo173

Full Changelog: FriendsOfFlarum/seo4.0.0-beta.2 → 4.0.0-beta.3

ddotar

For installation in 2.0 rc3, I had to use:
composer require fof/seo:"*"
You might be able to update this in the first post instructions, change 3 for *

FoF Bot

🚀 New Release: 4.0.0-beta.4

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.4

[2.x] Always emit author on forum/Q&A nodes; emit only valid image/answer fields by @IanM in FriendsOfFlarum/seo174

Full Changelog: FriendsOfFlarum/seo4.0.0-beta.3 → 4.0.0-beta.4

FoF Bot

🚀 New Release: 4.0.0-beta.5

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.5

[2.x] Resolve tag breadcrumb ancestry from an in-memory map (fix per-level N+1) by @IanM in FriendsOfFlarum/seo176
[2.x] Make answer/comment URLs unique with a #post-{id} fragment by @IanM in FriendsOfFlarum/seo175

Full Changelog: FriendsOfFlarum/seo4.0.0-beta.4 → 4.0.0-beta.5

xa_sharma

FriendsOfFlarum

I tried to install from v17development/flarum-seo v2.0.9 to fof/seo:"³" but got error and site stop loading, started showing this error - Flarum encountered a boot error. Details have been logged to the Flarum log file.

Error log -

[15-Jun-2026 12:37:09 UTC] PHP Warning:  Undefined property: stdClass::$included in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 90
[15-Jun-2026 12:37:09 UTC] PHP Warning:  foreach() argument must be of type array|object, null given in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 90
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "commentCount" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "title" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "slug" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2
[15-Jun-2026 12:37:09 UTC] PHP Warning:  Attempt to read property "title" on null in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2

IanM

xa_sharma you must remove the v17 version first before upgrading to the FoF version

FoF Bot

🚀 New Release: 3.0.6

Targets Flarum 1.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/3.0.6

[1.x] fix: emit JSON-LD as @graph root instead of a bare array by @IanM in FriendsOfFlarum/seo178

Full Changelog: FriendsOfFlarum/seo3.0.5 → 3.0.6

FoF Bot

🚀 New Release: 4.0.0-beta.6

Targets Flarum 2.x

Released by: @IanM
Release URL: FriendsOfFlarum/seoreleases/tag/4.0.0-beta.6

[2.x] Emit JSON-LD as an @graph root instead of a bare array by @IanM in FriendsOfFlarum/seo179

Full Changelog: FriendsOfFlarum/seo4.0.0-beta.5 → 4.0.0-beta.6

xa_sharma

IanM I did the same as you said -

First removed - composer remove v17development/flarum-seo and after that installed - composer require fof/seo

Still getting the same error xa_sharma - Flarum encountered a boot error. Details have been logged to the Flarum log file.

Error log -

[16-Jun-2026 02:43:30 UTC] PHP Warning:  Undefined property: stdClass::$included in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 90
[16-Jun-2026 02:43:30 UTC] PHP Warning:  foreach() argument must be of type array|object, null given in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 90
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "commentCount" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 97
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "title" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 99
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "slug" on null in /home/hacksnat/public_html/vendor/flarum/core/src/Forum/Content/Discussion.php on line 84
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Undefined property: stdClass::$data in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "attributes" on null in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2
[16-Jun-2026 02:43:30 UTC] PHP Warning:  Attempt to read property "title" on null in /home/hacksnat/public_html/storage/views/5afb52e362293fbbea0c9941a125e51c52000be3.php on line 2

Tutrix

@IanM
I've now switched to FoF/SEO via Composer instead of using the Extension Manager, and everything is working fine. 😀
The blog has also been updated to FoF/Blog. 😉
Thanks for your work.

« Previous Page Next Page »