MokoJoomOpenGraph/README.md

MokoJoomOpenGraph

Open Graph, Twitter Card, and social sharing meta tag management for Joomla 4/5/6.

Overview

MokoJoomOpenGraph gives you full control over how your Joomla content appears when shared on Facebook, Twitter/X, LinkedIn, Discord, WhatsApp, Telegram, and other social platforms. Set custom titles, descriptions, and images per article, menu item, and category — or let the extension auto-generate them from your existing content.

Features

Social Meta Tags

• Open Graph tags — og:title, og:description, og:image, og:url, og:type, og:site_name, og:locale
• Twitter/X Cards — Summary and Summary with Large Image card types
• LinkedIn — article:published_time, article:modified_time, article:author
• Discord — Custom embed color via theme-color meta tag
• Telegram — telegram:channel for link previews
• Facebook — fb:app_id support, og:image:width/og:image:height for instant previews

Content Management

• Per-article control — Custom OG fields tab in the article editor
• Per-menu-item control — Custom OG fields in the menu item editor
• Per-category control — Category-level OG tag overrides
• Multilingual support — Per-language OG data with language-aware fallback
• Auto-generation — Builds tags from article content, title, and images automatically
• Site-wide defaults — Default OG title, description, and image for all pages

SEO

• SEO title override — Custom <title> tag per page
• Meta description — Per-page meta description control
• Robots directive — Per-page noindex/nofollow settings
• Canonical URL — Custom canonical URL overrides
• JSON-LD structured data — Article, WebPage, BreadcrumbList, Organization schemas

Admin Tools

• Tag manager dashboard — View and manage all OG records centrally
• Batch generation — Auto-generate OG tags for all existing articles
• CSV import/export — Bulk manage OG data via CSV files
• SEO health badges — Visual indicators for missing descriptions, long titles, noindex
• Debug links — Quick links to Facebook Debugger, LinkedIn Inspector, Google Rich Results
• Live preview — Real-time Facebook and Twitter/X card preview in the editor

Developer Features

• REST API — Full CRUD via Joomla Web Services (/api/v1/mokoog/tags)
• Content type adapters — Extensible architecture for K2, VirtueMart, HikaShop
• Plugin event — onMokoOGAfterRender for third-party plugins to add custom social tags
• OG image generator — Text overlay on template backgrounds with auto-resize to 1200x630

Installation

1. Download the latest pkg_mokoog-*.zip from Releases
2. In Joomla Administrator → Extensions → Install → Upload Package File
3. All plugins are enabled automatically on install

Configuration

Navigate to Extensions → Plugins → System - MokoJoomOpenGraph to configure:

• Site name override
• Default OG title and description (site-wide fallback)
• Default fallback image
• Twitter Card type and @username
• Facebook App ID
• Discord embed color
• Telegram channel
• Auto-generation, image resize, JSON-LD, and description length settings

License

GPL-3.0-or-later — See LICENSE for details.

Author

Moko Consulting — hello@mokoconsulting.tech