# MokoOpenGraph

<!-- VERSION: 01.00.00 -->

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

## Overview

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

## Features

- **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`
- **Twitter/X Cards** — Summary and Summary with Large Image card types
- **Per-article control** — Custom OG fields in the article editor
- **Per-menu-item control** — Custom OG fields in the menu item editor
- **Auto-generation** — Automatically builds tags from article content, title, and images
- **Default fallback image** — Site-wide default when no article image exists
- **Admin tag manager** — View and manage all OG records from a central dashboard
- **Facebook App ID** — Optional `fb:app_id` meta tag support
- **Joomla 4/5/6** — Modern DI container architecture, Joomla coding standards

## Installation

1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoOpenGraph/releases)
2. In Joomla Administrator → Extensions → Install → Upload Package File
3. The system plugin is enabled automatically on install

## Configuration

Navigate to **Extensions → Plugins → System - MokoOpenGraph** to configure:
- Site name override
- Default fallback image
- Twitter Card type and @username
- Facebook App ID
- Auto-generation behavior
- Description length limit

## License

GPL-3.0-or-later — See [LICENSE](LICENSE) for details.

## Author

[Moko Consulting](https://mokoconsulting.tech) — hello@mokoconsulting.tech