From 1375c5820eb49c78b6a933448a031689b3195c1a Mon Sep 17 00:00:00 2001 From: Jonathan Miller Date: Sun, 21 Jun 2026 15:31:18 -0500 Subject: [PATCH] docs: update README and CHANGELOG for v1.0 assessment - Rename MokoJoomOpenGraph to MokoSuiteOpenGraph throughout - Add MokoSuiteShop integration, Product JSON-LD to feature lists - Remove dead adapter references (K2, VirtueMart, HikaShop) - Document all fixes: DB caching, TagTable validation, CSV language, batch limit, GD logging, canonical URL API, language filters --- CHANGELOG.md | 20 ++++++++++++++++---- README.md | 12 ++++++------ 2 files changed, 22 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1896f50..fa77da0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,7 +2,7 @@ -All notable changes to MokoJoomOpenGraph will be documented in this file. +All notable changes to MokoSuiteOpenGraph will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). @@ -25,9 +25,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). - CSV import/export for bulk OG tag management (#12) - OG image text overlay generator (#7) - Multilingual OG tag support with per-language records (#11) -- JSON-LD structured data: Article, WebPage, BreadcrumbList schemas (#6) +- JSON-LD structured data: Article, Product, WebPage, BreadcrumbList schemas (#6) - Social platform debugger quick links (Facebook, LinkedIn, Google) (#9) -- Content type adapter architecture for K2, VirtueMart, HikaShop (#5) +- MokoSuiteShop product OG tag support with pricing meta and JSON-LD Product schema (#53) - WhatsApp and Telegram link preview optimization (#10) - Category-level OG tag support (#4) - Batch OG tag generation for existing articles (#1) @@ -40,5 +40,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). - Facebook App ID and Telegram channel support - Database table `#__mokoog_tags` with multilingual unique key +### Changed +- Consolidated article DB queries into single cached lookup — 5 queries reduced to 1 (#38) +- Dynamic `og:image:width`/`og:image:height` from actual image dimensions instead of hardcoded (#39) +- Replace GD `@` error suppression with `Log::add()` warnings (#49) +- TagTable::check() validates og_type, field lengths, canonical_url, robots directives (#43) +- CSV import/export now includes language column for multilingual support (#52) +- Batch process limit capped at 200 per request (#42) +- Canonical URL replacement uses public `getHeadData()`/`setHeadData()` API (#39) +- Language-aware queries on `loadOgDataByType()` and `loadOgDataByMenu()` (#47) + ### Removed -- Removed deploy-manual.yml workflow — using Joomla update server for distribution +- Removed dead ContentType adapters (K2, VirtueMart, HikaShop) — not targeting these platforms (#36) +- Removed `` from package manifest — managed externally (#44) +- Removed deploy-manual.yml workflow diff --git a/README.md b/README.md index 0e0e9ba..12e3480 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# MokoJoomOpenGraph +# MokoSuiteOpenGraph @@ -6,7 +6,7 @@ Open Graph, Twitter Card, and social sharing meta tag management for Joomla 4/5/ ## 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. +MokoSuiteOpenGraph 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 @@ -31,7 +31,7 @@ MokoJoomOpenGraph gives you full control over how your Joomla content appears wh - **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 +- **JSON-LD structured data** — Article, Product, WebPage, BreadcrumbList, Organization schemas ### Admin Tools - **Tag manager dashboard** — View and manage all OG records centrally @@ -43,19 +43,19 @@ MokoJoomOpenGraph gives you full control over how your Joomla content appears wh ### Developer Features - **REST API** — Full CRUD via Joomla Web Services (`/api/v1/mokoog/tags`) -- **Content type adapters** — Extensible architecture for K2, VirtueMart, HikaShop +- **MokoSuiteShop integration** — Auto-generated OG/JSON-LD for product pages with pricing meta - **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](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/releases) +1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph/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: +Navigate to **Extensions → Plugins → System - MokoSuiteOpenGraph** to configure: - Site name override - Default OG title and description (site-wide fallback) - Default fallback image