Download the PHP package ernestdefoe/og-image without Composer
On this page you can find all versions of the php package ernestdefoe/og-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ernestdefoe/og-image
More information about ernestdefoe/og-image
Files in ernestdefoe/og-image
Package og-image
Short Description Adds Open Graph and Twitter Card meta tags to Flarum 2 discussions for rich Facebook and social media previews
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package og-image
Flarum OG Image
Automatically adds Open Graph and Twitter Card meta tags to every page of your Flarum 2 forum so that Facebook, Twitter/X, and other platforms generate rich link previews when discussions are shared or auto-posted.
What it does
| Page | Tags generated |
|---|---|
| Discussion | og:title, og:description, og:image, og:url, og:type, article:published_time, Twitter Card |
| Forum index / other pages | og:title, og:description, og:image, og:url, og:type, Twitter Card |
| All pages | og:site_name, fb:app_id (if configured) |
Image selection priority for discussions:
- First
<img>found in the first post's rendered HTML - Default OG Image configured in Admin → Extensions → OG Image
Requirements
| Dependency | Version |
|---|---|
| PHP | ≥ 8.1 |
| Flarum | ^2.0 |
Installation
Configuration
- Go to Admin → Extensions → OG Image
- Set Default OG Image URL — an absolute URL to an image used when a discussion has no embedded images (e.g. your forum banner)
- Facebook recommends 1200 × 630 px minimum
- Must be publicly accessible (no auth required)
- Set Facebook App ID (optional but recommended) — removes the "missing fb:app_id" warning in the Facebook Sharing Debugger
- Find your App ID at developers.facebook.com → My Apps → your app → top-left of dashboard
- Click Save Changes
How it works
The extension hooks into Flarum's server-side document rendering. Before the HTML is sent to the browser, it:
- Checks the request route — discussions are detected via Flarum's
routeNameattribute or by matching/d/{id}in the URL path - Loads the discussion and its first post from the database
- Renders the first post to HTML, strips tags for the description excerpt, and scans for the first
<img>to use as the OG image - Writes
<meta property="og:*">and<meta name="twitter:*">tags into the<head>
Because the tags are server-rendered, Facebook's scraper sees them immediately — no JavaScript execution required.
Using with the Facebook Auto-Post extension
Install both extensions. When the Facebook Auto-Post extension posts a discussion URL to your Facebook Page, Facebook scrapes that URL and reads the OG tags this extension provides, producing a rich preview card with the discussion title, excerpt, and image.
Troubleshooting
| Symptom | Likely cause |
|---|---|
| No preview on Facebook | Facebook cached the page before OG tags were present — use the Sharing Debugger to force a re-scrape |
| Preview shows no image | Discussion has no <img> in the first post and no default image is configured |
| Default image not showing | URL is not absolute, not publicly accessible, or returns a non-image content type |
| Wrong description | The excerpt is taken from the first post only; BBcode/markdown is stripped |
| "Invalid App ID" warning | You entered your Facebook Page ID instead of your App ID — they are different numbers |
| Image not showing on auto-posted Facebook posts | See HTTP 206 response section below |
HTTP 206 response — images not showing on Facebook posts
The Facebook Sharing Debugger reports a Response Code for every URL it scrapes. If yours shows 206 instead of 200, your web server is returning partial content to Facebook's crawler. This means Facebook may not receive the full <head> section where OG tags live, causing the image (and other tags) to be missing from link previews.
This is a web server configuration issue, not a Flarum or extension issue.
Nginx
Add to your server block:
Apache
Add to your .htaccess or virtual host config:
Cloudflare
If your site is proxied through Cloudflare, their edge cache may be serving partial responses. Add a Cache Rule to bypass caching for discussion pages:
- Cloudflare dashboard → Rules → Cache Rules
- Create a rule matching
fbsfb.com/d/* - Set Cache Status: Bypass
After making any of these changes, go to developers.facebook.com/tools/debug, paste your discussion URL, and click Scrape Again. Confirm the Response Code changes to 200 before testing image previews.
Support
Questions, bug reports, and feature requests:
- Support forum: https://ernestdefoe.online
- Issues: https://github.com/ernestdefoe/og-image/issues
License
MIT © Ernestdefoe
