chore: sync pre-release.yml from Template-Joomla [skip ci]

.gitattributes

@@ -1,62 +0,0 @@
-# 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

@@ -1,204 +0,0 @@
-# ============================================================
-# 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/
-!source/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/CLAUDE.md

@@ -1,67 +0,0 @@
-# MokoJoomOpenGraph
-
-Open Graph, Twitter Card, and social sharing meta tag management for Joomla. Per-article SEO with auto-generation fallback.
-
-## Quick Reference
-
-| Field | Value |
-|---|---|
-| **Package** | `pkg_mokoog` |
-| **Language** | PHP 8.1+ |
-| **Branch** | develop on `dev`, merge to `main` (protected) |
-| **Wiki** | [MokoJoomOpenGraph Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/wiki) |
-
-## Commands
-
-```bash
-make build        # Build package ZIP
-make lint         # Run linters
-make validate     # Validate structure
-make release      # Full release pipeline
-make clean        # Clean build artifacts
-composer install  # Install PHP dependencies
-```
-
-## Architecture
-
-Joomla **package** with three sub-extensions:
-
-### com_mokoog (Component)
-- Admin backend for viewing/managing all OG tag records
-- Joomla 4/5 MVC: `Controller/DisplayController`, `Model/TagsModel`, `View/Tags/HtmlView`, `Table/TagTable`
-- Namespace: `Joomla\Component\MokoOG\Administrator`
-
-### plg_system_mokoog (System Plugin)
-- Hooks `onBeforeCompileHead` to inject `<meta property="og:*">` and `<meta name="twitter:*">`
-- Auto-generates tags from article title, description, images when no custom tags exist
-- Supports articles (`com_content`), menu items, extensible content types
-
-### plg_content_mokoog (Content Plugin)
-- Hooks `onContentPrepareForm` to add OG fields tab to article/menu editors
-- Hooks `onContentAfterSave`/`onContentAfterDelete` to persist/clean OG data
-
-### Database Schema
-
-Single table `#__mokoog_tags`:
-- `content_type` + `content_id` = unique key for any content item
-- `og_title`, `og_description`, `og_image`, `og_type` = custom OG overrides
-- `published` flag for per-item enable/disable
-
-## Rules
-
-- **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js`
-- **Attribution**: `Authored-by: Moko Consulting`
-- **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`)
-- **Minification**: handled at build time (CI)
-- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files
-- **Standards**: [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home)
-
-## Coding Standards
-
-- PHP 8.1+ minimum
-- Joomla 4/5 DI container pattern: `services/provider.php` → Extension class
-- Legacy stub `.php` file required for plugin loader but empty
-- `SubscriberInterface` for event subscription (not `on*` method naming)
-- `bind() → check() → store()` for Table operations (not `save()`)
-- Language file placement: site (no `folder`) vs admin (`folder="administrator"`)
-- SPDX license headers on all PHP files

.mokogitea/branch-protection.yml

@@ -0,0 +1,251 @@
+# 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,11 +5,9 @@
 -->
 <moko-platform xmlns="https://standards.mokoconsulting.tech/moko-platform/1.0" schema-version="1.0">
   <identity>
-    <name>MokoJoomOpenGraph</name>
-    <display-name>Package - MokoJoomOpenGraph</display-name>
+    <name>MokoOpenGraph</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.02</version>
     <license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
   </identity>
   <governance>
@@ -21,6 +19,6 @@
   <build>
     <language>PHP</language>
     <package-type>joomla-extension</package-type>
-    <entry-point>source/</entry-point>
+    <entry-point>src/</entry-point>
   </build>
 </moko-platform>

.mokogitea/workflows/auto-bump.yml

@@ -0,0 +1,66 @@
+# 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/auto-release.yml

@@ -171,10 +171,27 @@ jobs:
             echo MOKO_CLI=/tmp/moko-platform-api/cli >> $GITHUB_ENV
           fi
 
+      - name: "Determine version bump level"
+        id: bump
+        run: |
+          # Fix/patch branches: version was already bumped by pre-release, just strip suffix
+          # Feature/dev branches: bump minor for the new stable release
+          HEAD_REF="${{ github.event.pull_request.head.ref || 'dev' }}"
+          case "$HEAD_REF" in
+            fix/*|patch/*|hotfix/*|bugfix/*) BUMP="none" ;;
+            *)                               BUMP="minor" ;;
+          esac
+          echo "level=${BUMP}" >> "$GITHUB_OUTPUT"
+          echo "Bump level: ${BUMP} (from branch: ${HEAD_REF})"
+
       - name: "Publish stable release"
         run: |
+          BUMP_FLAG=""
+          if [ "${{ steps.bump.outputs.level }}" != "none" ]; then
+            BUMP_FLAG="--bump ${{ steps.bump.outputs.level }}"
+          fi
           php ${MOKO_CLI}/release_publish.php \
-            --path . --stability stable --bump minor --branch main \
+            --path . --stability stable ${BUMP_FLAG} --branch main \
             --token "${{ secrets.MOKOGITEA_TOKEN }}"
 
       - name: Update release notes from CHANGELOG.md

.mokogitea/workflows/branch-cleanup.yml

@@ -0,0 +1,48 @@
+# 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

@@ -0,0 +1,10 @@
+# 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-generic.yml

@@ -0,0 +1,204 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: Gitea.Workflow
+# INGROUP: MokoStandards.CI
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
+# PATH: /.gitea/workflows/ci-generic.yml
+# VERSION: 01.00.00
+# BRIEF: CI pipeline — lint, validate, and test for generic projects (PHP + Node.js)
+
+name: "Generic: Project CI"
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+      - dev/**
+      - rc/**
+      - version/**
+  pull_request:
+    branches:
+      - main
+      - dev
+      - dev/**
+      - rc/**
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  # ── Lint & Validate ───────────────────────────────────────────────────
+  lint:
+    name: Lint & Validate
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Detect toolchain
+        id: detect
+        run: |
+          HAS_PHP=false
+          HAS_NODE=false
+          [ -f "composer.json" ] && HAS_PHP=true
+          [ -f "package.json" ] && HAS_NODE=true
+          echo "has_php=$HAS_PHP" >> "$GITHUB_OUTPUT"
+          echo "has_node=$HAS_NODE" >> "$GITHUB_OUTPUT"
+          echo "Toolchain: PHP=$HAS_PHP Node=$HAS_NODE"
+
+      - name: Setup PHP
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          if ! command -v php &> /dev/null; then
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq php-cli php-mbstring php-xml >/dev/null 2>&1
+          fi
+          php -v
+
+      - name: Setup Node.js
+        if: steps.detect.outputs.has_node == 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install PHP dependencies
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          if [ -f "composer.json" ]; then
+            composer install --no-interaction --prefer-dist --quiet 2>/dev/null || true
+          fi
+
+      - name: Install Node.js dependencies
+        if: steps.detect.outputs.has_node == 'true'
+        run: |
+          if [ -f "package.json" ]; then
+            npm ci --quiet 2>/dev/null || npm install --quiet 2>/dev/null || true
+          fi
+
+      - name: PHP syntax check
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          ERRORS=0
+          while IFS= read -r -d '' file; do
+            if ! php -l "$file" 2>&1 | grep -q "No syntax errors"; then
+              echo "::error file=${file}::PHP syntax error"
+              ERRORS=$((ERRORS + 1))
+            fi
+          done < <(find . -name "*.php" -not -path "./.git/*" -not -path "./vendor/*" -not -path "./node_modules/*" -print0)
+
+          echo "## PHP Lint" >> $GITHUB_STEP_SUMMARY
+          if [ "$ERRORS" -eq 0 ]; then
+            echo "All PHP files passed syntax check." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "${ERRORS} file(s) with syntax errors." >> $GITHUB_STEP_SUMMARY
+            exit 1
+          fi
+
+      - name: TypeScript/JavaScript lint
+        if: steps.detect.outputs.has_node == 'true'
+        run: |
+          if [ -f "node_modules/.bin/eslint" ]; then
+            npx eslint src/ --quiet 2>&1 || { echo "::error::ESLint errors found"; exit 1; }
+            echo "## ESLint" >> $GITHUB_STEP_SUMMARY
+            echo "All files passed ESLint." >> $GITHUB_STEP_SUMMARY
+          elif [ -f ".eslintrc.json" ] || [ -f ".eslintrc.js" ] || [ -f "eslint.config.js" ]; then
+            echo "::warning::ESLint config found but eslint not installed"
+          else
+            echo "No ESLint configured — skipping"
+          fi
+
+      - name: TypeScript compile check
+        if: steps.detect.outputs.has_node == 'true'
+        run: |
+          if [ -f "tsconfig.json" ] && [ -f "node_modules/.bin/tsc" ]; then
+            npx tsc --noEmit 2>&1 || { echo "::error::TypeScript compilation errors"; exit 1; }
+            echo "## TypeScript" >> $GITHUB_STEP_SUMMARY
+            echo "TypeScript compilation passed." >> $GITHUB_STEP_SUMMARY
+          fi
+
+      - name: PHPStan static analysis
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          if [ -f "phpstan.neon" ] && [ -f "vendor/bin/phpstan" ]; then
+            vendor/bin/phpstan analyse --no-progress 2>&1 || { echo "::warning::PHPStan found issues"; }
+          fi
+
+  # ── Tests ─────────────────────────────────────────────────────────────
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    needs: lint
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Detect toolchain
+        id: detect
+        run: |
+          HAS_PHP=false
+          HAS_NODE=false
+          [ -f "composer.json" ] && HAS_PHP=true
+          [ -f "package.json" ] && HAS_NODE=true
+          echo "has_php=$HAS_PHP" >> "$GITHUB_OUTPUT"
+          echo "has_node=$HAS_NODE" >> "$GITHUB_OUTPUT"
+
+      - name: Setup PHP
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          if ! command -v php &> /dev/null; then
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq php-cli php-mbstring php-xml >/dev/null 2>&1
+          fi
+
+      - name: Setup Node.js
+        if: steps.detect.outputs.has_node == 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: |
+          [ -f "composer.json" ] && composer install --no-interaction --prefer-dist --quiet 2>/dev/null || true
+          [ -f "package.json" ] && { npm ci --quiet 2>/dev/null || npm install --quiet 2>/dev/null || true; }
+
+      - name: Run PHP tests
+        if: steps.detect.outputs.has_php == 'true'
+        run: |
+          if [ -f "vendor/bin/phpunit" ]; then
+            vendor/bin/phpunit --testdox 2>&1
+            echo "## PHPUnit" >> $GITHUB_STEP_SUMMARY
+            echo "Tests passed." >> $GITHUB_STEP_SUMMARY
+          elif [ -f "phpunit.xml" ] || [ -f "phpunit.xml.dist" ]; then
+            echo "::warning::PHPUnit config found but phpunit not installed"
+          else
+            echo "No PHPUnit configured — skipping"
+          fi
+
+      - name: Run Node.js tests
+        if: steps.detect.outputs.has_node == 'true'
+        run: |
+          if jq -e '.scripts.test' package.json > /dev/null 2>&1; then
+            npm test 2>&1
+            echo "## Node.js Tests" >> $GITHUB_STEP_SUMMARY
+            echo "Tests passed." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "No test script in package.json — skipping"
+          fi
+
+      - name: Build check
+        run: |
+          if [ -f "Makefile" ]; then
+            make build 2>&1 || echo "::warning::Build failed or not configured"
+          elif [ -f "package.json" ] && jq -e '.scripts.build' package.json > /dev/null 2>&1; then
+            npm run build 2>&1 || echo "::warning::Build failed"
+          fi

.mokogitea/workflows/ci-joomla.yml

@@ -35,25 +35,32 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         run: |
+          if ! command -v php &> /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
           php -v && composer --version
 
-      - name: Clone MokoStandards
+      - name: Setup moko-platform tools
         env:
-          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' }}
+          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          MOKO_CLONE_HOST: ${{ secrets.GA_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" \
-            /tmp/mokostandards-api
+          if [ -d "/tmp/moko-platform" ] || [ -d "/opt/moko-platform" ]; then
+            echo "moko-platform already available on runner — skipping clone"
+          else
+            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 || echo "moko-platform clone skipped — continuing without it"
+          fi
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -67,7 +74,7 @@ jobs:
       - name: PHP syntax check
         run: |
           ERRORS=0
-          for DIR in source/ src/ htdocs/; do
+          for DIR in src/ htdocs/; do
             if [ -d "$DIR" ]; then
               FOUND=1
               while IFS= read -r -d '' FILE; do
@@ -124,13 +131,8 @@ jobs:
               echo "Manifest is well-formed XML." >> $GITHUB_STEP_SUMMARY
             fi
 
-            # 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
+            # Check required tags: name, version, author
+            for TAG in name version author; do
               if ! grep -q "<${TAG}>" "$MANIFEST" 2>/dev/null; then
                 echo "Missing required tag: \`<${TAG}>\`" >> $GITHUB_STEP_SUMMARY
                 ERRORS=$((ERRORS + 1))
@@ -138,6 +140,19 @@ jobs:
                 echo "Found required tag: \`<${TAG}>\`" >> $GITHUB_STEP_SUMMARY
               fi
             done
+
+            # Namespace is required for components/plugins but not packages
+            EXT_TYPE=$(grep -oP '<extension[^>]*\btype="\K[^"]+' "$MANIFEST" | head -1)
+            if [ "$EXT_TYPE" != "package" ]; then
+              if ! grep -q "<namespace" "$MANIFEST" 2>/dev/null; then
+                echo "Missing required tag: \`<namespace>\` (required for Joomla 5+ ${EXT_TYPE} extensions)" >> $GITHUB_STEP_SUMMARY
+                ERRORS=$((ERRORS + 1))
+              else
+                echo "Found required tag: \`<namespace>\`" >> $GITHUB_STEP_SUMMARY
+              fi
+            else
+              echo "Package extension — \`<namespace>\` not required." >> $GITHUB_STEP_SUMMARY
+            fi
           fi
 
           if [ "${ERRORS}" -gt 0 ]; then
@@ -202,44 +217,13 @@ 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 source/ 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
           MISSING=0
           CHECKED=0
 
-          for DIR in source/ src/ htdocs/; do
+          for DIR in src/ htdocs/; do
             if [ -d "$DIR" ]; then
               while IFS= read -r -d '' SUBDIR; do
                 CHECKED=$((CHECKED + 1))
@@ -252,7 +236,7 @@ jobs:
           done
 
           if [ "${CHECKED}" -eq 0 ]; then
-            echo "No source/, src/, or htdocs/ directories found — skipping." >> $GITHUB_STEP_SUMMARY
+            echo "No src/ or htdocs/ directories found — skipping." >> $GITHUB_STEP_SUMMARY
           elif [ "${MISSING}" -gt 0 ]; then
             echo "" >> $GITHUB_STEP_SUMMARY
             echo "**${MISSING} director(ies) missing index.html out of ${CHECKED} checked.**" >> $GITHUB_STEP_SUMMARY
@@ -268,7 +252,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Validate release readiness
         run: |
@@ -276,8 +260,8 @@ jobs:
           echo "" >> $GITHUB_STEP_SUMMARY
           ERRORS=0
 
-          # 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)
+          # 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)
           if [ -z "$README_VERSION" ]; then
             echo "No VERSION found in README.md FILE INFORMATION block." >> $GITHUB_STEP_SUMMARY
             ERRORS=$((ERRORS + 1))
@@ -301,7 +285,7 @@ jobs:
             echo "Manifest: \`${MANIFEST}\`" >> $GITHUB_STEP_SUMMARY
 
             # Check <version> matches README VERSION
-            MANIFEST_VERSION=$(sed -n 's/.*<version>\([^<]*\)<\/version>.*/\1/p' "$MANIFEST" | head -1)
+            MANIFEST_VERSION=$(grep -oP '<version>\K[^<]+' "$MANIFEST" | head -1)
             if [ -z "$MANIFEST_VERSION" ]; then
               echo "No \`<version>\` tag in manifest." >> $GITHUB_STEP_SUMMARY
               ERRORS=$((ERRORS + 1))
@@ -374,15 +358,19 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP ${{ matrix.php }}
         run: |
+          if ! command -v php &> /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
           php -v && composer --version
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -420,14 +408,19 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP
-        run: php -v && composer --version
+        run: |
+          if ! command -v php &> /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
+          php -v && composer --version
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install --no-interaction --prefer-dist --optimize-autoloader
@@ -450,7 +443,7 @@ jobs:
 
           # Determine source directory
           SRC_DIR=""
-          for DIR in source/ src/ htdocs/ lib/; do
+          for DIR in src/ htdocs/ lib/; do
             if [ -d "$DIR" ]; then
               SRC_DIR="$DIR"
               break
@@ -458,7 +451,7 @@ jobs:
           done
 
           if [ -z "$SRC_DIR" ]; then
-            echo "No source directory found (source/, src/, htdocs/, lib/) — skipping." >> $GITHUB_STEP_SUMMARY
+            echo "No source directory found (src/, htdocs/, lib/) — skipping." >> $GITHUB_STEP_SUMMARY
             exit 0
           fi
 
@@ -484,3 +477,24 @@ jobs:
             echo '```' >> $GITHUB_STEP_SUMMARY
           fi
           exit $EXIT
+
+  pre-release:
+    name: Build RC Pre-Release
+    runs-on: ubuntu-latest
+    needs: [lint-and-validate, test]
+    if: github.event_name == 'pull_request'
+
+    steps:
+      - name: Trigger pre-release build
+        env:
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          REPO: ${{ github.repository }}
+          BRANCH: ${{ github.head_ref }}
+        run: |
+          curl -s -X POST \
+            "${GITEA_URL:-https://git.mokoconsulting.tech}/api/v1/repos/${REPO}/actions/workflows/pre-release.yml/dispatches" \
+            -H "Authorization: token ${GA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"ref\":\"${BRANCH}\",\"inputs\":{\"stability\":\"release-candidate\"}}"
+          echo "### Pre-Release" >> $GITHUB_STEP_SUMMARY
+          echo "Triggered RC build on branch \`${BRANCH}\`" >> $GITHUB_STEP_SUMMARY

.mokogitea/workflows/cleanup.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Maintenance
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# INGROUP: MokoStandards.Maintenance
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # 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.MOKOGITEA_TOKEN }}
+          token: ${{ secrets.GA_TOKEN }}
 
       - name: Delete merged branches
         env:
-          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
         run: |
           echo "=== Merged Branch Cleanup ==="
           API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
 
           # List branches via API
-          BRANCHES=$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
+          BRANCHES=$(curl -sS -H "Authorization: token ${GA_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 ${GITEA_TOKEN}" \
+              curl -sS -X DELETE -H "Authorization: token ${GA_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.MOKOGITEA_TOKEN }}
+          GA_TOKEN: ${{ secrets.GA_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 ${GITEA_TOKEN}" \
+          RUNS=$(curl -sS -H "Authorization: token ${GA_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 ${GITEA_TOKEN}" \
+            curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
               "${API}/actions/runs/${RUN_ID}" 2>/dev/null || true
             DELETED=$((DELETED + 1))
           done

.mokogitea/workflows/deploy-manual.yml

@@ -0,0 +1,126 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: Gitea.Workflow
+# INGROUP: MokoStandards.Deploy
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API
+# PATH: /templates/workflows/joomla/deploy-manual.yml.template
+# VERSION: 04.07.00
+# BRIEF: Manual SFTP deploy to dev server for Joomla repos
+
+name: "Universal: Deploy to Dev (Manual)"
+
+on:
+  workflow_dispatch:
+    inputs:
+      clear_remote:
+        description: 'Delete all remote files before uploading'
+        required: false
+        default: 'false'
+        type: boolean
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    name: SFTP Deploy to Dev
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Setup PHP
+        run: |
+          php -v && composer --version
+
+      - name: Setup MokoStandards tools
+        env:
+          GA_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
+          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
+          MOKO_CLONE_HOST: ${{ secrets.GA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+        run: |
+          git clone --depth 1 --branch main --quiet \
+            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
+            /tmp/mokostandards-api 2>/dev/null || true
+          if [ -d "/tmp/mokostandards-api" ] && [ -f "/tmp/mokostandards-api/composer.json" ]; then
+            cd /tmp/mokostandards-api && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
+          fi
+
+      - name: Check FTP configuration
+        id: check
+        env:
+          HOST: ${{ vars.DEV_FTP_HOST }}
+          PATH_VAR: ${{ vars.DEV_FTP_PATH }}
+          PORT: ${{ vars.DEV_FTP_PORT }}
+        run: |
+          if [ -z "$HOST" ] || [ -z "$PATH_VAR" ]; then
+            echo "DEV_FTP_HOST or DEV_FTP_PATH not configured -- cannot deploy"
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "skip=false" >> "$GITHUB_OUTPUT"
+          echo "host=$HOST" >> "$GITHUB_OUTPUT"
+
+          REMOTE="${PATH_VAR%/}"
+          echo "remote=$REMOTE" >> "$GITHUB_OUTPUT"
+
+          [ -z "$PORT" ] && PORT="22"
+          echo "port=$PORT" >> "$GITHUB_OUTPUT"
+
+      - name: Deploy via SFTP
+        if: steps.check.outputs.skip != 'true'
+        env:
+          SFTP_KEY: ${{ secrets.DEV_FTP_KEY }}
+          SFTP_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
+          SFTP_USER: ${{ vars.DEV_FTP_USERNAME }}
+        run: |
+          SOURCE_DIR="src"
+          [ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
+          [ ! -d "$SOURCE_DIR" ] && { echo "No src/ or htdocs/ -- nothing to deploy"; exit 0; }
+
+          printf '{"host":"%s","port":%s,"username":"%s","remotePath":"%s"' \
+            "${{ steps.check.outputs.host }}" "${{ steps.check.outputs.port }}" "$SFTP_USER" "${{ steps.check.outputs.remote }}" \
+            > /tmp/sftp-config.json
+
+          if [ -n "$SFTP_KEY" ]; then
+            echo "$SFTP_KEY" > /tmp/deploy_key
+            chmod 600 /tmp/deploy_key
+            printf ',"privateKeyPath":"/tmp/deploy_key"}' >> /tmp/sftp-config.json
+          else
+            printf ',"password":"%s"}' "$SFTP_PASS" >> /tmp/sftp-config.json
+          fi
+
+          DEPLOY_ARGS=(--path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json)
+          [ "${{ inputs.clear_remote }}" = "true" ] && DEPLOY_ARGS+=(--clear-remote)
+
+          PLATFORM=$(php /tmp/mokostandards-api/cli/platform_detect.php --path . 2>/dev/null || true)
+          if [ "$PLATFORM" = "waas-component" ] && [ -f "/tmp/mokostandards-api/deploy/deploy-joomla.php" ]; then
+            php /tmp/mokostandards-api/deploy/deploy-joomla.php "${DEPLOY_ARGS[@]}"
+          else
+            php /tmp/mokostandards-api/deploy/deploy-sftp.php "${DEPLOY_ARGS[@]}"
+          fi
+
+          rm -f /tmp/deploy_key /tmp/sftp-config.json
+
+      - name: Summary
+        if: always()
+        run: |
+          if [ "${{ steps.check.outputs.skip }}" = "true" ]; then
+            echo "### Deploy Skipped -- FTP not configured" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "### Manual Dev Deploy Complete" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
+            echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
+            echo "| Host | \`${{ steps.check.outputs.host }}\` |" >> $GITHUB_STEP_SUMMARY
+            echo "| Remote | \`${{ steps.check.outputs.remote }}\` |" >> $GITHUB_STEP_SUMMARY
+            echo "| Clear | ${{ inputs.clear_remote }} |" >> $GITHUB_STEP_SUMMARY
+          fi

.mokogitea/workflows/gitleaks.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Security
-# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
+# INGROUP: MokoStandards.Security
+# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/MokoStandards-API
 # 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

@@ -0,0 +1,73 @@
+# 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: moko-platform.Notifications
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# INGROUP: MokoStandards.Notifications
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /.gitea/workflows/notify.yml
 # VERSION: 01.00.00
 # BRIEF: Push notifications via ntfy on release success or workflow failure

.mokogitea/workflows/pre-release.yml

@@ -8,236 +8,4 @@
 # 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
-  pull_request_target:
-    types: [synchronize, opened, reopened]
-    branches:
-      - main
-  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_name == 'pull_request' && github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'dev') ||
-      (github.event_name == 'pull_request_target' && github.event.pull_request.base.ref == 'main')
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
-          ref: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.sha || '' }}
-
-      - name: Setup moko-platform tools
-        env:
-          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
-          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
-        run: |
-          # Use pre-installed /opt/moko-platform if available (updated by cron every 6h)
-          if [ -f /opt/moko-platform/cli/version_bump.php ] && [ -f /opt/moko-platform/cli/manifest_element.php ] && [ -f /opt/moko-platform/vendor/autoload.php ]; then
-            echo Using pre-installed /opt/moko-platform
-            echo MOKO_CLI=/opt/moko-platform/cli >> $GITHUB_ENV
-          else
-            echo Falling back to fresh clone
-            if ! command -v composer > /dev/null 2>&1; 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
-            rm -rf /tmp/moko-platform-api
-            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git
-            git clone --depth 1 --branch main --quiet $CLONE_URL /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: Detect platform
-        id: platform
-        run: |
-          php ${MOKO_CLI}/manifest_read.php --path . --github-output
-
-      - name: Resolve metadata and bump version
-        id: meta
-        run: |
-          # Auto-detect stability: RC for PRs targeting main, else use input or default to development
-          if [ "${{ github.event_name }}" = "pull_request_target" ] && [ "${{ github.event.pull_request.base.ref }}" = "main" ]; then
-            STABILITY="release-candidate"
-          else
-            STABILITY="${{ inputs.stability || 'development' }}"
-          fi
-
-          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
-
-          # Bump version via CLI: patch for dev/alpha/beta, minor for RC
-          case "$STABILITY" in
-            release-candidate) BUMP="minor" ;;
-            *)                 BUMP="patch" ;;
-          esac
-
-          php ${MOKO_CLI}/version_bump.php --path . $([ "$BUMP" = "minor" ] && echo "--minor") 2>/dev/null || true
-
-          # Set stability suffix and verify consistency
-          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "00.00.01")
-          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
-          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
-
-          # Ensure licensing tags (updateservers, dlid) if enabled in manifest.xml
-          php ${MOKO_CLI}/manifest_licensing.php --path . --fix 2>/dev/null || true
-
-          # Append suffix for output
-          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: Update release notes from CHANGELOG.md
-        run: |
-          TAG="${{ steps.meta.outputs.tag }}"
-          VERSION="${{ steps.meta.outputs.version }}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-
-          # Extract [Unreleased] section from changelog (everything between [Unreleased] and next ## heading)
-          if [ -f "CHANGELOG.md" ]; then
-            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
-            [ -z "$NOTES" ] && NOTES="Release ${VERSION}"
-          else
-            NOTES="Release ${VERSION}"
-          fi
-
-          # Update release body via API
-          RELEASE_ID=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
-            "${API_BASE}/releases/tags/${TAG}" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
-
-          if [ -n "$RELEASE_ID" ]; then
-            python3 -c "
-          import json, urllib.request
-          body = open('/dev/stdin').read()
-          payload = json.dumps({'body': body}).encode()
-          req = urllib.request.Request(
-              '${API_BASE}/releases/${RELEASE_ID}',
-              data=payload, method='PATCH',
-              headers={
-                  'Authorization': 'token ${{ secrets.MOKOGITEA_TOKEN }}',
-                  'Content-Type': 'application/json'
-              })
-          urllib.request.urlopen(req)
-          " <<< "$NOTES"
-            echo "Release notes updated from CHANGELOG.md"
-          fi
-
-      - 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
-
-      # updates.xml is generated dynamically by MokoGitea license server
-      # No need to build, commit, or sync updates.xml from workflows
-
-      - 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
+# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches

.mokogitea/workflows/security-audit.yml

@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Security
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# INGROUP: MokoStandards.Security
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /.gitea/workflows/security-audit.yml
 # VERSION: 01.00.00
 # BRIEF: Dependency vulnerability scanning for composer and npm packages
@@ -80,19 +80,3 @@ 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

@@ -0,0 +1,312 @@
+# 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,44 +1,24 @@
 # Changelog
 
-<!-- VERSION: 01.00.02 -->
+<!-- VERSION: 01.00.00 -->
 
-All notable changes to MokoJoomOpenGraph will be documented in this file.
+All notable changes to MokoOpenGraph will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-### 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)
+### Removed
+- Removed deploy-manual.yml workflow — switching to Joomla update server method for extension distribution
 
 ### Added
-- 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
+- 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
 - Default fallback image configuration
-- 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
+- Admin tag manager component for viewing all OG records
+- Facebook App ID support
+- Database table `#__mokoog_tags` for storing custom OG data

CLAUDE.md

@@ -0,0 +1,78 @@
+# CLAUDE.md
+
+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
+
+| Field | Value |
+|---|---|
+| **Platform** | joomla |
+| **Language** | PHP |
+| **Default branch** | main |
+| **License** | GPL-3.0-or-later |
+| **Wiki** | [MokoOpenGraph Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoOpenGraph/wiki) |
+| **Standards** | [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home) |
+
+## Common Commands
+
+```bash
+make build        # Build the project
+make lint         # Run linters
+make validate     # Validate structure
+make release      # Full release pipeline
+make minify       # Minify CSS/JS assets
+make clean        # Clean build artifacts
+```
+
+```bash
+composer install  # Install PHP dependencies
+```
+
+## Architecture
+
+This is a Joomla **package** extension (`pkg_mokoog`) containing three sub-extensions:
+
+### com_mokoog (Component)
+- Admin backend for viewing and managing all OG tag records
+- Joomla 4/5 MVC: `Controller/DisplayController`, `Model/TagsModel`, `View/Tags/HtmlView`, `Table/TagTable`
+- Namespace: `Joomla\Component\MokoOG\Administrator`
+- Database table: `#__mokoog_tags` — stores custom OG data per content item
+
+### plg_system_mokoog (System Plugin)
+- Hooks `onBeforeCompileHead` to inject `<meta property="og:*">` and `<meta name="twitter:*">` tags
+- Auto-generates tags from article title, description, and images when no custom tags exist
+- Supports articles (`com_content`), menu items, and extensible content types
+- Namespace: `Joomla\Plugin\System\MokoOG`
+
+### plg_content_mokoog (Content Plugin)
+- Hooks `onContentPrepareForm` to add OG fields tab to article and menu item editors
+- Hooks `onContentAfterSave` / `onContentAfterDelete` to persist/clean OG data
+- Namespace: `Joomla\Plugin\Content\MokoOG`
+
+### Database Schema
+
+Single table `#__mokoog_tags`:
+- `content_type` + `content_id` = unique key identifying any content item
+- `og_title`, `og_description`, `og_image`, `og_type` = custom OG overrides
+- `published` flag for enabling/disabling per-item
+
+## Rules
+
+- **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, or `*.min.css`/`*.min.js`
+- **Attribution**: use `Authored-by: Moko Consulting` in commits
+- **Branch strategy**: develop on `dev`, merge to `main` for release
+- **Minification**: handled at build time (CI)
+- **Wiki**: documentation lives in the Gitea wiki, not in `docs/` files
+- **Standards**: this repo follows [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home)
+
+## Coding Standards
+
+- PHP 8.1+ minimum
+- Joomla 4/5 DI container pattern: `services/provider.php` → Extension class
+- Legacy stub `.php` file required for plugin loader but empty
+- `SubscriberInterface` for event subscription (not `on*` method naming)
+- `bind() → check() → store()` for Table operations (not `save()`)
+- Language file placement: site (no `folder`) vs admin (`folder="administrator"`)
+- SPDX license headers on all PHP files

CODE_OF_CONDUCT.md

@@ -1,28 +0,0 @@
-# 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,34 +1,161 @@
-# 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.
+# 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>*

Makefile

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

README.md

@@ -1,69 +1,40 @@
-# MokoJoomOpenGraph
+# MokoOpenGraph
 
-<!-- VERSION: 01.00.02 -->
+<!-- VERSION: 01.00.00 -->
 
 Open Graph, Twitter Card, and social sharing meta tag management for Joomla 4/5/6.
 
 ## Overview
 
-MokoJoomOpenGraph gives you full control over how your Joomla content appears when shared on Facebook, Twitter/X, LinkedIn, Discord, WhatsApp, Telegram, and other social platforms. Set custom titles, descriptions, and images per article, menu item, and category — or let the extension auto-generate them from your existing content.
+MokoOpenGraph gives you full control over how your Joomla content appears when shared on Facebook, Twitter/X, LinkedIn, WhatsApp, and other social platforms. Set custom titles, descriptions, and images per article and menu item — or let the extension auto-generate them from your existing content.
 
 ## Features
 
-### Social Meta Tags
-- **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`, `og:locale`
+- **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`
 - **Twitter/X Cards** — Summary and Summary with Large Image card types
-- **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-article control** — Custom OG fields in the article editor
 - **Per-menu-item control** — Custom OG fields in the menu item editor
-- **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
+- **Auto-generation** — Automatically builds tags from article content, title, and images
+- **Default fallback image** — Site-wide default when no article image exists
+- **Admin tag manager** — View and manage all OG records from a central dashboard
+- **Facebook App ID** — Optional `fb:app_id` meta tag support
+- **Joomla 4/5/6** — Modern DI container architecture, Joomla coding standards
 
 ## Installation
 
-1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/releases)
+1. Download the latest `pkg_mokoog-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoOpenGraph/releases)
 2. In Joomla Administrator → Extensions → Install → Upload Package File
-3. All plugins are enabled automatically on install
+3. The system plugin is enabled automatically on install
 
 ## Configuration
 
-Navigate to **Extensions → Plugins → System - MokoJoomOpenGraph** to configure:
+Navigate to **Extensions → Plugins → System - MokoOpenGraph** to configure:
 - Site name override
-- Default OG title and description (site-wide fallback)
 - Default fallback image
 - Twitter Card type and @username
 - Facebook App ID
-- Discord embed color
-- Telegram channel
-- Auto-generation, image resize, JSON-LD, and description length settings
+- Auto-generation behavior
+- Description length limit
 
 ## License
 

composer.json

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

source/index.html

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

source/language/en-GB/index.html

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

source/language/en-US/index.html

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

source/language/index.html

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

source/packages/com_mokoog/api/index.html

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

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

@@ -1,68 +0,0 @@
-<?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();
-    }
-}

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

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

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

@@ -1,66 +0,0 @@
-<?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',
-    ];
-}

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

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

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

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

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

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

source/packages/com_mokoog/forms/index.html

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

source/packages/com_mokoog/index.html

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

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

@@ -1,59 +0,0 @@
-; MokoJoomOpenGraph - Component Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-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"
-COM_MOKOOG_AUTO_GENERATED="auto-generated"
-
-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."

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

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

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

@@ -1,59 +0,0 @@
-; MokoJoomOpenGraph - Component Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-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"
-COM_MOKOOG_AUTO_GENERATED="auto-generated"
-
-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."

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

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

source/packages/com_mokoog/language/index.html

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

source/packages/com_mokoog/services/index.html

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

source/packages/com_mokoog/sql/index.html

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

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

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

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

@@ -1,9 +0,0 @@
---
--- 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`;

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

@@ -1,10 +0,0 @@
---
--- 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`);

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

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

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

@@ -1,60 +0,0 @@
-<?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;
-}

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

@@ -1,76 +0,0 @@
-<?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 (mb_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() ?: '';
-    }
-}

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

@@ -1,73 +0,0 @@
-<?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 (mb_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 '';
-    }
-}

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

@@ -1,82 +0,0 @@
-<?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));
-    }
-}

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

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

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

@@ -1,176 +0,0 @@
-<?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();
-        $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');
-
-        // Always offset=0: processed articles now have #__mokoog_tags rows
-        // and are excluded by the LEFT JOIN ... IS NULL filter automatically.
-        $db->setQuery($query, 0, $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,
-        ]);
-
-        $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 (mb_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 '';
-    }
-}

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

@@ -1,245 +0,0 @@
-<?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');
-    }
-}

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

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

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

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

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

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

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

@@ -1,68 +0,0 @@
-<?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);
-    }
-}

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

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

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

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

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

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

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

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

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

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

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

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

source/packages/com_mokoog/src/index.html

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

source/packages/com_mokoog/tmpl/index.html

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

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

@@ -1,243 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomOpenGraph
- * @subpackage  com_mokoog
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- */
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\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">
-                        <span class="icon-info-circle" aria-hidden="true"></span>
-                        <?php echo Text::_('COM_MOKOOG_NO_TAGS'); ?>
-                    </div>
-                <?php else : ?>
-                    <table class="table" id="tagList">
-                        <caption class="visually-hidden">
-                            <?php echo Text::_('COM_MOKOOG_TABLE_CAPTION'); ?>
-                        </caption>
-                        <thead>
-                            <tr>
-                                <td class="w-1 text-center">
-                                    <?php echo HTMLHelper::_('grid.checkall'); ?>
-                                </td>
-                                <th scope="col">
-                                    <?php echo Text::_('COM_MOKOOG_HEADING_CONTENT_TYPE'); ?>
-                                </th>
-                                <th scope="col">
-                                    <?php echo Text::_('COM_MOKOOG_HEADING_CONTENT_ID'); ?>
-                                </th>
-                                <th scope="col">
-                                    <?php echo Text::_('COM_MOKOOG_HEADING_OG_TITLE'); ?>
-                                </th>
-                                <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>
-                                <th scope="col" class="w-5">
-                                    <?php echo Text::_('JGRID_HEADING_ID'); ?>
-                                </th>
-                            </tr>
-                        </thead>
-                        <tbody>
-                            <?php foreach ($this->items as $i => $item) : ?>
-                                <tr>
-                                    <td class="text-center">
-                                        <?php echo HTMLHelper::_('grid.id', $i, $item->id); ?>
-                                    </td>
-                                    <td>
-                                        <?php echo $this->escape($item->content_type); ?>
-                                    </td>
-                                    <td>
-                                        <?php echo (int) $item->content_id; ?>
-                                    </td>
-                                    <td>
-                                        <?php echo $this->escape($item->og_title ?: '(' . Text::_('COM_MOKOOG_AUTO_GENERATED') . ')'); ?>
-                                    </td>
-                                    <td>
-                                        <?php if ($item->og_image) : ?>
-                                            <span class="icon-image" aria-hidden="true" title="<?php echo $this->escape($item->og_image); ?>"></span>
-                                        <?php else : ?>
-                                            <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>
-                                    <td>
-                                        <?php echo (int) $item->id; ?>
-                                    </td>
-                                </tr>
-                            <?php endforeach; ?>
-                        </tbody>
-                    </table>
-
-                    <?php echo $this->pagination->getListFooter(); ?>
-                <?php endif; ?>
-
-                <input type="hidden" name="task" value="">
-                <input type="hidden" name="boxchecked" value="0">
-                <?php echo HTMLHelper::_('form.token'); ?>
-            </div>
-        </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(processed, total, chunkSize, token, bar, status) {
-        // Always offset=0: processed items are excluded by the IS NULL filter
-        fetch('index.php?option=com_mokoog&task=batch.process&format=json&limit=' + chunkSize + '&' + token + '=1')
-            .then(function(r) { return r.json(); })
-            .then(function(resp) {
-                processed += resp.data.created;
-                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 (resp.data.created > 0 && 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); ?> ' + processed + ' articles.';
-                    setTimeout(function() { location.reload(); }, 2000);
-                }
-            })
-            .catch(function(err) {
-                status.textContent = '<?php echo Text::_('COM_MOKOOG_BATCH_ERROR', true); ?> ' + err.message;
-            });
-    }
-});
-</script>

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

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

source/packages/index.html

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

source/packages/plg_content_mokoog/forms/index.html

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

source/packages/plg_content_mokoog/index.html

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

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

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

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

@@ -1,28 +0,0 @@
-; MokoJoomOpenGraph - Content Plugin Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-PLG_CONTENT_MOKOOG_FIELDSET_LABEL="Open Graph / Social Sharing"
-PLG_CONTENT_MOKOOG_FIELDSET_DESC="Configure how this content appears when shared on social media."
-
-PLG_CONTENT_MOKOOG_FIELD_OG_TITLE="OG Title"
-PLG_CONTENT_MOKOOG_FIELD_OG_TITLE_DESC="Custom title for social sharing. Leave blank to use the article title."
-PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION="OG Description"
-PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION_DESC="Custom description for social sharing. Leave blank to auto-generate from content."
-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."

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

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

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

@@ -1,28 +0,0 @@
-; MokoJoomOpenGraph - Content Plugin Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-PLG_CONTENT_MOKOOG_FIELDSET_LABEL="Open Graph / Social Sharing"
-PLG_CONTENT_MOKOOG_FIELDSET_DESC="Configure how this content appears when shared on social media."
-
-PLG_CONTENT_MOKOOG_FIELD_OG_TITLE="OG Title"
-PLG_CONTENT_MOKOOG_FIELD_OG_TITLE_DESC="Custom title for social sharing. Leave blank to use the article title."
-PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION="OG Description"
-PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION_DESC="Custom description for social sharing. Leave blank to auto-generate from content."
-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."

source/packages/plg_content_mokoog/language/index.html

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

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

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

source/packages/plg_content_mokoog/media/css/preview.css

@@ -1,104 +0,0 @@
-/**
- * @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;
-}

source/packages/plg_content_mokoog/media/index.html

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

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

@@ -1,20 +0,0 @@
-{
-    "$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"]
-        }
-    ]
-}

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

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

source/packages/plg_content_mokoog/media/js/preview.js

@@ -1,170 +0,0 @@
-/**
- * @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();
-});

source/packages/plg_content_mokoog/services/index.html

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

source/packages/plg_content_mokoog/src/Extension/index.html

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

source/packages/plg_content_mokoog/src/Field/index.html

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

source/packages/plg_content_mokoog/src/index.html

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

source/packages/plg_system_mokoog/index.html

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

source/packages/plg_system_mokoog/language/en-GB/index.html

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

source/packages/plg_system_mokoog/language/en-GB/plg_system_mokoog.ini

@@ -1,39 +0,0 @@
-; MokoJoomOpenGraph - System Plugin Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-PLG_SYSTEM_MOKOOG_FIELDSET_BASIC="Basic Settings"
-PLG_SYSTEM_MOKOOG_FIELDSET_ADVANCED="Advanced Settings"
-
-PLG_SYSTEM_MOKOOG_FIELD_SITE_NAME="Site Name"
-PLG_SYSTEM_MOKOOG_FIELD_SITE_NAME_DESC="The og:site_name value. Leave blank to use the Joomla site name."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_TITLE="Default OG Title"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_TITLE_DESC="Site-wide fallback title for social sharing. Used when a page has no custom OG title. Leave blank to use the page title."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_DESCRIPTION="Default OG Description"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_DESCRIPTION_DESC="Site-wide fallback description for social sharing. Used when a page has no custom OG description and no meta description. Leave blank to auto-generate from page content."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_IMAGE="Default Image"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_IMAGE_DESC="Fallback image used when no article or page image is found."
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_CARD="Twitter Card Type"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_CARD_DESC="The type of Twitter Card to generate."
-PLG_SYSTEM_MOKOOG_CARD_SUMMARY="Summary"
-PLG_SYSTEM_MOKOOG_CARD_SUMMARY_LARGE="Summary with Large Image"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_SITE="Twitter @username"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_SITE_DESC="Your site's Twitter handle (e.g. @mokoconsulting)."
-PLG_SYSTEM_MOKOOG_FIELD_FB_APP_ID="Facebook App ID"
-PLG_SYSTEM_MOKOOG_FIELD_FB_APP_ID_DESC="Your Facebook App ID for fb:app_id meta tag."
-PLG_SYSTEM_MOKOOG_FIELD_DISCORD_COLOR="Discord Embed Color"
-PLG_SYSTEM_MOKOOG_FIELD_DISCORD_COLOR_DESC="The color of the embed sidebar when shared on Discord. Sets the theme-color meta tag. Leave blank to use Discord defaults."
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_GENERATE="Auto-generate Tags"
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_GENERATE_DESC="Automatically generate OG tags from article content when no custom tags are set."
-PLG_SYSTEM_MOKOOG_FIELD_STRIP_HTML="Strip HTML from Description"
-PLG_SYSTEM_MOKOOG_FIELD_STRIP_HTML_DESC="Remove HTML tags from the auto-generated description."
-PLG_SYSTEM_MOKOOG_FIELD_DESC_LENGTH="Description Length"
-PLG_SYSTEM_MOKOOG_FIELD_DESC_LENGTH_DESC="Maximum character length for the auto-generated og:description."
-PLG_SYSTEM_MOKOOG_FIELD_TELEGRAM_CHANNEL="Telegram Channel"
-PLG_SYSTEM_MOKOOG_FIELD_TELEGRAM_CHANNEL_DESC="Your Telegram channel handle (e.g. @mokoconsulting). Outputs a telegram:channel meta tag for Telegram link previews."
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."

source/packages/plg_system_mokoog/language/en-US/index.html

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

source/packages/plg_system_mokoog/language/en-US/plg_system_mokoog.ini

@@ -1,39 +0,0 @@
-; MokoJoomOpenGraph - System Plugin Language File
-; Copyright (C) 2026 Moko Consulting. All rights reserved.
-; License: GPL-3.0-or-later
-
-PLG_SYSTEM_MOKOOG_FIELDSET_BASIC="Basic Settings"
-PLG_SYSTEM_MOKOOG_FIELDSET_ADVANCED="Advanced Settings"
-
-PLG_SYSTEM_MOKOOG_FIELD_SITE_NAME="Site Name"
-PLG_SYSTEM_MOKOOG_FIELD_SITE_NAME_DESC="The og:site_name value. Leave blank to use the Joomla site name."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_TITLE="Default OG Title"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_TITLE_DESC="Site-wide fallback title for social sharing. Used when a page has no custom OG title. Leave blank to use the page title."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_DESCRIPTION="Default OG Description"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_OG_DESCRIPTION_DESC="Site-wide fallback description for social sharing. Used when a page has no custom OG description and no meta description. Leave blank to auto-generate from page content."
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_IMAGE="Default Image"
-PLG_SYSTEM_MOKOOG_FIELD_DEFAULT_IMAGE_DESC="Fallback image used when no article or page image is found."
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_CARD="Twitter Card Type"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_CARD_DESC="The type of Twitter Card to generate."
-PLG_SYSTEM_MOKOOG_CARD_SUMMARY="Summary"
-PLG_SYSTEM_MOKOOG_CARD_SUMMARY_LARGE="Summary with Large Image"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_SITE="Twitter @username"
-PLG_SYSTEM_MOKOOG_FIELD_TWITTER_SITE_DESC="Your site's Twitter handle (e.g. @mokoconsulting)."
-PLG_SYSTEM_MOKOOG_FIELD_FB_APP_ID="Facebook App ID"
-PLG_SYSTEM_MOKOOG_FIELD_FB_APP_ID_DESC="Your Facebook App ID for fb:app_id meta tag."
-PLG_SYSTEM_MOKOOG_FIELD_DISCORD_COLOR="Discord Embed Color"
-PLG_SYSTEM_MOKOOG_FIELD_DISCORD_COLOR_DESC="The color of the embed sidebar when shared on Discord. Sets the theme-color meta tag. Leave blank to use Discord defaults."
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_GENERATE="Auto-generate Tags"
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_GENERATE_DESC="Automatically generate OG tags from article content when no custom tags are set."
-PLG_SYSTEM_MOKOOG_FIELD_STRIP_HTML="Strip HTML from Description"
-PLG_SYSTEM_MOKOOG_FIELD_STRIP_HTML_DESC="Remove HTML tags from the auto-generated description."
-PLG_SYSTEM_MOKOOG_FIELD_DESC_LENGTH="Description Length"
-PLG_SYSTEM_MOKOOG_FIELD_DESC_LENGTH_DESC="Maximum character length for the auto-generated og:description."
-PLG_SYSTEM_MOKOOG_FIELD_TELEGRAM_CHANNEL="Telegram Channel"
-PLG_SYSTEM_MOKOOG_FIELD_TELEGRAM_CHANNEL_DESC="Your Telegram channel handle (e.g. @mokoconsulting). Outputs a telegram:channel meta tag for Telegram link previews."
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
-PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
-PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."

source/packages/plg_system_mokoog/language/index.html

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

source/packages/plg_system_mokoog/services/index.html

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

source/packages/plg_system_mokoog/src/Extension/MokoOG.php

@@ -1,603 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomOpenGraph
- * @subpackage  plg_system_mokoog
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- */
-
-namespace Joomla\Plugin\System\MokoOG\Extension;
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\Factory;
-use Joomla\CMS\Plugin\CMSPlugin;
-use Joomla\CMS\Uri\Uri;
-use Joomla\Event\Event;
-use Joomla\Event\SubscriberInterface;
-use Joomla\Plugin\System\MokoOG\Helper\ImageHelper;
-use Joomla\Plugin\System\MokoOG\Helper\JsonLdBuilder;
-
-final class MokoOG extends CMSPlugin implements SubscriberInterface
-{
-    /**
-     * @var bool
-     */
-    protected $autoloadLanguage = true;
-
-    /**
-     * Returns the events this plugin subscribes to.
-     *
-     * @return  array<string, string>
-     */
-    public static function getSubscribedEvents(): array
-    {
-        return [
-            'onAfterRoute'        => 'onAfterRoute',
-            'onBeforeCompileHead' => 'onBeforeCompileHead',
-        ];
-    }
-
-    /**
-     * Run admin-side license key check after routing.
-     *
-     * @param   Event  $event  The event object
-     *
-     * @return  void
-     */
-    public function onAfterRoute(Event $event): void
-    {
-        $app = $this->getApplication();
-
-        if ($app->isClient('administrator')) {
-            $this->warnMissingLicenseKey();
-        }
-    }
-
-    /**
-     * Inject Open Graph and Twitter Card meta tags before the document head is compiled.
-     *
-     * @param   Event  $event  The event object
-     *
-     * @return  void
-     */
-    public function onBeforeCompileHead(Event $event): void
-    {
-        $app = $this->getApplication();
-
-        // Only run on the site frontend
-        if (!$app->isClient('site')) {
-            return;
-        }
-
-        $doc = $app->getDocument();
-
-        if ($doc->getType() !== 'html') {
-            return;
-        }
-
-        $input  = $app->getInput();
-        $option = $input->getCmd('option', '');
-        $view   = $input->getCmd('view', '');
-        $id     = $input->getInt('id', 0);
-
-        // Try to load custom OG data from the database
-        $ogData = $this->loadOgData($option, $view, $id);
-
-        // For category views, also try category-level OG data as fallback
-        if ($option === 'com_content' && $view === 'category' && $id > 0) {
-            $catOg = $this->loadOgDataByType('com_content.category', $id);
-
-            if ($catOg) {
-                // Merge: category fills any gaps in the content-level data
-                foreach (['og_title', 'og_description', 'og_image', 'og_type', 'seo_title', 'meta_description', 'robots', 'canonical_url'] as $field) {
-                    if (empty($ogData->$field) && !empty($catOg->$field)) {
-                        $ogData->$field = $catOg->$field;
-                    }
-                }
-            }
-        }
-
-        // --- SEO meta tags (set first, before OG) ---
-        $this->applySeoTags($doc, $ogData);
-
-        // Build tag values — custom OG data → site-wide defaults → auto-generated
-        $defaultTitle = $this->params->get('default_og_title', '');
-        $defaultDesc  = $this->params->get('default_og_description', '');
-
-        $title       = $ogData->og_title ?: ($doc->getTitle() ?: $defaultTitle);
-        $description = $ogData->og_description ?: ($this->buildDescription($doc) ?: $defaultDesc);
-        $image       = $ogData->og_image ?: $this->findImage($option, $view, $id);
-        $url         = Uri::getInstance()->toString();
-        $siteName    = $this->params->get('og_site_name', $app->get('sitename', ''));
-        $type        = $ogData->og_type ?: 'article';
-
-        // Open Graph tags
-        $doc->setMetaData('og:title', $title, 'property');
-        $doc->setMetaData('og:description', $description, 'property');
-        $doc->setMetaData('og:url', $url, 'property');
-        $doc->setMetaData('og:type', $type, 'property');
-        $doc->setMetaData('og:site_name', $siteName, 'property');
-
-        if ($image) {
-            $imageUrl = $this->resolveImageUrl($image);
-            $doc->setMetaData('og:image', $imageUrl, 'property');
-
-            // Emit actual image dimensions when detectable
-            $imageDims = $this->getImageDimensions($image);
-
-            if ($imageDims) {
-                $doc->setMetaData('og:image:width', (string) $imageDims[0], 'property');
-                $doc->setMetaData('og:image:height', (string) $imageDims[1], 'property');
-            }
-        }
-
-        // og:locale from current language
-        $langTag   = Factory::getLanguage()->getTag();
-        $ogLocale  = str_replace('-', '_', $langTag);
-        $doc->setMetaData('og:locale', $ogLocale, 'property');
-
-        // Facebook App ID
-        $fbAppId = $this->params->get('fb_app_id', '');
-
-        if ($fbAppId) {
-            $doc->setMetaData('fb:app_id', $fbAppId, 'property');
-        }
-
-        // Twitter Card tags
-        $cardType    = $this->params->get('twitter_card_type', 'summary_large_image');
-        $twitterSite = $this->params->get('twitter_site', '');
-
-        $doc->setMetaData('twitter:card', $cardType);
-        $doc->setMetaData('twitter:title', $title);
-        $doc->setMetaData('twitter:description', $description);
-
-        if ($image) {
-            $doc->setMetaData('twitter:image', $this->resolveImageUrl($image));
-        }
-
-        if ($twitterSite) {
-            $doc->setMetaData('twitter:site', $twitterSite);
-        }
-
-        // Telegram channel tag
-        $telegramChannel = $this->params->get('telegram_channel', '');
-
-        if ($telegramChannel) {
-            $doc->setMetaData('telegram:channel', $telegramChannel);
-        }
-
-        // Discord embed color (theme-color meta tag)
-        $discordColor = $this->params->get('discord_color', '');
-
-        if ($discordColor) {
-            $doc->setMetaData('theme-color', $discordColor);
-        }
-
-        // LinkedIn article tags
-        if ($option === 'com_content' && $view === 'article' && $id > 0) {
-            $doc->setMetaData('article:published_time', $this->getArticleDate($id, 'publish_up'), 'property');
-            $doc->setMetaData('article:modified_time', $this->getArticleDate($id, 'modified'), 'property');
-
-            $author = $this->getArticleAuthor($id);
-
-            if ($author) {
-                $doc->setMetaData('article:author', $author, 'property');
-            }
-        }
-
-        // Fire event so third-party plugins can add custom OG/social tags
-        $eventData = [
-            'subject' => $doc,
-            'title'   => $title,
-            'description' => $description,
-            'image'   => $image ? $this->resolveImageUrl($image) : '',
-            'url'     => $url,
-            'type'    => $type,
-            'option'  => $option,
-            'view'    => $view,
-            'id'      => $id,
-        ];
-        $app->getDispatcher()->dispatch('onMokoOGAfterRender', new Event('onMokoOGAfterRender', $eventData));
-
-        // JSON-LD structured data
-        if ($this->params->get('jsonld_enabled', 1)) {
-            $imageUrl  = $image ? $this->resolveImageUrl($image) : '';
-
-            if ($option === 'com_content' && $view === 'article' && $id > 0) {
-                $schema = JsonLdBuilder::buildArticle($id, $title, $description, $imageUrl);
-            } else {
-                $schema = JsonLdBuilder::buildWebPage($title, $description);
-            }
-
-            if ($schema) {
-                $doc->addCustomTag(JsonLdBuilder::toScriptTag($schema));
-            }
-
-            if ($this->params->get('jsonld_breadcrumbs', 1)) {
-                $breadcrumbs = JsonLdBuilder::buildBreadcrumbs();
-
-                if ($breadcrumbs) {
-                    $doc->addCustomTag(JsonLdBuilder::toScriptTag($breadcrumbs));
-                }
-            }
-        }
-    }
-
-    /**
-     * Apply SEO meta tags (title, description, robots, canonical) to the document.
-     *
-     * @param   \Joomla\CMS\Document\HtmlDocument  $doc     The document
-     * @param   object                              $ogData  The loaded OG/SEO data
-     *
-     * @return  void
-     */
-    private function applySeoTags($doc, object $ogData): void
-    {
-        // Custom SEO title overrides the page <title>
-        if (!empty($ogData->seo_title)) {
-            $doc->setTitle($ogData->seo_title);
-        }
-
-        // Custom meta description
-        if (!empty($ogData->meta_description)) {
-            $doc->setDescription($ogData->meta_description);
-        }
-
-        // Robots directive
-        if (!empty($ogData->robots)) {
-            $doc->setMetaData('robots', $ogData->robots);
-        }
-
-        // Canonical URL
-        if (!empty($ogData->canonical_url)) {
-            // Remove any existing canonical link first
-            foreach ($doc->_links as $link => $attribs) {
-                if (isset($attribs['relation']) && $attribs['relation'] === 'canonical') {
-                    unset($doc->_links[$link]);
-                }
-            }
-
-            $doc->addHeadLink($ogData->canonical_url, 'canonical');
-        }
-    }
-
-    /**
-     * Load custom OG data from the database for the current page.
-     *
-     * @param   string  $option  Component option
-     * @param   string  $view    View name
-     * @param   int     $id      Content ID
-     *
-     * @return  object
-     */
-    private function loadOgData(string $option, string $view, int $id): object
-    {
-        $empty = (object) [
-            'og_title'         => '',
-            'og_description'   => '',
-            'og_image'         => '',
-            'og_type'          => '',
-            'seo_title'        => '',
-            'meta_description' => '',
-            'robots'           => '',
-            'canonical_url'    => '',
-        ];
-
-        if (!$id) {
-            // Try menu-item-based lookup
-            $menuItem = $this->getApplication()->getMenu()->getActive();
-
-            if (!$menuItem) {
-                return $empty;
-            }
-
-            return $this->loadOgDataByMenu((int) $menuItem->id) ?: $empty;
-        }
-
-        $db    = Factory::getDbo();
-        $query = $db->getQuery(true)
-            ->select('*')
-            ->from($db->quoteName('#__mokoog_tags'))
-            ->where($db->quoteName('content_type') . ' = ' . $db->quote($option))
-            ->where($db->quoteName('content_id') . ' = ' . (int) $id)
-            ->where($db->quoteName('published') . ' = 1')
-            ->where('(' . $db->quoteName('language') . ' = ' . $db->quote(Factory::getLanguage()->getTag())
-                . ' OR ' . $db->quoteName('language') . ' = ' . $db->quote('*') . ')')
-            ->order('CASE WHEN ' . $db->quoteName('language') . ' = ' . $db->quote('*') . ' THEN 1 ELSE 0 END ASC');
-
-        $db->setQuery($query, 0, 1);
-
-        return $db->loadObject() ?: $empty;
-    }
-
-    /**
-     * Load OG data by content type and ID.
-     *
-     * @param   string  $contentType  Content type identifier
-     * @param   int     $contentId    Content ID
-     *
-     * @return  object|null
-     */
-    private function loadOgDataByType(string $contentType, int $contentId): ?object
-    {
-        $db    = Factory::getDbo();
-        $query = $db->getQuery(true)
-            ->select('*')
-            ->from($db->quoteName('#__mokoog_tags'))
-            ->where($db->quoteName('content_type') . ' = ' . $db->quote($contentType))
-            ->where($db->quoteName('content_id') . ' = ' . $contentId)
-            ->where($db->quoteName('published') . ' = 1');
-
-        $db->setQuery($query);
-
-        return $db->loadObject();
-    }
-
-    /**
-     * Load OG data by menu item ID.
-     *
-     * @param   int  $menuId  Menu item ID
-     *
-     * @return  object|null
-     */
-    private function loadOgDataByMenu(int $menuId): ?object
-    {
-        $db    = Factory::getDbo();
-        $query = $db->getQuery(true)
-            ->select('*')
-            ->from($db->quoteName('#__mokoog_tags'))
-            ->where($db->quoteName('content_type') . ' = ' . $db->quote('menu'))
-            ->where($db->quoteName('content_id') . ' = ' . $menuId)
-            ->where($db->quoteName('published') . ' = 1');
-
-        $db->setQuery($query);
-
-        return $db->loadObject();
-    }
-
-    /**
-     * Build a description from the document metadata or page content.
-     *
-     * @param   \Joomla\CMS\Document\HtmlDocument  $doc  The document
-     *
-     * @return  string
-     */
-    private function buildDescription($doc): string
-    {
-        $description = $doc->getDescription();
-        $maxLength   = (int) $this->params->get('desc_length', 160);
-
-        if ($this->params->get('strip_html', 1)) {
-            $description = strip_tags($description);
-        }
-
-        $description = trim(preg_replace('/\s+/', ' ', $description));
-
-        if (mb_strlen($description) > $maxLength) {
-            $description = mb_substr($description, 0, $maxLength - 3) . '...';
-        }
-
-        return $description;
-    }
-
-    /**
-     * Attempt to find the first image for the given content.
-     *
-     * @param   string  $option  Component option
-     * @param   string  $view    View name
-     * @param   int     $id      Content ID
-     *
-     * @return  string
-     */
-    private function findImage(string $option, string $view, int $id): string
-    {
-        if (!$this->params->get('auto_generate', 1)) {
-            return $this->params->get('default_image', '');
-        }
-
-        // For Joomla articles, look at the intro/full image fields
-        if ($option === 'com_content' && $id > 0) {
-            $db    = Factory::getDbo();
-            $query = $db->getQuery(true)
-                ->select($db->quoteName('images'))
-                ->from($db->quoteName('#__content'))
-                ->where($db->quoteName('id') . ' = ' . (int) $id);
-
-            $db->setQuery($query);
-            $images = $db->loadResult();
-
-            if ($images) {
-                $imagesData = json_decode($images, true);
-
-                if (!empty($imagesData['image_fulltext'])) {
-                    return $imagesData['image_fulltext'];
-                }
-
-                if (!empty($imagesData['image_intro'])) {
-                    return $imagesData['image_intro'];
-                }
-            }
-
-            // Fallback: check the article's category for an image
-            if ($view === 'article') {
-                $catQuery = $db->getQuery(true)
-                    ->select($db->quoteName('cat.params'))
-                    ->from($db->quoteName('#__categories', 'cat'))
-                    ->join('INNER', $db->quoteName('#__content', 'a') . ' ON ' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('cat.id'))
-                    ->where($db->quoteName('a.id') . ' = ' . (int) $id);
-
-                $db->setQuery($catQuery);
-                $catParams = $db->loadResult();
-
-                if ($catParams) {
-                    $catData = json_decode($catParams, true);
-
-                    if (!empty($catData['image'])) {
-                        return $catData['image'];
-                    }
-                }
-            }
-        }
-
-        return $this->params->get('default_image', '');
-    }
-
-    /**
-     * Resolve a relative image path to a full URL, resizing for OG if needed.
-     *
-     * @param   string  $image  Image path
-     *
-     * @return  string
-     */
-    private function resolveImageUrl(string $image): string
-    {
-        if (str_starts_with($image, 'http://') || str_starts_with($image, 'https://')) {
-            return $image;
-        }
-
-        // Auto-resize to OG recommended dimensions if enabled
-        if ($this->params->get('auto_resize', 1)) {
-            $image = ImageHelper::resize($image);
-        }
-
-        return rtrim(Uri::root(), '/') . '/' . ltrim($image, '/');
-    }
-
-    /**
-     * Get a date field from an article.
-     *
-     * @param   int     $id     Article ID
-     * @param   string  $field  Date field name (publish_up, modified, created)
-     *
-     * @return  string  ISO 8601 date string
-     */
-    private function getArticleDate(int $id, string $field): string
-    {
-        $db    = Factory::getDbo();
-        $query = $db->getQuery(true)
-            ->select($db->quoteName($field))
-            ->from($db->quoteName('#__content'))
-            ->where($db->quoteName('id') . ' = ' . $id);
-
-        $db->setQuery($query);
-        $date = $db->loadResult();
-
-        return $date ?: '';
-    }
-
-    /**
-     * Get the author name for an article.
-     *
-     * @param   int  $id  Article ID
-     *
-     * @return  string
-     */
-    private function getArticleAuthor(int $id): string
-    {
-        $db    = Factory::getDbo();
-        $query = $db->getQuery(true)
-            ->select($db->quoteName('u.name'))
-            ->from($db->quoteName('#__content', 'a'))
-            ->join('LEFT', $db->quoteName('#__users', 'u') . ' ON ' . $db->quoteName('u.id') . ' = ' . $db->quoteName('a.created_by'))
-            ->where($db->quoteName('a.id') . ' = ' . $id);
-
-        $db->setQuery($query);
-
-        return $db->loadResult() ?: '';
-    }
-
-    /**
-     * Warn administrators once per session when no license key is configured.
-     *
-     * @return  void
-     */
-    private function warnMissingLicenseKey(): void
-    {
-        $session = Factory::getSession();
-
-        if ($session->get('mokoog.license_warned', false)) {
-            return;
-        }
-
-        $user = Factory::getUser();
-
-        if ($user->guest || !$user->authorise('core.manage')) {
-            return;
-        }
-
-        try {
-            $db = Factory::getDbo();
-
-            $query = $db->getQuery(true)
-                ->select($db->quoteName('extra_query'))
-                ->from($db->quoteName('#__update_sites'))
-                ->where($db->quoteName('name') . ' = ' . $db->quote('MokoJoomOpenGraph Updates'))
-                ->setLimit(1);
-            $db->setQuery($query);
-            $extraQuery = (string) $db->loadResult();
-
-            // Mark as checked only after the DB query succeeds
-            $session->set('mokoog.license_warned', true);
-
-            if (!empty($extraQuery)) {
-                parse_str($extraQuery, $parsed);
-
-                if (!empty($parsed['dlid']) && preg_match('/^MOKO-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/', $parsed['dlid'])) {
-                    return;
-                }
-            }
-
-            $this->getApplication()->enqueueMessage(
-                '<strong>Moko Consulting License Key Required</strong> — '
-                . 'No download key is configured. Updates will not be available until a valid license key is entered. '
-                . 'Go to <a href="index.php?option=com_installer&view=updatesites">System → Update Sites</a> '
-                . 'and enter your license key (<code>MOKO-XXXX-XXXX-XXXX-XXXX</code>) in the Download Key field '
-                . 'for the MokoJoomOpenGraph update site.',
-                'warning'
-            );
-        } catch (\Throwable $e) {
-            // Don't break admin over a license check
-        }
-    }
-
-    /**
-     * Get the actual pixel dimensions of a local image.
-     *
-     * Returns [width, height] or null for external URLs or unreadable images.
-     *
-     * @param   string  $image  Image path (relative or absolute URL)
-     *
-     * @return  array{0: int, 1: int}|null
-     */
-    private function getImageDimensions(string $image): ?array
-    {
-        // Cannot determine dimensions for external URLs
-        if (str_starts_with($image, 'http://') || str_starts_with($image, 'https://')) {
-            return null;
-        }
-
-        // If auto-resize is on, the resized image lives in the generated dir
-        if ($this->params->get('auto_resize', 1)) {
-            $resolved = ImageHelper::resize($image);
-        } else {
-            $resolved = $image;
-        }
-
-        $absPath = JPATH_ROOT . '/' . ltrim($resolved, '/');
-
-        if (!is_file($absPath)) {
-            return null;
-        }
-
-        $info = @getimagesize($absPath);
-
-        if (!$info) {
-            return null;
-        }
-
-        return [$info[0], $info[1]];
-    }
-}

source/packages/plg_system_mokoog/src/Extension/index.html

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