Flarum之友（Fof）/SEO插件

云云

一个 Flarum 扩展，可为你的论坛添加 SEO 标签——包括 meta 描述、Open Graph、Twitter 卡片以及 schema.org 结构化数据。

安装

composer require fof/seo:"^3"

更新

composer update fof/seo
php flarum cache:clear

从 `v17development/flarum-seo` 迁移

本扩展已移交至 FriendsOfFlarum，之前以 v17development/flarum-seo 名义发布。FriendsOfFlarum 的版本线从 3.0.0 开始，延续之前的版本历史（原包最高版本为 2.0.9）。

对于论坛管理员来说，迁移仅需一行命令——更换包名，保留原有设置和已存储的 SEO 数据：

composer remove v17development/flarum-seo
composer require fof/seo:"^3"
php flarum cache:clear

fof/seo 声明了 replace: { "v17development/flarum-seo": "*" }，因此所有依赖旧包的内容都会被新包满足，且两者不会同时安装。现有的 v17development/flarum-seo 发行版（≤ 2.0.9）仍可从 Packagist 安装，供尚未准备好切换的用户使用。

第三方扩展的作者应将 V17Development\FlarumSeo 命名空间的引用更新为 FoF\Seo，并将前端模块 v17development-seo 的引用更新为 fof-seo。详情请参阅开发者文档。

功能

以下页面会生成 SEO 标签：

首页
标签页（若已启用 flarum/tags）
讨论页
用户资料页
页面页（若已启用 fof/pages）

使用的方法：

HTML meta 标签（application-name、description、keywords、language）
Open Graph 标签（og:type、og:title、og:description、og:url、article:published_time、article:updated_time）
Twitter 卡片
每页均包含 inLanguage
Schema.org 结构化数据：
- WebPage + WebSite 的 SearchAction
- DiscussionForumPosting —— 包含 headline、text 以及评论/点赞/查看的 interactionStatistic
- 针对问答讨论的 QAPage（搭配 fof/best-answer）
- CollectionPage —— 带有该标签下讨论的 ItemList
- ProfilePage —— 包含丰富的 Person（身份与活动统计）
若帖子中存在图片，则使用首张图片作为社交媒体图片，否则回退至配置的默认图片。

你的 robots.txt 和 XML 站点地图由 fof/sitemap 提供。请参见 Sitemap 与 robots.txt。

兼容扩展

可与之兼容（但并非必须）的扩展：

flarum/likes —— 在交互统计中包含点赞数
flarum/tags
fof/best-answer —— 提供 Q&A（QAPage）结构化数据
fof/sitemap —— 站点地图与 robots.txt
fof/pages
fof/discussion-views —— 在结构化数据中提供查看次数
fof/discussion-language —— 为多语言论坛提供每个讨论的 inLanguage

扩展开发

第三方扩展有三个集成切入点：

页面驱动 —— 通过继承 FoF\Seo\Extend\SEO 并实现 FoF\Seo\Page\PageDriverInterface，为自己的路由生成/替换结构化数据。
SeoMeta 对象 —— 让你自己的模型拥有可管理的、逐对象的元数据，并显示在 配置 SEO 对话框中。
PreparingPageMeta 事件 —— 在任意页面上拦截并覆盖已准备的元数据（语言、描述、任意 schema.org 属性）。

更多细节请参考开发者指南：

致谢

本扩展最初由 V17 Development 创建并维护，以 v17development/flarum-seo 名义发布。FriendsOfFlarum 感谢他们为 Flarum 生态引入 SEO 支持所做的工作，并在他们的许可下继续开发。

云云

文档

完整文档位于 docs/ 文件夹中：

FoF SEO — Documentation

FoF SEO adds search-engine optimization to your Flarum forum. It renders the
meta tags, Open Graph / Twitter cards and
schema.org structured data that search engines and social
networks use to understand and display your content — automatically, and with
per-item overrides where you need them.

This extension is the FriendsOfFlarum continuation of the original
v17development/flarum-seo extension and replaces it.

What it does

Site-wide meta tags — application name, description, canonical URL, and a
robots directive on every page.
Open Graph & Twitter cards — og:* and twitter:* tags so links shared on
social media render rich previews. The Twitter card size is configurable.
Structured data (JSON-LD) — WebPage, DiscussionForumPosting (with
headline, text, comment/like/view interactionStatistics), QAPage,
CollectionPage (with an ItemList of discussions), ProfilePage,
breadcrumbs, an organization publisher block, a site SearchAction, and
inLanguage on every page.
Per-page metadata — discussions, tags and user profiles each get tailored
titles, descriptions, images, and published/updated timestamps.
Per-item overrides — a Configure SEO dialog lets you hand-tune the meta
for an individual discussion (or any registered object), or let it stay
automatically managed.
External-link control — outbound links get rel="nofollow" and open in a
new tab by default, with a configurable do-follow allow-list.
A health check — an admin dashboard that audits your configuration and
points out what to improve.

Requirements

Flarum ^1.8
PHP ^8.2

Zane_Splash72

666