chore: add dlid and blockChildUninstall to package manifest [skip ci]

Delete auto-release.yml, pre-release.yml, and auto-bump.yml in
preparation for the new update server system.

Remaining workflows: ci-joomla, cleanup, gitleaks, notify, pr-check,
repo-health, security-audit (7 total).

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.gitattributes

@@ -0,0 +1,62 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# PHP files
+*.php text eol=lf
+
+# XML manifests
+*.xml text eol=lf
+
+# Language files
+*.ini text eol=lf
+
+# SQL files
+*.sql text eol=lf
+
+# Shell scripts
+*.sh text eol=lf
+
+# Markdown
+*.md text eol=lf
+
+# YAML
+*.yml text eol=lf
+*.yaml text eol=lf
+
+# CSS/JS
+*.css text eol=lf
+*.js text eol=lf
+
+# JSON
+*.json text eol=lf
+
+# Windows scripts
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Binary files
+*.zip binary
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary
+
+# Export ignore (not included in archives)
+.mokogitea/ export-ignore
+.editorconfig export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.gitmessage export-ignore
+CLAUDE.md export-ignore
+CONTRIBUTING.md export-ignore
+CODE_OF_CONDUCT.md export-ignore
+Makefile export-ignore
+composer.json export-ignore
+phpstan.neon export-ignore

.gitignore

@@ -0,0 +1,204 @@
+# ============================================================
+# Local task tracking (not version controlled)
+# ============================================================
+TODO.md
+
+# ============================================================
+# Environment and secrets
+# ============================================================
+.env
+.env.local
+.env.*.local
+*.local.php
+*.secret.php
+configuration.php
+configuration.*.php
+configuration.local.php
+conf/conf.php
+conf/conf*.php
+secrets/
+*.secrets.*
+
+# ============================================================
+# Logs, dumps and databases
+# ============================================================
+*.db
+*.db-journal
+*.dump
+*.log
+*.pid
+*.seed
+
+
+# ============================================================
+# OS / Editor / IDE cruft
+# ============================================================
+.DS_Store
+Thumbs.db
+desktop.ini
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+$RECYCLE.BIN/
+System Volume Information/
+*.lnk
+Icon?
+.idea/
+.settings/
+.claude/
+.vscode/*
+!.vscode/tasks.json
+!.vscode/settings.json.example
+!.vscode/extensions.json
+*.code-workspace
+*.sublime*
+.project
+.buildpath
+.classpath
+*.bak
+*.swp
+*.swo
+*.tmp
+*.old
+*.orig
+
+# ============================================================
+# Dev scripts and scratch
+# ============================================================
+TODO.md
+todo*
+*ffs*
+
+# ============================================================
+# SFTP / sync tools
+# ============================================================
+sftp-config*.json
+sftp-config.json.template
+sftp-settings.json
+
+# ============================================================
+# Sublime SFTP / FTP sync
+# ============================================================
+*.sublime-project
+*.sublime-workspace
+*.sublime-settings
+.libsass.json
+*.ffs*
+
+# ============================================================
+# Replit / cloud IDE
+# ============================================================
+.replit
+replit.md
+
+# ============================================================
+# Archives / release artifacts
+# ============================================================
+*.7z
+*.rar
+*.tar
+*.tar.gz
+*.tgz
+*.zip
+artifacts/
+release/
+releases/
+
+# ============================================================
+# Build outputs and site generators
+# ============================================================
+.mkdocs-build/
+.cache/
+.parcel-cache/
+build/
+dist/
+out/
+site/
+*.map
+*.css.map
+*.js.map
+*.tsbuildinfo
+
+# ============================================================
+# CI / test artifacts
+# ============================================================
+.coverage
+.coverage.*
+coverage/
+coverage.xml
+htmlcov/
+junit.xml
+reports/
+test-results/
+tests/_output/
+.github/local/
+.github/workflows/*.log
+
+# ============================================================
+# Node / JavaScript
+# ============================================================
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.pnpm-store/
+.yarn/
+.npmrc
+.eslintcache
+package-lock.json
+
+# ============================================================
+# PHP / Composer tooling
+# ============================================================
+vendor/
+!src/media/vendor/
+composer.lock
+*.phar
+codeception.phar
+.phpunit.result.cache
+.php_cs.cache
+.php-cs-fixer.cache
+.phpstan.cache
+.phplint-cache
+phpmd-cache/
+.psalm/
+.rector/
+
+# ============================================================
+# Python
+# ============================================================
+__pycache__/
+*.py[cod]
+*.pyc
+*$py.class
+*.so
+.Python
+.eggs/
+*.egg
+*.egg-info/
+.installed.cfg
+MANIFEST
+develop-eggs/
+downloads/
+eggs/
+parts/
+sdist/
+var/
+wheels/
+ENV/
+env/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.pyright/
+.tox/
+.nox/
+*.cover
+*.coverage
+hypothesis/
+
+profile.ps1
+.mcp.json

.mokogitea/branch-protection.yml

@@ -1,251 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-# SPDX-License-Identifier: GPL-3.0-or-later
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Automation
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /.gitea/workflows/branch-protection.yml
-# BRIEF: Apply standardised branch protection rules to all governed repositories
-#
-# +========================================================================+
-# |                   BRANCH PROTECTION SETUP                              |
-# +========================================================================+
-# |                                                                        |
-# |  Applies protection rules for: main, dev, rc, beta, alpha       |
-# |                                                                        |
-# |  main  — Require PR, block rejected reviews, no force push             |
-# |  dev   — Allow push, no force push, no delete                          |
-# |  rc  — Allow push, no force push, no delete                          |
-# |  beta — Allow push, no force push, no delete                         |
-# |  alpha — Allow push, no force push, no delete                        |
-# |                                                                        |
-# |  jmiller has override authority on all branches.                       |
-# |                                                                        |
-# +========================================================================+
-
-name: Branch Protection Setup
-
-on:
-  schedule:
-    - cron: '0 2 * * 1'  # Weekly Monday 02:00 UTC
-  workflow_dispatch:
-    inputs:
-      dry_run:
-        description: 'Preview mode (no changes)'
-        required: false
-        type: boolean
-        default: false
-      repos:
-        description: 'Comma-separated repo names (empty = all governed repos)'
-        required: false
-        type: string
-        default: ''
-
-env:
-  GITEA_URL: https://git.mokoconsulting.tech
-  GITEA_ORG: MokoConsulting
-
-permissions:
-  contents: read
-
-jobs:
-  protect:
-    name: Apply Branch Protection Rules
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Determine target repos
-        id: repos
-        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
-        run: |
-          API="${GITEA_URL}/api/v1"
-
-          # Platform/standards/infra repos to exclude
-          EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private MokoStandards moko-platform MokoTesting"
-          EXCLUDE="$EXCLUDE MokoStandards-Template-Client MokoStandards-Template-Dolibarr MokoStandards-Template-Generic MokoStandards-Template-Joomla MokoDoliProjTemplate"
-
-          if [ -n "${{ inputs.repos }}" ]; then
-            # User-specified repos
-            REPOS=$(echo "${{ inputs.repos }}" | tr ',' ' ')
-          else
-            # Fetch all org repos
-            PAGE=1
-            REPOS=""
-            while true; do
-              BATCH=$(curl -sS \
-                -H "Authorization: token ${GA_TOKEN}" \
-                "${API}/orgs/${GITEA_ORG}/repos?page=${PAGE}&limit=50" \
-                | jq -r '.[].name // empty')
-              [ -z "$BATCH" ] && break
-              REPOS="$REPOS $BATCH"
-              PAGE=$((PAGE + 1))
-            done
-
-            # Filter out excluded repos
-            FILTERED=""
-            for REPO in $REPOS; do
-              SKIP=false
-              for EX in $EXCLUDE; do
-                if [ "$REPO" = "$EX" ]; then
-                  SKIP=true
-                  break
-                fi
-              done
-              if [ "$SKIP" = "false" ]; then
-                FILTERED="$FILTERED $REPO"
-              fi
-            done
-            REPOS="$FILTERED"
-          fi
-
-          echo "repos=$REPOS" >> "$GITHUB_OUTPUT"
-          COUNT=$(echo "$REPOS" | wc -w)
-          echo "📋 Target repos (${COUNT}): $REPOS"
-
-      - name: Apply protection rules
-        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
-          DRY_RUN: ${{ inputs.dry_run || 'false' }}
-        run: |
-          API="${GITEA_URL}/api/v1"
-          REPOS="${{ steps.repos.outputs.repos }}"
-
-          SUCCESS=0
-          FAILED=0
-          SKIPPED=0
-
-          # ── Rule definitions ──────────────────────────────────────
-          # Only the CI bot (jmiller token) can push directly.
-          # All human contributors must use PRs.
-          # Force push disabled on all branches.
-
-          RULE_MAIN='{
-            "rule_name": "main",
-            "enable_push": true,
-            "enable_push_whitelist": true,
-            "push_whitelist_usernames": ["jmiller"],
-            "enable_force_push": false,
-            "enable_force_push_allowlist": false,
-            "force_push_allowlist_usernames": [],
-            "enable_merge_whitelist": false,
-            "required_approvals": 0,
-            "dismiss_stale_approvals": true,
-            "block_on_rejected_reviews": true,
-            "block_on_outdated_branch": false,
-            "priority": 1
-          }'
-
-          RULE_DEV='{
-            "rule_name": "dev",
-            "enable_push": true,
-            "enable_push_whitelist": true,
-            "push_whitelist_usernames": ["jmiller"],
-            "enable_force_push": false,
-            "enable_force_push_allowlist": false,
-            "force_push_allowlist_usernames": [],
-            "enable_merge_whitelist": false,
-            "required_approvals": 0,
-            "block_on_rejected_reviews": false,
-            "priority": 2
-          }'
-
-          RULE_RC='{
-            "rule_name": "rc",
-            "enable_push": true,
-            "enable_push_whitelist": true,
-            "push_whitelist_usernames": ["jmiller"],
-            "enable_force_push": false,
-            "enable_force_push_allowlist": false,
-            "force_push_allowlist_usernames": [],
-            "enable_merge_whitelist": false,
-            "required_approvals": 0,
-            "block_on_rejected_reviews": false,
-            "priority": 3
-          }'
-
-          RULE_BETA='{
-            "rule_name": "beta",
-            "enable_push": true,
-            "enable_push_whitelist": true,
-            "push_whitelist_usernames": ["jmiller"],
-            "enable_force_push": false,
-            "enable_force_push_allowlist": false,
-            "force_push_allowlist_usernames": [],
-            "enable_merge_whitelist": false,
-            "required_approvals": 0,
-            "block_on_rejected_reviews": false,
-            "priority": 4
-          }'
-
-          RULE_ALPHA='{
-            "rule_name": "alpha",
-            "enable_push": true,
-            "enable_push_whitelist": true,
-            "push_whitelist_usernames": ["jmiller"],
-            "enable_force_push": false,
-            "enable_force_push_allowlist": false,
-            "force_push_allowlist_usernames": [],
-            "enable_merge_whitelist": false,
-            "required_approvals": 0,
-            "block_on_rejected_reviews": false,
-            "priority": 5
-          }'
-
-          RULES=("$RULE_MAIN" "$RULE_DEV" "$RULE_RC" "$RULE_BETA" "$RULE_ALPHA")
-          RULE_NAMES=("main" "dev" "rc" "beta" "alpha")
-
-          # ── Apply rules to each repo ──────────────────────────────
-          for REPO in $REPOS; do
-            echo ""
-            echo "═══ ${REPO} ═══"
-
-            for i in "${!RULES[@]}"; do
-              RULE="${RULES[$i]}"
-              NAME="${RULE_NAMES[$i]}"
-
-              if [ "$DRY_RUN" = "true" ]; then
-                echo "  [DRY RUN] Would apply rule: ${NAME}"
-                SKIPPED=$((SKIPPED + 1))
-                continue
-              fi
-
-              # Delete existing rule if present (idempotent recreate)
-              ENCODED_NAME=$(echo "$NAME" | sed 's|/|%2F|g')
-              curl -sS -o /dev/null -w "" \
-                -X DELETE \
-                -H "Authorization: token ${GA_TOKEN}" \
-                "${API}/repos/${GITEA_ORG}/${REPO}/branch_protections/${ENCODED_NAME}" 2>/dev/null || true
-
-              # Create rule
-              RESPONSE=$(curl -sS -w "\n%{http_code}" \
-                -X POST \
-                -H "Authorization: token ${GA_TOKEN}" \
-                -H "Content-Type: application/json" \
-                -d "$RULE" \
-                "${API}/repos/${GITEA_ORG}/${REPO}/branch_protections")
-
-              HTTP=$(echo "$RESPONSE" | tail -1)
-              BODY=$(echo "$RESPONSE" | sed '$d')
-
-              if [ "$HTTP" = "201" ]; then
-                echo "  ✅ ${NAME}"
-                SUCCESS=$((SUCCESS + 1))
-              else
-                echo "  ❌ ${NAME} (HTTP ${HTTP}): $(echo "$BODY" | jq -r '.message // .' 2>/dev/null | head -1)"
-                FAILED=$((FAILED + 1))
-              fi
-            done
-          done
-
-          # ── Summary ───────────────────────────────────────────────
-          echo ""
-          echo "════════════════════════════════════════"
-          echo "  ✅ Success: ${SUCCESS}"
-          echo "  ❌ Failed:  ${FAILED}"
-          echo "  ⏭️  Skipped: ${SKIPPED}"
-          echo "════════════════════════════════════════"
-
-          if [ "$FAILED" -gt 0 ]; then
-            echo "::warning::${FAILED} rule(s) failed to apply"
-          fi

.mokogitea/manifest.xml

@@ -5,9 +5,11 @@
 -->
 <moko-platform xmlns="https://standards.mokoconsulting.tech/moko-platform/1.0" schema-version="1.0">
   <identity>
-    <name>MokoOpenGraph</name>
+    <name>MokoJoomOpenGraph</name>
+    <display-name>Package - MokoJoomOpenGraph</display-name>
     <org>MokoConsulting</org>
     <description>Open Graph, SEO meta tags, and social sharing image management for Joomla articles and menu items</description>
+    <version>01.00.01</version>
     <license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
   </identity>
   <governance>

.mokogitea/workflows/auto-bump.yml

@@ -1,66 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Release
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /.mokogitea/workflows/auto-bump.yml
-# VERSION: 09.02.00
-# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
-
-name: "Universal: Auto Version Bump"
-
-on:
-  push:
-    branches:
-      - dev
-      - rc
-      - 'feature/**'
-      - 'patch/**'
-
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-
-permissions:
-  contents: write
-
-jobs:
-  bump:
-    name: Version Bump
-    runs-on: release
-    if: >-
-      !contains(github.event.head_commit.message, '[skip ci]') &&
-      !contains(github.event.head_commit.message, '[skip bump]') &&
-      !startsWith(github.event.head_commit.message, 'Merge pull request')
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
-          fetch-depth: 1
-
-      - name: Setup moko-platform tools
-        run: |
-          if ! command -v composer &> /dev/null; then
-            sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
-          fi
-          if [ -d "/opt/moko-platform/cli" ]; then
-            echo "MOKO_CLI=/opt/moko-platform/cli" >> "$GITHUB_ENV"
-          else
-            git clone --depth 1 --branch main --quiet \
-              "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/moko-platform.git" \
-              /tmp/moko-platform-api
-            cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
-            echo "MOKO_CLI=/tmp/moko-platform-api/cli" >> "$GITHUB_ENV"
-          fi
-
-      - name: Bump version
-        run: |
-          php ${MOKO_CLI}/version_auto_bump.php \
-            --path . --branch "${GITHUB_REF_NAME}" \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
-            --repo-url "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"

.mokogitea/workflows/branch-cleanup.yml

@@ -1,48 +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.Universal
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /.mokogitea/workflows/branch-cleanup.yml
-# VERSION: 01.00.00
-# BRIEF: Delete feature branches after PR merge
-
-name: "Branch Cleanup"
-
-on:
-  pull_request:
-    types: [closed]
-
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-
-jobs:
-  cleanup:
-    name: Delete merged branch
-    runs-on: ubuntu-latest
-    if: >-
-      github.event.pull_request.merged == true &&
-      github.event.pull_request.head.ref != 'dev' &&
-      github.event.pull_request.head.ref != 'main'
-
-    steps:
-      - name: Delete source branch
-        run: |
-          BRANCH="${{ github.event.pull_request.head.ref }}"
-          API="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}/api/v1/repos/${{ github.repository }}/branches"
-          ENCODED=$(php -r "echo rawurlencode('${BRANCH}');")
-
-          STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X DELETE \
-            -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
-            "${API}/${ENCODED}" 2>/dev/null || true)
-
-          if [ "$STATUS" = "204" ]; then
-            echo "Deleted branch: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
-          elif [ "$STATUS" = "404" ]; then
-            echo "Branch already deleted: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
-          else
-            echo "::warning::Failed to delete branch ${BRANCH} (HTTP ${STATUS})"
-          fi

.mokogitea/workflows/cascade-dev.yml

@@ -1,10 +0,0 @@
-# DISABLED — auto-release Step 11 recreates dev from main after every release.
-# Cascade-dev is redundant and causes version conflicts when both main and dev
-# have different version numbers in templateDetails.xml / manifest.xml.
-name: "Cascade Main → Dev (DISABLED)"
-on: workflow_dispatch
-jobs:
-  noop:
-    runs-on: ubuntu-latest
-    steps:
-      - run: echo "Cascade disabled — auto-release handles dev recreation"

.mokogitea/workflows/ci-joomla.yml

@@ -43,9 +43,9 @@ jobs:
 
       - name: Clone MokoStandards
         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' }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
+          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
+          MOKO_CLONE_HOST: ${{ secrets.MOKOGITEA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
         run: |
           git clone --depth 1 --branch main --quiet \
             "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
@@ -53,7 +53,7 @@ jobs:
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -124,8 +124,13 @@ jobs:
               echo "Manifest is well-formed XML." >> $GITHUB_STEP_SUMMARY
             fi
 
-            # Check required tags: name, version, author, namespace (Joomla 5+)
-            for TAG in name version author namespace; do
+            # Check required tags
+            REQUIRED_TAGS="name version author"
+            # namespace is only required for non-package extensions
+            if ! grep -q 'type="package"' "$MANIFEST" 2>/dev/null; then
+              REQUIRED_TAGS="$REQUIRED_TAGS namespace"
+            fi
+            for TAG in $REQUIRED_TAGS; do
               if ! grep -q "<${TAG}>" "$MANIFEST" 2>/dev/null; then
                 echo "Missing required tag: \`<${TAG}>\`" >> $GITHUB_STEP_SUMMARY
                 ERRORS=$((ERRORS + 1))
@@ -197,6 +202,37 @@ jobs:
             echo "**Language file check passed.**" >> $GITHUB_STEP_SUMMARY
           fi
 
+      - name: Check en-GB and en-US language directories exist
+        run: |
+          echo "### Language Directory Check" >> $GITHUB_STEP_SUMMARY
+          ERRORS=0
+
+          for DIR in src/ htdocs/; do
+            [ -d "$DIR" ] || continue
+            # Find all language directories
+            while IFS= read -r -d '' LANG_DIR; do
+              HAS_GB=false
+              HAS_US=false
+              [ -d "${LANG_DIR}/en-GB" ] && HAS_GB=true
+              [ -d "${LANG_DIR}/en-US" ] && HAS_US=true
+              if [ "$HAS_GB" = false ]; then
+                echo "Missing \`en-GB\` in: \`${LANG_DIR}\`" >> $GITHUB_STEP_SUMMARY
+                ERRORS=$((ERRORS + 1))
+              fi
+              if [ "$HAS_US" = false ]; then
+                echo "Missing \`en-US\` in: \`${LANG_DIR}\`" >> $GITHUB_STEP_SUMMARY
+                ERRORS=$((ERRORS + 1))
+              fi
+            done < <(find "$DIR" -type d -name "language" -print0)
+          done
+
+          if [ "${ERRORS}" -gt 0 ]; then
+            echo "**${ERRORS} missing language director(ies).**" >> $GITHUB_STEP_SUMMARY
+            exit 1
+          else
+            echo "All language directories have en-GB and en-US." >> $GITHUB_STEP_SUMMARY
+          fi
+
       - name: Check index.html files in directories
         run: |
           echo "### Index.html Check" >> $GITHUB_STEP_SUMMARY
@@ -240,8 +276,8 @@ jobs:
           echo "" >> $GITHUB_STEP_SUMMARY
           ERRORS=0
 
-          # Extract version from README.md
-          README_VERSION=$(grep -oP '^\s*VERSION:\s*\K[0-9]{2}\.[0-9]{2}\.[0-9]{2}' README.md | head -1)
+          # Extract version from README.md (supports both FILE INFORMATION block and HTML comment format)
+          README_VERSION=$(sed -n 's/.*VERSION:\s*\([0-9]\{2\}\.[0-9]\{2\}\.[0-9]\{2\}\).*/\1/p' README.md | head -1)
           if [ -z "$README_VERSION" ]; then
             echo "No VERSION found in README.md FILE INFORMATION block." >> $GITHUB_STEP_SUMMARY
             ERRORS=$((ERRORS + 1))
@@ -265,7 +301,7 @@ jobs:
             echo "Manifest: \`${MANIFEST}\`" >> $GITHUB_STEP_SUMMARY
 
             # Check <version> matches README VERSION
-            MANIFEST_VERSION=$(grep -oP '<version>\K[^<]+' "$MANIFEST" | head -1)
+            MANIFEST_VERSION=$(sed -n 's/.*<version>\([^<]*\)<\/version>.*/\1/p' "$MANIFEST" | head -1)
             if [ -z "$MANIFEST_VERSION" ]; then
               echo "No \`<version>\` tag in manifest." >> $GITHUB_STEP_SUMMARY
               ERRORS=$((ERRORS + 1))
@@ -346,7 +382,7 @@ jobs:
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -391,7 +427,7 @@ jobs:
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install --no-interaction --prefer-dist --optimize-autoloader

.mokogitea/workflows/cleanup.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Maintenance
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
+# INGROUP: moko-platform.Maintenance
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 # PATH: /.gitea/workflows/cleanup.yml
 # VERSION: 01.00.00
 # BRIEF: Scheduled cleanup — delete merged branches and old workflow runs
@@ -33,17 +33,17 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          token: ${{ secrets.GA_TOKEN }}
+          token: ${{ secrets.MOKOGITEA_TOKEN }}
 
       - name: Delete merged branches
         env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
         run: |
           echo "=== Merged Branch Cleanup ==="
           API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
 
           # List branches via API
-          BRANCHES=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
+          BRANCHES=$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
             "${API}/branches?limit=50" | jq -r '.[].name')
 
           DELETED=0
@@ -56,7 +56,7 @@ jobs:
             # Check if branch is merged into main
             if git merge-base --is-ancestor "origin/${BRANCH}" origin/main 2>/dev/null; then
               echo "  Deleting merged branch: ${BRANCH}"
-              curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
+              curl -sS -X DELETE -H "Authorization: token ${GITEA_TOKEN}" \
                 "${API}/branches/${BRANCH}" 2>/dev/null || true
               DELETED=$((DELETED + 1))
             fi
@@ -66,20 +66,20 @@ jobs:
 
       - name: Clean old workflow runs
         env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
         run: |
           echo "=== Workflow Run Cleanup ==="
           API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
           CUTOFF=$(date -d "30 days ago" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -v-30d +%Y-%m-%dT%H:%M:%SZ)
 
           # Get old completed runs
-          RUNS=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
+          RUNS=$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
             "${API}/actions/runs?status=completed&limit=50" | \
             jq -r ".workflow_runs[] | select(.created_at < \"${CUTOFF}\") | .id" 2>/dev/null)
 
           DELETED=0
           for RUN_ID in $RUNS; do
-            curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
+            curl -sS -X DELETE -H "Authorization: token ${GITEA_TOKEN}" \
               "${API}/actions/runs/${RUN_ID}" 2>/dev/null || true
             DELETED=$((DELETED + 1))
           done

.mokogitea/workflows/gitleaks.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Security
-# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/MokoStandards-API
+# INGROUP: moko-platform.Security
+# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
 # PATH: /templates/workflows/gitleaks.yml.template
 # VERSION: 01.00.00
 # BRIEF: Secret scanning — detect leaked credentials, API keys, and tokens

.mokogitea/workflows/issue-branch.yml

@@ -1,73 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Automation
-# VERSION: 01.00.00
-# BRIEF: Auto-create feature branch when an issue is opened
-
-name: "Universal: Issue Branch"
-
-on:
-  issues:
-    types: [opened]
-
-permissions:
-  contents: write
-  issues: write
-
-env:
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-
-jobs:
-  create-branch:
-    name: Create feature branch
-    runs-on: ubuntu-latest
-    steps:
-      - name: Create branch and comment
-        run: |
-          TOKEN="${{ secrets.GA_TOKEN }}"
-          API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
-          ISSUE_NUM="${{ github.event.issue.number }}"
-          ISSUE_TITLE="${{ github.event.issue.title }}"
-
-          # Build slug from title: lowercase, replace non-alnum with dash, trim
-          SLUG=$(echo "${ISSUE_TITLE}" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//' | cut -c1-40)
-          BRANCH="feature/${ISSUE_NUM}-${SLUG}"
-
-          # Check dev branch exists
-          DEV_EXISTS=$(curl -sf -o /dev/null -w '%{http_code}' \
-            -H "Authorization: token ${TOKEN}" \
-            "${API}/branches/dev" 2>/dev/null || echo "000")
-
-          if [ "${DEV_EXISTS}" != "200" ]; then
-            echo "No dev branch -- skipping"
-            exit 0
-          fi
-
-          # Create branch from dev
-          HTTP=$(curl -sf -o /dev/null -w '%{http_code}' -X POST \
-            -H "Authorization: token ${TOKEN}" \
-            -H "Content-Type: application/json" \
-            "${API}/branches" \
-            -d "{\"new_branch_name\":\"${BRANCH}\",\"old_branch_name\":\"dev\"}" 2>/dev/null || echo "000")
-
-          if [ "${HTTP}" = "201" ]; then
-            echo "Created branch: ${BRANCH}"
-
-            # Comment on issue with branch link
-            REPO_URL="${GITEA_URL}/${{ github.repository }}"
-            BODY="Branch created: [\`${BRANCH}\`](${REPO_URL}/src/branch/${BRANCH})\n\n\`\`\`bash\ngit fetch origin\ngit checkout ${BRANCH}\n\`\`\`"
-
-            curl -sf -X POST \
-              -H "Authorization: token ${TOKEN}" \
-              -H "Content-Type: application/json" \
-              "${API}/issues/${ISSUE_NUM}/comments" \
-              -d "{\"body\":\"${BODY}\"}" > /dev/null 2>&1
-
-            echo "Commented on issue #${ISSUE_NUM}"
-          else
-            echo "Failed to create branch (HTTP ${HTTP}) -- may already exist"
-          fi

.mokogitea/workflows/notify.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Notifications
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
+# INGROUP: moko-platform.Notifications
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 # PATH: /.gitea/workflows/notify.yml
 # VERSION: 01.00.00
 # BRIEF: Push notifications via ntfy on release success or workflow failure
@@ -18,7 +18,6 @@ on:
       - "Joomla Build & Release"
       - "Joomla Extension CI"
       - "Deploy"
-      - "Cascade Main → Dev"
     types:
       - completed
 

.mokogitea/workflows/pre-release.yml

@@ -1,233 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Release
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /templates/workflows/universal/pre-release.yml.template
-# VERSION: 05.01.00
-# BRIEF: Manual pre-release -- builds dev/alpha/beta/rc packages from any branch
-
-name: "Universal: Pre-Release"
-
-on:
-  pull_request:
-    types: [closed]
-    branches:
-      - dev
-  workflow_dispatch:
-    inputs:
-      stability:
-        description: 'Pre-release channel'
-        required: true
-        type: choice
-        options:
-          - development
-          - alpha
-          - beta
-          - release-candidate
-
-permissions:
-  contents: write
-
-env:
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-  GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
-  GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
-
-jobs:
-  build:
-    name: "Build Pre-Release (${{ inputs.stability || 'development' }})"
-    runs-on: release
-    if: >-
-      github.event_name == 'workflow_dispatch' ||
-      (github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'dev')
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
-
-      - name: Setup moko-platform tools
-        env:
-          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
-          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
-        run: |
-          if ! command -v composer &> /dev/null; then
-            sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
-          fi
-          # Always fetch latest CLI tools — never use stale cache from previous runs
-          rm -rf /tmp/moko-platform-api
-          git clone --depth 1 --branch main --quiet \
-            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
-            /tmp/moko-platform-api
-          cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
-          echo "MOKO_CLI=/tmp/moko-platform-api/cli" >> "$GITHUB_ENV"
-
-      - name: Detect platform
-        id: platform
-        run: |
-          php ${MOKO_CLI}/manifest_read.php --path . --github-output
-
-      - name: Resolve metadata and bump version
-        id: meta
-        run: |
-          STABILITY="${{ inputs.stability || 'development' }}"
-
-          case "$STABILITY" in
-            development)        SUFFIX="-dev";   TAG="development" ;;
-            alpha)              SUFFIX="-alpha"; TAG="alpha" ;;
-            beta)               SUFFIX="-beta";  TAG="beta" ;;
-            release-candidate)  SUFFIX="-rc";    TAG="release-candidate" ;;
-          esac
-
-          # Read current version (bump already handled by push workflow)
-          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null)
-          [ -z "$VERSION" ] && VERSION="00.00.01"
-
-          # Strip any existing suffix from version before applying stability
-          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
-
-          php ${MOKO_CLI}/version_set_platform.php \
-            --path . --version "$VERSION" --branch "${{ github.ref_name }}" --stability "$STABILITY" 2>/dev/null || true
-
-          # Verify version consistency across all files
-          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
-
-          # Update VERSION variable with suffix
-          if [ -n "$SUFFIX" ]; then
-            VERSION="${VERSION}${SUFFIX}"
-          fi
-
-          # Commit version bump
-          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-          git config --local user.name "gitea-actions[bot]"
-          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
-          git add -A
-          git diff --cached --quiet || {
-            git commit -m "chore(version): pre-release bump to ${VERSION} [skip ci]"
-            git push origin HEAD 2>&1
-          }
-
-          # Auto-detect element via manifest_element.php
-          php ${MOKO_CLI}/manifest_element.php \
-            --path . --version "$VERSION" --stability "$STABILITY" \
-            --repo "${GITEA_REPO}" --github-output
-
-          # Read back element outputs
-          EXT_ELEMENT=$(grep '^ext_element=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
-          ZIP_NAME=$(grep '^zip_name=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
-          [ -z "$EXT_ELEMENT" ] && EXT_ELEMENT=$(echo "${GITEA_REPO}" | tr '[:upper:]' '[:lower:]' | tr -d ' -')
-          [ -z "$ZIP_NAME" ] && ZIP_NAME="${EXT_ELEMENT}-${VERSION}.zip"
-
-          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
-          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
-          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
-          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
-          echo "zip_name=${ZIP_NAME}" >> "$GITHUB_OUTPUT"
-          echo "ext_element=${EXT_ELEMENT}" >> "$GITHUB_OUTPUT"
-
-          echo "=== Pre-Release: ${EXT_ELEMENT} ${VERSION}${SUFFIX} ==="
-
-      - name: Create release
-        id: release
-        run: |
-          TAG="${{ steps.meta.outputs.tag }}"
-          VERSION="${{ steps.meta.outputs.version }}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          php ${MOKO_CLI}/release_create.php \
-            --path . --version "$VERSION" --tag "$TAG" \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-            --repo "${GITEA_REPO}" --branch dev --prerelease
-
-      - name: Build package and upload
-        id: package
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          TAG="${{ steps.meta.outputs.tag }}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          php ${MOKO_CLI}/release_package.php \
-            --path . --version "$VERSION" --tag "$TAG" \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-            --repo "${GITEA_REPO}" --output /tmp || true
-
-      - name: Update updates.xml
-        if: steps.platform.outputs.platform == 'joomla'
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          STABILITY="${{ steps.meta.outputs.stability }}"
-          SHA256="${{ steps.package.outputs.sha256_zip }}"
-
-          if [ ! -f "updates.xml" ]; then
-            echo "No updates.xml -- skipping"
-            exit 0
-          fi
-
-          SHA_FLAG=""
-          [ -n "$SHA256" ] && SHA_FLAG="--sha ${SHA256}"
-
-          php ${MOKO_CLI}/updates_xml_build.php \
-            --path . --version "${VERSION}" --stability "${STABILITY}" \
-            --gitea-url "${GITEA_URL}" --org "${GITEA_ORG}" --repo "${GITEA_REPO}" \
-            ${SHA_FLAG}
-
-          # Commit and push
-          if ! git diff --quiet updates.xml 2>/dev/null; then
-            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-            git config --local user.name "gitea-actions[bot]"
-            git add updates.xml
-            git commit -m "chore: update ${STABILITY} channel ${VERSION} [skip ci]"
-            git push origin HEAD 2>&1 || echo "WARNING: push failed"
-          fi
-
-      - name: "Sync updates.xml to all branches"
-        if: steps.platform.outputs.platform == 'joomla'
-        run: |
-          CURRENT_BRANCH="${{ github.ref_name }}"
-          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-          git config --local user.name "gitea-actions[bot]"
-
-          for BRANCH in main dev; do
-            [ "$BRANCH" = "$CURRENT_BRANCH" ] && continue
-            echo "Syncing updates.xml -> ${BRANCH}"
-            git fetch origin "${BRANCH}" 2>/dev/null || continue
-            git checkout "origin/${BRANCH}" -- updates.xml 2>/dev/null || continue
-            git checkout "${CURRENT_BRANCH}" -- updates.xml
-            if ! git diff --quiet updates.xml 2>/dev/null; then
-              git add updates.xml
-              git commit -m "chore: sync updates.xml from ${CURRENT_BRANCH} [skip ci]"
-              git push origin HEAD:refs/heads/${BRANCH} 2>&1 || echo "WARNING: push to ${BRANCH} failed"
-            fi
-            git checkout "${CURRENT_BRANCH}" 2>/dev/null
-          done
-
-      - name: "Delete lesser pre-release channels (cascade)"
-        continue-on-error: true
-        run: |
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
-
-          php ${MOKO_CLI}/release_cascade.php \
-            --stability "${{ steps.meta.outputs.stability }}" \
-            --token "${TOKEN}" \
-            --api-base "${API_BASE}"
-
-      - name: Summary
-        if: always()
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          STABILITY="${{ steps.meta.outputs.stability }}"
-          ZIP_NAME="${{ steps.meta.outputs.zip_name }}"
-          SHA256="${{ steps.package.outputs.sha256_zip }}"
-          echo "## Pre-Release Complete" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
-          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
-          echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
-          echo "| Channel | ${STABILITY} |" >> $GITHUB_STEP_SUMMARY
-          echo "| Package | \`${ZIP_NAME}\` |" >> $GITHUB_STEP_SUMMARY
-          echo "| SHA-256 | \`${SHA256:-n/a}\` |" >> $GITHUB_STEP_SUMMARY

.mokogitea/workflows/security-audit.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Security
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
+# INGROUP: moko-platform.Security
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 # PATH: /.gitea/workflows/security-audit.yml
 # VERSION: 01.00.00
 # BRIEF: Dependency vulnerability scanning for composer and npm packages
@@ -80,3 +80,19 @@ jobs:
             -H "Priority: high" \
             -d "Security audit found vulnerabilities. Review dependency updates." \
             "${NTFY_URL}/${NTFY_TOPIC}" || true
+
+
+      - name: Joomla version audit
+        if: always()
+        run: |
+          if [ -f "monitoring/joomla-version-audit.php" ] && [ -n "$JOOMLA_SITES" ]; then
+            echo "$JOOMLA_SITES" > /tmp/sites.json
+            php monitoring/joomla-version-audit.php --sites /tmp/sites.json || true
+            echo "### Joomla Version Audit" >> $GITHUB_STEP_SUMMARY
+            rm -f /tmp/sites.json
+          else
+            echo "Joomla audit skipped (no script or JOOMLA_SITES_JSON not configured)"
+          fi
+        env:
+          JOOMLA_SITES: ${{ vars.JOOMLA_SITES_JSON }}
+

.mokogitea/workflows/update-server.yml

@@ -1,312 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Universal
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /templates/workflows/update-server.yml
-# VERSION: 05.00.00
-# BRIEF: Pre-release build + update server XML for dev/alpha/beta/rc branches
-#
-# Thin wrapper around moko-platform CLI tools.
-# Builds packages, updates updates.xml, and optionally deploys via SFTP.
-#
-# Joomla filters update entries by the user's "Minimum Stability" setting.
-
-name: "Update Server"
-
-on:
-  push:
-    branches:
-      - 'dev'
-      - 'dev/**'
-      - 'alpha/**'
-      - 'beta/**'
-      - 'rc/**'
-    paths:
-      - 'src/**'
-      - 'htdocs/**'
-  pull_request:
-    types: [closed]
-    branches:
-      - 'dev'
-      - 'dev/**'
-      - 'alpha/**'
-      - 'beta/**'
-      - 'rc/**'
-    paths:
-      - 'src/**'
-      - 'htdocs/**'
-  workflow_dispatch:
-    inputs:
-      stability:
-        description: 'Stability tag'
-        required: true
-        default: 'development'
-        type: choice
-        options:
-          - development
-          - alpha
-          - beta
-          - rc
-          - stable
-
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-  GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
-  GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
-
-permissions:
-  contents: write
-
-jobs:
-  update-xml:
-    name: Update Server
-    runs-on: release
-    if: >-
-      github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch' || github.event_name == 'push'
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
-          fetch-depth: 0
-
-      - name: Setup moko-platform tools
-        env:
-          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
-          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
-          COMPOSER_AUTH: '{"http-basic":{"git.mokoconsulting.tech":{"username":"token","password":"${{ secrets.MOKOGITEA_TOKEN }}"}}}'
-        run: |
-          if ! command -v composer &> /dev/null; then
-            sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
-          fi
-          # Always fetch latest CLI tools — never use stale cache from previous runs
-          rm -rf /tmp/moko-platform
-          git clone --depth 1 --branch main --quiet \
-            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
-            /tmp/moko-platform 2>/dev/null || true
-          if [ -d "/tmp/moko-platform" ] && [ -f "/tmp/moko-platform/composer.json" ]; then
-            cd /tmp/moko-platform && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
-          fi
-          echo "MOKO_CLI=/tmp/moko-platform/cli" >> "$GITHUB_ENV"
-
-      - name: Detect platform
-        id: platform
-        run: php ${MOKO_CLI}/manifest_read.php --path . --github-output
-
-      - name: Resolve stability and bump version
-        id: meta
-        run: |
-          BRANCH="${{ github.ref_name }}"
-
-          # Configure git for bot pushes
-          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-          git config --local user.name "gitea-actions[bot]"
-          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
-
-          # Auto-bump patch version
-          php ${MOKO_CLI}/version_bump.php --path . 2>/dev/null || true
-
-          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "0.0.0")
-
-          # Strip any existing suffix before applying stability
-          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
-
-          # Determine stability from branch or manual input
-          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            STABILITY="${{ inputs.stability }}"
-          elif [[ "$BRANCH" == rc/* ]]; then
-            STABILITY="rc"
-          elif [[ "$BRANCH" == beta/* ]]; then
-            STABILITY="beta"
-          elif [[ "$BRANCH" == alpha/* ]]; then
-            STABILITY="alpha"
-          else
-            STABILITY="development"
-          fi
-
-          # Version suffix per stability stream
-          case "$STABILITY" in
-            development) SUFFIX="-dev";  TAG="development" ;;
-            alpha)       SUFFIX="-alpha"; TAG="alpha" ;;
-            beta)        SUFFIX="-beta";  TAG="beta" ;;
-            rc)          SUFFIX="-rc";    TAG="release-candidate" ;;
-            *)           SUFFIX="";       TAG="stable" ;;
-          esac
-
-          # Propagate version with stability suffix to all manifest files
-          php ${MOKO_CLI}/version_set_platform.php \
-            --path . --version "$VERSION" --branch "$BRANCH" --stability "$STABILITY" 2>/dev/null || true
-          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
-
-          # Re-read version (now includes suffix from version_set_platform)
-          if [ -n "$SUFFIX" ]; then
-            VERSION="${VERSION}${SUFFIX}"
-          fi
-
-          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
-          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
-          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
-          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
-          echo "display_version=${VERSION}" >> "$GITHUB_OUTPUT"
-
-          # Commit version bump if changed
-          git add -A
-          git diff --cached --quiet || {
-            git commit -m "chore(version): auto-bump ${VERSION} [skip ci]" \
-              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
-            git push
-          }
-
-      - name: Create release and upload package
-        id: package
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          TAG="${{ steps.meta.outputs.tag }}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-
-          # Create or update Gitea release
-          php ${MOKO_CLI}/release_create.php \
-            --path . --version "$VERSION" --tag "$TAG" \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-            --repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease
-
-          # Build package and upload
-          php ${MOKO_CLI}/release_package.php \
-            --path . --version "$VERSION" --tag "$TAG" \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-            --repo "${GITEA_REPO}" --output /tmp || true
-
-      - name: Update updates.xml
-        if: steps.platform.outputs.platform == 'joomla'
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          STABILITY="${{ steps.meta.outputs.stability }}"
-          SHA256="${{ steps.package.outputs.sha256_zip }}"
-
-          if [ ! -f "updates.xml" ]; then
-            echo "No updates.xml — skipping"
-            exit 0
-          fi
-
-          SHA_FLAG=""
-          [ -n "$SHA256" ] && SHA_FLAG="--sha ${SHA256}"
-
-          php ${MOKO_CLI}/updates_xml_build.php \
-            --path . --version "${VERSION}" --stability "${STABILITY}" \
-            --gitea-url "${GITEA_URL}" --org "${GITEA_ORG}" --repo "${GITEA_REPO}" \
-            ${SHA_FLAG}
-
-          # Commit and push updates.xml
-          git add updates.xml
-          git diff --cached --quiet || {
-            git commit -m "chore: update ${STABILITY} channel ${VERSION} [skip ci]"
-            git push
-          }
-
-      - name: Sync updates.xml to main
-        if: github.ref_name != 'main' && steps.platform.outputs.platform == 'joomla'
-        run: |
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          GITEA_TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
-
-          FILE_SHA=$(curl -sf -H "Authorization: token ${GITEA_TOKEN}" \
-            "${API_BASE}/contents/updates.xml?ref=main" | python3 -c "import sys,json; print(json.load(sys.stdin).get('sha',''))" 2>/dev/null || true)
-
-          if [ -n "$FILE_SHA" ] && [ -f "updates.xml" ]; then
-            python3 -c "
-          import base64, json, urllib.request, sys
-          with open('updates.xml', 'rb') as f:
-              content = base64.b64encode(f.read()).decode()
-          payload = json.dumps({
-              'content': content,
-              'sha': '${FILE_SHA}',
-              'message': 'chore: sync updates.xml from ${{ steps.meta.outputs.stability }} [skip ci]',
-              'branch': 'main'
-          }).encode()
-          req = urllib.request.Request(
-              '${API_BASE}/contents/updates.xml',
-              data=payload, method='PUT',
-              headers={
-                  'Authorization': 'token ${GITEA_TOKEN}',
-                  'Content-Type': 'application/json'
-              })
-          try:
-              urllib.request.urlopen(req)
-              print('updates.xml synced to main')
-          except Exception as e:
-              print(f'WARNING: sync to main failed: {e}', file=sys.stderr)
-          "
-          fi
-
-      - name: SFTP deploy to dev server
-        if: contains(github.ref, 'dev/') || github.ref == 'refs/heads/dev'
-        env:
-          DEV_HOST: ${{ vars.DEV_FTP_HOST }}
-          DEV_PATH: ${{ vars.DEV_FTP_PATH }}
-          DEV_SUFFIX: ${{ vars.DEV_FTP_SUFFIX }}
-          DEV_USER: ${{ vars.DEV_FTP_USERNAME }}
-          DEV_PORT: ${{ vars.DEV_FTP_PORT }}
-          DEV_KEY: ${{ secrets.DEV_FTP_KEY }}
-          DEV_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
-        run: |
-          # Permission check: admin or maintain role required
-          ACTOR="${{ github.actor }}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-
-          PERMISSION=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
-            "${API_BASE}/collaborators/${ACTOR}/permission" 2>/dev/null | \
-            python3 -c "import sys,json; print(json.load(sys.stdin).get('permission','read'))" 2>/dev/null || echo "read")
-          case "$PERMISSION" in
-            admin|maintain|write) ;;
-            *)
-              echo "Deploy denied: ${ACTOR} has '${PERMISSION}' — requires admin, maintain, or write"
-              exit 0
-              ;;
-          esac
-
-          [ -z "$DEV_HOST" ] || [ -z "$DEV_PATH" ] && { echo "DEV FTP not configured — skipping SFTP"; exit 0; }
-
-          SOURCE_DIR="src"
-          [ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
-          [ ! -d "$SOURCE_DIR" ] && exit 0
-
-          PORT="${DEV_PORT:-22}"
-          REMOTE="${DEV_PATH%/}"
-          [ -n "$DEV_SUFFIX" ] && REMOTE="${REMOTE}/${DEV_SUFFIX#/}"
-
-          printf '{"host":"%s","port":%s,"username":"%s","remotePath":"%s"' \
-            "$DEV_HOST" "$PORT" "$DEV_USER" "$REMOTE" > /tmp/sftp-config.json
-          if [ -n "$DEV_KEY" ]; then
-            echo "$DEV_KEY" > /tmp/deploy_key && chmod 600 /tmp/deploy_key
-            printf ',"privateKeyPath":"/tmp/deploy_key"}' >> /tmp/sftp-config.json
-          else
-            printf ',"password":"%s"}' "$DEV_PASS" >> /tmp/sftp-config.json
-          fi
-
-          PLATFORM=$(php ${MOKO_CLI}/platform_detect.php --path . 2>/dev/null || true)
-          if [ "$PLATFORM" = "waas-component" ] && [ -f "${MOKO_CLI}/../deploy/deploy-joomla.php" ]; then
-            php ${MOKO_CLI}/../deploy/deploy-joomla.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
-          elif [ -f "${MOKO_CLI}/../deploy/deploy-sftp.php" ]; then
-            php ${MOKO_CLI}/../deploy/deploy-sftp.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
-          fi
-          rm -f /tmp/deploy_key /tmp/sftp-config.json
-          echo "SFTP deploy to dev complete" >> $GITHUB_STEP_SUMMARY
-
-      - name: Summary
-        if: always()
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          STABILITY="${{ steps.meta.outputs.stability }}"
-          DISPLAY="${{ steps.meta.outputs.display_version }}"
-          echo "## Update Server" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
-          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
-          echo "| Stability | \`${STABILITY}\` |" >> $GITHUB_STEP_SUMMARY
-          echo "| Version | \`${DISPLAY}\` |" >> $GITHUB_STEP_SUMMARY

CHANGELOG.md

@@ -1,24 +1,44 @@
 # Changelog
 
-<!-- VERSION: 01.00.00 -->
+<!-- VERSION: 01.00.01 -->
 
-All notable changes to MokoOpenGraph will be documented in this file.
+All notable changes to MokoJoomOpenGraph will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-### Removed
-- Removed deploy-manual.yml workflow — switching to Joomla update server method for extension distribution
+### Security
+- Fix JSON-LD XSS vulnerability via `</script>` injection in content data (#34)
+- Add ACL permission checks to Batch and ImportExport controllers (#37)
+- Add CSV import file type, MIME type, size, and content_type validation (#35)
+- Fix multilingual data corruption in content plugin load/save (#41)
 
 ### Added
-- Initial package structure with component, system plugin, and content plugin
-- Open Graph meta tag injection via system plugin (`onBeforeCompileHead`)
-- Twitter/X Card meta tag support (Summary and Summary with Large Image)
-- Per-article OG fields in the article editor
-- Per-menu-item OG fields in the menu item editor
-- Auto-generation of OG tags from article title, description, and images
+- 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`
+- `og:image:width` and `og:image:height` for faster social preview rendering
+- `onMokoOGAfterRender` event for third-party plugin extensibility
+- Joomla Web Services API for OG tags — full CRUD at `/api/v1/mokoog/tags` (#27)
+- Live social preview in article/menu editors (Facebook and Twitter/X card mockups) (#3)
+- CSV import/export for bulk OG tag management (#12)
+- OG image text overlay generator (#7)
+- Multilingual OG tag support with per-language records (#11)
+- JSON-LD structured data: Article, WebPage, BreadcrumbList schemas (#6)
+- Social platform debugger quick links (Facebook, LinkedIn, Google) (#9)
+- Content type adapter architecture for K2, VirtueMart, HikaShop (#5)
+- WhatsApp and Telegram link preview optimization (#10)
+- Category-level OG tag support (#4)
+- Batch OG tag generation for existing articles (#1)
+- Auto-resize OG images to 1200x630px with center crop (#2)
+- SEO meta tag management: title, description, robots, canonical URL (#8)
+- Per-article and per-menu-item OG fields in the editor
+- Auto-generation of OG tags from article content, title, and images
 - Default fallback image configuration
-- Admin tag manager component for viewing all OG records
-- Facebook App ID support
-- Database table `#__mokoog_tags` for storing custom OG data
+- Admin tag manager component with filtering, search, and pagination
+- Facebook App ID and Telegram channel support
+- Database table `#__mokoog_tags` with multilingual unique key
+
+### Removed
+- Removed deploy-manual.yml workflow — using Joomla update server for distribution

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code when working with this repository.
 
 ## Project Overview
 
-**MokoOpenGraph** -- Open Graph, Twitter Card, and social sharing meta tag management for Joomla
+**MokoJoomOpenGraph** -- Open Graph, Twitter Card, and social sharing meta tag management for Joomla
 
 | Field | Value |
 |---|---|
@@ -12,7 +12,7 @@ This file provides guidance to Claude Code when working with this repository.
 | **Language** | PHP |
 | **Default branch** | main |
 | **License** | GPL-3.0-or-later |
-| **Wiki** | [MokoOpenGraph Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoOpenGraph/wiki) |
+| **Wiki** | [MokoJoomOpenGraph Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/wiki) |
 | **Standards** | [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home) |
 
 ## Common Commands

CODE_OF_CONDUCT.md

@@ -0,0 +1,28 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project team at hello@mokoconsulting.tech. All complaints will be reviewed and investigated.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

CONTRIBUTING.md

@@ -1,161 +1,34 @@
-# Contributing to Moko Consulting Projects
-
-Thank you for your interest in contributing. All Moko Consulting repositories follow this universal workflow and version policy.
-
-## Branching Workflow
-
-```
-feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge──> main
-```
-
-### Step by step
-
-1. **Create a feature branch** from `dev`:
-   ```bash
-   git checkout dev && git pull
-   git checkout -b feature/my-change
-   ```
-
-2. **Work and commit** on your feature branch. Push to origin.
-
-3. **Open a PR**: `feature/my-change` → `dev`. After review and checks, merge it.
-
-4. **When ready for release**, open a **draft PR**: `dev` → `main`.
-   - This automatically renames the source branch to `rc` (release candidate)
-   - An RC pre-release is built and uploaded
-
-5. **Alpha and beta branches** are created by manually renaming the branch before the RC stage:
-   - Rename `dev` to `alpha` for early testing → alpha pre-release is built
-   - Rename `alpha` to `beta` for feature-complete testing → beta pre-release is built
-   - When the draft PR is created, the branch is renamed to `rc`
-
-6. **Once PR checks pass** on the `rc` branch, mark the PR as ready and merge to `main`.
-
-7. **Merging to main** triggers the stable release pipeline:
-   - Minor version bump (e.g., `02.09.xx` → `02.10.00`)
-   - Stability suffix stripped (clean version)
-   - Gitea release created with ZIP/tar.gz packages
-   - `updates.xml` updated (Joomla extensions)
-   - `dev` branch recreated from `main`
-
-### Branch summary
-
-| Branch | Purpose | Created by |
-|--------|---------|-----------|
-| `feature/*` | New features and fixes | Developer |
-| `dev` | Integration branch | Auto-recreated after release |
-| `alpha` | Alpha pre-release testing | Manual rename from `dev` |
-| `beta` | Beta pre-release testing | Manual rename from `alpha` |
-| `rc` | Release candidate | Auto-renamed on draft PR to main |
-| `main` | Stable releases | Protected, merge only |
-| `version/XX.YY.ZZ` | Archived release snapshots | Auto-created by CI |
-
-### Protected branches
-
-| Branch | Direct push | Merge via |
-|--------|------------|-----------|
-| `main` | Blocked (CI bot whitelisted) | PR merge only |
-| `dev` | Blocked (CI bot whitelisted) | PR merge from feature/* |
-| `rc` | Blocked (CI bot whitelisted) | Auto-created on draft PR |
-| `alpha` | Blocked (CI bot whitelisted) | Manual rename |
-| `beta` | Blocked (CI bot whitelisted) | Manual rename |
-| `feature/*` | Open | N/A (source branch) |
-
-## Version Policy
-
-### Format
-
-All versions use `XX.YY.ZZ` — three two-digit segments, zero-padded:
-
-- **XX** — Major version (breaking changes)
-- **YY** — Minor version (new features, bumped on release to main)
-- **ZZ** — Patch version (auto-incremented on every push to dev/feature branches)
-
-Rollover: patch `99` → `00` increments minor; minor `99` → `00` increments major.
-
-### Stability suffixes
-
-Each branch appends a suffix to indicate stability:
-
-| Branch | Suffix | Example |
-|--------|--------|---------|
-| `main` | (none) | `02.09.00` |
-| `dev` | `-dev` | `02.09.01-dev` |
-| `feature/*` | `-dev` | `02.09.01-dev` |
-| `alpha` | `-alpha` | `02.09.01-alpha` |
-| `beta` | `-beta` | `02.09.01-beta` |
-| `rc` | `-rc` | `02.09.01-rc` |
-
-### Auto version bump
-
-On every push to `dev`, `feature/*`, or `patch/*`:
-
-1. Patch version incremented
-2. Stability suffix `-dev` applied
-3. All version-bearing files updated (manifests, CHANGELOG, PHP headers, etc.)
-4. Commit created with `[skip ci]` to avoid loops
-
-### Release version flow
-
-Version bumps happen at specific release events:
-
-| Event | Bump | Example |
-|-------|------|---------|
-| Feature merged to dev | Patch bump after dev release | `02.09.01-dev` → release → `02.09.02-dev` |
-| Dev promoted to RC | Minor bump | `02.09.02-dev` → `02.10.00-rc` |
-| RC merged to main | Minor bump | `02.10.00-rc` → `02.11.00` (stable) |
-| Dev recreated from main | Patch bump | `02.11.00` → `02.11.01-dev` |
-
-### Release stream copies
-
-When a higher-stability release is published, copies are created for all lesser streams with the same base version:
-
-- **RC `02.10.00-rc`** also creates: `02.10.00-dev`, `02.10.00-alpha`, `02.10.00-beta`
-- **Stable `02.11.00`** also creates: `02.11.00-dev`, `02.11.00-alpha`, `02.11.00-beta`, `02.11.00-rc`
-
-This ensures Joomla sites on ANY stability channel see the update (Joomla only shows versions higher than what's installed).
-
-### Version files
-
-The version tools update all files containing version stamps:
-
-- `.mokogitea/manifest.xml` (canonical source)
-- Joomla XML manifests (`<version>` tag)
-- `README.md`, `CHANGELOG.md` (`VERSION:` pattern)
-- `package.json`, `pyproject.toml`
-- Any text file with a `VERSION: XX.YY.ZZ` label
-
-Files synced from other repos (with a `# REPO:` header) are not touched.
-
-## Code Standards
-
-- **PHP**: PSR-12, tabs for indentation
-- **Copyright**: all files must include the Moko Consulting copyright header
-- **License**: SPDX identifier `GPL-3.0-or-later` (or as specified per repo)
-- **Attribution**: use `Authored-by: Moko Consulting` in commits, not individual names
-
-## Commit Messages
-
-Use conventional commit format:
-
-```
-type(scope): short description
-
-Optional body with context.
-
-Authored-by: Moko Consulting
-```
-
-Types: `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `ci`
-
-Special flags in commit messages:
-- `[skip ci]` — skip all CI workflows
-- `[skip bump]` — skip auto version bump only
-
-## Reporting Issues
-
-Use the repository's issue tracker with the appropriate template.
-
----
-
-*Moko Consulting <hello@mokoconsulting.tech>*
+# Contributing to MokoJoomOpenGraph
+
+Thank you for your interest in contributing to MokoJoomOpenGraph.
+
+## Getting Started
+
+1. Fork the repository on Gitea
+2. Create a feature branch from `dev` (`feature/your-feature`)
+3. Make your changes following the coding standards below
+4. Submit a pull request targeting `dev`
+
+## Branch Strategy
+
+- `main` — stable releases only
+- `dev` — active development
+- `feature/*` — new features (target `dev`)
+- `fix/*` — bug fixes (target `dev`)
+- `hotfix/*` — urgent fixes (target `dev` or `main`)
+
+## Coding Standards
+
+- PHP 8.1+ required
+- Follow Joomla coding standards
+- SPDX license headers on all PHP files
+- Use `SubscriberInterface` for event subscription
+- Use `bind() -> check() -> store()` for Table operations
+
+## Reporting Issues
+
+Report bugs and feature requests via [Issues](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/issues).
+
+## License
+
+By contributing, you agree that your contributions will be licensed under GPL-3.0-or-later.

Makefile

@@ -2,7 +2,7 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
-# MokoOpenGraph — Open Graph & social sharing meta tag management
+# MokoJoomOpenGraph — Open Graph & social sharing meta tag management
 
 # ==============================================================================
 # CONFIGURATION - Customize these for your extension

README.md

@@ -1,40 +1,69 @@
-# MokoOpenGraph
+# MokoJoomOpenGraph
 
-<!-- VERSION: 01.00.00 -->
+<!-- VERSION: 01.00.01 -->
 
 Open Graph, Twitter Card, and social sharing meta tag management for Joomla 4/5/6.
 
 ## Overview
 
-MokoOpenGraph gives you full control over how your Joomla content appears when shared on Facebook, Twitter/X, LinkedIn, WhatsApp, and other social platforms. Set custom titles, descriptions, and images per article and menu item — or let the extension auto-generate them from your existing content.
+MokoJoomOpenGraph gives you full control over how your Joomla content appears when shared on Facebook, Twitter/X, LinkedIn, Discord, WhatsApp, Telegram, and other social platforms. Set custom titles, descriptions, and images per article, menu item, and category — or let the extension auto-generate them from your existing content.
 
 ## Features
 
-- **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`
+### Social Meta Tags
+- **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`, `og:locale`
 - **Twitter/X Cards** — Summary and Summary with Large Image card types
-- **Per-article control** — Custom OG fields in the article editor
+- **LinkedIn** — `article:published_time`, `article:modified_time`, `article:author`
+- **Discord** — Custom embed color via `theme-color` meta tag
+- **Telegram** — `telegram:channel` for link previews
+- **Facebook** — `fb:app_id` support, `og:image:width`/`og:image:height` for instant previews
+
+### Content Management
+- **Per-article control** — Custom OG fields tab in the article editor
 - **Per-menu-item control** — Custom OG fields in the menu item editor
-- **Auto-generation** — Automatically builds tags from article content, title, and images
-- **Default fallback image** — Site-wide default when no article image exists
-- **Admin tag manager** — View and manage all OG records from a central dashboard
-- **Facebook App ID** — Optional `fb:app_id` meta tag support
-- **Joomla 4/5/6** — Modern DI container architecture, Joomla coding standards
+- **Per-category control** — Category-level OG tag overrides
+- **Multilingual support** — Per-language OG data with language-aware fallback
+- **Auto-generation** — Builds tags from article content, title, and images automatically
+- **Site-wide defaults** — Default OG title, description, and image for all pages
+
+### SEO
+- **SEO title override** — Custom `<title>` tag per page
+- **Meta description** — Per-page meta description control
+- **Robots directive** — Per-page noindex/nofollow settings
+- **Canonical URL** — Custom canonical URL overrides
+- **JSON-LD structured data** — Article, WebPage, BreadcrumbList, Organization schemas
+
+### Admin Tools
+- **Tag manager dashboard** — View and manage all OG records centrally
+- **Batch generation** — Auto-generate OG tags for all existing articles
+- **CSV import/export** — Bulk manage OG data via CSV files
+- **SEO health badges** — Visual indicators for missing descriptions, long titles, noindex
+- **Debug links** — Quick links to Facebook Debugger, LinkedIn Inspector, Google Rich Results
+- **Live preview** — Real-time Facebook and Twitter/X card preview in the editor
+
+### Developer Features
+- **REST API** — Full CRUD via Joomla Web Services (`/api/v1/mokoog/tags`)
+- **Content type adapters** — Extensible architecture for K2, VirtueMart, HikaShop
+- **Plugin event** — `onMokoOGAfterRender` for third-party plugins to add custom social tags
+- **OG image generator** — Text overlay on template backgrounds with auto-resize to 1200x630
 
 ## Installation
 
-1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoOpenGraph/releases)
+1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/releases)
 2. In Joomla Administrator → Extensions → Install → Upload Package File
-3. The system plugin is enabled automatically on install
+3. All plugins are enabled automatically on install
 
 ## Configuration
 
-Navigate to **Extensions → Plugins → System - MokoOpenGraph** to configure:
+Navigate to **Extensions → Plugins → System - MokoJoomOpenGraph** to configure:
 - Site name override
+- Default OG title and description (site-wide fallback)
 - Default fallback image
 - Twitter Card type and @username
 - Facebook App ID
-- Auto-generation behavior
-- Description length limit
+- Discord embed color
+- Telegram channel
+- Auto-generation, image resize, JSON-LD, and description length settings
 
 ## License
 

composer.json

@@ -17,8 +17,10 @@
     "require-dev": {
         "squizlabs/php_codesniffer": "^3.7",
         "phpstan/phpstan": "^1.10",
-        "joomla/coding-standards": "^4.0"
+        "joomla/coding-standards": "^3.0"
     },
+    "minimum-stability": "alpha",
+    "prefer-stable": true,
     "config": {
         "sort-packages": true
     }

src/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/language/en-GB/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/language/en-GB/pkg_mokoog.sys.ini

@@ -1,7 +1,7 @@
-; MokoOpenGraph - Package System Language File
+; MokoJoomOpenGraph - Package System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-PKG_MOKOOG="MokoOpenGraph"
+PKG_MOKOOG="MokoJoomOpenGraph"
 PKG_MOKOOG_DESCRIPTION="Complete Open Graph, Twitter Card, and social sharing meta tag management for Joomla. Control how every page appears when shared on Facebook, Twitter/X, LinkedIn, WhatsApp, and more."
-PKG_MOKOOG_PHP_VERSION_ERROR="MokoOpenGraph requires PHP %s or later."
+PKG_MOKOOG_PHP_VERSION_ERROR="MokoJoomOpenGraph requires PHP %s or later."

src/language/en-US/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/language/en-US/pkg_mokoog.sys.ini

@@ -1,7 +1,7 @@
-; MokoOpenGraph - Package System Language File
+; MokoJoomOpenGraph - Package System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-PKG_MOKOOG="MokoOpenGraph"
+PKG_MOKOOG="MokoJoomOpenGraph"
 PKG_MOKOOG_DESCRIPTION="Complete Open Graph, Twitter Card, and social sharing meta tag management for Joomla. Control how every page appears when shared on Facebook, Twitter/X, LinkedIn, WhatsApp, and more."
-PKG_MOKOOG_PHP_VERSION_ERROR="MokoOpenGraph requires PHP %s or later."
+PKG_MOKOOG_PHP_VERSION_ERROR="MokoJoomOpenGraph requires PHP %s or later."

src/language/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/api/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/api/src/Controller/TagsController.php

@@ -0,0 +1,68 @@
+<?php
+
+/**
+ * @package     MokoJoomOpenGraph
+ * @subpackage  com_mokoog.api
+ * @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\Component\MokoOG\Api\Controller;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\Controller\ApiController;
+
+class TagsController extends ApiController
+{
+    /**
+     * The content type for JSON:API output.
+     *
+     * @var string
+     */
+    protected $contentType = 'tags';
+
+    /**
+     * The default view for the API.
+     *
+     * @var string
+     */
+    protected $default_view = 'tags';
+
+    /**
+     * Lookup an OG tag by content_type and content_id.
+     *
+     * GET /api/index.php/v1/mokoog/lookup/:content_type/:content_id
+     *
+     * @return  static
+     */
+    public function lookup(): static
+    {
+        $contentType = $this->input->getString('content_type', '');
+        $contentId   = $this->input->getInt('content_id', 0);
+
+        if (empty($contentType) || $contentId <= 0) {
+            throw new \RuntimeException('content_type and content_id are required', 400);
+        }
+
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('id'))
+            ->from($db->quoteName('#__mokoog_tags'))
+            ->where($db->quoteName('content_type') . ' = ' . $db->quote($contentType))
+            ->where($db->quoteName('content_id') . ' = ' . $contentId);
+
+        $db->setQuery($query);
+        $id = $db->loadResult();
+
+        if (!$id) {
+            throw new \RuntimeException('OG tag not found for ' . $contentType . ':' . $contentId, 404);
+        }
+
+        $this->input->set('id', $id);
+
+        return $this->displayItem();
+    }
+}

src/packages/com_mokoog/api/src/Controller/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/api/src/View/Tags/JsonapiView.php

@@ -0,0 +1,66 @@
+<?php
+
+/**
+ * @package     MokoJoomOpenGraph
+ * @subpackage  com_mokoog.api
+ * @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\Component\MokoOG\Api\View\Tags;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\MVC\View\JsonApiView as BaseApiView;
+
+class JsonapiView extends BaseApiView
+{
+    /**
+     * The fields to render in the API response.
+     *
+     * Whitelist of fields from #__mokoog_tags that are safe to expose.
+     *
+     * @var array
+     */
+    protected $fieldsToRenderItem = [
+        'id',
+        'content_type',
+        'content_id',
+        'og_title',
+        'og_description',
+        'og_image',
+        'og_type',
+        'seo_title',
+        'meta_description',
+        'robots',
+        'canonical_url',
+        'language',
+        'published',
+        'created',
+        'modified',
+    ];
+
+    /**
+     * The fields to render in list responses.
+     *
+     * @var array
+     */
+    protected $fieldsToRenderList = [
+        'id',
+        'content_type',
+        'content_id',
+        'og_title',
+        'og_description',
+        'og_image',
+        'og_type',
+        'seo_title',
+        'meta_description',
+        'robots',
+        'canonical_url',
+        'language',
+        'published',
+        'created',
+        'modified',
+    ];
+}

src/packages/com_mokoog/api/src/View/Tags/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/api/src/View/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/api/src/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/forms/filter_tags.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/forms/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/forms/tag.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -70,4 +70,37 @@
             <option value="0">JUNPUBLISHED</option>
         </field>
     </fieldset>
+    <fieldset name="seo" label="SEO Meta Tags">
+        <field
+            name="seo_title"
+            type="text"
+            label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
+            description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
+            filter="string"
+            maxlength="70"
+        />
+        <field
+            name="meta_description"
+            type="textarea"
+            label="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION"
+            description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
+            filter="string"
+            rows="3"
+            maxlength="200"
+        />
+        <field
+            name="robots"
+            type="text"
+            label="PLG_CONTENT_MOKOOG_FIELD_ROBOTS"
+            description="PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC"
+            filter="string"
+        />
+        <field
+            name="canonical_url"
+            type="url"
+            label="PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL"
+            description="PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC"
+            filter="url"
+        />
+    </fieldset>
 </form>

src/packages/com_mokoog/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/language/en-GB/com_mokoog.ini

@@ -1,9 +1,9 @@
-; MokoOpenGraph - Component Language File
+; MokoJoomOpenGraph - Component Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-COM_MOKOOG="MokoOpenGraph"
-COM_MOKOOG_TAGS_TITLE="MokoOpenGraph - Tag Manager"
+COM_MOKOOG="MokoJoomOpenGraph"
+COM_MOKOOG_TAGS_TITLE="MokoJoomOpenGraph - Tag Manager"
 COM_MOKOOG_SUBMENU_TAGS="Tags"
 COM_MOKOOG_NO_TAGS="No Open Graph tags have been created yet. Tags are created automatically when you edit articles or menu items."
 COM_MOKOOG_TABLE_CAPTION="Table of Open Graph tags"
@@ -13,4 +13,47 @@ COM_MOKOOG_HEADING_CONTENT_TYPE="Content Type"
 COM_MOKOOG_HEADING_CONTENT_ID="Content ID"
 COM_MOKOOG_HEADING_OG_TITLE="OG Title"
 COM_MOKOOG_HEADING_IMAGE="Image"
+COM_MOKOOG_HEADING_SEO="SEO"
+COM_MOKOOG_HEADING_DEBUG="Debug"
 COM_MOKOOG_HEADING_MODIFIED="Modified"
+
+COM_MOKOOG_SEO_OK="OK"
+COM_MOKOOG_SEO_MISSING_DESC="No meta description"
+COM_MOKOOG_SEO_TITLE_LONG="SEO title too long"
+COM_MOKOOG_SEO_NOINDEX="noindex"
+
+COM_MOKOOG_FIELD_CONTENT_TYPE="Content Type"
+COM_MOKOOG_FIELD_CONTENT_ID="Content ID"
+COM_MOKOOG_FIELD_OG_TITLE="OG Title"
+COM_MOKOOG_FIELD_OG_TITLE_DESC="Custom title for social sharing."
+COM_MOKOOG_FIELD_OG_DESCRIPTION="OG Description"
+COM_MOKOOG_FIELD_OG_DESCRIPTION_DESC="Custom description for social sharing."
+COM_MOKOOG_FIELD_OG_IMAGE="OG Image"
+COM_MOKOOG_FIELD_OG_IMAGE_DESC="Custom image for social sharing."
+COM_MOKOOG_FIELD_OG_TYPE="OG Type"
+COM_MOKOOG_FIELD_OG_TYPE_DESC="The Open Graph content type."
+
+COM_MOKOOG_FILTER_SEARCH="Search OG titles"
+COM_MOKOOG_FILTER_CONTENT_TYPE="Content Type"
+COM_MOKOOG_FILTER_SELECT_TYPE="- Select Type -"
+COM_MOKOOG_HEADING_OG_TITLE_ASC="OG Title ascending"
+COM_MOKOOG_HEADING_OG_TITLE_DESC="OG Title descending"
+COM_MOKOOG_HEADING_MODIFIED_ASC="Modified ascending"
+COM_MOKOOG_HEADING_MODIFIED_DESC="Modified descending"
+
+COM_MOKOOG_TOOLBAR_BATCH_GENERATE="Batch Generate"
+COM_MOKOOG_BATCH_TITLE="Batch OG Tag Generation"
+COM_MOKOOG_BATCH_COUNTING="Counting articles without OG tags..."
+COM_MOKOOG_BATCH_NONE="All articles already have OG tags."
+COM_MOKOOG_BATCH_FOUND="articles found without OG tags."
+COM_MOKOOG_BATCH_PROCESSED="processed"
+COM_MOKOOG_BATCH_COMPLETE="Batch generation complete!"
+COM_MOKOOG_BATCH_ERROR="Error:"
+
+COM_MOKOOG_TOOLBAR_EXPORT="Export CSV"
+COM_MOKOOG_TOOLBAR_IMPORT="Import CSV"
+COM_MOKOOG_IMPORT_NO_FILE="No CSV file was uploaded."
+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."

src/packages/com_mokoog/language/en-GB/com_mokoog.sys.ini

@@ -1,6 +1,6 @@
-; MokoOpenGraph - Component System Language File
+; MokoJoomOpenGraph - Component System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-COM_MOKOOG="MokoOpenGraph"
+COM_MOKOOG="MokoJoomOpenGraph"
 COM_MOKOOG_DESCRIPTION="Manage Open Graph and social sharing tags for all your content. View, edit, and batch-process OG metadata."

src/packages/com_mokoog/language/en-GB/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/language/en-US/com_mokoog.ini

@@ -1,9 +1,9 @@
-; MokoOpenGraph - Component Language File
+; MokoJoomOpenGraph - Component Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-COM_MOKOOG="MokoOpenGraph"
-COM_MOKOOG_TAGS_TITLE="MokoOpenGraph - Tag Manager"
+COM_MOKOOG="MokoJoomOpenGraph"
+COM_MOKOOG_TAGS_TITLE="MokoJoomOpenGraph - Tag Manager"
 COM_MOKOOG_SUBMENU_TAGS="Tags"
 COM_MOKOOG_NO_TAGS="No Open Graph tags have been created yet. Tags are created automatically when you edit articles or menu items."
 COM_MOKOOG_TABLE_CAPTION="Table of Open Graph tags"
@@ -13,4 +13,47 @@ COM_MOKOOG_HEADING_CONTENT_TYPE="Content Type"
 COM_MOKOOG_HEADING_CONTENT_ID="Content ID"
 COM_MOKOOG_HEADING_OG_TITLE="OG Title"
 COM_MOKOOG_HEADING_IMAGE="Image"
+COM_MOKOOG_HEADING_SEO="SEO"
+COM_MOKOOG_HEADING_DEBUG="Debug"
 COM_MOKOOG_HEADING_MODIFIED="Modified"
+
+COM_MOKOOG_SEO_OK="OK"
+COM_MOKOOG_SEO_MISSING_DESC="No meta description"
+COM_MOKOOG_SEO_TITLE_LONG="SEO title too long"
+COM_MOKOOG_SEO_NOINDEX="noindex"
+
+COM_MOKOOG_FIELD_CONTENT_TYPE="Content Type"
+COM_MOKOOG_FIELD_CONTENT_ID="Content ID"
+COM_MOKOOG_FIELD_OG_TITLE="OG Title"
+COM_MOKOOG_FIELD_OG_TITLE_DESC="Custom title for social sharing."
+COM_MOKOOG_FIELD_OG_DESCRIPTION="OG Description"
+COM_MOKOOG_FIELD_OG_DESCRIPTION_DESC="Custom description for social sharing."
+COM_MOKOOG_FIELD_OG_IMAGE="OG Image"
+COM_MOKOOG_FIELD_OG_IMAGE_DESC="Custom image for social sharing."
+COM_MOKOOG_FIELD_OG_TYPE="OG Type"
+COM_MOKOOG_FIELD_OG_TYPE_DESC="The Open Graph content type."
+
+COM_MOKOOG_FILTER_SEARCH="Search OG titles"
+COM_MOKOOG_FILTER_CONTENT_TYPE="Content Type"
+COM_MOKOOG_FILTER_SELECT_TYPE="- Select Type -"
+COM_MOKOOG_HEADING_OG_TITLE_ASC="OG Title ascending"
+COM_MOKOOG_HEADING_OG_TITLE_DESC="OG Title descending"
+COM_MOKOOG_HEADING_MODIFIED_ASC="Modified ascending"
+COM_MOKOOG_HEADING_MODIFIED_DESC="Modified descending"
+
+COM_MOKOOG_TOOLBAR_BATCH_GENERATE="Batch Generate"
+COM_MOKOOG_BATCH_TITLE="Batch OG Tag Generation"
+COM_MOKOOG_BATCH_COUNTING="Counting articles without OG tags..."
+COM_MOKOOG_BATCH_NONE="All articles already have OG tags."
+COM_MOKOOG_BATCH_FOUND="articles found without OG tags."
+COM_MOKOOG_BATCH_PROCESSED="processed"
+COM_MOKOOG_BATCH_COMPLETE="Batch generation complete!"
+COM_MOKOOG_BATCH_ERROR="Error:"
+
+COM_MOKOOG_TOOLBAR_EXPORT="Export CSV"
+COM_MOKOOG_TOOLBAR_IMPORT="Import CSV"
+COM_MOKOOG_IMPORT_NO_FILE="No CSV file was uploaded."
+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."

src/packages/com_mokoog/language/en-US/com_mokoog.sys.ini

@@ -1,6 +1,6 @@
-; MokoOpenGraph - Component System Language File
+; MokoJoomOpenGraph - Component System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-COM_MOKOOG="MokoOpenGraph"
+COM_MOKOOG="MokoJoomOpenGraph"
 COM_MOKOOG_DESCRIPTION="Manage Open Graph and social sharing tags for all your content. View, edit, and batch-process OG metadata."

src/packages/com_mokoog/language/en-US/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/language/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/mokoog.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -8,7 +8,7 @@
  -->
 <extension type="component" method="upgrade">
     <name>com_mokoog</name>
-    <version>01.00.00</version>
+    <version>01.00.01-dev</version>
     <creationDate>2026-05-23</creationDate>
     <author>Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -42,6 +42,7 @@
             <filename>provider.php</filename>
         </files>
         <files folder="src">
+            <folder>ContentType</folder>
             <folder>Controller</folder>
             <folder>Extension</folder>
             <folder>Model</folder>
@@ -68,4 +69,10 @@
             <menu link="option=com_mokoog&amp;view=tags">COM_MOKOOG_SUBMENU_TAGS</menu>
         </submenu>
     </administration>
+
+    <api>
+        <files folder="api">
+            <folder>src</folder>
+        </files>
+    </api>
 </extension>

src/packages/com_mokoog/script.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -23,7 +23,7 @@ class Com_MokoOGInstallerScript
      */
     public function install(InstallerAdapter $parent): void
     {
-        echo '<p>MokoOpenGraph component installed successfully.</p>';
+        echo '<p>MokoJoomOpenGraph component installed successfully.</p>';
     }
 
     /**
@@ -35,6 +35,6 @@ class Com_MokoOGInstallerScript
      */
     public function update(InstallerAdapter $parent): void
     {
-        echo '<p>MokoOpenGraph component updated successfully.</p>';
+        echo '<p>MokoJoomOpenGraph component updated successfully.</p>';
     }
 }

src/packages/com_mokoog/services/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/services/provider.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/sql/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/sql/install.mysql.sql

@@ -1,5 +1,5 @@
 --
--- MokoOpenGraph - Database Schema
+-- MokoJoomOpenGraph - Database Schema
 -- Copyright (C) 2026 Moko Consulting. All rights reserved.
 -- License: GPL-3.0-or-later
 --
@@ -12,10 +12,15 @@ CREATE TABLE IF NOT EXISTS `#__mokoog_tags` (
     `og_description` TEXT NOT NULL,
     `og_image`       VARCHAR(512) NOT NULL DEFAULT '',
     `og_type`        VARCHAR(50) NOT NULL DEFAULT 'article',
+    `seo_title`      VARCHAR(70) NOT NULL DEFAULT '',
+    `meta_description` VARCHAR(200) NOT NULL DEFAULT '',
+    `robots`         VARCHAR(100) NOT NULL DEFAULT '',
+    `canonical_url`  VARCHAR(512) NOT NULL DEFAULT '',
+    `language`       CHAR(7) NOT NULL DEFAULT '*',
     `published`      TINYINT(1) NOT NULL DEFAULT 1,
     `created`        DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
     `modified`       DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
     PRIMARY KEY (`id`),
-    UNIQUE KEY `idx_content` (`content_type`, `content_id`),
+    UNIQUE KEY `idx_content_lang` (`content_type`, `content_id`, `language`),
     KEY `idx_published` (`published`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

src/packages/com_mokoog/sql/uninstall.mysql.sql

@@ -1,5 +1,5 @@
 --
--- MokoOpenGraph - Uninstall
+-- MokoJoomOpenGraph - Uninstall
 --
 
 DROP TABLE IF EXISTS `#__mokoog_tags`;

src/packages/com_mokoog/sql/updates/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/sql/updates/mysql/01.01.00.sql

@@ -0,0 +1,9 @@
+--
+-- MokoJoomOpenGraph 01.01.00 — Add SEO meta management columns
+--
+
+ALTER TABLE `#__mokoog_tags`
+    ADD COLUMN `seo_title` VARCHAR(70) NOT NULL DEFAULT '' AFTER `og_type`,
+    ADD COLUMN `meta_description` VARCHAR(200) NOT NULL DEFAULT '' AFTER `seo_title`,
+    ADD COLUMN `robots` VARCHAR(100) NOT NULL DEFAULT '' AFTER `meta_description`,
+    ADD COLUMN `canonical_url` VARCHAR(512) NOT NULL DEFAULT '' AFTER `robots`;

src/packages/com_mokoog/sql/updates/mysql/01.02.00.sql

@@ -0,0 +1,10 @@
+--
+-- MokoJoomOpenGraph 01.02.00 — Add multilingual OG tag support
+--
+
+ALTER TABLE `#__mokoog_tags`
+    ADD COLUMN `language` CHAR(7) NOT NULL DEFAULT '*' AFTER `canonical_url`;
+
+ALTER TABLE `#__mokoog_tags`
+    DROP INDEX `idx_content`,
+    ADD UNIQUE KEY `idx_content_lang` (`content_type`, `content_id`, `language`);

src/packages/com_mokoog/sql/updates/mysql/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/ContentType/ContentTypeInterface.php

@@ -0,0 +1,60 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\ContentType;
+
+defined('_JEXEC') or die;
+
+interface ContentTypeInterface
+{
+    /**
+     * Check if this adapter can handle the given component/view.
+     *
+     * @param   string  $option  Component option (e.g. com_virtuemart)
+     * @param   string  $view    View name (e.g. productdetails)
+     *
+     * @return  bool
+     */
+    public function canHandle(string $option, string $view): bool;
+
+    /**
+     * Get the content type identifier for database storage.
+     *
+     * @return  string
+     */
+    public function getContentType(): string;
+
+    /**
+     * Get the title for the content item.
+     *
+     * @param   int  $id  Content item ID
+     *
+     * @return  string
+     */
+    public function getTitle(int $id): string;
+
+    /**
+     * Get a description for the content item.
+     *
+     * @param   int  $id  Content item ID
+     *
+     * @return  string
+     */
+    public function getDescription(int $id): string;
+
+    /**
+     * Get the primary image for the content item.
+     *
+     * @param   int  $id  Content item ID
+     *
+     * @return  string  Image path relative to JPATH_ROOT, or empty string
+     */
+    public function getImage(int $id): string;
+}

src/packages/com_mokoog/src/ContentType/HikaShopAdapter.php

@@ -0,0 +1,76 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\ContentType;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+
+class HikaShopAdapter implements ContentTypeInterface
+{
+    public function canHandle(string $option, string $view): bool
+    {
+        return $option === 'com_hikashop' && $view === 'product';
+    }
+
+    public function getContentType(): string
+    {
+        return 'com_hikashop';
+    }
+
+    public function getTitle(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('product_name'))
+            ->from($db->quoteName('#__hikashop_product'))
+            ->where($db->quoteName('product_id') . ' = ' . $id);
+
+        $db->setQuery($query);
+
+        return $db->loadResult() ?: '';
+    }
+
+    public function getDescription(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('product_description'))
+            ->from($db->quoteName('#__hikashop_product'))
+            ->where($db->quoteName('product_id') . ' = ' . $id);
+
+        $db->setQuery($query);
+        $text = $db->loadResult() ?: '';
+        $text = strip_tags($text);
+        $text = trim(preg_replace('/\s+/', ' ', $text));
+
+        if (\strlen($text) > 160) {
+            $text = mb_substr($text, 0, 157) . '...';
+        }
+
+        return $text;
+    }
+
+    public function getImage(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('f.file_path'))
+            ->from($db->quoteName('#__hikashop_file', 'f'))
+            ->where($db->quoteName('f.file_ref_id') . ' = ' . $id)
+            ->where($db->quoteName('f.file_type') . ' = ' . $db->quote('product'))
+            ->order($db->quoteName('f.file_ordering') . ' ASC');
+
+        $db->setQuery($query, 0, 1);
+
+        return $db->loadResult() ?: '';
+    }
+}

src/packages/com_mokoog/src/ContentType/K2Adapter.php

@@ -0,0 +1,73 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\ContentType;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+
+class K2Adapter implements ContentTypeInterface
+{
+    public function canHandle(string $option, string $view): bool
+    {
+        return $option === 'com_k2' && $view === 'item';
+    }
+
+    public function getContentType(): string
+    {
+        return 'com_k2';
+    }
+
+    public function getTitle(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('title'))
+            ->from($db->quoteName('#__k2_items'))
+            ->where($db->quoteName('id') . ' = ' . $id);
+
+        $db->setQuery($query);
+
+        return $db->loadResult() ?: '';
+    }
+
+    public function getDescription(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('introtext'))
+            ->from($db->quoteName('#__k2_items'))
+            ->where($db->quoteName('id') . ' = ' . $id);
+
+        $db->setQuery($query);
+        $text = $db->loadResult() ?: '';
+        $text = strip_tags($text);
+        $text = trim(preg_replace('/\s+/', ' ', $text));
+
+        if (\strlen($text) > 160) {
+            $text = mb_substr($text, 0, 157) . '...';
+        }
+
+        return $text;
+    }
+
+    public function getImage(int $id): string
+    {
+        // K2 stores images as media/k2/items/cache/{md5}_L.jpg
+        $imagePath = 'media/k2/items/cache/' . md5('Image' . $id) . '_L.jpg';
+
+        if (is_file(JPATH_ROOT . '/' . $imagePath)) {
+            return $imagePath;
+        }
+
+        return '';
+    }
+}

src/packages/com_mokoog/src/ContentType/VirtueMartAdapter.php

@@ -0,0 +1,82 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\ContentType;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+
+class VirtueMartAdapter implements ContentTypeInterface
+{
+    public function canHandle(string $option, string $view): bool
+    {
+        return $option === 'com_virtuemart' && $view === 'productdetails';
+    }
+
+    public function getContentType(): string
+    {
+        return 'com_virtuemart';
+    }
+
+    public function getTitle(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('product_name'))
+            ->from($db->quoteName('#__virtuemart_products_' . $this->getLangTag()))
+            ->where($db->quoteName('virtuemart_product_id') . ' = ' . $id);
+
+        $db->setQuery($query);
+
+        return $db->loadResult() ?: '';
+    }
+
+    public function getDescription(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('product_s_desc'))
+            ->from($db->quoteName('#__virtuemart_products_' . $this->getLangTag()))
+            ->where($db->quoteName('virtuemart_product_id') . ' = ' . $id);
+
+        $db->setQuery($query);
+        $desc = $db->loadResult() ?: '';
+
+        return strip_tags($desc);
+    }
+
+    public function getImage(int $id): string
+    {
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName('m.file_url'))
+            ->from($db->quoteName('#__virtuemart_product_medias', 'pm'))
+            ->join('INNER', $db->quoteName('#__virtuemart_medias', 'm') . ' ON ' . $db->quoteName('m.virtuemart_media_id') . ' = ' . $db->quoteName('pm.virtuemart_media_id'))
+            ->where($db->quoteName('pm.virtuemart_product_id') . ' = ' . $id)
+            ->order($db->quoteName('pm.ordering') . ' ASC');
+
+        $db->setQuery($query, 0, 1);
+
+        return $db->loadResult() ?: '';
+    }
+
+    /**
+     * Get the VirtueMart language table suffix.
+     *
+     * @return  string
+     */
+    private function getLangTag(): string
+    {
+        $lang = Factory::getLanguage()->getTag();
+
+        return strtolower(str_replace('-', '_', $lang));
+    }
+}

src/packages/com_mokoog/src/ContentType/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Controller/BatchController.php

@@ -0,0 +1,177 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\Controller;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\MVC\Controller\BaseController;
+use Joomla\CMS\Response\JsonResponse;
+use Joomla\CMS\Session\Session;
+
+class BatchController extends BaseController
+{
+    /**
+     * Count the total articles eligible for batch generation.
+     *
+     * @return  void
+     */
+    public function count(): void
+    {
+        Session::checkToken('get') || jexit(Text::_('JINVALID_TOKEN'));
+
+        if (!Factory::getApplication()->getIdentity()->authorise('core.create', 'com_mokoog')) {
+            throw new \RuntimeException(Text::_('JLIB_APPLICATION_ERROR_ACCESS_FORBIDDEN'), 403);
+        }
+
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select('COUNT(*)')
+            ->from($db->quoteName('#__content', 'c'))
+            ->leftJoin(
+                $db->quoteName('#__mokoog_tags', 't')
+                . ' ON ' . $db->quoteName('t.content_type') . ' = ' . $db->quote('com_content')
+                . ' AND ' . $db->quoteName('t.content_id') . ' = ' . $db->quoteName('c.id')
+            )
+            ->where($db->quoteName('c.state') . ' = 1')
+            ->where($db->quoteName('t.id') . ' IS NULL');
+
+        $db->setQuery($query);
+        $total = (int) $db->loadResult();
+
+        echo new JsonResponse(['total' => $total]);
+
+        Factory::getApplication()->close();
+    }
+
+    /**
+     * Process a chunk of articles for batch OG generation.
+     *
+     * @return  void
+     */
+    public function process(): void
+    {
+        Session::checkToken('get') || jexit(Text::_('JINVALID_TOKEN'));
+
+        if (!Factory::getApplication()->getIdentity()->authorise('core.create', 'com_mokoog')) {
+            throw new \RuntimeException(Text::_('JLIB_APPLICATION_ERROR_ACCESS_FORBIDDEN'), 403);
+        }
+
+        $app    = Factory::getApplication();
+        $offset = $app->getInput()->getInt('offset', 0);
+        $limit  = $app->getInput()->getInt('limit', 50);
+
+        $db    = Factory::getDbo();
+        $query = $db->getQuery(true)
+            ->select($db->quoteName([
+                'c.id', 'c.title', 'c.metadesc', 'c.introtext', 'c.fulltext', 'c.images',
+            ]))
+            ->from($db->quoteName('#__content', 'c'))
+            ->leftJoin(
+                $db->quoteName('#__mokoog_tags', 't')
+                . ' ON ' . $db->quoteName('t.content_type') . ' = ' . $db->quote('com_content')
+                . ' AND ' . $db->quoteName('t.content_id') . ' = ' . $db->quoteName('c.id')
+            )
+            ->where($db->quoteName('c.state') . ' = 1')
+            ->where($db->quoteName('t.id') . ' IS NULL')
+            ->order($db->quoteName('c.id') . ' ASC');
+
+        $db->setQuery($query, $offset, $limit);
+        $articles = $db->loadObjectList();
+
+        $created = 0;
+        $now     = Factory::getDate()->toSql();
+
+        foreach ($articles as $article) {
+            $ogTitle       = $article->title;
+            $ogDescription = $this->extractDescription($article);
+            $ogImage       = $this->extractImage($article);
+
+            $record = (object) [
+                'content_type'   => 'com_content',
+                'content_id'     => (int) $article->id,
+                'og_title'       => $ogTitle,
+                'og_description' => $ogDescription,
+                'og_image'       => $ogImage,
+                'og_type'        => 'article',
+                'seo_title'      => '',
+                'meta_description' => $article->metadesc ?: '',
+                'robots'         => '',
+                'canonical_url'  => '',
+                'published'      => 1,
+                'created'        => $now,
+                'modified'       => $now,
+            ];
+
+            $db->insertObject('#__mokoog_tags', $record);
+            $created++;
+        }
+
+        echo new JsonResponse([
+            'created'   => $created,
+            'offset'    => $offset,
+            'processed' => $offset + $created,
+        ]);
+
+        $app->close();
+    }
+
+    /**
+     * Extract a description from article content.
+     *
+     * @param   object  $article  Article record
+     *
+     * @return  string
+     */
+    private function extractDescription(object $article): string
+    {
+        // Prefer meta description if set
+        if (!empty($article->metadesc)) {
+            return $article->metadesc;
+        }
+
+        // Fall back to intro text
+        $text = $article->introtext ?: $article->fulltext;
+        $text = strip_tags($text);
+        $text = trim(preg_replace('/\s+/', ' ', $text));
+
+        if (\strlen($text) > 160) {
+            $text = mb_substr($text, 0, 157) . '...';
+        }
+
+        return $text;
+    }
+
+    /**
+     * Extract the best image from article data.
+     *
+     * @param   object  $article  Article record
+     *
+     * @return  string
+     */
+    private function extractImage(object $article): string
+    {
+        if (!empty($article->images)) {
+            $images = json_decode($article->images, true);
+
+            if (!empty($images['image_fulltext'])) {
+                return $images['image_fulltext'];
+            }
+
+            if (!empty($images['image_intro'])) {
+                return $images['image_intro'];
+            }
+        }
+
+        return '';
+    }
+}

src/packages/com_mokoog/src/Controller/DisplayController.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/src/Controller/ImportExportController.php

@@ -0,0 +1,245 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\Controller;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\MVC\Controller\BaseController;
+use Joomla\CMS\Session\Session;
+
+class ImportExportController extends BaseController
+{
+    /**
+     * Maximum upload file size in bytes (2 MB).
+     */
+    private const MAX_FILE_SIZE = 2 * 1024 * 1024;
+
+    /**
+     * Allowed content_type patterns for import.
+     */
+    private const CONTENT_TYPE_PATTERN = '/^[a-z][a-z0-9_.]*$/';
+
+    /**
+     * Export all OG tags as CSV.
+     *
+     * @return  void
+     */
+    public function export(): void
+    {
+        Session::checkToken('get') || jexit(Text::_('JINVALID_TOKEN'));
+
+        if (!Factory::getApplication()->getIdentity()->authorise('core.manage', 'com_mokoog')) {
+            throw new \RuntimeException(Text::_('JLIB_APPLICATION_ERROR_ACCESS_FORBIDDEN'), 403);
+        }
+
+        $app = Factory::getApplication();
+        $db  = Factory::getDbo();
+
+        // Join with #__content to get article titles for reference
+        $query = $db->getQuery(true)
+            ->select([
+                $db->quoteName('t.content_type'),
+                $db->quoteName('t.content_id'),
+                'COALESCE(' . $db->quoteName('c.title') . ', ' . $db->quote('') . ') AS ' . $db->quoteName('article_title'),
+                $db->quoteName('t.og_title'),
+                $db->quoteName('t.og_description'),
+                $db->quoteName('t.og_image'),
+                $db->quoteName('t.og_type'),
+                $db->quoteName('t.seo_title'),
+                $db->quoteName('t.meta_description'),
+                $db->quoteName('t.robots'),
+                $db->quoteName('t.canonical_url'),
+            ])
+            ->from($db->quoteName('#__mokoog_tags', 't'))
+            ->leftJoin(
+                $db->quoteName('#__content', 'c')
+                . ' ON ' . $db->quoteName('t.content_type') . ' = ' . $db->quote('com_content')
+                . ' AND ' . $db->quoteName('t.content_id') . ' = ' . $db->quoteName('c.id')
+            )
+            ->order($db->quoteName('t.content_type') . ', ' . $db->quoteName('t.content_id'));
+
+        $db->setQuery($query);
+        $rows = $db->loadAssocList();
+
+        // Send CSV headers
+        $app->setHeader('Content-Type', 'text/csv; charset=utf-8');
+        $app->setHeader('Content-Disposition', 'attachment; filename="mokoog_tags_export.csv"');
+        $app->sendHeaders();
+
+        $output = fopen('php://output', 'w');
+
+        // Header row
+        fputcsv($output, [
+            'content_type', 'content_id', 'article_title',
+            'og_title', 'og_description', 'og_image', 'og_type',
+            'seo_title', 'meta_description', 'robots', 'canonical_url',
+        ]);
+
+        foreach ($rows as $row) {
+            fputcsv($output, $row);
+        }
+
+        fclose($output);
+        $app->close();
+    }
+
+    /**
+     * Import OG tags from uploaded CSV.
+     *
+     * @return  void
+     */
+    public function import(): void
+    {
+        Session::checkToken() || jexit(Text::_('JINVALID_TOKEN'));
+
+        $identity = Factory::getApplication()->getIdentity();
+
+        if (!$identity->authorise('core.create', 'com_mokoog') || !$identity->authorise('core.edit', 'com_mokoog')) {
+            throw new \RuntimeException(Text::_('JLIB_APPLICATION_ERROR_ACCESS_FORBIDDEN'), 403);
+        }
+
+        $app   = Factory::getApplication();
+        $input = $app->getInput();
+        $files = $input->files->get('jform', [], 'array');
+
+        if (empty($files['csv_file']['tmp_name'])) {
+            $app->enqueueMessage(Text::_('COM_MOKOOG_IMPORT_NO_FILE'), 'error');
+            $app->redirect('index.php?option=com_mokoog&view=tags');
+
+            return;
+        }
+
+        $csvFile = $files['csv_file'];
+
+        // Validate file extension
+        $ext = strtolower(pathinfo($csvFile['name'] ?? '', PATHINFO_EXTENSION));
+
+        if ($ext !== 'csv') {
+            $app->enqueueMessage(Text::_('COM_MOKOOG_IMPORT_INVALID_TYPE'), 'error');
+            $app->redirect('index.php?option=com_mokoog&view=tags');
+
+            return;
+        }
+
+        // Validate MIME type
+        $allowedMimes = ['text/csv', 'text/plain', 'application/csv', 'application/vnd.ms-excel'];
+
+        if (!empty($csvFile['type']) && !\in_array($csvFile['type'], $allowedMimes, true)) {
+            $app->enqueueMessage(Text::_('COM_MOKOOG_IMPORT_INVALID_TYPE'), 'error');
+            $app->redirect('index.php?option=com_mokoog&view=tags');
+
+            return;
+        }
+
+        // Validate file size
+        if (($csvFile['size'] ?? 0) > self::MAX_FILE_SIZE) {
+            $app->enqueueMessage(Text::sprintf('COM_MOKOOG_IMPORT_FILE_TOO_LARGE', '2 MB'), 'error');
+            $app->redirect('index.php?option=com_mokoog&view=tags');
+
+            return;
+        }
+
+        $tmpFile = $csvFile['tmp_name'];
+        $handle  = fopen($tmpFile, 'r');
+
+        if (!$handle) {
+            $app->enqueueMessage(Text::_('COM_MOKOOG_IMPORT_READ_ERROR'), 'error');
+            $app->redirect('index.php?option=com_mokoog&view=tags');
+
+            return;
+        }
+
+        $db      = Factory::getDbo();
+        $header  = fgetcsv($handle);
+        $created = 0;
+        $updated = 0;
+        $skipped = 0;
+        $now     = Factory::getDate()->toSql();
+
+        while (($row = fgetcsv($handle)) !== false) {
+            if (\count($row) < 7) {
+                $skipped++;
+
+                continue;
+            }
+
+            $contentType = trim($row[0]);
+            $contentId   = (int) $row[1];
+            // $row[2] = article_title (informational, skip)
+            $ogTitle       = trim($row[3] ?? '');
+            $ogDescription = trim($row[4] ?? '');
+            $ogImage       = trim($row[5] ?? '');
+            $ogType        = trim($row[6] ?? 'article');
+            $seoTitle      = trim($row[7] ?? '');
+            $metaDesc      = trim($row[8] ?? '');
+            $robots        = trim($row[9] ?? '');
+            $canonicalUrl  = trim($row[10] ?? '');
+
+            if (empty($contentType) || $contentId <= 0) {
+                $skipped++;
+
+                continue;
+            }
+
+            // Validate content_type against allowed pattern
+            if (!preg_match(self::CONTENT_TYPE_PATTERN, $contentType)) {
+                $skipped++;
+
+                continue;
+            }
+
+            // Check for existing record
+            $query = $db->getQuery(true)
+                ->select($db->quoteName('id'))
+                ->from($db->quoteName('#__mokoog_tags'))
+                ->where($db->quoteName('content_type') . ' = ' . $db->quote($contentType))
+                ->where($db->quoteName('content_id') . ' = ' . $contentId);
+
+            $db->setQuery($query);
+            $existingId = $db->loadResult();
+
+            $record = (object) [
+                'content_type'     => $contentType,
+                'content_id'       => $contentId,
+                'og_title'         => $ogTitle,
+                'og_description'   => $ogDescription,
+                'og_image'         => $ogImage,
+                'og_type'          => $ogType,
+                'seo_title'        => $seoTitle,
+                'meta_description' => $metaDesc,
+                'robots'           => $robots,
+                'canonical_url'    => $canonicalUrl,
+                'published'        => 1,
+                'modified'         => $now,
+            ];
+
+            if ($existingId) {
+                $record->id = $existingId;
+                $db->updateObject('#__mokoog_tags', $record, 'id');
+                $updated++;
+            } else {
+                $record->created = $now;
+                $db->insertObject('#__mokoog_tags', $record);
+                $created++;
+            }
+        }
+
+        fclose($handle);
+
+        $app->enqueueMessage(
+            Text::sprintf('COM_MOKOOG_IMPORT_RESULT', $created, $updated, $skipped),
+            'success'
+        );
+        $app->redirect('index.php?option=com_mokoog&view=tags');
+    }
+}

src/packages/com_mokoog/src/Controller/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Extension/MokoOGComponent.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/src/Extension/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Field/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Model/TagModel.php

@@ -0,0 +1,68 @@
+<?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
+ */
+
+namespace Joomla\Component\MokoOG\Administrator\Model;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\Model\AdminModel;
+
+class TagModel extends AdminModel
+{
+    /**
+     * Get the form for the item.
+     *
+     * @param   array  $data      Form data
+     * @param   bool   $loadData  Load data from state
+     *
+     * @return  \Joomla\CMS\Form\Form|false
+     */
+    public function getForm($data = [], $loadData = true)
+    {
+        $form = $this->loadForm(
+            'com_mokoog.tag',
+            'tag',
+            ['control' => 'jform', 'load_data' => $loadData]
+        );
+
+        return $form ?: false;
+    }
+
+    /**
+     * Load the form data.
+     *
+     * @return  object
+     */
+    protected function loadFormData(): object
+    {
+        $data = Factory::getApplication()->getUserState('com_mokoog.edit.tag.data', []);
+
+        if (empty($data)) {
+            $data = $this->getItem();
+        }
+
+        return $data;
+    }
+
+    /**
+     * Get the table class name.
+     *
+     * @param   string  $name    Table name
+     * @param   string  $prefix  Table prefix
+     * @param   array   $options Table options
+     *
+     * @return  \Joomla\CMS\Table\Table
+     */
+    public function getTable($name = 'Tag', $prefix = 'Administrator', $options = [])
+    {
+        return parent::getTable($name, $prefix, $options);
+    }
+}

src/packages/com_mokoog/src/Model/TagsModel.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/src/Model/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Service/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/Table/TagTable.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.

src/packages/com_mokoog/src/Table/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/View/Tags/HtmlView.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -39,6 +39,20 @@ class HtmlView extends BaseHtmlView
      */
     protected $state;
 
+    /**
+     * The filter form.
+     *
+     * @var \Joomla\CMS\Form\Form|null
+     */
+    public $filterForm;
+
+    /**
+     * The active filters.
+     *
+     * @var array
+     */
+    public $activeFilters = [];
+
     /**
      * Display the view.
      *
@@ -48,9 +62,11 @@ class HtmlView extends BaseHtmlView
      */
     public function display($tpl = null): void
     {
-        $this->items      = $this->get('Items');
-        $this->pagination = $this->get('Pagination');
-        $this->state      = $this->get('State');
+        $this->items         = $this->get('Items');
+        $this->pagination    = $this->get('Pagination');
+        $this->state         = $this->get('State');
+        $this->filterForm    = $this->get('FilterForm');
+        $this->activeFilters = $this->get('ActiveFilters');
 
         $this->addToolbar();
 
@@ -65,6 +81,8 @@ class HtmlView extends BaseHtmlView
     protected function addToolbar(): void
     {
         ToolbarHelper::title(Text::_('COM_MOKOOG_TAGS_TITLE'), 'bookmark');
+        ToolbarHelper::custom('batch.generate', 'refresh', '', 'COM_MOKOOG_TOOLBAR_BATCH_GENERATE', false);
+        ToolbarHelper::custom('importexport.export', 'download', '', 'COM_MOKOOG_TOOLBAR_EXPORT', false);
         ToolbarHelper::deleteList('JGLOBAL_CONFIRM_DELETE', 'tags.delete');
         ToolbarHelper::preferences('com_mokoog');
     }

src/packages/com_mokoog/src/View/Tags/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/View/Tags/tmpl/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/View/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/src/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/tmpl/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/com_mokoog/tmpl/tags/default.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  com_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -14,14 +14,18 @@ use Joomla\CMS\HTML\HTMLHelper;
 use Joomla\CMS\Language\Text;
 use Joomla\CMS\Layout\LayoutHelper;
 use Joomla\CMS\Router\Route;
+use Joomla\CMS\Uri\Uri;
+use Joomla\CMS\Session\Session;
 
 /** @var \Joomla\Component\MokoOG\Administrator\View\Tags\HtmlView $this */
 
+$token = Session::getFormToken();
 ?>
 <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">
             <div id="j-main-container" class="j-main-container">
+                <?php echo LayoutHelper::render('joomla.searchtools.default', ['view' => $this]); ?>
 
                 <?php if (empty($this->items)) : ?>
                     <div class="alert alert-info">
@@ -50,9 +54,15 @@ use Joomla\CMS\Router\Route;
                                 <th scope="col" class="w-10">
                                     <?php echo Text::_('COM_MOKOOG_HEADING_IMAGE'); ?>
                                 </th>
+                                <th scope="col" class="w-10">
+                                    <?php echo Text::_('COM_MOKOOG_HEADING_SEO'); ?>
+                                </th>
                                 <th scope="col" class="w-10">
                                     <?php echo Text::_('JSTATUS'); ?>
                                 </th>
+                                <th scope="col" class="w-10">
+                                    <?php echo Text::_('COM_MOKOOG_HEADING_DEBUG'); ?>
+                                </th>
                                 <th scope="col" class="w-10">
                                     <?php echo Text::_('COM_MOKOOG_HEADING_MODIFIED'); ?>
                                 </th>
@@ -83,9 +93,50 @@ use Joomla\CMS\Router\Route;
                                             <span class="icon-minus-circle text-muted" aria-hidden="true"></span>
                                         <?php endif; ?>
                                     </td>
+                                    <td>
+                                        <?php
+                                        $seoIssues = [];
+
+                                        if (empty($item->meta_description)) {
+                                            $seoIssues[] = Text::_('COM_MOKOOG_SEO_MISSING_DESC');
+                                        }
+
+                                        if (!empty($item->seo_title) && \strlen($item->seo_title) > 60) {
+                                            $seoIssues[] = Text::_('COM_MOKOOG_SEO_TITLE_LONG');
+                                        }
+
+                                        if (!empty($item->robots) && str_contains($item->robots, 'noindex')) {
+                                            $seoIssues[] = Text::_('COM_MOKOOG_SEO_NOINDEX');
+                                        }
+
+                                        if (empty($seoIssues)) : ?>
+                                            <span class="badge bg-success"><?php echo Text::_('COM_MOKOOG_SEO_OK'); ?></span>
+                                        <?php else : ?>
+                                            <?php foreach ($seoIssues as $issue) : ?>
+                                                <span class="badge bg-warning text-dark"><?php echo $issue; ?></span>
+                                            <?php endforeach; ?>
+                                        <?php endif; ?>
+                                    </td>
                                     <td>
                                         <?php echo $item->published ? Text::_('JPUBLISHED') : Text::_('JUNPUBLISHED'); ?>
                                     </td>
+                                    <td class="mokoog-debug-links">
+                                        <?php
+                                        // Build frontend URL for this content item
+                                        if ($item->content_type === 'com_content') {
+                                            $debugUrl = Uri::root() . 'index.php?option=com_content&view=article&id=' . (int) $item->content_id;
+                                        } elseif ($item->content_type === 'menu') {
+                                            $debugUrl = Uri::root() . 'index.php?Itemid=' . (int) $item->content_id;
+                                        } elseif ($item->content_type === 'com_content.category') {
+                                            $debugUrl = Uri::root() . 'index.php?option=com_content&view=category&id=' . (int) $item->content_id;
+                                        } else {
+                                            $debugUrl = Uri::root();
+                                        }
+                                        ?>
+                                        <a href="https://developers.facebook.com/tools/debug/?q=<?php echo urlencode($debugUrl); ?>" target="_blank" rel="noopener" title="Facebook Debugger" class="btn btn-sm btn-outline-primary">FB</a>
+                                        <a href="https://www.linkedin.com/post-inspector/inspect/<?php echo urlencode($debugUrl); ?>" target="_blank" rel="noopener" title="LinkedIn Inspector" class="btn btn-sm btn-outline-info">LI</a>
+                                        <a href="https://search.google.com/test/rich-results?url=<?php echo urlencode($debugUrl); ?>" target="_blank" rel="noopener" title="Google Rich Results" class="btn btn-sm btn-outline-success">G</a>
+                                    </td>
                                     <td>
                                         <?php echo HTMLHelper::_('date', $item->modified, Text::_('DATE_FORMAT_LC4')); ?>
                                     </td>
@@ -107,3 +158,85 @@ use Joomla\CMS\Router\Route;
         </div>
     </div>
 </form>
+
+<!-- Batch Generation Progress -->
+<div id="mokoog-batch-panel" style="display:none;" class="card mt-3">
+    <div class="card-body">
+        <h4><?php echo Text::_('COM_MOKOOG_BATCH_TITLE'); ?></h4>
+        <div class="progress mb-2">
+            <div id="mokoog-batch-bar" class="progress-bar progress-bar-striped progress-bar-animated" role="progressbar" style="width: 0%">0%</div>
+        </div>
+        <p id="mokoog-batch-status"></p>
+    </div>
+</div>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    // Intercept the batch.generate toolbar button
+    var origSubmitbutton = Joomla.submitbutton;
+    Joomla.submitbutton = function(task) {
+        if (task === 'batch.generate') {
+            mokoogBatchGenerate();
+            return;
+        }
+        if (origSubmitbutton) {
+            origSubmitbutton(task);
+        }
+    };
+
+    function mokoogBatchGenerate() {
+        var panel = document.getElementById('mokoog-batch-panel');
+        var bar = document.getElementById('mokoog-batch-bar');
+        var status = document.getElementById('mokoog-batch-status');
+        var token = '<?php echo $token; ?>';
+        var chunkSize = 50;
+
+        panel.style.display = 'block';
+        status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_COUNTING', true); ?>';
+
+        // Step 1: Count eligible articles
+        fetch('index.php?option=com_mokoog&task=batch.count&format=json&' + token + '=1')
+            .then(function(r) { return r.json(); })
+            .then(function(resp) {
+                var total = resp.data.total;
+                if (total === 0) {
+                    bar.style.width = '100%';
+                    bar.textContent = '100%';
+                    bar.classList.remove('progress-bar-animated');
+                    bar.classList.add('bg-success');
+                    status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_NONE', true); ?>';
+                    return;
+                }
+                status.textContent = total + ' <?php echo Text::_('COM_MOKOOG_BATCH_FOUND', true); ?>';
+                processChunk(0, total, chunkSize, token, bar, status);
+            })
+            .catch(function(err) {
+                status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_ERROR', true); ?> ' + err.message;
+            });
+    }
+
+    function processChunk(offset, total, chunkSize, token, bar, status) {
+        fetch('index.php?option=com_mokoog&task=batch.process&format=json&offset=' + offset + '&limit=' + chunkSize + '&' + token + '=1')
+            .then(function(r) { return r.json(); })
+            .then(function(resp) {
+                var processed = resp.data.processed;
+                var pct = Math.min(100, Math.round((processed / total) * 100));
+                bar.style.width = pct + '%';
+                bar.textContent = pct + '%';
+                status.textContent = processed + ' / ' + total + ' <?php echo Text::_('COM_MOKOOG_BATCH_PROCESSED', true); ?>';
+
+                if (processed < total) {
+                    processChunk(processed, total, chunkSize, token, bar, status);
+                } else {
+                    bar.classList.remove('progress-bar-animated');
+                    bar.classList.add('bg-success');
+                    status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_COMPLETE', true); ?> ' + total + ' articles.';
+                    setTimeout(function() { location.reload(); }, 2000);
+                }
+            })
+            .catch(function(err) {
+                status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_ERROR', true); ?> ' + err.message;
+            });
+    }
+});
+</script>

src/packages/com_mokoog/tmpl/tags/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/forms/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/forms/mokoog.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
- * @package     MokoOpenGraph
+ * @package     MokoJoomOpenGraph
  * @subpackage  plg_content_mokoog
  * @author      Moko Consulting <hello@mokoconsulting.tech>
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
@@ -50,5 +50,48 @@
                 <option value="video.other">Video</option>
             </field>
         </fieldset>
+        <fieldset name="mokoog_seo" label="PLG_CONTENT_MOKOOG_FIELDSET_SEO_LABEL"
+                  description="PLG_CONTENT_MOKOOG_FIELDSET_SEO_DESC">
+            <field
+                name="seo_title"
+                type="text"
+                label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
+                description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
+                filter="string"
+                maxlength="70"
+            />
+            <field
+                name="meta_description"
+                type="textarea"
+                label="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION"
+                description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
+                filter="string"
+                rows="3"
+                maxlength="200"
+            />
+            <field
+                name="robots"
+                type="list"
+                label="PLG_CONTENT_MOKOOG_FIELD_ROBOTS"
+                description="PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC"
+                default=""
+                multiple="true"
+            >
+                <option value="">PLG_CONTENT_MOKOOG_ROBOTS_DEFAULT</option>
+                <option value="noindex">noindex</option>
+                <option value="nofollow">nofollow</option>
+                <option value="nosnippet">nosnippet</option>
+                <option value="noarchive">noarchive</option>
+                <option value="noimageindex">noimageindex</option>
+            </field>
+            <field
+                name="canonical_url"
+                type="url"
+                label="PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL"
+                description="PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC"
+                filter="url"
+                validate="url"
+            />
+        </fieldset>
     </fields>
 </form>

src/packages/plg_content_mokoog/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/language/en-GB/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/language/en-GB/plg_content_mokoog.ini

@@ -1,4 +1,4 @@
-; MokoOpenGraph - Content Plugin Language File
+; MokoJoomOpenGraph - Content Plugin Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
@@ -13,3 +13,16 @@ PLG_CONTENT_MOKOOG_FIELD_OG_IMAGE="OG Image"
 PLG_CONTENT_MOKOOG_FIELD_OG_IMAGE_DESC="Custom image for social sharing. Recommended: 1200x630px. Leave blank to use the article image."
 PLG_CONTENT_MOKOOG_FIELD_OG_TYPE="OG Type"
 PLG_CONTENT_MOKOOG_FIELD_OG_TYPE_DESC="The Open Graph content type for this page."
+
+PLG_CONTENT_MOKOOG_FIELDSET_SEO_LABEL="SEO Meta Tags"
+PLG_CONTENT_MOKOOG_FIELDSET_SEO_DESC="Control search engine meta tags for this page."
+
+PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE="SEO Title"
+PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC="Custom <title> tag. 50-60 characters recommended. Leave blank to use the default page title."
+PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION="Meta Description"
+PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC="Custom meta description. 150-160 characters recommended. Leave blank to use the default."
+PLG_CONTENT_MOKOOG_FIELD_ROBOTS="Robots Directive"
+PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this page. Leave blank for default (index, follow)."
+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."

src/packages/plg_content_mokoog/language/en-GB/plg_content_mokoog.sys.ini

@@ -1,6 +1,6 @@
-; MokoOpenGraph - Content Plugin System Language File
+; MokoJoomOpenGraph - Content Plugin System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-PLG_CONTENT_MOKOOG="Content - MokoOpenGraph"
+PLG_CONTENT_MOKOOG="Content - MokoJoomOpenGraph"
 PLG_CONTENT_MOKOOG_DESCRIPTION="Adds Open Graph fields to article and menu item edit forms for per-page social sharing control."

src/packages/plg_content_mokoog/language/en-US/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/language/en-US/plg_content_mokoog.ini

@@ -1,4 +1,4 @@
-; MokoOpenGraph - Content Plugin Language File
+; MokoJoomOpenGraph - Content Plugin Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
@@ -13,3 +13,16 @@ PLG_CONTENT_MOKOOG_FIELD_OG_IMAGE="OG Image"
 PLG_CONTENT_MOKOOG_FIELD_OG_IMAGE_DESC="Custom image for social sharing. Recommended: 1200x630px. Leave blank to use the article image."
 PLG_CONTENT_MOKOOG_FIELD_OG_TYPE="OG Type"
 PLG_CONTENT_MOKOOG_FIELD_OG_TYPE_DESC="The Open Graph content type for this page."
+
+PLG_CONTENT_MOKOOG_FIELDSET_SEO_LABEL="SEO Meta Tags"
+PLG_CONTENT_MOKOOG_FIELDSET_SEO_DESC="Control search engine meta tags for this page."
+
+PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE="SEO Title"
+PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC="Custom <title> tag. 50-60 characters recommended. Leave blank to use the default page title."
+PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION="Meta Description"
+PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC="Custom meta description. 150-160 characters recommended. Leave blank to use the default."
+PLG_CONTENT_MOKOOG_FIELD_ROBOTS="Robots Directive"
+PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this page. Leave blank for default (index, follow)."
+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."

src/packages/plg_content_mokoog/language/en-US/plg_content_mokoog.sys.ini

@@ -1,6 +1,6 @@
-; MokoOpenGraph - Content Plugin System Language File
+; MokoJoomOpenGraph - Content Plugin System Language File
 ; Copyright (C) 2026 Moko Consulting. All rights reserved.
 ; License: GPL-3.0-or-later
 
-PLG_CONTENT_MOKOOG="Content - MokoOpenGraph"
+PLG_CONTENT_MOKOOG="Content - MokoJoomOpenGraph"
 PLG_CONTENT_MOKOOG_DESCRIPTION="Adds Open Graph fields to article and menu item edit forms for per-page social sharing control."

src/packages/plg_content_mokoog/language/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/media/css/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/media/css/preview.css

@@ -0,0 +1,104 @@
+/**
+ * @package     MokoJoomOpenGraph
+ * @subpackage  plg_content_mokoog
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GPL-3.0-or-later
+ */
+
+.mokoog-preview-wrapper {
+    margin: 15px 0;
+    padding: 15px;
+    background: #f8f9fa;
+    border-radius: 8px;
+    border: 1px solid #dee2e6;
+}
+
+.mokoog-preview-heading {
+    margin: 0 0 12px;
+    font-size: 14px;
+    color: #666;
+}
+
+.mokoog-platform-label {
+    display: block;
+    color: #999;
+    text-transform: uppercase;
+    font-size: 11px;
+    font-weight: 600;
+    margin-top: 16px;
+    margin-bottom: 4px;
+}
+
+.mokoog-platform-label:first-of-type {
+    margin-top: 0;
+}
+
+.mokoog-card {
+    overflow: hidden;
+    max-width: 500px;
+    background: #fff;
+}
+
+.mokoog-card-fb {
+    border: 1px solid #ddd;
+    border-radius: 3px;
+}
+
+.mokoog-card-tw {
+    border: 1px solid #cfd9de;
+    border-radius: 16px;
+}
+
+.mokoog-card-img {
+    height: 260px;
+    background: #e4e6eb center / cover no-repeat;
+}
+
+.mokoog-card-body {
+    padding: 10px 12px;
+    border-top: 1px solid #ddd;
+}
+
+.mokoog-card-tw .mokoog-card-body {
+    border-top-color: #cfd9de;
+}
+
+.mokoog-card-domain {
+    font-size: 11px;
+    color: #65676b;
+    text-transform: uppercase;
+}
+
+.mokoog-card-tw .mokoog-card-domain {
+    font-size: 13px;
+    text-transform: none;
+    margin-top: 4px;
+}
+
+.mokoog-card-title {
+    font-size: 16px;
+    font-weight: 600;
+    color: #1d2129;
+    margin: 3px 0 2px;
+    line-height: 1.3;
+}
+
+.mokoog-card-tw .mokoog-card-title {
+    font-size: 15px;
+    font-weight: 700;
+    color: #0f1419;
+}
+
+.mokoog-card-desc {
+    font-size: 14px;
+    color: #65676b;
+    line-height: 1.4;
+    max-height: 2.8em;
+    overflow: hidden;
+}
+
+.mokoog-card-tw .mokoog-card-desc {
+    font-size: 15px;
+    color: #536471;
+    margin-top: 2px;
+}

src/packages/plg_content_mokoog/media/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/media/joomla.asset.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "https://developer.joomla.org/schemas/json-schema/web_assets.json",
+    "name": "plg_content_mokoog",
+    "version": "01.00.00",
+    "description": "MokoJoomOpenGraph Content Plugin Assets",
+    "license": "GPL-3.0-or-later",
+    "assets": [
+        {
+            "name": "plg_content_mokoog.preview",
+            "type": "style",
+            "uri": "plg_content_mokoog/css/preview.css"
+        },
+        {
+            "name": "plg_content_mokoog.preview",
+            "type": "script",
+            "uri": "plg_content_mokoog/js/preview.js",
+            "dependencies": ["core"]
+        }
+    ]
+}

src/packages/plg_content_mokoog/media/js/index.html

@@ -0,0 +1 @@
+<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_content_mokoog/media/js/preview.js

@@ -0,0 +1,170 @@
+/**
+ * @package     MokoJoomOpenGraph
+ * @subpackage  plg_content_mokoog
+ * @author      Moko Consulting <hello@mokoconsulting.tech>
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GPL-3.0-or-later
+ *
+ * Live social sharing preview for article/menu item editor.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+    'use strict';
+
+    var fields = {
+        ogTitle: document.getElementById('jform_mokoog_og_title'),
+        ogDesc: document.getElementById('jform_mokoog_og_description'),
+        ogImage: document.getElementById('jform_mokoog_og_image'),
+        articleTitle: document.getElementById('jform_title'),
+        metaDesc: document.getElementById('jform_metadesc')
+    };
+
+    // Find the mokoog fieldset and insert preview after it
+    var fieldset = document.querySelector('[data-showon-id="mokoog"]') ||
+        document.getElementById('attrib-mokoog') ||
+        document.querySelector('fieldset.mokoog') ||
+        document.querySelector('[id*="mokoog"]');
+
+    if (!fieldset) {
+        return;
+    }
+
+    // Build preview DOM safely (no innerHTML with user data)
+    var preview = document.createElement('div');
+    preview.id = 'mokoog-preview';
+
+    var wrapper = document.createElement('div');
+    wrapper.className = 'mokoog-preview-wrapper';
+
+    var heading = document.createElement('h4');
+    heading.className = 'mokoog-preview-heading';
+    heading.textContent = 'Social Sharing Preview';
+    wrapper.appendChild(heading);
+
+    // Facebook preview card
+    var fbLabel = document.createElement('small');
+    fbLabel.className = 'mokoog-platform-label';
+    fbLabel.textContent = 'Facebook';
+    wrapper.appendChild(fbLabel);
+
+    var fbCard = document.createElement('div');
+    fbCard.className = 'mokoog-card mokoog-card-fb';
+
+    var fbImg = document.createElement('div');
+    fbImg.id = 'mokoog-fb-img';
+    fbImg.className = 'mokoog-card-img';
+    fbCard.appendChild(fbImg);
+
+    var fbBody = document.createElement('div');
+    fbBody.className = 'mokoog-card-body';
+
+    var fbDomain = document.createElement('div');
+    fbDomain.id = 'mokoog-fb-domain';
+    fbDomain.className = 'mokoog-card-domain';
+    fbBody.appendChild(fbDomain);
+
+    var fbTitle = document.createElement('div');
+    fbTitle.id = 'mokoog-fb-title';
+    fbTitle.className = 'mokoog-card-title';
+    fbBody.appendChild(fbTitle);
+
+    var fbDesc = document.createElement('div');
+    fbDesc.id = 'mokoog-fb-desc';
+    fbDesc.className = 'mokoog-card-desc';
+    fbBody.appendChild(fbDesc);
+
+    fbCard.appendChild(fbBody);
+    wrapper.appendChild(fbCard);
+
+    // Twitter preview card
+    var twLabel = document.createElement('small');
+    twLabel.className = 'mokoog-platform-label';
+    twLabel.textContent = 'Twitter / X';
+    wrapper.appendChild(twLabel);
+
+    var twCard = document.createElement('div');
+    twCard.className = 'mokoog-card mokoog-card-tw';
+
+    var twImg = document.createElement('div');
+    twImg.id = 'mokoog-tw-img';
+    twImg.className = 'mokoog-card-img';
+    twCard.appendChild(twImg);
+
+    var twBody = document.createElement('div');
+    twBody.className = 'mokoog-card-body';
+
+    var twTitle = document.createElement('div');
+    twTitle.id = 'mokoog-tw-title';
+    twTitle.className = 'mokoog-card-title';
+    twBody.appendChild(twTitle);
+
+    var twDesc = document.createElement('div');
+    twDesc.id = 'mokoog-tw-desc';
+    twDesc.className = 'mokoog-card-desc';
+    twBody.appendChild(twDesc);
+
+    var twDomain = document.createElement('div');
+    twDomain.id = 'mokoog-tw-domain';
+    twDomain.className = 'mokoog-card-domain';
+    twBody.appendChild(twDomain);
+
+    twCard.appendChild(twBody);
+    wrapper.appendChild(twCard);
+
+    preview.appendChild(wrapper);
+    fieldset.parentNode.insertBefore(preview, fieldset.nextSibling);
+
+    var domain = window.location.hostname;
+
+    function updatePreview() {
+        var title = (fields.ogTitle && fields.ogTitle.value) ||
+            (fields.articleTitle && fields.articleTitle.value) || 'Page Title';
+        var desc = (fields.ogDesc && fields.ogDesc.value) ||
+            (fields.metaDesc && fields.metaDesc.value) || 'Page description will appear here...';
+        var img = '';
+
+        if (fields.ogImage) {
+            img = fields.ogImage.value;
+        }
+
+        if (title.length > 65) title = title.substring(0, 62) + '...';
+        if (desc.length > 160) desc = desc.substring(0, 157) + '...';
+
+        // Facebook
+        document.getElementById('mokoog-fb-title').textContent = title;
+        document.getElementById('mokoog-fb-desc').textContent = desc;
+        document.getElementById('mokoog-fb-domain').textContent = domain;
+        var fbImgEl = document.getElementById('mokoog-fb-img');
+        if (img) {
+            fbImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
+            fbImgEl.style.display = '';
+        } else {
+            fbImgEl.style.display = 'none';
+        }
+
+        // Twitter
+        document.getElementById('mokoog-tw-title').textContent = title;
+        document.getElementById('mokoog-tw-desc').textContent = desc;
+        document.getElementById('mokoog-tw-domain').textContent = domain;
+        var twImgEl = document.getElementById('mokoog-tw-img');
+        if (img) {
+            twImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
+            twImgEl.style.display = '';
+        } else {
+            twImgEl.style.display = 'none';
+        }
+    }
+
+    Object.values(fields).forEach(function (el) {
+        if (el) {
+            el.addEventListener('input', updatePreview);
+            el.addEventListener('change', updatePreview);
+        }
+    });
+
+    if (fields.ogImage) {
+        var observer = new MutationObserver(updatePreview);
+        observer.observe(fields.ogImage, { attributes: true, attributeFilter: ['value'] });
+    }
+
+    updatePreview();
+});