1
Admin Guide
Jonathan Miller edited this page 2026-06-29 11:17:35 -05:00

Admin Guide

Open Components → MokoSuiteOpenGraph in the Joomla administrator.

Dashboard (default view)

The dashboard is the landing screen. It shows:

  • Coverage donut — percentage of published articles that have an OG tag (green ≥ 80%, amber ≥ 50%, red below)
  • Field coverage gaps — how many tags are missing a custom title, description, or image
  • Coverage by content type — a per-content_type breakdown (com_content, menu, category, com_mokoshop)
  • Articles missing OG tags — the most recent published articles with no tag, each linking to the article editor, plus a Batch Generate shortcut

Switch between the dashboard and the tag list using the component submenu (Dashboard / Tags).

Tag Manager (Tags)

Lists every OG tag record. From here you can:

  • Search and filter by OG title and content type
  • Open the editor by clicking a tag's title
  • New — create a tag manually (you choose the content type, content ID, and language)
  • Edit — select a row and edit it
  • Publish / Unpublish / Delete — standard toolbar actions
  • SEO health badges — flags for missing description, overly long title, or noindex
  • Debug links — quick links to the Facebook Debugger, LinkedIn Inspector, and Google Rich Results test

Editing a tag

The edit screen has two tabs:

  • Details — content type, content ID, language, OG title/description/image/type, og:video, published state
  • SEO Meta Tags — SEO title, meta description, robots, canonical URL

maxlength hints match the database limits (SEO title 70, meta description 200). Required fields are validated on save.

Batch Generation

Click Batch Generate (toolbar or dashboard). The component:

  1. Counts published articles that have no OG tag
  2. Processes them in chunks, generating OG title/description/image from the article content
  3. Shows a live progress bar

Requires the mokoog.batch permission (or core create).

CSV Import / Export

  • Export CSV — downloads all OG tags (including og_video, event_data, recipe_data, custom_schema)
  • Import CSV — click Import, choose a .csv file, and upload. New columns are appended, so older exports still import. JSON columns are validated (objects/arrays only) and og_video is restricted to http/https.

The CSV header row defines the columns; content_type, content_id, and language form the unique key used to update-or-insert each row.

Requires the mokoog.import permission (or core create + edit).

Permissions

Open Options → Permissions to grant per-group access to the custom actions:

  • mokoog.batch — batch generation
  • mokoog.import — CSV import/export

These complement the standard core actions (core.create, core.edit, core.delete, core.manage).

Plugin Settings

Site-wide behaviour (defaults, JSON-LD, sitemap, AI, LocalBusiness) is configured in the System - MokoSuiteOpenGraph plugin — see Configuration.