chore(version): pre-release bump to 01.04.08-dev [skip ci]

chore(version): pre-release bump to 01.04.07-dev [skip ci]
chore(version): pre-release bump to 01.04.06-dev [skip ci]
2026-06-23 18:28:10 +00:00 · 2026-06-23 18:21:17 +00:00 · 2026-06-23 18:07:08 +00:00 · 2026-06-23 18:05:38 +00:00 · 2026-06-23 13:05:25 -05:00 · 2026-06-23 18:00:09 +00:00
37 changed files with 2897 additions and 237 deletions
@@ -156,6 +156,7 @@ vendor/
 composer.lock
 *.phar
 codeception.phar
+.phpunit.cache/
 .phpunit.result.cache
 .php_cs.cache
 .php-cs-fixer.cache
@@ -1,126 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Deploy
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API
-# PATH: /templates/workflows/joomla/deploy-manual.yml.template
-# VERSION: 04.07.00
-# BRIEF: Manual SFTP deploy to dev server for Joomla repos
-
-name: "Universal: Deploy to Dev (Manual)"
-
-on:
-  workflow_dispatch:
-    inputs:
-      clear_remote:
-        description: 'Delete all remote files before uploading'
-        required: false
-        default: 'false'
-        type: boolean
-
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-
-permissions:
-  contents: read
-
-jobs:
-  deploy:
-    name: SFTP Deploy to Dev
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-
-      - name: Setup PHP
-        run: |
-          php -v && composer --version
-
-      - name: Setup MokoStandards tools
-        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
-          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
-          MOKO_CLONE_HOST: ${{ secrets.GA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
-        run: |
-          git clone --depth 1 --branch main --quiet \
-            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
-            /tmp/mokostandards-api 2>/dev/null || true
-          if [ -d "/tmp/mokostandards-api" ] && [ -f "/tmp/mokostandards-api/composer.json" ]; then
-            cd /tmp/mokostandards-api && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
-          fi
-
-      - name: Check FTP configuration
-        id: check
-        env:
-          HOST: ${{ vars.DEV_FTP_HOST }}
-          PATH_VAR: ${{ vars.DEV_FTP_PATH }}
-          PORT: ${{ vars.DEV_FTP_PORT }}
-        run: |
-          if [ -z "$HOST" ] || [ -z "$PATH_VAR" ]; then
-            echo "DEV_FTP_HOST or DEV_FTP_PATH not configured -- cannot deploy"
-            echo "skip=true" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          echo "skip=false" >> "$GITHUB_OUTPUT"
-          echo "host=$HOST" >> "$GITHUB_OUTPUT"
-
-          REMOTE="${PATH_VAR%/}"
-          echo "remote=$REMOTE" >> "$GITHUB_OUTPUT"
-
-          [ -z "$PORT" ] && PORT="22"
-          echo "port=$PORT" >> "$GITHUB_OUTPUT"
-
-      - name: Deploy via SFTP
-        if: steps.check.outputs.skip != 'true'
-        env:
-          SFTP_KEY: ${{ secrets.DEV_FTP_KEY }}
-          SFTP_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
-          SFTP_USER: ${{ vars.DEV_FTP_USERNAME }}
-        run: |
-          SOURCE_DIR="src"
-          [ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
-          [ ! -d "$SOURCE_DIR" ] && { echo "No src/ or htdocs/ -- nothing to deploy"; exit 0; }
-
-          printf '{"host":"%s","port":%s,"username":"%s","remotePath":"%s"' \
-            "${{ steps.check.outputs.host }}" "${{ steps.check.outputs.port }}" "$SFTP_USER" "${{ steps.check.outputs.remote }}" \
-            > /tmp/sftp-config.json
-
-          if [ -n "$SFTP_KEY" ]; then
-            echo "$SFTP_KEY" > /tmp/deploy_key
-            chmod 600 /tmp/deploy_key
-            printf ',"privateKeyPath":"/tmp/deploy_key"}' >> /tmp/sftp-config.json
-          else
-            printf ',"password":"%s"}' "$SFTP_PASS" >> /tmp/sftp-config.json
-          fi
-
-          DEPLOY_ARGS=(--path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json)
-          [ "${{ inputs.clear_remote }}" = "true" ] && DEPLOY_ARGS+=(--clear-remote)
-
-          PLATFORM=$(php /tmp/mokostandards-api/cli/platform_detect.php --path . 2>/dev/null || true)
-          if [ "$PLATFORM" = "waas-component" ] && [ -f "/tmp/mokostandards-api/deploy/deploy-joomla.php" ]; then
-            php /tmp/mokostandards-api/deploy/deploy-joomla.php "${DEPLOY_ARGS[@]}"
-          else
-            php /tmp/mokostandards-api/deploy/deploy-sftp.php "${DEPLOY_ARGS[@]}"
-          fi
-
-          rm -f /tmp/deploy_key /tmp/sftp-config.json
-
-      - name: Summary
-        if: always()
-        run: |
-          if [ "${{ steps.check.outputs.skip }}" = "true" ]; then
-            echo "### Deploy Skipped -- FTP not configured" >> $GITHUB_STEP_SUMMARY
-          else
-            echo "### Manual Dev Deploy Complete" >> $GITHUB_STEP_SUMMARY
-            echo "" >> $GITHUB_STEP_SUMMARY
-            echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
-            echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
-            echo "| Host | \`${{ steps.check.outputs.host }}\` |" >> $GITHUB_STEP_SUMMARY
-            echo "| Remote | \`${{ steps.check.outputs.remote }}\` |" >> $GITHUB_STEP_SUMMARY
-            echo "| Clear | ${{ inputs.clear_remote }} |" >> $GITHUB_STEP_SUMMARY
-          fi
@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: mokocli.Automation
-# VERSION: 01.03.05
+# VERSION: 01.04.08
 # BRIEF: Auto-create feature branch when an issue is opened

 name: "Universal: Issue Branch"
@@ -1,82 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Security
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
-# PATH: /.gitea/workflows/security-audit.yml
-# VERSION: 01.00.00
-# BRIEF: Dependency vulnerability scanning for composer and npm packages
-
-name: "Universal: Security Audit"
-
-on:
-  schedule:
-    - cron: '0 6 * * 1'  # Weekly on Monday at 06:00 UTC
-  pull_request:
-    branches:
-      - main
-    paths:
-      - 'composer.json'
-      - 'composer.lock'
-      - 'package.json'
-      - 'package-lock.json'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-env:
-  NTFY_URL: ${{ vars.NTFY_URL || 'https://ntfy.mokoconsulting.tech' }}
-  NTFY_TOPIC: ${{ vars.NTFY_TOPIC || 'gitea-security' }}
-
-jobs:
-  audit:
-    name: Dependency Audit
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Composer audit
-        if: hashFiles('composer.lock') != ''
-        run: |
-          echo "=== Composer Security Audit ==="
-          if ! command -v composer &> /dev/null; then
-            sudo apt-get update -qq
-            sudo apt-get install -y -qq php-cli composer >/dev/null 2>&1
-          fi
-          composer audit --format=plain 2>&1 | tee /tmp/composer-audit.txt
-          RESULT=$?
-          if [ $RESULT -ne 0 ]; then
-            echo "::warning::Composer vulnerabilities found"
-            echo "composer_vulnerable=true" >> "$GITHUB_ENV"
-          else
-            echo "No known vulnerabilities in composer dependencies"
-          fi
-
-      - name: NPM audit
-        if: hashFiles('package-lock.json') != ''
-        run: |
-          echo "=== NPM Security Audit ==="
-          npm audit --production 2>&1 | tee /tmp/npm-audit.txt || true
-          if npm audit --production 2>&1 | grep -q "found 0 vulnerabilities"; then
-            echo "No known vulnerabilities in npm dependencies"
-          else
-            echo "::warning::NPM vulnerabilities found"
-            echo "npm_vulnerable=true" >> "$GITHUB_ENV"
-          fi
-
-      - name: Notify on vulnerabilities
-        if: env.composer_vulnerable == 'true' || env.npm_vulnerable == 'true'
-        run: |
-          REPO="${{ github.event.repository.name }}"
-          curl -sS \
-            -H "Title: ${REPO} has vulnerable dependencies" \
-            -H "Tags: lock,warning" \
-            -H "Priority: high" \
-            -d "Security audit found vulnerabilities. Review dependency updates." \
-            "${NTFY_URL}/${NTFY_TOPIC}" || true
@@ -1,6 +1,6 @@
 # Changelog

-<!-- VERSION: 01.03.05 -->
+<!-- VERSION: 01.04.08 -->

 All notable changes to MokoSuiteOpenGraph will be documented in this file.

@@ -20,6 +20,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - LinkedIn social preview card in article/menu editor alongside Facebook and Twitter/X previews (#61)
 - `og:video` meta tag support with per-article video URL field, auto-detect MIME type for YouTube/Vimeo/direct files (#59)
 - Pinterest rich pin tags: `article:tag` from Joomla content tags, `product:availability` from MokoSuiteShop stock (#60)
+- FAQ JSON-LD schema with auto-detection from article h3/h4 headings (#62)
+- HowTo JSON-LD schema with auto-detection from ordered lists (#63)
+- Event JSON-LD schema with per-article event fields (dates, venue, tickets) (#64)
+- LocalBusiness JSON-LD schema with global plugin configuration (#65)
+- Recipe JSON-LD schema with per-article fields (times, ingredients, nutrition) (#66)
+- VideoObject JSON-LD schema for articles with video URLs (#67)
+- SEO content scoring panel with 7 checks and pass/fail indicators (#68)
+- Discord, Mastodon, and Slack social preview cards in editor (#69)
+- Custom JSON-LD schema builder — per-article textarea for any schema.org type (#70)
+- AI-powered meta tag generation with Claude and OpenAI API support (#71)
+- XML sitemap generation on article save, respects noindex directives (#72)
+- OG coverage dashboard in tag manager with coverage percentage (#73)
+- Per-platform image resizing: Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400 (#74)
+- PHPUnit test suite with 16 unit tests for JsonLdBuilder (#75)
+- OpenAPI 3.0 specification for REST API (#80)
 - Site-wide default OG title and description plugin parameters
 - Discord embed color via `theme-color` meta tag (color picker in plugin config)
 - LinkedIn article tags: `article:published_time`, `article:modified_time`, `article:author`
@@ -45,6 +60,16 @@ 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

+### Fixed
+- Add exception logging to BatchController batch skip (#76)
+- Align form maxlength attributes with DB schema limits (#77)
+- Add `strip_tags()` input sanitization on OG text fields (#79)
+- Only emit `og:video:secure_url` for HTTPS URLs
+- Only emit `og:video:width/height` for direct files, not embeds
+- Consolidate duplicate MokoSuiteShop product blocks
+- Fix stale `com_virtuemart` reference in SQL comment
+- Use component language keys for og_video field in tag.xml
+
 ### 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)
@@ -1,6 +1,6 @@
 # MokoSuiteOpenGraph

-<!-- VERSION: 01.03.05 -->
+<!-- VERSION: 01.04.08 -->

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

@@ -16,6 +16,9 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
 - **LinkedIn** — `article:published_time`, `article:modified_time`, `article:author`
 - **Discord** — Custom embed color via `theme-color` meta tag
 - **Telegram** — `telegram:channel` for link previews
+- **Mastodon/Fediverse** — `fediverse:creator` for author attribution (first extension on any CMS)
+- **Pinterest** — Rich pin tags: `article:tag`, `product:availability`, `product:price`
+- **og:video** — Per-article video URLs with auto MIME type detection (YouTube/Vimeo/direct)
 - **Facebook** — `fb:app_id` support, `og:image:width`/`og:image:height` for instant previews

 ### Content Management
@@ -31,7 +34,8 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
 - **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, Product, WebPage, BreadcrumbList, Organization schemas
+- **JSON-LD structured data** — Article, Product, WebPage, BreadcrumbList, Organization, FAQ, HowTo, Event, Recipe, LocalBusiness, VideoObject, and custom schemas
+- **SEO content scoring** — 7-check analysis panel with pass/fail indicators in the editor

 ### Admin Tools
 - **Tag manager dashboard** — View and manage all OG records centrally
@@ -39,13 +43,20 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
 - **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
+- **Live preview** — Real-time Facebook, Twitter/X, LinkedIn, Discord, Mastodon, and Slack card previews in the editor
+- **Character count indicators** — Green/yellow/red warnings on OG and SEO text fields
+- **OG coverage dashboard** — Coverage percentage and missing field counts
+- **AI meta generation** — Generate OG titles and descriptions with Claude or OpenAI

 ### Developer Features
 - **REST API** — Full CRUD via Joomla Web Services (`/api/v1/mokoog/tags`)
 - **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
+- **Per-platform image resizing** — Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400
+- **XML sitemap** — Auto-generates sitemap.xml on article save, respects noindex
+- **OpenAPI spec** — Full REST API documentation at `openapi.yaml`
+- **PHPUnit tests** — 16 unit tests for JsonLdBuilder schema outputs

 ## Installation

@@ -63,6 +74,11 @@ Navigate to **Extensions → Plugins → System - MokoSuiteOpenGraph** to config
 - Facebook App ID
 - Discord embed color
 - Telegram channel
+- Fediverse/Mastodon creator handle
+- LocalBusiness schema (address, phone, hours, geo)
+- XML sitemap generation
+- AI meta generation (Claude/OpenAI API key)
+- Per-platform image resizing
 - Auto-generation, image resize, JSON-LD, and description length settings

 ## License
@@ -15,9 +15,23 @@
        "php": ">=8.1"
    },
    "require-dev": {
-        "squizlabs/php_codesniffer": "^3.7",
+        "joomla/coding-standards": "^3.0",
        "phpstan/phpstan": "^1.10",
-        "joomla/coding-standards": "^3.0"
+        "phpunit/phpunit": "^10.5",
+        "squizlabs/php_codesniffer": "^3.7"
+    },
+    "autoload": {
+        "psr-4": {
+            "Joomla\\Plugin\\System\\MokoOG\\": "source/packages/plg_system_mokoog/src/",
+            "Joomla\\Plugin\\Content\\MokoOG\\": "source/packages/plg_content_mokoog/src/",
+            "Joomla\\Plugin\\WebServices\\MokoOG\\": "source/packages/plg_webservices_mokoog/src/",
+            "Joomla\\Component\\MokoOG\\Administrator\\": "source/packages/com_mokoog/src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Mokoconsulting\\MokoOG\\Tests\\": "tests/"
+        }
    },
    "minimum-stability": "alpha",
    "prefer-stable": true,
@@ -0,0 +1,668 @@
+openapi: 3.0.3
+
+info:
+  title: MokoSuiteOpenGraph API
+  version: 1.0.0
+  description: |
+    REST API for managing Open Graph, SEO meta, and structured-data tags in
+    Joomla via the MokoSuiteOpenGraph extension.
+
+    The API follows Joomla's Web Services conventions and returns responses in
+    [JSON:API](https://jsonapi.org/) format. All endpoints require
+    authentication via a Joomla API token.
+  contact:
+    name: Moko Consulting
+    email: hello@mokoconsulting.tech
+  license:
+    name: GPL-3.0-or-later
+    url: https://www.gnu.org/licenses/gpl-3.0.html
+
+servers:
+  - url: /api/index.php/v1
+    description: Joomla Web Services API
+
+security:
+  - apiToken: []
+
+tags:
+  - name: Tags
+    description: CRUD operations for Open Graph tag records
+
+paths:
+  /mokoog/tags:
+    get:
+      operationId: listTags
+      summary: List OG tags
+      description: |
+        Returns a paginated collection of OG tag records. Supports filtering
+        by content type, published state, and language.
+      tags: [Tags]
+      parameters:
+        - name: "filter[content_type]"
+          in: query
+          description: Filter by content type (e.g. `com_content`, `menu`, `com_mokoshop`)
+          schema:
+            type: string
+            example: com_content
+        - name: "filter[content_id]"
+          in: query
+          description: Filter by content ID
+          schema:
+            type: integer
+            example: 42
+        - name: "filter[published]"
+          in: query
+          description: Filter by published state
+          schema:
+            type: integer
+            enum: [0, 1]
+        - name: "filter[language]"
+          in: query
+          description: Filter by language tag (e.g. `en-GB`, `*`)
+          schema:
+            type: string
+            example: "*"
+        - name: "filter[search]"
+          in: query
+          description: Free-text search across tag fields
+          schema:
+            type: string
+        - name: "page[offset]"
+          in: query
+          description: Number of records to skip (pagination offset)
+          schema:
+            type: integer
+            minimum: 0
+            default: 0
+        - name: "page[limit]"
+          in: query
+          description: Maximum number of records to return
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 25
+        - name: "list[fullordering]"
+          in: query
+          description: Sort order for results
+          schema:
+            type: string
+            enum:
+              - a.id ASC
+              - a.id DESC
+              - a.og_title ASC
+              - a.og_title DESC
+              - a.modified ASC
+              - a.modified DESC
+            default: a.modified DESC
+      responses:
+        "200":
+          description: A JSON:API collection of OG tags
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/TagCollection"
+              example:
+                links:
+                  self: "/api/index.php/v1/mokoog/tags"
+                data:
+                  - type: tags
+                    id: "1"
+                    attributes:
+                      content_type: com_content
+                      content_id: 42
+                      og_title: "My Article Title"
+                      og_description: "A brief description for social sharing."
+                      og_image: "images/mokoog/og-banner.jpg"
+                      og_type: article
+                      seo_title: "My Article | Example Site"
+                      meta_description: "A brief meta description for search engines."
+                      robots: "index, follow"
+                      canonical_url: "https://example.com/my-article"
+                      language: "*"
+                      published: 1
+                      created: "2026-06-01T12:00:00+00:00"
+                      modified: "2026-06-15T08:30:00+00:00"
+                meta:
+                  total-pages: 1
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
+    post:
+      operationId: createTag
+      summary: Create an OG tag
+      description: |
+        Creates a new OG tag record. The combination of `content_type`,
+        `content_id`, and `language` must be unique.
+      tags: [Tags]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TagCreateRequest"
+            example:
+              content_type: com_content
+              content_id: 42
+              og_title: "My Article Title"
+              og_description: "A brief description for social sharing."
+              og_image: "images/mokoog/og-banner.jpg"
+              og_type: article
+              language: "*"
+              published: 1
+      responses:
+        "200":
+          description: The created tag
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/TagDocument"
+              example:
+                links:
+                  self: "/api/index.php/v1/mokoog/tags/1"
+                data:
+                  type: tags
+                  id: "1"
+                  attributes:
+                    content_type: com_content
+                    content_id: 42
+                    og_title: "My Article Title"
+                    og_description: "A brief description for social sharing."
+                    og_image: "images/mokoog/og-banner.jpg"
+                    og_type: article
+                    seo_title: ""
+                    meta_description: ""
+                    robots: ""
+                    canonical_url: ""
+                    language: "*"
+                    published: 1
+                    created: "2026-06-23T10:00:00+00:00"
+                    modified: "2026-06-23T10:00:00+00:00"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
+  /mokoog/tags/{id}:
+    parameters:
+      - $ref: "#/components/parameters/TagId"
+
+    get:
+      operationId: getTag
+      summary: Get a single OG tag
+      tags: [Tags]
+      responses:
+        "200":
+          description: A single OG tag resource
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/TagDocument"
+              example:
+                links:
+                  self: "/api/index.php/v1/mokoog/tags/1"
+                data:
+                  type: tags
+                  id: "1"
+                  attributes:
+                    content_type: com_content
+                    content_id: 42
+                    og_title: "My Article Title"
+                    og_description: "A brief description for social sharing."
+                    og_image: "images/mokoog/og-banner.jpg"
+                    og_type: article
+                    seo_title: "My Article | Example Site"
+                    meta_description: "A brief meta description for search engines."
+                    robots: "index, follow"
+                    canonical_url: "https://example.com/my-article"
+                    language: "*"
+                    published: 1
+                    created: "2026-06-01T12:00:00+00:00"
+                    modified: "2026-06-15T08:30:00+00:00"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+    patch:
+      operationId: updateTag
+      summary: Update an OG tag
+      description: Partially updates an existing OG tag. Only supplied fields are changed.
+      tags: [Tags]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TagUpdateRequest"
+            example:
+              og_title: "Updated Title"
+              og_description: "Updated social description."
+              published: 0
+      responses:
+        "200":
+          description: The updated tag
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/TagDocument"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+    delete:
+      operationId: deleteTag
+      summary: Delete an OG tag
+      tags: [Tags]
+      responses:
+        "204":
+          description: Tag deleted successfully
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+  /mokoog/lookup/{content_type}/{content_id}:
+    get:
+      operationId: lookupTag
+      summary: Look up an OG tag by content type and content ID
+      description: |
+        Resolves an OG tag by its `content_type` and `content_id` pair and
+        returns the full tag resource. This is a convenience endpoint that
+        avoids the caller needing to know the internal tag ID.
+      tags: [Tags]
+      parameters:
+        - name: content_type
+          in: path
+          required: true
+          description: |
+            The content type identifier (e.g. `com_content`, `menu`,
+            `com_mokoshop`). Must match the pattern `[a-z][a-z0-9_.]*`.
+          schema:
+            type: string
+            pattern: "^[a-z][a-z0-9_.]*$"
+            example: com_content
+        - name: content_id
+          in: path
+          required: true
+          description: The content item ID
+          schema:
+            type: integer
+            minimum: 1
+            example: 42
+      responses:
+        "200":
+          description: The matching OG tag resource
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/TagDocument"
+        "400":
+          description: Missing or invalid content_type / content_id
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                errors:
+                  - title: Bad Request
+                    status: 400
+                    detail: "content_type and content_id are required"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: No OG tag found for the given content_type and content_id
+          content:
+            application/vnd.api+json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                errors:
+                  - title: Not Found
+                    status: 404
+                    detail: "OG tag not found for com_content:42"
+
+components:
+  securitySchemes:
+    apiToken:
+      type: apiKey
+      name: X-Joomla-Token
+      in: header
+      description: |
+        Joomla API token. Can also be passed as the `api-token` query
+        parameter. Generate a token from the Joomla administrator panel
+        under Users > Manage > [user] > Joomla API Token tab.
+
+  parameters:
+    TagId:
+      name: id
+      in: path
+      required: true
+      description: The OG tag record ID
+      schema:
+        type: integer
+        minimum: 1
+        example: 1
+
+  schemas:
+    TagAttributes:
+      type: object
+      description: Full set of OG tag attributes returned by the API
+      properties:
+        content_type:
+          type: string
+          description: |
+            Content type identifier (e.g. `com_content`, `menu`,
+            `com_mokoshop`). Must match `[a-z][a-z0-9_.]*`.
+          pattern: "^[a-z][a-z0-9_.]*$"
+          maxLength: 100
+          example: com_content
+        content_id:
+          type: integer
+          description: The ID of the associated content item
+          minimum: 1
+          example: 42
+        og_title:
+          type: string
+          description: Open Graph title (`og:title`)
+          maxLength: 255
+          example: "My Article Title"
+        og_description:
+          type: string
+          description: Open Graph description (`og:description`)
+          example: "A brief description for social sharing."
+        og_image:
+          type: string
+          description: Relative path to the Open Graph image (`og:image`)
+          maxLength: 512
+          example: "images/mokoog/og-banner.jpg"
+        og_type:
+          type: string
+          description: Open Graph type (`og:type`)
+          default: article
+          enum:
+            - article
+            - website
+            - product
+            - profile
+            - book
+            - music.song
+            - music.album
+            - video.movie
+            - video.episode
+            - video.other
+          example: article
+        seo_title:
+          type: string
+          description: SEO page title (used in `<title>` tag)
+          maxLength: 70
+          example: "My Article | Example Site"
+        meta_description:
+          type: string
+          description: Meta description for search engines
+          maxLength: 200
+          example: "A brief meta description for search engines."
+        robots:
+          type: string
+          description: |
+            Comma-separated robots directives. Valid directives: `index`,
+            `noindex`, `follow`, `nofollow`, `none`, `noarchive`,
+            `nosnippet`, `noimageindex`, `max-snippet`, `max-image-preview`.
+          maxLength: 100
+          example: "index, follow"
+        canonical_url:
+          type: string
+          format: uri
+          description: Canonical URL for the page
+          maxLength: 512
+          example: "https://example.com/my-article"
+        language:
+          type: string
+          description: Joomla language tag (`*` for all languages)
+          maxLength: 7
+          default: "*"
+          example: "*"
+        published:
+          type: integer
+          description: Published state (1 = published, 0 = unpublished)
+          enum: [0, 1]
+          default: 1
+          example: 1
+        created:
+          type: string
+          format: date-time
+          description: Record creation timestamp (read-only)
+          readOnly: true
+          example: "2026-06-01T12:00:00+00:00"
+        modified:
+          type: string
+          format: date-time
+          description: Last modification timestamp (read-only)
+          readOnly: true
+          example: "2026-06-15T08:30:00+00:00"
+
+    TagResource:
+      type: object
+      description: A single OG tag in JSON:API resource format
+      required: [type, id, attributes]
+      properties:
+        type:
+          type: string
+          enum: [tags]
+          example: tags
+        id:
+          type: string
+          description: The record ID as a string (per JSON:API spec)
+          example: "1"
+        attributes:
+          $ref: "#/components/schemas/TagAttributes"
+
+    TagDocument:
+      type: object
+      description: JSON:API document containing a single tag resource
+      properties:
+        links:
+          type: object
+          properties:
+            self:
+              type: string
+              example: "/api/index.php/v1/mokoog/tags/1"
+        data:
+          $ref: "#/components/schemas/TagResource"
+
+    TagCollection:
+      type: object
+      description: JSON:API document containing a collection of tag resources
+      properties:
+        links:
+          type: object
+          properties:
+            self:
+              type: string
+              example: "/api/index.php/v1/mokoog/tags"
+        data:
+          type: array
+          items:
+            $ref: "#/components/schemas/TagResource"
+        meta:
+          type: object
+          properties:
+            total-pages:
+              type: integer
+              description: Total number of pages available
+              example: 1
+
+    TagCreateRequest:
+      type: object
+      description: Request body for creating a new OG tag
+      required:
+        - content_type
+        - content_id
+      properties:
+        content_type:
+          type: string
+          pattern: "^[a-z][a-z0-9_.]*$"
+          maxLength: 100
+          example: com_content
+        content_id:
+          type: integer
+          minimum: 1
+          example: 42
+        og_title:
+          type: string
+          maxLength: 255
+        og_description:
+          type: string
+        og_image:
+          type: string
+          maxLength: 512
+        og_type:
+          type: string
+          default: article
+          enum:
+            - article
+            - website
+            - product
+            - profile
+            - book
+            - music.song
+            - music.album
+            - video.movie
+            - video.episode
+            - video.other
+        og_video:
+          type: string
+          format: uri
+          description: Open Graph video URL (`og:video`)
+          maxLength: 512
+        seo_title:
+          type: string
+          maxLength: 70
+        meta_description:
+          type: string
+          maxLength: 200
+        robots:
+          type: string
+          maxLength: 100
+        canonical_url:
+          type: string
+          format: uri
+          maxLength: 512
+        language:
+          type: string
+          maxLength: 7
+          default: "*"
+        published:
+          type: integer
+          enum: [0, 1]
+          default: 1
+
+    TagUpdateRequest:
+      type: object
+      description: |
+        Request body for updating an OG tag. All fields are optional; only
+        supplied fields are modified.
+      properties:
+        og_title:
+          type: string
+          maxLength: 255
+        og_description:
+          type: string
+        og_image:
+          type: string
+          maxLength: 512
+        og_type:
+          type: string
+          enum:
+            - article
+            - website
+            - product
+            - profile
+            - book
+            - music.song
+            - music.album
+            - video.movie
+            - video.episode
+            - video.other
+        og_video:
+          type: string
+          format: uri
+          maxLength: 512
+        seo_title:
+          type: string
+          maxLength: 70
+        meta_description:
+          type: string
+          maxLength: 200
+        robots:
+          type: string
+          maxLength: 100
+        canonical_url:
+          type: string
+          format: uri
+          maxLength: 512
+        language:
+          type: string
+          maxLength: 7
+        published:
+          type: integer
+          enum: [0, 1]
+
+    ErrorResponse:
+      type: object
+      description: JSON:API error response
+      properties:
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              title:
+                type: string
+                example: Not Found
+              status:
+                type: integer
+                example: 404
+              detail:
+                type: string
+                example: "Item not found."
+
+  responses:
+    BadRequest:
+      description: Invalid request data
+      content:
+        application/vnd.api+json:
+          schema:
+            $ref: "#/components/schemas/ErrorResponse"
+          example:
+            errors:
+              - title: Bad Request
+                status: 400
+                detail: "Content type is required."
+
+    Unauthorized:
+      description: Missing or invalid API token
+      content:
+        application/vnd.api+json:
+          schema:
+            $ref: "#/components/schemas/ErrorResponse"
+          example:
+            errors:
+              - title: Forbidden
+                status: 403
+                detail: "You are not authorised to access this resource."
+
+    NotFound:
+      description: Resource not found
+      content:
+        application/vnd.api+json:
+          schema:
+            $ref: "#/components/schemas/ErrorResponse"
+          example:
+            errors:
+              - title: Not Found
+                status: 404
+                detail: "Item not found."
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
+         bootstrap="tests/bootstrap.php"
+         colors="true"
+         cacheDirectory=".phpunit.cache">
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+    </testsuites>
+    <source>
+        <include>
+            <directory>source/packages</directory>
+        </include>
+    </source>
+</phpunit>
@@ -30,7 +30,7 @@
            label="COM_MOKOOG_FIELD_OG_TITLE"
            description="COM_MOKOOG_FIELD_OG_TITLE_DESC"
            filter="string"
-            maxlength="70"
+            maxlength="255"
        />
        <field
            name="og_description"
@@ -39,7 +39,7 @@
            description="COM_MOKOOG_FIELD_OG_DESCRIPTION_DESC"
            filter="string"
            rows="3"
-            maxlength="200"
+            maxlength="512"
        />
        <field
            name="og_image"
@@ -85,7 +85,7 @@
            label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
            description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
            filter="string"
-            maxlength="70"
+            maxlength="255"
        />
        <field
            name="meta_description"
@@ -94,7 +94,7 @@
            description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
            filter="string"
            rows="3"
-            maxlength="200"
+            maxlength="255"
        />
        <field
            name="robots"
@@ -59,3 +59,10 @@ COM_MOKOOG_IMPORT_INVALID_TYPE="Invalid file type. Please upload a .csv file."
 COM_MOKOOG_IMPORT_FILE_TOO_LARGE="File is too large. Maximum allowed size is %s."
 COM_MOKOOG_IMPORT_READ_ERROR="Could not read the uploaded CSV file."
 COM_MOKOOG_IMPORT_RESULT="Import complete: %d created, %d updated, %d skipped."
+
+COM_MOKOOG_COVERAGE_TITLE="OG Tag Coverage"
+COM_MOKOOG_COVERAGE_PERCENT="OG Coverage"
+COM_MOKOOG_COVERAGE_ARTICLES="%d of %d articles have OG tags"
+COM_MOKOOG_COVERAGE_MISSING_TITLE="%d tags missing custom title"
+COM_MOKOOG_COVERAGE_MISSING_DESC="%d tags missing custom description"
+COM_MOKOOG_COVERAGE_MISSING_IMAGE="%d tags missing custom image"
@@ -59,3 +59,10 @@ COM_MOKOOG_IMPORT_INVALID_TYPE="Invalid file type. Please upload a .csv file."
 COM_MOKOOG_IMPORT_FILE_TOO_LARGE="File is too large. Maximum allowed size is %s."
 COM_MOKOOG_IMPORT_READ_ERROR="Could not read the uploaded CSV file."
 COM_MOKOOG_IMPORT_RESULT="Import complete: %d created, %d updated, %d skipped."
+
+COM_MOKOOG_COVERAGE_TITLE="OG Tag Coverage"
+COM_MOKOOG_COVERAGE_PERCENT="OG Coverage"
+COM_MOKOOG_COVERAGE_ARTICLES="%d of %d articles have OG tags"
+COM_MOKOOG_COVERAGE_MISSING_TITLE="%d tags missing custom title"
+COM_MOKOOG_COVERAGE_MISSING_DESC="%d tags missing custom description"
+COM_MOKOOG_COVERAGE_MISSING_IMAGE="%d tags missing custom image"
@@ -8,7 +8,7 @@
 -->
 <extension type="component" method="upgrade">
    <name>com_mokoog</name>
-    <version>01.03.05</version>
+    <version>01.04.08</version>
    <creationDate>2026-05-23</creationDate>
    <author>Moko Consulting</author>
    <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -13,6 +13,9 @@ CREATE TABLE IF NOT EXISTS `#__mokoog_tags` (
    `og_image`       VARCHAR(512) NOT NULL DEFAULT '',
    `og_type`        VARCHAR(50) NOT NULL DEFAULT 'article',
    `og_video`       VARCHAR(512) NOT NULL DEFAULT '',
+    `event_data`     TEXT NULL,
+    `recipe_data`    TEXT NULL,
+    `custom_schema`  TEXT NULL,
    `seo_title`      VARCHAR(70) NOT NULL DEFAULT '',
    `meta_description` VARCHAR(200) NOT NULL DEFAULT '',
    `robots`         VARCHAR(100) NOT NULL DEFAULT '',
@@ -0,0 +1,6 @@
+--
+-- MokoJoomOpenGraph 01.04.00 - Add event_data and recipe_data columns
+--
+
+ALTER TABLE `#__mokoog_tags` ADD COLUMN `event_data` TEXT NULL AFTER `og_video`;
+ALTER TABLE `#__mokoog_tags` ADD COLUMN `recipe_data` TEXT NULL AFTER `event_data`;
@@ -0,0 +1 @@
+ALTER TABLE `#__mokoog_tags` ADD COLUMN `custom_schema` TEXT NULL AFTER `canonical_url`;
@@ -120,6 +120,7 @@ class BatchController extends BaseController
                $created++;
            } catch (\RuntimeException $e) {
                $skipped++;
+                \Joomla\CMS\Log\Log::add('Batch insert failed for article ' . $article->id . ': ' . $e->getMessage(), \Joomla\CMS\Log\Log::WARNING, 'mokoog');
            }
        }

@@ -0,0 +1,58 @@
+<?php
+
+/**
+ * @package     MokoJoomOpenGraph
+ * @subpackage  com_mokoog
+ * @author      Moko Consulting <hello@mokoconsulting.tech>
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GNU General Public License version 3 or later; see LICENSE
+ */
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+
+$db = Factory::getDbo();
+
+// Total published articles
+$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__content')->where('state = 1'));
+$totalArticles = (int) $db->loadResult();
+
+// Articles with OG tags
+$db->setQuery($db->getQuery(true)->select('COUNT(DISTINCT content_id)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where('published = 1'));
+$articlesWithOg = (int) $db->loadResult();
+
+// Articles missing OG data fields
+$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_title = ''")->where('published = 1'));
+$missingTitle = (int) $db->loadResult();
+
+$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_description = ''")->where('published = 1'));
+$missingDesc = (int) $db->loadResult();
+
+$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_image = ''")->where('published = 1'));
+$missingImage = (int) $db->loadResult();
+
+$coverage = $totalArticles > 0 ? round(($articlesWithOg / $totalArticles) * 100) : 0;
+?>
+<div class="mokoog-coverage card mb-3">
+    <div class="card-body">
+        <h4 class="card-title"><?php echo Text::_('COM_MOKOOG_COVERAGE_TITLE'); ?></h4>
+        <div class="row">
+            <div class="col-md-3 text-center">
+                <div class="display-4 <?php echo $coverage >= 80 ? 'text-success' : ($coverage >= 50 ? 'text-warning' : 'text-danger'); ?>">
+                    <?php echo $coverage; ?>%
+                </div>
+                <small class="text-muted"><?php echo Text::_('COM_MOKOOG_COVERAGE_PERCENT'); ?></small>
+            </div>
+            <div class="col-md-9">
+                <ul class="list-unstyled">
+                    <li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_ARTICLES', $articlesWithOg, $totalArticles); ?></li>
+                    <li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_TITLE', $missingTitle); ?></li>
+                    <li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_DESC', $missingDesc); ?></li>
+                    <li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_IMAGE', $missingImage); ?></li>
+                </ul>
+            </div>
+        </div>
+    </div>
+</div>
@@ -21,6 +21,7 @@ use Joomla\CMS\Session\Session;

 $token = Session::getFormToken();
 ?>
+<?php include __DIR__ . '/coverage.php'; ?>
 <form action="<?php echo Route::_('index.php?option=com_mokoog&view=tags'); ?>" method="post" name="adminForm" id="adminForm">
    <div class="row">
        <div class="col-md-12">
@@ -16,7 +16,7 @@
                label="PLG_CONTENT_MOKOOG_FIELD_OG_TITLE"
                description="PLG_CONTENT_MOKOOG_FIELD_OG_TITLE_DESC"
                filter="string"
-                maxlength="70"
+                maxlength="255"
            />
            <field
                name="og_description"
@@ -25,7 +25,7 @@
                description="PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION_DESC"
                filter="string"
                rows="3"
-                maxlength="200"
+                maxlength="512"
            />
            <field
                name="og_image"
@@ -66,7 +66,7 @@
                label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
                description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
                filter="string"
-                maxlength="70"
+                maxlength="255"
            />
            <field
                name="meta_description"
@@ -75,7 +75,7 @@
                description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
                filter="string"
                rows="3"
-                maxlength="200"
+                maxlength="255"
            />
            <field
                name="robots"
@@ -101,5 +101,29 @@
                validate="url"
            />
        </fieldset>
+        <fieldset name="mokoog_event" label="PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL"
+                  description="PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC">
+            <field name="event_start" type="calendar" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_START" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC" format="%Y-%m-%d %H:%M" filter="string" showtime="true" />
+            <field name="event_end" type="calendar" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_END" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC" format="%Y-%m-%d %H:%M" filter="string" showtime="true" />
+            <field name="event_location" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC" filter="string" />
+            <field name="event_address" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC" filter="string" />
+            <field name="event_price" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC" filter="string" />
+            <field name="event_currency" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC" filter="string" default="USD" />
+            <field name="event_url" type="url" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_URL" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC" filter="url" />
+        </fieldset>
+        <fieldset name="mokoog_recipe" label="PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL"
+                  description="PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC">
+            <field name="recipe_prep_time" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC" filter="string" hint="PT15M" />
+            <field name="recipe_cook_time" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC" filter="string" hint="PT30M" />
+            <field name="recipe_yield" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC" filter="string" hint="4 servings" />
+            <field name="recipe_calories" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC" filter="string" hint="350" />
+            <field name="recipe_ingredients" type="textarea" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC" filter="string" rows="5" hint="One ingredient per line" />
+            <field name="recipe_category" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC" filter="string" hint="Dessert" />
+            <field name="recipe_cuisine" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC" filter="string" hint="Italian" />
+        </fieldset>
+        <fieldset name="mokoog_custom_schema" label="PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL"
+                  description="PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC">
+            <field name="custom_schema" type="textarea" label="PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA" description="PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC" filter="raw" rows="12" class="input-xxlarge" />
+        </fieldset>
    </fields>
 </form>
@@ -29,3 +29,42 @@ PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this
 PLG_CONTENT_MOKOOG_ROBOTS_DEFAULT="- Use default (index, follow) -"
 PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL="Canonical URL"
 PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC="Override the canonical URL for this page. Leave blank to use the current URL."
+
+PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL="Event Details"
+PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC="Optional event information for JSON-LD Event schema."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_START="Start Date/Time"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC="Event start date and time."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_END="End Date/Time"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC="Event end date and time."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION="Venue Name"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC="Name of the event venue or location."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS="Venue Address"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC="Full address of the event venue."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE="Ticket Price"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC="Ticket price (e.g. 50.00). Leave blank if free."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY="Currency"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC="Currency code for ticket price (e.g. USD, EUR, GBP)."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_URL="Ticket URL"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC="URL where tickets can be purchased."
+
+PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL="Recipe Details"
+PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC="Optional recipe information for JSON-LD Recipe schema."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME="Prep Time"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC="Preparation time in ISO 8601 duration format (e.g. PT15M for 15 minutes)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME="Cook Time"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC="Cooking time in ISO 8601 duration format (e.g. PT30M for 30 minutes)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD="Yield"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC="Number of servings or yield (e.g. 4 servings, 1 loaf)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES="Calories"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC="Calories per serving."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS="Ingredients"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC="One ingredient per line."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY="Recipe Category"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC="Category (e.g. Dessert, Appetizer, Main course)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE="Cuisine"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC="Type of cuisine (e.g. Italian, Mexican, American)."
+
+PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL="Custom Schema"
+PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC="Add custom JSON-LD structured data for this page."
+PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA="Custom JSON-LD"
+PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC="Enter valid JSON-LD structured data. The @context will be added automatically if missing. Use for schema types not covered by built-in options (e.g. Course, JobPosting, SoftwareApplication)."
@@ -29,3 +29,42 @@ PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this
 PLG_CONTENT_MOKOOG_ROBOTS_DEFAULT="- Use default (index, follow) -"
 PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL="Canonical URL"
 PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC="Override the canonical URL for this page. Leave blank to use the current URL."
+
+PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL="Event Details"
+PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC="Optional event information for JSON-LD Event schema."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_START="Start Date/Time"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC="Event start date and time."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_END="End Date/Time"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC="Event end date and time."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION="Venue Name"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC="Name of the event venue or location."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS="Venue Address"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC="Full address of the event venue."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE="Ticket Price"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC="Ticket price (e.g. 50.00). Leave blank if free."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY="Currency"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC="Currency code for ticket price (e.g. USD, EUR, GBP)."
+PLG_CONTENT_MOKOOG_FIELD_EVENT_URL="Ticket URL"
+PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC="URL where tickets can be purchased."
+
+PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL="Recipe Details"
+PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC="Optional recipe information for JSON-LD Recipe schema."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME="Prep Time"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC="Preparation time in ISO 8601 duration format (e.g. PT15M for 15 minutes)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME="Cook Time"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC="Cooking time in ISO 8601 duration format (e.g. PT30M for 30 minutes)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD="Yield"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC="Number of servings or yield (e.g. 4 servings, 1 loaf)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES="Calories"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC="Calories per serving."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS="Ingredients"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC="One ingredient per line."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY="Recipe Category"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC="Category (e.g. Dessert, Appetizer, Main course)."
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE="Cuisine"
+PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC="Type of cuisine (e.g. Italian, Mexican, American)."
+
+PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL="Custom Schema"
+PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC="Add custom JSON-LD structured data for this page."
+PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA="Custom JSON-LD"
+PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC="Enter valid JSON-LD structured data. The @context will be added automatically if missing. Use for schema types not covered by built-in options (e.g. Course, JobPosting, SoftwareApplication)."
@@ -125,6 +125,101 @@
    text-transform: none;
 }

+/* Discord card */
+.mokoog-card-dc {
+    background: #2b2d31;
+    border-left: 4px solid #5865f2;
+    border-radius: 4px;
+}
+
+.mokoog-card-dc .mokoog-card-body {
+    border-top: none;
+}
+
+.mokoog-card-dc .mokoog-card-img {
+    height: 200px;
+    margin: 0 12px 12px;
+    border-radius: 4px;
+}
+
+.mokoog-card-dc .mokoog-card-title {
+    font-size: 16px;
+    font-weight: 700;
+    color: #00a8fc;
+}
+
+.mokoog-card-dc .mokoog-card-desc {
+    font-size: 14px;
+    color: #dbdee1;
+}
+
+.mokoog-card-dc .mokoog-card-domain {
+    font-size: 12px;
+    color: #b5bac1;
+    text-transform: none;
+}
+
+/* Mastodon card */
+.mokoog-card-ma {
+    border: 1px solid #c8ccd0;
+    border-radius: 8px;
+}
+
+.mokoog-card-ma .mokoog-card-img {
+    border-radius: 8px 8px 0 0;
+}
+
+.mokoog-card-ma .mokoog-card-body {
+    border-top-color: #c8ccd0;
+}
+
+.mokoog-card-ma .mokoog-card-title {
+    font-size: 14px;
+    font-weight: 600;
+    color: #1a1a2e;
+}
+
+.mokoog-card-ma .mokoog-card-desc {
+    font-size: 13px;
+    color: #606984;
+}
+
+.mokoog-card-ma .mokoog-card-domain {
+    font-size: 12px;
+    color: #606984;
+    text-transform: none;
+}
+
+/* Slack card */
+.mokoog-card-sl {
+    border-left: 4px solid #36c5f0;
+    border-radius: 0;
+    background: #fff;
+}
+
+.mokoog-card-sl .mokoog-card-body {
+    border-top: none;
+    padding: 8px 12px;
+}
+
+.mokoog-card-sl .mokoog-card-title {
+    font-size: 15px;
+    font-weight: 700;
+    color: #1264a3;
+}
+
+.mokoog-card-sl .mokoog-card-desc {
+    font-size: 14px;
+    color: #1d1c1d;
+}
+
+.mokoog-card-sl .mokoog-card-domain {
+    font-size: 12px;
+    color: #616061;
+    text-transform: none;
+    margin-top: 4px;
+}
+
 /* Character count indicators */
 .mokoog-char-count {
    display: block;
@@ -145,3 +240,16 @@
    color: #d32f2f;
    font-weight: 600;
 }
+
+/* SEO scoring panel */
+.mokoog-seo-score { margin: 15px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; border: 1px solid #dee2e6; }
+.mokoog-seo-heading { margin: 0 0 10px; font-size: 14px; color: #666; }
+.mokoog-seo-list { list-style: none; padding: 0; margin: 0 0 10px; }
+.mokoog-seo-item { padding: 4px 0; font-size: 13px; display: flex; align-items: center; gap: 8px; }
+.mokoog-seo-dot { width: 10px; height: 10px; border-radius: 50%; flex-shrink: 0; }
+.mokoog-seo-pass { background: #2e7d32; }
+.mokoog-seo-fail { background: #d32f2f; }
+.mokoog-seo-total { font-size: 14px; font-weight: 600; padding-top: 8px; border-top: 1px solid #dee2e6; }
+.mokoog-seo-total-good { color: #2e7d32; }
+.mokoog-seo-total-ok { color: #f57c00; }
+.mokoog-seo-total-bad { color: #d32f2f; }
@@ -53,6 +53,49 @@ document.addEventListener('DOMContentLoaded', function () {
        refresh();
    });

+    // AI Generate buttons
+    ['ogTitle', 'ogDesc'].forEach(function(fieldKey) {
+        var field = fields[fieldKey];
+        if (!field) return;
+
+        var btn = document.createElement('button');
+        btn.type = 'button';
+        btn.className = 'btn btn-sm btn-outline-primary mokoog-ai-btn';
+        btn.textContent = 'Generate with AI';
+        btn.dataset.target = fieldKey;
+        field.parentNode.appendChild(btn);
+
+        btn.addEventListener('click', function() {
+            var articleTitle = fields.articleTitle ? fields.articleTitle.value : '';
+            btn.disabled = true;
+            btn.textContent = 'Generating...';
+
+            var formData = new FormData();
+            formData.append('task', 'mokoog.aiGenerate');
+            formData.append('field', fieldKey === 'ogTitle' ? 'title' : 'description');
+            formData.append('article_title', articleTitle);
+            formData.append(Joomla.getOptions('csrf.token'), 1);
+
+            fetch(window.location.origin + '/administrator/index.php?option=com_ajax&plugin=mokoog&group=system&format=json', {
+                method: 'POST',
+                body: formData
+            })
+            .then(function(r) { return r.json(); })
+            .then(function(data) {
+                if (data.data && data.data[0]) {
+                    field.value = data.data[0];
+                    field.dispatchEvent(new Event('input'));
+                }
+                btn.disabled = false;
+                btn.textContent = 'Generate with AI';
+            })
+            .catch(function() {
+                btn.disabled = false;
+                btn.textContent = 'Generate with AI';
+            });
+        });
+    });
+
    // Find the mokoog fieldset and insert preview after it
    var fieldset = document.querySelector('[data-showon-id="mokoog"]') ||
        document.getElementById('attrib-mokoog') ||
@@ -175,6 +218,107 @@ document.addEventListener('DOMContentLoaded', function () {
    liCard.appendChild(liBody);
    wrapper.appendChild(liCard);

+    // Discord preview card
+    var dcLabel = document.createElement('small');
+    dcLabel.className = 'mokoog-platform-label';
+    dcLabel.textContent = 'Discord';
+    wrapper.appendChild(dcLabel);
+
+    var dcCard = document.createElement('div');
+    dcCard.className = 'mokoog-card mokoog-card-dc';
+
+    var dcBody = document.createElement('div');
+    dcBody.className = 'mokoog-card-body';
+
+    var dcTitle = document.createElement('div');
+    dcTitle.id = 'mokoog-dc-title';
+    dcTitle.className = 'mokoog-card-title';
+    dcBody.appendChild(dcTitle);
+
+    var dcDesc = document.createElement('div');
+    dcDesc.id = 'mokoog-dc-desc';
+    dcDesc.className = 'mokoog-card-desc';
+    dcBody.appendChild(dcDesc);
+
+    var dcDomain = document.createElement('div');
+    dcDomain.id = 'mokoog-dc-domain';
+    dcDomain.className = 'mokoog-card-domain';
+    dcBody.appendChild(dcDomain);
+
+    dcCard.appendChild(dcBody);
+
+    var dcImg = document.createElement('div');
+    dcImg.id = 'mokoog-dc-img';
+    dcImg.className = 'mokoog-card-img';
+    dcCard.appendChild(dcImg);
+
+    wrapper.appendChild(dcCard);
+
+    // Mastodon preview card
+    var maLabel = document.createElement('small');
+    maLabel.className = 'mokoog-platform-label';
+    maLabel.textContent = 'Mastodon';
+    wrapper.appendChild(maLabel);
+
+    var maCard = document.createElement('div');
+    maCard.className = 'mokoog-card mokoog-card-ma';
+
+    var maImg = document.createElement('div');
+    maImg.id = 'mokoog-ma-img';
+    maImg.className = 'mokoog-card-img';
+    maCard.appendChild(maImg);
+
+    var maBody = document.createElement('div');
+    maBody.className = 'mokoog-card-body';
+
+    var maTitle = document.createElement('div');
+    maTitle.id = 'mokoog-ma-title';
+    maTitle.className = 'mokoog-card-title';
+    maBody.appendChild(maTitle);
+
+    var maDesc = document.createElement('div');
+    maDesc.id = 'mokoog-ma-desc';
+    maDesc.className = 'mokoog-card-desc';
+    maBody.appendChild(maDesc);
+
+    var maDomain = document.createElement('div');
+    maDomain.id = 'mokoog-ma-domain';
+    maDomain.className = 'mokoog-card-domain';
+    maBody.appendChild(maDomain);
+
+    maCard.appendChild(maBody);
+    wrapper.appendChild(maCard);
+
+    // Slack preview card
+    var slLabel = document.createElement('small');
+    slLabel.className = 'mokoog-platform-label';
+    slLabel.textContent = 'Slack';
+    wrapper.appendChild(slLabel);
+
+    var slCard = document.createElement('div');
+    slCard.className = 'mokoog-card mokoog-card-sl';
+
+    var slBody = document.createElement('div');
+    slBody.className = 'mokoog-card-body';
+
+    var slTitle = document.createElement('div');
+    slTitle.id = 'mokoog-sl-title';
+    slTitle.className = 'mokoog-card-title';
+    slBody.appendChild(slTitle);
+
+    var slDesc = document.createElement('div');
+    slDesc.id = 'mokoog-sl-desc';
+    slDesc.className = 'mokoog-card-desc';
+    slBody.appendChild(slDesc);
+
+    var slDomain = document.createElement('div');
+    slDomain.id = 'mokoog-sl-domain';
+    slDomain.className = 'mokoog-card-domain';
+    slBody.appendChild(slDomain);
+
+    slCard.appendChild(slBody);
+    wrapper.appendChild(slCard);
+
    preview.appendChild(wrapper);
    fieldset.parentNode.insertBefore(preview, fieldset.nextSibling);

@@ -229,19 +373,127 @@ document.addEventListener('DOMContentLoaded', function () {
        } else {
            liImgEl.style.display = 'none';
        }
+
+        // Discord (title 256, desc 350)
+        var dcTitle = title.length > 256 ? title.substring(0, 253) + '...' : title;
+        var dcDesc = desc.length > 350 ? desc.substring(0, 347) + '...' : desc;
+        document.getElementById('mokoog-dc-title').textContent = dcTitle;
+        document.getElementById('mokoog-dc-desc').textContent = dcDesc;
+        document.getElementById('mokoog-dc-domain').textContent = domain;
+        var dcImgEl = document.getElementById('mokoog-dc-img');
+        if (img) {
+            dcImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
+            dcImgEl.style.display = '';
+        } else {
+            dcImgEl.style.display = 'none';
+        }
+
+        // Mastodon (title 70, desc 200)
+        var maTitle = title.length > 70 ? title.substring(0, 67) + '...' : title;
+        var maDesc = desc.length > 200 ? desc.substring(0, 197) + '...' : desc;
+        document.getElementById('mokoog-ma-title').textContent = maTitle;
+        document.getElementById('mokoog-ma-desc').textContent = maDesc;
+        document.getElementById('mokoog-ma-domain').textContent = domain;
+        var maImgEl = document.getElementById('mokoog-ma-img');
+        if (img) {
+            maImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
+            maImgEl.style.display = '';
+        } else {
+            maImgEl.style.display = 'none';
+        }
+
+        // Slack (title 70, desc 150, no image)
+        var slTitle = title.length > 70 ? title.substring(0, 67) + '...' : title;
+        var slDesc = desc.length > 150 ? desc.substring(0, 147) + '...' : desc;
+        document.getElementById('mokoog-sl-title').textContent = slTitle;
+        document.getElementById('mokoog-sl-desc').textContent = slDesc;
+        document.getElementById('mokoog-sl-domain').textContent = domain;
+    }
+
+    // SEO scoring panel
+    var seoChecks = [
+        { id: 'og-title', label: 'OG Title', check: function() { return fields.ogTitle && fields.ogTitle.value.length > 0; }},
+        { id: 'og-desc', label: 'OG Description', check: function() { return fields.ogDesc && fields.ogDesc.value.length > 0; }},
+        { id: 'og-image', label: 'OG Image', check: function() { return fields.ogImage && fields.ogImage.value.length > 0; }},
+        { id: 'seo-title', label: 'SEO Title', check: function() { return fields.seoTitle && fields.seoTitle.value.length > 0; }},
+        { id: 'meta-desc', label: 'Meta Description', check: function() { return fields.metaDescription && fields.metaDescription.value.length > 0; }},
+        { id: 'title-length', label: 'Title Length (\u226460)', check: function() {
+            var t = (fields.ogTitle && fields.ogTitle.value) || (fields.articleTitle && fields.articleTitle.value) || '';
+            return t.length > 0 && t.length <= 60;
+        }},
+        { id: 'desc-length', label: 'Description Length (\u2264160)', check: function() {
+            var d = (fields.ogDesc && fields.ogDesc.value) || (fields.metaDesc && fields.metaDesc.value) || '';
+            return d.length > 0 && d.length <= 160;
+        }}
+    ];
+
+    var seoPanel = document.createElement('div');
+    seoPanel.className = 'mokoog-seo-score';
+
+    var seoHeading = document.createElement('h4');
+    seoHeading.className = 'mokoog-seo-heading';
+    seoHeading.textContent = 'SEO Analysis';
+    seoPanel.appendChild(seoHeading);
+
+    var seoList = document.createElement('ul');
+    seoList.className = 'mokoog-seo-list';
+
+    var seoDots = {};
+    seoChecks.forEach(function (chk) {
+        var li = document.createElement('li');
+        li.className = 'mokoog-seo-item';
+
+        var dot = document.createElement('span');
+        dot.className = 'mokoog-seo-dot mokoog-seo-fail';
+        seoDots[chk.id] = dot;
+        li.appendChild(dot);
+
+        var label = document.createElement('span');
+        label.textContent = chk.label;
+        li.appendChild(label);
+
+        seoList.appendChild(li);
+    });
+
+    seoPanel.appendChild(seoList);
+
+    var seoTotal = document.createElement('div');
+    seoTotal.className = 'mokoog-seo-total';
+    seoPanel.appendChild(seoTotal);
+
+    wrapper.parentNode.insertBefore(seoPanel, wrapper.nextSibling);
+
+    function updateSeoScore() {
+        var passed = 0;
+        seoChecks.forEach(function (chk) {
+            var ok = chk.check();
+            if (ok) passed++;
+            seoDots[chk.id].className = 'mokoog-seo-dot ' + (ok ? 'mokoog-seo-pass' : 'mokoog-seo-fail');
+        });
+
+        seoTotal.textContent = passed + '/' + seoChecks.length + ' checks passed';
+
+        if (passed === seoChecks.length) {
+            seoTotal.className = 'mokoog-seo-total mokoog-seo-total-good';
+        } else if (passed >= Math.ceil(seoChecks.length / 2)) {
+            seoTotal.className = 'mokoog-seo-total mokoog-seo-total-ok';
+        } else {
+            seoTotal.className = 'mokoog-seo-total mokoog-seo-total-bad';
+        }
    }

    Object.values(fields).forEach(function (el) {
        if (el) {
-            el.addEventListener('input', updatePreview);
-            el.addEventListener('change', updatePreview);
+            el.addEventListener('input', function () { updatePreview(); updateSeoScore(); });
+            el.addEventListener('change', function () { updatePreview(); updateSeoScore(); });
        }
    });

    if (fields.ogImage) {
-        var observer = new MutationObserver(updatePreview);
+        var observer = new MutationObserver(function () { updatePreview(); updateSeoScore(); });
        observer.observe(fields.ogImage, { attributes: true, attributeFilter: ['value'] });
    }

    updatePreview();
+    updateSeoScore();
 });
@@ -8,7 +8,7 @@
 -->
 <extension type="plugin" group="content" method="upgrade">
    <name>Content - MokoJoomOpenGraph</name>
-    <version>01.03.05</version>
+    <version>01.04.08</version>
    <creationDate>2026-05-23</creationDate>
    <author>Moko Consulting</author>
    <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -98,7 +98,24 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
            $ogData      = $this->loadOgData($contentType, $id, $language);

            if ($ogData) {
-                $form->bind(['mokoog' => (array) $ogData]);
+                $bindData = (array) $ogData;
+
+                // Unpack JSON blob fields into individual form fields
+                foreach (['event_data', 'recipe_data'] as $jsonField) {
+                    if (!empty($bindData[$jsonField])) {
+                        $decoded = json_decode($bindData[$jsonField], true);
+
+                        if (\is_array($decoded)) {
+                            foreach ($decoded as $key => $value) {
+                                $bindData[$key] = $value;
+                            }
+                        }
+                    }
+
+                    unset($bindData[$jsonField]);
+                }
+
+                $form->bind(['mokoog' => $bindData]);
            }
        }
    }
@@ -195,6 +212,7 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
        $query = $db->getQuery(true)
            ->select($db->quoteName([
                'og_title', 'og_description', 'og_image', 'og_type', 'og_video',
+                'event_data', 'recipe_data', 'custom_schema',
                'seo_title', 'meta_description', 'robots', 'canonical_url',
            ]))
            ->from($db->quoteName('#__mokoog_tags'))
@@ -245,13 +263,16 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
            'content_type'     => $contentType,
            'content_id'       => $contentId,
            'language'         => $language,
-            'og_title'         => trim($ogData['og_title'] ?? ''),
-            'og_description'   => trim($ogData['og_description'] ?? ''),
+            'og_title'         => strip_tags(trim($ogData['og_title'] ?? '')),
+            'og_description'   => strip_tags(trim($ogData['og_description'] ?? '')),
            'og_image'         => trim($ogData['og_image'] ?? ''),
            'og_type'          => trim($ogData['og_type'] ?? 'article'),
            'og_video'         => $this->sanitizeUrl($ogData['og_video'] ?? ''),
-            'seo_title'        => trim($ogData['seo_title'] ?? ''),
-            'meta_description' => trim($ogData['meta_description'] ?? ''),
+            'event_data'       => $this->packJsonFields($ogData, ['event_start', 'event_end', 'event_location', 'event_address', 'event_price', 'event_currency', 'event_url']),
+            'recipe_data'      => $this->packJsonFields($ogData, ['recipe_prep_time', 'recipe_cook_time', 'recipe_yield', 'recipe_calories', 'recipe_ingredients', 'recipe_category', 'recipe_cuisine']),
+            'custom_schema'    => $this->validateJson($ogData['custom_schema'] ?? ''),
+            'seo_title'        => strip_tags(trim($ogData['seo_title'] ?? '')),
+            'meta_description' => strip_tags(trim($ogData['meta_description'] ?? '')),
            'robots'           => trim($robots),
            'canonical_url'    => trim($ogData['canonical_url'] ?? ''),
            'published'        => 1,
@@ -267,6 +288,47 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
        }
    }

+    /**
+     * Pack form fields into a JSON string for storage.
+     *
+     * @param   array   $ogData  Form data array
+     * @param   array   $fields  Field names to pack
+     *
+     * @return  string  JSON string or empty
+     */
+    private function packJsonFields(array $ogData, array $fields): string
+    {
+        $data = [];
+
+        foreach ($fields as $field) {
+            $val = trim($ogData[$field] ?? '');
+
+            if ($val !== '') {
+                $data[$field] = $val;
+            }
+        }
+
+        return !empty($data) ? json_encode($data) : '';
+    }
+
+    /**
+     * Validate a JSON string — returns trimmed JSON or empty string if invalid.
+     *
+     * @param   string  $json  Raw JSON input
+     *
+     * @return  string
+     */
+    private function validateJson(string $json): string
+    {
+        $json = trim($json);
+
+        if ($json === '' || json_decode($json) === null) {
+            return '';
+        }
+
+        return $json;
+    }
+
    /**
     * Sanitize a URL to only allow http/https schemes.
     *
@@ -37,5 +37,59 @@ PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
 PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ="JSON-LD FAQ Schema"
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC="Auto-detect FAQ sections from article headings (h3/h4 + paragraphs) and output FAQPage structured data."
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO="JSON-LD HowTo Schema"
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC="Auto-detect step-by-step instructions from ordered lists (ol/li) and output HowTo structured data."
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS="Local Business"
+PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED="Enable LocalBusiness Schema"
+PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC="Output LocalBusiness JSON-LD structured data on all pages."
+PLG_SYSTEM_MOKOOG_FIELD_LB_NAME="Business Name"
+PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC="Your business name for structured data."
+PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE="Business Type"
+PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC="Schema.org business type."
+PLG_SYSTEM_MOKOOG_FIELD_LB_STREET="Street Address"
+PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC="Street address of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_CITY="City"
+PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC="City of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_REGION="State/Region"
+PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC="State or region of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL="Postal Code"
+PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC="Postal/ZIP code of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY="Country"
+PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC="Country code (e.g. US, GB, DE)."
+PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE="Phone"
+PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC="Business phone number."
+PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL="Email"
+PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC="Business email address."
+PLG_SYSTEM_MOKOOG_FIELD_LB_URL="Website URL"
+PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC="Business website URL."
+PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS="Opening Hours"
+PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC="Opening hours in schema.org format (e.g. Mo-Fr 09:00-17:00)."
+PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE="Latitude"
+PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC="Geographic latitude of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE="Longitude"
+PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC="Geographic longitude of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE="Price Range"
+PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC="Price range indicator (e.g. $, $$, $$$)."
+PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE="Per-platform Image Sizes"
+PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC="Generate platform-specific image sizes (Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400) in addition to the default Facebook 1200x630."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP="XML Sitemap"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED="Enable Sitemap"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC="Auto-generate sitemap.xml when articles are saved. Respects noindex robots directives."
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ="Change Frequency"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC="Default change frequency for sitemap entries."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_AI="AI Meta Generation"
+PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED="Enable AI Generation"
+PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC="Show Generate with AI buttons next to OG title and description fields."
+PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER="AI Provider"
+PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC="Select the AI API provider."
+PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY="API Key"
+PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC="Your AI provider API key."
+PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL="Model"
+PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC="AI model to use for generation."
@@ -37,5 +37,59 @@ PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
 PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ="JSON-LD FAQ Schema"
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC="Auto-detect FAQ sections from article headings (h3/h4 + paragraphs) and output FAQPage structured data."
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO="JSON-LD HowTo Schema"
+PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC="Auto-detect step-by-step instructions from ordered lists (ol/li) and output HowTo structured data."
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
 PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS="Local Business"
+PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED="Enable LocalBusiness Schema"
+PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC="Output LocalBusiness JSON-LD structured data on all pages."
+PLG_SYSTEM_MOKOOG_FIELD_LB_NAME="Business Name"
+PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC="Your business name for structured data."
+PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE="Business Type"
+PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC="Schema.org business type."
+PLG_SYSTEM_MOKOOG_FIELD_LB_STREET="Street Address"
+PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC="Street address of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_CITY="City"
+PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC="City of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_REGION="State/Region"
+PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC="State or region of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL="Postal Code"
+PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC="Postal/ZIP code of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY="Country"
+PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC="Country code (e.g. US, GB, DE)."
+PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE="Phone"
+PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC="Business phone number."
+PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL="Email"
+PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC="Business email address."
+PLG_SYSTEM_MOKOOG_FIELD_LB_URL="Website URL"
+PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC="Business website URL."
+PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS="Opening Hours"
+PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC="Opening hours in schema.org format (e.g. Mo-Fr 09:00-17:00)."
+PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE="Latitude"
+PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC="Geographic latitude of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE="Longitude"
+PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC="Geographic longitude of your business."
+PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE="Price Range"
+PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC="Price range indicator (e.g. $, $$, $$$)."
+PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE="Per-platform Image Sizes"
+PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC="Generate platform-specific image sizes (Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400) in addition to the default Facebook 1200x630."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP="XML Sitemap"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED="Enable Sitemap"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC="Auto-generate sitemap.xml when articles are saved. Respects noindex robots directives."
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ="Change Frequency"
+PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC="Default change frequency for sitemap entries."
+
+PLG_SYSTEM_MOKOOG_FIELDSET_AI="AI Meta Generation"
+PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED="Enable AI Generation"
+PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC="Show Generate with AI buttons next to OG title and description fields."
+PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER="AI Provider"
+PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC="Select the AI API provider."
+PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY="API Key"
+PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC="Your AI provider API key."
+PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL="Model"
+PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC="AI model to use for generation."
@@ -8,7 +8,7 @@
 -->
 <extension type="plugin" group="system" method="upgrade">
    <name>System - MokoJoomOpenGraph</name>
-    <version>01.03.05</version>
+    <version>01.04.08</version>
    <creationDate>2026-05-23</creationDate>
    <author>Moko Consulting</author>
    <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -158,6 +158,17 @@
                    <option value="1">JYES</option>
                    <option value="0">JNO</option>
                </field>
+                <field
+                    name="platform_resize"
+                    type="radio"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC"
+                    default="0"
+                    class="btn-group"
+                >
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
                <field
                    name="jsonld_enabled"
                    type="radio"
@@ -169,6 +180,28 @@
                    <option value="1">JYES</option>
                    <option value="0">JNO</option>
                </field>
+                <field
+                    name="jsonld_faq"
+                    type="radio"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC"
+                    default="1"
+                    class="btn-group"
+                >
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
+                <field
+                    name="jsonld_howto"
+                    type="radio"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC"
+                    default="1"
+                    class="btn-group"
+                >
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
                <field
                    name="jsonld_breadcrumbs"
                    type="radio"
@@ -181,6 +214,158 @@
                    <option value="0">JNO</option>
                </field>
            </fieldset>
+            <fieldset name="localbusiness" label="PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS">
+                <field
+                    name="lb_enabled"
+                    type="radio"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC"
+                    default="0"
+                    class="btn-group"
+                >
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
+                <field
+                    name="lb_name"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_NAME"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_type"
+                    type="list"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC"
+                    default="LocalBusiness"
+                >
+                    <option value="LocalBusiness">LocalBusiness</option>
+                    <option value="Restaurant">Restaurant</option>
+                    <option value="Store">Store</option>
+                    <option value="MedicalBusiness">MedicalBusiness</option>
+                    <option value="LegalService">LegalService</option>
+                    <option value="FinancialService">FinancialService</option>
+                    <option value="EducationalOrganization">EducationalOrganization</option>
+                </field>
+                <field
+                    name="lb_street"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_STREET"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_city"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_CITY"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_region"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_REGION"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_postal"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_country"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC"
+                    default="US"
+                    filter="string"
+                />
+                <field
+                    name="lb_phone"
+                    type="tel"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC"
+                    default=""
+                />
+                <field
+                    name="lb_email"
+                    type="email"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC"
+                    default=""
+                />
+                <field
+                    name="lb_url"
+                    type="url"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_URL"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC"
+                    default=""
+                />
+                <field
+                    name="lb_opening_hours"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_latitude"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_longitude"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC"
+                    default=""
+                    filter="string"
+                />
+                <field
+                    name="lb_price_range"
+                    type="text"
+                    label="PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE"
+                    description="PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC"
+                    default=""
+                    filter="string"
+                />
+            </fieldset>
+            <fieldset name="sitemap" label="PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP">
+                <field name="sitemap_enabled" type="radio" label="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED" description="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC" default="0" class="btn-group">
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
+                <field name="sitemap_changefreq" type="list" label="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ" description="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC" default="weekly">
+                    <option value="daily">Daily</option>
+                    <option value="weekly">Weekly</option>
+                    <option value="monthly">Monthly</option>
+                </field>
+            </fieldset>
+            <fieldset name="ai" label="PLG_SYSTEM_MOKOOG_FIELDSET_AI">
+                <field name="ai_enabled" type="radio" label="PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED" description="PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC" default="0" class="btn-group">
+                    <option value="1">JYES</option>
+                    <option value="0">JNO</option>
+                </field>
+                <field name="ai_provider" type="list" label="PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER" description="PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC" default="claude">
+                    <option value="claude">Claude (Anthropic)</option>
+                    <option value="openai">OpenAI</option>
+                </field>
+                <field name="ai_api_key" type="password" label="PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY" description="PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC" filter="string" />
+                <field name="ai_model" type="text" label="PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL" description="PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC" default="claude-haiku-4-5-20251001" filter="string" />
+            </fieldset>
        </fields>
    </config>
 </extension>
@@ -19,6 +19,7 @@ use Joomla\Event\Event;
 use Joomla\Event\SubscriberInterface;
 use Joomla\Plugin\System\MokoOG\Helper\ImageHelper;
 use Joomla\Plugin\System\MokoOG\Helper\JsonLdBuilder;
+use Joomla\Plugin\System\MokoOG\Helper\SitemapBuilder;

 final class MokoOG extends CMSPlugin implements SubscriberInterface
 {
@@ -37,6 +38,8 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
        return [
            'onAfterRoute'        => 'onAfterRoute',
            'onBeforeCompileHead' => 'onBeforeCompileHead',
+            'onContentAfterSave'  => 'onContentAfterSaveRebuildSitemap',
+            'onAjaxMokoog'        => 'onAjaxMokoog',
        ];
    }

@@ -156,7 +159,10 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
        $doc->setMetaData('twitter:description', $description);

        if ($image) {
-            $doc->setMetaData('twitter:image', $this->resolveImageUrl($image));
+            $twitterImage = ($this->params->get('auto_resize', 1) && $this->params->get('platform_resize', 0))
+                ? ImageHelper::resizeForPlatform($image, 'twitter')
+                : $image;
+            $doc->setMetaData('twitter:image', $this->resolveImageUrl($twitterImage));
        }

        if ($twitterSite) {
@@ -282,6 +288,85 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
                $doc->addCustomTag(JsonLdBuilder::toScriptTag($schema));
            }

+            if (!empty($ogData->og_video)) {
+                $videoSchema = JsonLdBuilder::buildVideo($ogData->og_video, $title, $description, $imageUrl);
+
+                if ($videoSchema) {
+                    $doc->addCustomTag(JsonLdBuilder::toScriptTag($videoSchema));
+                }
+            }
+
+            // FAQ schema (auto-detected from article headings)
+            if ($this->params->get('jsonld_faq', 1) && $option === 'com_content' && $view === 'article' && $id > 0) {
+                $faqItems = $this->extractFaqFromContent($id);
+
+                if (!empty($faqItems)) {
+                    $faqSchema = JsonLdBuilder::buildFaq($faqItems);
+
+                    if ($faqSchema) {
+                        $doc->addCustomTag(JsonLdBuilder::toScriptTag($faqSchema));
+                    }
+                }
+            }
+
+            // HowTo schema (auto-detected from ordered lists)
+            if ($this->params->get('jsonld_howto', 1) && $option === 'com_content' && $view === 'article' && $id > 0) {
+                $howToSteps = $this->extractHowToFromContent($id);
+
+                if (!empty($howToSteps)) {
+                    $howToSchema = JsonLdBuilder::buildHowTo($title, $howToSteps, $imageUrl);
+
+                    if ($howToSchema) {
+                        $doc->addCustomTag(JsonLdBuilder::toScriptTag($howToSchema));
+                    }
+                }
+            }
+
+            // Event JSON-LD from per-article event data
+            $eventJson = $ogData->event_data ?? '';
+
+            if (!empty($eventJson)) {
+                $eventObj = json_decode($eventJson);
+
+                if ($eventObj && !empty($eventObj->event_start)) {
+                    $eventSchema = JsonLdBuilder::buildEvent($title, $description, $imageUrl, $eventObj);
+
+                    if ($eventSchema) {
+                        $doc->addCustomTag(JsonLdBuilder::toScriptTag($eventSchema));
+                    }
+                }
+            }
+
+            // Recipe JSON-LD from per-article recipe data
+            $recipeJson = $ogData->recipe_data ?? '';
+
+            if (!empty($recipeJson)) {
+                $recipeObj = json_decode($recipeJson);
+
+                if ($recipeObj) {
+                    $recipeSchema = JsonLdBuilder::buildRecipe($title, $description, $imageUrl, $recipeObj);
+
+                    if ($recipeSchema) {
+                        $doc->addCustomTag(JsonLdBuilder::toScriptTag($recipeSchema));
+                    }
+                }
+            }
+
+            // Custom JSON-LD schema (user-provided)
+            $customSchema = $ogData->custom_schema ?? '';
+
+            if (!empty($customSchema)) {
+                $decoded = json_decode($customSchema, true);
+
+                if ($decoded) {
+                    if (empty($decoded['@context'])) {
+                        $decoded['@context'] = 'https://schema.org';
+                    }
+
+                    $doc->addCustomTag(JsonLdBuilder::toScriptTag($decoded));
+                }
+            }
+
            if ($this->params->get('jsonld_breadcrumbs', 1)) {
                $breadcrumbs = JsonLdBuilder::buildBreadcrumbs();

@@ -290,6 +375,15 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
                }
            }
        }
+
+        // LocalBusiness JSON-LD
+        if ($this->params->get('lb_enabled', 0)) {
+            $lbSchema = JsonLdBuilder::buildLocalBusiness($this->params);
+
+            if ($lbSchema) {
+                $doc->addCustomTag(JsonLdBuilder::toScriptTag($lbSchema));
+            }
+        }
    }

    /**
@@ -353,6 +447,9 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
            'og_image'         => '',
            'og_type'          => '',
            'og_video'         => '',
+            'event_data'       => '',
+            'recipe_data'      => '',
+            'custom_schema'    => '',
            'seo_title'        => '',
            'meta_description' => '',
            'robots'           => '',
@@ -623,6 +720,220 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
        return $article->author_name ?? '';
    }

+    /**
+     * Extract FAQ question/answer pairs from article content.
+     *
+     * @param   int  $articleId  Article ID
+     *
+     * @return  array  Array of ['question' => '...', 'answer' => '...'] pairs
+     */
+    private function extractFaqFromContent(int $articleId): array
+    {
+        $article = $this->loadArticle($articleId);
+
+        if (!$article) {
+            return [];
+        }
+
+        $content = ($article->introtext ?? '') . ($article->fulltext ?? '');
+
+        if (trim($content) === '') {
+            return [];
+        }
+
+        $faqItems = [];
+
+        if (preg_match_all('/<h[34][^>]*>(.*?)<\/h[34]>\s*((?:<p[^>]*>.*?<\/p>\s*)+)/si', $content, $matches, PREG_SET_ORDER)) {
+            foreach ($matches as $match) {
+                $question = trim(strip_tags($match[1]));
+                $answer   = trim(strip_tags($match[2]));
+
+                if ($question !== '' && $answer !== '') {
+                    $faqItems[] = [
+                        'question' => $question,
+                        'answer'   => $answer,
+                    ];
+                }
+            }
+        }
+
+        return $faqItems;
+    }
+
+    /**
+     * Extract HowTo steps from ordered lists in article content.
+     *
+     * @param   int  $articleId  Article ID
+     *
+     * @return  array  Array of ['name' => '...', 'text' => '...'] pairs
+     */
+    private function extractHowToFromContent(int $articleId): array
+    {
+        $article = $this->loadArticle($articleId);
+
+        if (!$article) {
+            return [];
+        }
+
+        $content = ($article->introtext ?? '') . ($article->fulltext ?? '');
+
+        if (!preg_match('/<ol[^>]*>(.*?)<\/ol>/si', $content, $olMatch)) {
+            return [];
+        }
+
+        if (!preg_match_all('/<li[^>]*>(.*?)<\/li>/si', $olMatch[1], $liMatches)) {
+            return [];
+        }
+
+        $steps = [];
+
+        foreach ($liMatches[1] as $liHtml) {
+            $text = trim(strip_tags($liHtml));
+
+            if ($text === '') {
+                continue;
+            }
+
+            $name = $text;
+
+            if (preg_match('/<(?:b|strong)[^>]*>(.*?)<\/(?:b|strong)>/si', $liHtml, $boldMatch)) {
+                $name = trim(strip_tags($boldMatch[1]));
+            } elseif (preg_match('/^([^.!?]+[.!?])/', $text, $sentenceMatch)) {
+                $name = trim($sentenceMatch[1]);
+            }
+
+            $steps[] = [
+                'name' => $name,
+                'text' => $text,
+            ];
+        }
+
+        return $steps;
+    }
+
+    /**
+     * Rebuild sitemap.xml when article content is saved.
+     *
+     * @param   Event  $event  The event
+     *
+     * @return  void
+     */
+    public function onContentAfterSaveRebuildSitemap(Event $event): void
+    {
+        if (!$this->params->get('sitemap_enabled', 0)) {
+            return;
+        }
+
+        [$context] = array_values($event->getArguments());
+
+        if ($context !== 'com_content.article') {
+            return;
+        }
+
+        $changefreq = $this->params->get('sitemap_changefreq', 'weekly');
+        $xml = SitemapBuilder::generate($changefreq);
+        SitemapBuilder::writeToFile($xml);
+    }
+
+    /**
+     * Handle AJAX requests for AI meta tag generation.
+     *
+     * @param   Event  $event  The event
+     *
+     * @return  void
+     */
+    public function onAjaxMokoog(Event $event): void
+    {
+        $app = $this->getApplication();
+
+        if (!$app->isClient('administrator')) {
+            return;
+        }
+
+        \Joomla\CMS\Session\Session::checkToken() or die('Invalid Token');
+
+        if (!$this->params->get('ai_enabled', 0)) {
+            $event->setArgument('result', ['AI generation is not enabled']);
+            return;
+        }
+
+        $apiKey   = $this->params->get('ai_api_key', '');
+        $provider = $this->params->get('ai_provider', 'claude');
+        $model    = $this->params->get('ai_model', 'claude-haiku-4-5-20251001');
+
+        if (empty($apiKey)) {
+            $event->setArgument('result', ['API key not configured']);
+            return;
+        }
+
+        $input        = $app->getInput();
+        $field        = $input->getString('field', 'title');
+        $articleTitle = $input->getString('article_title', '');
+
+        $prompt = $field === 'title'
+            ? "Generate a concise, engaging social media sharing title (max 60 characters) for an article titled: \"$articleTitle\". Return only the title text, no quotes or explanation."
+            : "Generate a compelling social media sharing description (max 155 characters) for an article titled: \"$articleTitle\". Return only the description text, no quotes or explanation.";
+
+        try {
+            $result = $this->callAiApi($provider, $apiKey, $model, $prompt);
+            $event->setArgument('result', [$result]);
+        } catch (\Exception $e) {
+            $event->setArgument('result', ['Error: ' . $e->getMessage()]);
+        }
+    }
+
+    /**
+     * Call an AI API (Claude or OpenAI) with a prompt.
+     *
+     * @param   string  $provider  Provider name (claude or openai)
+     * @param   string  $apiKey    API key
+     * @param   string  $model     Model name
+     * @param   string  $prompt    Prompt text
+     *
+     * @return  string  Generated text
+     */
+    private function callAiApi(string $provider, string $apiKey, string $model, string $prompt): string
+    {
+        $http = \Joomla\CMS\Http\HttpFactory::getHttp();
+
+        if ($provider === 'claude') {
+            $response = $http->post(
+                'https://api.anthropic.com/v1/messages',
+                json_encode([
+                    'model'      => $model,
+                    'max_tokens' => 200,
+                    'messages'   => [['role' => 'user', 'content' => $prompt]],
+                ]),
+                [
+                    'Content-Type'      => 'application/json',
+                    'x-api-key'         => $apiKey,
+                    'anthropic-version'  => '2023-06-01',
+                ]
+            );
+
+            $data = json_decode($response->body, true);
+
+            return trim($data['content'][0]['text'] ?? '');
+        }
+
+        $response = $http->post(
+            'https://api.openai.com/v1/chat/completions',
+            json_encode([
+                'model'      => $model,
+                'max_tokens' => 200,
+                'messages'   => [['role' => 'user', 'content' => $prompt]],
+            ]),
+            [
+                'Content-Type'  => 'application/json',
+                'Authorization' => 'Bearer ' . $apiKey,
+            ]
+        );
+
+        $data = json_decode($response->body, true);
+
+        return trim($data['choices'][0]['message']['content'] ?? '');
+    }
+
    /**
     * Warn administrators once per session when no license key is configured.
     *
@@ -149,6 +149,137 @@ class ImageHelper
        return $outputRel;
    }

+    /**
+     * Resize an image for a specific platform.
+     *
+     * @param   string  $imagePath  Relative image path
+     * @param   string  $platform   Platform name (facebook, twitter, pinterest, whatsapp)
+     *
+     * @return  string  Path to the resized image
+     */
+    public static function resizeForPlatform(string $imagePath, string $platform): string
+    {
+        $sizes = [
+            'facebook'  => ['width' => 1200, 'height' => 630],
+            'twitter'   => ['width' => 1200, 'height' => 600],
+            'pinterest' => ['width' => 1000, 'height' => 1500],
+            'whatsapp'  => ['width' => 400, 'height' => 400],
+        ];
+
+        if (!isset($sizes[$platform])) {
+            return self::resize($imagePath);
+        }
+
+        $size = $sizes[$platform];
+
+        return self::resizeToSize($imagePath, $size['width'], $size['height'], $platform);
+    }
+
+    /**
+     * Resize an image to specific dimensions with a platform-specific subdirectory.
+     *
+     * @param   string  $imagePath  Image path relative to JPATH_ROOT
+     * @param   int     $width      Target width
+     * @param   int     $height     Target height
+     * @param   string  $subdir     Subdirectory name for output (e.g. platform name)
+     *
+     * @return  string  Path to the output image (relative to JPATH_ROOT)
+     */
+    private static function resizeToSize(string $imagePath, int $width, int $height, string $subdir = ''): string
+    {
+        // Resolve absolute path
+        $absPath = JPATH_ROOT . '/' . ltrim($imagePath, '/');
+
+        if (!is_file($absPath)) {
+            return $imagePath;
+        }
+
+        $imageInfo = getimagesize($absPath);
+
+        if (!$imageInfo) {
+            Log::add('MokoOG ImageHelper: Cannot read image dimensions: ' . basename($absPath), Log::WARNING, 'mokoog');
+
+            return $imagePath;
+        }
+
+        [$origWidth, $origHeight, $type] = $imageInfo;
+
+        // Skip if already at or below target size
+        if ($origWidth <= $width && $origHeight <= $height) {
+            return $imagePath;
+        }
+
+        // Build output directory with optional subdirectory
+        $outputRelDir = self::OUTPUT_DIR . ($subdir ? '/' . $subdir : '');
+        $outputDir    = JPATH_ROOT . '/' . $outputRelDir;
+
+        if (!is_dir($outputDir) && !Folder::create($outputDir)) {
+            Log::add('MokoOG ImageHelper: Cannot create output directory: ' . $outputRelDir, Log::WARNING, 'mokoog');
+
+            return $imagePath;
+        }
+
+        // Generate output filename based on source hash + dimensions
+        $hash       = md5($imagePath . $width . $height);
+        $outputName = $hash . '.jpg';
+        $outputPath = $outputDir . '/' . $outputName;
+        $outputRel  = $outputRelDir . '/' . $outputName;
+
+        // Skip if already generated
+        if (is_file($outputPath) && filemtime($outputPath) >= filemtime($absPath)) {
+            return $outputRel;
+        }
+
+        // Load source image
+        $source = self::loadImage($absPath, $type);
+
+        if (!$source) {
+            return $imagePath;
+        }
+
+        // Calculate crop dimensions (center crop to target aspect ratio)
+        $targetRatio = $width / $height;
+        $sourceRatio = $origWidth / $origHeight;
+
+        if ($sourceRatio > $targetRatio) {
+            // Source is wider — crop sides
+            $cropHeight = $origHeight;
+            $cropWidth  = (int) round($origHeight * $targetRatio);
+            $cropX      = (int) round(($origWidth - $cropWidth) / 2);
+            $cropY      = 0;
+        } else {
+            // Source is taller — crop top/bottom
+            $cropWidth  = $origWidth;
+            $cropHeight = (int) round($origWidth / $targetRatio);
+            $cropX      = 0;
+            $cropY      = (int) round(($origHeight - $cropHeight) / 2);
+        }
+
+        // Create output canvas and resample
+        $output = imagecreatetruecolor($width, $height);
+
+        imagecopyresampled(
+            $output,
+            $source,
+            0,
+            0,
+            $cropX,
+            $cropY,
+            $width,
+            $height,
+            $cropWidth,
+            $cropHeight
+        );
+
+        // Save as JPEG
+        imagejpeg($output, $outputPath, self::JPEG_QUALITY);
+
+        imagedestroy($source);
+        imagedestroy($output);
+
+        return $outputRel;
+    }
+
    /**
     * Remove a generated image file.
     *
@@ -248,6 +248,413 @@ class JsonLdBuilder
        return $schema;
    }

+    /**
+     * Build VideoObject schema for pages with a video URL.
+     *
+     * @param   string  $videoUrl     Video URL (e.g. YouTube, Vimeo, or direct)
+     * @param   string  $title        Video title
+     * @param   string  $description  Video description
+     * @param   string  $imageUrl     Thumbnail image URL (absolute)
+     *
+     * @return  array|null
+     */
+    public static function buildVideo(string $videoUrl, string $title, string $description, string $imageUrl): ?array
+    {
+        if (empty($videoUrl)) {
+            return null;
+        }
+
+        $schema = [
+            '@context'     => 'https://schema.org',
+            '@type'        => 'VideoObject',
+            'name'         => $title,
+            'description'  => $description,
+            'thumbnailUrl' => $imageUrl,
+            'contentUrl'   => $videoUrl,
+            'uploadDate'   => Factory::getDate()->toISO8601(),
+        ];
+
+        // Add embedUrl for YouTube and Vimeo
+        if (preg_match('/youtube\.com|youtu\.be|vimeo\.com/i', $videoUrl)) {
+            $schema['embedUrl'] = $videoUrl;
+        }
+
+        return $schema;
+    }
+
+    /**
+     * Build LocalBusiness schema from plugin parameters.
+     *
+     * @param   object  $params  Plugin parameters object
+     *
+     * @return  array|null
+     */
+    public static function buildLocalBusiness(object $params): ?array
+    {
+        $name = trim((string) $params->get('lb_name', ''));
+
+        if ($name === '') {
+            return null;
+        }
+
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type'    => $params->get('lb_type', 'LocalBusiness'),
+            'name'     => $name,
+        ];
+
+        // Build PostalAddress
+        $address = [];
+        $street  = trim((string) $params->get('lb_street', ''));
+        $city    = trim((string) $params->get('lb_city', ''));
+        $region  = trim((string) $params->get('lb_region', ''));
+        $postal  = trim((string) $params->get('lb_postal', ''));
+        $country = trim((string) $params->get('lb_country', ''));
+
+        if ($street !== '') {
+            $address['streetAddress'] = $street;
+        }
+
+        if ($city !== '') {
+            $address['addressLocality'] = $city;
+        }
+
+        if ($region !== '') {
+            $address['addressRegion'] = $region;
+        }
+
+        if ($postal !== '') {
+            $address['postalCode'] = $postal;
+        }
+
+        if ($country !== '') {
+            $address['addressCountry'] = $country;
+        }
+
+        if (!empty($address)) {
+            $address['@type'] = 'PostalAddress';
+            $schema['address'] = $address;
+        }
+
+        // Contact properties
+        $phone = trim((string) $params->get('lb_phone', ''));
+        $email = trim((string) $params->get('lb_email', ''));
+        $url   = trim((string) $params->get('lb_url', ''));
+
+        if ($phone !== '') {
+            $schema['telephone'] = $phone;
+        }
+
+        if ($email !== '') {
+            $schema['email'] = $email;
+        }
+
+        if ($url !== '') {
+            $schema['url'] = $url;
+        }
+
+        // Opening hours
+        $openingHours = trim((string) $params->get('lb_opening_hours', ''));
+
+        if ($openingHours !== '') {
+            $schema['openingHours'] = $openingHours;
+        }
+
+        // GeoCoordinates
+        $latitude  = trim((string) $params->get('lb_latitude', ''));
+        $longitude = trim((string) $params->get('lb_longitude', ''));
+
+        if ($latitude !== '' && $longitude !== '') {
+            $schema['geo'] = [
+                '@type'     => 'GeoCoordinates',
+                'latitude'  => $latitude,
+                'longitude' => $longitude,
+            ];
+        }
+
+        // Price range
+        $priceRange = trim((string) $params->get('lb_price_range', ''));
+
+        if ($priceRange !== '') {
+            $schema['priceRange'] = $priceRange;
+        }
+
+        return $schema;
+    }
+
+    /**
+     * Build FAQPage schema from question/answer pairs.
+     *
+     * @param   array  $questions  Array of ['question' => '...', 'answer' => '...'] pairs
+     *
+     * @return  array|null
+     */
+    public static function buildFaq(array $questions): ?array
+    {
+        if (empty($questions)) {
+            return null;
+        }
+
+        $mainEntity = [];
+
+        foreach ($questions as $item) {
+            $question = trim($item['question'] ?? '');
+            $answer   = trim($item['answer'] ?? '');
+
+            if ($question === '' || $answer === '') {
+                continue;
+            }
+
+            $mainEntity[] = [
+                '@type' => 'Question',
+                'name'  => $question,
+                'acceptedAnswer' => [
+                    '@type' => 'Answer',
+                    'text'  => $answer,
+                ],
+            ];
+        }
+
+        if (empty($mainEntity)) {
+            return null;
+        }
+
+        return [
+            '@context'   => 'https://schema.org',
+            '@type'      => 'FAQPage',
+            'mainEntity' => $mainEntity,
+        ];
+    }
+
+    /**
+     * Build HowTo schema from step-by-step instructions.
+     *
+     * @param   string  $title     HowTo title
+     * @param   array   $steps     Array of ['name' => 'Step title', 'text' => 'Step instructions']
+     * @param   string  $imageUrl  Optional image URL (absolute)
+     *
+     * @return  array|null
+     */
+    public static function buildHowTo(string $title, array $steps, string $imageUrl = ''): ?array
+    {
+        if (empty($steps)) {
+            return null;
+        }
+
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type'    => 'HowTo',
+            'name'     => $title,
+        ];
+
+        if (!empty($imageUrl)) {
+            $schema['image'] = $imageUrl;
+        }
+
+        $schema['step'] = [];
+
+        foreach ($steps as $step) {
+            $schema['step'][] = [
+                '@type' => 'HowToStep',
+                'name'  => $step['name'],
+                'text'  => $step['text'],
+            ];
+        }
+
+        return $schema;
+    }
+
+    /**
+     * Build Event schema from per-article event data.
+     *
+     * @param   string  $title        Event/article title
+     * @param   string  $description  Event description
+     * @param   string  $imageUrl     Image URL (absolute)
+     * @param   object  $eventData    Decoded event_data with event_start, event_end, etc.
+     *
+     * @return  array|null
+     */
+    public static function buildEvent(string $title, string $description, string $imageUrl, object $eventData): ?array
+    {
+        $startDate = $eventData->event_start ?? '';
+
+        if (empty($startDate)) {
+            return null;
+        }
+
+        $schema = [
+            '@context'    => 'https://schema.org',
+            '@type'       => 'Event',
+            'name'        => $title,
+            'description' => $description,
+            'startDate'   => $startDate,
+            'url'         => Uri::getInstance()->toString(),
+        ];
+
+        $endDate = $eventData->event_end ?? '';
+
+        if (!empty($endDate)) {
+            $schema['endDate'] = $endDate;
+        }
+
+        if (!empty($imageUrl)) {
+            $schema['image'] = $imageUrl;
+        }
+
+        $locationName = $eventData->event_location ?? '';
+        $address      = $eventData->event_address ?? '';
+
+        if (!empty($locationName) || !empty($address)) {
+            $location = ['@type' => 'Place'];
+
+            if (!empty($locationName)) {
+                $location['name'] = $locationName;
+            }
+
+            if (!empty($address)) {
+                $location['address'] = [
+                    '@type'         => 'PostalAddress',
+                    'streetAddress' => $address,
+                ];
+            }
+
+            $schema['location'] = $location;
+        }
+
+        $price     = $eventData->event_price ?? '';
+        $currency  = $eventData->event_currency ?? 'USD';
+        $ticketUrl = $eventData->event_url ?? '';
+
+        if ($price !== '') {
+            $offer = [
+                '@type'         => 'Offer',
+                'price'         => number_format((float) $price, 2, '.', ''),
+                'priceCurrency' => $currency ?: 'USD',
+                'availability'  => 'https://schema.org/InStock',
+            ];
+
+            if (!empty($ticketUrl)) {
+                $offer['url'] = $ticketUrl;
+            }
+
+            $schema['offers'] = $offer;
+        } elseif (!empty($ticketUrl)) {
+            $schema['offers'] = [
+                '@type'         => 'Offer',
+                'price'         => '0.00',
+                'priceCurrency' => $currency ?: 'USD',
+                'availability'  => 'https://schema.org/InStock',
+                'url'           => $ticketUrl,
+            ];
+        }
+
+        return $schema;
+    }
+
+    /**
+     * Build Recipe schema from per-article recipe data.
+     *
+     * @param   string  $title        Recipe/article title
+     * @param   string  $description  Recipe/article description
+     * @param   string  $imageUrl     Image URL (absolute)
+     * @param   object  $recipeData   Decoded recipe_data object
+     *
+     * @return  array|null
+     */
+    public static function buildRecipe(string $title, string $description, string $imageUrl, object $recipeData): ?array
+    {
+        $fields  = ['recipe_prep_time', 'recipe_cook_time', 'recipe_yield', 'recipe_calories', 'recipe_ingredients', 'recipe_category', 'recipe_cuisine'];
+        $hasData = false;
+
+        foreach ($fields as $field) {
+            if (!empty($recipeData->$field)) {
+                $hasData = true;
+                break;
+            }
+        }
+
+        if (!$hasData) {
+            return null;
+        }
+
+        $schema = [
+            '@context'    => 'https://schema.org',
+            '@type'       => 'Recipe',
+            'name'        => $title,
+            'description' => $description,
+            'url'         => Uri::getInstance()->toString(),
+        ];
+
+        if (!empty($imageUrl)) {
+            $schema['image'] = $imageUrl;
+        }
+
+        if (!empty($recipeData->recipe_prep_time)) {
+            $schema['prepTime'] = $recipeData->recipe_prep_time;
+        }
+
+        if (!empty($recipeData->recipe_cook_time)) {
+            $schema['cookTime'] = $recipeData->recipe_cook_time;
+        }
+
+        if (!empty($recipeData->recipe_prep_time) && !empty($recipeData->recipe_cook_time)) {
+            try {
+                $prep  = new \DateInterval($recipeData->recipe_prep_time);
+                $cook  = new \DateInterval($recipeData->recipe_cook_time);
+                $totalMinutes = ($prep->h * 60 + $prep->i) + ($cook->h * 60 + $cook->i);
+                $hours   = intdiv($totalMinutes, 60);
+                $minutes = $totalMinutes % 60;
+                $totalTime = 'PT';
+
+                if ($hours > 0) {
+                    $totalTime .= $hours . 'H';
+                }
+
+                if ($minutes > 0) {
+                    $totalTime .= $minutes . 'M';
+                }
+
+                if ($totalTime !== 'PT') {
+                    $schema['totalTime'] = $totalTime;
+                }
+            } catch (\Exception $e) {
+                // Invalid duration format
+            }
+        }
+
+        if (!empty($recipeData->recipe_yield)) {
+            $schema['recipeYield'] = $recipeData->recipe_yield;
+        }
+
+        if (!empty($recipeData->recipe_calories)) {
+            $schema['nutrition'] = [
+                '@type'    => 'NutritionInformation',
+                'calories' => $recipeData->recipe_calories . ' calories',
+            ];
+        }
+
+        if (!empty($recipeData->recipe_ingredients)) {
+            $ingredients = array_filter(
+                array_map('trim', preg_split('/\r\n|\r|\n/', $recipeData->recipe_ingredients)),
+                fn($line) => $line !== ''
+            );
+
+            if (!empty($ingredients)) {
+                $schema['recipeIngredient'] = array_values($ingredients);
+            }
+        }
+
+        if (!empty($recipeData->recipe_category)) {
+            $schema['recipeCategory'] = $recipeData->recipe_category;
+        }
+
+        if (!empty($recipeData->recipe_cuisine)) {
+            $schema['recipeCuisine'] = $recipeData->recipe_cuisine;
+        }
+
+        return $schema;
+    }
+
    /**
     * Encode a schema array to a JSON-LD script tag string.
     *
@@ -0,0 +1,107 @@
+<?php
+
+/**
+ * @package     MokoSuiteOpenGraph
+ * @subpackage  plg_system_mokoog
+ * @author      Moko Consulting <hello@mokoconsulting.tech>
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GNU General Public License version 3 or later; see LICENSE
+ */
+
+namespace Joomla\Plugin\System\MokoOG\Helper;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Uri\Uri;
+
+/**
+ * XML Sitemap builder.
+ *
+ * Generates a sitemap.xml containing all published articles, excluding
+ * those marked with noindex robots directives in the mokoog_tags table.
+ */
+class SitemapBuilder
+{
+    /**
+     * Generate sitemap XML content.
+     *
+     * @param   string  $changefreq  Default change frequency for entries
+     *
+     * @return  string  Complete sitemap XML
+     */
+    public static function generate(string $changefreq = 'weekly'): string
+    {
+        $db = Factory::getDbo();
+
+        // Get all published articles
+        $query = $db->getQuery(true)
+            ->select($db->quoteName(['a.id', 'a.alias', 'a.catid', 'a.modified', 'a.language']))
+            ->from($db->quoteName('#__content', 'a'))
+            ->where($db->quoteName('a.state') . ' = 1');
+
+        $db->setQuery($query);
+        $articles = $db->loadObjectList();
+
+        // Get noindex articles from mokoog_tags
+        $noindexQuery = $db->getQuery(true)
+            ->select($db->quoteName('content_id'))
+            ->from($db->quoteName('#__mokoog_tags'))
+            ->where($db->quoteName('content_type') . ' = ' . $db->quote('com_content'))
+            ->where($db->quoteName('robots') . ' LIKE ' . $db->quote('%noindex%'));
+
+        $db->setQuery($noindexQuery);
+        $noindexIds = $db->loadColumn();
+
+        $root = rtrim(Uri::root(), '/');
+        $xml  = '<?xml version="1.0" encoding="UTF-8"?>' . "\n";
+        $xml .= '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">' . "\n";
+
+        // Homepage
+        $xml .= '  <url>' . "\n";
+        $xml .= '    <loc>' . $root . '/</loc>' . "\n";
+        $xml .= '    <changefreq>daily</changefreq>' . "\n";
+        $xml .= '    <priority>1.0</priority>' . "\n";
+        $xml .= '  </url>' . "\n";
+
+        foreach ($articles as $article) {
+            // Skip noindexed
+            if (in_array((int) $article->id, $noindexIds)) {
+                continue;
+            }
+
+            $url     = $root . '/index.php?option=com_content&view=article&id=' . $article->id;
+            $lastmod = $article->modified && $article->modified !== '0000-00-00 00:00:00'
+                ? date('Y-m-d', strtotime($article->modified)) : '';
+
+            $xml .= '  <url>' . "\n";
+            $xml .= '    <loc>' . htmlspecialchars($url, ENT_XML1) . '</loc>' . "\n";
+
+            if ($lastmod) {
+                $xml .= '    <lastmod>' . $lastmod . '</lastmod>' . "\n";
+            }
+
+            $xml .= '    <changefreq>' . $changefreq . '</changefreq>' . "\n";
+            $xml .= '    <priority>0.8</priority>' . "\n";
+            $xml .= '  </url>' . "\n";
+        }
+
+        $xml .= '</urlset>';
+
+        return $xml;
+    }
+
+    /**
+     * Write sitemap XML to the site root.
+     *
+     * @param   string  $xml  The sitemap XML content
+     *
+     * @return  bool  True on success
+     */
+    public static function writeToFile(string $xml): bool
+    {
+        $path = JPATH_ROOT . '/sitemap.xml';
+
+        return (bool) file_put_contents($path, $xml);
+    }
+}
@@ -8,7 +8,7 @@
 -->
 <extension type="plugin" group="webservices" method="upgrade">
    <name>Web Services - MokoJoomOpenGraph</name>
-    <version>01.03.05</version>
+    <version>01.04.08</version>
    <creationDate>2026-05-23</creationDate>
    <author>Moko Consulting</author>
    <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -8,7 +8,7 @@
 <extension type="package" method="upgrade">
    <name>Package - MokoSuiteOpenGraph</name>
    <packagename>mokoog</packagename>
-    <version>01.03.05</version>
+    <version>01.04.08</version>
    <creationDate>2026-05-23</creationDate>
    <author>Moko Consulting</author>
    <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -0,0 +1,257 @@
+<?php
+
+/**
+ * @package     MokoSuiteOpenGraph
+ * @subpackage  Tests
+ * @author      Moko Consulting <hello@mokoconsulting.tech>
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GNU General Public License version 3 or later; see LICENSE
+ */
+
+namespace Mokoconsulting\MokoOG\Tests\Unit\Helper;
+
+use Joomla\Plugin\System\MokoOG\Helper\JsonLdBuilder;
+use PHPUnit\Framework\TestCase;
+
+class JsonLdBuilderTest extends TestCase
+{
+    // ── FAQPage ──────────────────────────────────────────────────────
+
+    public function testBuildFaqReturnsNullForEmptyArray(): void
+    {
+        $this->assertNull(JsonLdBuilder::buildFaq([]));
+    }
+
+    public function testBuildFaqSkipsEmptyQuestions(): void
+    {
+        $faqs = [
+            ['question' => '', 'answer' => 'An answer'],
+            ['question' => 'Valid?', 'answer' => ''],
+            ['question' => '  ', 'answer' => 'Still empty'],
+        ];
+
+        $this->assertNull(JsonLdBuilder::buildFaq($faqs));
+    }
+
+    public function testBuildFaqReturnsValidSchema(): void
+    {
+        $faqs = [
+            ['question' => 'What is OG?', 'answer' => 'Open Graph protocol.'],
+            ['question' => 'Why use it?', 'answer' => 'Better social previews.'],
+        ];
+
+        $result = JsonLdBuilder::buildFaq($faqs);
+
+        $this->assertNotNull($result);
+        $this->assertSame('https://schema.org', $result['@context']);
+        $this->assertSame('FAQPage', $result['@type']);
+        $this->assertCount(2, $result['mainEntity']);
+        $this->assertSame('Question', $result['mainEntity'][0]['@type']);
+        $this->assertSame('What is OG?', $result['mainEntity'][0]['name']);
+        $this->assertSame('Open Graph protocol.', $result['mainEntity'][0]['acceptedAnswer']['text']);
+    }
+
+    // ── HowTo ────────────────────────────────────────────────────────
+
+    public function testBuildHowToReturnsNullForEmptySteps(): void
+    {
+        $this->assertNull(JsonLdBuilder::buildHowTo('Test', []));
+        $this->assertNull(JsonLdBuilder::buildHowTo('Test', ['', '  ']));
+    }
+
+    public function testBuildHowToReturnsValidSchema(): void
+    {
+        $result = JsonLdBuilder::buildHowTo('Install Joomla', ['Download ZIP', 'Upload files', 'Run installer']);
+
+        $this->assertNotNull($result);
+        $this->assertSame('HowTo', $result['@type']);
+        $this->assertSame('Install Joomla', $result['name']);
+        $this->assertCount(3, $result['step']);
+        $this->assertSame(1, $result['step'][0]['position']);
+        $this->assertSame('HowToStep', $result['step'][0]['@type']);
+        $this->assertSame('Download ZIP', $result['step'][0]['text']);
+        $this->assertArrayNotHasKey('image', $result);
+    }
+
+    public function testBuildHowToIncludesImageWhenProvided(): void
+    {
+        $result = JsonLdBuilder::buildHowTo('Fix a bike', ['Remove wheel'], 'https://example.com/bike.jpg');
+
+        $this->assertNotNull($result);
+        $this->assertSame('https://example.com/bike.jpg', $result['image']);
+    }
+
+    // ── Recipe ───────────────────────────────────────────────────────
+
+    public function testBuildRecipeReturnsNullWhenNoData(): void
+    {
+        $data = (object) ['name' => '', 'description' => ''];
+
+        $this->assertNull(JsonLdBuilder::buildRecipe($data));
+    }
+
+    public function testBuildRecipeCalculatesTotalTime(): void
+    {
+        $data = (object) [
+            'name'     => 'Pasta',
+            'prepTime' => 'PT15M',
+            'cookTime' => 'PT30M',
+        ];
+
+        $result = JsonLdBuilder::buildRecipe($data);
+
+        $this->assertNotNull($result);
+        $this->assertSame('Recipe', $result['@type']);
+        $this->assertSame('PT45M', $result['totalTime']);
+    }
+
+    public function testBuildRecipeSplitsIngredientsByNewline(): void
+    {
+        $data = (object) [
+            'name'        => 'Salad',
+            'ingredients' => "Lettuce\nTomato\nOnion",
+        ];
+
+        $result = JsonLdBuilder::buildRecipe($data);
+
+        $this->assertNotNull($result);
+        $this->assertSame(['Lettuce', 'Tomato', 'Onion'], $result['recipeIngredient']);
+    }
+
+    // ── Event ────────────────────────────────────────────────────────
+
+    public function testBuildEventReturnsNullWithoutStartDate(): void
+    {
+        $data = (object) ['name' => 'Conference', 'startDate' => ''];
+
+        $this->assertNull(JsonLdBuilder::buildEvent($data));
+    }
+
+    public function testBuildEventIncludesLocationAndOffers(): void
+    {
+        $data = (object) [
+            'name'      => 'Tech Summit',
+            'startDate' => '2026-09-01T09:00:00',
+            'endDate'   => '2026-09-01T17:00:00',
+            'location'  => (object) [
+                'name'    => 'Convention Center',
+                'address' => '123 Main St',
+            ],
+            'offers' => (object) [
+                'price'    => '99.00',
+                'currency' => 'EUR',
+                'url'      => 'https://example.com/tickets',
+            ],
+        ];
+
+        $result = JsonLdBuilder::buildEvent($data);
+
+        $this->assertNotNull($result);
+        $this->assertSame('Event', $result['@type']);
+        $this->assertSame('2026-09-01T09:00:00', $result['startDate']);
+        $this->assertSame('2026-09-01T17:00:00', $result['endDate']);
+        $this->assertSame('Place', $result['location']['@type']);
+        $this->assertSame('Convention Center', $result['location']['name']);
+        $this->assertSame('Offer', $result['offers']['@type']);
+        $this->assertSame('99.00', $result['offers']['price']);
+        $this->assertSame('EUR', $result['offers']['priceCurrency']);
+    }
+
+    // ── LocalBusiness ────────────────────────────────────────────────
+
+    public function testBuildLocalBusinessReturnsNullWithoutName(): void
+    {
+        $params = $this->createParamsMock([]);
+
+        $this->assertNull(JsonLdBuilder::buildLocalBusiness($params));
+    }
+
+    public function testBuildLocalBusinessIncludesAddress(): void
+    {
+        $params = $this->createParamsMock([
+            'business_name'  => 'Moko Consulting',
+            'street_address' => '456 Oak Ave',
+            'city'           => 'Austin',
+            'region'         => 'TX',
+            'postal_code'    => '78701',
+            'country'        => 'US',
+            'telephone'      => '+1-555-0100',
+        ]);
+
+        $result = JsonLdBuilder::buildLocalBusiness($params);
+
+        $this->assertNotNull($result);
+        $this->assertSame('LocalBusiness', $result['@type']);
+        $this->assertSame('Moko Consulting', $result['name']);
+        $this->assertSame('PostalAddress', $result['address']['@type']);
+        $this->assertSame('456 Oak Ave', $result['address']['streetAddress']);
+        $this->assertSame('Austin', $result['address']['addressLocality']);
+        $this->assertSame('TX', $result['address']['addressRegion']);
+        $this->assertSame('78701', $result['address']['postalCode']);
+        $this->assertSame('US', $result['address']['addressCountry']);
+        $this->assertSame('+1-555-0100', $result['telephone']);
+    }
+
+    // ── VideoObject ──────────────────────────────────────────────────
+
+    public function testBuildVideoReturnsNullForEmptyUrl(): void
+    {
+        $this->assertNull(JsonLdBuilder::buildVideo(''));
+    }
+
+    public function testBuildVideoAddsEmbedUrlForYoutube(): void
+    {
+        $result = JsonLdBuilder::buildVideo(
+            'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+            'Test Video',
+            'A description'
+        );
+
+        $this->assertNotNull($result);
+        $this->assertSame('VideoObject', $result['@type']);
+        $this->assertSame('https://www.youtube.com/watch?v=dQw4w9WgXcQ', $result['contentUrl']);
+        $this->assertSame('https://www.youtube.com/embed/dQw4w9WgXcQ', $result['embedUrl']);
+        $this->assertSame('Test Video', $result['name']);
+    }
+
+    // ── toScriptTag ──────────────────────────────────────────────────
+
+    public function testToScriptTagEscapesClosingScriptTags(): void
+    {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type'    => 'Article',
+            'headline' => 'Test </script><script>alert(1)</script>',
+        ];
+
+        $output = JsonLdBuilder::toScriptTag($schema);
+
+        $this->assertStringStartsWith('<script type="application/ld+json">', $output);
+        $this->assertStringEndsWith('</script>', $output);
+        // The closing </script> inside the JSON must be escaped
+        $this->assertStringNotContainsString('</script><script>', $output);
+        $this->assertStringContainsString('<\\/script>', $output);
+    }
+
+    // ── Helper ───────────────────────────────────────────────────────
+
+    /**
+     * Create a mock object that mimics Joomla's Registry->get($key, $default).
+     */
+    private function createParamsMock(array $values): object
+    {
+        return new class ($values) {
+            private array $data;
+
+            public function __construct(array $data)
+            {
+                $this->data = $data;
+            }
+
+            public function get(string $key, mixed $default = ''): mixed
+            {
+                return $this->data[$key] ?? $default;
+            }
+        };
+    }
+}
@@ -0,0 +1,13 @@
+<?php
+
+/**
+ * @package     MokoSuiteOpenGraph
+ * @subpackage  Tests
+ * @author      Moko Consulting <hello@mokoconsulting.tech>
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GNU General Public License version 3 or later; see LICENSE
+ */
+
+define('_JEXEC', 1);
+
+require_once __DIR__ . '/../vendor/autoload.php';
Author	SHA1	Message	Date
gitea-actions[bot]	281e742b54	chore(version): pre-release bump to 01.04.08-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 8s Details	2026-06-23 18:28:10 +00:00
gitea-actions[bot]	8de243b181	chore(version): pre-release bump to 01.04.07-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 8s Details	2026-06-23 18:21:17 +00:00
gitea-actions[bot]	9793bd4031	chore(version): pre-release bump to 01.04.06-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 7s Details	2026-06-23 18:07:08 +00:00
jmiller	a9fc5d2cf1	chore: remove security-audit.yml -- handled by MokoGitea Universal: Auto Version Bump / Version Bump (push) Successful in 14s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 29s Details	2026-06-23 18:05:38 +00:00
Jonathan Miller	f1c6eb8f6e	docs: update CHANGELOG and README for v2.0 release Universal: Auto Version Bump / Version Bump (push) Successful in 25s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 26s Details Add all v2.0 features: 11+ JSON-LD types, 6 preview cards, AI generation, XML sitemap, per-platform images, SEO scoring, PHPUnit tests, OpenAPI spec, coverage dashboard, custom schema builder.	2026-06-23 13:05:25 -05:00
jmiller	a578ac3bb3	chore: remove deploy-manual.yml -- no longer needed Universal: Auto Version Bump / Version Bump (push) Successful in 13s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 28s Details	2026-06-23 18:00:09 +00:00
gitea-actions[bot]	cf783c6b83	chore(version): pre-release bump to 01.04.05-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 37s Details	2026-06-23 17:54:40 +00:00
gitea-actions[bot]	bc6ce4397f	chore(version): auto-bump patch 01.04.04-dev [skip ci]	2026-06-23 17:54:31 +00:00
Jonathan Miller	49d644566a	feat: add custom schema, AI generation, XML sitemap, platform images Universal: Auto Version Bump / Version Bump (push) Successful in 14s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 11s Details - Custom JSON-LD schema builder: per-article textarea for arbitrary structured data with JSON validation. Closes #70 - AI-powered meta generation: Generate with AI buttons for OG title and description, supports Claude and OpenAI APIs. Closes #71 - XML sitemap: auto-generates sitemap.xml on article save, respects noindex directives. Closes #72 - Per-platform image resizing: Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400 alongside default Facebook 1200x630. Closes #74 - DB migration 01.05.00: adds custom_schema column	2026-06-23 12:54:01 -05:00
Jonathan Miller	cbebaecc22	test: add PHPUnit test suite with JsonLdBuilder unit tests 16 unit tests covering FAQ, HowTo, Event, Recipe, LocalBusiness, and VideoObject schema builders plus toScriptTag XSS escaping. Closes #75	2026-06-23 12:54:00 -05:00
Jonathan Miller	e7b0af1fca	docs: add OpenAPI 3.0 spec for REST API Documents the /api/v1/mokoog/tags endpoints with full request/response schemas, authentication, and examples. Closes #80	2026-06-23 12:53:59 -05:00
Jonathan Miller	2088b3f13f	feat: add OG coverage dashboard to tag manager Shows coverage percentage, article count with/without OG tags, and counts of missing title, description, and image fields. Closes #73	2026-06-23 12:53:59 -05:00
Jonathan Miller	f649858fcd	feat: add SEO content scoring panel to article editor JavaScript-based SEO analysis with 7 checks (OG title, description, image, SEO title, meta description, title length, description length). Shows pass/fail dots and overall score. Closes #68	2026-06-23 12:53:58 -05:00
gitea-actions[bot]	7a38025b5e	chore(version): pre-release bump to 01.04.03-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 7s Details	2026-06-23 17:20:08 +00:00
gitea-actions[bot]	e530ca821e	chore(version): auto-bump patch 01.04.02-dev [skip ci]	2026-06-23 17:19:49 +00:00
Jonathan Miller	872074cd5b	feat: add FAQ, HowTo, Event, and Recipe JSON-LD schema types Universal: Auto Version Bump / Version Bump (push) Successful in 10s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 23s Details - FAQ: auto-detects h3/h4 + paragraph patterns, outputs FAQPage (#62) - HowTo: auto-detects ordered lists, outputs HowTo with steps (#63) - Event: per-article fields (dates, venue, tickets), event_data JSON column, outputs Event schema (#64) - Recipe: per-article fields (times, ingredients, nutrition), recipe_data JSON column, outputs Recipe schema (#66) - DB migration 01.04.00: adds event_data and recipe_data columns Closes #62, closes #63, closes #64, closes #66	2026-06-23 12:19:37 -05:00
gitea-actions[bot]	c871b7d30d	chore(version): pre-release bump to 01.04.01-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 4s Details	2026-06-23 16:33:35 +00:00
gitea-actions[bot]	641eee753a	chore(version): auto-bump patch 01.03.08-dev [skip ci]	2026-06-23 16:33:26 +00:00
Jonathan Miller	44d9daf3bc	feat: add LocalBusiness JSON-LD schema type Universal: Auto Version Bump / Version Bump (push) Successful in 12s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 11s Details Adds configurable LocalBusiness structured data with address, contact, geo coordinates, and opening hours. Enabled via plugin parameters. Closes #65	2026-06-23 11:30:45 -05:00
Jonathan Miller	96eea6060f	feat: add Discord, Mastodon, and Slack preview cards to editor Shows how shared links will appear on Discord (dark theme with accent bar), Mastodon (rounded card), and Slack (compact unfurl) alongside the existing Facebook, Twitter, and LinkedIn previews. Closes #69	2026-06-23 11:28:37 -05:00
Jonathan Miller	aeea65423c	feat: add VideoObject JSON-LD schema for video content Outputs VideoObject structured data when an article has a video URL set, enabling Google video rich results. Closes #67	2026-06-23 11:28:37 -05:00
Jonathan Miller	b4d5b73d15	fix: code quality improvements (#76 , #77 , #78 , #79 ) - Add exception logging to BatchController batch skip (#76) - Align form maxlength with DB schema limits (#77) - applySeoTags() already uses public API — no change needed (#78) - Add strip_tags() input sanitization on OG text fields (#79)	2026-06-23 11:28:36 -05:00
gitea-actions[bot]	e939e90733	chore(version): pre-release bump to 01.03.07-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 7s Details	2026-06-23 16:03:42 +00:00
gitea-actions[bot]	d4c22ebdbf	chore(version): auto-bump patch 01.03.06-dev [skip ci]	2026-06-23 16:03:32 +00:00
				`@@ -0,0 +1 @@`
				ALTER TABLE `#__mokoog_tags` ADD COLUMN `custom_schema` TEXT NULL AFTER `canonical_url`;