Compare commits

..

38 Commits

Author SHA1 Message Date
jmiller aa4e254f0b chore: sync pr-metadata-check.yml from Template-Joomla 2026-06-28 07:47:38 +00:00
jmiller 9147790214 chore: sync SECURITY.md from Template-Joomla 2026-06-28 07:46:12 +00:00
jmiller 3e51d8c439 chore: sync GOVERNANCE.md from Template-Joomla 2026-06-28 07:42:40 +00:00
jmiller 750f769a13 chore: sync CONTRIBUTING.md from Template-Joomla 2026-06-28 07:40:55 +00:00
jmiller 981464ee4e chore: sync CODE_OF_CONDUCT.md from Template-Joomla 2026-06-28 07:37:50 +00:00
jmiller 7afcc8e6b9 chore: sync composer.json from Template-Joomla 2026-06-28 07:35:50 +00:00
jmiller e47fdf8722 chore: sync phpstan.neon from Template-Joomla 2026-06-28 07:34:31 +00:00
jmiller 872abec8bc chore: sync .editorconfig from Template-Joomla 2026-06-28 07:33:59 +00:00
jmiller 6cc08927e7 chore: sync ci-generic.yml from Template-Generic [skip ci] 2026-06-27 20:44:50 +00:00
jmiller ed715b5db8 chore: sync rc-revert.yml from Template-Generic [skip ci] 2026-06-27 05:32:30 +00:00
jmiller 5d02db24d5 chore: sync pre-release.yml from Template-Generic [skip ci] 2026-06-27 00:49:26 +00:00
jmiller e6ade9033d chore: sync repo-health.yml from Template-Generic [skip ci] 2026-06-25 19:47:01 +00:00
jmiller 76845f78f2 chore: sync pr-check.yml from Template-Generic [skip ci] 2026-06-25 19:47:00 +00:00
jmiller b68d3f6481 chore: sync ci-issue-reporter.yml from Template-Generic [skip ci] 2026-06-25 19:46:59 +00:00
jmiller 3110d7eb75 chore: sync workflow-sync-trigger.yml from Template-Generic [skip ci] 2026-06-25 17:11:55 +00:00
jmiller e285b8e770 chore: sync version-set.yml from Template-Generic [skip ci] 2026-06-25 17:11:54 +00:00
jmiller 0997a875d6 chore: sync repo-health.yml from Template-Generic [skip ci] 2026-06-25 17:11:54 +00:00
jmiller baf67e18e6 chore: sync pre-release.yml from Template-Generic [skip ci] 2026-06-25 17:11:53 +00:00
jmiller cf6b1286b5 chore: sync pr-check.yml from Template-Generic [skip ci] 2026-06-25 17:11:53 +00:00
jmiller c1f560704b chore: sync issue-branch.yml from Template-Generic [skip ci] 2026-06-25 17:11:52 +00:00
jmiller 52edde00c9 chore: sync deploy-manual.yml from Template-Generic [skip ci] 2026-06-25 17:11:51 +00:00
jmiller 759af6b237 chore: sync cleanup.yml from Template-Generic [skip ci] 2026-06-25 17:11:51 +00:00
jmiller e0112d770a chore: sync auto-release.yml from Template-Generic [skip ci] 2026-06-25 17:11:50 +00:00
jmiller 5544878cf2 chore: sync auto-bump.yml from Template-Generic [skip ci] 2026-06-25 17:11:49 +00:00
jmiller bd551bffda chore: sync version-set.yml from Template-Generic [skip ci] 2026-06-24 11:51:16 +00:00
jmiller 48eeb9631f chore: sync auto-release.yml from Template-Generic [skip ci] 2026-06-24 11:51:14 +00:00
jmiller 2e3331170f chore: remove security-audit.yml -- handled by MokoGitea 2026-06-23 18:27:30 +00:00
jmiller 4699686f26 chore: sync deploy-manual.yml from Template-Generic [skip ci] 2026-06-23 17:51:20 +00:00
jmiller a7fe881d84 chore: remove deprecated .mokogitea/workflows/composer-publish.yml [skip ci] 2026-06-23 17:37:50 +00:00
jmiller ab02de34f4 chore: remove deprecated .mokogitea/workflows/update-server.yml [skip ci] 2026-06-23 17:37:47 +00:00
jmiller 64d9a97db1 chore: remove deprecated .mokogitea/workflows/deploy-manual.yml [skip ci] 2026-06-23 17:37:44 +00:00
jmiller 3ba1c3ead4 chore: sync repo-health.yml from Template-Generic [skip ci] 2026-06-23 16:05:23 +00:00
jmiller 4c091805ee chore: sync pr-check.yml from Template-Generic [skip ci] 2026-06-23 16:05:22 +00:00
jmiller 0d4e7785a3 chore: sync issue-branch.yml from Template-Generic [skip ci] 2026-06-23 16:05:21 +00:00
jmiller 6f13a10a34 chore: sync auto-bump.yml from Template-Generic [skip ci] 2026-06-23 16:05:18 +00:00
gitea-actions[bot] 5f1e44e66b chore: promote changelog [Unreleased] → [01.04.00] 2026-06-23 16:04:28 +00:00
gitea-actions[bot] 646dd23e81 chore(release): build 01.04.00 [skip ci]
Publish to Composer / Publish Package (release) Successful in 27s
2026-06-23 16:04:22 +00:00
jmiller d4229fd450 Merge pull request 'feat: v1.3 — multi-platform social tags, editor UX, video support' (#82) from dev into main 2026-06-23 16:03:30 +00:00
57 changed files with 790 additions and 3459 deletions
-1
View File
@@ -156,7 +156,6 @@ vendor/
composer.lock
*.phar
codeception.phar
.phpunit.cache/
.phpunit.result.cache
.php_cs.cache
.php-cs-fixer.cache
+1 -1
View File
@@ -22,7 +22,7 @@ on:
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
permissions:
contents: write
+12 -11
View File
@@ -27,7 +27,7 @@ name: "Universal: Build & Release"
on:
pull_request:
types: [opened, closed]
types: [opened, synchronize, closed]
branches:
- main
paths-ignore:
@@ -52,7 +52,7 @@ on:
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_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 }}
@@ -66,6 +66,7 @@ jobs:
runs-on: release
if: >-
(github.event.action == 'opened' && github.event.pull_request.merged != true) ||
(github.event.action == 'synchronize' && github.event.pull_request.merged != true) ||
(github.event_name == 'workflow_dispatch' && inputs.action == 'promote-rc')
steps:
@@ -101,7 +102,7 @@ jobs:
php ${MOKO_CLI}/branch_rename.php \
--from "${{ github.event.pull_request.head.ref || 'dev' }}" --to rc \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--api-base "${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}" \
--api-base "${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}" \
--pr "${{ github.event.pull_request.number }}"
- name: Checkout rc and configure git
@@ -120,7 +121,7 @@ jobs:
- name: Update RC release notes from CHANGELOG.md
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
# Extract [Unreleased] section from changelog
@@ -268,7 +269,7 @@ jobs:
!startsWith(steps.platform.outputs.platform, 'joomla')
run: |
VERSION="${{ steps.version.outputs.version }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
SEMVER_TAG="v${VERSION}"
@@ -293,7 +294,7 @@ jobs:
- name: Update release notes and promote changelog
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
# Get the stable release info (version and ID)
@@ -362,7 +363,7 @@ jobs:
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
GH_REPO="${{ vars.GH_MIRROR_REPO || github.repository }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php ${MOKO_CLI}/release_mirror.php \
--version "$VERSION" --tag "$RELEASE_TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
@@ -391,7 +392,7 @@ jobs:
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
# Delete rc branch (ephemeral — created by promote-rc)
@@ -415,7 +416,7 @@ jobs:
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
BRANCH_NAME="version/${VERSION}"
@@ -436,7 +437,7 @@ jobs:
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
API_BASE="${MOKOGITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php ${MOKO_CLI}/version_reset_dev.php \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "${API_BASE}" \
--branch dev --path . 2>&1 || true
@@ -462,5 +463,5 @@ jobs:
echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Branch | \`${{ steps.version.outputs.branch }}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Tag | \`${{ steps.version.outputs.tag }}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Release | [View](${GITEA_URL}/${GITEA_ORG}/${GITEA_REPO}/releases/tag/${{ steps.version.outputs.tag }}) |" >> $GITHUB_STEP_SUMMARY
echo "| Release | [View](${MOKOGITEA_URL}/${GITEA_ORG}/${GITEA_REPO}/releases/tag/${{ steps.version.outputs.tag }}) |" >> $GITHUB_STEP_SUMMARY
fi
+6
View File
@@ -13,6 +13,12 @@
name: "Generic: Project CI"
on:
pull_request:
branches:
- main
- dev
- dev/**
- rc/**
workflow_dispatch:
permissions:
+68 -1
View File
@@ -1 +1,68 @@
IyBDb3B5cmlnaHQgKEMpIDIwMjYgTW9rbyBDb25zdWx0aW5nIDxoZWxsb0Btb2tvY29uc3VsdGluZy50ZWNoPgojCiMgU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEdQTC0zLjAtb3ItbGF0ZXIKIwojIEZJTEUgSU5GT1JNQVRJT04KIyBERUZHUk9VUDogR2l0ZWEuV29ya2Zsb3cKIyBJTkdST1VQOiBtb2tvY2xpLlVuaXZlcnNhbAojIFJFUE86IGh0dHBzOi8vZ2l0Lm1va29jb25zdWx0aW5nLnRlY2gvTW9rb0NvbnN1bHRpbmcvbW9rb2NsaQojIFBBVEg6IC8ubW9rb2dpdGVhL3dvcmtmbG93cy9jaS1pc3N1ZS1yZXBvcnRlci55bWwKIyBWRVJTSU9OOiAwMS4wMC4wMAojIEJSSUVGOiBSZXVzYWJsZSB3b3JrZmxvdyDigJQgY3JlYXRlcy91cGRhdGVzIGEgR2l0ZWEgaXNzdWUgd2hlbiBhIENJIGdhdGUgZmFpbHMuCiMgICAgICAgIENsb25lcyBNb2tvQ0xJIGFuZCBydW5zIGNsaS9jaV9pc3N1ZV9yZXBvcnRlci5zaC4KCm5hbWU6ICJVbml2ZXJzYWw6IENJIElzc3VlIFJlcG9ydGVyIgoKb246CiAgd29ya2Zsb3dfY2FsbDoKICAgIGlucHV0czoKICAgICAgZ2F0ZToKICAgICAgICBkZXNjcmlwdGlvbjogIkNJIGdhdGUgbmFtZSAoZS5nLiBQUiBWYWxpZGF0aW9uLCBSZXBvc2l0b3J5IEhlYWx0aCkiCiAgICAgICAgcmVxdWlyZWQ6IHRydWUKICAgICAgICB0eXBlOiBzdHJpbmcKICAgICAgZGV0YWlsczoKICAgICAgICBkZXNjcmlwdGlvbjogIkh1bWFuLXJlYWRhYmxlIGZhaWx1cmUgZGVzY3JpcHRpb24iCiAgICAgICAgcmVxdWlyZWQ6IHRydWUKICAgICAgICB0eXBlOiBzdHJpbmcKICAgICAgc2V2ZXJpdHk6CiAgICAgICAgZGVzY3JpcHRpb246ICJlcnJvciBvciB3YXJuaW5nIgogICAgICAgIHJlcXVpcmVkOiBmYWxzZQogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGRlZmF1bHQ6ICJlcnJvciIKICAgICAgd29ya2Zsb3c6CiAgICAgICAgZGVzY3JpcHRpb246ICJXb3JrZmxvdyBuYW1lIGZvciB0aGUgaXNzdWUgdGl0bGUiCiAgICAgICAgcmVxdWlyZWQ6IGZhbHNlCiAgICAgICAgdHlwZTogc3RyaW5nCiAgICAgICAgZGVmYXVsdDogIiIKICAgIHNlY3JldHM6CiAgICAgIE1PS09HSVRFQV9UT0tFTjoKICAgICAgICByZXF1aXJlZDogdHJ1ZQoKZW52OgogIEZPUkNFX0pBVkFTQ1JJUFRfQUNUSU9OU19UT19OT0RFMjQ6IHRydWUKCmpvYnM6CiAgcmVwb3J0OgogICAgbmFtZTogIlJlcG9ydDogJHt7IGlucHV0cy5nYXRlIH19IgogICAgcnVucy1vbjogdWJ1bnR1LWxhdGVzdAoKICAgIHN0ZXBzOgogICAgICAtIG5hbWU6IENsb25lIE1va29DTEkKICAgICAgICBlbnY6CiAgICAgICAgICBNT0tPR0lURUFfVE9LRU46ICR7eyBzZWNyZXRzLk1PS09HSVRFQV9UT0tFTiB9fQogICAgICAgIHJ1bjogfAogICAgICAgICAgTU9LT0dJVEVBX1VSTD0iJHt7IHZhcnMuR0lURUFfVVJMIHx8ICdodHRwczovL2dpdC5tb2tvY29uc3VsdGluZy50ZWNoJyB9fSIKICAgICAgICAgIGdpdCBjbG9uZSAtLWRlcHRoIDEgLS1maWx0ZXI9YmxvYjpub25lIC0tc3BhcnNlICIke01PS09HSVRFQV9VUkx9L01va29Db25zdWx0aW5nL01va29DTEkuZ2l0IiAvdG1wL21va29jbGkKICAgICAgICAgIGNkIC90bXAvbW9rb2NsaSAmJiBnaXQgc3BhcnNlLWNoZWNrb3V0IHNldCBjbGkvY2lfaXNzdWVfcmVwb3J0ZXIuc2gKCiAgICAgIC0gbmFtZTogUmVwb3J0IENJIGZhaWx1cmUKICAgICAgICBlbnY6CiAgICAgICAgICBNT0tPR0lURUFfVE9LRU46ICR7eyBzZWNyZXRzLk1PS09HSVRFQV9UT0tFTiB9fQogICAgICAgICAgTU9LT0dJVEVBX1VSTDogJHt7IHZhcnMuR0lURUFfVVJMIHx8ICdodHRwczovL2dpdC5tb2tvY29uc3VsdGluZy50ZWNoJyB9fQogICAgICAgIHJ1bjogfAogICAgICAgICAgY2htb2QgK3ggL3RtcC9tb2tvY2xpL2NsaS9jaV9pc3N1ZV9yZXBvcnRlci5zaAogICAgICAgICAgL3RtcC9tb2tvY2xpL2NsaS9jaV9pc3N1ZV9yZXBvcnRlci5zaCBcCiAgICAgICAgICAgIC0tZ2F0ZSAiJHt7IGlucHV0cy5nYXRlIH19IiBcCiAgICAgICAgICAgIC0tZGV0YWlscyAiJHt7IGlucHV0cy5kZXRhaWxzIH19IiBcCiAgICAgICAgICAgIC0tc2V2ZXJpdHkgIiR7eyBpbnB1dHMuc2V2ZXJpdHkgfX0iIFwKICAgICAgICAgICAgLS13b3JrZmxvdyAiJHt7IGlucHV0cy53b3JrZmxvdyB9fSIK
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: mokocli.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# PATH: /.mokogitea/workflows/ci-issue-reporter.yml
# VERSION: 01.00.00
# BRIEF: Reusable workflow — creates/updates a Gitea issue when a CI gate fails.
# Clones MokoCLI and runs cli/ci_issue_reporter.sh.
name: "Universal: CI Issue Reporter"
on:
workflow_call:
inputs:
gate:
description: "CI gate name (e.g. PR Validation, Repository Health)"
required: true
type: string
details:
description: "Human-readable failure description"
required: true
type: string
severity:
description: "error or warning"
required: false
type: string
default: "error"
workflow:
description: "Workflow name for the issue title"
required: false
type: string
default: ""
secrets:
MOKOGITEA_TOKEN:
required: true
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
jobs:
report:
name: "Report: ${{ inputs.gate }}"
runs-on: ubuntu-latest
steps:
- name: Clone MokoCLI
env:
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
MOKOGITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
git clone --depth 1 --filter=blob:none --sparse "${MOKOGITEA_URL}/MokoConsulting/MokoCLI.git" /tmp/mokocli
cd /tmp/mokocli && git sparse-checkout set cli/ci_issue_reporter.sh
- name: Report CI failure
env:
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
run: |
chmod +x /tmp/mokocli/cli/ci_issue_reporter.sh
/tmp/mokocli/cli/ci_issue_reporter.sh \
--gate "${{ inputs.gate }}" \
--details "${{ inputs.details }}" \
--severity "${{ inputs.severity }}" \
--workflow "${{ inputs.workflow }}"
+10 -10
View File
@@ -21,7 +21,7 @@ permissions:
contents: write
env:
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
jobs:
cleanup:
@@ -33,17 +33,17 @@ jobs:
uses: actions/checkout@v4
with:
fetch-depth: 0
token: ${{ secrets.GA_TOKEN }}
token: ${{ secrets.MOKOGITEA_TOKEN }}
- name: Delete merged branches
env:
GA_TOKEN: ${{ secrets.GA_TOKEN }}
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
echo "=== Merged Branch Cleanup ==="
API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
API="${MOKOGITEA_URL}/api/v1/repos/${{ github.repository }}"
# List branches via API
BRANCHES=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
BRANCHES=$(curl -sS -H "Authorization: token ${MOKOGITEA_TOKEN}" \
"${API}/branches?limit=50" | jq -r '.[].name')
DELETED=0
@@ -56,7 +56,7 @@ jobs:
# Check if branch is merged into main
if git merge-base --is-ancestor "origin/${BRANCH}" origin/main 2>/dev/null; then
echo " Deleting merged branch: ${BRANCH}"
curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
curl -sS -X DELETE -H "Authorization: token ${MOKOGITEA_TOKEN}" \
"${API}/branches/${BRANCH}" 2>/dev/null || true
DELETED=$((DELETED + 1))
fi
@@ -66,20 +66,20 @@ jobs:
- name: Clean old workflow runs
env:
GA_TOKEN: ${{ secrets.GA_TOKEN }}
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
echo "=== Workflow Run Cleanup ==="
API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
API="${MOKOGITEA_URL}/api/v1/repos/${{ github.repository }}"
CUTOFF=$(date -d "30 days ago" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -v-30d +%Y-%m-%dT%H:%M:%SZ)
# Get old completed runs
RUNS=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
RUNS=$(curl -sS -H "Authorization: token ${MOKOGITEA_TOKEN}" \
"${API}/actions/runs?status=completed&limit=50" | \
jq -r ".workflow_runs[] | select(.created_at < \"${CUTOFF}\") | .id" 2>/dev/null)
DELETED=0
for RUN_ID in $RUNS; do
curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
curl -sS -X DELETE -H "Authorization: token ${MOKOGITEA_TOKEN}" \
"${API}/actions/runs/${RUN_ID}" 2>/dev/null || true
DELETED=$((DELETED + 1))
done
-76
View File
@@ -1,76 +0,0 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
# SPDX-License-Identifier: GPL-3.0-or-later
name: "Publish to Composer"
on:
push:
tags:
- 'v*'
- '[0-9]*.[0-9]*.[0-9]*'
release:
types: [published]
workflow_dispatch:
env:
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
jobs:
publish:
name: Publish Package
runs-on: ubuntu-latest
if: >-
!contains(github.event.head_commit.message, '[skip ci]') &&
!contains(github.event.head_commit.message, '[skip publish]')
steps:
- name: Checkout
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
- name: Install dependencies
run: composer install --no-dev --no-interaction --prefer-dist --quiet
- name: Determine version
id: version
run: |
VERSION=$(php -r "echo json_decode(file_get_contents('composer.json'))->version;")
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
echo "Package version: ${VERSION}"
# Gitea Composer Registry — auto-publishes from tags
# The tag push itself registers the package at:
# https://git.mokoconsulting.tech/api/packages/MokoConsulting/composer
- name: Verify Gitea registry
run: |
echo "Gitea Composer registry auto-publishes from tags."
echo "Package available at: ${GITEA_URL}/api/packages/MokoConsulting/composer"
echo "Install: composer require mokoconsulting/mokocli"
# Packagist — notify of new version
- name: Notify Packagist
if: secrets.PACKAGIST_TOKEN != ''
run: |
VERSION="${{ steps.version.outputs.version }}"
echo "Notifying Packagist of version ${VERSION}..."
curl -sf -X POST \
-H "Content-Type: application/json" \
-d '{"repository":{"url":"https://git.mokoconsulting.tech/MokoConsulting/mokocli"}}' \
"https://packagist.org/api/update-package?username=mokoconsulting&apiToken=${{ secrets.PACKAGIST_TOKEN }}" \
&& echo "Packagist notified" \
|| echo "::warning::Packagist notification failed (package may not be registered yet)"
- name: Summary
run: |
VERSION="${{ steps.version.outputs.version }}"
echo "## Composer Package Published" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "| Registry | Status |" >> $GITHUB_STEP_SUMMARY
echo "|----------|--------|" >> $GITHUB_STEP_SUMMARY
echo "| Gitea | \`composer require mokoconsulting/mokocli:${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Packagist | \`composer require mokoconsulting/mokocli\` |" >> $GITHUB_STEP_SUMMARY
+126
View File
@@ -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:
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || github.token }}
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || github.token }}
MOKO_CLONE_HOST: ${{ secrets.MOKOGITEA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.MOKOGITEA_TOKEN || github.token }}"}}'
run: |
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
/tmp/mokostandards-api 2>/dev/null || true
if [ -d "/tmp/mokostandards-api" ] && [ -f "/tmp/mokostandards-api/composer.json" ]; then
cd /tmp/mokostandards-api && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
fi
- name: Check FTP configuration
id: check
env:
HOST: ${{ vars.DEV_FTP_HOST }}
PATH_VAR: ${{ vars.DEV_FTP_PATH }}
PORT: ${{ vars.DEV_FTP_PORT }}
run: |
if [ -z "$HOST" ] || [ -z "$PATH_VAR" ]; then
echo "DEV_FTP_HOST or DEV_FTP_PATH not configured -- cannot deploy"
echo "skip=true" >> "$GITHUB_OUTPUT"
exit 0
fi
echo "skip=false" >> "$GITHUB_OUTPUT"
echo "host=$HOST" >> "$GITHUB_OUTPUT"
REMOTE="${PATH_VAR%/}"
echo "remote=$REMOTE" >> "$GITHUB_OUTPUT"
[ -z "$PORT" ] && PORT="22"
echo "port=$PORT" >> "$GITHUB_OUTPUT"
- name: Deploy via SFTP
if: steps.check.outputs.skip != 'true'
env:
SFTP_KEY: ${{ secrets.DEV_FTP_KEY }}
SFTP_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
SFTP_USER: ${{ vars.DEV_FTP_USERNAME }}
run: |
SOURCE_DIR="src"
[ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
[ ! -d "$SOURCE_DIR" ] && { echo "No src/ or htdocs/ -- nothing to deploy"; exit 0; }
printf '{"host":"%s","port":%s,"username":"%s","remotePath":"%s"' \
"${{ steps.check.outputs.host }}" "${{ steps.check.outputs.port }}" "$SFTP_USER" "${{ steps.check.outputs.remote }}" \
> /tmp/sftp-config.json
if [ -n "$SFTP_KEY" ]; then
echo "$SFTP_KEY" > /tmp/deploy_key
chmod 600 /tmp/deploy_key
printf ',"privateKeyPath":"/tmp/deploy_key"}' >> /tmp/sftp-config.json
else
printf ',"password":"%s"}' "$SFTP_PASS" >> /tmp/sftp-config.json
fi
DEPLOY_ARGS=(--path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json)
[ "${{ inputs.clear_remote }}" = "true" ] && DEPLOY_ARGS+=(--clear-remote)
PLATFORM=$(php /tmp/mokostandards-api/cli/platform_detect.php --path . 2>/dev/null || true)
if [ "$PLATFORM" = "waas-component" ] && [ -f "/tmp/mokostandards-api/deploy/deploy-joomla.php" ]; then
php /tmp/mokostandards-api/deploy/deploy-joomla.php "${DEPLOY_ARGS[@]}"
else
php /tmp/mokostandards-api/deploy/deploy-sftp.php "${DEPLOY_ARGS[@]}"
fi
rm -f /tmp/deploy_key /tmp/sftp-config.json
- name: Summary
if: always()
run: |
if [ "${{ steps.check.outputs.skip }}" = "true" ]; then
echo "### Deploy Skipped -- FTP not configured" >> $GITHUB_STEP_SUMMARY
else
echo "### Manual Dev Deploy Complete" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
echo "| Host | \`${{ steps.check.outputs.host }}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Remote | \`${{ steps.check.outputs.remote }}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Clear | ${{ inputs.clear_remote }} |" >> $GITHUB_STEP_SUMMARY
fi
+5 -5
View File
@@ -5,7 +5,7 @@
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: mokocli.Automation
# VERSION: 01.04.11
# VERSION: 01.00.00
# BRIEF: Auto-create feature branch when an issue is opened
name: "Universal: Issue Branch"
@@ -19,7 +19,7 @@ permissions:
issues: write
env:
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
jobs:
create-branch:
@@ -28,8 +28,8 @@ jobs:
steps:
- name: Create branch and comment
run: |
TOKEN="${{ secrets.GA_TOKEN }}"
API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
API="${MOKOGITEA_URL}/api/v1/repos/${{ github.repository }}"
ISSUE_NUM="${{ github.event.issue.number }}"
ISSUE_TITLE="${{ github.event.issue.title }}"
@@ -58,7 +58,7 @@ jobs:
echo "Created branch: ${BRANCH}"
# Comment on issue with branch link
REPO_URL="${GITEA_URL}/${{ github.repository }}"
REPO_URL="${MOKOGITEA_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 \
+9 -22
View File
@@ -496,39 +496,26 @@ jobs:
steps:
- name: Trigger RC pre-release
env:
GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
REPO: ${{ github.repository }}
BRANCH: ${{ github.head_ref }}
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
run: |
curl -s -X POST "${GITEA_URL}/api/v1/repos/${REPO}/actions/workflows/pre-release.yml/dispatches" -H "Authorization: token ${GITEA_TOKEN}" -H "Content-Type: application/json" -d "{\"ref\":\"${BRANCH}\",\"inputs\":{\"stability\":\"release-candidate\"}}"
curl -s -X POST "${MOKOGITEA_URL}/api/v1/repos/${REPO}/actions/workflows/pre-release.yml/dispatches" -H "Authorization: token ${MOKOGITEA_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
# ── Issue Reporter ──────────────────────────────────────────────────────
report-issues:
name: Report Issues
runs-on: ubuntu-latest
needs: [branch-policy, validate]
if: >-
always() &&
needs.validate.result == 'failure'
steps:
- name: Checkout
uses: actions/checkout@v4
uses: ./.mokogitea/workflows/ci-issue-reporter.yml
with:
sparse-checkout: automation/ci-issue-reporter.sh
sparse-checkout-cone-mode: false
- name: "File issue for PR validation failure"
env:
GITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
run: |
chmod +x automation/ci-issue-reporter.sh
./automation/ci-issue-reporter.sh \
--gate "PR Validation" \
--workflow "PR Check" \
--severity error \
--details "PR validation failed (syntax, manifest, changelog, or source checks). See the CI run for the specific check that failed."
gate: "PR Validation"
workflow: "PR Check"
severity: error
details: "PR validation failed (syntax, manifest, changelog, or source checks). See the CI run for the specific check that failed."
secrets: inherit
+4 -4
View File
@@ -20,7 +20,7 @@ permissions:
contents: read
env:
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
MOKOGITEA_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 }}
@@ -55,14 +55,14 @@ jobs:
- name: Validate metadata against Joomla manifest
env:
GITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
php ${MOKO_CLI}/joomla_metadata_validate.php \
--path . \
--token "${GITEA_TOKEN}" \
--token "${MOKOGITEA_TOKEN}" \
--org "${GITEA_ORG}" \
--repo "${GITEA_REPO}" \
--api-base "${GITEA_URL}/api/v1" \
--api-base "${MOKOGITEA_URL}/api/v1" \
--ci
if [ $? -ne 0 ]; then
+6 -1
View File
@@ -7,7 +7,7 @@
# INGROUP: mokocli.Release
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# PATH: /templates/workflows/universal/pre-release.yml.template
# VERSION: 05.01.00
# VERSION: 05.02.00
# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches
name: "Universal: Pre-Release"
@@ -59,6 +59,11 @@ jobs:
fetch-depth: 0
token: ${{ secrets.MOKOGITEA_TOKEN }}
ref: ${{ github.ref_name }}
submodules: recursive
- name: Update submodules to main
run: |
git submodule foreach --quiet 'git checkout main && git pull --quiet origin main' 2>/dev/null || true
- name: Setup mokocli tools
env:
+18 -13
View File
@@ -29,12 +29,20 @@ jobs:
steps:
- name: Rename branch
env:
BRANCH: ${{ github.event.pull_request.head.ref }}
REPO: ${{ github.repository }}
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
BRANCH="${{ github.event.pull_request.head.ref }}"
set -euo pipefail
# BRANCH is attacker-controlled (PR head ref). Strict allowlist before ANY use.
if ! printf '%s' "$BRANCH" | grep -Eq '^rc/[A-Za-z0-9._/-]+$'; then
echo "::error::Refusing unsafe branch name: $BRANCH"; exit 1
fi
SUFFIX="${BRANCH#rc/}"
DEV_BRANCH="dev/${SUFFIX}"
API="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}/api/v1/repos/${{ github.repository }}/branches"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
API="${GITEA_URL}/api/v1/repos/${REPO}/branches"
# Create dev/ branch from rc/ branch
STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X POST \
@@ -42,25 +50,22 @@ jobs:
-H "Content-Type: application/json" \
-d "{\"new_branch_name\": \"${DEV_BRANCH}\", \"old_branch_name\": \"${BRANCH}\"}" \
"${API}" 2>/dev/null || true)
if [ "$STATUS" = "201" ]; then
echo "Created branch: ${DEV_BRANCH}" >> $GITHUB_STEP_SUMMARY
echo "Created branch: ${DEV_BRANCH}" >> "$GITHUB_STEP_SUMMARY"
else
echo "::error::Failed to create ${DEV_BRANCH} from ${BRANCH} (HTTP ${STATUS})"
exit 1
echo "::error::Failed to create ${DEV_BRANCH} from ${BRANCH} (HTTP ${STATUS})"; exit 1
fi
# Delete rc/ branch
ENCODED=$(php -r "echo rawurlencode('${BRANCH}');")
# Read BRANCH from the environment inside PHP (getenv, no string interpolation -> no PHP injection)
ENCODED=$(php -r 'echo rawurlencode(getenv("BRANCH"));')
STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X DELETE \
-H "Authorization: token ${TOKEN}" \
"${API}/${ENCODED}" 2>/dev/null || true)
if [ "$STATUS" = "204" ]; then
echo "Deleted branch: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
echo "Deleted branch: ${BRANCH}" >> "$GITHUB_STEP_SUMMARY"
else
echo "::warning::Failed to delete ${BRANCH} (HTTP ${STATUS})"
fi
echo "### RC Reverted" >> $GITHUB_STEP_SUMMARY
echo "${BRANCH} → ${DEV_BRANCH}" >> $GITHUB_STEP_SUMMARY
echo "### RC Reverted" >> "$GITHUB_STEP_SUMMARY"
echo "${BRANCH} → ${DEV_BRANCH}" >> "$GITHUB_STEP_SUMMARY"
+24 -36
View File
@@ -77,7 +77,7 @@ jobs:
- name: Check actor permission (admin only)
id: perm
env:
TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
TOKEN: ${{ secrets.MOKOGITEA_TOKEN || github.token }}
REPO: ${{ github.repository }}
ACTOR: ${{ github.actor }}
run: |
@@ -671,42 +671,30 @@ jobs:
# ═══════════════════════════════════════════════════════════════════════
# Issue Reporter — file issues for failed gates
# ═══════════════════════════════════════════════════════════════════════
report-issues:
name: "Report Issues"
runs-on: ubuntu-latest
needs: [access_check, scripts_governance, repo_health]
report-scripts:
name: "Report: Scripts Governance"
needs: [access_check, scripts_governance]
if: >-
always() &&
(needs.scripts_governance.result == 'failure' ||
needs.repo_health.result == 'failure')
steps:
- name: Checkout
uses: actions/checkout@v4
needs.scripts_governance.result == 'failure'
uses: ./.mokogitea/workflows/ci-issue-reporter.yml
with:
sparse-checkout: automation/ci-issue-reporter.sh
sparse-checkout-cone-mode: false
gate: "Scripts Governance"
workflow: "Repo Health"
severity: error
details: "Scripts directory policy violations detected. Review required and allowed directories."
secrets: inherit
- name: "File issues for failed gates"
env:
GITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
run: |
chmod +x automation/ci-issue-reporter.sh
REPORTER="./automation/ci-issue-reporter.sh"
WF="Repo Health"
report_gate() {
local gate="$1" result="$2" details="$3"
if [ "$result" = "failure" ]; then
"$REPORTER" --gate "$gate" --details "$details" --workflow "$WF" --severity error
fi
}
report_gate "Scripts Governance" \
"${{ needs.scripts_governance.result }}" \
"Scripts directory policy violations detected. Review required and allowed directories."
report_gate "Repository Health" \
"${{ needs.repo_health.result }}" \
"Repository health checks failed — missing required artifacts, disallowed files, or content warnings. Check the CI run summary."
report-health:
name: "Report: Repository Health"
needs: [access_check, repo_health]
if: >-
always() &&
needs.repo_health.result == 'failure'
uses: ./.mokogitea/workflows/ci-issue-reporter.yml
with:
gate: "Repository Health"
workflow: "Repo Health"
severity: error
details: "Repository health checks failed — missing required artifacts, disallowed files, or content warnings. Check the CI run summary."
secrets: inherit
-312
View File
@@ -1,312 +0,0 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /templates/workflows/update-server.yml
# VERSION: 05.00.00
# BRIEF: Pre-release build + update server XML for dev/alpha/beta/rc branches
#
# Thin wrapper around moko-platform CLI tools.
# Builds packages, updates updates.xml, and optionally deploys via SFTP.
#
# Joomla filters update entries by the user's "Minimum Stability" setting.
name: "Update Server"
on:
push:
branches:
- 'dev'
- 'dev/**'
- 'alpha/**'
- 'beta/**'
- 'rc/**'
paths:
- 'src/**'
- 'htdocs/**'
pull_request:
types: [closed]
branches:
- 'dev'
- 'dev/**'
- 'alpha/**'
- 'beta/**'
- 'rc/**'
paths:
- 'src/**'
- 'htdocs/**'
workflow_dispatch:
inputs:
stability:
description: 'Stability tag'
required: true
default: 'development'
type: choice
options:
- development
- alpha
- beta
- rc
- stable
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
permissions:
contents: write
jobs:
update-xml:
name: Update Server
runs-on: release
if: >-
github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch' || github.event_name == 'push'
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 0
- name: Setup moko-platform tools
env:
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
COMPOSER_AUTH: '{"http-basic":{"git.mokoconsulting.tech":{"username":"token","password":"${{ secrets.MOKOGITEA_TOKEN }}"}}}'
run: |
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
# Always fetch latest CLI tools — never use stale cache from previous runs
rm -rf /tmp/moko-platform
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
/tmp/moko-platform 2>/dev/null || true
if [ -d "/tmp/moko-platform" ] && [ -f "/tmp/moko-platform/composer.json" ]; then
cd /tmp/moko-platform && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
fi
echo "MOKO_CLI=/tmp/moko-platform/cli" >> "$GITHUB_ENV"
- name: Detect platform
id: platform
run: php ${MOKO_CLI}/manifest_read.php --path . --github-output
- name: Resolve stability and bump version
id: meta
run: |
BRANCH="${{ github.ref_name }}"
# Configure git for bot pushes
git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "gitea-actions[bot]"
git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
# Auto-bump patch version
php ${MOKO_CLI}/version_bump.php --path . 2>/dev/null || true
VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "0.0.0")
# Strip any existing suffix before applying stability
VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
# Determine stability from branch or manual input
if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
STABILITY="${{ inputs.stability }}"
elif [[ "$BRANCH" == rc/* ]]; then
STABILITY="rc"
elif [[ "$BRANCH" == beta/* ]]; then
STABILITY="beta"
elif [[ "$BRANCH" == alpha/* ]]; then
STABILITY="alpha"
else
STABILITY="development"
fi
# Version suffix per stability stream
case "$STABILITY" in
development) SUFFIX="-dev"; TAG="development" ;;
alpha) SUFFIX="-alpha"; TAG="alpha" ;;
beta) SUFFIX="-beta"; TAG="beta" ;;
rc) SUFFIX="-rc"; TAG="release-candidate" ;;
*) SUFFIX=""; TAG="stable" ;;
esac
# Propagate version with stability suffix to all manifest files
php ${MOKO_CLI}/version_set_platform.php \
--path . --version "$VERSION" --branch "$BRANCH" --stability "$STABILITY" 2>/dev/null || true
php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
# Re-read version (now includes suffix from version_set_platform)
if [ -n "$SUFFIX" ]; then
VERSION="${VERSION}${SUFFIX}"
fi
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
echo "display_version=${VERSION}" >> "$GITHUB_OUTPUT"
# Commit version bump if changed
git add -A
git diff --cached --quiet || {
git commit -m "chore(version): auto-bump ${VERSION} [skip ci]" \
--author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
git push
}
- name: Create release and upload package
id: package
run: |
VERSION="${{ steps.meta.outputs.version }}"
TAG="${{ steps.meta.outputs.tag }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
# Create or update Gitea release
php ${MOKO_CLI}/release_create.php \
--path . --version "$VERSION" --tag "$TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease
# Build package and upload
php ${MOKO_CLI}/release_package.php \
--path . --version "$VERSION" --tag "$TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--repo "${GITEA_REPO}" --output /tmp || true
- name: Update updates.xml
if: steps.platform.outputs.platform == 'joomla'
run: |
VERSION="${{ steps.meta.outputs.version }}"
STABILITY="${{ steps.meta.outputs.stability }}"
SHA256="${{ steps.package.outputs.sha256_zip }}"
if [ ! -f "updates.xml" ]; then
echo "No updates.xml — skipping"
exit 0
fi
SHA_FLAG=""
[ -n "$SHA256" ] && SHA_FLAG="--sha ${SHA256}"
php ${MOKO_CLI}/updates_xml_build.php \
--path . --version "${VERSION}" --stability "${STABILITY}" \
--gitea-url "${GITEA_URL}" --org "${GITEA_ORG}" --repo "${GITEA_REPO}" \
${SHA_FLAG}
# Commit and push updates.xml
git add updates.xml
git diff --cached --quiet || {
git commit -m "chore: update ${STABILITY} channel ${VERSION} [skip ci]"
git push
}
- name: Sync updates.xml to main
if: github.ref_name != 'main' && steps.platform.outputs.platform == 'joomla'
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
GITEA_TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
FILE_SHA=$(curl -sf -H "Authorization: token ${GITEA_TOKEN}" \
"${API_BASE}/contents/updates.xml?ref=main" | python3 -c "import sys,json; print(json.load(sys.stdin).get('sha',''))" 2>/dev/null || true)
if [ -n "$FILE_SHA" ] && [ -f "updates.xml" ]; then
python3 -c "
import base64, json, urllib.request, sys
with open('updates.xml', 'rb') as f:
content = base64.b64encode(f.read()).decode()
payload = json.dumps({
'content': content,
'sha': '${FILE_SHA}',
'message': 'chore: sync updates.xml from ${{ steps.meta.outputs.stability }} [skip ci]',
'branch': 'main'
}).encode()
req = urllib.request.Request(
'${API_BASE}/contents/updates.xml',
data=payload, method='PUT',
headers={
'Authorization': 'token ${GITEA_TOKEN}',
'Content-Type': 'application/json'
})
try:
urllib.request.urlopen(req)
print('updates.xml synced to main')
except Exception as e:
print(f'WARNING: sync to main failed: {e}', file=sys.stderr)
"
fi
- name: SFTP deploy to dev server
if: contains(github.ref, 'dev/') || github.ref == 'refs/heads/dev'
env:
DEV_HOST: ${{ vars.DEV_FTP_HOST }}
DEV_PATH: ${{ vars.DEV_FTP_PATH }}
DEV_SUFFIX: ${{ vars.DEV_FTP_SUFFIX }}
DEV_USER: ${{ vars.DEV_FTP_USERNAME }}
DEV_PORT: ${{ vars.DEV_FTP_PORT }}
DEV_KEY: ${{ secrets.DEV_FTP_KEY }}
DEV_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
run: |
# Permission check: admin or maintain role required
ACTOR="${{ github.actor }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
PERMISSION=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
"${API_BASE}/collaborators/${ACTOR}/permission" 2>/dev/null | \
python3 -c "import sys,json; print(json.load(sys.stdin).get('permission','read'))" 2>/dev/null || echo "read")
case "$PERMISSION" in
admin|maintain|write) ;;
*)
echo "Deploy denied: ${ACTOR} has '${PERMISSION}' — requires admin, maintain, or write"
exit 0
;;
esac
[ -z "$DEV_HOST" ] || [ -z "$DEV_PATH" ] && { echo "DEV FTP not configured — skipping SFTP"; exit 0; }
SOURCE_DIR="src"
[ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
[ ! -d "$SOURCE_DIR" ] && exit 0
PORT="${DEV_PORT:-22}"
REMOTE="${DEV_PATH%/}"
[ -n "$DEV_SUFFIX" ] && REMOTE="${REMOTE}/${DEV_SUFFIX#/}"
printf '{"host":"%s","port":%s,"username":"%s","remotePath":"%s"' \
"$DEV_HOST" "$PORT" "$DEV_USER" "$REMOTE" > /tmp/sftp-config.json
if [ -n "$DEV_KEY" ]; then
echo "$DEV_KEY" > /tmp/deploy_key && chmod 600 /tmp/deploy_key
printf ',"privateKeyPath":"/tmp/deploy_key"}' >> /tmp/sftp-config.json
else
printf ',"password":"%s"}' "$DEV_PASS" >> /tmp/sftp-config.json
fi
PLATFORM=$(php ${MOKO_CLI}/platform_detect.php --path . 2>/dev/null || true)
if [ "$PLATFORM" = "waas-component" ] && [ -f "${MOKO_CLI}/../deploy/deploy-joomla.php" ]; then
php ${MOKO_CLI}/../deploy/deploy-joomla.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
elif [ -f "${MOKO_CLI}/../deploy/deploy-sftp.php" ]; then
php ${MOKO_CLI}/../deploy/deploy-sftp.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
fi
rm -f /tmp/deploy_key /tmp/sftp-config.json
echo "SFTP deploy to dev complete" >> $GITHUB_STEP_SUMMARY
- name: Summary
if: always()
run: |
VERSION="${{ steps.meta.outputs.version }}"
STABILITY="${{ steps.meta.outputs.stability }}"
DISPLAY="${{ steps.meta.outputs.display_version }}"
echo "## Update Server" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
echo "| Stability | \`${STABILITY}\` |" >> $GITHUB_STEP_SUMMARY
echo "| Version | \`${DISPLAY}\` |" >> $GITHUB_STEP_SUMMARY
File diff suppressed because one or more lines are too long
+12 -4
View File
@@ -13,6 +13,7 @@
name: "Universal: Workflow Sync Trigger"
on:
workflow_dispatch:
pull_request:
types: [closed]
branches:
@@ -26,8 +27,9 @@ jobs:
name: Sync workflows to live repos
runs-on: ubuntu-latest
if: >-
github.event.pull_request.merged == true &&
!contains(github.event.pull_request.title, '[skip sync]')
github.event_name == 'workflow_dispatch' ||
(github.event.pull_request.merged == true &&
!contains(github.event.pull_request.title, '[skip sync]'))
steps:
- name: Determine platform from repo name
@@ -49,8 +51,14 @@ jobs:
env:
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
GITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
git clone --depth 1 "${GITEA_URL}/MokoConsulting/mokocli.git" /tmp/mokocli
MOKOGITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
git clone --depth 1 "${MOKOGITEA_URL}/MokoConsulting/mokocli.git" /tmp/mokocli
- name: Install PHP
run: |
if ! command -v php &> /dev/null; then
apt-get update -qq && apt-get install -y -qq php-cli php-json php-curl > /dev/null 2>&1
fi
- name: Install dependencies
run: |
+7 -27
View File
@@ -1,12 +1,17 @@
# Changelog
<!-- VERSION: 01.04.11 -->
## [Unreleased]
## [01.04.00] --- 2026-06-23
<!-- VERSION: 01.04.00 -->
All notable changes to MokoSuiteOpenGraph will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [Unreleased]
## [01.04.00] --- 2026-06-23
### Security
- Fix JSON-LD XSS vulnerability via `</script>` injection in content data (#34)
@@ -20,21 +25,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
- LinkedIn social preview card in article/menu editor alongside Facebook and Twitter/X previews (#61)
- `og:video` meta tag support with per-article video URL field, auto-detect MIME type for YouTube/Vimeo/direct files (#59)
- Pinterest rich pin tags: `article:tag` from Joomla content tags, `product:availability` from MokoSuiteShop stock (#60)
- FAQ JSON-LD schema with auto-detection from article h3/h4 headings (#62)
- HowTo JSON-LD schema with auto-detection from ordered lists (#63)
- Event JSON-LD schema with per-article event fields (dates, venue, tickets) (#64)
- LocalBusiness JSON-LD schema with global plugin configuration (#65)
- Recipe JSON-LD schema with per-article fields (times, ingredients, nutrition) (#66)
- VideoObject JSON-LD schema for articles with video URLs (#67)
- SEO content scoring panel with 7 checks and pass/fail indicators (#68)
- Discord, Mastodon, and Slack social preview cards in editor (#69)
- Custom JSON-LD schema builder — per-article textarea for any schema.org type (#70)
- AI-powered meta tag generation with Claude and OpenAI API support (#71)
- XML sitemap generation on article save, respects noindex directives (#72)
- OG coverage dashboard in tag manager with coverage percentage (#73)
- Per-platform image resizing: Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400 (#74)
- PHPUnit test suite with 16 unit tests for JsonLdBuilder (#75)
- OpenAPI 3.0 specification for REST API (#80)
- Site-wide default OG title and description plugin parameters
- Discord embed color via `theme-color` meta tag (color picker in plugin config)
- LinkedIn article tags: `article:published_time`, `article:modified_time`, `article:author`
@@ -60,16 +50,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
- Facebook App ID and Telegram channel support
- Database table `#__mokoog_tags` with multilingual unique key
### Fixed
- Add exception logging to BatchController batch skip (#76)
- Align form maxlength attributes with DB schema limits (#77)
- Add `strip_tags()` input sanitization on OG text fields (#79)
- Only emit `og:video:secure_url` for HTTPS URLs
- Only emit `og:video:width/height` for direct files, not embeds
- Consolidate duplicate MokoSuiteShop product blocks
- Fix stale `com_virtuemart` reference in SQL comment
- Use component language keys for og_video field in tag.xml
### Changed
- Consolidated article DB queries into single cached lookup — 5 queries reduced to 1 (#38)
- Dynamic `og:image:width`/`og:image:height` from actual image dimensions instead of hardcoded (#39)
+36 -18
View File
@@ -1,28 +1,46 @@
# Code of Conduct
<!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
This file is part of a Moko Consulting project.
SPDX-LICENSE-IDENTIFIER: GPL-3.0-or-later
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License (./LICENSE).
# FILE INFORMATION
DEFGROUP: Template-Joomla
INGROUP: Template-Joomla.Documentation
REPO: https://github.com/mokoconsulting-tech/Template-Joomla/
VERSION: 01.01.00
PATH: ./CODE_OF_CONDUCT.md
BRIEF: Community expectations and enforcement guidelines
NOTE: Adapted with attribution from the Contributor Covenant v2.1
-->
# Contributor Covenant 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.
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone.
## Our Standards
- Be empathetic and kind
- Be respectful of differing opinions
- Accept constructive feedback
- Own mistakes and learn from them
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
Unacceptable behavior includes sexualized language/imagery, trolling, harassment, doxing, and other inappropriate conduct.
## Enforcement
Report incidents to **hello@mokoconsulting.tech** or through GitHub Discussions if you prefer a community-visible approach. Private complaints will be reviewed promptly and fairly.
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.
## Enforcement Guidelines
1. **Correction** — Private warning
2. **Warning** — Formal warning and limited interaction
3. **Temporary Ban** — Time-boxed exclusion
4. **Permanent Ban** — Removal from the community
## Attribution
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.
Adapted from the Contributor Covenant v2.1.
+149 -22
View File
@@ -1,34 +1,161 @@
# Contributing to MokoJoomOpenGraph
# Contributing to Moko Consulting Projects
Thank you for your interest in contributing to MokoJoomOpenGraph.
Thank you for your interest in contributing. All Moko Consulting repositories follow this universal workflow and version policy.
## Getting Started
## Branching Workflow
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`
```
feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge──> main
```
## Branch Strategy
### Step by step
- `main` — stable releases only
- `dev` — active development
- `feature/*` — new features (target `dev`)
- `fix/*` — bug fixes (target `dev`)
- `hotfix/*` — urgent fixes (target `dev` or `main`)
1. **Create a feature branch** from `dev`:
```bash
git checkout dev && git pull
git checkout -b feature/my-change
```
## Coding Standards
2. **Work and commit** on your feature branch. Push to origin.
- 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
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
Report bugs and feature requests via [Issues](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomOpenGraph/issues).
Use the repository's issue tracker with the appropriate template.
## License
---
By contributing, you agree that your contributions will be licensed under GPL-3.0-or-later.
*Moko Consulting <hello@mokoconsulting.tech>*
+119 -1
View File
File diff suppressed because one or more lines are too long
+3 -19
View File
@@ -1,6 +1,6 @@
# MokoSuiteOpenGraph
<!-- VERSION: 01.04.11 -->
<!-- VERSION: 01.04.00 -->
Open Graph, Twitter Card, and social sharing meta tag management for Joomla 4/5/6.
@@ -16,9 +16,6 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
- **LinkedIn** — `article:published_time`, `article:modified_time`, `article:author`
- **Discord** — Custom embed color via `theme-color` meta tag
- **Telegram** — `telegram:channel` for link previews
- **Mastodon/Fediverse** — `fediverse:creator` for author attribution (first extension on any CMS)
- **Pinterest** — Rich pin tags: `article:tag`, `product:availability`, `product:price`
- **og:video** — Per-article video URLs with auto MIME type detection (YouTube/Vimeo/direct)
- **Facebook** — `fb:app_id` support, `og:image:width`/`og:image:height` for instant previews
### Content Management
@@ -34,8 +31,7 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
- **Meta description** — Per-page meta description control
- **Robots directive** — Per-page noindex/nofollow settings
- **Canonical URL** — Custom canonical URL overrides
- **JSON-LD structured data** — Article, Product, WebPage, BreadcrumbList, Organization, FAQ, HowTo, Event, Recipe, LocalBusiness, VideoObject, and custom schemas
- **SEO content scoring** — 7-check analysis panel with pass/fail indicators in the editor
- **JSON-LD structured data** — Article, Product, WebPage, BreadcrumbList, Organization schemas
### Admin Tools
- **Tag manager dashboard** — View and manage all OG records centrally
@@ -43,20 +39,13 @@ MokoSuiteOpenGraph gives you full control over how your Joomla content appears w
- **CSV import/export** — Bulk manage OG data via CSV files
- **SEO health badges** — Visual indicators for missing descriptions, long titles, noindex
- **Debug links** — Quick links to Facebook Debugger, LinkedIn Inspector, Google Rich Results
- **Live preview** — Real-time Facebook, Twitter/X, LinkedIn, Discord, Mastodon, and Slack card previews in the editor
- **Character count indicators** — Green/yellow/red warnings on OG and SEO text fields
- **OG coverage dashboard** — Coverage percentage and missing field counts
- **AI meta generation** — Generate OG titles and descriptions with Claude or OpenAI
- **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`)
- **MokoSuiteShop integration** — Auto-generated OG/JSON-LD for product pages with pricing meta
- **Plugin event** — `onMokoOGAfterRender` for third-party plugins to add custom social tags
- **OG image generator** — Text overlay on template backgrounds with auto-resize to 1200x630
- **Per-platform image resizing** — Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400
- **XML sitemap** — Auto-generates sitemap.xml on article save, respects noindex
- **OpenAPI spec** — Full REST API documentation at `openapi.yaml`
- **PHPUnit tests** — 16 unit tests for JsonLdBuilder schema outputs
## Installation
@@ -74,11 +63,6 @@ Navigate to **Extensions → Plugins → System - MokoSuiteOpenGraph** to config
- Facebook App ID
- Discord embed color
- Telegram channel
- Fediverse/Mastodon creator handle
- LocalBusiness schema (address, phone, hours, geo)
- XML sitemap generation
- AI meta generation (Claude/OpenAI API key)
- Per-platform image resizing
- Auto-generation, image resize, JSON-LD, and description length settings
## License
+1 -1
View File
@@ -23,7 +23,7 @@ DEFGROUP: Template-Joomla
INGROUP: Template-Joomla.Documentation
REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Joomla
PATH: /SECURITY.md
VERSION: 01.04.11
VERSION: 01.01.00
BRIEF: Security vulnerability reporting and handling policy
-->
+5 -19
View File
@@ -1,6 +1,6 @@
{
"name": "mokoconsulting/mokoog",
"description": "Open Graph, Twitter Card, and social sharing meta tag management for Joomla",
"name": "mokoconsulting/mokojoomgallery",
"description": "Photo gallery management for Joomla — galleries, images, thumbnails, lightbox, and frontend display",
"type": "joomla-package",
"version": "01.00.00",
"license": "GPL-3.0-or-later",
@@ -15,25 +15,11 @@
"php": ">=8.1"
},
"require-dev": {
"joomla/coding-standards": "^3.0",
"squizlabs/php_codesniffer": "^3.7",
"phpstan/phpstan": "^1.10",
"phpunit/phpunit": "^10.5",
"squizlabs/php_codesniffer": "^3.7"
"joomla/coding-standards": "3.0.x-dev"
},
"autoload": {
"psr-4": {
"Joomla\\Plugin\\System\\MokoOG\\": "source/packages/plg_system_mokoog/src/",
"Joomla\\Plugin\\Content\\MokoOG\\": "source/packages/plg_content_mokoog/src/",
"Joomla\\Plugin\\WebServices\\MokoOG\\": "source/packages/plg_webservices_mokoog/src/",
"Joomla\\Component\\MokoOG\\Administrator\\": "source/packages/com_mokoog/src/"
}
},
"autoload-dev": {
"psr-4": {
"Mokoconsulting\\MokoOG\\Tests\\": "tests/"
}
},
"minimum-stability": "alpha",
"minimum-stability": "dev",
"prefer-stable": true,
"config": {
"sort-packages": true
-668
View File
@@ -1,668 +0,0 @@
openapi: 3.0.3
info:
title: MokoSuiteOpenGraph API
version: 1.0.0
description: |
REST API for managing Open Graph, SEO meta, and structured-data tags in
Joomla via the MokoSuiteOpenGraph extension.
The API follows Joomla's Web Services conventions and returns responses in
[JSON:API](https://jsonapi.org/) format. All endpoints require
authentication via a Joomla API token.
contact:
name: Moko Consulting
email: hello@mokoconsulting.tech
license:
name: GPL-3.0-or-later
url: https://www.gnu.org/licenses/gpl-3.0.html
servers:
- url: /api/index.php/v1
description: Joomla Web Services API
security:
- apiToken: []
tags:
- name: Tags
description: CRUD operations for Open Graph tag records
paths:
/mokoog/tags:
get:
operationId: listTags
summary: List OG tags
description: |
Returns a paginated collection of OG tag records. Supports filtering
by content type, published state, and language.
tags: [Tags]
parameters:
- name: "filter[content_type]"
in: query
description: Filter by content type (e.g. `com_content`, `menu`, `com_mokoshop`)
schema:
type: string
example: com_content
- name: "filter[content_id]"
in: query
description: Filter by content ID
schema:
type: integer
example: 42
- name: "filter[published]"
in: query
description: Filter by published state
schema:
type: integer
enum: [0, 1]
- name: "filter[language]"
in: query
description: Filter by language tag (e.g. `en-GB`, `*`)
schema:
type: string
example: "*"
- name: "filter[search]"
in: query
description: Free-text search across tag fields
schema:
type: string
- name: "page[offset]"
in: query
description: Number of records to skip (pagination offset)
schema:
type: integer
minimum: 0
default: 0
- name: "page[limit]"
in: query
description: Maximum number of records to return
schema:
type: integer
minimum: 1
maximum: 100
default: 25
- name: "list[fullordering]"
in: query
description: Sort order for results
schema:
type: string
enum:
- a.id ASC
- a.id DESC
- a.og_title ASC
- a.og_title DESC
- a.modified ASC
- a.modified DESC
default: a.modified DESC
responses:
"200":
description: A JSON:API collection of OG tags
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/TagCollection"
example:
links:
self: "/api/index.php/v1/mokoog/tags"
data:
- type: tags
id: "1"
attributes:
content_type: com_content
content_id: 42
og_title: "My Article Title"
og_description: "A brief description for social sharing."
og_image: "images/mokoog/og-banner.jpg"
og_type: article
seo_title: "My Article | Example Site"
meta_description: "A brief meta description for search engines."
robots: "index, follow"
canonical_url: "https://example.com/my-article"
language: "*"
published: 1
created: "2026-06-01T12:00:00+00:00"
modified: "2026-06-15T08:30:00+00:00"
meta:
total-pages: 1
"401":
$ref: "#/components/responses/Unauthorized"
post:
operationId: createTag
summary: Create an OG tag
description: |
Creates a new OG tag record. The combination of `content_type`,
`content_id`, and `language` must be unique.
tags: [Tags]
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/TagCreateRequest"
example:
content_type: com_content
content_id: 42
og_title: "My Article Title"
og_description: "A brief description for social sharing."
og_image: "images/mokoog/og-banner.jpg"
og_type: article
language: "*"
published: 1
responses:
"200":
description: The created tag
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/TagDocument"
example:
links:
self: "/api/index.php/v1/mokoog/tags/1"
data:
type: tags
id: "1"
attributes:
content_type: com_content
content_id: 42
og_title: "My Article Title"
og_description: "A brief description for social sharing."
og_image: "images/mokoog/og-banner.jpg"
og_type: article
seo_title: ""
meta_description: ""
robots: ""
canonical_url: ""
language: "*"
published: 1
created: "2026-06-23T10:00:00+00:00"
modified: "2026-06-23T10:00:00+00:00"
"400":
$ref: "#/components/responses/BadRequest"
"401":
$ref: "#/components/responses/Unauthorized"
/mokoog/tags/{id}:
parameters:
- $ref: "#/components/parameters/TagId"
get:
operationId: getTag
summary: Get a single OG tag
tags: [Tags]
responses:
"200":
description: A single OG tag resource
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/TagDocument"
example:
links:
self: "/api/index.php/v1/mokoog/tags/1"
data:
type: tags
id: "1"
attributes:
content_type: com_content
content_id: 42
og_title: "My Article Title"
og_description: "A brief description for social sharing."
og_image: "images/mokoog/og-banner.jpg"
og_type: article
seo_title: "My Article | Example Site"
meta_description: "A brief meta description for search engines."
robots: "index, follow"
canonical_url: "https://example.com/my-article"
language: "*"
published: 1
created: "2026-06-01T12:00:00+00:00"
modified: "2026-06-15T08:30:00+00:00"
"401":
$ref: "#/components/responses/Unauthorized"
"404":
$ref: "#/components/responses/NotFound"
patch:
operationId: updateTag
summary: Update an OG tag
description: Partially updates an existing OG tag. Only supplied fields are changed.
tags: [Tags]
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/TagUpdateRequest"
example:
og_title: "Updated Title"
og_description: "Updated social description."
published: 0
responses:
"200":
description: The updated tag
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/TagDocument"
"400":
$ref: "#/components/responses/BadRequest"
"401":
$ref: "#/components/responses/Unauthorized"
"404":
$ref: "#/components/responses/NotFound"
delete:
operationId: deleteTag
summary: Delete an OG tag
tags: [Tags]
responses:
"204":
description: Tag deleted successfully
"401":
$ref: "#/components/responses/Unauthorized"
"404":
$ref: "#/components/responses/NotFound"
/mokoog/lookup/{content_type}/{content_id}:
get:
operationId: lookupTag
summary: Look up an OG tag by content type and content ID
description: |
Resolves an OG tag by its `content_type` and `content_id` pair and
returns the full tag resource. This is a convenience endpoint that
avoids the caller needing to know the internal tag ID.
tags: [Tags]
parameters:
- name: content_type
in: path
required: true
description: |
The content type identifier (e.g. `com_content`, `menu`,
`com_mokoshop`). Must match the pattern `[a-z][a-z0-9_.]*`.
schema:
type: string
pattern: "^[a-z][a-z0-9_.]*$"
example: com_content
- name: content_id
in: path
required: true
description: The content item ID
schema:
type: integer
minimum: 1
example: 42
responses:
"200":
description: The matching OG tag resource
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/TagDocument"
"400":
description: Missing or invalid content_type / content_id
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/ErrorResponse"
example:
errors:
- title: Bad Request
status: 400
detail: "content_type and content_id are required"
"401":
$ref: "#/components/responses/Unauthorized"
"404":
description: No OG tag found for the given content_type and content_id
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/ErrorResponse"
example:
errors:
- title: Not Found
status: 404
detail: "OG tag not found for com_content:42"
components:
securitySchemes:
apiToken:
type: apiKey
name: X-Joomla-Token
in: header
description: |
Joomla API token. Can also be passed as the `api-token` query
parameter. Generate a token from the Joomla administrator panel
under Users > Manage > [user] > Joomla API Token tab.
parameters:
TagId:
name: id
in: path
required: true
description: The OG tag record ID
schema:
type: integer
minimum: 1
example: 1
schemas:
TagAttributes:
type: object
description: Full set of OG tag attributes returned by the API
properties:
content_type:
type: string
description: |
Content type identifier (e.g. `com_content`, `menu`,
`com_mokoshop`). Must match `[a-z][a-z0-9_.]*`.
pattern: "^[a-z][a-z0-9_.]*$"
maxLength: 100
example: com_content
content_id:
type: integer
description: The ID of the associated content item
minimum: 1
example: 42
og_title:
type: string
description: Open Graph title (`og:title`)
maxLength: 255
example: "My Article Title"
og_description:
type: string
description: Open Graph description (`og:description`)
example: "A brief description for social sharing."
og_image:
type: string
description: Relative path to the Open Graph image (`og:image`)
maxLength: 512
example: "images/mokoog/og-banner.jpg"
og_type:
type: string
description: Open Graph type (`og:type`)
default: article
enum:
- article
- website
- product
- profile
- book
- music.song
- music.album
- video.movie
- video.episode
- video.other
example: article
seo_title:
type: string
description: SEO page title (used in `<title>` tag)
maxLength: 70
example: "My Article | Example Site"
meta_description:
type: string
description: Meta description for search engines
maxLength: 200
example: "A brief meta description for search engines."
robots:
type: string
description: |
Comma-separated robots directives. Valid directives: `index`,
`noindex`, `follow`, `nofollow`, `none`, `noarchive`,
`nosnippet`, `noimageindex`, `max-snippet`, `max-image-preview`.
maxLength: 100
example: "index, follow"
canonical_url:
type: string
format: uri
description: Canonical URL for the page
maxLength: 512
example: "https://example.com/my-article"
language:
type: string
description: Joomla language tag (`*` for all languages)
maxLength: 7
default: "*"
example: "*"
published:
type: integer
description: Published state (1 = published, 0 = unpublished)
enum: [0, 1]
default: 1
example: 1
created:
type: string
format: date-time
description: Record creation timestamp (read-only)
readOnly: true
example: "2026-06-01T12:00:00+00:00"
modified:
type: string
format: date-time
description: Last modification timestamp (read-only)
readOnly: true
example: "2026-06-15T08:30:00+00:00"
TagResource:
type: object
description: A single OG tag in JSON:API resource format
required: [type, id, attributes]
properties:
type:
type: string
enum: [tags]
example: tags
id:
type: string
description: The record ID as a string (per JSON:API spec)
example: "1"
attributes:
$ref: "#/components/schemas/TagAttributes"
TagDocument:
type: object
description: JSON:API document containing a single tag resource
properties:
links:
type: object
properties:
self:
type: string
example: "/api/index.php/v1/mokoog/tags/1"
data:
$ref: "#/components/schemas/TagResource"
TagCollection:
type: object
description: JSON:API document containing a collection of tag resources
properties:
links:
type: object
properties:
self:
type: string
example: "/api/index.php/v1/mokoog/tags"
data:
type: array
items:
$ref: "#/components/schemas/TagResource"
meta:
type: object
properties:
total-pages:
type: integer
description: Total number of pages available
example: 1
TagCreateRequest:
type: object
description: Request body for creating a new OG tag
required:
- content_type
- content_id
properties:
content_type:
type: string
pattern: "^[a-z][a-z0-9_.]*$"
maxLength: 100
example: com_content
content_id:
type: integer
minimum: 1
example: 42
og_title:
type: string
maxLength: 255
og_description:
type: string
og_image:
type: string
maxLength: 512
og_type:
type: string
default: article
enum:
- article
- website
- product
- profile
- book
- music.song
- music.album
- video.movie
- video.episode
- video.other
og_video:
type: string
format: uri
description: Open Graph video URL (`og:video`)
maxLength: 512
seo_title:
type: string
maxLength: 70
meta_description:
type: string
maxLength: 200
robots:
type: string
maxLength: 100
canonical_url:
type: string
format: uri
maxLength: 512
language:
type: string
maxLength: 7
default: "*"
published:
type: integer
enum: [0, 1]
default: 1
TagUpdateRequest:
type: object
description: |
Request body for updating an OG tag. All fields are optional; only
supplied fields are modified.
properties:
og_title:
type: string
maxLength: 255
og_description:
type: string
og_image:
type: string
maxLength: 512
og_type:
type: string
enum:
- article
- website
- product
- profile
- book
- music.song
- music.album
- video.movie
- video.episode
- video.other
og_video:
type: string
format: uri
maxLength: 512
seo_title:
type: string
maxLength: 70
meta_description:
type: string
maxLength: 200
robots:
type: string
maxLength: 100
canonical_url:
type: string
format: uri
maxLength: 512
language:
type: string
maxLength: 7
published:
type: integer
enum: [0, 1]
ErrorResponse:
type: object
description: JSON:API error response
properties:
errors:
type: array
items:
type: object
properties:
title:
type: string
example: Not Found
status:
type: integer
example: 404
detail:
type: string
example: "Item not found."
responses:
BadRequest:
description: Invalid request data
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/ErrorResponse"
example:
errors:
- title: Bad Request
status: 400
detail: "Content type is required."
Unauthorized:
description: Missing or invalid API token
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/ErrorResponse"
example:
errors:
- title: Forbidden
status: 403
detail: "You are not authorised to access this resource."
NotFound:
description: Resource not found
content:
application/vnd.api+json:
schema:
$ref: "#/components/schemas/ErrorResponse"
example:
errors:
- title: Not Found
status: 404
detail: "Item not found."
-17
View File
@@ -1,17 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
bootstrap="tests/bootstrap.php"
colors="true"
cacheDirectory=".phpunit.cache">
<testsuites>
<testsuite name="Unit">
<directory>tests/Unit</directory>
</testsuite>
</testsuites>
<source>
<include>
<directory>source/packages</directory>
</include>
</source>
</phpunit>
+4 -4
View File
@@ -30,7 +30,7 @@
label="COM_MOKOOG_FIELD_OG_TITLE"
description="COM_MOKOOG_FIELD_OG_TITLE_DESC"
filter="string"
maxlength="255"
maxlength="70"
/>
<field
name="og_description"
@@ -39,7 +39,7 @@
description="COM_MOKOOG_FIELD_OG_DESCRIPTION_DESC"
filter="string"
rows="3"
maxlength="512"
maxlength="200"
/>
<field
name="og_image"
@@ -85,7 +85,7 @@
label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
filter="string"
maxlength="255"
maxlength="70"
/>
<field
name="meta_description"
@@ -94,7 +94,7 @@
description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
filter="string"
rows="3"
maxlength="255"
maxlength="200"
/>
<field
name="robots"
@@ -59,10 +59,3 @@ COM_MOKOOG_IMPORT_INVALID_TYPE="Invalid file type. Please upload a .csv file."
COM_MOKOOG_IMPORT_FILE_TOO_LARGE="File is too large. Maximum allowed size is %s."
COM_MOKOOG_IMPORT_READ_ERROR="Could not read the uploaded CSV file."
COM_MOKOOG_IMPORT_RESULT="Import complete: %d created, %d updated, %d skipped."
COM_MOKOOG_COVERAGE_TITLE="OG Tag Coverage"
COM_MOKOOG_COVERAGE_PERCENT="OG Coverage"
COM_MOKOOG_COVERAGE_ARTICLES="%d of %d articles have OG tags"
COM_MOKOOG_COVERAGE_MISSING_TITLE="%d tags missing custom title"
COM_MOKOOG_COVERAGE_MISSING_DESC="%d tags missing custom description"
COM_MOKOOG_COVERAGE_MISSING_IMAGE="%d tags missing custom image"
@@ -59,10 +59,3 @@ COM_MOKOOG_IMPORT_INVALID_TYPE="Invalid file type. Please upload a .csv file."
COM_MOKOOG_IMPORT_FILE_TOO_LARGE="File is too large. Maximum allowed size is %s."
COM_MOKOOG_IMPORT_READ_ERROR="Could not read the uploaded CSV file."
COM_MOKOOG_IMPORT_RESULT="Import complete: %d created, %d updated, %d skipped."
COM_MOKOOG_COVERAGE_TITLE="OG Tag Coverage"
COM_MOKOOG_COVERAGE_PERCENT="OG Coverage"
COM_MOKOOG_COVERAGE_ARTICLES="%d of %d articles have OG tags"
COM_MOKOOG_COVERAGE_MISSING_TITLE="%d tags missing custom title"
COM_MOKOOG_COVERAGE_MISSING_DESC="%d tags missing custom description"
COM_MOKOOG_COVERAGE_MISSING_IMAGE="%d tags missing custom image"
+1 -1
View File
@@ -8,7 +8,7 @@
-->
<extension type="component" method="upgrade">
<name>com_mokoog</name>
<version>01.04.11</version>
<version>01.04.00</version>
<creationDate>2026-05-23</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -13,9 +13,6 @@ CREATE TABLE IF NOT EXISTS `#__mokoog_tags` (
`og_image` VARCHAR(512) NOT NULL DEFAULT '',
`og_type` VARCHAR(50) NOT NULL DEFAULT 'article',
`og_video` VARCHAR(512) NOT NULL DEFAULT '',
`event_data` TEXT NULL,
`recipe_data` TEXT NULL,
`custom_schema` TEXT NULL,
`seo_title` VARCHAR(70) NOT NULL DEFAULT '',
`meta_description` VARCHAR(200) NOT NULL DEFAULT '',
`robots` VARCHAR(100) NOT NULL DEFAULT '',
@@ -1,6 +0,0 @@
--
-- MokoJoomOpenGraph 01.04.00 - Add event_data and recipe_data columns
--
ALTER TABLE `#__mokoog_tags` ADD COLUMN `event_data` TEXT NULL AFTER `og_video`;
ALTER TABLE `#__mokoog_tags` ADD COLUMN `recipe_data` TEXT NULL AFTER `event_data`;
@@ -1 +0,0 @@
/* 01.04.09 — no schema changes */
@@ -1 +0,0 @@
/* 01.04.10 — no schema changes */
@@ -1 +0,0 @@
/* 01.04.11 — no schema changes */
@@ -1 +0,0 @@
ALTER TABLE `#__mokoog_tags` ADD COLUMN `custom_schema` TEXT NULL AFTER `canonical_url`;
@@ -120,7 +120,6 @@ class BatchController extends BaseController
$created++;
} catch (\RuntimeException $e) {
$skipped++;
\Joomla\CMS\Log\Log::add('Batch insert failed for article ' . $article->id . ': ' . $e->getMessage(), \Joomla\CMS\Log\Log::WARNING, 'mokoog');
}
}
@@ -1,58 +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\Factory;
use Joomla\CMS\Language\Text;
$db = Factory::getDbo();
// Total published articles
$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__content')->where('state = 1'));
$totalArticles = (int) $db->loadResult();
// Articles with OG tags
$db->setQuery($db->getQuery(true)->select('COUNT(DISTINCT content_id)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where('published = 1'));
$articlesWithOg = (int) $db->loadResult();
// Articles missing OG data fields
$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_title = ''")->where('published = 1'));
$missingTitle = (int) $db->loadResult();
$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_description = ''")->where('published = 1'));
$missingDesc = (int) $db->loadResult();
$db->setQuery($db->getQuery(true)->select('COUNT(*)')->from('#__mokoog_tags')->where("content_type = 'com_content'")->where("og_image = ''")->where('published = 1'));
$missingImage = (int) $db->loadResult();
$coverage = $totalArticles > 0 ? round(($articlesWithOg / $totalArticles) * 100) : 0;
?>
<div class="mokoog-coverage card mb-3">
<div class="card-body">
<h4 class="card-title"><?php echo Text::_('COM_MOKOOG_COVERAGE_TITLE'); ?></h4>
<div class="row">
<div class="col-md-3 text-center">
<div class="display-4 <?php echo $coverage >= 80 ? 'text-success' : ($coverage >= 50 ? 'text-warning' : 'text-danger'); ?>">
<?php echo $coverage; ?>%
</div>
<small class="text-muted"><?php echo Text::_('COM_MOKOOG_COVERAGE_PERCENT'); ?></small>
</div>
<div class="col-md-9">
<ul class="list-unstyled">
<li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_ARTICLES', $articlesWithOg, $totalArticles); ?></li>
<li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_TITLE', $missingTitle); ?></li>
<li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_DESC', $missingDesc); ?></li>
<li><?php echo Text::sprintf('COM_MOKOOG_COVERAGE_MISSING_IMAGE', $missingImage); ?></li>
</ul>
</div>
</div>
</div>
</div>
@@ -21,7 +21,6 @@ use Joomla\CMS\Session\Session;
$token = Session::getFormToken();
?>
<?php include __DIR__ . '/coverage.php'; ?>
<form action="<?php echo Route::_('index.php?option=com_mokoog&view=tags'); ?>" method="post" name="adminForm" id="adminForm">
<div class="row">
<div class="col-md-12">
@@ -16,7 +16,7 @@
label="PLG_CONTENT_MOKOOG_FIELD_OG_TITLE"
description="PLG_CONTENT_MOKOOG_FIELD_OG_TITLE_DESC"
filter="string"
maxlength="255"
maxlength="70"
/>
<field
name="og_description"
@@ -25,7 +25,7 @@
description="PLG_CONTENT_MOKOOG_FIELD_OG_DESCRIPTION_DESC"
filter="string"
rows="3"
maxlength="512"
maxlength="200"
/>
<field
name="og_image"
@@ -66,7 +66,7 @@
label="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE"
description="PLG_CONTENT_MOKOOG_FIELD_SEO_TITLE_DESC"
filter="string"
maxlength="255"
maxlength="70"
/>
<field
name="meta_description"
@@ -75,7 +75,7 @@
description="PLG_CONTENT_MOKOOG_FIELD_META_DESCRIPTION_DESC"
filter="string"
rows="3"
maxlength="255"
maxlength="200"
/>
<field
name="robots"
@@ -101,29 +101,5 @@
validate="url"
/>
</fieldset>
<fieldset name="mokoog_event" label="PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL"
description="PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC">
<field name="event_start" type="calendar" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_START" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC" format="%Y-%m-%d %H:%M" filter="string" showtime="true" />
<field name="event_end" type="calendar" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_END" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC" format="%Y-%m-%d %H:%M" filter="string" showtime="true" />
<field name="event_location" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC" filter="string" />
<field name="event_address" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC" filter="string" />
<field name="event_price" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC" filter="string" />
<field name="event_currency" type="text" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC" filter="string" default="USD" />
<field name="event_url" type="url" label="PLG_CONTENT_MOKOOG_FIELD_EVENT_URL" description="PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC" filter="url" />
</fieldset>
<fieldset name="mokoog_recipe" label="PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL"
description="PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC">
<field name="recipe_prep_time" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC" filter="string" hint="PT15M" />
<field name="recipe_cook_time" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC" filter="string" hint="PT30M" />
<field name="recipe_yield" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC" filter="string" hint="4 servings" />
<field name="recipe_calories" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC" filter="string" hint="350" />
<field name="recipe_ingredients" type="textarea" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC" filter="string" rows="5" hint="One ingredient per line" />
<field name="recipe_category" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC" filter="string" hint="Dessert" />
<field name="recipe_cuisine" type="text" label="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE" description="PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC" filter="string" hint="Italian" />
</fieldset>
<fieldset name="mokoog_custom_schema" label="PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL"
description="PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC">
<field name="custom_schema" type="textarea" label="PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA" description="PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC" filter="raw" rows="12" class="input-xxlarge" />
</fieldset>
</fields>
</form>
@@ -29,42 +29,3 @@ PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this
PLG_CONTENT_MOKOOG_ROBOTS_DEFAULT="- Use default (index, follow) -"
PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL="Canonical URL"
PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC="Override the canonical URL for this page. Leave blank to use the current URL."
PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL="Event Details"
PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC="Optional event information for JSON-LD Event schema."
PLG_CONTENT_MOKOOG_FIELD_EVENT_START="Start Date/Time"
PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC="Event start date and time."
PLG_CONTENT_MOKOOG_FIELD_EVENT_END="End Date/Time"
PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC="Event end date and time."
PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION="Venue Name"
PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC="Name of the event venue or location."
PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS="Venue Address"
PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC="Full address of the event venue."
PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE="Ticket Price"
PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC="Ticket price (e.g. 50.00). Leave blank if free."
PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY="Currency"
PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC="Currency code for ticket price (e.g. USD, EUR, GBP)."
PLG_CONTENT_MOKOOG_FIELD_EVENT_URL="Ticket URL"
PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC="URL where tickets can be purchased."
PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL="Recipe Details"
PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC="Optional recipe information for JSON-LD Recipe schema."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME="Prep Time"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC="Preparation time in ISO 8601 duration format (e.g. PT15M for 15 minutes)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME="Cook Time"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC="Cooking time in ISO 8601 duration format (e.g. PT30M for 30 minutes)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD="Yield"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC="Number of servings or yield (e.g. 4 servings, 1 loaf)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES="Calories"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC="Calories per serving."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS="Ingredients"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC="One ingredient per line."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY="Recipe Category"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC="Category (e.g. Dessert, Appetizer, Main course)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE="Cuisine"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC="Type of cuisine (e.g. Italian, Mexican, American)."
PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL="Custom Schema"
PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC="Add custom JSON-LD structured data for this page."
PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA="Custom JSON-LD"
PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC="Enter valid JSON-LD structured data. The @context will be added automatically if missing. Use for schema types not covered by built-in options (e.g. Course, JobPosting, SoftwareApplication)."
@@ -29,42 +29,3 @@ PLG_CONTENT_MOKOOG_FIELD_ROBOTS_DESC="Search engine indexing directives for this
PLG_CONTENT_MOKOOG_ROBOTS_DEFAULT="- Use default (index, follow) -"
PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL="Canonical URL"
PLG_CONTENT_MOKOOG_FIELD_CANONICAL_URL_DESC="Override the canonical URL for this page. Leave blank to use the current URL."
PLG_CONTENT_MOKOOG_FIELDSET_EVENT_LABEL="Event Details"
PLG_CONTENT_MOKOOG_FIELDSET_EVENT_DESC="Optional event information for JSON-LD Event schema."
PLG_CONTENT_MOKOOG_FIELD_EVENT_START="Start Date/Time"
PLG_CONTENT_MOKOOG_FIELD_EVENT_START_DESC="Event start date and time."
PLG_CONTENT_MOKOOG_FIELD_EVENT_END="End Date/Time"
PLG_CONTENT_MOKOOG_FIELD_EVENT_END_DESC="Event end date and time."
PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION="Venue Name"
PLG_CONTENT_MOKOOG_FIELD_EVENT_LOCATION_DESC="Name of the event venue or location."
PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS="Venue Address"
PLG_CONTENT_MOKOOG_FIELD_EVENT_ADDRESS_DESC="Full address of the event venue."
PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE="Ticket Price"
PLG_CONTENT_MOKOOG_FIELD_EVENT_PRICE_DESC="Ticket price (e.g. 50.00). Leave blank if free."
PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY="Currency"
PLG_CONTENT_MOKOOG_FIELD_EVENT_CURRENCY_DESC="Currency code for ticket price (e.g. USD, EUR, GBP)."
PLG_CONTENT_MOKOOG_FIELD_EVENT_URL="Ticket URL"
PLG_CONTENT_MOKOOG_FIELD_EVENT_URL_DESC="URL where tickets can be purchased."
PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_LABEL="Recipe Details"
PLG_CONTENT_MOKOOG_FIELDSET_RECIPE_DESC="Optional recipe information for JSON-LD Recipe schema."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME="Prep Time"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_PREP_TIME_DESC="Preparation time in ISO 8601 duration format (e.g. PT15M for 15 minutes)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME="Cook Time"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_COOK_TIME_DESC="Cooking time in ISO 8601 duration format (e.g. PT30M for 30 minutes)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD="Yield"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_YIELD_DESC="Number of servings or yield (e.g. 4 servings, 1 loaf)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES="Calories"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CALORIES_DESC="Calories per serving."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS="Ingredients"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_INGREDIENTS_DESC="One ingredient per line."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY="Recipe Category"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CATEGORY_DESC="Category (e.g. Dessert, Appetizer, Main course)."
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE="Cuisine"
PLG_CONTENT_MOKOOG_FIELD_RECIPE_CUISINE_DESC="Type of cuisine (e.g. Italian, Mexican, American)."
PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_LABEL="Custom Schema"
PLG_CONTENT_MOKOOG_FIELDSET_CUSTOM_SCHEMA_DESC="Add custom JSON-LD structured data for this page."
PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA="Custom JSON-LD"
PLG_CONTENT_MOKOOG_FIELD_CUSTOM_SCHEMA_DESC="Enter valid JSON-LD structured data. The @context will be added automatically if missing. Use for schema types not covered by built-in options (e.g. Course, JobPosting, SoftwareApplication)."
@@ -125,101 +125,6 @@
text-transform: none;
}
/* Discord card */
.mokoog-card-dc {
background: #2b2d31;
border-left: 4px solid #5865f2;
border-radius: 4px;
}
.mokoog-card-dc .mokoog-card-body {
border-top: none;
}
.mokoog-card-dc .mokoog-card-img {
height: 200px;
margin: 0 12px 12px;
border-radius: 4px;
}
.mokoog-card-dc .mokoog-card-title {
font-size: 16px;
font-weight: 700;
color: #00a8fc;
}
.mokoog-card-dc .mokoog-card-desc {
font-size: 14px;
color: #dbdee1;
}
.mokoog-card-dc .mokoog-card-domain {
font-size: 12px;
color: #b5bac1;
text-transform: none;
}
/* Mastodon card */
.mokoog-card-ma {
border: 1px solid #c8ccd0;
border-radius: 8px;
}
.mokoog-card-ma .mokoog-card-img {
border-radius: 8px 8px 0 0;
}
.mokoog-card-ma .mokoog-card-body {
border-top-color: #c8ccd0;
}
.mokoog-card-ma .mokoog-card-title {
font-size: 14px;
font-weight: 600;
color: #1a1a2e;
}
.mokoog-card-ma .mokoog-card-desc {
font-size: 13px;
color: #606984;
}
.mokoog-card-ma .mokoog-card-domain {
font-size: 12px;
color: #606984;
text-transform: none;
}
/* Slack card */
.mokoog-card-sl {
border-left: 4px solid #36c5f0;
border-radius: 0;
background: #fff;
}
.mokoog-card-sl .mokoog-card-body {
border-top: none;
padding: 8px 12px;
}
.mokoog-card-sl .mokoog-card-title {
font-size: 15px;
font-weight: 700;
color: #1264a3;
}
.mokoog-card-sl .mokoog-card-desc {
font-size: 14px;
color: #1d1c1d;
}
.mokoog-card-sl .mokoog-card-domain {
font-size: 12px;
color: #616061;
text-transform: none;
margin-top: 4px;
}
/* Character count indicators */
.mokoog-char-count {
display: block;
@@ -240,16 +145,3 @@
color: #d32f2f;
font-weight: 600;
}
/* SEO scoring panel */
.mokoog-seo-score { margin: 15px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; border: 1px solid #dee2e6; }
.mokoog-seo-heading { margin: 0 0 10px; font-size: 14px; color: #666; }
.mokoog-seo-list { list-style: none; padding: 0; margin: 0 0 10px; }
.mokoog-seo-item { padding: 4px 0; font-size: 13px; display: flex; align-items: center; gap: 8px; }
.mokoog-seo-dot { width: 10px; height: 10px; border-radius: 50%; flex-shrink: 0; }
.mokoog-seo-pass { background: #2e7d32; }
.mokoog-seo-fail { background: #d32f2f; }
.mokoog-seo-total { font-size: 14px; font-weight: 600; padding-top: 8px; border-top: 1px solid #dee2e6; }
.mokoog-seo-total-good { color: #2e7d32; }
.mokoog-seo-total-ok { color: #f57c00; }
.mokoog-seo-total-bad { color: #d32f2f; }
@@ -53,49 +53,6 @@ document.addEventListener('DOMContentLoaded', function () {
refresh();
});
// AI Generate buttons
['ogTitle', 'ogDesc'].forEach(function(fieldKey) {
var field = fields[fieldKey];
if (!field) return;
var btn = document.createElement('button');
btn.type = 'button';
btn.className = 'btn btn-sm btn-outline-primary mokoog-ai-btn';
btn.textContent = 'Generate with AI';
btn.dataset.target = fieldKey;
field.parentNode.appendChild(btn);
btn.addEventListener('click', function() {
var articleTitle = fields.articleTitle ? fields.articleTitle.value : '';
btn.disabled = true;
btn.textContent = 'Generating...';
var formData = new FormData();
formData.append('task', 'mokoog.aiGenerate');
formData.append('field', fieldKey === 'ogTitle' ? 'title' : 'description');
formData.append('article_title', articleTitle);
formData.append(Joomla.getOptions('csrf.token'), 1);
fetch(window.location.origin + '/administrator/index.php?option=com_ajax&plugin=mokoog&group=system&format=json', {
method: 'POST',
body: formData
})
.then(function(r) { return r.json(); })
.then(function(data) {
if (data.data && data.data[0]) {
field.value = data.data[0];
field.dispatchEvent(new Event('input'));
}
btn.disabled = false;
btn.textContent = 'Generate with AI';
})
.catch(function() {
btn.disabled = false;
btn.textContent = 'Generate with AI';
});
});
});
// Find the mokoog fieldset and insert preview after it
var fieldset = document.querySelector('[data-showon-id="mokoog"]') ||
document.getElementById('attrib-mokoog') ||
@@ -218,107 +175,6 @@ document.addEventListener('DOMContentLoaded', function () {
liCard.appendChild(liBody);
wrapper.appendChild(liCard);
// Discord preview card
var dcLabel = document.createElement('small');
dcLabel.className = 'mokoog-platform-label';
dcLabel.textContent = 'Discord';
wrapper.appendChild(dcLabel);
var dcCard = document.createElement('div');
dcCard.className = 'mokoog-card mokoog-card-dc';
var dcBody = document.createElement('div');
dcBody.className = 'mokoog-card-body';
var dcTitle = document.createElement('div');
dcTitle.id = 'mokoog-dc-title';
dcTitle.className = 'mokoog-card-title';
dcBody.appendChild(dcTitle);
var dcDesc = document.createElement('div');
dcDesc.id = 'mokoog-dc-desc';
dcDesc.className = 'mokoog-card-desc';
dcBody.appendChild(dcDesc);
var dcDomain = document.createElement('div');
dcDomain.id = 'mokoog-dc-domain';
dcDomain.className = 'mokoog-card-domain';
dcBody.appendChild(dcDomain);
dcCard.appendChild(dcBody);
var dcImg = document.createElement('div');
dcImg.id = 'mokoog-dc-img';
dcImg.className = 'mokoog-card-img';
dcCard.appendChild(dcImg);
wrapper.appendChild(dcCard);
// Mastodon preview card
var maLabel = document.createElement('small');
maLabel.className = 'mokoog-platform-label';
maLabel.textContent = 'Mastodon';
wrapper.appendChild(maLabel);
var maCard = document.createElement('div');
maCard.className = 'mokoog-card mokoog-card-ma';
var maImg = document.createElement('div');
maImg.id = 'mokoog-ma-img';
maImg.className = 'mokoog-card-img';
maCard.appendChild(maImg);
var maBody = document.createElement('div');
maBody.className = 'mokoog-card-body';
var maTitle = document.createElement('div');
maTitle.id = 'mokoog-ma-title';
maTitle.className = 'mokoog-card-title';
maBody.appendChild(maTitle);
var maDesc = document.createElement('div');
maDesc.id = 'mokoog-ma-desc';
maDesc.className = 'mokoog-card-desc';
maBody.appendChild(maDesc);
var maDomain = document.createElement('div');
maDomain.id = 'mokoog-ma-domain';
maDomain.className = 'mokoog-card-domain';
maBody.appendChild(maDomain);
maCard.appendChild(maBody);
wrapper.appendChild(maCard);
// Slack preview card
var slLabel = document.createElement('small');
slLabel.className = 'mokoog-platform-label';
slLabel.textContent = 'Slack';
wrapper.appendChild(slLabel);
var slCard = document.createElement('div');
slCard.className = 'mokoog-card mokoog-card-sl';
var slBody = document.createElement('div');
slBody.className = 'mokoog-card-body';
var slTitle = document.createElement('div');
slTitle.id = 'mokoog-sl-title';
slTitle.className = 'mokoog-card-title';
slBody.appendChild(slTitle);
var slDesc = document.createElement('div');
slDesc.id = 'mokoog-sl-desc';
slDesc.className = 'mokoog-card-desc';
slBody.appendChild(slDesc);
var slDomain = document.createElement('div');
slDomain.id = 'mokoog-sl-domain';
slDomain.className = 'mokoog-card-domain';
slBody.appendChild(slDomain);
slCard.appendChild(slBody);
wrapper.appendChild(slCard);
preview.appendChild(wrapper);
fieldset.parentNode.insertBefore(preview, fieldset.nextSibling);
@@ -373,127 +229,19 @@ document.addEventListener('DOMContentLoaded', function () {
} else {
liImgEl.style.display = 'none';
}
// Discord (title 256, desc 350)
var dcTitle = title.length > 256 ? title.substring(0, 253) + '...' : title;
var dcDesc = desc.length > 350 ? desc.substring(0, 347) + '...' : desc;
document.getElementById('mokoog-dc-title').textContent = dcTitle;
document.getElementById('mokoog-dc-desc').textContent = dcDesc;
document.getElementById('mokoog-dc-domain').textContent = domain;
var dcImgEl = document.getElementById('mokoog-dc-img');
if (img) {
dcImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
dcImgEl.style.display = '';
} else {
dcImgEl.style.display = 'none';
}
// Mastodon (title 70, desc 200)
var maTitle = title.length > 70 ? title.substring(0, 67) + '...' : title;
var maDesc = desc.length > 200 ? desc.substring(0, 197) + '...' : desc;
document.getElementById('mokoog-ma-title').textContent = maTitle;
document.getElementById('mokoog-ma-desc').textContent = maDesc;
document.getElementById('mokoog-ma-domain').textContent = domain;
var maImgEl = document.getElementById('mokoog-ma-img');
if (img) {
maImgEl.style.backgroundImage = 'url(' + encodeURI(img) + ')';
maImgEl.style.display = '';
} else {
maImgEl.style.display = 'none';
}
// Slack (title 70, desc 150, no image)
var slTitle = title.length > 70 ? title.substring(0, 67) + '...' : title;
var slDesc = desc.length > 150 ? desc.substring(0, 147) + '...' : desc;
document.getElementById('mokoog-sl-title').textContent = slTitle;
document.getElementById('mokoog-sl-desc').textContent = slDesc;
document.getElementById('mokoog-sl-domain').textContent = domain;
}
// SEO scoring panel
var seoChecks = [
{ id: 'og-title', label: 'OG Title', check: function() { return fields.ogTitle && fields.ogTitle.value.length > 0; }},
{ id: 'og-desc', label: 'OG Description', check: function() { return fields.ogDesc && fields.ogDesc.value.length > 0; }},
{ id: 'og-image', label: 'OG Image', check: function() { return fields.ogImage && fields.ogImage.value.length > 0; }},
{ id: 'seo-title', label: 'SEO Title', check: function() { return fields.seoTitle && fields.seoTitle.value.length > 0; }},
{ id: 'meta-desc', label: 'Meta Description', check: function() { return fields.metaDescription && fields.metaDescription.value.length > 0; }},
{ id: 'title-length', label: 'Title Length (\u226460)', check: function() {
var t = (fields.ogTitle && fields.ogTitle.value) || (fields.articleTitle && fields.articleTitle.value) || '';
return t.length > 0 && t.length <= 60;
}},
{ id: 'desc-length', label: 'Description Length (\u2264160)', check: function() {
var d = (fields.ogDesc && fields.ogDesc.value) || (fields.metaDesc && fields.metaDesc.value) || '';
return d.length > 0 && d.length <= 160;
}}
];
var seoPanel = document.createElement('div');
seoPanel.className = 'mokoog-seo-score';
var seoHeading = document.createElement('h4');
seoHeading.className = 'mokoog-seo-heading';
seoHeading.textContent = 'SEO Analysis';
seoPanel.appendChild(seoHeading);
var seoList = document.createElement('ul');
seoList.className = 'mokoog-seo-list';
var seoDots = {};
seoChecks.forEach(function (chk) {
var li = document.createElement('li');
li.className = 'mokoog-seo-item';
var dot = document.createElement('span');
dot.className = 'mokoog-seo-dot mokoog-seo-fail';
seoDots[chk.id] = dot;
li.appendChild(dot);
var label = document.createElement('span');
label.textContent = chk.label;
li.appendChild(label);
seoList.appendChild(li);
});
seoPanel.appendChild(seoList);
var seoTotal = document.createElement('div');
seoTotal.className = 'mokoog-seo-total';
seoPanel.appendChild(seoTotal);
wrapper.parentNode.insertBefore(seoPanel, wrapper.nextSibling);
function updateSeoScore() {
var passed = 0;
seoChecks.forEach(function (chk) {
var ok = chk.check();
if (ok) passed++;
seoDots[chk.id].className = 'mokoog-seo-dot ' + (ok ? 'mokoog-seo-pass' : 'mokoog-seo-fail');
});
seoTotal.textContent = passed + '/' + seoChecks.length + ' checks passed';
if (passed === seoChecks.length) {
seoTotal.className = 'mokoog-seo-total mokoog-seo-total-good';
} else if (passed >= Math.ceil(seoChecks.length / 2)) {
seoTotal.className = 'mokoog-seo-total mokoog-seo-total-ok';
} else {
seoTotal.className = 'mokoog-seo-total mokoog-seo-total-bad';
}
}
Object.values(fields).forEach(function (el) {
if (el) {
el.addEventListener('input', function () { updatePreview(); updateSeoScore(); });
el.addEventListener('change', function () { updatePreview(); updateSeoScore(); });
el.addEventListener('input', updatePreview);
el.addEventListener('change', updatePreview);
}
});
if (fields.ogImage) {
var observer = new MutationObserver(function () { updatePreview(); updateSeoScore(); });
var observer = new MutationObserver(updatePreview);
observer.observe(fields.ogImage, { attributes: true, attributeFilter: ['value'] });
}
updatePreview();
updateSeoScore();
});
@@ -8,7 +8,7 @@
-->
<extension type="plugin" group="content" method="upgrade">
<name>Content - MokoJoomOpenGraph</name>
<version>01.04.11</version>
<version>01.04.00</version>
<creationDate>2026-05-23</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -98,24 +98,7 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
$ogData = $this->loadOgData($contentType, $id, $language);
if ($ogData) {
$bindData = (array) $ogData;
// Unpack JSON blob fields into individual form fields
foreach (['event_data', 'recipe_data'] as $jsonField) {
if (!empty($bindData[$jsonField])) {
$decoded = json_decode($bindData[$jsonField], true);
if (\is_array($decoded)) {
foreach ($decoded as $key => $value) {
$bindData[$key] = $value;
}
}
}
unset($bindData[$jsonField]);
}
$form->bind(['mokoog' => $bindData]);
$form->bind(['mokoog' => (array) $ogData]);
}
}
}
@@ -212,7 +195,6 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
$query = $db->getQuery(true)
->select($db->quoteName([
'og_title', 'og_description', 'og_image', 'og_type', 'og_video',
'event_data', 'recipe_data', 'custom_schema',
'seo_title', 'meta_description', 'robots', 'canonical_url',
]))
->from($db->quoteName('#__mokoog_tags'))
@@ -263,16 +245,13 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
'content_type' => $contentType,
'content_id' => $contentId,
'language' => $language,
'og_title' => strip_tags(trim($ogData['og_title'] ?? '')),
'og_description' => strip_tags(trim($ogData['og_description'] ?? '')),
'og_title' => trim($ogData['og_title'] ?? ''),
'og_description' => trim($ogData['og_description'] ?? ''),
'og_image' => trim($ogData['og_image'] ?? ''),
'og_type' => trim($ogData['og_type'] ?? 'article'),
'og_video' => $this->sanitizeUrl($ogData['og_video'] ?? ''),
'event_data' => $this->packJsonFields($ogData, ['event_start', 'event_end', 'event_location', 'event_address', 'event_price', 'event_currency', 'event_url']),
'recipe_data' => $this->packJsonFields($ogData, ['recipe_prep_time', 'recipe_cook_time', 'recipe_yield', 'recipe_calories', 'recipe_ingredients', 'recipe_category', 'recipe_cuisine']),
'custom_schema' => $this->validateJson($ogData['custom_schema'] ?? ''),
'seo_title' => strip_tags(trim($ogData['seo_title'] ?? '')),
'meta_description' => strip_tags(trim($ogData['meta_description'] ?? '')),
'seo_title' => trim($ogData['seo_title'] ?? ''),
'meta_description' => trim($ogData['meta_description'] ?? ''),
'robots' => trim($robots),
'canonical_url' => trim($ogData['canonical_url'] ?? ''),
'published' => 1,
@@ -288,47 +267,6 @@ final class MokoOGContent extends CMSPlugin implements SubscriberInterface
}
}
/**
* Pack form fields into a JSON string for storage.
*
* @param array $ogData Form data array
* @param array $fields Field names to pack
*
* @return string JSON string or empty
*/
private function packJsonFields(array $ogData, array $fields): string
{
$data = [];
foreach ($fields as $field) {
$val = trim($ogData[$field] ?? '');
if ($val !== '') {
$data[$field] = $val;
}
}
return !empty($data) ? json_encode($data) : '';
}
/**
* Validate a JSON string — returns trimmed JSON or empty string if invalid.
*
* @param string $json Raw JSON input
*
* @return string
*/
private function validateJson(string $json): string
{
$json = trim($json);
if ($json === '' || json_decode($json) === null) {
return '';
}
return $json;
}
/**
* Sanitize a URL to only allow http/https schemes.
*
@@ -37,59 +37,5 @@ PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ="JSON-LD FAQ Schema"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC="Auto-detect FAQ sections from article headings (h3/h4 + paragraphs) and output FAQPage structured data."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO="JSON-LD HowTo Schema"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC="Auto-detect step-by-step instructions from ordered lists (ol/li) and output HowTo structured data."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."
PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS="Local Business"
PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED="Enable LocalBusiness Schema"
PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC="Output LocalBusiness JSON-LD structured data on all pages."
PLG_SYSTEM_MOKOOG_FIELD_LB_NAME="Business Name"
PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC="Your business name for structured data."
PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE="Business Type"
PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC="Schema.org business type."
PLG_SYSTEM_MOKOOG_FIELD_LB_STREET="Street Address"
PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC="Street address of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_CITY="City"
PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC="City of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_REGION="State/Region"
PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC="State or region of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL="Postal Code"
PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC="Postal/ZIP code of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY="Country"
PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC="Country code (e.g. US, GB, DE)."
PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE="Phone"
PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC="Business phone number."
PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL="Email"
PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC="Business email address."
PLG_SYSTEM_MOKOOG_FIELD_LB_URL="Website URL"
PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC="Business website URL."
PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS="Opening Hours"
PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC="Opening hours in schema.org format (e.g. Mo-Fr 09:00-17:00)."
PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE="Latitude"
PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC="Geographic latitude of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE="Longitude"
PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC="Geographic longitude of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE="Price Range"
PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC="Price range indicator (e.g. $, $$, $$$)."
PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE="Per-platform Image Sizes"
PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC="Generate platform-specific image sizes (Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400) in addition to the default Facebook 1200x630."
PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP="XML Sitemap"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED="Enable Sitemap"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC="Auto-generate sitemap.xml when articles are saved. Respects noindex robots directives."
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ="Change Frequency"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC="Default change frequency for sitemap entries."
PLG_SYSTEM_MOKOOG_FIELDSET_AI="AI Meta Generation"
PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED="Enable AI Generation"
PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC="Show Generate with AI buttons next to OG title and description fields."
PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER="AI Provider"
PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC="Select the AI API provider."
PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY="API Key"
PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC="Your AI provider API key."
PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL="Model"
PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC="AI model to use for generation."
@@ -37,59 +37,5 @@ PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE="Auto-resize Images"
PLG_SYSTEM_MOKOOG_FIELD_AUTO_RESIZE_DESC="Automatically resize images to 1200x630px (Facebook recommended) using center crop. Generated images are saved to images/mokoog/generated/."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED="Enable JSON-LD"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_ENABLED_DESC="Output JSON-LD structured data (Article, WebPage) for Google rich results."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ="JSON-LD FAQ Schema"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC="Auto-detect FAQ sections from article headings (h3/h4 + paragraphs) and output FAQPage structured data."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO="JSON-LD HowTo Schema"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC="Auto-detect step-by-step instructions from ordered lists (ol/li) and output HowTo structured data."
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS="JSON-LD Breadcrumbs"
PLG_SYSTEM_MOKOOG_FIELD_JSONLD_BREADCRUMBS_DESC="Output BreadcrumbList JSON-LD schema from Joomla's pathway."
PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS="Local Business"
PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED="Enable LocalBusiness Schema"
PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC="Output LocalBusiness JSON-LD structured data on all pages."
PLG_SYSTEM_MOKOOG_FIELD_LB_NAME="Business Name"
PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC="Your business name for structured data."
PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE="Business Type"
PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC="Schema.org business type."
PLG_SYSTEM_MOKOOG_FIELD_LB_STREET="Street Address"
PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC="Street address of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_CITY="City"
PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC="City of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_REGION="State/Region"
PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC="State or region of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL="Postal Code"
PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC="Postal/ZIP code of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY="Country"
PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC="Country code (e.g. US, GB, DE)."
PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE="Phone"
PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC="Business phone number."
PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL="Email"
PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC="Business email address."
PLG_SYSTEM_MOKOOG_FIELD_LB_URL="Website URL"
PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC="Business website URL."
PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS="Opening Hours"
PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC="Opening hours in schema.org format (e.g. Mo-Fr 09:00-17:00)."
PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE="Latitude"
PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC="Geographic latitude of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE="Longitude"
PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC="Geographic longitude of your business."
PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE="Price Range"
PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC="Price range indicator (e.g. $, $$, $$$)."
PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE="Per-platform Image Sizes"
PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC="Generate platform-specific image sizes (Twitter 1200x600, Pinterest 1000x1500, WhatsApp 400x400) in addition to the default Facebook 1200x630."
PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP="XML Sitemap"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED="Enable Sitemap"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC="Auto-generate sitemap.xml when articles are saved. Respects noindex robots directives."
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ="Change Frequency"
PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC="Default change frequency for sitemap entries."
PLG_SYSTEM_MOKOOG_FIELDSET_AI="AI Meta Generation"
PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED="Enable AI Generation"
PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC="Show Generate with AI buttons next to OG title and description fields."
PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER="AI Provider"
PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC="Select the AI API provider."
PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY="API Key"
PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC="Your AI provider API key."
PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL="Model"
PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC="AI model to use for generation."
+1 -186
View File
@@ -8,7 +8,7 @@
-->
<extension type="plugin" group="system" method="upgrade">
<name>System - MokoJoomOpenGraph</name>
<version>01.04.11</version>
<version>01.04.00</version>
<creationDate>2026-05-23</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -158,17 +158,6 @@
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="platform_resize"
type="radio"
label="PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE"
description="PLG_SYSTEM_MOKOOG_FIELD_PLATFORM_RESIZE_DESC"
default="0"
class="btn-group"
>
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="jsonld_enabled"
type="radio"
@@ -180,28 +169,6 @@
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="jsonld_faq"
type="radio"
label="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ"
description="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_FAQ_DESC"
default="1"
class="btn-group"
>
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="jsonld_howto"
type="radio"
label="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO"
description="PLG_SYSTEM_MOKOOG_FIELD_JSONLD_HOWTO_DESC"
default="1"
class="btn-group"
>
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="jsonld_breadcrumbs"
type="radio"
@@ -214,158 +181,6 @@
<option value="0">JNO</option>
</field>
</fieldset>
<fieldset name="localbusiness" label="PLG_SYSTEM_MOKOOG_FIELDSET_LOCALBUSINESS">
<field
name="lb_enabled"
type="radio"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_ENABLED_DESC"
default="0"
class="btn-group"
>
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="lb_name"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_NAME"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_NAME_DESC"
default=""
filter="string"
/>
<field
name="lb_type"
type="list"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_TYPE_DESC"
default="LocalBusiness"
>
<option value="LocalBusiness">LocalBusiness</option>
<option value="Restaurant">Restaurant</option>
<option value="Store">Store</option>
<option value="MedicalBusiness">MedicalBusiness</option>
<option value="LegalService">LegalService</option>
<option value="FinancialService">FinancialService</option>
<option value="EducationalOrganization">EducationalOrganization</option>
</field>
<field
name="lb_street"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_STREET"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_STREET_DESC"
default=""
filter="string"
/>
<field
name="lb_city"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_CITY"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_CITY_DESC"
default=""
filter="string"
/>
<field
name="lb_region"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_REGION"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_REGION_DESC"
default=""
filter="string"
/>
<field
name="lb_postal"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_POSTAL_DESC"
default=""
filter="string"
/>
<field
name="lb_country"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_COUNTRY_DESC"
default="US"
filter="string"
/>
<field
name="lb_phone"
type="tel"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_PHONE_DESC"
default=""
/>
<field
name="lb_email"
type="email"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_EMAIL_DESC"
default=""
/>
<field
name="lb_url"
type="url"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_URL"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_URL_DESC"
default=""
/>
<field
name="lb_opening_hours"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_OPENING_HOURS_DESC"
default=""
filter="string"
/>
<field
name="lb_latitude"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_LATITUDE_DESC"
default=""
filter="string"
/>
<field
name="lb_longitude"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_LONGITUDE_DESC"
default=""
filter="string"
/>
<field
name="lb_price_range"
type="text"
label="PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE"
description="PLG_SYSTEM_MOKOOG_FIELD_LB_PRICE_RANGE_DESC"
default=""
filter="string"
/>
</fieldset>
<fieldset name="sitemap" label="PLG_SYSTEM_MOKOOG_FIELDSET_SITEMAP">
<field name="sitemap_enabled" type="radio" label="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED" description="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_ENABLED_DESC" default="0" class="btn-group">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field name="sitemap_changefreq" type="list" label="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ" description="PLG_SYSTEM_MOKOOG_FIELD_SITEMAP_CHANGEFREQ_DESC" default="weekly">
<option value="daily">Daily</option>
<option value="weekly">Weekly</option>
<option value="monthly">Monthly</option>
</field>
</fieldset>
<fieldset name="ai" label="PLG_SYSTEM_MOKOOG_FIELDSET_AI">
<field name="ai_enabled" type="radio" label="PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED" description="PLG_SYSTEM_MOKOOG_FIELD_AI_ENABLED_DESC" default="0" class="btn-group">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field name="ai_provider" type="list" label="PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER" description="PLG_SYSTEM_MOKOOG_FIELD_AI_PROVIDER_DESC" default="claude">
<option value="claude">Claude (Anthropic)</option>
<option value="openai">OpenAI</option>
</field>
<field name="ai_api_key" type="password" label="PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY" description="PLG_SYSTEM_MOKOOG_FIELD_AI_API_KEY_DESC" filter="string" />
<field name="ai_model" type="text" label="PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL" description="PLG_SYSTEM_MOKOOG_FIELD_AI_MODEL_DESC" default="claude-haiku-4-5-20251001" filter="string" />
</fieldset>
</fields>
</config>
</extension>
@@ -19,7 +19,6 @@ use Joomla\Event\Event;
use Joomla\Event\SubscriberInterface;
use Joomla\Plugin\System\MokoOG\Helper\ImageHelper;
use Joomla\Plugin\System\MokoOG\Helper\JsonLdBuilder;
use Joomla\Plugin\System\MokoOG\Helper\SitemapBuilder;
final class MokoOG extends CMSPlugin implements SubscriberInterface
{
@@ -38,8 +37,6 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
return [
'onAfterRoute' => 'onAfterRoute',
'onBeforeCompileHead' => 'onBeforeCompileHead',
'onContentAfterSave' => 'onContentAfterSaveRebuildSitemap',
'onAjaxMokoog' => 'onAjaxMokoog',
];
}
@@ -159,10 +156,7 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
$doc->setMetaData('twitter:description', $description);
if ($image) {
$twitterImage = ($this->params->get('auto_resize', 1) && $this->params->get('platform_resize', 0))
? ImageHelper::resizeForPlatform($image, 'twitter')
: $image;
$doc->setMetaData('twitter:image', $this->resolveImageUrl($twitterImage));
$doc->setMetaData('twitter:image', $this->resolveImageUrl($image));
}
if ($twitterSite) {
@@ -288,85 +282,6 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
$doc->addCustomTag(JsonLdBuilder::toScriptTag($schema));
}
if (!empty($ogData->og_video)) {
$videoSchema = JsonLdBuilder::buildVideo($ogData->og_video, $title, $description, $imageUrl);
if ($videoSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($videoSchema));
}
}
// FAQ schema (auto-detected from article headings)
if ($this->params->get('jsonld_faq', 1) && $option === 'com_content' && $view === 'article' && $id > 0) {
$faqItems = $this->extractFaqFromContent($id);
if (!empty($faqItems)) {
$faqSchema = JsonLdBuilder::buildFaq($faqItems);
if ($faqSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($faqSchema));
}
}
}
// HowTo schema (auto-detected from ordered lists)
if ($this->params->get('jsonld_howto', 1) && $option === 'com_content' && $view === 'article' && $id > 0) {
$howToSteps = $this->extractHowToFromContent($id);
if (!empty($howToSteps)) {
$howToSchema = JsonLdBuilder::buildHowTo($title, $howToSteps, $imageUrl);
if ($howToSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($howToSchema));
}
}
}
// Event JSON-LD from per-article event data
$eventJson = $ogData->event_data ?? '';
if (!empty($eventJson)) {
$eventObj = json_decode($eventJson);
if ($eventObj && !empty($eventObj->event_start)) {
$eventSchema = JsonLdBuilder::buildEvent($title, $description, $imageUrl, $eventObj);
if ($eventSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($eventSchema));
}
}
}
// Recipe JSON-LD from per-article recipe data
$recipeJson = $ogData->recipe_data ?? '';
if (!empty($recipeJson)) {
$recipeObj = json_decode($recipeJson);
if ($recipeObj) {
$recipeSchema = JsonLdBuilder::buildRecipe($title, $description, $imageUrl, $recipeObj);
if ($recipeSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($recipeSchema));
}
}
}
// Custom JSON-LD schema (user-provided)
$customSchema = $ogData->custom_schema ?? '';
if (!empty($customSchema)) {
$decoded = json_decode($customSchema, true);
if ($decoded) {
if (empty($decoded['@context'])) {
$decoded['@context'] = 'https://schema.org';
}
$doc->addCustomTag(JsonLdBuilder::toScriptTag($decoded));
}
}
if ($this->params->get('jsonld_breadcrumbs', 1)) {
$breadcrumbs = JsonLdBuilder::buildBreadcrumbs();
@@ -375,15 +290,6 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
}
}
}
// LocalBusiness JSON-LD
if ($this->params->get('lb_enabled', 0)) {
$lbSchema = JsonLdBuilder::buildLocalBusiness($this->params);
if ($lbSchema) {
$doc->addCustomTag(JsonLdBuilder::toScriptTag($lbSchema));
}
}
}
/**
@@ -447,9 +353,6 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
'og_image' => '',
'og_type' => '',
'og_video' => '',
'event_data' => '',
'recipe_data' => '',
'custom_schema' => '',
'seo_title' => '',
'meta_description' => '',
'robots' => '',
@@ -720,220 +623,6 @@ final class MokoOG extends CMSPlugin implements SubscriberInterface
return $article->author_name ?? '';
}
/**
* Extract FAQ question/answer pairs from article content.
*
* @param int $articleId Article ID
*
* @return array Array of ['question' => '...', 'answer' => '...'] pairs
*/
private function extractFaqFromContent(int $articleId): array
{
$article = $this->loadArticle($articleId);
if (!$article) {
return [];
}
$content = ($article->introtext ?? '') . ($article->fulltext ?? '');
if (trim($content) === '') {
return [];
}
$faqItems = [];
if (preg_match_all('/<h[34][^>]*>(.*?)<\/h[34]>\s*((?:<p[^>]*>.*?<\/p>\s*)+)/si', $content, $matches, PREG_SET_ORDER)) {
foreach ($matches as $match) {
$question = trim(strip_tags($match[1]));
$answer = trim(strip_tags($match[2]));
if ($question !== '' && $answer !== '') {
$faqItems[] = [
'question' => $question,
'answer' => $answer,
];
}
}
}
return $faqItems;
}
/**
* Extract HowTo steps from ordered lists in article content.
*
* @param int $articleId Article ID
*
* @return array Array of ['name' => '...', 'text' => '...'] pairs
*/
private function extractHowToFromContent(int $articleId): array
{
$article = $this->loadArticle($articleId);
if (!$article) {
return [];
}
$content = ($article->introtext ?? '') . ($article->fulltext ?? '');
if (!preg_match('/<ol[^>]*>(.*?)<\/ol>/si', $content, $olMatch)) {
return [];
}
if (!preg_match_all('/<li[^>]*>(.*?)<\/li>/si', $olMatch[1], $liMatches)) {
return [];
}
$steps = [];
foreach ($liMatches[1] as $liHtml) {
$text = trim(strip_tags($liHtml));
if ($text === '') {
continue;
}
$name = $text;
if (preg_match('/<(?:b|strong)[^>]*>(.*?)<\/(?:b|strong)>/si', $liHtml, $boldMatch)) {
$name = trim(strip_tags($boldMatch[1]));
} elseif (preg_match('/^([^.!?]+[.!?])/', $text, $sentenceMatch)) {
$name = trim($sentenceMatch[1]);
}
$steps[] = [
'name' => $name,
'text' => $text,
];
}
return $steps;
}
/**
* Rebuild sitemap.xml when article content is saved.
*
* @param Event $event The event
*
* @return void
*/
public function onContentAfterSaveRebuildSitemap(Event $event): void
{
if (!$this->params->get('sitemap_enabled', 0)) {
return;
}
[$context] = array_values($event->getArguments());
if ($context !== 'com_content.article') {
return;
}
$changefreq = $this->params->get('sitemap_changefreq', 'weekly');
$xml = SitemapBuilder::generate($changefreq);
SitemapBuilder::writeToFile($xml);
}
/**
* Handle AJAX requests for AI meta tag generation.
*
* @param Event $event The event
*
* @return void
*/
public function onAjaxMokoog(Event $event): void
{
$app = $this->getApplication();
if (!$app->isClient('administrator')) {
return;
}
\Joomla\CMS\Session\Session::checkToken() or die('Invalid Token');
if (!$this->params->get('ai_enabled', 0)) {
$event->setArgument('result', ['AI generation is not enabled']);
return;
}
$apiKey = $this->params->get('ai_api_key', '');
$provider = $this->params->get('ai_provider', 'claude');
$model = $this->params->get('ai_model', 'claude-haiku-4-5-20251001');
if (empty($apiKey)) {
$event->setArgument('result', ['API key not configured']);
return;
}
$input = $app->getInput();
$field = $input->getString('field', 'title');
$articleTitle = $input->getString('article_title', '');
$prompt = $field === 'title'
? "Generate a concise, engaging social media sharing title (max 60 characters) for an article titled: \"$articleTitle\". Return only the title text, no quotes or explanation."
: "Generate a compelling social media sharing description (max 155 characters) for an article titled: \"$articleTitle\". Return only the description text, no quotes or explanation.";
try {
$result = $this->callAiApi($provider, $apiKey, $model, $prompt);
$event->setArgument('result', [$result]);
} catch (\Exception $e) {
$event->setArgument('result', ['Error: ' . $e->getMessage()]);
}
}
/**
* Call an AI API (Claude or OpenAI) with a prompt.
*
* @param string $provider Provider name (claude or openai)
* @param string $apiKey API key
* @param string $model Model name
* @param string $prompt Prompt text
*
* @return string Generated text
*/
private function callAiApi(string $provider, string $apiKey, string $model, string $prompt): string
{
$http = \Joomla\CMS\Http\HttpFactory::getHttp();
if ($provider === 'claude') {
$response = $http->post(
'https://api.anthropic.com/v1/messages',
json_encode([
'model' => $model,
'max_tokens' => 200,
'messages' => [['role' => 'user', 'content' => $prompt]],
]),
[
'Content-Type' => 'application/json',
'x-api-key' => $apiKey,
'anthropic-version' => '2023-06-01',
]
);
$data = json_decode($response->body, true);
return trim($data['content'][0]['text'] ?? '');
}
$response = $http->post(
'https://api.openai.com/v1/chat/completions',
json_encode([
'model' => $model,
'max_tokens' => 200,
'messages' => [['role' => 'user', 'content' => $prompt]],
]),
[
'Content-Type' => 'application/json',
'Authorization' => 'Bearer ' . $apiKey,
]
);
$data = json_decode($response->body, true);
return trim($data['choices'][0]['message']['content'] ?? '');
}
/**
* Warn administrators once per session when no license key is configured.
*
@@ -149,137 +149,6 @@ class ImageHelper
return $outputRel;
}
/**
* Resize an image for a specific platform.
*
* @param string $imagePath Relative image path
* @param string $platform Platform name (facebook, twitter, pinterest, whatsapp)
*
* @return string Path to the resized image
*/
public static function resizeForPlatform(string $imagePath, string $platform): string
{
$sizes = [
'facebook' => ['width' => 1200, 'height' => 630],
'twitter' => ['width' => 1200, 'height' => 600],
'pinterest' => ['width' => 1000, 'height' => 1500],
'whatsapp' => ['width' => 400, 'height' => 400],
];
if (!isset($sizes[$platform])) {
return self::resize($imagePath);
}
$size = $sizes[$platform];
return self::resizeToSize($imagePath, $size['width'], $size['height'], $platform);
}
/**
* Resize an image to specific dimensions with a platform-specific subdirectory.
*
* @param string $imagePath Image path relative to JPATH_ROOT
* @param int $width Target width
* @param int $height Target height
* @param string $subdir Subdirectory name for output (e.g. platform name)
*
* @return string Path to the output image (relative to JPATH_ROOT)
*/
private static function resizeToSize(string $imagePath, int $width, int $height, string $subdir = ''): string
{
// Resolve absolute path
$absPath = JPATH_ROOT . '/' . ltrim($imagePath, '/');
if (!is_file($absPath)) {
return $imagePath;
}
$imageInfo = getimagesize($absPath);
if (!$imageInfo) {
Log::add('MokoOG ImageHelper: Cannot read image dimensions: ' . basename($absPath), Log::WARNING, 'mokoog');
return $imagePath;
}
[$origWidth, $origHeight, $type] = $imageInfo;
// Skip if already at or below target size
if ($origWidth <= $width && $origHeight <= $height) {
return $imagePath;
}
// Build output directory with optional subdirectory
$outputRelDir = self::OUTPUT_DIR . ($subdir ? '/' . $subdir : '');
$outputDir = JPATH_ROOT . '/' . $outputRelDir;
if (!is_dir($outputDir) && !Folder::create($outputDir)) {
Log::add('MokoOG ImageHelper: Cannot create output directory: ' . $outputRelDir, Log::WARNING, 'mokoog');
return $imagePath;
}
// Generate output filename based on source hash + dimensions
$hash = md5($imagePath . $width . $height);
$outputName = $hash . '.jpg';
$outputPath = $outputDir . '/' . $outputName;
$outputRel = $outputRelDir . '/' . $outputName;
// Skip if already generated
if (is_file($outputPath) && filemtime($outputPath) >= filemtime($absPath)) {
return $outputRel;
}
// Load source image
$source = self::loadImage($absPath, $type);
if (!$source) {
return $imagePath;
}
// Calculate crop dimensions (center crop to target aspect ratio)
$targetRatio = $width / $height;
$sourceRatio = $origWidth / $origHeight;
if ($sourceRatio > $targetRatio) {
// Source is wider — crop sides
$cropHeight = $origHeight;
$cropWidth = (int) round($origHeight * $targetRatio);
$cropX = (int) round(($origWidth - $cropWidth) / 2);
$cropY = 0;
} else {
// Source is taller — crop top/bottom
$cropWidth = $origWidth;
$cropHeight = (int) round($origWidth / $targetRatio);
$cropX = 0;
$cropY = (int) round(($origHeight - $cropHeight) / 2);
}
// Create output canvas and resample
$output = imagecreatetruecolor($width, $height);
imagecopyresampled(
$output,
$source,
0,
0,
$cropX,
$cropY,
$width,
$height,
$cropWidth,
$cropHeight
);
// Save as JPEG
imagejpeg($output, $outputPath, self::JPEG_QUALITY);
imagedestroy($source);
imagedestroy($output);
return $outputRel;
}
/**
* Remove a generated image file.
*
@@ -248,413 +248,6 @@ class JsonLdBuilder
return $schema;
}
/**
* Build VideoObject schema for pages with a video URL.
*
* @param string $videoUrl Video URL (e.g. YouTube, Vimeo, or direct)
* @param string $title Video title
* @param string $description Video description
* @param string $imageUrl Thumbnail image URL (absolute)
*
* @return array|null
*/
public static function buildVideo(string $videoUrl, string $title, string $description, string $imageUrl): ?array
{
if (empty($videoUrl)) {
return null;
}
$schema = [
'@context' => 'https://schema.org',
'@type' => 'VideoObject',
'name' => $title,
'description' => $description,
'thumbnailUrl' => $imageUrl,
'contentUrl' => $videoUrl,
'uploadDate' => Factory::getDate()->toISO8601(),
];
// Add embedUrl for YouTube and Vimeo
if (preg_match('/youtube\.com|youtu\.be|vimeo\.com/i', $videoUrl)) {
$schema['embedUrl'] = $videoUrl;
}
return $schema;
}
/**
* Build LocalBusiness schema from plugin parameters.
*
* @param object $params Plugin parameters object
*
* @return array|null
*/
public static function buildLocalBusiness(object $params): ?array
{
$name = trim((string) $params->get('lb_name', ''));
if ($name === '') {
return null;
}
$schema = [
'@context' => 'https://schema.org',
'@type' => $params->get('lb_type', 'LocalBusiness'),
'name' => $name,
];
// Build PostalAddress
$address = [];
$street = trim((string) $params->get('lb_street', ''));
$city = trim((string) $params->get('lb_city', ''));
$region = trim((string) $params->get('lb_region', ''));
$postal = trim((string) $params->get('lb_postal', ''));
$country = trim((string) $params->get('lb_country', ''));
if ($street !== '') {
$address['streetAddress'] = $street;
}
if ($city !== '') {
$address['addressLocality'] = $city;
}
if ($region !== '') {
$address['addressRegion'] = $region;
}
if ($postal !== '') {
$address['postalCode'] = $postal;
}
if ($country !== '') {
$address['addressCountry'] = $country;
}
if (!empty($address)) {
$address['@type'] = 'PostalAddress';
$schema['address'] = $address;
}
// Contact properties
$phone = trim((string) $params->get('lb_phone', ''));
$email = trim((string) $params->get('lb_email', ''));
$url = trim((string) $params->get('lb_url', ''));
if ($phone !== '') {
$schema['telephone'] = $phone;
}
if ($email !== '') {
$schema['email'] = $email;
}
if ($url !== '') {
$schema['url'] = $url;
}
// Opening hours
$openingHours = trim((string) $params->get('lb_opening_hours', ''));
if ($openingHours !== '') {
$schema['openingHours'] = $openingHours;
}
// GeoCoordinates
$latitude = trim((string) $params->get('lb_latitude', ''));
$longitude = trim((string) $params->get('lb_longitude', ''));
if ($latitude !== '' && $longitude !== '') {
$schema['geo'] = [
'@type' => 'GeoCoordinates',
'latitude' => $latitude,
'longitude' => $longitude,
];
}
// Price range
$priceRange = trim((string) $params->get('lb_price_range', ''));
if ($priceRange !== '') {
$schema['priceRange'] = $priceRange;
}
return $schema;
}
/**
* Build FAQPage schema from question/answer pairs.
*
* @param array $questions Array of ['question' => '...', 'answer' => '...'] pairs
*
* @return array|null
*/
public static function buildFaq(array $questions): ?array
{
if (empty($questions)) {
return null;
}
$mainEntity = [];
foreach ($questions as $item) {
$question = trim($item['question'] ?? '');
$answer = trim($item['answer'] ?? '');
if ($question === '' || $answer === '') {
continue;
}
$mainEntity[] = [
'@type' => 'Question',
'name' => $question,
'acceptedAnswer' => [
'@type' => 'Answer',
'text' => $answer,
],
];
}
if (empty($mainEntity)) {
return null;
}
return [
'@context' => 'https://schema.org',
'@type' => 'FAQPage',
'mainEntity' => $mainEntity,
];
}
/**
* Build HowTo schema from step-by-step instructions.
*
* @param string $title HowTo title
* @param array $steps Array of ['name' => 'Step title', 'text' => 'Step instructions']
* @param string $imageUrl Optional image URL (absolute)
*
* @return array|null
*/
public static function buildHowTo(string $title, array $steps, string $imageUrl = ''): ?array
{
if (empty($steps)) {
return null;
}
$schema = [
'@context' => 'https://schema.org',
'@type' => 'HowTo',
'name' => $title,
];
if (!empty($imageUrl)) {
$schema['image'] = $imageUrl;
}
$schema['step'] = [];
foreach ($steps as $step) {
$schema['step'][] = [
'@type' => 'HowToStep',
'name' => $step['name'],
'text' => $step['text'],
];
}
return $schema;
}
/**
* Build Event schema from per-article event data.
*
* @param string $title Event/article title
* @param string $description Event description
* @param string $imageUrl Image URL (absolute)
* @param object $eventData Decoded event_data with event_start, event_end, etc.
*
* @return array|null
*/
public static function buildEvent(string $title, string $description, string $imageUrl, object $eventData): ?array
{
$startDate = $eventData->event_start ?? '';
if (empty($startDate)) {
return null;
}
$schema = [
'@context' => 'https://schema.org',
'@type' => 'Event',
'name' => $title,
'description' => $description,
'startDate' => $startDate,
'url' => Uri::getInstance()->toString(),
];
$endDate = $eventData->event_end ?? '';
if (!empty($endDate)) {
$schema['endDate'] = $endDate;
}
if (!empty($imageUrl)) {
$schema['image'] = $imageUrl;
}
$locationName = $eventData->event_location ?? '';
$address = $eventData->event_address ?? '';
if (!empty($locationName) || !empty($address)) {
$location = ['@type' => 'Place'];
if (!empty($locationName)) {
$location['name'] = $locationName;
}
if (!empty($address)) {
$location['address'] = [
'@type' => 'PostalAddress',
'streetAddress' => $address,
];
}
$schema['location'] = $location;
}
$price = $eventData->event_price ?? '';
$currency = $eventData->event_currency ?? 'USD';
$ticketUrl = $eventData->event_url ?? '';
if ($price !== '') {
$offer = [
'@type' => 'Offer',
'price' => number_format((float) $price, 2, '.', ''),
'priceCurrency' => $currency ?: 'USD',
'availability' => 'https://schema.org/InStock',
];
if (!empty($ticketUrl)) {
$offer['url'] = $ticketUrl;
}
$schema['offers'] = $offer;
} elseif (!empty($ticketUrl)) {
$schema['offers'] = [
'@type' => 'Offer',
'price' => '0.00',
'priceCurrency' => $currency ?: 'USD',
'availability' => 'https://schema.org/InStock',
'url' => $ticketUrl,
];
}
return $schema;
}
/**
* Build Recipe schema from per-article recipe data.
*
* @param string $title Recipe/article title
* @param string $description Recipe/article description
* @param string $imageUrl Image URL (absolute)
* @param object $recipeData Decoded recipe_data object
*
* @return array|null
*/
public static function buildRecipe(string $title, string $description, string $imageUrl, object $recipeData): ?array
{
$fields = ['recipe_prep_time', 'recipe_cook_time', 'recipe_yield', 'recipe_calories', 'recipe_ingredients', 'recipe_category', 'recipe_cuisine'];
$hasData = false;
foreach ($fields as $field) {
if (!empty($recipeData->$field)) {
$hasData = true;
break;
}
}
if (!$hasData) {
return null;
}
$schema = [
'@context' => 'https://schema.org',
'@type' => 'Recipe',
'name' => $title,
'description' => $description,
'url' => Uri::getInstance()->toString(),
];
if (!empty($imageUrl)) {
$schema['image'] = $imageUrl;
}
if (!empty($recipeData->recipe_prep_time)) {
$schema['prepTime'] = $recipeData->recipe_prep_time;
}
if (!empty($recipeData->recipe_cook_time)) {
$schema['cookTime'] = $recipeData->recipe_cook_time;
}
if (!empty($recipeData->recipe_prep_time) && !empty($recipeData->recipe_cook_time)) {
try {
$prep = new \DateInterval($recipeData->recipe_prep_time);
$cook = new \DateInterval($recipeData->recipe_cook_time);
$totalMinutes = ($prep->h * 60 + $prep->i) + ($cook->h * 60 + $cook->i);
$hours = intdiv($totalMinutes, 60);
$minutes = $totalMinutes % 60;
$totalTime = 'PT';
if ($hours > 0) {
$totalTime .= $hours . 'H';
}
if ($minutes > 0) {
$totalTime .= $minutes . 'M';
}
if ($totalTime !== 'PT') {
$schema['totalTime'] = $totalTime;
}
} catch (\Exception $e) {
// Invalid duration format
}
}
if (!empty($recipeData->recipe_yield)) {
$schema['recipeYield'] = $recipeData->recipe_yield;
}
if (!empty($recipeData->recipe_calories)) {
$schema['nutrition'] = [
'@type' => 'NutritionInformation',
'calories' => $recipeData->recipe_calories . ' calories',
];
}
if (!empty($recipeData->recipe_ingredients)) {
$ingredients = array_filter(
array_map('trim', preg_split('/\r\n|\r|\n/', $recipeData->recipe_ingredients)),
fn($line) => $line !== ''
);
if (!empty($ingredients)) {
$schema['recipeIngredient'] = array_values($ingredients);
}
}
if (!empty($recipeData->recipe_category)) {
$schema['recipeCategory'] = $recipeData->recipe_category;
}
if (!empty($recipeData->recipe_cuisine)) {
$schema['recipeCuisine'] = $recipeData->recipe_cuisine;
}
return $schema;
}
/**
* Encode a schema array to a JSON-LD script tag string.
*
@@ -1,107 +0,0 @@
<?php
/**
* @package MokoSuiteOpenGraph
* @subpackage plg_system_mokoog
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
*/
namespace Joomla\Plugin\System\MokoOG\Helper;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Uri\Uri;
/**
* XML Sitemap builder.
*
* Generates a sitemap.xml containing all published articles, excluding
* those marked with noindex robots directives in the mokoog_tags table.
*/
class SitemapBuilder
{
/**
* Generate sitemap XML content.
*
* @param string $changefreq Default change frequency for entries
*
* @return string Complete sitemap XML
*/
public static function generate(string $changefreq = 'weekly'): string
{
$db = Factory::getDbo();
// Get all published articles
$query = $db->getQuery(true)
->select($db->quoteName(['a.id', 'a.alias', 'a.catid', 'a.modified', 'a.language']))
->from($db->quoteName('#__content', 'a'))
->where($db->quoteName('a.state') . ' = 1');
$db->setQuery($query);
$articles = $db->loadObjectList();
// Get noindex articles from mokoog_tags
$noindexQuery = $db->getQuery(true)
->select($db->quoteName('content_id'))
->from($db->quoteName('#__mokoog_tags'))
->where($db->quoteName('content_type') . ' = ' . $db->quote('com_content'))
->where($db->quoteName('robots') . ' LIKE ' . $db->quote('%noindex%'));
$db->setQuery($noindexQuery);
$noindexIds = $db->loadColumn();
$root = rtrim(Uri::root(), '/');
$xml = '<?xml version="1.0" encoding="UTF-8"?>' . "\n";
$xml .= '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">' . "\n";
// Homepage
$xml .= ' <url>' . "\n";
$xml .= ' <loc>' . $root . '/</loc>' . "\n";
$xml .= ' <changefreq>daily</changefreq>' . "\n";
$xml .= ' <priority>1.0</priority>' . "\n";
$xml .= ' </url>' . "\n";
foreach ($articles as $article) {
// Skip noindexed
if (in_array((int) $article->id, $noindexIds)) {
continue;
}
$url = $root . '/index.php?option=com_content&view=article&id=' . $article->id;
$lastmod = $article->modified && $article->modified !== '0000-00-00 00:00:00'
? date('Y-m-d', strtotime($article->modified)) : '';
$xml .= ' <url>' . "\n";
$xml .= ' <loc>' . htmlspecialchars($url, ENT_XML1) . '</loc>' . "\n";
if ($lastmod) {
$xml .= ' <lastmod>' . $lastmod . '</lastmod>' . "\n";
}
$xml .= ' <changefreq>' . $changefreq . '</changefreq>' . "\n";
$xml .= ' <priority>0.8</priority>' . "\n";
$xml .= ' </url>' . "\n";
}
$xml .= '</urlset>';
return $xml;
}
/**
* Write sitemap XML to the site root.
*
* @param string $xml The sitemap XML content
*
* @return bool True on success
*/
public static function writeToFile(string $xml): bool
{
$path = JPATH_ROOT . '/sitemap.xml';
return (bool) file_put_contents($path, $xml);
}
}
@@ -8,7 +8,7 @@
-->
<extension type="plugin" group="webservices" method="upgrade">
<name>Web Services - MokoJoomOpenGraph</name>
<version>01.04.11</version>
<version>01.04.00</version>
<creationDate>2026-05-23</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
+1 -1
View File
@@ -8,7 +8,7 @@
<extension type="package" method="upgrade">
<name>Package - MokoSuiteOpenGraph</name>
<packagename>mokoog</packagename>
<version>01.04.11</version>
<version>01.04.00</version>
<creationDate>2026-05-23</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
-257
View File
@@ -1,257 +0,0 @@
<?php
/**
* @package MokoSuiteOpenGraph
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
*/
namespace Mokoconsulting\MokoOG\Tests\Unit\Helper;
use Joomla\Plugin\System\MokoOG\Helper\JsonLdBuilder;
use PHPUnit\Framework\TestCase;
class JsonLdBuilderTest extends TestCase
{
// ── FAQPage ──────────────────────────────────────────────────────
public function testBuildFaqReturnsNullForEmptyArray(): void
{
$this->assertNull(JsonLdBuilder::buildFaq([]));
}
public function testBuildFaqSkipsEmptyQuestions(): void
{
$faqs = [
['question' => '', 'answer' => 'An answer'],
['question' => 'Valid?', 'answer' => ''],
['question' => ' ', 'answer' => 'Still empty'],
];
$this->assertNull(JsonLdBuilder::buildFaq($faqs));
}
public function testBuildFaqReturnsValidSchema(): void
{
$faqs = [
['question' => 'What is OG?', 'answer' => 'Open Graph protocol.'],
['question' => 'Why use it?', 'answer' => 'Better social previews.'],
];
$result = JsonLdBuilder::buildFaq($faqs);
$this->assertNotNull($result);
$this->assertSame('https://schema.org', $result['@context']);
$this->assertSame('FAQPage', $result['@type']);
$this->assertCount(2, $result['mainEntity']);
$this->assertSame('Question', $result['mainEntity'][0]['@type']);
$this->assertSame('What is OG?', $result['mainEntity'][0]['name']);
$this->assertSame('Open Graph protocol.', $result['mainEntity'][0]['acceptedAnswer']['text']);
}
// ── HowTo ────────────────────────────────────────────────────────
public function testBuildHowToReturnsNullForEmptySteps(): void
{
$this->assertNull(JsonLdBuilder::buildHowTo('Test', []));
$this->assertNull(JsonLdBuilder::buildHowTo('Test', ['', ' ']));
}
public function testBuildHowToReturnsValidSchema(): void
{
$result = JsonLdBuilder::buildHowTo('Install Joomla', ['Download ZIP', 'Upload files', 'Run installer']);
$this->assertNotNull($result);
$this->assertSame('HowTo', $result['@type']);
$this->assertSame('Install Joomla', $result['name']);
$this->assertCount(3, $result['step']);
$this->assertSame(1, $result['step'][0]['position']);
$this->assertSame('HowToStep', $result['step'][0]['@type']);
$this->assertSame('Download ZIP', $result['step'][0]['text']);
$this->assertArrayNotHasKey('image', $result);
}
public function testBuildHowToIncludesImageWhenProvided(): void
{
$result = JsonLdBuilder::buildHowTo('Fix a bike', ['Remove wheel'], 'https://example.com/bike.jpg');
$this->assertNotNull($result);
$this->assertSame('https://example.com/bike.jpg', $result['image']);
}
// ── Recipe ───────────────────────────────────────────────────────
public function testBuildRecipeReturnsNullWhenNoData(): void
{
$data = (object) ['name' => '', 'description' => ''];
$this->assertNull(JsonLdBuilder::buildRecipe($data));
}
public function testBuildRecipeCalculatesTotalTime(): void
{
$data = (object) [
'name' => 'Pasta',
'prepTime' => 'PT15M',
'cookTime' => 'PT30M',
];
$result = JsonLdBuilder::buildRecipe($data);
$this->assertNotNull($result);
$this->assertSame('Recipe', $result['@type']);
$this->assertSame('PT45M', $result['totalTime']);
}
public function testBuildRecipeSplitsIngredientsByNewline(): void
{
$data = (object) [
'name' => 'Salad',
'ingredients' => "Lettuce\nTomato\nOnion",
];
$result = JsonLdBuilder::buildRecipe($data);
$this->assertNotNull($result);
$this->assertSame(['Lettuce', 'Tomato', 'Onion'], $result['recipeIngredient']);
}
// ── Event ────────────────────────────────────────────────────────
public function testBuildEventReturnsNullWithoutStartDate(): void
{
$data = (object) ['name' => 'Conference', 'startDate' => ''];
$this->assertNull(JsonLdBuilder::buildEvent($data));
}
public function testBuildEventIncludesLocationAndOffers(): void
{
$data = (object) [
'name' => 'Tech Summit',
'startDate' => '2026-09-01T09:00:00',
'endDate' => '2026-09-01T17:00:00',
'location' => (object) [
'name' => 'Convention Center',
'address' => '123 Main St',
],
'offers' => (object) [
'price' => '99.00',
'currency' => 'EUR',
'url' => 'https://example.com/tickets',
],
];
$result = JsonLdBuilder::buildEvent($data);
$this->assertNotNull($result);
$this->assertSame('Event', $result['@type']);
$this->assertSame('2026-09-01T09:00:00', $result['startDate']);
$this->assertSame('2026-09-01T17:00:00', $result['endDate']);
$this->assertSame('Place', $result['location']['@type']);
$this->assertSame('Convention Center', $result['location']['name']);
$this->assertSame('Offer', $result['offers']['@type']);
$this->assertSame('99.00', $result['offers']['price']);
$this->assertSame('EUR', $result['offers']['priceCurrency']);
}
// ── LocalBusiness ────────────────────────────────────────────────
public function testBuildLocalBusinessReturnsNullWithoutName(): void
{
$params = $this->createParamsMock([]);
$this->assertNull(JsonLdBuilder::buildLocalBusiness($params));
}
public function testBuildLocalBusinessIncludesAddress(): void
{
$params = $this->createParamsMock([
'business_name' => 'Moko Consulting',
'street_address' => '456 Oak Ave',
'city' => 'Austin',
'region' => 'TX',
'postal_code' => '78701',
'country' => 'US',
'telephone' => '+1-555-0100',
]);
$result = JsonLdBuilder::buildLocalBusiness($params);
$this->assertNotNull($result);
$this->assertSame('LocalBusiness', $result['@type']);
$this->assertSame('Moko Consulting', $result['name']);
$this->assertSame('PostalAddress', $result['address']['@type']);
$this->assertSame('456 Oak Ave', $result['address']['streetAddress']);
$this->assertSame('Austin', $result['address']['addressLocality']);
$this->assertSame('TX', $result['address']['addressRegion']);
$this->assertSame('78701', $result['address']['postalCode']);
$this->assertSame('US', $result['address']['addressCountry']);
$this->assertSame('+1-555-0100', $result['telephone']);
}
// ── VideoObject ──────────────────────────────────────────────────
public function testBuildVideoReturnsNullForEmptyUrl(): void
{
$this->assertNull(JsonLdBuilder::buildVideo(''));
}
public function testBuildVideoAddsEmbedUrlForYoutube(): void
{
$result = JsonLdBuilder::buildVideo(
'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
'Test Video',
'A description'
);
$this->assertNotNull($result);
$this->assertSame('VideoObject', $result['@type']);
$this->assertSame('https://www.youtube.com/watch?v=dQw4w9WgXcQ', $result['contentUrl']);
$this->assertSame('https://www.youtube.com/embed/dQw4w9WgXcQ', $result['embedUrl']);
$this->assertSame('Test Video', $result['name']);
}
// ── toScriptTag ──────────────────────────────────────────────────
public function testToScriptTagEscapesClosingScriptTags(): void
{
$schema = [
'@context' => 'https://schema.org',
'@type' => 'Article',
'headline' => 'Test </script><script>alert(1)</script>',
];
$output = JsonLdBuilder::toScriptTag($schema);
$this->assertStringStartsWith('<script type="application/ld+json">', $output);
$this->assertStringEndsWith('</script>', $output);
// The closing </script> inside the JSON must be escaped
$this->assertStringNotContainsString('</script><script>', $output);
$this->assertStringContainsString('<\\/script>', $output);
}
// ── Helper ───────────────────────────────────────────────────────
/**
* Create a mock object that mimics Joomla's Registry->get($key, $default).
*/
private function createParamsMock(array $values): object
{
return new class ($values) {
private array $data;
public function __construct(array $data)
{
$this->data = $data;
}
public function get(string $key, mixed $default = ''): mixed
{
return $this->data[$key] ?? $default;
}
};
}
}
-13
View File
@@ -1,13 +0,0 @@
<?php
/**
* @package MokoSuiteOpenGraph
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
*/
define('_JEXEC', 1);
require_once __DIR__ . '/../vendor/autoload.php';