包简介

Emits OpenGraph and Twitter Card meta tags on Flarum discussion pages so external link previews show the actual discussion title, excerpt, and (when available) first-post image.

README 文档

README

Emits per-discussion OpenGraph and Twitter Card meta tags in the <head> of Flarum 2.0 discussion pages, so when someone pastes a discussion URL into Slack, Discord, Facebook, X, iMessage, Telegram, or any other unfurler, the preview shows the actual discussion title and first-post excerpt — not the same generic forum description every time.

Built with Claude Code.

Why this exists

Out of the box, every page on a Flarum forum carries the same single forum-level <meta name="description">. So a link to https://example.com/d/2449-pianos-and-design previews everywhere as the forum's generic description ("Piano forum for piano, keyboard, synth, players and music enthusiasts..."), regardless of what the thread is actually about. That makes shared links look interchangeable and kills click-through.

This extension fixes that by reading the discussion + first-post data that Flarum's discussion route handler already loads, and turning it into a small block of per-page OpenGraph + Twitter meta tags.

What it emits

On every public discussion page (/d/{id}-{slug}):

<meta property="og:title"       content="{discussion title} - {forum name}">
<meta property="og:type"        content="article">
<meta property="og:url"         content="{canonical discussion URL}">
<meta property="og:site_name"   content="{forum name}">
<meta property="og:description" content="{first-post excerpt, ~200 chars, plaintext}">
<meta property="og:image"       content="{first image URL in first post, if any}">

<meta name="twitter:card"        content="summary | summary_large_image">
<meta name="twitter:title"       content="{discussion title} - {forum name}">
<meta name="twitter:description" content="{first-post excerpt}">
<meta name="twitter:image"       content="{first image URL, if any}">

twitter:card switches to summary_large_image when the first post contains an image; otherwise it's plain summary. og:image and twitter:image are only emitted when an image is found.

What it does NOT do

No INSERT, UPDATE, or DELETE against the database. No migrations.
No new tables, columns, or settings rows.
No JSON-LD / structured-data emission.
No sitemap integration (use fof/sitemap for that).
No admin UI or settings panel — it uses your existing forum_title setting.
No image proxying — the og:image URL is whatever sits in the first post's rendered HTML (e.g. a fof/upload attachment URL).

What it skips

Defensively, the meta tags are not injected when the discussion is:

Hidden (isHidden = true)
Private (fof/byobu isPrivateDiscussion = true)
Unapproved (flarum/approval isApproved = false)

Flarum's API already 404s these for unauthenticated viewers (which is what link-unfurl bots are), so the meta tags would never reach a crawler anyway — but the explicit skip belt-and-braces the case where a privileged user copies a non-public discussion URL.

Install

composer require ekumanov/flarum-ext-discussion-og-meta
php flarum extension:enable ekumanov-discussion-og-meta
php flarum cache:clear

That's it — no settings to configure.

Verify

After install, on any public discussion page:

curl -sS https://your-forum.example/d/123-some-slug \
  | grep -E '<meta (property="og:|name="twitter:)' | head

You should see the og:* and twitter:* tags reflecting the discussion's actual title and first-post content.

How it works

The extension registers a single Extend\Frontend('forum')->content(AddOgMetaTags::class) callback. It runs after Flarum's built-in discussion route handler has populated $document->payload['apiDocument'] with the JSON:API document for the discussion (including the eager-loaded firstPost). So the callback adds no DB queries of its own — it just reads what core has already fetched and formats it into meta tags.

The description build pipeline:

Read firstPost.attributes.contentHtml from the API document.
Replace every HTML tag with a single space (so </p><p> doesn't concatenate text), then html_entity_decode, then collapse whitespace.
Truncate at the last word boundary before 200 chars and append ….

The image scan:

Short-circuit if contentHtml doesn't contain <img.
preg_match_all for <img> tags, skip ones whose class contains emoji or whose src is a data: URI or /emoji/ path.
Use the first survivor as og:image.

Performance

Zero DB queries. The description regex scales linearly with first-post HTML size and runs in microseconds for typical posts. Measured against the pianoclack prod-mirror over 20 iterations per condition, the with-extension vs. without-extension delta sat well inside curl measurement noise (±70 ms stddev for a ~1 s debug-mode render).

No client-side JS, no CSS, no asset rebuild.

Compatibility

Flarum ^2.0
PHP ^8.2

Plays nicely with fof/upload (image attachments become og:image), fof/byobu (private discussions are skipped), and flarum/approval (unapproved discussions are skipped).

License

MIT — see LICENSE.

ekumanov/flarum-ext-discussion-og-meta 适用场景与选型建议

ekumanov/flarum-ext-discussion-og-meta 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 6 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 16 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「extension」「seo」「opengraph」「flarum」「twitter-card」「social-share」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 ekumanov/flarum-ext-discussion-og-meta 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 ekumanov/flarum-ext-discussion-og-meta 我们能提供哪些服务？

定制开发 / 二次开发

基于 ekumanov/flarum-ext-discussion-og-meta 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 ekumanov/flarum-ext-discussion-og-meta 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

mapkyca/php-ogp 26

Simple PHP Open Graph Protocol parser library

geertw/yii2-translatable-url-rule 14

A custom URL rule class for Yii 2 which allows to create translated URL rules

slavkovrn/yii2-imagecarousel 5

The Yii2 extension uses jQuery jquery.carousel-1.1.min.js and makes image carousel from php array of structure defined.

gorriecoe/silverstripe-meta 1

Improves silverstripes html meta data options.

yarri/essence 0

Extracts information about medias on the web, like youtube videos, twitter statuses or blog articles.

novius/laravel-meta 0

Help to manage meta data on Laravel Eloquent model

ekumanov/flarum-ext-discussion-og-meta

包简介

关键字：