MokoConsulting/MokoSuiteOpenGraph
1
0
Fork 0
Code Issues 3 Pull Requests Releases 2 Wiki Activity

Add "Configuration"

Jonathan Miller
2026-05-31 01:50:33 +00:00
parent deba2c8324
commit 39416543b4
1 changed files with 51 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Configuration.md
+51
@@ -0,0 +1,51 @@
# Configuration
Navigate to **Extensions > Plugins > System - MokoJoomOpenGraph** to configure the plugin.
## Basic Settings
| Parameter | Description |
|-----------|-------------|
| **Site Name** | The `og:site_name` value. Leave blank to use the Joomla site name. |
| **Default OG Title** | Site-wide fallback title for social sharing. Used when a page has no custom OG title and no page title. |
| **Default OG Description** | Site-wide fallback description. Used when a page has no custom OG description and no meta description. |
| **Default Image** | Fallback image used when no article or page image is found. Recommended: 1200x630px. |
| **Twitter Card Type** | Summary (small image) or Summary with Large Image (large image). |
| **Twitter @username** | Your site Twitter handle (e.g. @mokoconsulting). |
| **Facebook App ID** | Your Facebook App ID for `fb:app_id` meta tag. |
| **Telegram Channel** | Your Telegram channel handle for link previews. |
| **Discord Embed Color** | The color of the embed sidebar when shared on Discord. |
## Advanced Settings
| Parameter | Description |
|-----------|-------------|
| **Auto-generate Tags** | Automatically generate OG tags from article content when no custom tags are set. |
| **Strip HTML** | Remove HTML tags from auto-generated descriptions. |
| **Description Length** | Maximum character length for `og:description` (50-300, default 160). |
| **Auto-resize Images** | Resize images to 1200x630px using center crop. Cached in `images/mokoog/generated/`. |
| **Enable JSON-LD** | Output structured data (Article, WebPage) for Google rich results. |
| **JSON-LD Breadcrumbs** | Output BreadcrumbList schema from Joomla pathway. |
## Fallback Chain
OG tag values are resolved in this order:
1. **Custom OG data** -- per-article/menu/category overrides set in the editor
2. **Page metadata** -- Joomla page title, meta description, article images
3. **Site-wide defaults** -- Default OG Title, Default OG Description, Default Image from plugin config
This ensures every page always has OG tags, even without any manual configuration.
## Per-Content OG Fields
When editing an article, menu item, or category, you will see a **MokoJoomOpenGraph** tab with:
- **OG Title** -- Custom title for social sharing
- **OG Description** -- Custom description for social sharing
- **OG Image** -- Custom image (uses Joomla media picker)
- **OG Type** -- article, website, product, profile, book, music, video
- **SEO Title** -- Custom page `<title>` override
- **Meta Description** -- Custom meta description
- **Robots** -- noindex, nofollow, noarchive, nosnippet, noimageindex
- **Canonical URL** -- Custom canonical URL override