Compare commits

..

53 Commits

Author SHA1 Message Date
jmiller ef8e3bcfcf chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 2026-06-04 15:58:49 +00:00
jmiller adf55bc2b2 chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 2026-06-04 15:41:38 +00:00
jmiller cd8c1826fe chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 2026-06-04 15:32:49 +00:00
jmiller 0adc05fa2b chore: remove updates.xml [skip ci] 2026-06-04 15:27:09 +00:00
jmiller 1c1d168ffb chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 2026-06-04 15:19:40 +00:00
jmiller 824026ace2 feat(update): migrate update server URL to Gitea Pages [skip ci] 2026-06-04 14:34:06 +00:00
jmiller 55e47a4913 chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-06-04 14:23:58 +00:00
jmiller 1b3c70dec6 chore: sync .mokogitea/workflows/repo-health.yml from moko-platform [skip ci] 2026-06-04 13:47:42 +00:00
Moko Consulting cec5f192c3 chore(ci): add CI issue reporter for auto-filing gate failures
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Generic: Repo Health / Release configuration (push) Has been cancelled
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
2026-06-02 20:38:39 +00:00
Moko Consulting 554818cc10 chore(ci): add CI issue reporter for auto-filing gate failures
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Generic: Repo Health / Release configuration (push) Has been cancelled
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
2026-06-02 20:38:39 +00:00
Moko Consulting 65b48b65ba chore(ci): add CI issue reporter for auto-filing gate failures
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Generic: Repo Health / Release configuration (push) Has been cancelled
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
2026-06-02 20:38:38 +00:00
jmiller 173c868a56 chore: sync .mokogitea/workflows/cascade-dev.yml from moko-platform [skip ci] 2026-05-31 01:42:52 +00:00
jmiller 7836522d8a chore: sync CONTRIBUTING.md from moko-platform [skip ci] 2026-05-31 01:10:54 +00:00
jmiller 786ce1b14a chore: add .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 2026-05-30 16:02:17 +00:00
jmiller f5fd4ac8da chore: sync CONTRIBUTING.md from moko-platform [skip ci] 2026-05-30 15:00:27 +00:00
jmiller 6f67bf97bd chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-30 14:56:55 +00:00
jmiller d947a0e259 chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 2026-05-30 14:54:57 +00:00
jmiller 334c90fa02 chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 2026-05-30 05:52:02 +00:00
jmiller bbca20d795 chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-30 03:41:55 +00:00
jmiller 705e2a2eaf chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-30 01:15:35 +00:00
jmiller 61ce28c29e chore: add .mokogitea/branch-protection.yml from moko-platform [skip ci] 2026-05-29 10:30:49 +00:00
jmiller efd604808e chore: add CONTRIBUTING.md from moko-platform [skip ci] 2026-05-29 10:28:12 +00:00
jmiller 92efb3b4de chore: add .mokogitea/workflows/branch-cleanup.yml from moko-platform [skip ci] 2026-05-29 10:26:36 +00:00
jmiller 6ae4ff9b83 chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-29 10:25:09 +00:00
jmiller f0501d562c chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 2026-05-29 10:23:40 +00:00
jmiller 4606bec029 chore: sync updates.xml from development [skip ci] 2026-05-29 05:29:03 +00:00
jmiller 91e9a1005a chore: sync updates.xml from development [skip ci] 2026-05-29 05:13:42 +00:00
jmiller f4c4daee05 chore: sync updates.xml from development [skip ci] 2026-05-29 03:56:03 +00:00
jmiller 6696d08607 chore: sync updates.xml from development [skip ci] 2026-05-29 03:52:44 +00:00
jmiller 1150455e43 chore: sync updates.xml from development [skip ci] 2026-05-29 03:48:33 +00:00
jmiller b78609c929 chore: sync updates.xml from development [skip ci] 2026-05-29 03:33:54 +00:00
jmiller 1b40c627e2 chore: sync updates.xml from development [skip ci] 2026-05-29 00:14:14 +00:00
jmiller 3a57ae1584 chore: sync updates.xml from development [skip ci] 2026-05-28 23:56:28 +00:00
jmiller baacbb82a7 chore: sync updates.xml from development [skip ci] 2026-05-28 23:47:06 +00:00
jmiller 493666cabb chore: sync updates.xml from development [skip ci] 2026-05-28 22:40:19 +00:00
jmiller a6be4af9d0 chore: sync updates.xml from development [skip ci] 2026-05-28 22:05:04 +00:00
jmiller bc5976ef1a chore: sync updates.xml from development [skip ci] 2026-05-28 21:51:15 +00:00
jmiller e25846fded chore: sync .mokogitea/workflows/pre-release.yml from moko-platform [skip ci] 2026-05-28 20:54:27 +00:00
jmiller 466448719b chore: sync .mokogitea/workflows/update-server.yml from moko-platform [skip ci] 2026-05-28 20:49:20 +00:00
jmiller 37edd57f85 chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-28 20:44:39 +00:00
jmiller 2df322841e chore: sync updates.xml from development [skip ci] 2026-05-28 20:38:49 +00:00
jmiller 302851abb7 chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2026-05-28 20:38:43 +00:00
jmiller ea4e211175 chore: sync updates.xml from development [skip ci] 2026-05-28 20:06:51 +00:00
jmiller 48b2745c42 chore: sync updates.xml from development [skip ci] 2026-05-28 19:53:46 +00:00
jmiller abc73045be chore: sync updates.xml from development [skip ci] 2026-05-28 19:41:42 +00:00
jmiller c244751bb0 chore: sync updates.xml from development [skip ci] 2026-05-28 19:33:23 +00:00
jmiller 6cd06d0aa0 chore: sync updates.xml from development [skip ci] 2026-05-28 19:00:06 +00:00
jmiller 21fde78e08 chore: sync updates.xml from development [skip ci] 2026-05-28 18:42:23 +00:00
jmiller be850dc676 chore: sync updates.xml from [skip ci] 2026-05-28 18:36:32 +00:00
jmiller 54ea3f46e0 chore: sync updates.xml from [skip ci] 2026-05-28 18:29:40 +00:00
jmiller 988c3a1ef6 chore: sync updates.xml from [skip ci] 2026-05-28 18:19:52 +00:00
jmiller 84da84b62d chore: sync updates.xml from [skip ci] 2026-05-28 18:11:33 +00:00
jmiller 8dc3234bd4 chore: sync updates.xml from [skip ci] 2026-05-28 17:55:20 +00:00
454 changed files with 2547 additions and 14697 deletions
+251
View File
@@ -0,0 +1,251 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
# SPDX-License-Identifier: GPL-3.0-or-later
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Automation
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /.gitea/workflows/branch-protection.yml
# BRIEF: Apply standardised branch protection rules to all governed repositories
#
# +========================================================================+
# | BRANCH PROTECTION SETUP |
# +========================================================================+
# | |
# | Applies protection rules for: main, dev, rc, beta, alpha |
# | |
# | main — Require PR, block rejected reviews, no force push |
# | dev — Allow push, no force push, no delete |
# | rc — Allow push, no force push, no delete |
# | beta — Allow push, no force push, no delete |
# | alpha — Allow push, no force push, no delete |
# | |
# | jmiller has override authority on all branches. |
# | |
# +========================================================================+
name: Branch Protection Setup
on:
schedule:
- cron: '0 2 * * 1' # Weekly Monday 02:00 UTC
workflow_dispatch:
inputs:
dry_run:
description: 'Preview mode (no changes)'
required: false
type: boolean
default: false
repos:
description: 'Comma-separated repo names (empty = all governed repos)'
required: false
type: string
default: ''
env:
GITEA_URL: https://git.mokoconsulting.tech
GITEA_ORG: MokoConsulting
permissions:
contents: read
jobs:
protect:
name: Apply Branch Protection Rules
runs-on: ubuntu-latest
steps:
- name: Determine target repos
id: repos
env:
GA_TOKEN: ${{ secrets.GA_TOKEN }}
run: |
API="${GITEA_URL}/api/v1"
# Platform/standards/infra repos to exclude
EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private MokoStandards moko-platform MokoTesting"
EXCLUDE="$EXCLUDE MokoStandards-Template-Client MokoStandards-Template-Dolibarr MokoStandards-Template-Generic MokoStandards-Template-Joomla MokoDoliProjTemplate"
if [ -n "${{ inputs.repos }}" ]; then
# User-specified repos
REPOS=$(echo "${{ inputs.repos }}" | tr ',' ' ')
else
# Fetch all org repos
PAGE=1
REPOS=""
while true; do
BATCH=$(curl -sS \
-H "Authorization: token ${GA_TOKEN}" \
"${API}/orgs/${GITEA_ORG}/repos?page=${PAGE}&limit=50" \
| jq -r '.[].name // empty')
[ -z "$BATCH" ] && break
REPOS="$REPOS $BATCH"
PAGE=$((PAGE + 1))
done
# Filter out excluded repos
FILTERED=""
for REPO in $REPOS; do
SKIP=false
for EX in $EXCLUDE; do
if [ "$REPO" = "$EX" ]; then
SKIP=true
break
fi
done
if [ "$SKIP" = "false" ]; then
FILTERED="$FILTERED $REPO"
fi
done
REPOS="$FILTERED"
fi
echo "repos=$REPOS" >> "$GITHUB_OUTPUT"
COUNT=$(echo "$REPOS" | wc -w)
echo "📋 Target repos (${COUNT}): $REPOS"
- name: Apply protection rules
env:
GA_TOKEN: ${{ secrets.GA_TOKEN }}
DRY_RUN: ${{ inputs.dry_run || 'false' }}
run: |
API="${GITEA_URL}/api/v1"
REPOS="${{ steps.repos.outputs.repos }}"
SUCCESS=0
FAILED=0
SKIPPED=0
# ── Rule definitions ──────────────────────────────────────
# Only the CI bot (jmiller token) can push directly.
# All human contributors must use PRs.
# Force push disabled on all branches.
RULE_MAIN='{
"rule_name": "main",
"enable_push": true,
"enable_push_whitelist": true,
"push_whitelist_usernames": ["jmiller"],
"enable_force_push": false,
"enable_force_push_allowlist": false,
"force_push_allowlist_usernames": [],
"enable_merge_whitelist": false,
"required_approvals": 0,
"dismiss_stale_approvals": true,
"block_on_rejected_reviews": true,
"block_on_outdated_branch": false,
"priority": 1
}'
RULE_DEV='{
"rule_name": "dev",
"enable_push": true,
"enable_push_whitelist": true,
"push_whitelist_usernames": ["jmiller"],
"enable_force_push": false,
"enable_force_push_allowlist": false,
"force_push_allowlist_usernames": [],
"enable_merge_whitelist": false,
"required_approvals": 0,
"block_on_rejected_reviews": false,
"priority": 2
}'
RULE_RC='{
"rule_name": "rc",
"enable_push": true,
"enable_push_whitelist": true,
"push_whitelist_usernames": ["jmiller"],
"enable_force_push": false,
"enable_force_push_allowlist": false,
"force_push_allowlist_usernames": [],
"enable_merge_whitelist": false,
"required_approvals": 0,
"block_on_rejected_reviews": false,
"priority": 3
}'
RULE_BETA='{
"rule_name": "beta",
"enable_push": true,
"enable_push_whitelist": true,
"push_whitelist_usernames": ["jmiller"],
"enable_force_push": false,
"enable_force_push_allowlist": false,
"force_push_allowlist_usernames": [],
"enable_merge_whitelist": false,
"required_approvals": 0,
"block_on_rejected_reviews": false,
"priority": 4
}'
RULE_ALPHA='{
"rule_name": "alpha",
"enable_push": true,
"enable_push_whitelist": true,
"push_whitelist_usernames": ["jmiller"],
"enable_force_push": false,
"enable_force_push_allowlist": false,
"force_push_allowlist_usernames": [],
"enable_merge_whitelist": false,
"required_approvals": 0,
"block_on_rejected_reviews": false,
"priority": 5
}'
RULES=("$RULE_MAIN" "$RULE_DEV" "$RULE_RC" "$RULE_BETA" "$RULE_ALPHA")
RULE_NAMES=("main" "dev" "rc" "beta" "alpha")
# ── Apply rules to each repo ──────────────────────────────
for REPO in $REPOS; do
echo ""
echo "═══ ${REPO} ═══"
for i in "${!RULES[@]}"; do
RULE="${RULES[$i]}"
NAME="${RULE_NAMES[$i]}"
if [ "$DRY_RUN" = "true" ]; then
echo " [DRY RUN] Would apply rule: ${NAME}"
SKIPPED=$((SKIPPED + 1))
continue
fi
# Delete existing rule if present (idempotent recreate)
ENCODED_NAME=$(echo "$NAME" | sed 's|/|%2F|g')
curl -sS -o /dev/null -w "" \
-X DELETE \
-H "Authorization: token ${GA_TOKEN}" \
"${API}/repos/${GITEA_ORG}/${REPO}/branch_protections/${ENCODED_NAME}" 2>/dev/null || true
# Create rule
RESPONSE=$(curl -sS -w "\n%{http_code}" \
-X POST \
-H "Authorization: token ${GA_TOKEN}" \
-H "Content-Type: application/json" \
-d "$RULE" \
"${API}/repos/${GITEA_ORG}/${REPO}/branch_protections")
HTTP=$(echo "$RESPONSE" | tail -1)
BODY=$(echo "$RESPONSE" | sed '$d')
if [ "$HTTP" = "201" ]; then
echo " ✅ ${NAME}"
SUCCESS=$((SUCCESS + 1))
else
echo " ❌ ${NAME} (HTTP ${HTTP}): $(echo "$BODY" | jq -r '.message // .' 2>/dev/null | head -1)"
FAILED=$((FAILED + 1))
fi
done
done
# ── Summary ───────────────────────────────────────────────
echo ""
echo "════════════════════════════════════════"
echo " ✅ Success: ${SUCCESS}"
echo " ❌ Failed: ${FAILED}"
echo " ⏭️ Skipped: ${SKIPPED}"
echo "════════════════════════════════════════"
if [ "$FAILED" -gt 0 ]; then
echo "::warning::${FAILED} rule(s) failed to apply"
fi
+1 -2
View File
@@ -4,8 +4,7 @@
<name>MokoJoomCross</name>
<org>MokoConsulting</org>
<description>Cross-posting Joomla content to social media, email marketing, and chat platforms</description>
<version>01.00.06-dev-dev</version>
<version>01.00.13</version>
<version>01.00.00-dev</version>
<license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
</identity>
<governance>
+66 -85
View File
@@ -1,85 +1,66 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Release
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /.mokogitea/workflows/auto-bump.yml
# VERSION: 09.02.00
# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
name: "Universal: Auto Version Bump"
on:
push:
branches:
- dev
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
permissions:
contents: write
jobs:
bump:
name: Version Bump
runs-on: release
if: >-
!contains(github.event.head_commit.message, '[skip ci]') &&
!contains(github.event.head_commit.message, '[skip bump]') &&
!startsWith(github.event.head_commit.message, 'Merge pull request')
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 1
- name: Setup moko-platform tools
run: |
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
if [ -d "/opt/moko-platform/cli" ]; then
echo "MOKO_CLI=/opt/moko-platform/cli" >> "$GITHUB_ENV"
else
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
echo "MOKO_CLI=/tmp/moko-platform-api/cli" >> "$GITHUB_ENV"
fi
- name: Bump version
run: |
BUMP=$(php ${MOKO_CLI}/version_bump.php --path . 2>&1) || true
echo "$BUMP"
VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null) || true
[ -z "$VERSION" ] && { echo "No version found — skipping"; exit 0; }
# Propagate to platform manifests with -dev suffix
php ${MOKO_CLI}/version_set_platform.php \
--path . --version "$VERSION" --branch dev --stability dev 2>/dev/null || true
php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
VERSION="${VERSION}-dev"
# Commit if anything changed
if git diff --quiet && git diff --cached --quiet; then
echo "No version changes to commit"
exit 0
fi
git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "gitea-actions[bot]"
git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
git add -A
git commit -m "chore(version): auto-bump patch ${VERSION} [skip ci]" \
--author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
git push origin dev
echo "Bumped to ${VERSION}" >> $GITHUB_STEP_SUMMARY
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Release
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /.mokogitea/workflows/auto-bump.yml
# VERSION: 09.02.00
# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
name: "Universal: Auto Version Bump"
on:
push:
branches:
- dev
- rc
- 'feature/**'
- 'patch/**'
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
permissions:
contents: write
jobs:
bump:
name: Version Bump
runs-on: release
if: >-
!contains(github.event.head_commit.message, '[skip ci]') &&
!contains(github.event.head_commit.message, '[skip bump]') &&
!startsWith(github.event.head_commit.message, 'Merge pull request')
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 1
- name: Setup moko-platform tools
run: |
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
if [ -d "/opt/moko-platform/cli" ]; then
echo "MOKO_CLI=/opt/moko-platform/cli" >> "$GITHUB_ENV"
else
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
echo "MOKO_CLI=/tmp/moko-platform-api/cli" >> "$GITHUB_ENV"
fi
- name: Bump version
run: |
php ${MOKO_CLI}/version_auto_bump.php \
--path . --branch "${GITHUB_REF_NAME}" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--repo-url "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
+285 -531
View File
@@ -1,531 +1,285 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Release
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
# PATH: /templates/workflows/universal/auto-release.yml.template
# VERSION: 05.00.00
# BRIEF: Universal build & release detects platform from manifest.xml
#
# +========================================================================+
# | UNIVERSAL BUILD & RELEASE PIPELINE |
# +========================================================================+
# | |
# | Reads manifest.xml (joomla|dolibarr|generic) to branch logic. |
# | |
# | Platform-specific: |
# | joomla: XML manifest, updates.xml, type-prefixed packages |
# | dolibarr: mod*.class.php, update.txt, dev version reset |
# | generic: README-only, no update stream |
# | |
# +========================================================================+
name: "Universal: Build & Release"
on:
pull_request:
types: [opened, closed]
branches:
- main
workflow_dispatch:
inputs:
action:
description: 'Action to perform'
required: false
type: choice
default: release
options:
- release
- promote-rc
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:
# ── Draft PR → Promote highest pre-release to RC ─────────────────────────────
promote-rc:
name: Promote Pre-Release to RC
runs-on: release
if: >-
(github.event.action == 'opened' && github.event.pull_request.draft == true) ||
(github.event_name == 'workflow_dispatch' && inputs.action == 'promote-rc')
steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 1
- name: Setup moko-platform tools
env:
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
run: |
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
# Always fetch latest CLI tools — never use stale cache from previous runs
rm -rf /tmp/moko-platform-api
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api
composer install --no-dev --no-interaction --quiet
- name: Promote to release-candidate
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_promote.php \
--from auto --to release-candidate \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--api-base "${API_BASE}" \
--branch "${{ github.event.pull_request.head.ref || 'dev' }}"
- name: Cascade lesser channels
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_cascade.php \
--stability release-candidate \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--api-base "${API_BASE}"
- name: Summary
if: always()
run: |
echo "## Promoted to Release Candidate" >> $GITHUB_STEP_SUMMARY
echo "Draft PR opened — promoted highest pre-release to RC" >> $GITHUB_STEP_SUMMARY
# ── Merged PR → Build & Release (or promote RC to stable) ────────────────────
release:
name: Build & Release Pipeline
runs-on: release
if: >-
github.event.pull_request.merged == true ||
(github.event_name == 'workflow_dispatch' && inputs.action != 'promote-rc')
steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 0
- name: Configure git for bot pushes
run: |
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"
- name: Setup moko-platform tools
env:
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN }}"}}'
run: |
# Ensure PHP + Composer are available
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
# Always fetch latest CLI tools — never use stale cache from previous runs
rm -rf /tmp/moko-platform-api
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api
composer install --no-dev --no-interaction --quiet
# -- PLATFORM DETECTION ---------------------------------------------------
- name: Detect platform
id: platform
run: |
php /tmp/moko-platform-api/cli/manifest_read.php --path . --github-output
MANIFEST=$(find . -maxdepth 3 -name "*.xml" ! -path "./.git/*" -exec grep -l '<extension' {} \; 2>/dev/null | head -1 || true)
MOD_FILE=$(find . -maxdepth 4 -name "mod*.class.php" ! -path "./.git/*" -exec grep -l 'extends DolibarrModules' {} \; 2>/dev/null | head -1 || true)
echo "manifest=${MANIFEST}" >> "$GITHUB_OUTPUT"
echo "mod_file=${MOD_FILE}" >> "$GITHUB_OUTPUT"
- name: "Step 1: Read version"
id: version
run: |
VERSION=$(php /tmp/moko-platform-api/cli/version_read.php --path .)
if [ -z "$VERSION" ]; then
echo "::error::No VERSION in README.md"
echo "skip=true" >> "$GITHUB_OUTPUT"
exit 0
fi
# Strip any pre-release suffix merged from dev (e.g. 01.02.20-dev → 01.02.20)
VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
MAJOR=$(echo "$VERSION" | cut -d. -f1)
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
echo "release_tag=stable" >> "$GITHUB_OUTPUT"
echo "skip=false" >> "$GITHUB_OUTPUT"
echo "branch=main" >> "$GITHUB_OUTPUT"
# -- CHECK FOR RC PROMOTION ------------------------------------------------
- name: "Check for RC release"
id: rc
if: steps.version.outputs.skip != 'true'
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
RC_JSON=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
"${API_BASE}/releases/tags/release-candidate" 2>/dev/null || echo "{}")
RC_ID=$(echo "$RC_JSON" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('id',''))" 2>/dev/null || true)
if [ -n "$RC_ID" ] && [ "$RC_ID" != "None" ] && [ "$RC_ID" != "" ]; then
echo "promote=true" >> "$GITHUB_OUTPUT"
echo "release_id=${RC_ID}" >> "$GITHUB_OUTPUT"
echo "::notice::RC release found (id: ${RC_ID}) — will promote to stable"
else
echo "promote=false" >> "$GITHUB_OUTPUT"
echo "::notice::No RC release — full build pipeline"
fi
- name: "Step 1b: Minor bump version"
id: bump
if: >-
steps.version.outputs.skip != 'true' &&
steps.rc.outputs.promote != 'true'
run: |
MOKO_API="/tmp/moko-platform-api/cli"
php ${MOKO_API}/version_bump.php --path . --minor 2>&1 || true
VERSION=$(php ${MOKO_API}/version_read.php --path .)
# Strip any pre-release suffix — stable releases have no suffix
VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
echo "Bumped to: ${VERSION}"
- name: Check if already released
if: steps.version.outputs.skip != 'true'
id: check
run: |
TAG="${{ steps.version.outputs.release_tag }}"
BRANCH="${{ steps.version.outputs.branch }}"
TAG_EXISTS=false
BRANCH_EXISTS=false
git rev-parse "$TAG" >/dev/null 2>&1 && TAG_EXISTS=true
git ls-remote --heads origin "$BRANCH" 2>/dev/null | grep -q "$BRANCH" && BRANCH_EXISTS=true
echo "tag_exists=$TAG_EXISTS" >> "$GITHUB_OUTPUT"
echo "branch_exists=$BRANCH_EXISTS" >> "$GITHUB_OUTPUT"
# Tag and branch may persist across patch releases — never skip
echo "already_released=false" >> "$GITHUB_OUTPUT"
# -- SANITY CHECKS -------------------------------------------------------
- name: "Sanity: Pre-release validation"
if: >-
steps.version.outputs.skip != 'true' &&
steps.check.outputs.already_released != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
php /tmp/moko-platform-api/cli/release_validate.php \
--path . --version "$VERSION" --output-summary --github-output || true
# -- STEP 2: Create or update version/XX.YY archive branch ---------------
# Always runs — every version change on main archives to version/XX.YY
- name: "Step 2: Version archive branch"
if: steps.check.outputs.already_released != 'true'
run: |
BRANCH="${{ steps.version.outputs.branch }}"
IS_MINOR="${{ steps.version.outputs.is_minor }}"
PATCH="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
PATCH_NUM=$(echo "$PATCH" | awk -F. '{print $3}')
# Check if branch exists
if git ls-remote --heads origin "$BRANCH" | grep -q "$BRANCH"; then
git push origin HEAD:"$BRANCH" --force
echo "Updated archive branch: ${BRANCH} (patch ${PATCH_NUM})" >> $GITHUB_STEP_SUMMARY
else
git checkout -b "$BRANCH" 2>/dev/null || git checkout "$BRANCH"
git push origin "$BRANCH" --force
echo "Created archive branch: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
fi
# -- STEP 3: Set platform version ----------------------------------------
- name: "Step 3: Set platform version"
if: >-
steps.version.outputs.skip != 'true' &&
steps.check.outputs.already_released != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
php /tmp/moko-platform-api/cli/version_set_platform.php \
--path . --version "$VERSION" --branch main
# -- STEP 4: Update version badges ----------------------------------------
- name: "Step 4: Update version badges"
if: steps.version.outputs.skip != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
php /tmp/moko-platform-api/cli/badge_update.php --path . --version "${VERSION}" 2>/dev/null || true
php /tmp/moko-platform-api/cli/version_check.php --path . --fix 2>/dev/null || true
# Step 5 (updates.xml) moved after Step 8 to include SHA-256 checksum
- name: "Step 4b: Promote and prune CHANGELOG"
if: >-
steps.version.outputs.skip != 'true' &&
steps.check.outputs.already_released != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
MOKO_API="/tmp/moko-platform-api/cli"
if [ -f "CHANGELOG.md" ]; then
php ${MOKO_API}/changelog_promote.php --path . --version "$VERSION" 2>&1 || true
php ${MOKO_API}/changelog_prune.php --path . --keep 5 2>&1 || true
fi
- name: Commit release changes
if: >-
steps.version.outputs.skip != 'true' &&
steps.check.outputs.already_released != 'true'
run: |
if git diff --quiet && git diff --cached --quiet; then
echo "No changes to commit"
exit 0
fi
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
git add -A
git commit -m "chore(release): build ${VERSION} [skip ci]" \
--author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
# Detached HEAD on PR merge — push explicitly to main
git push origin HEAD:refs/heads/main
# -- STEP 6: Create tag ---------------------------------------------------
- name: "Step 6: Create git tag"
if: >-
steps.version.outputs.skip != 'true'
run: |
RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
# Only create the major release tag if it doesn't exist yet
if ! git rev-parse "$RELEASE_TAG" >/dev/null 2>&1; then
git tag "$RELEASE_TAG"
git push origin "$RELEASE_TAG"
echo "Tag created: ${RELEASE_TAG}" >> $GITHUB_STEP_SUMMARY
else
echo "Tag ${RELEASE_TAG} already exists" >> $GITHUB_STEP_SUMMARY
fi
echo "Tag: ${TAG}" >> $GITHUB_STEP_SUMMARY
# -- STEP 7a: Promote RC to stable (skip build) ----------------------------
- name: "Step 7a: Promote RC to stable"
if: >-
steps.version.outputs.skip != 'true' &&
steps.rc.outputs.promote == 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_promote.php \
--from release-candidate --to stable \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--api-base "${API_BASE}" \
--path . --branch main
echo "Promoted RC → stable (${VERSION})" >> $GITHUB_STEP_SUMMARY
# -- STEP 7b: Create or update Gitea Release (full build path) -------------
- name: "Step 7b: Gitea Release"
if: >-
steps.version.outputs.skip != 'true' &&
steps.rc.outputs.promote != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_create.php \
--path . --version "$VERSION" --tag "$RELEASE_TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--repo "${GITEA_REPO}" --branch main
echo "Release created: ${VERSION}" >> $GITHUB_STEP_SUMMARY
# -- STEP 8: Build packages and upload to release ----------------------------
- name: "Step 8: Build package and upload"
id: package
if: >-
steps.version.outputs.skip != 'true' &&
steps.rc.outputs.promote != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_package.php \
--path . --version "$VERSION" --tag "$RELEASE_TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--repo "${GITEA_REPO}" --output /tmp || true
# -- STEP 5: Write update stream (after build so SHA-256 is available) -----
- name: "Step 5: Write update stream"
if: steps.version.outputs.skip != 'true'
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
SHA256="${{ steps.package.outputs.sha256_zip }}"
# Fetch latest updates.xml from main so preserve logic has all channels
GITEA_TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
curl -sf -H "Authorization: token ${GITEA_TOKEN}" \
"${API}/contents/updates.xml?ref=main" 2>/dev/null | \
python3 -c "import sys,json,base64; print(base64.b64decode(json.load(sys.stdin)['content']).decode())" \
> updates.xml 2>/dev/null || true
SHA_FLAG=""
[ -n "$SHA256" ] && SHA_FLAG="--sha ${SHA256}"
php /tmp/moko-platform-api/cli/updates_xml_build.php \
--path . --version "${VERSION}" --stability stable \
--gitea-url "${GITEA_URL}" --org "${GITEA_ORG}" --repo "${GITEA_REPO}" \
${SHA_FLAG} --github-output
# Commit updates.xml if changed
if ! git diff --quiet updates.xml 2>/dev/null; then
git add updates.xml
git commit -m "chore: update stable channel ${VERSION} [skip ci]" \
--author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
git push origin HEAD:refs/heads/main 2>&1 || true
fi
# -- STEP 8b: Update release description with changelog ----------------------
- name: "Step 8b: Update release body"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
php /tmp/moko-platform-api/cli/release_body_update.php \
--path . --version "${VERSION}" --tag "${RELEASE_TAG}" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--gitea-url "${GITEA_URL}" --org "${GITEA_ORG}" --repo "${GITEA_REPO}" \
2>&1 || true
echo "Release body updated" >> $GITHUB_STEP_SUMMARY
# -- STEP 9: Mirror to GitHub (stable only) --------------------------------
- name: "Step 9: Mirror release to GitHub"
if: >-
steps.version.outputs.skip != 'true' &&
secrets.GH_MIRROR_TOKEN != ''
continue-on-error: true
run: |
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}"
php /tmp/moko-platform-api/cli/release_mirror.php \
--version "$VERSION" --tag "$RELEASE_TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--gh-token "${{ secrets.GH_MIRROR_TOKEN }}" --gh-repo "$GH_REPO" \
--branch main 2>&1 || true
echo "GitHub mirror updated" >> $GITHUB_STEP_SUMMARY
# -- STEP 10: Sync main branch to GitHub mirror ----------------------------
- name: "Step 10: Push main to GitHub mirror"
if: >-
steps.version.outputs.skip != 'true' &&
secrets.GH_MIRROR_TOKEN != ''
continue-on-error: true
run: |
GH_REPO="${{ vars.GH_MIRROR_REPO || github.repository }}"
GH_ORG=$(echo "$GH_REPO" | cut -d/ -f1)
GH_NAME=$(echo "$GH_REPO" | cut -d/ -f2)
git remote add github "https://x-access-token:${{ secrets.GH_MIRROR_TOKEN }}@github.com/${GH_ORG}/${GH_NAME}.git" 2>/dev/null || \
git remote set-url github "https://x-access-token:${{ secrets.GH_MIRROR_TOKEN }}@github.com/${GH_ORG}/${GH_NAME}.git"
git fetch origin main --depth=1
git push github origin/main:refs/heads/main --force 2>/dev/null \
&& echo "main branch pushed to GitHub mirror" \
|| echo "WARNING: GitHub mirror push failed"
# -- Clean up lesser pre-releases (cascade) ---------------------------------
# stable → deletes all | rc → beta,alpha,dev | beta → alpha,dev | alpha → dev
- name: "Delete lesser pre-release channels"
continue-on-error: true
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/release_cascade.php \
--stability stable \
--version "${VERSION}" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--api-base "${API_BASE}" 2>/dev/null || true
- name: "Step 11: Delete and recreate dev branch from main"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
# Delete dev branch
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
"${API_BASE}/branches/dev" 2>/dev/null && echo "Deleted dev branch"
# Recreate dev from main (now includes version bump + changelog promotion)
curl -sf -X POST -H "Authorization: token ${TOKEN}" \
-H "Content-Type: application/json" \
"${API_BASE}/branches" \
-d '{"new_branch_name":"dev","old_branch_name":"main"}' 2>/dev/null && echo "Recreated dev from main"
echo "Dev branch reset from main (keeps dev ahead after release)" >> $GITHUB_STEP_SUMMARY
- name: "Step 12: Create version branch from main"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_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}"
MAIN_SHA=$(git rev-parse HEAD)
# Delete old version branch if it exists (same version re-release)
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" "${API_BASE}/branches/${BRANCH_NAME}" 2>/dev/null && echo "Deleted old ${BRANCH_NAME}"
# Create version/XX.YY.ZZ from main
curl -sf -X POST -H "Authorization: token ${TOKEN}" -H "Content-Type: application/json" "${API_BASE}/branches" -d "{\"new_branch_name\":\"${BRANCH_NAME}\",\"old_branch_name\":\"main\"}" 2>/dev/null && echo "Created ${BRANCH_NAME} from main (${MAIN_SHA})" || echo "WARNING: ${BRANCH_NAME} creation failed"
echo "Version branch created: ${BRANCH_NAME} (${MAIN_SHA})" >> $GITHUB_STEP_SUMMARY
# -- Dolibarr post-release: Reset dev version -----------------------------
- name: "Post-release: Reset dev version"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/version_reset_dev.php \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "${API_BASE}" \
--branch dev --path . 2>&1 || true
# -- Summary --------------------------------------------------------------
- name: Pipeline Summary
if: always()
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
PLATFORM="${{ steps.platform.outputs.platform }}"
if [ "${{ steps.version.outputs.skip }}" = "true" ]; then
echo "## Release Skipped" >> $GITHUB_STEP_SUMMARY
echo "No VERSION in README.md" >> $GITHUB_STEP_SUMMARY
elif [ "${{ steps.check.outputs.already_released }}" = "true" ]; then
echo "## Already Released — ${VERSION}" >> $GITHUB_STEP_SUMMARY
else
echo "" >> $GITHUB_STEP_SUMMARY
echo "## Build & Release Complete (${PLATFORM})" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "| Step | Result |" >> $GITHUB_STEP_SUMMARY
echo "|------|--------|" >> $GITHUB_STEP_SUMMARY
echo "| Platform | \`${PLATFORM}\` |" >> $GITHUB_STEP_SUMMARY
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
fi
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Release
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
# PATH: /templates/workflows/universal/auto-release.yml.template
# VERSION: 05.00.00
# BRIEF: Universal build & release detects platform from manifest.xml
#
# +========================================================================+
# | UNIVERSAL BUILD & RELEASE PIPELINE |
# +========================================================================+
# | |
# | Reads manifest.xml (joomla|dolibarr|generic) to branch logic. |
# | |
# | Platform-specific: |
# | joomla: XML manifest, updates.xml, type-prefixed packages |
# | dolibarr: mod*.class.php, update.txt, dev version reset |
# | generic: README-only, no update stream |
# | |
# +========================================================================+
name: "Universal: Build & Release"
on:
pull_request:
types: [opened, closed]
branches:
- main
workflow_dispatch:
inputs:
action:
description: 'Action to perform'
required: false
type: choice
default: release
options:
- release
- promote-rc
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:
# ── PR Opened → Rename branch to RC and build RC release ─────────────────────
promote-rc:
name: Promote to RC
runs-on: release
if: >-
(github.event.action == 'opened' && github.event.pull_request.merged != true) ||
(github.event_name == 'workflow_dispatch' && inputs.action == 'promote-rc')
steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 1
- name: Setup moko-platform tools
env:
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
run: |
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
# Always fetch latest CLI tools — never use stale cache from previous runs
rm -rf /tmp/moko-platform-api
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api
composer install --no-dev --no-interaction --quiet
- name: Rename branch to rc
run: |
php /tmp/moko-platform-api/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}" \
--pr "${{ github.event.pull_request.number }}"
- name: Checkout rc and configure git
run: |
git fetch origin rc
git checkout rc
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"
- name: Publish RC release
run: |
php /tmp/moko-platform-api/cli/release_publish.php \
--path . --stability rc --bump minor --branch rc \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--skip-update-stream
- name: Summary
if: always()
run: |
echo "## Promoted to Release Candidate" >> $GITHUB_STEP_SUMMARY
echo "Branch renamed to rc, minor bump, RC release built (updates.xml managed by Gitea Pages)" >> $GITHUB_STEP_SUMMARY
# ── Merged PR → Build & Release (or promote RC to stable) ────────────────────
release:
name: Build & Release Pipeline
runs-on: release
if: >-
github.event.pull_request.merged == true ||
(github.event_name == 'workflow_dispatch' && inputs.action != 'promote-rc')
steps:
- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
token: ${{ secrets.MOKOGITEA_TOKEN }}
fetch-depth: 0
- name: Configure git for bot pushes
run: |
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"
- name: Check for merge conflict markers
run: |
CONFLICTS=$(grep -rn '<<<<<<< \|>>>>>>> \|^=======$' --include='*.php' --include='*.xml' --include='*.css' --include='*.js' --include='*.json' --include='*.md' --include='*.yml' --include='*.yaml' --include='*.ini' --include='*.txt' . 2>/dev/null | grep -v '.git/' || true)
if [ -n "$CONFLICTS" ]; then
echo "::error::Merge conflict markers found — aborting release"
echo "## Release Blocked: Conflict Markers" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
echo "$CONFLICTS" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
exit 1
fi
echo "No conflict markers found"
- name: Setup moko-platform tools
env:
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN }}"}}'
run: |
# Ensure PHP + Composer are available
if ! command -v composer &> /dev/null; then
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
fi
# Always fetch latest CLI tools — never use stale cache from previous runs
rm -rf /tmp/moko-platform-api
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
/tmp/moko-platform-api
cd /tmp/moko-platform-api
composer install --no-dev --no-interaction --quiet
- name: "Publish stable release"
run: |
php /tmp/moko-platform-api/cli/release_publish.php \
--path . --stability stable --bump minor --branch main \
--token "${{ secrets.MOKOGITEA_TOKEN }}" \
--skip-update-stream
# -- STEP 9: Mirror to GitHub (stable only) --------------------------------
- name: "Step 9: Mirror release to GitHub"
if: >-
steps.version.outputs.skip != 'true' &&
secrets.GH_MIRROR_TOKEN != ''
continue-on-error: true
run: |
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}"
php /tmp/moko-platform-api/cli/release_mirror.php \
--version "$VERSION" --tag "$RELEASE_TAG" \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
--gh-token "${{ secrets.GH_MIRROR_TOKEN }}" --gh-repo "$GH_REPO" \
--branch main 2>&1 || true
echo "GitHub mirror updated" >> $GITHUB_STEP_SUMMARY
# -- STEP 10: Sync main branch to GitHub mirror ----------------------------
- name: "Step 10: Push main to GitHub mirror"
if: >-
steps.version.outputs.skip != 'true' &&
secrets.GH_MIRROR_TOKEN != ''
continue-on-error: true
run: |
GH_REPO="${{ vars.GH_MIRROR_REPO || github.repository }}"
GH_ORG=$(echo "$GH_REPO" | cut -d/ -f1)
GH_NAME=$(echo "$GH_REPO" | cut -d/ -f2)
git remote add github "https://x-access-token:${{ secrets.GH_MIRROR_TOKEN }}@github.com/${GH_ORG}/${GH_NAME}.git" 2>/dev/null || \
git remote set-url github "https://x-access-token:${{ secrets.GH_MIRROR_TOKEN }}@github.com/${GH_ORG}/${GH_NAME}.git"
git fetch origin main --depth=1
git push github origin/main:refs/heads/main --force 2>/dev/null \
&& echo "main branch pushed to GitHub mirror" \
|| echo "WARNING: GitHub mirror push failed"
- name: "Step 11: Delete rc branch and recreate dev from main"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
# Delete rc branch (ephemeral — created by promote-rc)
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
"${API_BASE}/branches/rc" 2>/dev/null \
&& echo "Deleted rc branch" || echo "rc branch not found"
# Delete dev branch
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
"${API_BASE}/branches/dev" 2>/dev/null && echo "Deleted dev branch"
# Recreate dev from main (now includes version bump + changelog promotion)
curl -sf -X POST -H "Authorization: token ${TOKEN}" \
-H "Content-Type: application/json" \
"${API_BASE}/branches" \
-d '{"new_branch_name":"dev","old_branch_name":"main"}' 2>/dev/null && echo "Recreated dev from main"
echo "Pre-release branches cleaned, dev reset from main" >> $GITHUB_STEP_SUMMARY
- name: "Step 12: Create version branch from main"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_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}"
MAIN_SHA=$(git rev-parse HEAD)
# Delete old version branch if it exists (same version re-release)
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" "${API_BASE}/branches/${BRANCH_NAME}" 2>/dev/null && echo "Deleted old ${BRANCH_NAME}"
# Create version/XX.YY.ZZ from main
curl -sf -X POST -H "Authorization: token ${TOKEN}" -H "Content-Type: application/json" "${API_BASE}/branches" -d "{\"new_branch_name\":\"${BRANCH_NAME}\",\"old_branch_name\":\"main\"}" 2>/dev/null && echo "Created ${BRANCH_NAME} from main (${MAIN_SHA})" || echo "WARNING: ${BRANCH_NAME} creation failed"
echo "Version branch created: ${BRANCH_NAME} (${MAIN_SHA})" >> $GITHUB_STEP_SUMMARY
# -- Dolibarr post-release: Reset dev version -----------------------------
- name: "Post-release: Reset dev version"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
php /tmp/moko-platform-api/cli/version_reset_dev.php \
--token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "${API_BASE}" \
--branch dev --path . 2>&1 || true
# -- Summary --------------------------------------------------------------
- name: Pipeline Summary
if: always()
run: |
VERSION="${{ steps.bump.outputs.version || steps.version.outputs.version }}"
PLATFORM="${{ steps.platform.outputs.platform }}"
if [ "${{ steps.version.outputs.skip }}" = "true" ]; then
echo "## Release Skipped" >> $GITHUB_STEP_SUMMARY
echo "No VERSION in README.md" >> $GITHUB_STEP_SUMMARY
elif [ "${{ steps.check.outputs.already_released }}" = "true" ]; then
echo "## Already Released — ${VERSION}" >> $GITHUB_STEP_SUMMARY
else
echo "" >> $GITHUB_STEP_SUMMARY
echo "## Build & Release Complete (${PLATFORM})" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "| Step | Result |" >> $GITHUB_STEP_SUMMARY
echo "|------|--------|" >> $GITHUB_STEP_SUMMARY
echo "| Platform | \`${PLATFORM}\` |" >> $GITHUB_STEP_SUMMARY
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
fi
+48
View File
@@ -0,0 +1,48 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: MokoStandards.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /.mokogitea/workflows/branch-cleanup.yml
# VERSION: 01.00.00
# BRIEF: Delete feature branches after PR merge
name: "Branch Cleanup"
on:
pull_request:
types: [closed]
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
jobs:
cleanup:
name: Delete merged branch
runs-on: ubuntu-latest
if: >-
github.event.pull_request.merged == true &&
github.event.pull_request.head.ref != 'dev' &&
github.event.pull_request.head.ref != 'main'
steps:
- name: Delete source branch
run: |
BRANCH="${{ github.event.pull_request.head.ref }}"
API="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}/api/v1/repos/${{ github.repository }}/branches"
ENCODED=$(php -r "echo rawurlencode('${BRANCH}');")
STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X DELETE \
-H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
"${API}/${ENCODED}" 2>/dev/null || true)
if [ "$STATUS" = "204" ]; then
echo "Deleted branch: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
elif [ "$STATUS" = "404" ]; then
echo "Branch already deleted: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
else
echo "::warning::Failed to delete branch ${BRANCH} (HTTP ${STATUS})"
fi
+7 -210
View File
@@ -1,213 +1,10 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Maintenance
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
# PATH: /templates/workflows/cascade-dev.yml.template
# VERSION: 02.00.00
# BRIEF: Forward-merge main → all open branches after every push to main
#
# +========================================================================+
# | CASCADE MAIN → ALL BRANCHES |
# +========================================================================+
# | |
# | Triggers on every push to main (PR merges, bot commits, etc.) |
# | |
# | 1. List all branches matching: dev, rc/*, beta/*, alpha/* |
# | 2. For each: create PR (main → branch), auto-merge if clean |
# | 3. On conflict: leave PR open for manual resolution |
# | |
# +========================================================================+
name: "Universal: Cascade Main → Dev"
on:
push:
branches:
- main
workflow_dispatch:
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
pull-requests: write
# DISABLED — auto-release Step 11 recreates dev from main after every release.
# Cascade-dev is redundant and causes version conflicts when both main and dev
# have different version numbers in templateDetails.xml / manifest.xml.
name: "Cascade Main → Dev (DISABLED)"
on: workflow_dispatch
jobs:
cascade:
name: Cascade main → branches
noop:
runs-on: ubuntu-latest
if: >-
!contains(github.event.head_commit.message, '[skip ci]') &&
!contains(github.event.head_commit.message, '[skip cascade]')
steps:
- name: Discover target branches
id: branches
env:
GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
API="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
# Fetch all branches (paginated)
PAGE=1
ALL_BRANCHES=""
while true; do
BATCH=$(curl -sS \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/branches?page=${PAGE}&limit=50" \
| jq -r '.[].name // empty')
[ -z "$BATCH" ] && break
ALL_BRANCHES="$ALL_BRANCHES $BATCH"
PAGE=$((PAGE + 1))
done
# Filter to cascade targets: dev, dev/*, rc/*, beta/*, alpha/*
TARGETS=""
for BRANCH in $ALL_BRANCHES; do
case "$BRANCH" in
dev|dev/*|rc/*|beta/*|alpha/*)
TARGETS="$TARGETS $BRANCH"
;;
esac
done
TARGETS=$(echo "$TARGETS" | xargs) # trim whitespace
if [ -z "$TARGETS" ]; then
echo "targets=" >> "$GITHUB_OUTPUT"
echo "️ No cascade target branches found"
else
echo "targets=$TARGETS" >> "$GITHUB_OUTPUT"
COUNT=$(echo "$TARGETS" | wc -w)
echo "📋 Found ${COUNT} target branch(es): ${TARGETS}"
fi
- name: Cascade to all target branches
if: steps.branches.outputs.targets != ''
env:
GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
API="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
SHORT_SHA="${GITHUB_SHA:0:7}"
TARGETS="${{ steps.branches.outputs.targets }}"
SUCCESS=0
CONFLICTS=0
SKIPPED=0
FAILED=0
for BRANCH in $TARGETS; do
echo ""
echo "═══ main → ${BRANCH} ═══"
# Check if branch is already up to date
ENCODED_BRANCH=$(echo "$BRANCH" | sed 's|/|%2F|g')
RESPONSE=$(curl -sS \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/compare/${ENCODED_BRANCH}...main")
AHEAD=$(echo "$RESPONSE" | jq '.total_commits // 0')
if [ "$AHEAD" -eq 0 ]; then
echo " ✅ Already up to date"
SKIPPED=$((SKIPPED + 1))
continue
fi
echo " ️ main is ${AHEAD} commit(s) ahead"
# Check for existing cascade PR
EXISTING=$(curl -sS \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/pulls?state=open&head=${GITEA_ORG}:main&base=${ENCODED_BRANCH}&limit=1")
EXISTING_COUNT=$(echo "$EXISTING" | jq 'length')
PR_NUMBER=""
if [ "$EXISTING_COUNT" -gt 0 ]; then
PR_NUMBER=$(echo "$EXISTING" | jq -r '.[0].number')
echo " ️ Reusing existing PR #${PR_NUMBER}"
else
# Create cascade PR
PR_RESPONSE=$(curl -sS -w "\n%{http_code}" \
-X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d "{
\"title\": \"chore: cascade main → ${BRANCH} (${SHORT_SHA}) [skip ci]\",
\"body\": \"## Automatic cascade\\n\\nForward-merging \`main\` (${SHORT_SHA}) into \`${BRANCH}\`.\\n\\nIf conflicts exist, resolve manually and merge.\\n\\n> Auto-created by **Cascade Main → Dev**.\",
\"head\": \"main\",
\"base\": \"${BRANCH}\"
}" \
"${API}/pulls")
HTTP_CODE=$(echo "$PR_RESPONSE" | tail -1)
BODY=$(echo "$PR_RESPONSE" | sed '$d')
PR_NUMBER=$(echo "$BODY" | jq -r '.number // empty')
if [ "$HTTP_CODE" != "201" ] || [ -z "$PR_NUMBER" ]; then
MSG=$(echo "$BODY" | jq -r '.message // .' 2>/dev/null | head -1)
echo " ❌ Failed to create PR (HTTP ${HTTP_CODE}): ${MSG}"
FAILED=$((FAILED + 1))
continue
fi
echo " ✅ Created PR #${PR_NUMBER}"
fi
# Try auto-merge
PR_DATA=$(curl -sS \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/pulls/${PR_NUMBER}")
MERGEABLE=$(echo "$PR_DATA" | jq -r '.mergeable // false')
if [ "$MERGEABLE" != "true" ]; then
echo " ⚠️ Conflicts — PR #${PR_NUMBER} left open"
CONFLICTS=$((CONFLICTS + 1))
continue
fi
MERGE_RESPONSE=$(curl -sS -w "\n%{http_code}" \
-X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d "{
\"Do\": \"merge\",
\"merge_message_field\": \"chore: cascade main → ${BRANCH} [skip ci]\",
\"delete_branch_after_merge\": false
}" \
"${API}/pulls/${PR_NUMBER}/merge")
MERGE_HTTP=$(echo "$MERGE_RESPONSE" | tail -1)
if [ "$MERGE_HTTP" = "200" ] || [ "$MERGE_HTTP" = "204" ]; then
echo " ✅ Merged — ${BRANCH} is in sync"
SUCCESS=$((SUCCESS + 1))
else
MERGE_BODY=$(echo "$MERGE_RESPONSE" | sed '$d')
echo " ⚠️ Merge failed (HTTP ${MERGE_HTTP}) — PR #${PR_NUMBER} left open"
CONFLICTS=$((CONFLICTS + 1))
fi
done
# Summary
echo ""
echo "════════════════════════════════════════"
echo " ✅ Merged: ${SUCCESS}"
echo " ⚠️ Conflicts: ${CONFLICTS}"
echo " ⏭️ Up to date: ${SKIPPED}"
echo " ❌ Failed: ${FAILED}"
echo "════════════════════════════════════════"
if [ "$FAILED" -gt 0 ]; then
exit 1
fi
- run: echo "Cascade disabled — auto-release handles dev recreation"
+6 -6
View File
@@ -47,9 +47,9 @@ jobs:
- name: Clone MokoStandards
env:
GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
MOKO_CLONE_HOST: ${{ secrets.MOKOGITEA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
GA_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
MOKO_CLONE_HOST: ${{ secrets.GA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
run: |
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
@@ -57,7 +57,7 @@ jobs:
- name: Install dependencies
env:
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.MOKOGITEA_TOKEN || github.token }}"}}'
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
run: |
if [ -f "composer.json" ]; then
composer install \
@@ -354,7 +354,7 @@ jobs:
- name: Install dependencies
env:
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.MOKOGITEA_TOKEN || github.token }}"}}'
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
run: |
if [ -f "composer.json" ]; then
composer install \
@@ -404,7 +404,7 @@ jobs:
- name: Install dependencies
env:
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.MOKOGITEA_TOKEN || github.token }}"}}'
COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
run: |
if [ -f "composer.json" ]; then
composer install --no-interaction --prefer-dist --optimize-autoloader
+1 -1
View File
@@ -28,7 +28,7 @@ jobs:
steps:
- name: Create branch and comment
run: |
TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
TOKEN="${{ secrets.GA_TOKEN }}"
API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
ISSUE_NUM="${{ github.event.issue.number }}"
ISSUE_TITLE="${{ github.event.issue.title }}"
+508
View File
@@ -0,0 +1,508 @@
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.CI
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
# PATH: /templates/workflows/universal/pr-check.yml.template
# VERSION: 09.23.00
# BRIEF: PR gate — branch policy + code validation before merge
name: "Universal: PR Check"
on:
pull_request:
types: [opened, synchronize, reopened, edited]
permissions:
contents: read
pull-requests: write
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
jobs:
# ── Branch Policy ──────────────────────────────────────────────────────
branch-policy:
name: Branch Policy
runs-on: ubuntu-latest
steps:
- name: Check branch merge target
run: |
HEAD="${{ github.head_ref }}"
BASE="${{ github.base_ref }}"
echo "PR: ${HEAD} → ${BASE}"
ALLOWED=true
REASON=""
case "$HEAD" in
feature/*|feat/*)
if [ "$BASE" != "dev" ]; then
ALLOWED=false
REASON="Feature branches must target 'dev', not '${BASE}'"
fi
;;
fix/*|bugfix/*)
if [ "$BASE" != "dev" ]; then
ALLOWED=false
REASON="Fix branches must target 'dev', not '${BASE}'"
fi
;;
patch/*)
if [ "$BASE" != "dev" ] && [ "$BASE" != "rc" ]; then
ALLOWED=false
REASON="Patch branches must target 'dev' or 'rc', not '${BASE}'"
fi
;;
hotfix/*)
if [ "$BASE" != "dev" ] && [ "$BASE" != "main" ]; then
ALLOWED=false
REASON="Hotfix branches can only target 'dev' or 'main', not '${BASE}'"
fi
;;
rc)
if [ "$BASE" != "main" ]; then
ALLOWED=false
REASON="RC branch can only merge into 'main', not '${BASE}'"
fi
;;
dev)
if [ "$BASE" != "main" ]; then
ALLOWED=false
REASON="Dev branch can only merge into 'main', not '${BASE}'"
fi
;;
esac
if [ "$ALLOWED" = false ]; then
echo "::error::${REASON}"
echo "## Branch Policy Violation" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "${REASON}" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "### Allowed merge paths:" >> $GITHUB_STEP_SUMMARY
echo "- \`feature/*\` → \`dev\`" >> $GITHUB_STEP_SUMMARY
echo "- \`fix/*\` → \`dev\`" >> $GITHUB_STEP_SUMMARY
echo "- \`hotfix/*\` → \`dev\` or \`main\`" >> $GITHUB_STEP_SUMMARY
echo "- \`dev\` → \`main\`" >> $GITHUB_STEP_SUMMARY
echo "- \`rc/*\` → \`main\`" >> $GITHUB_STEP_SUMMARY
exit 1
fi
echo "Branch policy: OK (${HEAD} → ${BASE})"
echo "## Branch Policy: Passed" >> $GITHUB_STEP_SUMMARY
# ── Code Validation ────────────────────────────────────────────────────
validate:
name: Validate PR
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Check for merge conflict markers
run: |
CONFLICTS=$(grep -rn '<<<<<<< \|>>>>>>> \|^=======$' --include='*.php' --include='*.xml' --include='*.css' --include='*.js' --include='*.json' --include='*.md' --include='*.yml' --include='*.yaml' --include='*.ini' --include='*.txt' . 2>/dev/null | grep -v '.git/' || true)
if [ -n "$CONFLICTS" ]; then
echo "::error::Merge conflict markers found in source files"
echo "## Conflict Markers Found" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
echo "$CONFLICTS" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
exit 1
fi
echo "No conflict markers found"
- name: Detect platform
id: platform
run: |
# Read platform from XML manifest (<platform> tag) or plain text fallback
PLATFORM=$(sed -n 's/.*<platform>\([^<]*\)<\/platform>.*/\1/p' .mokogitea/manifest.xml 2>/dev/null | head -1)
[ -z "$PLATFORM" ] && PLATFORM=$(cat .mokogitea/manifest.xml 2>/dev/null | tr -d '[:space:]')
[ -z "$PLATFORM" ] && PLATFORM="generic"
echo "platform=$PLATFORM" >> "$GITHUB_OUTPUT"
- name: Setup PHP
if: steps.platform.outputs.platform == 'joomla' || steps.platform.outputs.platform == 'dolibarr'
run: |
if ! command -v php &> /dev/null; then
sudo apt-get update -qq
sudo apt-get install -y -qq php-cli php-mbstring php-xml >/dev/null 2>&1
fi
- name: PHP syntax check
if: steps.platform.outputs.platform == 'joomla' || steps.platform.outputs.platform == 'dolibarr'
run: |
ERRORS=0
while IFS= read -r -d '' file; do
if ! php -l "$file" 2>&1 | grep -q "No syntax errors"; then
ERRORS=$((ERRORS + 1))
fi
done < <(find . -name "*.php" -not -path "./.git/*" -not -path "./vendor/*" -print0)
echo "PHP lint: ${ERRORS} error(s)"
[ "$ERRORS" -eq 0 ] || { echo "::error::PHP syntax errors found"; exit 1; }
- name: Joomla JEXEC guard check
if: steps.platform.outputs.platform == 'joomla'
run: |
ERRORS=0
while IFS= read -r -d '' file; do
# Skip vendor, node_modules, and index.html stub files
case "$file" in ./vendor/*|./node_modules/*) continue ;; esac
# Check first 10 lines for JEXEC or JPATH guard
if ! head -20 "$file" | grep -qE "defined\s*\(\s*['\"](_JEXEC|JPATH_BASE|\\\\JPATH_PLATFORM)['\"]"; then
echo "::error file=${file}::Missing JEXEC guard: ${file}"
ERRORS=$((ERRORS + 1))
fi
done < <(find . -name "*.php" -path "*/src/*" -not -path "./.git/*" -not -path "./vendor/*" -print0)
if [ "$ERRORS" -gt 0 ]; then
echo "::error::${ERRORS} PHP file(s) missing defined('_JEXEC') or die guard"
echo "## JEXEC Guard Check: Failed" >> $GITHUB_STEP_SUMMARY
echo "${ERRORS} file(s) in src/ are missing the Joomla execution guard." >> $GITHUB_STEP_SUMMARY
exit 1
fi
echo "JEXEC guard: OK"
- name: Joomla directory listing protection
if: steps.platform.outputs.platform == 'joomla'
run: |
MISSING=0
SOURCE_DIR="src"
[ ! -d "$SOURCE_DIR" ] && exit 0
while IFS= read -r dir; do
if [ ! -f "${dir}/index.html" ]; then
echo "::warning::Missing index.html in ${dir} (directory listing protection)"
MISSING=$((MISSING + 1))
fi
done < <(find "$SOURCE_DIR" -type d -not -path "./.git/*" -not -path "*/vendor/*" -not -path "*/node_modules/*")
if [ "$MISSING" -gt 0 ]; then
echo "## Directory Protection" >> $GITHUB_STEP_SUMMARY
echo "${MISSING} director(ies) missing index.html" >> $GITHUB_STEP_SUMMARY
fi
echo "Directory protection: ${MISSING} missing (advisory)"
- name: Joomla script file and asset checks
if: steps.platform.outputs.platform == 'joomla'
run: |
ERRORS=0
MANIFEST=$(find . -maxdepth 3 -name "*.xml" ! -path "./.git/*" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
[ -z "$MANIFEST" ] && exit 0
MANIFEST_DIR=$(dirname "$MANIFEST")
# Check scriptfile exists if declared
SCRIPTFILE=$(sed -n 's/.*<scriptfile>\([^<]*\)<\/scriptfile>.*/\1/p' "$MANIFEST" 2>/dev/null)
if [ -n "$SCRIPTFILE" ]; then
if [ ! -f "${MANIFEST_DIR}/${SCRIPTFILE}" ]; then
echo "::error::Manifest declares <scriptfile>${SCRIPTFILE}</scriptfile> but file not found at ${MANIFEST_DIR}/${SCRIPTFILE}"
ERRORS=$((ERRORS + 1))
else
echo "Script file: ${MANIFEST_DIR}/${SCRIPTFILE} (OK)"
fi
fi
# Require joomla.asset.json and validate it
ASSET_JSON=$(find "$MANIFEST_DIR" -name "joomla.asset.json" -not -path "./.git/*" 2>/dev/null | head -1)
if [ -z "$ASSET_JSON" ]; then
echo "::error::joomla.asset.json not found — Joomla asset system is required"
ERRORS=$((ERRORS + 1))
else
if command -v php &> /dev/null; then
php -r "json_decode(file_get_contents('$ASSET_JSON')); if(json_last_error()!==JSON_ERROR_NONE){echo json_last_error_msg();exit(1);}" 2>&1 || {
echo "::error::joomla.asset.json is not valid JSON"
ERRORS=$((ERRORS + 1))
}
fi
echo "joomla.asset.json: valid"
fi
# Validate all XML files in src/ are well-formed
XML_ERRORS=0
if command -v php &> /dev/null; then
while IFS= read -r -d '' xmlfile; do
if ! php -r "libxml_use_internal_errors(true); \$x = simplexml_load_file('$xmlfile'); if(!\$x){foreach(libxml_get_errors() as \$e) echo trim(\$e->message) . ' in $xmlfile'; exit(1);}" 2>&1; then
XML_ERRORS=$((XML_ERRORS + 1))
fi
done < <(find "$MANIFEST_DIR" -name "*.xml" -not -path "./.git/*" -print0)
fi
if [ "$XML_ERRORS" -gt 0 ]; then
echo "::error::${XML_ERRORS} XML file(s) are malformed"
ERRORS=$((ERRORS + 1))
else
echo "XML well-formedness: OK"
fi
[ "$ERRORS" -gt 0 ] && exit 1
echo "Joomla asset checks: OK"
- name: Validate platform manifest
run: |
PLATFORM="${{ steps.platform.outputs.platform }}"
case "$PLATFORM" in
joomla)
MANIFEST=$(find . -maxdepth 3 -name "*.xml" ! -path "./.git/*" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
if [ -z "$MANIFEST" ]; then
echo "::warning::No Joomla manifest found (WaaS site)"
exit 0
fi
echo "Manifest: ${MANIFEST}"
if command -v php &> /dev/null; then
php -r "libxml_use_internal_errors(true); \$x = simplexml_load_file('$MANIFEST'); if(!\$x){foreach(libxml_get_errors() as \$e) echo \$e->message; exit(1);}" || { echo "::error::Manifest XML is malformed"; exit 1; }
fi
for ELEMENT in name version description; do
grep -q "<${ELEMENT}>" "$MANIFEST" || { echo "::error::Missing <${ELEMENT}> in manifest"; exit 1; }
done
# Block legacy raw/branch update server URLs on MokoGitea
RAW_URLS=$(grep -n 'raw/branch' "$MANIFEST" | grep -i 'mokoconsulting\|mokogitea\|git\.mokoconsulting\.tech' || true)
if [ -n "$RAW_URLS" ]; then
echo "::error::Manifest contains legacy raw/branch update server URL on MokoGitea. Use the Gitea Pages URL instead (e.g. /{REPO}/updates.xml not /{REPO}/raw/branch/main/updates.xml)"
echo "$RAW_URLS"
exit 1
fi
echo "Joomla manifest valid"
;;
dolibarr)
MOD_FILE=$(find . -maxdepth 4 -name "mod*.class.php" ! -path "./.git/*" -exec grep -l 'extends DolibarrModules' {} \; 2>/dev/null | head -1)
if [ -z "$MOD_FILE" ]; then
echo "::error::No mod*.class.php found"
exit 1
fi
echo "Dolibarr module: ${MOD_FILE}"
;;
*)
echo "Generic platform — no manifest validation"
;;
esac
- name: Check update stream format
run: |
PLATFORM="${{ steps.platform.outputs.platform }}"
case "$PLATFORM" in
joomla)
if [ -f "updates.xml" ]; then
if command -v php &> /dev/null; then
php -r "libxml_use_internal_errors(true); \$x = simplexml_load_file('updates.xml'); if(!\$x){foreach(libxml_get_errors() as \$e) echo \$e->message; exit(1);}" || { echo "::error::updates.xml is malformed"; exit 1; }
fi
echo "updates.xml valid"
fi
;;
dolibarr)
[ -f "update.txt" ] && echo "update.txt present" || echo "::warning::No update.txt"
;;
esac
- name: Validate Joomla language files
if: steps.platform.outputs.platform == 'joomla'
run: |
ERRORS=0
WARNINGS=0
# Require both en-GB and en-US language directories
LANG_ROOT=$(find . -path "*/language" -type d -not -path "./.git/*" 2>/dev/null | head -1)
if [ -z "$LANG_ROOT" ]; then
echo "No language/ directory found — skipping"
exit 0
fi
if [ ! -d "$LANG_ROOT/en-GB" ]; then
echo "::error::Missing en-GB language directory (${LANG_ROOT}/en-GB)"
ERRORS=$((ERRORS + 1))
fi
if [ ! -d "$LANG_ROOT/en-US" ]; then
echo "::error::Missing en-US language directory (${LANG_ROOT}/en-US)"
ERRORS=$((ERRORS + 1))
fi
# Check that en-GB and en-US have matching .ini files
if [ -d "$LANG_ROOT/en-GB" ] && [ -d "$LANG_ROOT/en-US" ]; then
for GB_INI in "$LANG_ROOT/en-GB"/*.ini; do
[ ! -f "$GB_INI" ] && continue
US_INI="$LANG_ROOT/en-US/$(basename "$GB_INI")"
if [ ! -f "$US_INI" ]; then
echo "::error::$(basename "$GB_INI") exists in en-GB but missing from en-US"
ERRORS=$((ERRORS + 1))
fi
done
for US_INI in "$LANG_ROOT/en-US"/*.ini; do
[ ! -f "$US_INI" ] && continue
GB_INI="$LANG_ROOT/en-GB/$(basename "$US_INI")"
if [ ! -f "$GB_INI" ]; then
echo "::error::$(basename "$US_INI") exists in en-US but missing from en-GB"
ERRORS=$((ERRORS + 1))
fi
done
fi
# Find all .ini language files
INI_FILES=$(find . -path "*/language/*/*.ini" -not -path "./.git/*" 2>/dev/null)
if [ -z "$INI_FILES" ]; then
echo "No .ini language files found"
[ "$ERRORS" -gt 0 ] && exit 1
exit 0
fi
echo "Found $(echo "$INI_FILES" | wc -l) language file(s)"
for FILE in $INI_FILES; do
FNAME=$(basename "$FILE")
LINENUM=0
SEEN_KEYS=""
while IFS= read -r line || [ -n "$line" ]; do
LINENUM=$((LINENUM + 1))
# Skip empty lines and comments
[ -z "$line" ] && continue
echo "$line" | grep -qE '^\s*;' && continue
echo "$line" | grep -qE '^\s*$' && continue
# Must match KEY="VALUE" format
if ! echo "$line" | grep -qE '^[A-Z_][A-Z0-9_]*=".*"$'; then
echo "::error file=${FILE},line=${LINENUM}::Malformed line: ${line}"
ERRORS=$((ERRORS + 1))
continue
fi
# Extract key and check for duplicates
KEY=$(echo "$line" | sed 's/=.*//')
if echo "$SEEN_KEYS" | grep -qx "$KEY"; then
echo "::error file=${FILE},line=${LINENUM}::Duplicate key: ${KEY}"
ERRORS=$((ERRORS + 1))
fi
SEEN_KEYS="${SEEN_KEYS}
${KEY}"
done < "$FILE"
echo " ${FILE}: checked ${LINENUM} lines"
done
# Cross-check en-GB vs en-US key consistency
GB_DIR=$(find . -path "*/language/en-GB" -type d -not -path "./.git/*" 2>/dev/null | head -1)
US_DIR=$(find . -path "*/language/en-US" -type d -not -path "./.git/*" 2>/dev/null | head -1)
if [ -n "$GB_DIR" ] && [ -n "$US_DIR" ]; then
for GB_FILE in "$GB_DIR"/*.ini; do
[ ! -f "$GB_FILE" ] && continue
FNAME=$(basename "$GB_FILE")
US_FILE="$US_DIR/$FNAME"
[ ! -f "$US_FILE" ] && continue
GB_KEYS=$(grep -oP '^[A-Z_][A-Z0-9_]*(?==)' "$GB_FILE" 2>/dev/null | sort)
US_KEYS=$(grep -oP '^[A-Z_][A-Z0-9_]*(?==)' "$US_FILE" 2>/dev/null | sort)
# Keys in en-GB but not en-US
MISSING_US=$(comm -23 <(echo "$GB_KEYS") <(echo "$US_KEYS"))
if [ -n "$MISSING_US" ]; then
echo "::warning::Keys in en-GB/$FNAME but missing from en-US/$FNAME:"
echo "$MISSING_US" | while read -r k; do echo " - $k"; done
WARNINGS=$((WARNINGS + 1))
fi
# Keys in en-US but not en-GB
MISSING_GB=$(comm -13 <(echo "$GB_KEYS") <(echo "$US_KEYS"))
if [ -n "$MISSING_GB" ]; then
echo "::warning::Keys in en-US/$FNAME but missing from en-GB/$FNAME:"
echo "$MISSING_GB" | while read -r k; do echo " - $k"; done
WARNINGS=$((WARNINGS + 1))
fi
done
fi
{
echo "### Language File Validation"
echo "| Metric | Count |"
echo "|---|---|"
echo "| Files checked | $(echo "$INI_FILES" | wc -l) |"
echo "| Errors | ${ERRORS} |"
echo "| Warnings | ${WARNINGS} |"
} >> $GITHUB_STEP_SUMMARY
if [ "$ERRORS" -gt 0 ]; then
echo "::error::Language validation failed with ${ERRORS} error(s)"
exit 1
fi
echo "Language files: OK (${WARNINGS} warning(s))"
- name: Check changelog has unreleased entry
run: |
if [ ! -f "CHANGELOG.md" ]; then
echo "::warning::No CHANGELOG.md found"
exit 0
fi
# Check for content under [Unreleased] section
if ! grep -q "## \[Unreleased\]" CHANGELOG.md; then
echo "::error::CHANGELOG.md missing [Unreleased] section"
exit 1
fi
# Check there's at least one entry (Added/Changed/Fixed/Removed) under Unreleased
UNRELEASED_CONTENT=$(sed -n '/## \[Unreleased\]/,/## \[/p' CHANGELOG.md | grep -cE '^\s*-\s' || true)
if [ "$UNRELEASED_CONTENT" -eq 0 ]; then
echo "::error::CHANGELOG.md [Unreleased] section has no entries. Add a changelog entry describing your changes."
echo "## Changelog Check: Failed" >> $GITHUB_STEP_SUMMARY
echo "The \`[Unreleased]\` section in CHANGELOG.md has no entries." >> $GITHUB_STEP_SUMMARY
echo "Add a line like \`- Description of your change\` under a heading (\`### Added\`, \`### Changed\`, \`### Fixed\`, etc.)" >> $GITHUB_STEP_SUMMARY
exit 1
fi
echo "Changelog: ${UNRELEASED_CONTENT} entry/entries in [Unreleased]"
- name: Verify package source
run: |
SOURCE_DIR="src"
[ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
if [ ! -d "$SOURCE_DIR" ]; then
echo "::warning::No src/ or htdocs/ directory"
exit 0
fi
FILE_COUNT=$(find "$SOURCE_DIR" -type f | wc -l)
echo "Source: ${FILE_COUNT} files"
[ "$FILE_COUNT" -gt 0 ] || { echo "::error::Source directory is empty"; exit 1; }
# ── Pre-Release RC Build ─────────────────────────────────────────────────
pre-release:
name: Build RC Package
runs-on: ubuntu-latest
needs: [branch-policy, validate]
steps:
- name: Trigger RC pre-release
env:
GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
REPO: ${{ github.repository }}
BRANCH: ${{ github.head_ref }}
GITEA_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\"}}"
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
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."
+711
View File
@@ -0,0 +1,711 @@
# ============================================================================
# Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
#
# This file is part of a Moko Consulting project.
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: moko-platform.Validation
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
# PATH: /templates/workflows/joomla/repo_health.yml.template
# VERSION: 09.23.00
# BRIEF: Enforces repository guardrails by validating scripts governance, tooling availability, and core repository health artifacts.
# ============================================================================
name: "Generic: Repo Health"
defaults:
run:
shell: bash
on:
workflow_dispatch:
inputs:
profile:
description: 'Validation profile: all, scripts, or repo'
required: true
default: all
type: choice
options:
- all
- scripts
- repo
pull_request:
push:
permissions:
contents: read
env:
# Scripts governance policy
SCRIPTS_REQUIRED_DIRS:
SCRIPTS_ALLOWED_DIRS: scripts,scripts/fix,scripts/lib,scripts/release,scripts/run,scripts/validate
# Repo health policy
REPO_REQUIRED_ARTIFACTS: README.md,LICENSE,CHANGELOG.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md,.mokogitea/workflows/
REPO_OPTIONAL_FILES: SECURITY.md,GOVERNANCE.md,.editorconfig,.gitattributes,.gitignore,README.md,docs/
REPO_DISALLOWED_DIRS:
REPO_DISALLOWED_FILES: TODO.md,todo.md
# Extended checks toggles
EXTENDED_CHECKS: "true"
# File / directory variables
DOCS_INDEX: docs/docs-index.md
SCRIPT_DIR: scripts
WORKFLOWS_DIR: .mokogitea/workflows
SHELLCHECK_PATTERN: '*.sh'
SPDX_FILE_GLOBS: '*.sh,*.php,*.js,*.ts,*.css,*.xml,*.yml,*.yaml'
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
jobs:
access_check:
name: Access control
runs-on: ubuntu-latest
timeout-minutes: 10
permissions:
contents: read
outputs:
allowed: ${{ steps.perm.outputs.allowed }}
permission: ${{ steps.perm.outputs.permission }}
steps:
- name: Check actor permission (admin only)
id: perm
env:
TOKEN: ${{ secrets.MOKOGITEA_TOKEN || secrets.MOKOGITEA_TOKEN || github.token }}
REPO: ${{ github.repository }}
ACTOR: ${{ github.actor }}
run: |
set -euo pipefail
ALLOWED=false
PERMISSION=unknown
METHOD=""
# Hardcoded authorized users — always allowed
case "$ACTOR" in
jmiller|gitea-actions[bot])
ALLOWED=true
PERMISSION=admin
METHOD="hardcoded allowlist"
;;
*)
# Detect platform and check permissions via API
API_BASE="${GITHUB_API_URL:-${GITEA_API_URL:-https://api.github.com}}"
RESP=$(curl -sf -H "Authorization: token ${TOKEN}" \
"${API_BASE}/repos/${REPO}/collaborators/${ACTOR}/permission" 2>/dev/null || echo '{}')
PERMISSION=$(echo "$RESP" | grep -oP '"permission"\s*:\s*"\K[^"]+' || echo "unknown")
if [ "$PERMISSION" = "admin" ] || [ "$PERMISSION" = "maintain" ] || [ "$PERMISSION" = "owner" ]; then
ALLOWED=true
fi
METHOD="collaborator API"
;;
esac
echo "permission=${PERMISSION}" >> "$GITHUB_OUTPUT"
echo "allowed=${ALLOWED}" >> "$GITHUB_OUTPUT"
{
echo "## Access Authorization"
echo ""
echo "| Field | Value |"
echo "|-------|-------|"
echo "| **Actor** | \`${ACTOR}\` |"
echo "| **Repository** | \`${REPO}\` |"
echo "| **Permission** | \`${PERMISSION}\` |"
echo "| **Method** | ${METHOD} |"
echo "| **Authorized** | ${ALLOWED} |"
echo ""
if [ "$ALLOWED" = "true" ]; then
echo "${ACTOR} authorized (${METHOD})"
else
echo "${ACTOR} is NOT authorized. Requires admin or maintain role."
fi
} >> "${GITHUB_STEP_SUMMARY}"
- name: Deny execution when not permitted
if: ${{ steps.perm.outputs.allowed != 'true' }}
run: |
set -euo pipefail
printf '%s\n' 'ERROR: Access denied. Admin permission required.' >> "${GITHUB_STEP_SUMMARY}"
exit 1
scripts_governance:
name: Scripts governance
needs: access_check
if: ${{ needs.access_check.outputs.allowed == 'true' }}
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: read
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
fetch-depth: 0
- name: Scripts folder checks
env:
PROFILE_RAW: ${{ github.event.inputs.profile }}
run: |
set -euo pipefail
profile="${PROFILE_RAW:-all}"
case "${profile}" in
all|scripts|repo) ;;
*)
printf '%s\n' "ERROR: Unknown profile: ${profile}" >> "${GITHUB_STEP_SUMMARY}"
exit 1
;;
esac
if [ "${profile}" = 'repo' ]; then
{
printf '%s\n' '### Scripts governance'
printf '%s\n' "Profile: ${profile}"
printf '%s\n' 'Status: SKIPPED'
printf '%s\n' 'Reason: profile excludes scripts governance'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
exit 0
fi
if [ ! -d "${SCRIPT_DIR}" ]; then
{
printf '%s\n' '### Scripts governance'
printf '%s\n' 'Status: OK (advisory)'
printf '%s\n' 'scripts/ directory not present. No scripts governance enforced.'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
exit 0
fi
if [ -n "${SCRIPTS_REQUIRED_DIRS:-}" ]; then IFS=',' read -r -a required_dirs <<< "${SCRIPTS_REQUIRED_DIRS}"; else required_dirs=(); fi
IFS=',' read -r -a allowed_dirs <<< "${SCRIPTS_ALLOWED_DIRS}"
missing_dirs=()
unapproved_dirs=()
for d in "${required_dirs[@]}"; do
req="${d%/}"
[ ! -d "${req}" ] && missing_dirs+=("${req}/")
done
while IFS= read -r d; do
allowed=false
for a in "${allowed_dirs[@]}"; do
a_norm="${a%/}"
[ "${d%/}" = "${a_norm}" ] && allowed=true
done
[ "${allowed}" = false ] && unapproved_dirs+=("${d%/}/")
done < <(find "${SCRIPT_DIR}" -maxdepth 1 -mindepth 1 -type d 2>/dev/null | sed 's#^\./##')
{
printf '%s\n' '### Scripts governance'
printf '%s\n' "Profile: ${profile}"
printf '%s\n' '| Area | Status | Notes |'
printf '%s\n' '|---|---|---|'
if [ "${#missing_dirs[@]}" -gt 0 ]; then
printf '%s\n' '| Required directories | Warning | Missing required subfolders |'
else
printf '%s\n' '| Required directories | OK | All required subfolders present |'
fi
if [ "${#unapproved_dirs[@]}" -gt 0 ]; then
printf '%s\n' '| Directory policy | Warning | Unapproved directories detected |'
else
printf '%s\n' '| Directory policy | OK | No unapproved directories |'
fi
printf '%s\n' '| Enforcement mode | Advisory | scripts folder is optional |'
printf '\n'
if [ "${#missing_dirs[@]}" -gt 0 ]; then
printf '%s\n' 'Missing required script directories:'
for m in "${missing_dirs[@]}"; do printf '%s\n' "- ${m}"; done
printf '\n'
else
printf '%s\n' 'Missing required script directories: none.'
printf '\n'
fi
if [ "${#unapproved_dirs[@]}" -gt 0 ]; then
printf '%s\n' 'Unapproved script directories detected:'
for m in "${unapproved_dirs[@]}"; do printf '%s\n' "- ${m}"; done
printf '\n'
else
printf '%s\n' 'Unapproved script directories detected: none.'
printf '\n'
fi
printf '%s\n' 'Scripts governance completed in advisory mode.'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
repo_health:
name: Repository health
needs: access_check
if: ${{ needs.access_check.outputs.allowed == 'true' }}
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
contents: read
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
fetch-depth: 0
- name: Repository health checks
env:
PROFILE_RAW: ${{ github.event.inputs.profile }}
run: |
set -euo pipefail
profile="${PROFILE_RAW:-all}"
case "${profile}" in
all|scripts|repo) ;;
*)
printf '%s\n' "ERROR: Unknown profile: ${profile}" >> "${GITHUB_STEP_SUMMARY}"
exit 1
;;
esac
if [ "${profile}" = 'scripts' ]; then
{
printf '%s\n' '### Repository health'
printf '%s\n' "Profile: ${profile}"
printf '%s\n' 'Status: SKIPPED'
printf '%s\n' 'Reason: profile excludes repository health'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
exit 0
fi
IFS=',' read -r -a required_artifacts <<< "${REPO_REQUIRED_ARTIFACTS}"
IFS=',' read -r -a optional_files <<< "${REPO_OPTIONAL_FILES}"
if [ -n "${REPO_DISALLOWED_DIRS:-}" ]; then IFS=',' read -r -a disallowed_dirs <<< "${REPO_DISALLOWED_DIRS}"; else disallowed_dirs=(); fi
IFS=',' read -r -a disallowed_files <<< "${REPO_DISALLOWED_FILES:-}"
missing_required=()
missing_optional=()
# Source directory: src/ or htdocs/ (either is valid for extension repos)
SOURCE_DIR=""
if [ -d "src" ]; then
SOURCE_DIR="src"
elif [ -d "htdocs" ]; then
SOURCE_DIR="htdocs"
elif [ -d "deploy" ] || [ -d "cli" ] || [ -d "monitoring" ]; then
# Platform/tooling repos don't need src/
SOURCE_DIR=""
else
missing_required+=("src/ or htdocs/ (source directory required)")
fi
for item in "${required_artifacts[@]}"; do
if printf '%s' "${item}" | grep -q '/$'; then
d="${item%/}"
[ ! -d "${d}" ] && missing_required+=("${item}")
else
[ ! -f "${item}" ] && missing_required+=("${item}")
fi
done
for f in "${optional_files[@]}"; do
if printf '%s' "${f}" | grep -q '/$'; then
d="${f%/}"
[ ! -d "${d}" ] && missing_optional+=("${f}")
else
[ ! -f "${f}" ] && missing_optional+=("${f}")
fi
done
for d in "${disallowed_dirs[@]}"; do
d_norm="${d%/}"
[ -d "${d_norm}" ] && missing_required+=("${d_norm}/ (disallowed)")
done
for f in "${disallowed_files[@]}"; do
[ -f "${f}" ] && missing_required+=("${f} (disallowed)")
done
git fetch origin --prune
dev_paths=()
dev_branches=()
while IFS= read -r b; do
name="${b#origin/}"
if [ "${name}" = 'dev' ]; then
dev_branches+=("${name}")
else
dev_paths+=("${name}")
fi
done < <(git branch -r --list 'origin/dev*' | sed 's/^ *//')
if [ "${#dev_paths[@]}" -eq 0 ] && [ "${#dev_branches[@]}" -eq 0 ]; then
missing_required+=("dev or dev/* branch")
fi
content_warnings=()
if [ -f 'CHANGELOG.md' ] && ! grep -Eq '^# Changelog' CHANGELOG.md; then
content_warnings+=("CHANGELOG.md missing '# Changelog' header")
fi
if [ -f 'CHANGELOG.md' ] && grep -Eq '^[# ]*Unreleased' CHANGELOG.md; then
content_warnings+=("CHANGELOG.md contains Unreleased section (review release readiness)")
fi
if [ -f 'LICENSE' ] && ! grep -qiE 'GNU GENERAL PUBLIC LICENSE|GPL' LICENSE; then
content_warnings+=("LICENSE does not look like a GPL text")
fi
if [ -f 'README.md' ] && ! grep -qiE 'moko|Moko' README.md; then
content_warnings+=("README.md missing expected brand keyword")
fi
export PROFILE_RAW="${profile}"
export MISSING_REQUIRED="$(printf '%s\n' "${missing_required[@]:-}")"
export MISSING_OPTIONAL="$(printf '%s\n' "${missing_optional[@]:-}")"
export CONTENT_WARNINGS="$(printf '%s\n' "${content_warnings[@]:-}")"
report_json=$(printf '{"profile":"%s","missing_required":%d,"missing_optional":%d,"content_warnings":%d}' "$profile" "${#missing_required[@]}" "${#missing_optional[@]}" "${#content_warnings[@]}")
{
printf '%s\n' '### Repository health'
printf '%s\n' "Profile: ${profile}"
printf '%s\n' '| Metric | Value |'
printf '%s\n' '|---|---|'
printf '%s\n' "| Missing required | ${#missing_required[@]} |"
printf '%s\n' "| Missing optional | ${#missing_optional[@]} |"
printf '%s\n' "| Content warnings | ${#content_warnings[@]} |"
printf '\n'
printf '%s\n' '### Guardrails report (JSON)'
printf '%s\n' '```json'
printf '%s\n' "${report_json}"
printf '%s\n' '```'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
if [ "${#missing_required[@]}" -gt 0 ]; then
{
printf '%s\n' '### Missing required repo artifacts'
for m in "${missing_required[@]}"; do printf '%s\n' "- ${m}"; done
printf '%s\n' 'ERROR: Guardrails failed. Missing required repository artifacts.'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
exit 1
fi
if [ "${#missing_optional[@]}" -gt 0 ]; then
{
printf '%s\n' '### Missing optional repo artifacts'
for m in "${missing_optional[@]}"; do printf '%s\n' "- ${m}"; done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
if [ "${#content_warnings[@]}" -gt 0 ]; then
{
printf '%s\n' '### Repo content warnings'
for m in "${content_warnings[@]}"; do printf '%s\n' "- ${m}"; done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
# -- Joomla-specific checks --
joomla_findings=()
MANIFEST="$(find . -maxdepth 2 -name '*.xml' -exec grep -l '<extension' {} \; 2>/dev/null | head -1 || true)"
if [ -z "${MANIFEST}" ]; then
joomla_findings+=("Joomla XML manifest not found (no *.xml with <extension> tag)")
else
if ! grep -qP '<version>' "${MANIFEST}"; then
joomla_findings+=("XML manifest: <version> tag missing")
fi
if ! grep -qP 'type="(component|module|plugin|library|package|template|language)"' "${MANIFEST}"; then
joomla_findings+=("XML manifest: type attribute missing or invalid")
fi
if ! grep -qP '<name>' "${MANIFEST}"; then
joomla_findings+=("XML manifest: <name> tag missing")
fi
if ! grep -qP '<author>' "${MANIFEST}"; then
joomla_findings+=("XML manifest: <author> tag missing")
fi
if ! grep -qP '<namespace' "${MANIFEST}"; then
joomla_findings+=("XML manifest: <namespace> missing (required for Joomla 5+)")
fi
fi
INI_COUNT="$(find . -name '*.ini' -type f 2>/dev/null | wc -l)"
if [ "${INI_COUNT}" -eq 0 ]; then
joomla_findings+=("No .ini language files found")
fi
if [ ! -f 'updates.xml' ]; then
joomla_findings+=("updates.xml missing in root (required for Joomla update server)")
fi
if [ -n "${SOURCE_DIR}" ]; then
INDEX_DIRS=("${SOURCE_DIR}" "${SOURCE_DIR}/admin" "${SOURCE_DIR}/site")
for dir in "${INDEX_DIRS[@]}"; do
if [ -d "${dir}" ] && [ ! -f "${dir}/index.html" ]; then
joomla_findings+=("${dir}/index.html missing (directory listing protection)")
fi
done
fi
if [ "${#joomla_findings[@]}" -gt 0 ]; then
{
printf '%s\n' '### Joomla extension checks'
printf '%s\n' '| Check | Status |'
printf '%s\n' '|---|---|'
for f in "${joomla_findings[@]}"; do
printf '%s\n' "| ${f} | Warning |"
done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
else
{
printf '%s\n' '### Joomla extension checks'
printf '%s\n' 'All Joomla-specific checks passed.'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
extended_enabled="${EXTENDED_CHECKS:-true}"
extended_findings=()
if [ "${extended_enabled}" = 'true' ]; then
if [ -f '.github/CODEOWNERS' ] || [ -f 'CODEOWNERS' ] || [ -f 'docs/CODEOWNERS' ]; then
:
else
extended_findings+=("CODEOWNERS not found (.github/CODEOWNERS preferred)")
fi
if ls "${WORKFLOWS_DIR}"/*.yml >/dev/null 2>&1 || ls "${WORKFLOWS_DIR}"/*.yaml >/dev/null 2>&1; then
bad_refs="$(grep -RIn --include='*.yml' --include='*.yaml' -E '^[[:space:]]*uses:[[:space:]]*[^#]+@(main|master)\b' "${WORKFLOWS_DIR}" 2>/dev/null || true)"
if [ -n "${bad_refs}" ]; then
extended_findings+=("Workflows reference actions @main/@master (pin versions): see log excerpt")
{
printf '%s\n' '### Workflow pinning advisory'
printf '%s\n' 'Found uses: entries pinned to main/master:'
printf '%s\n' '```'
printf '%s\n' "${bad_refs}"
printf '%s\n' '```'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
fi
if [ -f "${DOCS_INDEX}" ]; then
missing_links=""
while IFS= read -r docline; do
for link in $(echo "$docline" | grep -oE '\]\([^)]+\)' | sed 's/\](//' | sed 's/)$//' || true); do
case "$link" in http://*|https://*|"#"*|mailto:*) continue ;; esac
linkpath="${link%%#*}"
linkpath="${linkpath%%\?*}"
[ -z "$linkpath" ] && continue
if [ "${linkpath:0:1}" = "/" ]; then
testpath="${linkpath#/}"
else
testpath="$(dirname "${DOCS_INDEX}")/${linkpath}"
fi
[ ! -e "$testpath" ] && missing_links="${missing_links}${testpath} "
done
done < "${DOCS_INDEX}"
if [ -n "${missing_links}" ]; then
extended_findings+=("docs/docs-index.md contains broken relative links")
{
printf '%s\n' '### Docs index link integrity'
printf '%s\n' 'Broken relative links:'
for bl in ${missing_links}; do
printf '%s\n' "- ${bl}"
done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
fi
if [ -d "${SCRIPT_DIR}" ]; then
if ! command -v shellcheck >/dev/null 2>&1; then
sudo apt-get update -qq
sudo apt-get install -y shellcheck >/dev/null
fi
sc_out=''
while IFS= read -r shf; do
[ -z "${shf}" ] && continue
out_one="$(shellcheck -S warning -x "${shf}" 2>/dev/null || true)"
if [ -n "${out_one}" ]; then
sc_out="${sc_out}${out_one}\n"
fi
done < <(find "${SCRIPT_DIR}" -type f -name "${SHELLCHECK_PATTERN}" 2>/dev/null | sort)
if [ -n "${sc_out}" ]; then
extended_findings+=("ShellCheck warnings detected (advisory)")
sc_head="$(printf '%s' "${sc_out}" | head -n 200)"
{
printf '%s\n' '### ShellCheck (advisory)'
printf '%s\n' '```'
printf '%s\n' "${sc_head}"
printf '%s\n' '```'
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
fi
spdx_missing=()
IFS=',' read -r -a spdx_globs <<< "${SPDX_FILE_GLOBS}"
spdx_args=()
for g in "${spdx_globs[@]}"; do spdx_args+=("${g}"); done
while IFS= read -r f; do
[ -z "${f}" ] && continue
if ! head -n 40 "${f}" | grep -q 'SPDX-License-Identifier:'; then
spdx_missing+=("${f}")
fi
done < <(git ls-files "${spdx_args[@]}" 2>/dev/null || true)
if [ "${#spdx_missing[@]}" -gt 0 ]; then
extended_findings+=("SPDX header missing in some tracked files (advisory)")
{
printf '%s\n' '### SPDX header advisory'
printf '%s\n' 'Files missing SPDX-License-Identifier (first 40 lines scan):'
for f in "${spdx_missing[@]}"; do printf '%s\n' "- ${f}"; done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
stale_cutoff_days=180
stale_branches="$(git for-each-ref --format='%(refname:short) %(committerdate:unix)' refs/remotes/origin 2>/dev/null | awk -v now="$(date +%s)" -v days="${stale_cutoff_days}" '{if (now-$2 > days*86400) print $1}' | head -50)"
if [ -n "${stale_branches}" ]; then
extended_findings+=("Stale remote branches detected (advisory)")
{
printf '%s\n' '### Git hygiene advisory'
printf '%s\n' "Branches with last commit older than ${stale_cutoff_days} days (sample up to 50):"
while IFS= read -r b; do [ -n "${b}" ] && printf '%s\n' "- ${b}"; done <<< "${stale_branches}"
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
fi
{
printf '%s\n' '### Guardrails coverage matrix'
printf '%s\n' '| Domain | Status | Notes |'
printf '%s\n' '|---|---|---|'
printf '%s\n' '| Access control | OK | Admin-only execution gate |'
printf '%s\n' '| Release policy | N/A | Releases handled by MokoGitea |'
printf '%s\n' '| Scripts governance | OK | Directory policy and advisory reporting |'
printf '%s\n' '| Repo required artifacts | OK | Required, optional, disallowed enforcement |'
printf '%s\n' '| Repo content heuristics | OK | Brand, license, changelog structure |'
if [ "${extended_enabled}" = 'true' ]; then
if [ "${#extended_findings[@]}" -gt 0 ]; then
printf '%s\n' '| Extended checks | Warning | See extended findings below |'
else
printf '%s\n' '| Extended checks | OK | No findings |'
fi
else
printf '%s\n' '| Extended checks | SKIPPED | EXTENDED_CHECKS disabled |'
fi
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
if [ "${extended_enabled}" = 'true' ] && [ "${#extended_findings[@]}" -gt 0 ]; then
{
printf '%s\n' '### Extended findings (advisory)'
for f in "${extended_findings[@]}"; do printf '%s\n' "- ${f}"; done
printf '\n'
} >> "${GITHUB_STEP_SUMMARY}"
fi
printf '%s\n' 'Repository health guardrails passed.' >> "${GITHUB_STEP_SUMMARY}"
site-health:
name: Site Health
runs-on: ubuntu-latest
if: github.event_name == 'workflow_dispatch'
steps:
- uses: actions/checkout@v4
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
- name: Uptime check
if: env.URLS != ''
run: |
echo "$URLS" > /tmp/urls.txt
php monitoring/uptime-probe.php --urls /tmp/urls.txt --timeout 15 || echo "::warning::Some sites are down"
rm -f /tmp/urls.txt
env:
URLS: ${{ vars.MONITORED_URLS }}
- name: SSL certificate check
if: env.DOMAINS != ''
run: |
echo "$DOMAINS" > /tmp/domains.txt
php monitoring/ssl-check.php --domains /tmp/domains.txt --warn-days 30 || echo "::warning::SSL certificates expiring soon"
rm -f /tmp/domains.txt
env:
DOMAINS: ${{ vars.MONITORED_DOMAINS }}
- name: Summary
if: always()
run: |
echo "### Site Health" >> $GITHUB_STEP_SUMMARY
echo "Uptime and SSL checks completed." >> $GITHUB_STEP_SUMMARY
# ═══════════════════════════════════════════════════════════════════════
# Issue Reporter — file issues for failed gates
# ═══════════════════════════════════════════════════════════════════════
report-issues:
name: "Report Issues"
runs-on: ubuntu-latest
needs: [access_check, scripts_governance, repo_health]
if: >-
always() &&
(needs.scripts_governance.result == 'failure' ||
needs.repo_health.result == 'failure')
steps:
- name: Checkout
uses: actions/checkout@v4
with:
sparse-checkout: automation/ci-issue-reporter.sh
sparse-checkout-cone-mode: false
- 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."
+10 -169
View File
@@ -8,174 +8,15 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [Unreleased]
### Fixed
- **Content plugin**: Fixed `onContentBeforeDisplay` signature for Joomla 5/6 — now accepts `BeforeDisplayEvent` object instead of individual parameters
### Added
- **CrossPostDispatcher**: New static helper (`com_mokojoomcross/Helper/CrossPostDispatcher`) centralising dispatch logic for reuse by all source plugins
- **Content plugin**: Added `onContentAfterSave` and `onContentChangeState` handlers with Joomla 5/6 event compatibility, dispatching via `CrossPostDispatcher`
- **plg_system_mokojoomcross_events**: New source plugin for MokoJoomCalendar — cross-posts calendar events when published
- **plg_system_mokojoomcross_gallery**: New source plugin for MokoJoomGallery — cross-posts galleries and images when published
### Fixed
- **QueueProcessor**: Replaced read-then-write DB lock with MySQL advisory locks (`GET_LOCK`/`RELEASE_LOCK`) to eliminate race condition
- **Twitter/X**: Replaced Bearer token auth with OAuth 1.0a (HMAC-SHA1) — Bearer tokens are app-only and cannot create tweets
- **service.xml**: Fixed missing closing `</field>` tag on webhook method field
- **Views**: Added missing `Toolbar` and `Route` imports in Logs, Posts, Services, Template, Templates HtmlView files
- **13 service plugins**: Fixed broken `publish()` methods that had literal placeholder URLs instead of using credential values — ActivityPub, Blogger, Ghost, Google Business, Hashnode, Matrix, Medium, Nostr, RSS Feed, Threads, Tumblr, WhatsApp, WordPress
- **Ghost**: Proper JWT auth from `{id}:{secret}` admin API key format
- **WordPress**: Correct Basic Auth (not Bearer) with Application Passwords
- **Medium**: 2-step flow — fetch user ID via /v1/me, then post
- **Matrix**: PUT with transaction ID for idempotent message sending
- **Hashnode**: GraphQL mutation with proper query structure
- **Threads**: 2-step container creation + publish flow
- **WhatsApp**: Meta Cloud API with messaging_product payload
- **Nostr**: Stub with clear "not yet implemented" message (requires WebSocket)
- **RSS Feed**: Local service — no external API, always succeeds
### Added
- **Credential fields**: Added fields for 19 previously missing services (Pinterest, Tumblr, TikTok, Nostr, ActivityPub, Brevo, ConvertKit, Constant Contact, Hashnode, Blogger, Google Business, RSS Feed config)
- **Twitter**: Access Token and Access Token Secret fields for OAuth 1.0a
- **LinkedIn**: Refresh token field for automatic token renewal
- **Bluesky**: PDS URL field for self-hosted instances
- **Discord**: Username and avatar URL override fields
- **Mailchimp**: From name and from email fields
- **SendGrid**: From email and from name fields
- **Reddit**: Account password field for script-type OAuth
- **WordPress**: Default post status selector (draft/publish)
- **Dev.to**: Organization ID field
- **Ghost**: Default post status selector (draft/published)
- **Webhook**: Auth type selector (none/bearer/basic), auth token field, content type selector (JSON/form)
- **RSS Feed**: Feed title and max items config fields
- **OAuth services**: Added Pinterest, Tumblr, TikTok, Constant Contact, Blogger, Google Business to OAuth authorize flow
- **Developer Guide**: Comprehensive wiki page for building new service plugins
- **Help articles**: 42 KB articles on mokoconsulting.tech (overview, installation, 34 per-service guides, templates, queue, troubleshooting)
- **Service help link**: Per-service "Setup Guide" button in service edit sidebar links to the matching KB article
- **Evergreen re-sharing**: Articles can be marked as evergreen for automatic recurring cross-posts on a configurable interval (default 30 days)
- **Post edit form**: Full CRUD for queue posts — edit message, reschedule, change status, re-queue failed posts
- **Manual post creator**: New button in Post Queue toolbar to create manual cross-posts with article/service selection, custom message, and optional scheduling
- **Scheduled posts**: Calendar picker for scheduling posts to specific date/time; scheduled_at shown in queue list
- **Dashboard trend chart**: Chart.js line chart showing daily posted vs failed counts between stat cards and service breakdown
- **Dashboard date range filter**: Period selector (7/30/90 days, all time) filters service breakdown, top articles, and trend chart
- **Hashtag placeholders**: `{tags}` (comma-separated) and `{hashtags}` (#-prefixed space-separated) template placeholders from article tags
- **Posts service filter**: SQL-driven service dropdown filter in posts list, plus search filter by article title or message content
- **CSV export**: "Export CSV" toolbar button on posts list to download filtered post data as CSV
- **WordPress canonical URL**: WordPress cross-posts now include an "Originally published at" source link appended to content with the Joomla article URL
- **REST API dispatch endpoint**: `POST /api/v1/mokojoomcross/dispatch` — trigger cross-posts for an article via API with optional service filtering, duplicate guard, and template rendering
### Added (original)
#### Core Engine
- Cross-posting engine dispatches articles to service plugins on publish
- System plugin hooks `onContentAfterSave` and `onContentChangeState`
- Duplicate guard prevents re-posting to services that already received an article
- Message template rendering with 8 placeholders: `{title}`, `{url}`, `{introtext}`, `{fulltext}`, `{image}`, `{category}`, `{author}`, `{date}`
- Initial package structure with component, system plugin, content plugin, and webservices plugin
- Admin component with dashboard, post queue, services management, and activity logs
- System plugin triggering cross-post on article publish via `onContentAfterSave`
- Content plugin adding cross-post controls to article editor
- WebServices API plugin with REST endpoints for posts and services
- Custom `mokojoomcross` plugin group for extensible service architecture
- `MokoJoomCrossServiceInterface` contract for all service plugins
#### Admin Component (5 views)
- **Dashboard** — summary cards, posts-by-service analytics with success rates, top cross-posted articles, recent activity feed, PP Pro migration banner, page-load processing warning
- **Post Queue** — list with color-coded status badges, error messages, retry counts, platform post IDs, article/service columns, date filters
- **Services** — CRUD with service type selector (34 platforms organized by category), default/custom mode badges, publish toggle, credential editor
- **Templates** — CRUD for message templates, per-platform assignment, placeholder reference panel, template body preview
- **Activity Logs** — list with level badges (info/warning/error), service column, context data, level and search filters
#### Queue Processing (3 methods)
- Joomla Scheduled Task plugin (`plg_task_mokojoomcross`) — preferred, processes 20 posts per run
- Page-load fallback via system plugin `onAfterRender` — configurable throttle interval, backend/frontend/both
- Shared `QueueProcessor` helper with DB lock to prevent concurrent execution
- Failed post retry with configurable max retries and exponential delay
- Scheduled post support (`scheduled_at` column)
- Automatic log cleanup based on configurable retention period
#### Per-Article Controls
- "Cross-Posting" fieldset injected into article editor via `onContentPrepareForm`
- Skip cross-posting toggle per article
- Service selection checkboxes (unchecked = post to all enabled services)
#### OAuth 2.0
- `OAuthHelper` with authorization URL generation, code-to-token exchange, token storage
- Twitter PKCE flow support
- `OauthController` with authorize and callback endpoints
- Reads client ID/secret from service plugin params
#### Perfect Publisher Pro Migration
- Reads `#__autotweet_channels` table with per-platform credential mapping
- Fallback extraction from component params when channel table missing
- Maps Facebook, Twitter, LinkedIn, Telegram, Discord, Slack, Mastodon
- Creates services in disabled state for manual verification
- One-click migration from dashboard
#### Service Plugins (34 platforms)
**Social Media (12)**
- Facebook / Meta — Graph API v19.0, default MokoWaaS app mode, page feed posting
- X / Twitter — API v2, OAuth 2.0 Bearer Token, 280 char limit
- LinkedIn — Share API v2, organization + personal profile, 3000 char limit
- Mastodon — API v1, multi-instance, hashtags, 500 char limit
- Bluesky — AT Protocol, session auth, app passwords, 300 char limit
- Threads (Meta) — Threads Publishing API, default app mode, 500 char limit
- Pinterest — Pins API v5, board selection, image-focused
- Reddit — OAuth2 link submission, subreddit selection
- Tumblr — API v2, link/text posts, OAuth 1.0a
- TikTok — Content Posting API, photo slideshows
- Nostr — NIP-01 event publishing, configurable relays
- ActivityPub — generic Fediverse (Pleroma, Akkoma, Misskey, Pixelfed)
**Chat / Messaging (8)**
- Telegram — Bot API, default @MokoWaaSBot + custom bot, HTML/Markdown, 4096 chars
- Discord — Webhooks, default MokoWaaS webhook mode, embeds, 2000 chars
- Slack — Incoming Webhooks, default MokoWaaS webhook mode, Block Kit
- Microsoft Teams — Incoming Webhooks, default mode, Adaptive Cards
- Google Chat — Webhook API, card formatting
- WhatsApp Business — Meta Cloud API, template + free-form messages
- Matrix / Element — Client-Server API, self-hosted homeserver support
- Ntfy — Push notifications, priority levels, action buttons
**Email / Newsletter (5)**
- Mailchimp — Campaigns API, audience selection, send/draft modes
- SendGrid — Marketing Campaigns API v3, Single Send creation
- Brevo (Sendinblue) — API v3, campaign creation
- ConvertKit — API v3, broadcast creation
- Constant Contact — API v3, campaign creation
**Publishing / Blogging (6)**
- Medium — Publishing API, full HTML, canonical URL, tags
- WordPress — REST API v2, Application Passwords, category mapping
- Dev.to — Forem API, markdown, series support
- Ghost — Admin API v5, JWT auth, full HTML
- Hashnode — GraphQL API, cover image, tags
- Google Blogger — Blogger API v3, labels from categories
**Business (1)**
- Google Business Profile — API v1, local posts (UPDATE/EVENT/OFFER)
**Universal (2)**
- Generic Webhook — POST/PUT to any URL, JSON/form body, custom headers (IFTTT, Zapier, n8n, Make)
- RSS Feed — dedicated cross-post feed generation
#### Plugin Configuration
- Telegram: default bot token, parse mode, link preview toggle
- Facebook: default page access token, default page ID
- Discord: default webhook URL, embed color
- Slack: default webhook URL
- LinkedIn: OAuth client ID/secret, redirect URI
- Mastodon: default instance URL, visibility, hashtags
- Bluesky: default PDS URL, auto link cards
- Mailchimp: default sender name/email, auto-send toggle
- Microsoft Teams: default webhook URL
- Threads: default webhook URL
#### Infrastructure
- 7 CI/CD workflows: CI, auto-release, pre-release, auto-bump, update-server, cascade-dev, issue-branch
- Joomla update server (`updates.xml`) with development channel
- WebServices REST API plugin with CRUD routes for posts and services
- Database: 4 tables (services, posts, templates, logs) with default templates
- Package installer with auto-enable for core + task + service plugins
- 9 wiki documentation pages
- Windows Terminal profile in Joomla dropdown
## [01.00.00] - 2026-05-28
### Added
- Initial release
- Service plugins: Facebook, X/Twitter, LinkedIn, Mastodon, Bluesky, Mailchimp, Telegram, Discord, Slack
- Database tables: services, posts, templates, logs
- Perfect Publisher Pro migration tool in installer script
- Message template system with per-platform placeholders
- Post queue with scheduled posting, retry logic, and delivery tracking
+161
View File
@@ -0,0 +1,161 @@
# Contributing to Moko Consulting Projects
Thank you for your interest in contributing. All Moko Consulting repositories follow this universal workflow and version policy.
## Branching Workflow
```
feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge──> main
```
### Step by step
1. **Create a feature branch** from `dev`:
```bash
git checkout dev && git pull
git checkout -b feature/my-change
```
2. **Work and commit** on your feature branch. Push to origin.
3. **Open a PR**: `feature/my-change` → `dev`. After review and checks, merge it.
4. **When ready for release**, open a **draft PR**: `dev` → `main`.
- This automatically renames the source branch to `rc` (release candidate)
- An RC pre-release is built and uploaded
5. **Alpha and beta branches** are created by manually renaming the branch before the RC stage:
- Rename `dev` to `alpha` for early testing → alpha pre-release is built
- Rename `alpha` to `beta` for feature-complete testing → beta pre-release is built
- When the draft PR is created, the branch is renamed to `rc`
6. **Once PR checks pass** on the `rc` branch, mark the PR as ready and merge to `main`.
7. **Merging to main** triggers the stable release pipeline:
- Minor version bump (e.g., `02.09.xx` → `02.10.00`)
- Stability suffix stripped (clean version)
- Gitea release created with ZIP/tar.gz packages
- `updates.xml` updated (Joomla extensions)
- `dev` branch recreated from `main`
### Branch summary
| Branch | Purpose | Created by |
|--------|---------|-----------|
| `feature/*` | New features and fixes | Developer |
| `dev` | Integration branch | Auto-recreated after release |
| `alpha` | Alpha pre-release testing | Manual rename from `dev` |
| `beta` | Beta pre-release testing | Manual rename from `alpha` |
| `rc` | Release candidate | Auto-renamed on draft PR to main |
| `main` | Stable releases | Protected, merge only |
| `version/XX.YY.ZZ` | Archived release snapshots | Auto-created by CI |
### Protected branches
| Branch | Direct push | Merge via |
|--------|------------|-----------|
| `main` | Blocked (CI bot whitelisted) | PR merge only |
| `dev` | Blocked (CI bot whitelisted) | PR merge from feature/* |
| `rc` | Blocked (CI bot whitelisted) | Auto-created on draft PR |
| `alpha` | Blocked (CI bot whitelisted) | Manual rename |
| `beta` | Blocked (CI bot whitelisted) | Manual rename |
| `feature/*` | Open | N/A (source branch) |
## Version Policy
### Format
All versions use `XX.YY.ZZ` — three two-digit segments, zero-padded:
- **XX** — Major version (breaking changes)
- **YY** — Minor version (new features, bumped on release to main)
- **ZZ** — Patch version (auto-incremented on every push to dev/feature branches)
Rollover: patch `99` → `00` increments minor; minor `99` → `00` increments major.
### Stability suffixes
Each branch appends a suffix to indicate stability:
| Branch | Suffix | Example |
|--------|--------|---------|
| `main` | (none) | `02.09.00` |
| `dev` | `-dev` | `02.09.01-dev` |
| `feature/*` | `-dev` | `02.09.01-dev` |
| `alpha` | `-alpha` | `02.09.01-alpha` |
| `beta` | `-beta` | `02.09.01-beta` |
| `rc` | `-rc` | `02.09.01-rc` |
### Auto version bump
On every push to `dev`, `feature/*`, or `patch/*`:
1. Patch version incremented
2. Stability suffix `-dev` applied
3. All version-bearing files updated (manifests, CHANGELOG, PHP headers, etc.)
4. Commit created with `[skip ci]` to avoid loops
### Release version flow
Version bumps happen at specific release events:
| Event | Bump | Example |
|-------|------|---------|
| Feature merged to dev | Patch bump after dev release | `02.09.01-dev` → release → `02.09.02-dev` |
| Dev promoted to RC | Minor bump | `02.09.02-dev` → `02.10.00-rc` |
| RC merged to main | Minor bump | `02.10.00-rc` → `02.11.00` (stable) |
| Dev recreated from main | Patch bump | `02.11.00` → `02.11.01-dev` |
### Release stream copies
When a higher-stability release is published, copies are created for all lesser streams with the same base version:
- **RC `02.10.00-rc`** also creates: `02.10.00-dev`, `02.10.00-alpha`, `02.10.00-beta`
- **Stable `02.11.00`** also creates: `02.11.00-dev`, `02.11.00-alpha`, `02.11.00-beta`, `02.11.00-rc`
This ensures Joomla sites on ANY stability channel see the update (Joomla only shows versions higher than what's installed).
### Version files
The version tools update all files containing version stamps:
- `.mokogitea/manifest.xml` (canonical source)
- Joomla XML manifests (`<version>` tag)
- `README.md`, `CHANGELOG.md` (`VERSION:` pattern)
- `package.json`, `pyproject.toml`
- Any text file with a `VERSION: XX.YY.ZZ` label
Files synced from other repos (with a `# REPO:` header) are not touched.
## Code Standards
- **PHP**: PSR-12, tabs for indentation
- **Copyright**: all files must include the Moko Consulting copyright header
- **License**: SPDX identifier `GPL-3.0-or-later` (or as specified per repo)
- **Attribution**: use `Authored-by: Moko Consulting` in commits, not individual names
## Commit Messages
Use conventional commit format:
```
type(scope): short description
Optional body with context.
Authored-by: Moko Consulting
```
Types: `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `ci`
Special flags in commit messages:
- `[skip ci]` — skip all CI workflows
- `[skip bump]` — skip auto version bump only
## Reporting Issues
Use the repository's issue tracker with the appropriate template.
---
*Moko Consulting <hello@mokoconsulting.tech>*
+1 -1
View File
@@ -1,6 +1,6 @@
# MokoJoomCross
<!-- VERSION: 01.00.22 -->
<!-- VERSION: 01.00.00-dev -->
Cross-posting Joomla content to social media, email marketing, and chat platforms for Joomla 5/6.
+237
View File
@@ -0,0 +1,237 @@
#!/usr/bin/env bash
# ============================================================================
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Automation.CI
# INGROUP: moko-platform.Automation
# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
# PATH: /automation/ci-issue-reporter.sh
# VERSION: 09.23.00
# BRIEF: Creates or updates a Gitea issue when a CI gate fails.
# Deduplicates by searching open issues with the "ci-auto" label
# whose title matches the gate. If a matching issue exists, a comment
# is appended instead of opening a duplicate.
# ============================================================================
set -euo pipefail
# ── Defaults ────────────────────────────────────────────────────────────────
GITEA_URL="${GITEA_URL:-https://git.mokoconsulting.tech}"
GITEA_TOKEN="${GITEA_TOKEN:-}"
REPO="${GITHUB_REPOSITORY:-}"
RUN_URL="${GITHUB_SERVER_URL:-${GITEA_URL}}/${REPO}/actions/runs/${GITHUB_RUN_ID:-0}"
LABEL_NAME="ci-auto"
LABEL_COLOR="#e11d48"
GATE=""
DETAILS=""
SEVERITY="error"
WORKFLOW=""
# ── Parse arguments ─────────────────────────────────────────────────────────
usage() {
cat <<EOF
Usage: ci-issue-reporter.sh --gate NAME --details TEXT [OPTIONS]
Required:
--gate CI gate name (e.g. "Code Quality", "Self-Health")
--details Human-readable failure description
Optional:
--severity "error" (default) or "warning"
--workflow Workflow name for the issue title
--repo owner/repo (default: \$GITHUB_REPOSITORY)
--run-url URL to the CI run (auto-detected from env)
--token Gitea API token (default: \$GITEA_TOKEN)
--url Gitea base URL (default: \$GITEA_URL)
EOF
exit 1
}
while [[ $# -gt 0 ]]; do
case "$1" in
--gate) GATE="$2"; shift 2 ;;
--details) DETAILS="$2"; shift 2 ;;
--severity) SEVERITY="$2"; shift 2 ;;
--workflow) WORKFLOW="$2"; shift 2 ;;
--repo) REPO="$2"; shift 2 ;;
--run-url) RUN_URL="$2"; shift 2 ;;
--token) GITEA_TOKEN="$2"; shift 2 ;;
--url) GITEA_URL="$2"; shift 2 ;;
-h|--help) usage ;;
*) echo "Unknown option: $1"; usage ;;
esac
done
[[ -z "$GATE" ]] && { echo "ERROR: --gate is required"; usage; }
[[ -z "$DETAILS" ]] && { echo "ERROR: --details is required"; usage; }
[[ -z "$GITEA_TOKEN" ]] && { echo "ERROR: GITEA_TOKEN not set"; exit 1; }
[[ -z "$REPO" ]] && { echo "ERROR: GITHUB_REPOSITORY not set"; exit 1; }
API="${GITEA_URL}/api/v1/repos/${REPO}"
# ── Build title ─────────────────────────────────────────────────────────────
if [[ -n "$WORKFLOW" ]]; then
TITLE="[CI] ${WORKFLOW}: ${GATE} failed"
else
TITLE="[CI] ${GATE} failed"
fi
# ── Ensure label exists ─────────────────────────────────────────────────────
ensure_label() {
local exists
exists=$(curl -sf -o /dev/null -w '%{http_code}' \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/labels" 2>/dev/null || echo "000")
if [[ "$exists" == "200" ]]; then
# Check if label already exists
local found
found=$(curl -sf \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/labels" 2>/dev/null \
| grep -o "\"name\":\"${LABEL_NAME}\"" || true)
if [[ -z "$found" ]]; then
curl -sf -X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
"${API}/labels" \
-d "{\"name\":\"${LABEL_NAME}\",\"color\":\"${LABEL_COLOR}\",\"description\":\"Auto-created by CI issue reporter\"}" \
> /dev/null 2>&1 || true
fi
fi
}
# ── Search for existing open issue ──────────────────────────────────────────
find_existing_issue() {
# URL-encode the gate name for the query
local query
query=$(printf '%s' "[CI] ${GATE}" | sed 's/ /%20/g; s/\[/%5B/g; s/\]/%5D/g')
local response
response=$(curl -sf \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/issues?type=issues&state=open&labels=${LABEL_NAME}&q=${query}&limit=5" \
2>/dev/null || echo "[]")
# Extract the first matching issue number
echo "$response" \
| grep -oP '"number":\s*\K[0-9]+' \
| head -1
}
# ── Build issue body ────────────────────────────────────────────────────────
build_body() {
local severity_badge
if [[ "$SEVERITY" == "error" ]]; then
severity_badge="**Severity:** Error"
else
severity_badge="**Severity:** Warning"
fi
cat <<BODY
## CI Gate Failure: ${GATE}
${severity_badge}
**Workflow:** ${WORKFLOW:-unknown}
**Branch:** ${GITHUB_REF_NAME:-unknown}
**Commit:** \`${GITHUB_SHA:0:8}\`
**Run:** [View CI run](${RUN_URL})
### Details
${DETAILS}
### Resolution
Fix the issue described above and push a new commit. This issue will be closed automatically when the gate passes, or can be closed manually.
---
*Auto-created by [ci-issue-reporter](${GITEA_URL}/${REPO}/src/branch/main/automation/ci-issue-reporter.sh)*
BODY
}
# ── Build comment body (for existing issues) ────────────────────────────────
build_comment() {
cat <<COMMENT
### CI failure recurrence
**Branch:** ${GITHUB_REF_NAME:-unknown}
**Commit:** \`${GITHUB_SHA:0:8}\`
**Run:** [View CI run](${RUN_URL})
${DETAILS}
COMMENT
}
# ── Main ────────────────────────────────────────────────────────────────────
ensure_label
EXISTING=$(find_existing_issue)
if [[ -n "$EXISTING" ]]; then
# Append comment to existing issue
COMMENT_BODY=$(build_comment)
COMMENT_JSON=$(printf '%s' "$COMMENT_BODY" | python3 -c "
import sys, json
print(json.dumps({'body': sys.stdin.read()}))" 2>/dev/null)
HTTP=$(curl -sf -o /dev/null -w '%{http_code}' -X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
"${API}/issues/${EXISTING}/comments" \
-d "${COMMENT_JSON}" 2>/dev/null || echo "000")
if [[ "$HTTP" == "201" ]]; then
echo "Commented on existing issue #${EXISTING}"
else
echo "WARNING: Failed to comment on issue #${EXISTING} (HTTP ${HTTP})"
fi
else
# Create new issue
ISSUE_BODY=$(build_body)
ISSUE_JSON=$(python3 -c "
import sys, json
body = sys.stdin.read()
print(json.dumps({
'title': sys.argv[1],
'body': body,
'labels': []
}))" "$TITLE" <<< "$ISSUE_BODY" 2>/dev/null)
# Create the issue
RESPONSE=$(curl -sf -X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
"${API}/issues" \
-d "${ISSUE_JSON}" 2>/dev/null || echo "{}")
ISSUE_NUM=$(echo "$RESPONSE" | grep -oP '"number":\s*\K[0-9]+' | head -1)
if [[ -n "$ISSUE_NUM" ]]; then
# Apply label (separate call — more reliable across Gitea versions)
LABEL_ID=$(curl -sf \
-H "Authorization: token ${GITEA_TOKEN}" \
"${API}/labels" 2>/dev/null \
| grep -oP "\"id\":\s*\K[0-9]+(?=[^}]*\"name\":\s*\"${LABEL_NAME}\")" \
| head -1 || true)
if [[ -n "$LABEL_ID" ]]; then
curl -sf -X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
"${API}/issues/${ISSUE_NUM}/labels" \
-d "{\"labels\":[${LABEL_ID}]}" \
> /dev/null 2>&1 || true
fi
echo "Created issue #${ISSUE_NUM}: ${TITLE}"
else
echo "WARNING: Failed to create issue"
echo "Response: ${RESPONSE}"
fi
fi
-83
View File
@@ -12,18 +12,6 @@
<option value="0">JNO</option>
</field>
<field
name="post_on_first_publish_only"
type="radio"
label="COM_MOKOJOOMCROSS_CONFIG_FIRST_PUBLISH_ONLY"
description="COM_MOKOJOOMCROSS_CONFIG_FIRST_PUBLISH_ONLY_DESC"
default="0"
class="btn-group"
showon="auto_post_on_publish:1">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="retry_max"
type="number"
@@ -63,75 +51,4 @@
rows="4"
/>
</fieldset>
<fieldset name="evergreen" label="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN">
<field
name="evergreen_enabled"
type="radio"
label="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_ENABLED"
description="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_ENABLED_DESC"
default="1"
class="btn-group">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
<field
name="evergreen_default_interval"
type="number"
label="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_DEFAULT_INTERVAL"
description="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_DEFAULT_INTERVAL_DESC"
default="30"
min="1"
max="365"
showon="evergreen_enabled:1"
/>
<field
name="evergreen_max_per_run"
type="number"
label="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_MAX_PER_RUN"
description="COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_MAX_PER_RUN_DESC"
default="3"
min="1"
max="20"
showon="evergreen_enabled:1"
/>
</fieldset>
<fieldset name="queue" label="COM_MOKOJOOMCROSS_CONFIG_QUEUE">
<field
name="queue_processing"
type="list"
label="COM_MOKOJOOMCROSS_CONFIG_QUEUE_PROCESSING"
description="COM_MOKOJOOMCROSS_CONFIG_QUEUE_PROCESSING_DESC"
default="scheduler">
<option value="scheduler">COM_MOKOJOOMCROSS_CONFIG_QUEUE_SCHEDULER</option>
<option value="pageload">COM_MOKOJOOMCROSS_CONFIG_QUEUE_PAGELOAD</option>
<option value="both">COM_MOKOJOOMCROSS_CONFIG_QUEUE_BOTH</option>
</field>
<field
name="pageload_client"
type="list"
label="COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_CLIENT"
description="COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_CLIENT_DESC"
default="both"
showon="queue_processing:pageload,both">
<option value="both">COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_BOTH</option>
<option value="admin">COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_ADMIN</option>
<option value="site">COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_SITE</option>
</field>
<field
name="pageload_interval"
type="number"
label="COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_INTERVAL"
description="COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_INTERVAL_DESC"
default="300"
min="60"
max="3600"
showon="queue_processing:pageload,both"
/>
</fieldset>
</config>
@@ -1,37 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fields name="filter">
<field
name="search"
type="text"
label="COM_MOKOJOOMCROSS_FILTER_SEARCH"
hint="JSEARCH_FILTER"
/>
<field
name="level"
type="list"
label="COM_MOKOJOOMCROSS_FILTER_LEVEL"
onchange="this.form.submit();">
<option value="">COM_MOKOJOOMCROSS_SELECT_LEVEL</option>
<option value="info">Info</option>
<option value="warning">Warning</option>
<option value="error">Error</option>
</field>
</fields>
<fields name="list">
<field
name="fullordering"
type="list"
label="JGLOBAL_SORT_BY"
default="a.created DESC"
onchange="this.form.submit();">
<option value="">JGLOBAL_SORT_BY</option>
<option value="a.created ASC">COM_MOKOJOOMCROSS_CREATED_ASC</option>
<option value="a.created DESC">COM_MOKOJOOMCROSS_CREATED_DESC</option>
<option value="a.level ASC">COM_MOKOJOOMCROSS_LEVEL_ASC</option>
<option value="a.level DESC">COM_MOKOJOOMCROSS_LEVEL_DESC</option>
</field>
</fields>
</form>
@@ -20,19 +20,6 @@
<option value="failed">Failed</option>
<option value="scheduled">Scheduled</option>
</field>
<field
name="service_id"
type="sql"
label="COM_MOKOJOOMCROSS_FILTER_SERVICE_TYPE"
onchange="this.form.submit();"
sql_select="id, CONCAT(title, ' (', service_type, ')') AS title"
sql_from="#__mokojoomcross_services"
key_field="id"
value_field="title"
sql_order="ordering ASC">
<option value="">COM_MOKOJOOMCROSS_SELECT_SERVICE</option>
</field>
</fields>
<fields name="list">
@@ -1,51 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fields name="filter">
<field
name="search"
type="text"
label="COM_MOKOJOOMCROSS_FILTER_SEARCH"
hint="JSEARCH_FILTER"
/>
<field
name="published"
type="status"
label="JOPTION_SELECT_PUBLISHED"
onchange="this.form.submit();">
<option value="">JOPTION_SELECT_PUBLISHED</option>
</field>
<field
name="service_type"
type="list"
label="COM_MOKOJOOMCROSS_FILTER_SERVICE_TYPE"
onchange="this.form.submit();">
<option value="">COM_MOKOJOOMCROSS_SELECT_SERVICE_TYPE</option>
<option value="default">Default</option>
<option value="facebook">Facebook</option>
<option value="twitter">X / Twitter</option>
<option value="linkedin">LinkedIn</option>
<option value="mastodon">Mastodon</option>
<option value="bluesky">Bluesky</option>
<option value="mailchimp">Mailchimp</option>
<option value="telegram">Telegram</option>
<option value="discord">Discord</option>
<option value="slack">Slack</option>
</field>
</fields>
<fields name="list">
<field
name="fullordering"
type="list"
label="JGLOBAL_SORT_BY"
default="a.ordering ASC"
onchange="this.form.submit();">
<option value="">JGLOBAL_SORT_BY</option>
<option value="a.title ASC">JGLOBAL_TITLE_ASC</option>
<option value="a.title DESC">JGLOBAL_TITLE_DESC</option>
<option value="a.ordering ASC">JGLOBAL_ORDERING_ASC</option>
</field>
</fields>
</form>
@@ -1,125 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="details">
<field
name="id"
type="hidden"
/>
<field
name="article_id"
type="sql"
label="COM_MOKOJOOMCROSS_POST_ARTICLE"
description="COM_MOKOJOOMCROSS_POST_ARTICLE_DESC"
required="true"
sql_select="id, title"
sql_from="#__content"
sql_filter="true"
sql_default_title="- Select Article -"
key_field="id"
value_field="title"
sql_order="title ASC"
>
<option value="">COM_MOKOJOOMCROSS_SELECT_ARTICLE</option>
</field>
<field
name="service_id"
type="sql"
label="COM_MOKOJOOMCROSS_POST_SERVICE"
description="COM_MOKOJOOMCROSS_POST_SERVICE_DESC"
required="true"
sql_select="id, CONCAT(title, ' (', service_type, ')') AS title"
sql_from="#__mokojoomcross_services"
sql_filter="true"
sql_default_title="- Select Service -"
sql_where="published = 1"
key_field="id"
value_field="title"
sql_order="ordering ASC"
>
<option value="">COM_MOKOJOOMCROSS_SELECT_SERVICE</option>
</field>
<field
name="message"
type="textarea"
label="COM_MOKOJOOMCROSS_POST_MESSAGE"
description="COM_MOKOJOOMCROSS_POST_MESSAGE_DESC"
rows="6"
cols="60"
required="true"
/>
<field
name="status"
type="list"
label="COM_MOKOJOOMCROSS_POST_STATUS"
default="queued">
<option value="queued">COM_MOKOJOOMCROSS_STATUS_QUEUED</option>
<option value="scheduled">COM_MOKOJOOMCROSS_STATUS_SCHEDULED</option>
<option value="posted">COM_MOKOJOOMCROSS_STATUS_POSTED</option>
<option value="failed">COM_MOKOJOOMCROSS_STATUS_FAILED</option>
</field>
<field
name="scheduled_at"
type="calendar"
label="COM_MOKOJOOMCROSS_POST_SCHEDULED_AT"
description="COM_MOKOJOOMCROSS_POST_SCHEDULED_AT_DESC"
showtime="true"
format="%Y-%m-%d %H:%M:%S"
/>
</fieldset>
<fieldset name="readonly" label="COM_MOKOJOOMCROSS_POST_RESULTS">
<field
name="platform_post_id"
type="text"
label="COM_MOKOJOOMCROSS_POST_PLATFORM_ID"
readonly="true"
/>
<field
name="error_message"
type="textarea"
label="COM_MOKOJOOMCROSS_POST_ERROR"
readonly="true"
rows="3"
/>
<field
name="retry_count"
type="number"
label="COM_MOKOJOOMCROSS_POST_RETRY_COUNT"
readonly="true"
/>
<field
name="posted_at"
type="calendar"
label="COM_MOKOJOOMCROSS_POST_POSTED_AT"
readonly="true"
showtime="true"
format="%Y-%m-%d %H:%M:%S"
/>
<field
name="created"
type="calendar"
label="JGLOBAL_CREATED"
readonly="true"
showtime="true"
format="%Y-%m-%d %H:%M:%S"
/>
<field
name="modified"
type="calendar"
label="JGLOBAL_MODIFIED"
readonly="true"
showtime="true"
format="%Y-%m-%d %H:%M:%S"
/>
</fieldset>
</form>
@@ -28,46 +28,15 @@
required="true"
default="">
<option value="">COM_MOKOJOOMCROSS_SELECT_SERVICE_TYPE</option>
<!-- Social Media -->
<option value="facebook">Facebook / Meta</option>
<option value="twitter">X / Twitter</option>
<option value="linkedin">LinkedIn</option>
<option value="mastodon">Mastodon</option>
<option value="bluesky">Bluesky</option>
<option value="threads">Threads (Meta)</option>
<option value="pinterest">Pinterest</option>
<option value="reddit">Reddit</option>
<option value="tumblr">Tumblr</option>
<option value="tiktok">TikTok</option>
<option value="nostr">Nostr</option>
<option value="activitypub">ActivityPub (Fediverse)</option>
<!-- Chat / Messaging -->
<option value="mailchimp">Mailchimp</option>
<option value="telegram">Telegram</option>
<option value="discord">Discord</option>
<option value="slack">Slack</option>
<option value="teams">Microsoft Teams</option>
<option value="googlechat">Google Chat</option>
<option value="whatsapp">WhatsApp Business</option>
<option value="matrix">Matrix / Element</option>
<option value="ntfy">Ntfy (Push Notifications)</option>
<!-- Email / Newsletter -->
<option value="mailchimp">Mailchimp</option>
<option value="sendgrid">SendGrid</option>
<option value="brevo">Brevo (Sendinblue)</option>
<option value="convertkit">ConvertKit</option>
<option value="constantcontact">Constant Contact</option>
<!-- Publishing / Blogging -->
<option value="medium">Medium</option>
<option value="wordpress">WordPress</option>
<option value="devto">Dev.to</option>
<option value="ghost">Ghost</option>
<option value="hashnode">Hashnode</option>
<option value="blogger">Google Blogger</option>
<!-- Business -->
<option value="googlebusiness">Google Business Profile</option>
<!-- Other -->
<option value="webhook">Generic Webhook</option>
<option value="rssfeed">RSS Feed</option>
</field>
<field
@@ -86,825 +55,14 @@
/>
</fieldset>
<!-- ============================================================ -->
<!-- Per-service credential fields using showon -->
<!-- ============================================================ -->
<!-- Mode selector for services with default bot support -->
<fieldset name="credentials" label="COM_MOKOJOOMCROSS_FIELDSET_CREDENTIALS">
<field
name="cred_mode"
type="list"
label="COM_MOKOJOOMCROSS_FIELD_CRED_MODE"
description="COM_MOKOJOOMCROSS_FIELD_CRED_MODE_DESC"
default="default"
showon="service_type:telegram,discord,slack,teams,facebook,threads">
<option value="default">COM_MOKOJOOMCROSS_CRED_MODE_DEFAULT</option>
<option value="custom">COM_MOKOJOOMCROSS_CRED_MODE_CUSTOM</option>
</field>
<!-- ======== TELEGRAM ======== -->
<field
name="cred_telegram_chat_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_TELEGRAM_CHAT_ID"
description="COM_MOKOJOOMCROSS_CRED_TELEGRAM_CHAT_ID_DESC"
showon="service_type:telegram"
size="40"
/>
<field
name="cred_telegram_bot_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TELEGRAM_BOT_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_TELEGRAM_BOT_TOKEN_DESC"
showon="service_type:telegram[AND]cred_mode:custom"
size="60"
/>
<!-- ======== DISCORD ======== -->
<field
name="cred_discord_webhook_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_DISCORD_WEBHOOK"
description="COM_MOKOJOOMCROSS_CRED_DISCORD_WEBHOOK_DESC"
showon="service_type:discord[AND]cred_mode:custom"
size="80"
/>
<field
name="cred_discord_username"
type="text"
label="COM_MOKOJOOMCROSS_CRED_DISCORD_USERNAME"
description="COM_MOKOJOOMCROSS_CRED_DISCORD_USERNAME_DESC"
showon="service_type:discord"
size="40"
/>
<field
name="cred_discord_avatar_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_DISCORD_AVATAR"
description="COM_MOKOJOOMCROSS_CRED_DISCORD_AVATAR_DESC"
showon="service_type:discord"
size="80"
/>
<!-- ======== SLACK ======== -->
<field
name="cred_slack_webhook_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_SLACK_WEBHOOK"
description="COM_MOKOJOOMCROSS_CRED_SLACK_WEBHOOK_DESC"
showon="service_type:slack[AND]cred_mode:custom"
size="80"
/>
<!-- ======== MICROSOFT TEAMS ======== -->
<field
name="cred_teams_webhook_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_TEAMS_WEBHOOK"
description="COM_MOKOJOOMCROSS_CRED_TEAMS_WEBHOOK_DESC"
showon="service_type:teams[AND]cred_mode:custom"
size="80"
/>
<!-- ======== GOOGLE CHAT ======== -->
<field
name="cred_googlechat_webhook_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_GOOGLECHAT_WEBHOOK"
description="COM_MOKOJOOMCROSS_CRED_GOOGLECHAT_WEBHOOK_DESC"
showon="service_type:googlechat"
size="80"
/>
<!-- ======== FACEBOOK ======== -->
<field
name="cred_facebook_page_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_FACEBOOK_PAGE_ID"
description="COM_MOKOJOOMCROSS_CRED_FACEBOOK_PAGE_ID_DESC"
showon="service_type:facebook"
size="40"
/>
<field
name="cred_facebook_page_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_FACEBOOK_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_FACEBOOK_TOKEN_DESC"
showon="service_type:facebook[AND]cred_mode:custom"
size="60"
/>
<!-- ======== THREADS ======== -->
<field
name="cred_threads_user_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_THREADS_USER_ID"
showon="service_type:threads"
size="40"
/>
<field
name="cred_threads_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_THREADS_TOKEN"
showon="service_type:threads[AND]cred_mode:custom"
size="60"
/>
<!-- ======== TWITTER / X (OAuth 1.0a — 4 keys required for posting) ======== -->
<field
name="cred_twitter_api_key"
type="text"
label="COM_MOKOJOOMCROSS_CRED_TWITTER_API_KEY"
description="COM_MOKOJOOMCROSS_CRED_TWITTER_API_KEY_DESC"
showon="service_type:twitter"
size="40"
/>
<field
name="cred_twitter_api_secret"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TWITTER_API_SECRET"
description="COM_MOKOJOOMCROSS_CRED_TWITTER_API_SECRET_DESC"
showon="service_type:twitter"
size="40"
/>
<field
name="cred_twitter_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_DESC"
showon="service_type:twitter"
size="60"
/>
<field
name="cred_twitter_access_token_secret"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_SECRET"
description="COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_SECRET_DESC"
showon="service_type:twitter"
size="60"
/>
<!-- ======== LINKEDIN ======== -->
<field
name="cred_linkedin_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_LINKEDIN_TOKEN"
showon="service_type:linkedin"
size="60"
/>
<field
name="cred_linkedin_organization_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_LINKEDIN_ORG_ID"
description="COM_MOKOJOOMCROSS_CRED_LINKEDIN_ORG_ID_DESC"
showon="service_type:linkedin"
size="40"
/>
<field
name="cred_linkedin_refresh_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_LINKEDIN_REFRESH_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_LINKEDIN_REFRESH_TOKEN_DESC"
showon="service_type:linkedin"
size="60"
/>
<!-- ======== MASTODON ======== -->
<field
name="cred_mastodon_instance_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_MASTODON_INSTANCE"
description="COM_MOKOJOOMCROSS_CRED_MASTODON_INSTANCE_DESC"
showon="service_type:mastodon"
size="40"
default="https://mastodon.social"
/>
<field
name="cred_mastodon_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_MASTODON_TOKEN"
showon="service_type:mastodon"
size="60"
/>
<!-- ======== BLUESKY ======== -->
<field
name="cred_bluesky_handle"
type="text"
label="COM_MOKOJOOMCROSS_CRED_BLUESKY_HANDLE"
description="COM_MOKOJOOMCROSS_CRED_BLUESKY_HANDLE_DESC"
showon="service_type:bluesky"
size="40"
/>
<field
name="cred_bluesky_app_password"
type="password"
label="COM_MOKOJOOMCROSS_CRED_BLUESKY_APP_PWD"
description="COM_MOKOJOOMCROSS_CRED_BLUESKY_APP_PWD_DESC"
showon="service_type:bluesky"
size="40"
/>
<field
name="cred_bluesky_pds_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_BLUESKY_PDS_URL"
description="COM_MOKOJOOMCROSS_CRED_BLUESKY_PDS_URL_DESC"
showon="service_type:bluesky"
size="40"
default="https://bsky.social"
/>
<!-- ======== WHATSAPP ======== -->
<field
name="cred_whatsapp_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_WHATSAPP_TOKEN"
showon="service_type:whatsapp"
size="60"
/>
<field
name="cred_whatsapp_phone_number_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_WHATSAPP_PHONE_ID"
showon="service_type:whatsapp"
size="40"
/>
<field
name="cred_whatsapp_recipient"
type="text"
label="COM_MOKOJOOMCROSS_CRED_WHATSAPP_RECIPIENT"
description="COM_MOKOJOOMCROSS_CRED_WHATSAPP_RECIPIENT_DESC"
showon="service_type:whatsapp"
size="40"
/>
<!-- ======== MAILCHIMP ======== -->
<field
name="cred_mailchimp_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_KEY"
description="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_KEY_DESC"
showon="service_type:mailchimp"
size="60"
/>
<field
name="cred_mailchimp_list_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_LIST"
description="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_LIST_DESC"
showon="service_type:mailchimp"
size="40"
/>
<field
name="cred_mailchimp_from_name"
type="text"
label="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_NAME"
description="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_NAME_DESC"
showon="service_type:mailchimp"
size="40"
/>
<field
name="cred_mailchimp_from_email"
type="email"
label="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_EMAIL"
description="COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_EMAIL_DESC"
showon="service_type:mailchimp"
size="40"
/>
<!-- ======== SENDGRID ======== -->
<field
name="cred_sendgrid_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_SENDGRID_KEY"
showon="service_type:sendgrid"
size="60"
/>
<field
name="cred_sendgrid_list_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_SENDGRID_LIST"
showon="service_type:sendgrid"
size="40"
/>
<field
name="cred_sendgrid_from_email"
type="email"
label="COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_EMAIL"
description="COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_EMAIL_DESC"
showon="service_type:sendgrid"
size="40"
/>
<field
name="cred_sendgrid_from_name"
type="text"
label="COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_NAME"
description="COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_NAME_DESC"
showon="service_type:sendgrid"
size="40"
/>
<!-- ======== GENERIC WEBHOOK ======== -->
<field
name="cred_webhook_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_URL"
description="COM_MOKOJOOMCROSS_CRED_WEBHOOK_URL_DESC"
showon="service_type:webhook"
size="80"
required="true"
/>
<field
name="cred_webhook_method"
type="list"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_METHOD"
showon="service_type:webhook"
default="POST">
<option value="POST">POST</option>
<option value="PUT">PUT</option>
</field>
<field
name="cred_webhook_auth_type"
type="list"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_AUTH_TYPE"
description="COM_MOKOJOOMCROSS_CRED_WEBHOOK_AUTH_TYPE_DESC"
showon="service_type:webhook"
default="none">
<option value="none">COM_MOKOJOOMCROSS_WEBHOOK_AUTH_NONE</option>
<option value="bearer">COM_MOKOJOOMCROSS_WEBHOOK_AUTH_BEARER</option>
<option value="basic">COM_MOKOJOOMCROSS_WEBHOOK_AUTH_BASIC</option>
</field>
<field
name="cred_webhook_bearer_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_BEARER_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_WEBHOOK_BEARER_TOKEN_DESC"
showon="service_type:webhook[AND]cred_webhook_auth_type:bearer"
size="60"
/>
<field
name="cred_webhook_basic_username"
type="text"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_BASIC_USER"
showon="service_type:webhook[AND]cred_webhook_auth_type:basic"
size="40"
/>
<field
name="cred_webhook_basic_password"
type="password"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_BASIC_PWD"
showon="service_type:webhook[AND]cred_webhook_auth_type:basic"
size="40"
/>
<field
name="cred_webhook_content_type"
type="list"
label="COM_MOKOJOOMCROSS_CRED_WEBHOOK_CONTENT_TYPE"
showon="service_type:webhook"
default="json">
<option value="json">application/json</option>
<option value="form">application/x-www-form-urlencoded</option>
</field>
<!-- ======== MATRIX ======== -->
<field
name="cred_matrix_homeserver"
type="url"
label="COM_MOKOJOOMCROSS_CRED_MATRIX_HOMESERVER"
showon="service_type:matrix"
size="40"
default="https://matrix.org"
/>
<field
name="cred_matrix_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_MATRIX_TOKEN"
showon="service_type:matrix"
size="60"
/>
<field
name="cred_matrix_room_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_MATRIX_ROOM"
description="COM_MOKOJOOMCROSS_CRED_MATRIX_ROOM_DESC"
showon="service_type:matrix"
size="40"
/>
<!-- ======== NTFY ======== -->
<field
name="cred_ntfy_server_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_NTFY_SERVER"
showon="service_type:ntfy"
size="40"
default="https://ntfy.sh"
/>
<field
name="cred_ntfy_topic"
type="text"
label="COM_MOKOJOOMCROSS_CRED_NTFY_TOPIC"
description="COM_MOKOJOOMCROSS_CRED_NTFY_TOPIC_DESC"
showon="service_type:ntfy"
size="40"
required="true"
/>
<field
name="cred_ntfy_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_NTFY_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_NTFY_TOKEN_DESC"
showon="service_type:ntfy"
size="40"
/>
<!-- ======== WORDPRESS ======== -->
<field
name="cred_wordpress_site_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_WP_SITE"
showon="service_type:wordpress"
size="40"
/>
<field
name="cred_wordpress_username"
type="text"
label="COM_MOKOJOOMCROSS_CRED_WP_USER"
showon="service_type:wordpress"
size="40"
/>
<field
name="cred_wordpress_app_password"
type="password"
label="COM_MOKOJOOMCROSS_CRED_WP_APP_PWD"
description="COM_MOKOJOOMCROSS_CRED_WP_APP_PWD_DESC"
showon="service_type:wordpress"
size="40"
/>
<field
name="cred_wordpress_default_status"
type="list"
label="COM_MOKOJOOMCROSS_CRED_WP_DEFAULT_STATUS"
description="COM_MOKOJOOMCROSS_CRED_WP_DEFAULT_STATUS_DESC"
showon="service_type:wordpress"
default="draft">
<option value="draft">COM_MOKOJOOMCROSS_STATUS_DRAFT</option>
<option value="publish">COM_MOKOJOOMCROSS_STATUS_PUBLISH</option>
</field>
<!-- ======== MEDIUM ======== -->
<field
name="cred_medium_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_MEDIUM_TOKEN"
showon="service_type:medium"
size="60"
/>
<!-- ======== DEV.TO ======== -->
<field
name="cred_devto_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_DEVTO_KEY"
showon="service_type:devto"
size="60"
/>
<field
name="cred_devto_organization_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_DEVTO_ORG_ID"
description="COM_MOKOJOOMCROSS_CRED_DEVTO_ORG_ID_DESC"
showon="service_type:devto"
size="40"
/>
<!-- ======== GHOST ======== -->
<field
name="cred_ghost_site_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_GHOST_SITE"
showon="service_type:ghost"
size="40"
/>
<field
name="cred_ghost_admin_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_GHOST_KEY"
showon="service_type:ghost"
size="60"
/>
<field
name="cred_ghost_default_status"
type="list"
label="COM_MOKOJOOMCROSS_CRED_GHOST_DEFAULT_STATUS"
description="COM_MOKOJOOMCROSS_CRED_GHOST_DEFAULT_STATUS_DESC"
showon="service_type:ghost"
default="draft">
<option value="draft">COM_MOKOJOOMCROSS_STATUS_DRAFT</option>
<option value="published">COM_MOKOJOOMCROSS_STATUS_PUBLISHED</option>
</field>
<!-- ======== REDDIT ======== -->
<field
name="cred_reddit_client_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_REDDIT_CLIENT_ID"
showon="service_type:reddit"
size="40"
/>
<field
name="cred_reddit_client_secret"
type="password"
label="COM_MOKOJOOMCROSS_CRED_REDDIT_SECRET"
showon="service_type:reddit"
size="40"
/>
<field
name="cred_reddit_username"
type="text"
label="COM_MOKOJOOMCROSS_CRED_REDDIT_USER"
showon="service_type:reddit"
size="40"
/>
<field
name="cred_reddit_password"
type="password"
label="COM_MOKOJOOMCROSS_CRED_REDDIT_PASSWORD"
description="COM_MOKOJOOMCROSS_CRED_REDDIT_PASSWORD_DESC"
showon="service_type:reddit"
size="40"
/>
<field
name="cred_reddit_subreddit"
type="text"
label="COM_MOKOJOOMCROSS_CRED_REDDIT_SUBREDDIT"
description="COM_MOKOJOOMCROSS_CRED_REDDIT_SUBREDDIT_DESC"
showon="service_type:reddit"
size="40"
/>
<!-- ======== PINTEREST ======== -->
<field
name="cred_pinterest_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_PINTEREST_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_PINTEREST_TOKEN_DESC"
showon="service_type:pinterest"
size="60"
/>
<field
name="cred_pinterest_board_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_PINTEREST_BOARD"
description="COM_MOKOJOOMCROSS_CRED_PINTEREST_BOARD_DESC"
showon="service_type:pinterest"
size="40"
/>
<!-- ======== TUMBLR ======== -->
<field
name="cred_tumblr_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TUMBLR_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_TUMBLR_TOKEN_DESC"
showon="service_type:tumblr"
size="60"
/>
<field
name="cred_tumblr_blog_name"
type="text"
label="COM_MOKOJOOMCROSS_CRED_TUMBLR_BLOG"
description="COM_MOKOJOOMCROSS_CRED_TUMBLR_BLOG_DESC"
showon="service_type:tumblr"
size="40"
/>
<!-- ======== TIKTOK ======== -->
<field
name="cred_tiktok_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TIKTOK_TOKEN"
showon="service_type:tiktok"
size="60"
/>
<field
name="cred_tiktok_refresh_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_TIKTOK_REFRESH_TOKEN"
showon="service_type:tiktok"
size="60"
/>
<field
name="cred_tiktok_open_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_TIKTOK_OPEN_ID"
description="COM_MOKOJOOMCROSS_CRED_TIKTOK_OPEN_ID_DESC"
showon="service_type:tiktok"
size="40"
/>
<!-- ======== NOSTR ======== -->
<field
name="cred_nostr_private_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_NOSTR_PRIVKEY"
description="COM_MOKOJOOMCROSS_CRED_NOSTR_PRIVKEY_DESC"
showon="service_type:nostr"
size="60"
/>
<field
name="cred_nostr_relays"
name="credentials"
type="textarea"
label="COM_MOKOJOOMCROSS_CRED_NOSTR_RELAYS"
description="COM_MOKOJOOMCROSS_CRED_NOSTR_RELAYS_DESC"
showon="service_type:nostr"
rows="3"
cols="60"
/>
<!-- ======== ACTIVITYPUB (Fediverse) ======== -->
<field
name="cred_activitypub_instance_url"
type="url"
label="COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_INSTANCE"
description="COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_INSTANCE_DESC"
showon="service_type:activitypub"
size="40"
/>
<field
name="cred_activitypub_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_TOKEN"
description="COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_TOKEN_DESC"
showon="service_type:activitypub"
size="60"
/>
<!-- ======== BREVO (Sendinblue) ======== -->
<field
name="cred_brevo_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_BREVO_KEY"
showon="service_type:brevo"
size="60"
/>
<field
name="cred_brevo_list_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_BREVO_LIST"
description="COM_MOKOJOOMCROSS_CRED_BREVO_LIST_DESC"
showon="service_type:brevo"
size="40"
/>
<field
name="cred_brevo_sender_email"
type="email"
label="COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_EMAIL"
description="COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_EMAIL_DESC"
showon="service_type:brevo"
size="40"
/>
<field
name="cred_brevo_sender_name"
type="text"
label="COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_NAME"
showon="service_type:brevo"
size="40"
/>
<!-- ======== CONVERTKIT ======== -->
<field
name="cred_convertkit_api_key"
type="password"
label="COM_MOKOJOOMCROSS_CRED_CONVERTKIT_KEY"
showon="service_type:convertkit"
size="60"
/>
<field
name="cred_convertkit_api_secret"
type="password"
label="COM_MOKOJOOMCROSS_CRED_CONVERTKIT_SECRET"
showon="service_type:convertkit"
size="60"
/>
<!-- ======== CONSTANT CONTACT ======== -->
<field
name="cred_constantcontact_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_TOKEN"
showon="service_type:constantcontact"
size="60"
/>
<field
name="cred_constantcontact_refresh_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_REFRESH_TOKEN"
showon="service_type:constantcontact"
size="60"
/>
<field
name="cred_constantcontact_list_ids"
type="text"
label="COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_LISTS"
description="COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_LISTS_DESC"
showon="service_type:constantcontact"
size="40"
/>
<!-- ======== HASHNODE ======== -->
<field
name="cred_hashnode_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_HASHNODE_TOKEN"
showon="service_type:hashnode"
size="60"
/>
<field
name="cred_hashnode_publication_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_HASHNODE_PUB_ID"
description="COM_MOKOJOOMCROSS_CRED_HASHNODE_PUB_ID_DESC"
showon="service_type:hashnode"
size="40"
/>
<!-- ======== GOOGLE BLOGGER ======== -->
<field
name="cred_blogger_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_BLOGGER_TOKEN"
showon="service_type:blogger"
size="60"
/>
<field
name="cred_blogger_refresh_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_BLOGGER_REFRESH_TOKEN"
showon="service_type:blogger"
size="60"
/>
<field
name="cred_blogger_blog_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_BLOGGER_BLOG_ID"
description="COM_MOKOJOOMCROSS_CRED_BLOGGER_BLOG_ID_DESC"
showon="service_type:blogger"
size="40"
/>
<!-- ======== GOOGLE BUSINESS PROFILE ======== -->
<field
name="cred_googlebusiness_access_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_GBUSINESS_TOKEN"
showon="service_type:googlebusiness"
size="60"
/>
<field
name="cred_googlebusiness_refresh_token"
type="password"
label="COM_MOKOJOOMCROSS_CRED_GBUSINESS_REFRESH_TOKEN"
showon="service_type:googlebusiness"
size="60"
/>
<field
name="cred_googlebusiness_location_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_GBUSINESS_LOCATION"
description="COM_MOKOJOOMCROSS_CRED_GBUSINESS_LOCATION_DESC"
showon="service_type:googlebusiness"
size="40"
/>
<field
name="cred_googlebusiness_account_id"
type="text"
label="COM_MOKOJOOMCROSS_CRED_GBUSINESS_ACCOUNT"
description="COM_MOKOJOOMCROSS_CRED_GBUSINESS_ACCOUNT_DESC"
showon="service_type:googlebusiness"
size="40"
/>
<!-- ======== RSS FEED ======== -->
<field
name="cred_rssfeed_title"
type="text"
label="COM_MOKOJOOMCROSS_CRED_RSSFEED_TITLE"
description="COM_MOKOJOOMCROSS_CRED_RSSFEED_TITLE_DESC"
showon="service_type:rssfeed"
size="40"
/>
<field
name="cred_rssfeed_max_items"
type="number"
label="COM_MOKOJOOMCROSS_CRED_RSSFEED_MAX_ITEMS"
description="COM_MOKOJOOMCROSS_CRED_RSSFEED_MAX_ITEMS_DESC"
showon="service_type:rssfeed"
default="50"
min="1"
max="500"
label="COM_MOKOJOOMCROSS_FIELD_CREDENTIALS"
description="COM_MOKOJOOMCROSS_FIELD_CREDENTIALS_DESC"
rows="6"
filter="raw"
/>
</fieldset>
</form>
@@ -1,61 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="details">
<field
name="id"
type="hidden"
/>
<field
name="title"
type="text"
label="JGLOBAL_TITLE"
required="true"
size="40"
/>
<field
name="service_type"
type="list"
label="COM_MOKOJOOMCROSS_FIELD_SERVICE_TYPE"
description="COM_MOKOJOOMCROSS_TEMPLATE_SERVICE_TYPE_DESC"
default="default">
<option value="default">COM_MOKOJOOMCROSS_TEMPLATE_TYPE_DEFAULT</option>
<option value="facebook">Facebook</option>
<option value="twitter">X / Twitter</option>
<option value="linkedin">LinkedIn</option>
<option value="mastodon">Mastodon</option>
<option value="bluesky">Bluesky</option>
<option value="mailchimp">Mailchimp</option>
<option value="telegram">Telegram</option>
<option value="discord">Discord</option>
<option value="slack">Slack</option>
</field>
<field
name="template_body"
type="textarea"
label="COM_MOKOJOOMCROSS_TEMPLATE_BODY"
description="COM_MOKOJOOMCROSS_TEMPLATE_BODY_DESC"
rows="10"
cols="60"
required="true"
filter="raw"
/>
<field
name="published"
type="list"
label="JSTATUS"
default="1">
<option value="1">JPUBLISHED</option>
<option value="0">JUNPUBLISHED</option>
</field>
<field
name="ordering"
type="ordering"
label="JFIELD_ORDERING_LABEL"
/>
</fieldset>
</form>
@@ -58,445 +58,3 @@ COM_MOKOJOOMCROSS_CONFIG_LOG_RETENTION="Log Retention (days)"
COM_MOKOJOOMCROSS_CONFIG_LOG_RETENTION_DESC="Number of days to keep activity logs"
COM_MOKOJOOMCROSS_CONFIG_DEFAULT_TEMPLATE="Default Message Template"
COM_MOKOJOOMCROSS_CONFIG_DEFAULT_TEMPLATE_DESC="Default template for cross-posts. Placeholders: {title}, {url}, {introtext}, {image}, {category}, {author}"
; Table headings
COM_MOKOJOOMCROSS_HEADING_STATUS="Status"
COM_MOKOJOOMCROSS_HEADING_ARTICLE="Article"
COM_MOKOJOOMCROSS_HEADING_SERVICE="Service"
COM_MOKOJOOMCROSS_HEADING_MESSAGE="Message"
COM_MOKOJOOMCROSS_HEADING_POSTED_AT="Posted"
COM_MOKOJOOMCROSS_HEADING_CREATED="Created"
COM_MOKOJOOMCROSS_HEADING_LEVEL="Level"
COM_MOKOJOOMCROSS_HEADING_MODE="Mode"
; Dashboard
COM_MOKOJOOMCROSS_DASHBOARD_RECENT_ACTIVITY="Recent Activity"
COM_MOKOJOOMCROSS_DASHBOARD_NO_RECENT="No recent activity."
COM_MOKOJOOMCROSS_DASHBOARD_TOTAL_POSTS="Total Posts"
COM_MOKOJOOMCROSS_DASHBOARD_PAGELOAD_WARNING_TITLE="Page-load queue processing is active"
COM_MOKOJOOMCROSS_DASHBOARD_PAGELOAD_WARNING="You are using page-load processing for the cross-post queue. This is a fallback method and may be unreliable on low-traffic sites. For production use, switch to Joomla Scheduled Tasks: create a task of type <strong>MokoJoomCross - Process Queue</strong> in System → Scheduled Tasks, then set queue processing to <strong>Scheduler only</strong> in component options."
; Evergreen Configuration
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN="Evergreen Re-sharing"
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_ENABLED="Enable Evergreen"
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_ENABLED_DESC="Allow articles marked as evergreen to be automatically re-shared on a recurring schedule."
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_DEFAULT_INTERVAL="Default Interval (days)"
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_DEFAULT_INTERVAL_DESC="Default number of days between re-shares when no per-article interval is set."
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_MAX_PER_RUN="Max Re-shares Per Run"
COM_MOKOJOOMCROSS_CONFIG_EVERGREEN_MAX_PER_RUN_DESC="Maximum number of evergreen articles to re-share in a single queue processing run. Prevents flooding platforms."
; Queue Processing Configuration
COM_MOKOJOOMCROSS_CONFIG_QUEUE="Queue Processing"
COM_MOKOJOOMCROSS_CONFIG_QUEUE_PROCESSING="Processing Method"
COM_MOKOJOOMCROSS_CONFIG_QUEUE_PROCESSING_DESC="How queued posts, retries, and scheduled posts are processed. Scheduler (recommended) uses Joomla's built-in Task Scheduler. Page-load piggybacks on page requests."
COM_MOKOJOOMCROSS_CONFIG_QUEUE_SCHEDULER="Scheduler only (recommended)"
COM_MOKOJOOMCROSS_CONFIG_QUEUE_PAGELOAD="Page-load only (fallback)"
COM_MOKOJOOMCROSS_CONFIG_QUEUE_BOTH="Both (scheduler + page-load)"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_CLIENT="Page-load Client"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_CLIENT_DESC="Which Joomla application triggers page-load processing."
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_BOTH="Backend and Frontend"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_ADMIN="Backend only"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_SITE="Frontend only"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_INTERVAL="Page-load Interval (seconds)"
COM_MOKOJOOMCROSS_CONFIG_PAGELOAD_INTERVAL_DESC="Minimum seconds between page-load queue runs. Lower = more responsive but more DB queries per page load."
; Submenu (extended)
COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES="Templates"
; Template Management
COM_MOKOJOOMCROSS_TEMPLATE_BODY="Template Body"
COM_MOKOJOOMCROSS_TEMPLATE_BODY_DESC="Message template with placeholders. Use the reference panel on the right for available placeholders."
COM_MOKOJOOMCROSS_TEMPLATE_SERVICE_TYPE_DESC="Which platform this template is for. 'Default' is the fallback when no platform-specific template exists."
COM_MOKOJOOMCROSS_TEMPLATE_TYPE_DEFAULT="Default (fallback)"
COM_MOKOJOOMCROSS_TEMPLATE_PREVIEW="Preview"
COM_MOKOJOOMCROSS_TEMPLATE_PLACEHOLDERS="Available Placeholders"
; Placeholders
COM_MOKOJOOMCROSS_PLACEHOLDER_TITLE="Article title"
COM_MOKOJOOMCROSS_PLACEHOLDER_URL="Article URL"
COM_MOKOJOOMCROSS_PLACEHOLDER_INTROTEXT="Intro text (280 chars, no HTML)"
COM_MOKOJOOMCROSS_PLACEHOLDER_FULLTEXT="Full text (500 chars, no HTML)"
COM_MOKOJOOMCROSS_PLACEHOLDER_IMAGE="Intro image URL"
COM_MOKOJOOMCROSS_PLACEHOLDER_CATEGORY="Category name"
COM_MOKOJOOMCROSS_PLACEHOLDER_AUTHOR="Author name"
COM_MOKOJOOMCROSS_PLACEHOLDER_DATE="Publish date (YYYY-MM-DD)"
; Logs
COM_MOKOJOOMCROSS_FILTER_LEVEL="Level"
COM_MOKOJOOMCROSS_SELECT_LEVEL="- Select Level -"
COM_MOKOJOOMCROSS_LEVEL_ASC="Level ascending"
COM_MOKOJOOMCROSS_LEVEL_DESC="Level descending"
; Analytics Dashboard
COM_MOKOJOOMCROSS_DASHBOARD_SERVICE_BREAKDOWN="Posts by Service"
COM_MOKOJOOMCROSS_DASHBOARD_TOP_ARTICLES="Most Cross-Posted Articles"
COM_MOKOJOOMCROSS_DASHBOARD_SUCCESS_RATE="Success Rate"
; OAuth
COM_MOKOJOOMCROSS_OAUTH_NO_SERVICE="No service specified for OAuth authorization."
COM_MOKOJOOMCROSS_OAUTH_SERVICE_NOT_FOUND="Service not found."
COM_MOKOJOOMCROSS_OAUTH_NO_CLIENT_ID="No OAuth Client ID configured for %s. Set it in Extensions → Plugins → MokoJoomCross - %s."
COM_MOKOJOOMCROSS_OAUTH_NOT_SUPPORTED="OAuth is not supported for %s."
COM_MOKOJOOMCROSS_OAUTH_PLATFORM_ERROR="Platform returned error: %s"
COM_MOKOJOOMCROSS_OAUTH_INVALID_CALLBACK="Invalid OAuth callback — missing code or state."
COM_MOKOJOOMCROSS_OAUTH_INVALID_STATE="Invalid OAuth state parameter."
COM_MOKOJOOMCROSS_OAUTH_TOKEN_ERROR="Token exchange failed: %s"
COM_MOKOJOOMCROSS_OAUTH_SUCCESS="%s connected successfully! Access token stored."
; Post edit
COM_MOKOJOOMCROSS_NEW_POST="New Post"
COM_MOKOJOOMCROSS_EDIT_POST="Edit Post"
COM_MOKOJOOMCROSS_POST_ARTICLE="Article"
COM_MOKOJOOMCROSS_POST_ARTICLE_DESC="The Joomla article to cross-post."
COM_MOKOJOOMCROSS_SELECT_ARTICLE="- Select Article -"
COM_MOKOJOOMCROSS_POST_SERVICE="Service"
COM_MOKOJOOMCROSS_POST_SERVICE_DESC="The service to post to."
COM_MOKOJOOMCROSS_SELECT_SERVICE="- Select Service -"
COM_MOKOJOOMCROSS_POST_MESSAGE="Message"
COM_MOKOJOOMCROSS_POST_MESSAGE_DESC="The message to send to the platform. Use template placeholders or write a custom message."
COM_MOKOJOOMCROSS_POST_STATUS="Status"
COM_MOKOJOOMCROSS_STATUS_QUEUED="Queued"
COM_MOKOJOOMCROSS_STATUS_SCHEDULED="Scheduled"
COM_MOKOJOOMCROSS_STATUS_POSTED="Posted"
COM_MOKOJOOMCROSS_STATUS_FAILED="Failed"
COM_MOKOJOOMCROSS_POST_SCHEDULED_AT="Scheduled Date/Time"
COM_MOKOJOOMCROSS_POST_SCHEDULED_AT_DESC="When to send this post. Leave empty to process immediately. Set a future date to schedule."
COM_MOKOJOOMCROSS_POST_RESULTS="Post Results"
COM_MOKOJOOMCROSS_POST_PLATFORM_ID="Platform Post ID"
COM_MOKOJOOMCROSS_POST_ERROR="Error Message"
COM_MOKOJOOMCROSS_POST_RETRY_COUNT="Retry Count"
COM_MOKOJOOMCROSS_POST_POSTED_AT="Posted At"
COM_MOKOJOOMCROSS_POST_CREATE_HELP="Create a manual cross-post. Select an article and service, write your message, and optionally set a scheduled date. Leave the schedule empty to queue for immediate processing."
COM_MOKOJOOMCROSS_POST_REQUEUE="Re-queue for Posting"
COM_MOKOJOOMCROSS_POST_REQUEUE_HELP="Reset this post to queued status so it will be processed again on the next queue run."
; Service edit
COM_MOKOJOOMCROSS_NEW_SERVICE="New Service"
COM_MOKOJOOMCROSS_EDIT_SERVICE="Edit Service"
COM_MOKOJOOMCROSS_SERVICE_DETAILS="Service Details"
COM_MOKOJOOMCROSS_CREDENTIALS_HELP="Fill in the connection details for the selected platform. Fields change based on the service type you choose above."
; Credential mode
COM_MOKOJOOMCROSS_FIELD_CRED_MODE="Connection Mode"
COM_MOKOJOOMCROSS_FIELD_CRED_MODE_DESC="Default uses the pre-configured MokoWaaS account. Custom lets you use your own API credentials."
COM_MOKOJOOMCROSS_CRED_MODE_DEFAULT="Default (MokoWaaS)"
COM_MOKOJOOMCROSS_CRED_MODE_CUSTOM="Custom (your own credentials)"
; Telegram
COM_MOKOJOOMCROSS_CRED_TELEGRAM_CHAT_ID="Chat ID"
COM_MOKOJOOMCROSS_CRED_TELEGRAM_CHAT_ID_DESC="Telegram channel, group, or user chat ID. Channel IDs start with -100. Get yours from @userinfobot."
COM_MOKOJOOMCROSS_CRED_TELEGRAM_BOT_TOKEN="Bot Token"
COM_MOKOJOOMCROSS_CRED_TELEGRAM_BOT_TOKEN_DESC="Your custom Telegram bot token from @BotFather. Only needed in Custom mode."
; Discord
COM_MOKOJOOMCROSS_CRED_DISCORD_WEBHOOK="Webhook URL"
COM_MOKOJOOMCROSS_CRED_DISCORD_WEBHOOK_DESC="Discord channel webhook URL. Create one in Channel Settings → Integrations → Webhooks."
; Slack
COM_MOKOJOOMCROSS_CRED_SLACK_WEBHOOK="Webhook URL"
COM_MOKOJOOMCROSS_CRED_SLACK_WEBHOOK_DESC="Slack Incoming Webhook URL. Create one at api.slack.com/apps."
; Teams
COM_MOKOJOOMCROSS_CRED_TEAMS_WEBHOOK="Webhook URL"
COM_MOKOJOOMCROSS_CRED_TEAMS_WEBHOOK_DESC="Microsoft Teams Incoming Webhook URL. Create in channel Connectors."
; Google Chat
COM_MOKOJOOMCROSS_CRED_GOOGLECHAT_WEBHOOK="Webhook URL"
COM_MOKOJOOMCROSS_CRED_GOOGLECHAT_WEBHOOK_DESC="Google Chat space webhook URL."
; Facebook
COM_MOKOJOOMCROSS_CRED_FACEBOOK_PAGE_ID="Facebook Page ID"
COM_MOKOJOOMCROSS_CRED_FACEBOOK_PAGE_ID_DESC="Your Facebook Page numeric ID. Find it in Page Settings → About."
COM_MOKOJOOMCROSS_CRED_FACEBOOK_TOKEN="Page Access Token"
COM_MOKOJOOMCROSS_CRED_FACEBOOK_TOKEN_DESC="Long-lived Page Access Token. Use the Authorize button below or generate via Meta Business Suite."
; Threads
COM_MOKOJOOMCROSS_CRED_THREADS_USER_ID="Threads User ID"
COM_MOKOJOOMCROSS_CRED_THREADS_TOKEN="Access Token"
; Twitter (OAuth 1.0a)
COM_MOKOJOOMCROSS_CRED_TWITTER_API_KEY="API Key (Consumer Key)"
COM_MOKOJOOMCROSS_CRED_TWITTER_API_KEY_DESC="Consumer Key from the Twitter Developer Portal → Keys and Tokens."
COM_MOKOJOOMCROSS_CRED_TWITTER_API_SECRET="API Secret (Consumer Secret)"
COM_MOKOJOOMCROSS_CRED_TWITTER_API_SECRET_DESC="Consumer Secret from the Twitter Developer Portal → Keys and Tokens."
COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_DESC="User access token from the Developer Portal → Keys and Tokens → Authentication Tokens."
COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_SECRET="Access Token Secret"
COM_MOKOJOOMCROSS_CRED_TWITTER_ACCESS_TOKEN_SECRET_DESC="User access token secret from the Developer Portal → Keys and Tokens → Authentication Tokens."
; LinkedIn
COM_MOKOJOOMCROSS_CRED_LINKEDIN_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_LINKEDIN_ORG_ID="Organization ID"
COM_MOKOJOOMCROSS_CRED_LINKEDIN_ORG_ID_DESC="LinkedIn Company Page ID. Leave empty to post as yourself."
; Mastodon
COM_MOKOJOOMCROSS_CRED_MASTODON_INSTANCE="Instance URL"
COM_MOKOJOOMCROSS_CRED_MASTODON_INSTANCE_DESC="Your Mastodon server (e.g. https://mastodon.social)"
COM_MOKOJOOMCROSS_CRED_MASTODON_TOKEN="Access Token"
; Bluesky
COM_MOKOJOOMCROSS_CRED_BLUESKY_HANDLE="Handle"
COM_MOKOJOOMCROSS_CRED_BLUESKY_HANDLE_DESC="Your Bluesky handle (e.g. user.bsky.social)"
COM_MOKOJOOMCROSS_CRED_BLUESKY_APP_PWD="App Password"
COM_MOKOJOOMCROSS_CRED_BLUESKY_APP_PWD_DESC="Generate in Bluesky Settings → Advanced → App Passwords."
; WhatsApp
COM_MOKOJOOMCROSS_CRED_WHATSAPP_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_WHATSAPP_PHONE_ID="Phone Number ID"
COM_MOKOJOOMCROSS_CRED_WHATSAPP_RECIPIENT="Recipient Number"
COM_MOKOJOOMCROSS_CRED_WHATSAPP_RECIPIENT_DESC="Phone number to send to, with country code (e.g. +1234567890)"
; Mailchimp
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_KEY="API Key"
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_KEY_DESC="Mailchimp API key (ends with -us1, -us2, etc.)"
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_LIST="Audience/List ID"
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_LIST_DESC="The audience to send campaigns to. Find in Audience → Settings → Audience ID."
; SendGrid
COM_MOKOJOOMCROSS_CRED_SENDGRID_KEY="API Key"
COM_MOKOJOOMCROSS_CRED_SENDGRID_LIST="Contact List ID"
; Webhook
COM_MOKOJOOMCROSS_CRED_WEBHOOK_URL="Webhook URL"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_URL_DESC="The URL to send article data to. Works with Zapier, IFTTT, n8n, Make, or any custom endpoint."
COM_MOKOJOOMCROSS_CRED_WEBHOOK_METHOD="HTTP Method"
; Matrix
COM_MOKOJOOMCROSS_CRED_MATRIX_HOMESERVER="Homeserver URL"
COM_MOKOJOOMCROSS_CRED_MATRIX_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_MATRIX_ROOM="Room ID"
COM_MOKOJOOMCROSS_CRED_MATRIX_ROOM_DESC="Matrix room ID (e.g. !abc123:matrix.org)"
; Ntfy
COM_MOKOJOOMCROSS_CRED_NTFY_SERVER="Server URL"
COM_MOKOJOOMCROSS_CRED_NTFY_TOPIC="Topic Name"
COM_MOKOJOOMCROSS_CRED_NTFY_TOPIC_DESC="The notification topic (e.g. my-site-updates). Subscribers use this to receive push notifications."
COM_MOKOJOOMCROSS_CRED_NTFY_TOKEN="Auth Token"
COM_MOKOJOOMCROSS_CRED_NTFY_TOKEN_DESC="Optional authentication token if your ntfy server requires it."
; WordPress
COM_MOKOJOOMCROSS_CRED_WP_SITE="WordPress Site URL"
COM_MOKOJOOMCROSS_CRED_WP_USER="Username"
COM_MOKOJOOMCROSS_CRED_WP_APP_PWD="Application Password"
COM_MOKOJOOMCROSS_CRED_WP_APP_PWD_DESC="Generate in WordPress → Users → Profile → Application Passwords."
; Medium
COM_MOKOJOOMCROSS_CRED_MEDIUM_TOKEN="Integration Token"
; Dev.to
COM_MOKOJOOMCROSS_CRED_DEVTO_KEY="API Key"
; Ghost
COM_MOKOJOOMCROSS_CRED_GHOST_SITE="Ghost Site URL"
COM_MOKOJOOMCROSS_CRED_GHOST_KEY="Admin API Key"
; Reddit
COM_MOKOJOOMCROSS_CRED_REDDIT_CLIENT_ID="App Client ID"
COM_MOKOJOOMCROSS_CRED_REDDIT_SECRET="App Secret"
COM_MOKOJOOMCROSS_CRED_REDDIT_USER="Reddit Username"
COM_MOKOJOOMCROSS_CRED_REDDIT_SUBREDDIT="Subreddit"
COM_MOKOJOOMCROSS_CRED_REDDIT_SUBREDDIT_DESC="Subreddit to post to (without r/ prefix)"
; Authorize / OAuth
COM_MOKOJOOMCROSS_AUTHORIZE_BUTTON="Connect to %s"
COM_MOKOJOOMCROSS_AUTHORIZE_HELP="Click to open the authorization page. You'll be redirected back after granting access. Your token will be saved automatically."
COM_MOKOJOOMCROSS_OAUTH_HELP_TITLE="Authorization Required"
COM_MOKOJOOMCROSS_OAUTH_HELP_BODY="This service requires OAuth authorization. Save the service first, then click the Connect button below to authorize access."
; LinkedIn (additional)
COM_MOKOJOOMCROSS_CRED_LINKEDIN_REFRESH_TOKEN="Refresh Token"
COM_MOKOJOOMCROSS_CRED_LINKEDIN_REFRESH_TOKEN_DESC="OAuth refresh token for automatic access token renewal."
; Bluesky (additional)
COM_MOKOJOOMCROSS_CRED_BLUESKY_PDS_URL="PDS URL"
COM_MOKOJOOMCROSS_CRED_BLUESKY_PDS_URL_DESC="Personal Data Server URL. Default is https://bsky.social. Only change for self-hosted PDS."
; Discord (additional)
COM_MOKOJOOMCROSS_CRED_DISCORD_USERNAME="Display Name Override"
COM_MOKOJOOMCROSS_CRED_DISCORD_USERNAME_DESC="Override the webhook's default display name. Leave empty to use the webhook name."
COM_MOKOJOOMCROSS_CRED_DISCORD_AVATAR="Avatar URL Override"
COM_MOKOJOOMCROSS_CRED_DISCORD_AVATAR_DESC="Override the webhook's default avatar with a custom image URL."
; Mailchimp (additional)
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_NAME="From Name"
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_NAME_DESC="Sender name for campaigns. Leave empty to use the audience default."
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_EMAIL="From Email"
COM_MOKOJOOMCROSS_CRED_MAILCHIMP_FROM_EMAIL_DESC="Sender email for campaigns. Must be a verified sending domain."
; SendGrid (additional)
COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_EMAIL="From Email"
COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_EMAIL_DESC="Verified sender email address for Single Sends."
COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_NAME="From Name"
COM_MOKOJOOMCROSS_CRED_SENDGRID_FROM_NAME_DESC="Display name for the sender."
; Reddit (additional)
COM_MOKOJOOMCROSS_CRED_REDDIT_PASSWORD="Account Password"
COM_MOKOJOOMCROSS_CRED_REDDIT_PASSWORD_DESC="Required for Reddit script-type OAuth. The password for the Reddit account."
; WordPress (additional)
COM_MOKOJOOMCROSS_CRED_WP_DEFAULT_STATUS="Default Post Status"
COM_MOKOJOOMCROSS_CRED_WP_DEFAULT_STATUS_DESC="Whether cross-posted articles appear as drafts or are published immediately."
; Dev.to (additional)
COM_MOKOJOOMCROSS_CRED_DEVTO_ORG_ID="Organization ID"
COM_MOKOJOOMCROSS_CRED_DEVTO_ORG_ID_DESC="Optional. Publish under a Dev.to organization instead of your personal account."
; Ghost (additional)
COM_MOKOJOOMCROSS_CRED_GHOST_DEFAULT_STATUS="Default Post Status"
COM_MOKOJOOMCROSS_CRED_GHOST_DEFAULT_STATUS_DESC="Whether cross-posted articles are saved as drafts or published immediately."
; Status options (shared)
COM_MOKOJOOMCROSS_STATUS_DRAFT="Draft"
COM_MOKOJOOMCROSS_STATUS_PUBLISH="Publish"
COM_MOKOJOOMCROSS_STATUS_PUBLISHED="Published"
; Pinterest
COM_MOKOJOOMCROSS_CRED_PINTEREST_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_PINTEREST_TOKEN_DESC="Pinterest API v5 access token from the Developer Portal."
COM_MOKOJOOMCROSS_CRED_PINTEREST_BOARD="Board ID"
COM_MOKOJOOMCROSS_CRED_PINTEREST_BOARD_DESC="The board to pin to. Find the ID in the board URL or via the API."
; Tumblr
COM_MOKOJOOMCROSS_CRED_TUMBLR_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_TUMBLR_TOKEN_DESC="Tumblr OAuth access token."
COM_MOKOJOOMCROSS_CRED_TUMBLR_BLOG="Blog Name"
COM_MOKOJOOMCROSS_CRED_TUMBLR_BLOG_DESC="Your Tumblr blog name (e.g. myblog — without .tumblr.com)."
; TikTok
COM_MOKOJOOMCROSS_CRED_TIKTOK_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_TIKTOK_REFRESH_TOKEN="Refresh Token"
COM_MOKOJOOMCROSS_CRED_TIKTOK_OPEN_ID="Open ID"
COM_MOKOJOOMCROSS_CRED_TIKTOK_OPEN_ID_DESC="Your TikTok Open ID from the developer app authorization."
; Nostr
COM_MOKOJOOMCROSS_CRED_NOSTR_PRIVKEY="Private Key"
COM_MOKOJOOMCROSS_CRED_NOSTR_PRIVKEY_DESC="Nostr private key in hex or nsec format. Used to sign events."
COM_MOKOJOOMCROSS_CRED_NOSTR_RELAYS="Relay URLs"
COM_MOKOJOOMCROSS_CRED_NOSTR_RELAYS_DESC="Comma-separated list of relay WebSocket URLs (e.g. wss://relay.damus.io, wss://nos.lol)."
; ActivityPub
COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_INSTANCE="Instance URL"
COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_INSTANCE_DESC="Fediverse instance URL (Pleroma, Akkoma, Misskey, Pixelfed, etc.)."
COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_ACTIVITYPUB_TOKEN_DESC="API access token from the instance's developer settings."
; Brevo (Sendinblue)
COM_MOKOJOOMCROSS_CRED_BREVO_KEY="API Key"
COM_MOKOJOOMCROSS_CRED_BREVO_LIST="Contact List ID"
COM_MOKOJOOMCROSS_CRED_BREVO_LIST_DESC="Brevo contact list ID to send campaigns to."
COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_EMAIL="Sender Email"
COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_EMAIL_DESC="Must be a verified sender in your Brevo account."
COM_MOKOJOOMCROSS_CRED_BREVO_SENDER_NAME="Sender Name"
; ConvertKit
COM_MOKOJOOMCROSS_CRED_CONVERTKIT_KEY="API Key"
COM_MOKOJOOMCROSS_CRED_CONVERTKIT_SECRET="API Secret"
; Constant Contact
COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_REFRESH_TOKEN="Refresh Token"
COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_LISTS="Contact List IDs"
COM_MOKOJOOMCROSS_CRED_CONSTANTCONTACT_LISTS_DESC="Comma-separated list IDs to include in the campaign."
; Hashnode
COM_MOKOJOOMCROSS_CRED_HASHNODE_TOKEN="Personal Access Token"
COM_MOKOJOOMCROSS_CRED_HASHNODE_PUB_ID="Publication ID"
COM_MOKOJOOMCROSS_CRED_HASHNODE_PUB_ID_DESC="Your Hashnode publication ID. Find in Dashboard → General settings."
; Google Blogger
COM_MOKOJOOMCROSS_CRED_BLOGGER_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_BLOGGER_REFRESH_TOKEN="Refresh Token"
COM_MOKOJOOMCROSS_CRED_BLOGGER_BLOG_ID="Blog ID"
COM_MOKOJOOMCROSS_CRED_BLOGGER_BLOG_ID_DESC="Numeric Blog ID from Blogger settings or the Blogger API."
; Google Business Profile
COM_MOKOJOOMCROSS_CRED_GBUSINESS_TOKEN="Access Token"
COM_MOKOJOOMCROSS_CRED_GBUSINESS_REFRESH_TOKEN="Refresh Token"
COM_MOKOJOOMCROSS_CRED_GBUSINESS_LOCATION="Location ID"
COM_MOKOJOOMCROSS_CRED_GBUSINESS_LOCATION_DESC="Google Business location ID (e.g. locations/1234567890)."
COM_MOKOJOOMCROSS_CRED_GBUSINESS_ACCOUNT="Account ID"
COM_MOKOJOOMCROSS_CRED_GBUSINESS_ACCOUNT_DESC="Google Business account ID (e.g. accounts/1234567890)."
; RSS Feed
COM_MOKOJOOMCROSS_CRED_RSSFEED_TITLE="Feed Title"
COM_MOKOJOOMCROSS_CRED_RSSFEED_TITLE_DESC="Title for the generated RSS feed. Defaults to the site name."
COM_MOKOJOOMCROSS_CRED_RSSFEED_MAX_ITEMS="Max Feed Items"
COM_MOKOJOOMCROSS_CRED_RSSFEED_MAX_ITEMS_DESC="Maximum number of items to include in the feed."
; Webhook (additional)
COM_MOKOJOOMCROSS_CRED_WEBHOOK_AUTH_TYPE="Authentication"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_AUTH_TYPE_DESC="Authentication method for the webhook endpoint."
COM_MOKOJOOMCROSS_WEBHOOK_AUTH_NONE="None"
COM_MOKOJOOMCROSS_WEBHOOK_AUTH_BEARER="Bearer Token"
COM_MOKOJOOMCROSS_WEBHOOK_AUTH_BASIC="Basic Auth"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_BEARER_TOKEN="Bearer Token"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_BEARER_TOKEN_DESC="Authentication token sent as Authorization: Bearer {token}."
COM_MOKOJOOMCROSS_CRED_WEBHOOK_BASIC_USER="Username"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_BASIC_PWD="Password"
COM_MOKOJOOMCROSS_CRED_WEBHOOK_CONTENT_TYPE="Content Type"
; Service help link
COM_MOKOJOOMCROSS_SERVICE_HELP_LINK="%s Setup Guide"
; Setup help panel
COM_MOKOJOOMCROSS_SETUP_HELP_TITLE="How to set up"
COM_MOKOJOOMCROSS_SETUP_HELP_INTRO="Setting up a new service is easy:"
COM_MOKOJOOMCROSS_SETUP_STEP1="Choose a service type from the dropdown"
COM_MOKOJOOMCROSS_SETUP_STEP2="Fill in the connection details that appear"
COM_MOKOJOOMCROSS_SETUP_STEP3="For OAuth services, save first, then click Connect"
COM_MOKOJOOMCROSS_SETUP_STEP4="Set status to Published and save"
; Test Connection
COM_MOKOJOOMCROSS_TEST_CONNECTION_TITLE="Test Connection"
COM_MOKOJOOMCROSS_TEST_CONNECTION_DESC="Verify that your credentials are valid and the service is reachable."
COM_MOKOJOOMCROSS_TEST_CONNECTION_BUTTON="Test Connection"
COM_MOKOJOOMCROSS_TEST_CONNECTION_TESTING="Testing..."
COM_MOKOJOOMCROSS_TEST_CONNECTION_SUCCESS="Connection successful"
COM_MOKOJOOMCROSS_TEST_CONNECTION_FAILED="Connection failed"
COM_MOKOJOOMCROSS_TEST_CONNECTION_ERROR="Could not reach the server. Please try again."
COM_MOKOJOOMCROSS_TEST_CONNECTION_NO_SERVICE="No service specified for test."
COM_MOKOJOOMCROSS_TEST_CONNECTION_NOT_FOUND="Service record not found."
COM_MOKOJOOMCROSS_TEST_CONNECTION_NO_PLUGIN="No service plugin available for type '%s'."
; Bulk Queue Actions
COM_MOKOJOOMCROSS_TOOLBAR_RETRY_FAILED="Retry Failed"
COM_MOKOJOOMCROSS_TOOLBAR_PURGE_POSTED="Purge Posted"
COM_MOKOJOOMCROSS_POSTS_N_RETRIED="%d failed post(s) re-queued for retry."
COM_MOKOJOOMCROSS_POSTS_N_RETRIED_1="1 failed post re-queued for retry."
COM_MOKOJOOMCROSS_POSTS_N_PURGED="%d posted record(s) purged."
COM_MOKOJOOMCROSS_POSTS_N_PURGED_1="1 posted record purged."
COM_MOKOJOOMCROSS_POSTS_N_SCHEDULED="%d post(s) scheduled."
COM_MOKOJOOMCROSS_POSTS_NO_ITEM_SELECTED="No posts selected."
COM_MOKOJOOMCROSS_SCHEDULE_NO_DATE="Please select a date and time for scheduling."
COM_MOKOJOOMCROSS_TOOLBAR_SCHEDULE="Schedule"
COM_MOKOJOOMCROSS_TOOLBAR_RETRY_SELECTED="Retry Selected"
; Queue Depth Warning
COM_MOKOJOOMCROSS_DASHBOARD_QUEUE_DEPTH_WARNING_TITLE="Large queue backlog"
COM_MOKOJOOMCROSS_DASHBOARD_QUEUE_DEPTH_WARNING="There are %d posts waiting in the queue. Please verify that the Joomla Task Scheduler is running and the MokoJoomCross scheduled task is enabled in System → Scheduled Tasks."
; First-Publish-Only
COM_MOKOJOOMCROSS_CONFIG_FIRST_PUBLISH_ONLY="First Publish Only"
COM_MOKOJOOMCROSS_CONFIG_FIRST_PUBLISH_ONLY_DESC="When enabled, articles are only cross-posted on their first save as published. Subsequent edits to already-published articles will not trigger new cross-posts."
; Trend Chart
COM_MOKOJOOMCROSS_DASHBOARD_TREND_CHART="Daily Post Trend"
; Date Range Period Filter
COM_MOKOJOOMCROSS_PERIOD_7_DAYS="Last 7 days"
COM_MOKOJOOMCROSS_PERIOD_30_DAYS="Last 30 days"
COM_MOKOJOOMCROSS_PERIOD_90_DAYS="Last 90 days"
COM_MOKOJOOMCROSS_PERIOD_ALL_TIME="All time"
; Hashtag Placeholders
COM_MOKOJOOMCROSS_PLACEHOLDER_TAGS="Article tags (comma-separated)"
COM_MOKOJOOMCROSS_PLACEHOLDER_HASHTAGS="Article tags as hashtags (#Tag1 #Tag2)"
; CSV Export
COM_MOKOJOOMCROSS_EXPORT_CSV="Export CSV"
; API Dispatch
COM_MOKOJOOMCROSS_DISPATCH_MISSING_ARTICLE="Missing or invalid article_id in request body."
COM_MOKOJOOMCROSS_DISPATCH_INVALID_SERVICES="service_ids must be a non-empty array of service IDs."
COM_MOKOJOOMCROSS_DISPATCH_ARTICLE_NOT_FOUND="Article not found."
COM_MOKOJOOMCROSS_DISPATCH_NO_SERVICES="No enabled services found matching the request."
@@ -7,5 +7,4 @@ COM_MOKOJOOMCROSS_DESCRIPTION="Cross-posting Joomla content to social media, ema
COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD="Dashboard"
COM_MOKOJOOMCROSS_SUBMENU_POSTS="Post Queue"
COM_MOKOJOOMCROSS_SUBMENU_SERVICES="Services"
COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES="Templates"
COM_MOKOJOOMCROSS_SUBMENU_LOGS="Activity Logs"
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="component" method="upgrade">
<name>com_mokojoomcross</name>
<version>01.00.06-dev</version>
<version>01.00.00-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -48,7 +48,6 @@
<menu link="option=com_mokojoomcross&amp;view=dashboard">COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD</menu>
<menu link="option=com_mokojoomcross&amp;view=posts">COM_MOKOJOOMCROSS_SUBMENU_POSTS</menu>
<menu link="option=com_mokojoomcross&amp;view=services">COM_MOKOJOOMCROSS_SUBMENU_SERVICES</menu>
<menu link="option=com_mokojoomcross&amp;view=templates">COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES</menu>
<menu link="option=com_mokojoomcross&amp;view=logs">COM_MOKOJOOMCROSS_SUBMENU_LOGS</menu>
</submenu>
<files>
@@ -32,7 +32,7 @@ CREATE TABLE IF NOT EXISTS `#__mokojoomcross_posts` (
`scheduled_at` datetime DEFAULT NULL COMMENT 'When to post (NULL = immediately)',
`posted_at` datetime DEFAULT NULL COMMENT 'When actually posted',
`retry_count` int(10) unsigned NOT NULL DEFAULT 0,
`error_message` text NOT NULL,
`error_message` text NOT NULL DEFAULT '',
`created` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
`modified` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
PRIMARY KEY (`id`),
@@ -76,20 +76,4 @@ INSERT INTO `#__mokojoomcross_templates` (`service_type`, `title`, `template_bod
('default', 'Default Template', '{title}\n\n{introtext}\n\n{url}', 1, 1, NOW()),
('twitter', 'Twitter/X Default', '{title}\n\n{url}', 1, 2, NOW()),
('mastodon', 'Mastodon Default', '{title}\n\n{introtext}\n\n{url}\n\n#Joomla', 1, 3, NOW()),
('mailchimp', 'Mailchimp Default', '<h1>{title}</h1>\n<p>{introtext}</p>\n<p><a href=\"{url}\">Read more</a></p>', 1, 4, NOW()),
('telegram', 'Telegram Default', '<b>{title}</b>\n\n{introtext}\n\n<a href=\"{url}\">Read more</a>', 1, 5, NOW()),
('discord', 'Discord Default', '**{title}**\n\n{introtext}\n\n{url}', 1, 6, NOW()),
('slack', 'Slack Default', '*{title}*\n\n{introtext}\n\n{url}', 1, 7, NOW()),
('facebook', 'Facebook Default', '{title}\n\n{introtext}\n\n{url}', 1, 8, NOW()),
('linkedin', 'LinkedIn Default', '{title}\n\n{introtext}\n\n{url}', 1, 9, NOW()),
('bluesky', 'Bluesky Default', '{title}\n\n{url}', 1, 10, NOW()),
('threads', 'Threads Default', '{title}\n\n{introtext}\n\n{url}', 1, 11, NOW()),
('teams', 'Teams Default', '**{title}**\n\n{introtext}\n\n[Read more]({url})', 1, 12, NOW()),
('medium', 'Medium Default', '{title}\n\n{introtext}\n\n{url}', 1, 13, NOW()),
('wordpress', 'WordPress Default', '{title}\n\n{introtext}\n\n{url}', 1, 14, NOW()),
('webhook', 'Webhook Default', '{title}\n\n{introtext}\n\n{url}', 1, 15, NOW()),
('sendgrid', 'SendGrid Default', '<h1>{title}</h1>\n<p>{introtext}</p>\n<p><a href=\"{url}\">Read more</a></p>', 1, 16, NOW()),
('brevo', 'Brevo Default', '<h1>{title}</h1>\n<p>{introtext}</p>\n<p><a href=\"{url}\">Read more</a></p>', 1, 17, NOW()),
('ntfy', 'Ntfy Default', '{title}: {introtext}', 1, 18, NOW()),
('reddit', 'Reddit Default', '{title}', 1, 19, NOW()),
('pinterest', 'Pinterest Default', '{title} - {introtext}', 1, 20, NOW());
('mailchimp', 'Mailchimp Default', '<h1>{title}</h1>\n<p>{introtext}</p>\n<p><a href=\"{url}\">Read more</a></p>', 1, 4, NOW());
@@ -1,59 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Router\Route;
use Joomla\Component\MokoJoomCross\Administrator\Helper\MigrationHelper;
class DashboardController extends BaseController
{
/**
* Run Perfect Publisher Pro migration.
*
* @return void
*/
public function migrate(): void
{
// Check ACL
if (!$this->app->getIdentity()->authorise('mokojoomcross.migrate', 'com_mokojoomcross')) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false),
Text::_('JLIB_APPLICATION_ERROR_ACCESS_FORBIDDEN'),
'error'
);
return;
}
$result = MigrationHelper::migrate();
if (!empty($result['errors'])) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false),
Text::sprintf('COM_MOKOJOOMCROSS_MIGRATION_ERROR', implode('; ', $result['errors'])),
'error'
);
return;
}
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false),
Text::sprintf('COM_MOKOJOOMCROSS_MIGRATION_SUCCESS', $result['migrated'], $result['skipped']),
'success'
);
}
}
@@ -1,332 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
/**
* REST API controller for dispatching cross-posts.
*
* Endpoint: POST /api/index.php/v1/mokojoomcross/dispatch
*
* JSON body:
* {
* "article_id": 123,
* "service_ids": [1, 2, 3] // optional — omit to post to all enabled services
* }
*
* Returns JSON with the created post IDs and status.
*/
class DispatchController extends BaseController
{
/**
* Dispatch cross-posts for an article to one or more services.
*
* @return void
*/
public function dispatch(): void
{
$app = $this->app;
// Read JSON body
$input = json_decode(file_get_contents('php://input'), true) ?: [];
$articleId = (int) ($input['article_id'] ?? 0);
$serviceIds = $input['service_ids'] ?? null;
if ($articleId < 1) {
$this->sendJsonResponse(['error' => Text::_('COM_MOKOJOOMCROSS_DISPATCH_MISSING_ARTICLE')], 400);
return;
}
// Validate service_ids if provided
if ($serviceIds !== null) {
if (!is_array($serviceIds) || empty($serviceIds)) {
$this->sendJsonResponse(['error' => Text::_('COM_MOKOJOOMCROSS_DISPATCH_INVALID_SERVICES')], 400);
return;
}
$serviceIds = array_map('intval', $serviceIds);
}
$db = Factory::getDbo();
// Load the article
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__content'))
->where($db->quoteName('id') . ' = ' . $articleId);
$db->setQuery($query);
$article = $db->loadObject();
if (!$article) {
$this->sendJsonResponse(['error' => Text::_('COM_MOKOJOOMCROSS_DISPATCH_ARTICLE_NOT_FOUND')], 404);
return;
}
// Load enabled services, optionally filtered by service_ids
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('published') . ' = 1')
->order($db->quoteName('ordering') . ' ASC');
if ($serviceIds !== null) {
$query->where($db->quoteName('id') . ' IN (' . implode(',', $serviceIds) . ')');
}
$db->setQuery($query);
$services = $db->loadObjectList() ?: [];
if (empty($services)) {
$this->sendJsonResponse(['error' => Text::_('COM_MOKOJOOMCROSS_DISPATCH_NO_SERVICES')], 404);
return;
}
// Import service plugins and build type-to-plugin map
PluginHelper::importPlugin('mokojoomcross');
$servicePlugins = [];
try {
$app->getDispatcher()->dispatch(
'onMokoJoomCrossGetServices',
new \Joomla\Event\Event('onMokoJoomCrossGetServices', [&$servicePlugins])
);
} catch (\Throwable $e) {
// Dispatcher may not be available
}
$pluginMap = [];
foreach ($servicePlugins as $plugin) {
if ($plugin instanceof MokoJoomCrossServiceInterface) {
$pluginMap[$plugin->getServiceType()] = $plugin;
}
}
// Render template and create queue entries (same logic as system plugin dispatchCrossPost)
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
$now = Factory::getDate()->toSql();
$createdIds = [];
$skipped = [];
// Build article URL
$articleUrl = Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id;
if (!empty($article->catid)) {
$articleUrl .= '&catid=' . $article->catid;
}
// Extract intro image for media
$media = [];
$images = json_decode($article->images ?? '{}');
if (!empty($images->image_intro)) {
$media[] = Uri::root() . ltrim($images->image_intro, '/');
}
foreach ($services as $service) {
// Duplicate guard — skip if article already posted/queued for this service
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('article_id') . ' = ' . (int) $article->id)
->where($db->quoteName('service_id') . ' = ' . (int) $service->id)
->where($db->quoteName('status') . ' IN (' . $db->quote('queued') . ',' . $db->quote('posted') . ',' . $db->quote('posting') . ')');
$db->setQuery($query);
if ((int) $db->loadResult() > 0) {
$skipped[] = [
'service_id' => (int) $service->id,
'service_type' => $service->service_type,
'reason' => 'duplicate',
];
continue;
}
// Render template
$message = $this->renderTemplate($db, $article, $service, $componentParams);
// Create queue entry
$post = (object) [
'article_id' => (int) $article->id,
'service_id' => (int) $service->id,
'status' => 'queued',
'message' => $message,
'platform_post_id' => '',
'platform_response' => '',
'error_message' => '',
'retry_count' => 0,
'created' => $now,
'modified' => $now,
];
$db->insertObject('#__mokojoomcross_posts', $post);
$postId = (int) $db->insertid();
$createdIds[] = [
'post_id' => $postId,
'service_id' => (int) $service->id,
'service_type' => $service->service_type,
'status' => 'queued',
];
// Write log entry
$log = (object) [
'post_id' => $postId,
'service_id' => (int) $service->id,
'level' => 'info',
'message' => sprintf('API dispatch: queued article %d to %s', $article->id, $service->service_type),
'context' => '{}',
'created' => $now,
];
$db->insertObject('#__mokojoomcross_logs', $log);
}
$this->sendJsonResponse([
'article_id' => (int) $article->id,
'dispatched' => $createdIds,
'skipped' => $skipped,
], 200);
}
/**
* Render the message template for a service (simplified version of system plugin logic).
*/
private function renderTemplate($db, object $article, object $service, $componentParams): string
{
// Try service-specific template first, fall back to default
$query = $db->getQuery(true)
->select($db->quoteName('template_body'))
->from($db->quoteName('#__mokojoomcross_templates'))
->where($db->quoteName('published') . ' = 1')
->where('(' . $db->quoteName('service_type') . ' = ' . $db->quote($service->service_type)
. ' OR ' . $db->quoteName('service_type') . ' = ' . $db->quote('default') . ')')
->order('CASE WHEN ' . $db->quoteName('service_type') . ' = '
. $db->quote($service->service_type) . ' THEN 0 ELSE 1 END')
->setLimit(1);
$db->setQuery($query);
$template = $db->loadResult() ?: ($componentParams->get('default_template', "{title}\n\n{url}"));
// Build article URL
$url = Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id;
if (!empty($article->catid)) {
$url .= '&catid=' . $article->catid;
}
// Resolve category name
$categoryName = '';
if (!empty($article->catid)) {
$query = $db->getQuery(true)
->select($db->quoteName('title'))
->from($db->quoteName('#__categories'))
->where($db->quoteName('id') . ' = ' . (int) $article->catid);
$db->setQuery($query);
$categoryName = $db->loadResult() ?: '';
}
// Resolve author name
$authorName = '';
if (!empty($article->created_by)) {
$query = $db->getQuery(true)
->select($db->quoteName('name'))
->from($db->quoteName('#__users'))
->where($db->quoteName('id') . ' = ' . (int) $article->created_by);
$db->setQuery($query);
$authorName = $db->loadResult() ?: '';
}
// Extract intro image
$introImage = '';
$images = json_decode($article->images ?? '{}');
if (!empty($images->image_intro)) {
$introImage = Uri::root() . ltrim($images->image_intro, '/');
}
// Resolve article tags
$tagNames = [];
if (!empty($article->id)) {
$query = $db->getQuery(true)
->select($db->quoteName('t.title'))
->from($db->quoteName('#__tags', 't'))
->join('INNER', $db->quoteName('#__contentitem_tag_map', 'm')
. ' ON ' . $db->quoteName('m.tag_id') . ' = ' . $db->quoteName('t.id'))
->where($db->quoteName('m.type_alias') . ' = ' . $db->quote('com_content.article'))
->where($db->quoteName('m.content_item_id') . ' = ' . (int) $article->id)
->where($db->quoteName('t.published') . ' = 1');
$db->setQuery($query);
$tagNames = $db->loadColumn() ?: [];
}
$tagsComma = implode(', ', $tagNames);
$hashtags = implode(' ', array_map(function ($tag) {
return '#' . preg_replace('/\s+/', '', $tag);
}, $tagNames));
$replacements = [
'{title}' => $article->title ?? '',
'{introtext}' => strip_tags(mb_substr($article->introtext ?? '', 0, 280)),
'{fulltext}' => strip_tags(mb_substr($article->fulltext ?? '', 0, 500)),
'{url}' => $url,
'{image}' => $introImage,
'{category}' => $categoryName,
'{author}' => $authorName,
'{date}' => Factory::getDate($article->publish_up ?? 'now')->format('Y-m-d'),
'{tags}' => $tagsComma,
'{hashtags}' => $hashtags,
];
return str_replace(array_keys($replacements), array_values($replacements), $template);
}
/**
* Send a JSON response and close the application.
*
* @param array $data Response data
* @param int $httpCode HTTP status code
*
* @return void
*/
private function sendJsonResponse(array $data, int $httpCode): void
{
$app = $this->app;
$app->setHeader('Content-Type', 'application/json; charset=utf-8');
$app->setHeader('Status', (string) $httpCode);
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$app->close();
}
}
@@ -1,175 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Router\Route;
use Joomla\Component\MokoJoomCross\Administrator\Helper\OAuthHelper;
/**
* OAuth controller for handling browser-based authorization flows.
*
* Endpoints:
* task=oauth.authorize — Initiate OAuth flow (redirect to platform)
* task=oauth.callback — Handle platform redirect with auth code
*/
class OauthController extends BaseController
{
/**
* Initiate OAuth authorization for a service.
*
* Expects: service_id (int) in request
*/
public function authorize(): void
{
$serviceId = $this->input->getInt('service_id', 0);
if (!$serviceId) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::_('COM_MOKOJOOMCROSS_OAUTH_NO_SERVICE'),
'error'
);
return;
}
$db = \Joomla\CMS\Factory::getDbo();
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('id') . ' = ' . $serviceId);
$db->setQuery($query);
$service = $db->loadObject();
if (!$service) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::_('COM_MOKOJOOMCROSS_OAUTH_SERVICE_NOT_FOUND'),
'error'
);
return;
}
// Get client ID from plugin params
PluginHelper::importPlugin('mokojoomcross');
$pluginParams = PluginHelper::getPlugin('mokojoomcross', $service->service_type);
$params = json_decode($pluginParams->params ?? '{}', true) ?: [];
$clientId = $params['client_id'] ?? '';
if (empty($clientId)) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::sprintf('COM_MOKOJOOMCROSS_OAUTH_NO_CLIENT_ID', ucfirst($service->service_type)),
'error'
);
return;
}
$url = OAuthHelper::getAuthorizeUrl($service->service_type, $serviceId, $clientId);
if (!$url) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::sprintf('COM_MOKOJOOMCROSS_OAUTH_NOT_SUPPORTED', ucfirst($service->service_type)),
'error'
);
return;
}
$this->app->redirect($url);
}
/**
* Handle OAuth callback from platform.
*
* Expects: code (string), state (base64 JSON with service_id)
*/
public function callback(): void
{
$code = $this->input->getString('code', '');
$state = $this->input->getString('state', '');
$error = $this->input->getString('error', '');
if ($error) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::sprintf('COM_MOKOJOOMCROSS_OAUTH_PLATFORM_ERROR', $error),
'error'
);
return;
}
if (empty($code) || empty($state)) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::_('COM_MOKOJOOMCROSS_OAUTH_INVALID_CALLBACK'),
'error'
);
return;
}
$stateData = json_decode(base64_decode($state), true);
$serviceId = (int) ($stateData['service_id'] ?? 0);
$serviceType = $stateData['type'] ?? '';
if (!$serviceId || !$serviceType) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=services', false),
Text::_('COM_MOKOJOOMCROSS_OAUTH_INVALID_STATE'),
'error'
);
return;
}
// Get client credentials from plugin params
PluginHelper::importPlugin('mokojoomcross');
$pluginParams = PluginHelper::getPlugin('mokojoomcross', $serviceType);
$params = json_decode($pluginParams->params ?? '{}', true) ?: [];
$clientId = $params['client_id'] ?? '';
$clientSecret = $params['client_secret'] ?? '';
$tokenData = OAuthHelper::exchangeCode($serviceType, $code, $clientId, $clientSecret);
if (!empty($tokenData['error'])) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&task=service.edit&id=' . $serviceId, false),
Text::sprintf('COM_MOKOJOOMCROSS_OAUTH_TOKEN_ERROR', $tokenData['error']),
'error'
);
return;
}
OAuthHelper::storeToken($serviceId, $tokenData);
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&task=service.edit&id=' . $serviceId, false),
Text::sprintf('COM_MOKOJOOMCROSS_OAUTH_SUCCESS', ucfirst($serviceType)),
'success'
);
}
}
@@ -13,10 +13,7 @@ namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\Controller\AdminController;
use Joomla\CMS\Router\Route;
class PostsController extends AdminController
{
@@ -24,214 +21,4 @@ class PostsController extends AdminController
{
return parent::getModel($name, $prefix, $config);
}
/**
* Schedule selected posts for a future date/time.
*
* @return void
*/
public function schedule(): void
{
$this->checkToken();
$ids = $this->input->get('cid', [], 'array');
$scheduledAt = $this->input->getString('scheduled_at', '');
if (empty($ids)) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::_('COM_MOKOJOOMCROSS_POSTS_NO_ITEM_SELECTED'),
'warning'
);
return;
}
if (empty($scheduledAt)) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::_('COM_MOKOJOOMCROSS_SCHEDULE_NO_DATE'),
'warning'
);
return;
}
$db = Factory::getDbo();
$now = Factory::getDate()->toSql();
foreach ($ids as $id) {
$query = $db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('scheduled_at') . ' = ' . $db->quote($scheduledAt))
->set($db->quoteName('status') . ' = ' . $db->quote('queued'))
->set($db->quoteName('modified') . ' = ' . $db->quote($now))
->where($db->quoteName('id') . ' = ' . (int) $id);
$db->setQuery($query);
$db->execute();
}
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::sprintf('COM_MOKOJOOMCROSS_POSTS_N_SCHEDULED', count($ids)),
'success'
);
}
/**
* Retry selected failed/permanently_failed posts.
*
* @return void
*/
public function retrySelected(): void
{
$this->checkToken();
$ids = $this->input->get('cid', [], 'array');
if (empty($ids)) {
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::_('COM_MOKOJOOMCROSS_POSTS_NO_ITEM_SELECTED'),
'warning'
);
return;
}
$count = \Joomla\Component\MokoJoomCross\Administrator\Helper\QueueProcessor::retryPosts($ids);
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::sprintf('COM_MOKOJOOMCROSS_POSTS_N_RETRIED', $count),
'success'
);
}
/**
* Re-queue all failed posts by resetting their status to queued and retry count to 0.
*
* @return void
*/
public function retryFailed(): void
{
$this->checkToken();
$db = Factory::getDbo();
$query = $db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('queued'))
->set($db->quoteName('retry_count') . ' = 0')
->set($db->quoteName('error_message') . ' = ' . $db->quote(''))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('status') . ' = ' . $db->quote('failed'));
$db->setQuery($query);
$db->execute();
$count = $db->getAffectedRows();
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::plural('COM_MOKOJOOMCROSS_POSTS_N_RETRIED', $count),
'success'
);
}
/**
* Export posts as CSV download.
*
* @return void
*/
public function exportCsv(): void
{
$app = $this->app;
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select([
$db->quoteName('c.title', 'article_title'),
'CONCAT(' . $db->quoteName('s.title') . ', ' . $db->quote(' (') . ', '
. $db->quoteName('s.service_type') . ', ' . $db->quote(')') . ') AS service',
$db->quoteName('a.status'),
$db->quoteName('a.message'),
$db->quoteName('a.posted_at'),
$db->quoteName('a.error_message'),
$db->quoteName('a.platform_post_id'),
$db->quoteName('a.created'),
])
->from($db->quoteName('#__mokojoomcross_posts', 'a'))
->join('LEFT', $db->quoteName('#__content', 'c')
. ' ON ' . $db->quoteName('c.id') . ' = ' . $db->quoteName('a.article_id'))
->join('LEFT', $db->quoteName('#__mokojoomcross_services', 's')
. ' ON ' . $db->quoteName('s.id') . ' = ' . $db->quoteName('a.service_id'))
->order($db->quoteName('a.created') . ' DESC');
// Apply current filters
$status = $app->input->get('filter_status', '', 'string');
if (!empty($status)) {
$query->where($db->quoteName('a.status') . ' = ' . $db->quote($status));
}
$serviceId = $app->input->getInt('filter_service_id', 0);
if (!empty($serviceId)) {
$query->where($db->quoteName('a.service_id') . ' = ' . (int) $serviceId);
}
$search = $app->input->get('filter_search', '', 'string');
if (!empty($search)) {
$search = '%' . $db->escape(trim($search), true) . '%';
$query->where('(' . $db->quoteName('c.title') . ' LIKE ' . $db->quote($search)
. ' OR ' . $db->quoteName('a.message') . ' LIKE ' . $db->quote($search) . ')');
}
$db->setQuery($query);
$rows = $db->loadAssocList() ?: [];
$filename = 'mokojoomcross-posts-' . Factory::getDate()->format('Y-m-d') . '.csv';
$app->setHeader('Content-Type', 'text/csv; charset=utf-8');
$app->setHeader('Content-Disposition', 'attachment; filename="' . $filename . '"');
$app->sendHeaders();
$fp = fopen('php://output', 'w');
fputcsv($fp, ['Article', 'Service', 'Status', 'Message', 'Posted At', 'Error', 'Platform Post ID', 'Created']);
foreach ($rows as $row) {
fputcsv($fp, $row);
}
fclose($fp);
$app->close();
}
/**
* Purge (delete) all posts with status 'posted'.
*
* @return void
*/
public function purgePosted(): void
{
$this->checkToken();
$db = Factory::getDbo();
$query = $db->getQuery(true)
->delete($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('status') . ' = ' . $db->quote('posted'));
$db->setQuery($query);
$db->execute();
$count = $db->getAffectedRows();
$this->setRedirect(
Route::_('index.php?option=com_mokojoomcross&view=posts', false),
Text::plural('COM_MOKOJOOMCROSS_POSTS_N_PURGED', $count),
'success'
);
}
}
@@ -13,81 +13,8 @@ namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\Controller\FormController;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Response\JsonResponse;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
class ServiceController extends FormController
{
/**
* Test connection to a service by validating its credentials.
*
* @return void
*/
public function testConnection(): void
{
$app = $this->app;
$id = (int) $this->input->getInt('id', 0);
try {
if ($id <= 0) {
throw new \RuntimeException(Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_NO_SERVICE'));
}
// Load the service record
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('id') . ' = ' . $id);
$db->setQuery($query);
$service = $db->loadObject();
if (!$service) {
throw new \RuntimeException(Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_NOT_FOUND'));
}
// Get service plugins via dispatcher
PluginHelper::importPlugin('mokojoomcross');
$servicePlugins = [];
$app->getDispatcher()->dispatch(
'onMokoJoomCrossGetServices',
new \Joomla\Event\Event('onMokoJoomCrossGetServices', [&$servicePlugins])
);
// Find the matching plugin
$plugin = null;
foreach ($servicePlugins as $sp) {
if ($sp instanceof MokoJoomCrossServiceInterface && $sp->getServiceType() === $service->service_type) {
$plugin = $sp;
break;
}
}
if (!$plugin) {
throw new \RuntimeException(Text::sprintf('COM_MOKOJOOMCROSS_TEST_CONNECTION_NO_PLUGIN', $service->service_type));
}
// Decode credentials and validate
$credentials = json_decode($service->credentials ?: '{}', true) ?: [];
$result = $plugin->validateCredentials($credentials);
$app->mimeType = 'application/json';
$app->setHeader('Content-Type', 'application/json; charset=utf-8');
echo new JsonResponse($result);
} catch (\Throwable $e) {
$app->mimeType = 'application/json';
$app->setHeader('Content-Type', 'application/json; charset=utf-8');
echo new JsonResponse($e);
}
$app->close();
}
}
@@ -1,20 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\Controller\FormController;
class TemplateController extends FormController
{
}
@@ -1,24 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\Controller\AdminController;
class TemplatesController extends AdminController
{
public function getModel($name = 'Template', $prefix = 'Administrator', $config = ['ignore_request' => true])
{
return parent::getModel($name, $prefix, $config);
}
}
@@ -1,416 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Helper;
defined('_JEXEC') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
/**
* Static dispatcher for cross-posting content from any source plugin.
*
* Centralises the dispatch logic that was previously only in the system plugin,
* so content-type source plugins (articles, calendar events, gallery items) can
* trigger cross-posts without coupling to plg_system_mokojoomcross.
*/
class CrossPostDispatcher
{
/**
* Dispatch an article-like payload to all enabled cross-post services.
*
* @param object $article Article or article-like object
* @param string $articleUrl Canonical URL for the content item
* @param string|null $contentType Content type context (e.g. 'com_content.article')
*/
public static function dispatch(object $article, string $articleUrl = '', ?string $contentType = null): void
{
$db = Factory::getDbo();
// Load all enabled services
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('published') . ' = 1')
->order($db->quoteName('ordering') . ' ASC');
$db->setQuery($query);
$services = $db->loadObjectList();
if (empty($services)) {
return;
}
// Import service plugins so they register with the dispatcher
PluginHelper::importPlugin('mokojoomcross');
// Collect registered service plugin instances
$servicePlugins = [];
Factory::getApplication()->getDispatcher()->dispatch(
'onMokoJoomCrossGetServices',
new \Joomla\Event\Event('onMokoJoomCrossGetServices', [&$servicePlugins])
);
// Index by service type for lookup
$pluginMap = [];
foreach ($servicePlugins as $plugin) {
if ($plugin instanceof MokoJoomCrossServiceInterface) {
$pluginMap[$plugin->getServiceType()] = $plugin;
}
}
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
// Per-article selective cross-posting (#19)
$attribs = json_decode($article->attribs ?? '{}', true) ?: [];
$selectedServiceIds = $attribs['mokojoomcross_services'] ?? null;
$skipCrossPost = !empty($attribs['mokojoomcross_skip']);
if ($skipCrossPost) {
return;
}
// If specific services selected, convert to array of ints for filtering
if (is_array($selectedServiceIds) && !empty($selectedServiceIds)) {
$selectedServiceIds = array_map('intval', $selectedServiceIds);
} else {
$selectedServiceIds = null; // null = post to all
}
// Determine service type filter from content type property
$serviceTypeFilter = $article->_content_type ?? null;
foreach ($services as $service) {
// Service type filter for non-article content types
if ($serviceTypeFilter !== null && $service->service_type !== $serviceTypeFilter) {
continue;
}
// Per-article filter
if ($selectedServiceIds !== null && !in_array((int) $service->id, $selectedServiceIds, true)) {
continue;
}
// Duplicate guard
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('article_id') . ' = ' . (int) $article->id)
->where($db->quoteName('service_id') . ' = ' . (int) $service->id)
->where($db->quoteName('status') . ' IN (' . $db->quote('queued') . ',' . $db->quote('posted') . ',' . $db->quote('posting') . ')');
$db->setQuery($query);
if ((int) $db->loadResult() > 0) {
continue;
}
$message = self::renderTemplate($article, $service);
// Extract intro image for media attachment
$media = [];
$images = json_decode($article->images ?? '{}');
if (!empty($images->image_intro)) {
$media[] = Uri::root() . ltrim($images->image_intro, '/');
}
// Create queue entry
$post = (object) [
'article_id' => (int) $article->id,
'service_id' => (int) $service->id,
'status' => 'queued',
'message' => $message,
'platform_post_id' => '',
'platform_response' => '',
'error_message' => '',
'retry_count' => 0,
'created' => Factory::getDate()->toSql(),
'modified' => Factory::getDate()->toSql(),
];
$db->insertObject('#__mokojoomcross_posts', $post);
$postId = $db->insertid();
// Resolve article URL
$url = $article->_article_url ?? $articleUrl;
if (empty($url)) {
$url = Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id
. (!empty($article->catid) ? '&catid=' . $article->catid : '');
}
// Attempt immediate dispatch if service plugin is available
$plugin = $pluginMap[$service->service_type] ?? null;
if ($plugin) {
self::executePost($db, $postId, $plugin, $message, $service, $media, $url);
} else {
self::log($db, $postId, $service->id, 'warning',
sprintf('No service plugin found for type "%s" — post remains queued', $service->service_type));
}
}
}
/**
* Execute a cross-post via the service plugin.
*/
private static function executePost($db, int $postId, MokoJoomCrossServiceInterface $plugin, string $message, object $service, array $media = [], string $articleUrl = ''): void
{
// Mark as posting
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('posting'))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $postId)
);
$db->execute();
$credentials = json_decode($service->credentials ?: '{}', true) ?: [];
$params = json_decode($service->params ?: '{}', true) ?: [];
if (!empty($articleUrl)) {
$params['_article_url'] = $articleUrl;
}
// Lifecycle event: before post
$cancel = false;
$dispatcher = Factory::getApplication()->getDispatcher();
try {
$beforeEvent = new \Joomla\Event\Event('onMokoJoomCrossBeforePost', [$postId, &$message, $service->service_type, &$cancel]);
$dispatcher->dispatch('onMokoJoomCrossBeforePost', $beforeEvent);
} catch (\Throwable $e) {
// Dispatcher may not be available
}
if ($cancel) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('cancelled'))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $postId)
);
$db->execute();
self::log($db, $postId, $service->id, 'info',
sprintf('Post to %s cancelled by onMokoJoomCrossBeforePost event', $service->service_type));
return;
}
try {
$result = $plugin->publish($message, $media, $credentials, $params);
if (!empty($result['success'])) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('posted'))
->set($db->quoteName('platform_post_id') . ' = ' . $db->quote($result['platform_post_id'] ?? ''))
->set($db->quoteName('platform_response') . ' = ' . $db->quote(json_encode($result['response'] ?? [])))
->set($db->quoteName('posted_at') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $postId)
);
$db->execute();
self::log($db, $postId, $service->id, 'info',
sprintf('Posted to %s (platform ID: %s)', $service->service_type, $result['platform_post_id'] ?? 'n/a'));
try {
$afterEvent = new \Joomla\Event\Event('onMokoJoomCrossAfterPost', [$postId, $service->service_type, $result]);
$dispatcher->dispatch('onMokoJoomCrossAfterPost', $afterEvent);
} catch (\Throwable $e) {
// Non-critical
}
} else {
$errorMsg = $result['response']['error'] ?? json_encode($result['response'] ?? []);
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('failed'))
->set($db->quoteName('error_message') . ' = ' . $db->quote(mb_substr($errorMsg, 0, 1000)))
->set($db->quoteName('platform_response') . ' = ' . $db->quote(json_encode($result['response'] ?? [])))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $postId)
);
$db->execute();
self::log($db, $postId, $service->id, 'error',
sprintf('Failed to post to %s: %s', $service->service_type, $errorMsg));
try {
$failedEvent = new \Joomla\Event\Event('onMokoJoomCrossPostFailed', [$postId, $service->service_type, $errorMsg]);
$dispatcher->dispatch('onMokoJoomCrossPostFailed', $failedEvent);
} catch (\Throwable $e) {
// Non-critical
}
}
} catch (\Throwable $e) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('failed'))
->set($db->quoteName('error_message') . ' = ' . $db->quote(mb_substr($e->getMessage(), 0, 1000)))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $postId)
);
$db->execute();
self::log($db, $postId, $service->id, 'error',
sprintf('Exception posting to %s: %s', $service->service_type, $e->getMessage()));
try {
$failedEvent = new \Joomla\Event\Event('onMokoJoomCrossPostFailed', [$postId, $service->service_type, $e->getMessage()]);
$dispatcher->dispatch('onMokoJoomCrossPostFailed', $failedEvent);
} catch (\Throwable $ex) {
// Non-critical
}
}
}
/**
* Render the message template for a service.
*/
private static function renderTemplate(object $article, object $service): string
{
$db = Factory::getDbo();
// Try service-specific template first, fall back to default
$query = $db->getQuery(true)
->select($db->quoteName('template_body'))
->from($db->quoteName('#__mokojoomcross_templates'))
->where($db->quoteName('published') . ' = 1')
->where('(' . $db->quoteName('service_type') . ' = ' . $db->quote($service->service_type)
. ' OR ' . $db->quoteName('service_type') . ' = ' . $db->quote('default') . ')')
->order('CASE WHEN ' . $db->quoteName('service_type') . ' = '
. $db->quote($service->service_type) . ' THEN 0 ELSE 1 END')
->setLimit(1);
$db->setQuery($query);
$template = $db->loadResult() ?: "{title}\n\n{url}";
// Build SEF article URL
$url = $article->_article_url
?? (Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id
. (!empty($article->catid) ? '&catid=' . $article->catid : ''));
// Resolve category name
$categoryName = '';
if (!empty($article->catid)) {
$query = $db->getQuery(true)
->select($db->quoteName('title'))
->from($db->quoteName('#__categories'))
->where($db->quoteName('id') . ' = ' . (int) $article->catid);
$db->setQuery($query);
$categoryName = $db->loadResult() ?: '';
}
// Resolve author name
$authorName = '';
if (!empty($article->created_by)) {
$query = $db->getQuery(true)
->select($db->quoteName('name'))
->from($db->quoteName('#__users'))
->where($db->quoteName('id') . ' = ' . (int) $article->created_by);
$db->setQuery($query);
$authorName = $db->loadResult() ?: '';
}
// Extract intro image
$introImage = '';
$images = json_decode($article->images ?? '{}');
if (!empty($images->image_intro)) {
$introImage = Uri::root() . ltrim($images->image_intro, '/');
}
// Resolve article tags
$tagNames = [];
if (!empty($article->id)) {
$query = $db->getQuery(true)
->select($db->quoteName('t.title'))
->from($db->quoteName('#__tags', 't'))
->join('INNER', $db->quoteName('#__contentitem_tag_map', 'm')
. ' ON ' . $db->quoteName('m.tag_id') . ' = ' . $db->quoteName('t.id'))
->where($db->quoteName('m.type_alias') . ' = ' . $db->quote('com_content.article'))
->where($db->quoteName('m.content_item_id') . ' = ' . (int) $article->id)
->where($db->quoteName('t.published') . ' = 1');
$db->setQuery($query);
$tagNames = $db->loadColumn() ?: [];
}
$tagsComma = implode(', ', $tagNames);
$hashtags = implode(' ', array_map(function ($tag) {
return '#' . preg_replace('/\s+/', '', $tag);
}, $tagNames));
// Replace placeholders
$replacements = [
'{title}' => $article->title ?? '',
'{introtext}' => strip_tags(mb_substr($article->introtext ?? '', 0, 280)),
'{fulltext}' => strip_tags(mb_substr($article->fulltext ?? '', 0, 500)),
'{url}' => $url,
'{image}' => $introImage,
'{category}' => $categoryName,
'{author}' => $authorName,
'{date}' => Factory::getDate($article->publish_up ?? 'now')->format('Y-m-d'),
'{tags}' => $tagsComma,
'{hashtags}' => $hashtags,
];
$message = str_replace(array_keys($replacements), array_values($replacements), $template);
// Resolve custom field placeholders: {field:field_name}
$message = preg_replace_callback('/\{field:([a-zA-Z0-9_-]+)\}/', function ($matches) use ($db, $article) {
$fieldName = $matches[1];
$query = $db->getQuery(true)
->select('fv.value')
->from($db->quoteName('#__fields_values', 'fv'))
->join('INNER', $db->quoteName('#__fields', 'f') . ' ON f.id = fv.field_id')
->where('f.name = ' . $db->quote($fieldName))
->where('fv.item_id = ' . (int) $article->id);
$db->setQuery($query);
return $db->loadResult() ?: '';
}, $message);
return $message;
}
/**
* Write an entry to the activity log.
*/
private static function log($db, ?int $postId, ?int $serviceId, string $level, string $message): void
{
$log = (object) [
'post_id' => $postId,
'service_id' => $serviceId,
'level' => $level,
'message' => mb_substr($message, 0, 2000),
'context' => '{}',
'created' => Factory::getDate()->toSql(),
];
$db->insertObject('#__mokojoomcross_logs', $log);
}
}
@@ -16,42 +16,28 @@ defined('_JEXEC') or die;
use Joomla\CMS\Factory;
/**
* Migration helper for importing settings from Perfect Publisher Pro (com_autotweet).
* Migration helper for importing settings from Perfect Publisher Pro.
*
* PP Pro stores channels in #__autotweet_channels with a channeltype_id FK
* to #__autotweet_channeltypes. Each channel has a JSON params column
* containing OAuth tokens, API keys, webhook URLs, etc.
*
* This helper reads those channels and creates MokoJoomCross service records.
* Reads Perfect Publisher Pro's component params and plugin configurations
* and maps them to MokoJoomCross service records.
*/
class MigrationHelper
{
/**
* Channel type name → MokoJoomCross service type mapping.
* PP Pro channeltype names vary; we match common patterns.
* Service type mapping from Perfect Publisher Pro to MokoJoomCross.
*
* @var array
*/
private const CHANNEL_MAP = [
'facebook' => 'facebook',
'fb' => 'facebook',
'twitter' => 'twitter',
'tw' => 'twitter',
'linkedin' => 'linkedin',
'li' => 'linkedin',
'telegram' => 'telegram',
'tg' => 'telegram',
'discord' => 'discord',
'slack' => 'slack',
'mastodon' => 'mastodon',
private const SERVICE_MAP = [
'facebook' => 'facebook',
'twitter' => 'twitter',
'linkedin' => 'linkedin',
'telegram' => 'telegram',
];
/**
* Run the full migration from Perfect Publisher Pro.
*
* Strategy:
* 1. Try reading #__autotweet_channels (PP Pro's channel table)
* 2. Fall back to reading component params if table doesn't exist
* 3. Create disabled MokoJoomCross service records
*
* @return array ['migrated' => int, 'skipped' => int, 'errors' => string[]]
*/
public static function migrate(): array
@@ -59,231 +45,18 @@ class MigrationHelper
$db = Factory::getDbo();
$result = ['migrated' => 0, 'skipped' => 0, 'errors' => []];
// Check if PP Pro is installed
if (!self::isPPProInstalled($db)) {
$result['errors'][] = 'Perfect Publisher Pro (com_autotweet) is not installed.';
return $result;
}
// Try channel-based migration first (PP Pro stores configs in #__autotweet_channels)
if (self::hasChannelTable($db)) {
$result = self::migrateFromChannels($db, $result);
} else {
// Fall back to component params extraction
$result = self::migrateFromParams($db, $result);
}
// Clear migration flag from MokoJoomCross params
self::clearMigrationFlag($db);
return $result;
}
/**
* Check if PP Pro is installed.
*/
private static function isPPProInstalled($db): bool
{
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__extensions'))
->where('(' . $db->quoteName('element') . ' = ' . $db->quote('com_autotweet')
. ' OR ' . $db->quoteName('element') . ' LIKE ' . $db->quote('%perfectpublisher%') . ')')
->where($db->quoteName('type') . ' = ' . $db->quote('component'));
$db->setQuery($query);
return (int) $db->loadResult() > 0;
}
/**
* Check if the autotweet_channels table exists.
*/
private static function hasChannelTable($db): bool
{
$prefix = $db->getPrefix();
try {
$db->setQuery('SHOW TABLES LIKE ' . $db->quote($prefix . 'autotweet_channels'));
return !empty($db->loadResult());
} catch (\Throwable $e) {
return false;
}
}
/**
* Migrate from #__autotweet_channels table (primary method).
*/
private static function migrateFromChannels($db, array $result): array
{
// Load channels with their type names
$query = $db->getQuery(true)
->select('c.id, c.name, c.published, c.params')
->select($db->quoteName('ct.name', 'type_name'))
->from($db->quoteName('#__autotweet_channels', 'c'))
->join('LEFT', $db->quoteName('#__autotweet_channeltypes', 'ct')
. ' ON ' . $db->quoteName('ct.id') . ' = ' . $db->quoteName('c.channeltype_id'));
$db->setQuery($query);
$channels = $db->loadObjectList();
if (empty($channels)) {
$result['errors'][] = 'No channels found in Perfect Publisher Pro.';
return $result;
}
foreach ($channels as $channel) {
$typeName = strtolower(trim($channel->type_name ?? ''));
// Match to MokoJoomCross service type
$mjcType = null;
foreach (self::CHANNEL_MAP as $pattern => $serviceType) {
if (str_contains($typeName, $pattern)) {
$mjcType = $serviceType;
break;
}
}
if (!$mjcType) {
$result['skipped']++;
continue;
}
// Check for duplicate (same type + migrated alias)
$alias = $mjcType . '-pp-' . $channel->id;
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('alias') . ' = ' . $db->quote($alias));
$db->setQuery($query);
if ((int) $db->loadResult() > 0) {
$result['skipped']++;
continue;
}
// Parse channel params to extract credentials
$channelParams = json_decode($channel->params ?: '{}', true) ?: [];
$credentials = self::mapChannelCredentials($mjcType, $channelParams);
if (empty($credentials)) {
$result['skipped']++;
continue;
}
// Create MokoJoomCross service record
$service = (object) [
'title' => $channel->name ?: ucfirst($mjcType) . ' (PP Pro #' . $channel->id . ')',
'alias' => $alias,
'service_type' => $mjcType,
'credentials' => json_encode($credentials),
'params' => '{}',
'published' => 0, // Disabled — user must verify before enabling
'ordering' => 0,
'created' => Factory::getDate()->toSql(),
'modified' => Factory::getDate()->toSql(),
'created_by' => Factory::getApplication()->getIdentity()->id ?? 0,
];
try {
$db->insertObject('#__mokojoomcross_services', $service);
$result['migrated']++;
} catch (\Throwable $e) {
$result['errors'][] = sprintf('Failed to create %s service: %s', $mjcType, $e->getMessage());
}
}
return $result;
}
/**
* Map PP Pro channel params to MokoJoomCross credential format.
*
* PP Pro stores various keys in channel params depending on the type.
* We normalize them to MokoJoomCross's expected credential structure.
*/
private static function mapChannelCredentials(string $serviceType, array $channelParams): array
{
$creds = ['mode' => 'custom'];
// Common OAuth fields PP Pro uses
$oauthFields = ['access_token', 'access_secret', 'client_id', 'client_secret',
'api_key', 'api_secret', 'app_id', 'app_secret', 'token'];
switch ($serviceType) {
case 'facebook':
$creds['page_access_token'] = $channelParams['access_token'] ?? $channelParams['token'] ?? '';
$creds['page_id'] = $channelParams['page_id'] ?? $channelParams['pageid'] ?? '';
break;
case 'twitter':
$creds['bearer_token'] = $channelParams['bearer_token'] ?? '';
$creds['api_key'] = $channelParams['api_key'] ?? $channelParams['consumer_key'] ?? '';
$creds['api_secret'] = $channelParams['api_secret'] ?? $channelParams['consumer_secret'] ?? '';
$creds['access_token'] = $channelParams['access_token'] ?? '';
$creds['access_token_secret'] = $channelParams['access_secret'] ?? $channelParams['access_token_secret'] ?? '';
break;
case 'linkedin':
$creds['access_token'] = $channelParams['access_token'] ?? $channelParams['token'] ?? '';
$creds['organization_id'] = $channelParams['company_id'] ?? $channelParams['organization_id'] ?? '';
$creds['person_id'] = $channelParams['person_id'] ?? $channelParams['member_id'] ?? '';
break;
case 'telegram':
$creds['bot_token'] = $channelParams['bot_token'] ?? $channelParams['token'] ?? $channelParams['api_key'] ?? '';
$creds['chat_id'] = $channelParams['chat_id'] ?? $channelParams['channel_id'] ?? '';
break;
case 'discord':
$creds['webhook_url'] = $channelParams['webhook_url'] ?? $channelParams['webhook'] ?? '';
break;
case 'slack':
$creds['webhook_url'] = $channelParams['webhook_url'] ?? $channelParams['webhook'] ?? '';
break;
case 'mastodon':
$creds['instance_url'] = $channelParams['instance_url'] ?? $channelParams['server'] ?? '';
$creds['access_token'] = $channelParams['access_token'] ?? $channelParams['token'] ?? '';
break;
default:
// Generic: copy all non-empty params
foreach ($channelParams as $key => $value) {
if (!empty($value) && is_string($value)) {
$creds[$key] = $value;
}
}
}
// Remove empty credential values and the mode key for check
$check = array_filter($creds, fn($v, $k) => $k !== 'mode' && !empty($v), ARRAY_FILTER_USE_BOTH);
return empty($check) ? [] : $creds;
}
/**
* Fallback: migrate from component params when channel table doesn't exist.
*/
private static function migrateFromParams($db, array $result): array
{
// Read Perfect Publisher Pro component params
$query = $db->getQuery(true)
->select($db->quoteName('params'))
->from($db->quoteName('#__extensions'))
->where('(' . $db->quoteName('element') . ' = ' . $db->quote('com_autotweet')
. ' OR ' . $db->quoteName('element') . ' LIKE ' . $db->quote('%perfectpublisher%') . ')')
->where($db->quoteName('element') . ' LIKE ' . $db->quote('%perfectpublisher%'))
->where($db->quoteName('type') . ' = ' . $db->quote('component'));
$db->setQuery($query);
$rawParams = $db->loadResult();
if (!$rawParams) {
$result['errors'][] = 'No PP Pro configuration found.';
$result['errors'][] = 'Perfect Publisher Pro not found or has no configuration.';
return $result;
}
@@ -291,44 +64,25 @@ class MigrationHelper
$params = json_decode($rawParams, true);
if (!is_array($params)) {
$result['errors'][] = 'Could not parse PP Pro configuration.';
$result['errors'][] = 'Could not parse Perfect Publisher Pro configuration.';
return $result;
}
// Extract services from component params using prefix patterns
$servicePatterns = [
'facebook' => ['facebook_', 'fb_'],
'twitter' => ['twitter_', 'tw_'],
'linkedin' => ['linkedin_', 'li_'],
'telegram' => ['telegram_', 'tg_'],
];
// Iterate known service mappings and create MokoJoomCross service records
foreach (self::SERVICE_MAP as $ppKey => $mjcType) {
$credentials = self::extractCredentials($params, $ppKey);
foreach ($servicePatterns as $mjcType => $prefixes) {
$credentials = ['mode' => 'custom'];
$found = false;
foreach ($params as $key => $value) {
foreach ($prefixes as $prefix) {
if (str_starts_with($key, $prefix) && !empty($value)) {
$cleanKey = substr($key, strlen($prefix));
$credentials[$cleanKey] = $value;
$found = true;
}
}
}
if (!$found) {
if (empty($credentials)) {
$result['skipped']++;
continue;
}
// Duplicate check
// Check if service already exists
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('service_type') . ' = ' . $db->quote($mjcType))
->where($db->quoteName('alias') . ' LIKE ' . $db->quote('%-migrated%'));
->where($db->quoteName('service_type') . ' = ' . $db->quote($mjcType));
$db->setQuery($query);
if ((int) $db->loadResult() > 0) {
@@ -336,53 +90,60 @@ class MigrationHelper
continue;
}
// Insert new service record
$service = (object) [
'title' => ucfirst($mjcType) . ' (migrated from PP Pro)',
'alias' => $mjcType . '-migrated',
'service_type' => $mjcType,
'credentials' => json_encode($credentials),
'params' => '{}',
'published' => 0,
'published' => 0, // Disabled until user verifies
'ordering' => 0,
'created' => Factory::getDate()->toSql(),
'modified' => Factory::getDate()->toSql(),
'created_by' => Factory::getApplication()->getIdentity()->id ?? 0,
];
try {
$db->insertObject('#__mokojoomcross_services', $service);
$result['migrated']++;
} catch (\Throwable $e) {
$result['errors'][] = sprintf('Failed to create %s: %s', $mjcType, $e->getMessage());
}
$db->insertObject('#__mokojoomcross_services', $service);
$result['migrated']++;
}
// Clear migration flag
$query = $db->getQuery(true)
->update($db->quoteName('#__extensions'))
->set($db->quoteName('params') . ' = ' . $db->quote('{}'))
->where($db->quoteName('type') . ' = ' . $db->quote('component'))
->where($db->quoteName('element') . ' = ' . $db->quote('com_mokojoomcross'));
$db->setQuery($query);
$db->execute();
return $result;
}
/**
* Clear the migration flag from MokoJoomCross component params.
* Extract credentials for a specific service from PP Pro params.
*
* @param array $params PP Pro component params
* @param string $serviceKey Service key in PP Pro params
*
* @return array Credential key/value pairs (empty if none found)
*/
private static function clearMigrationFlag($db): void
private static function extractCredentials(array $params, string $serviceKey): array
{
$query = $db->getQuery(true)
->select($db->quoteName('params'))
->from($db->quoteName('#__extensions'))
->where($db->quoteName('type') . ' = ' . $db->quote('component'))
->where($db->quoteName('element') . ' = ' . $db->quote('com_mokojoomcross'));
$credentials = [];
$db->setQuery($query);
$params = json_decode($db->loadResult() ?: '{}', true) ?: [];
// PP Pro uses various key patterns: {service}_app_id, {service}_api_key, etc.
$prefixes = [$serviceKey . '_', $serviceKey . 'api_', $serviceKey . '-'];
unset($params['migration_available'], $params['migration_source_params']);
foreach ($params as $key => $value) {
foreach ($prefixes as $prefix) {
if (str_starts_with($key, $prefix) && !empty($value)) {
$cleanKey = str_replace($prefix, '', $key);
$credentials[$cleanKey] = $value;
}
}
}
$query = $db->getQuery(true)
->update($db->quoteName('#__extensions'))
->set($db->quoteName('params') . ' = ' . $db->quote(json_encode($params)))
->where($db->quoteName('type') . ' = ' . $db->quote('component'))
->where($db->quoteName('element') . ' = ' . $db->quote('com_mokojoomcross'));
$db->setQuery($query);
$db->execute();
return $credentials;
}
}
@@ -1,65 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Helper;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
/**
* Component helper — renders the admin submenu sidebar.
*/
class MokoJoomCrossHelper
{
/**
* Configure the submenu links.
*
* Called from each view's addToolbar() to highlight the active item.
*
* @param string $activeView The current view name
*
* @return void
*/
public static function addSubmenu(string $activeView): void
{
\Joomla\CMS\HTML\Sidebar::addEntry(
Text::_('COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD'),
'index.php?option=com_mokojoomcross&view=dashboard',
$activeView === 'dashboard'
);
\Joomla\CMS\HTML\Sidebar::addEntry(
Text::_('COM_MOKOJOOMCROSS_SUBMENU_POSTS'),
'index.php?option=com_mokojoomcross&view=posts',
$activeView === 'posts'
);
\Joomla\CMS\HTML\Sidebar::addEntry(
Text::_('COM_MOKOJOOMCROSS_SUBMENU_SERVICES'),
'index.php?option=com_mokojoomcross&view=services',
$activeView === 'services'
);
\Joomla\CMS\HTML\Sidebar::addEntry(
Text::_('COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES'),
'index.php?option=com_mokojoomcross&view=templates',
$activeView === 'templates'
);
\Joomla\CMS\HTML\Sidebar::addEntry(
Text::_('COM_MOKOJOOMCROSS_SUBMENU_LOGS'),
'index.php?option=com_mokojoomcross&view=logs',
$activeView === 'logs'
);
}
}
@@ -1,305 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Helper;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Uri\Uri;
/**
* OAuth helper for services requiring browser-based authorization.
*
* Handles the OAuth 2.0 authorization code flow:
* 1. Generate authorize URL → redirect user to platform
* 2. Platform redirects back with auth code
* 3. Exchange code for access token
* 4. Store token in service credentials
*
* Each platform has its own endpoints and scopes. The service plugin
* provides these via OAuthConfigInterface (if it supports OAuth).
*/
class OAuthHelper
{
/**
* OAuth endpoint configs per service type.
*/
private const OAUTH_CONFIGS = [
'facebook' => [
'authorize_url' => 'https://www.facebook.com/v19.0/dialog/oauth',
'token_url' => 'https://graph.facebook.com/v19.0/oauth/access_token',
'scopes' => 'pages_manage_posts,pages_read_engagement',
],
'linkedin' => [
'authorize_url' => 'https://www.linkedin.com/oauth/v2/authorization',
'token_url' => 'https://www.linkedin.com/oauth/v2/accessToken',
'scopes' => 'w_member_social',
],
'twitter' => [
'authorize_url' => 'https://twitter.com/i/oauth2/authorize',
'token_url' => 'https://api.twitter.com/2/oauth2/token',
'scopes' => 'tweet.read tweet.write users.read',
],
];
/**
* Build the authorization URL for a given service.
*
* @param string $serviceType Service type (facebook, linkedin, twitter)
* @param int $serviceId Service record ID (passed through state param)
* @param string $clientId OAuth client/app ID
*
* @return string|null Authorization URL or null if not supported
*/
public static function getAuthorizeUrl(string $serviceType, int $serviceId, string $clientId): ?string
{
$config = self::OAUTH_CONFIGS[$serviceType] ?? null;
if (!$config) {
return null;
}
$redirectUri = self::getCallbackUrl();
$state = base64_encode(json_encode(['service_id' => $serviceId, 'type' => $serviceType]));
$params = [
'client_id' => $clientId,
'redirect_uri' => $redirectUri,
'response_type' => 'code',
'scope' => $config['scopes'],
'state' => $state,
];
// Twitter uses PKCE
if ($serviceType === 'twitter') {
$verifier = bin2hex(random_bytes(32));
$challenge = rtrim(strtr(base64_encode(hash('sha256', $verifier, true)), '+/', '-_'), '=');
// Store verifier in session for token exchange
Factory::getApplication()->getSession()->set('mokojoomcross.pkce_verifier', $verifier);
$params['code_challenge'] = $challenge;
$params['code_challenge_method'] = 'S256';
}
return $config['authorize_url'] . '?' . http_build_query($params);
}
/**
* Exchange authorization code for access token.
*
* @param string $serviceType Service type
* @param string $code Authorization code from callback
* @param string $clientId OAuth client ID
* @param string $clientSecret OAuth client secret
*
* @return array ['access_token' => '...', 'expires_in' => N, ...] or ['error' => '...']
*/
public static function exchangeCode(string $serviceType, string $code, string $clientId, string $clientSecret): array
{
$config = self::OAUTH_CONFIGS[$serviceType] ?? null;
if (!$config) {
return ['error' => 'Unsupported service type for OAuth'];
}
$postData = [
'grant_type' => 'authorization_code',
'code' => $code,
'redirect_uri' => self::getCallbackUrl(),
'client_id' => $clientId,
'client_secret' => $clientSecret,
];
// Twitter PKCE
if ($serviceType === 'twitter') {
$verifier = Factory::getApplication()->getSession()->get('mokojoomcross.pkce_verifier', '');
$postData['code_verifier'] = $verifier;
}
$ch = curl_init($config['token_url']);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($postData),
CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded', 'Accept: application/json'],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if ($httpCode >= 200 && $httpCode < 300 && !empty($data['access_token'])) {
return $data;
}
return ['error' => $data['error_description'] ?? $data['error'] ?? 'Token exchange failed'];
}
/**
* Store OAuth token in the service credentials.
*
* @param int $serviceId Service record ID
* @param array $tokenData Token response from platform
*
* @return bool
*/
public static function storeToken(int $serviceId, array $tokenData): bool
{
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select($db->quoteName('credentials'))
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('id') . ' = ' . $serviceId);
$db->setQuery($query);
$credentials = json_decode($db->loadResult() ?: '{}', true) ?: [];
$credentials['access_token'] = $tokenData['access_token'];
$credentials['mode'] = 'custom';
if (!empty($tokenData['refresh_token'])) {
$credentials['refresh_token'] = $tokenData['refresh_token'];
}
if (!empty($tokenData['expires_in'])) {
$credentials['token_expires'] = time() + (int) $tokenData['expires_in'];
}
$query = $db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_services'))
->set($db->quoteName('credentials') . ' = ' . $db->quote(json_encode($credentials)))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . $serviceId);
$db->setQuery($query);
$db->execute();
return true;
}
/**
* Refresh an OAuth token if it has expired.
*
* Checks `token_expires` in the credentials array. If the token is expired
* and a refresh_token is available, performs the refresh grant and updates
* both the DB and the passed-in credentials array.
*
* @param int $serviceId Service record ID
* @param array &$credentials Credentials array (updated by reference on refresh)
*
* @return bool True if token was refreshed, false otherwise
*/
public static function refreshTokenIfNeeded(int $serviceId, array &$credentials): bool
{
// No expiry set — nothing to refresh
if (empty($credentials['token_expires'])) {
return false;
}
// Token not yet expired
if ((int) $credentials['token_expires'] >= time()) {
return false;
}
// Expired but no refresh token available
if (empty($credentials['refresh_token'])) {
return false;
}
// Look up the service type from DB
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select($db->quoteName('service_type'))
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('id') . ' = ' . $serviceId);
$db->setQuery($query);
$serviceType = $db->loadResult();
if (!$serviceType) {
return false;
}
// Get OAuth config for this service type
$config = self::OAUTH_CONFIGS[$serviceType] ?? null;
if (!$config || empty($config['token_url'])) {
return false;
}
// POST refresh token grant
$postData = [
'grant_type' => 'refresh_token',
'refresh_token' => $credentials['refresh_token'],
];
// Include client credentials if available
if (!empty($credentials['client_id'])) {
$postData['client_id'] = $credentials['client_id'];
}
if (!empty($credentials['client_secret'])) {
$postData['client_secret'] = $credentials['client_secret'];
}
$ch = curl_init($config['token_url']);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($postData),
CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded', 'Accept: application/json'],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if ($httpCode >= 200 && $httpCode < 300 && !empty($data['access_token'])) {
// Store updated token in DB
self::storeToken($serviceId, $data);
// Update credentials by reference
$credentials['access_token'] = $data['access_token'];
if (!empty($data['refresh_token'])) {
$credentials['refresh_token'] = $data['refresh_token'];
}
if (!empty($data['expires_in'])) {
$credentials['token_expires'] = time() + (int) $data['expires_in'];
}
return true;
}
return false;
}
/**
* Get the OAuth callback URL for this Joomla installation.
*
* @return string
*/
public static function getCallbackUrl(): string
{
return Uri::root() . 'administrator/index.php?option=com_mokojoomcross&task=oauth.callback';
}
}
@@ -1,774 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Helper;
defined('_JEXEC') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
/**
* Shared queue processor used by:
* - System plugin onAfterRender (page-load processing)
* - Task scheduler plugin (Joomla scheduled task)
*
* Handles: queued posts, failed retries, scheduled posts, and log cleanup.
* Uses a simple DB-based lock to prevent concurrent execution.
*/
class QueueProcessor
{
/**
* Process the post queue: dispatch queued posts, retry failed, fire scheduled.
*
* @param int $batchSize Max posts to process per run
*
* @return array ['processed' => int, 'succeeded' => int, 'failed' => int, 'skipped' => int]
*/
public static function processQueue(int $batchSize = 10): array
{
$result = ['processed' => 0, 'succeeded' => 0, 'failed' => 0, 'skipped' => 0];
if (!self::acquireLock()) {
$result['skipped'] = -1;
return $result;
}
try {
$db = Factory::getDbo();
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
$maxRetry = (int) $componentParams->get('retry_max', 3);
$retryDelay = (int) $componentParams->get('retry_delay', 300);
$now = Factory::getDate()->toSql();
// Build service plugin map
$pluginMap = self::getServicePluginMap();
// 1. Process queued posts
$query = $db->getQuery(true)
->select('p.*, s.service_type, s.credentials, s.params AS service_params')
->from($db->quoteName('#__mokojoomcross_posts', 'p'))
->join('INNER', $db->quoteName('#__mokojoomcross_services', 's')
. ' ON ' . $db->quoteName('s.id') . ' = ' . $db->quoteName('p.service_id'))
->where($db->quoteName('p.status') . ' = ' . $db->quote('queued'))
->where('(' . $db->quoteName('p.scheduled_at') . ' IS NULL OR '
. $db->quoteName('p.scheduled_at') . ' <= ' . $db->quote($now) . ')')
->where($db->quoteName('s.published') . ' = 1')
->order($db->quoteName('p.created') . ' ASC')
->setLimit($batchSize);
$db->setQuery($query);
$queuedPosts = $db->loadObjectList() ?: [];
// 2. Process failed posts eligible for retry (exponential backoff)
// Retry 1 waits retryDelay, retry 2 waits retryDelay*2, retry 3 waits retryDelay*4, etc.
$query = $db->getQuery(true)
->select('p.*, s.service_type, s.credentials, s.params AS service_params')
->from($db->quoteName('#__mokojoomcross_posts', 'p'))
->join('INNER', $db->quoteName('#__mokojoomcross_services', 's')
. ' ON ' . $db->quoteName('s.id') . ' = ' . $db->quoteName('p.service_id'))
->where($db->quoteName('p.status') . ' = ' . $db->quote('failed'))
->where($db->quoteName('p.retry_count') . ' < ' . $maxRetry)
->where($db->quoteName('p.modified') . ' <= DATE_SUB(NOW(), INTERVAL ('
. (int) $retryDelay . ' * POW(2, ' . $db->quoteName('p.retry_count') . ')) SECOND)')
->where($db->quoteName('s.published') . ' = 1')
->order($db->quoteName('p.modified') . ' ASC')
->setLimit($batchSize);
$db->setQuery($query);
$retryPosts = $db->loadObjectList() ?: [];
$allPosts = array_merge($queuedPosts, $retryPosts);
foreach ($allPosts as $post) {
$result['processed']++;
$plugin = $pluginMap[$post->service_type] ?? null;
if (!$plugin) {
$result['skipped']++;
continue;
}
$isRetry = ($post->status === 'failed');
if ($isRetry) {
$newRetryCount = (int) $post->retry_count + 1;
// If this is the last retry attempt, mark permanently failed on failure
if ($newRetryCount >= $maxRetry) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('permanently_failed'))
->set($db->quoteName('retry_count') . ' = ' . $newRetryCount)
->set($db->quoteName('error_message') . ' = CONCAT(' . $db->quoteName('error_message') . ', ' . $db->quote(' [max retries exceeded]') . ')')
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
self::log($db, (int) $post->id, (int) $post->service_id, 'error',
sprintf('Permanently failed %s: max retries (%d) exceeded', $post->service_type, $maxRetry));
$result['failed']++;
continue;
}
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('retry_count') . ' = ' . $newRetryCount)
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
}
// Mark as posting
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('posting'))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
$credentials = json_decode($post->credentials ?: '{}', true) ?: [];
$params = json_decode($post->service_params ?: '{}', true) ?: [];
// Token auto-refresh before posting
OAuthHelper::refreshTokenIfNeeded((int) $post->service_id, $credentials);
// Extract intro image for media attachment
$media = [];
if (!empty($post->article_id)) {
$imgQuery = $db->getQuery(true)
->select($db->quoteName('images'))
->from($db->quoteName('#__content'))
->where($db->quoteName('id') . ' = ' . (int) $post->article_id);
$db->setQuery($imgQuery);
$imgJson = $db->loadResult();
if ($imgJson) {
$imgData = json_decode($imgJson);
if (!empty($imgData->image_intro)) {
$media[] = Uri::root() . ltrim($imgData->image_intro, '/');
}
}
}
// Lifecycle event: before post
$cancel = false;
$message = $post->message;
try {
$dispatcher = Factory::getApplication()->getDispatcher();
$beforeEvent = new \Joomla\Event\Event('onMokoJoomCrossBeforePost', [(int) $post->id, &$message, $post->service_type, &$cancel]);
$dispatcher->dispatch('onMokoJoomCrossBeforePost', $beforeEvent);
} catch (\Throwable $e) {
// Dispatcher may not be available
}
if ($cancel) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('cancelled'))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
self::log($db, (int) $post->id, (int) $post->service_id, 'info',
sprintf('Post to %s cancelled by onMokoJoomCrossBeforePost event', $post->service_type));
$result['skipped']++;
continue;
}
try {
$apiResult = $plugin->publish($message, $media, $credentials, $params);
if (!empty($apiResult['success'])) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('posted'))
->set($db->quoteName('platform_post_id') . ' = ' . $db->quote($apiResult['platform_post_id'] ?? ''))
->set($db->quoteName('platform_response') . ' = ' . $db->quote(json_encode($apiResult['response'] ?? [])))
->set($db->quoteName('posted_at') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
self::log($db, (int) $post->id, (int) $post->service_id, 'info',
sprintf('%s to %s (ID: %s)', $isRetry ? 'Retry succeeded' : 'Posted', $post->service_type, $apiResult['platform_post_id'] ?? 'n/a'));
// Lifecycle event: after successful post
try {
$afterEvent = new \Joomla\Event\Event('onMokoJoomCrossAfterPost', [(int) $post->id, $post->service_type, $apiResult]);
$dispatcher->dispatch('onMokoJoomCrossAfterPost', $afterEvent);
} catch (\Throwable $e) {
// Non-critical
}
$result['succeeded']++;
} else {
$errorMsg = $apiResult['response']['error'] ?? json_encode($apiResult['response'] ?? []);
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('failed'))
->set($db->quoteName('error_message') . ' = ' . $db->quote(mb_substr($errorMsg, 0, 1000)))
->set($db->quoteName('platform_response') . ' = ' . $db->quote(json_encode($apiResult['response'] ?? [])))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
self::log($db, (int) $post->id, (int) $post->service_id, 'error',
sprintf('Failed %s: %s', $post->service_type, mb_substr($errorMsg, 0, 500)));
// Lifecycle event: post failed
try {
$failedEvent = new \Joomla\Event\Event('onMokoJoomCrossPostFailed', [(int) $post->id, $post->service_type, $errorMsg]);
$dispatcher->dispatch('onMokoJoomCrossPostFailed', $failedEvent);
} catch (\Throwable $e) {
// Non-critical
}
$result['failed']++;
}
} catch (\Throwable $e) {
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('failed'))
->set($db->quoteName('error_message') . ' = ' . $db->quote(mb_substr($e->getMessage(), 0, 1000)))
->set($db->quoteName('modified') . ' = ' . $db->quote(Factory::getDate()->toSql()))
->where($db->quoteName('id') . ' = ' . (int) $post->id)
);
$db->execute();
self::log($db, (int) $post->id, (int) $post->service_id, 'error',
sprintf('Exception %s: %s', $post->service_type, mb_substr($e->getMessage(), 0, 500)));
// Lifecycle event: post failed (exception)
try {
$failedEvent = new \Joomla\Event\Event('onMokoJoomCrossPostFailed', [(int) $post->id, $post->service_type, $e->getMessage()]);
$dispatcher->dispatch('onMokoJoomCrossPostFailed', $failedEvent);
} catch (\Throwable $ex) {
// Non-critical
}
$result['failed']++;
}
}
// 3. Clean up old logs
self::cleanupLogs($db, $componentParams);
} finally {
self::releaseLock();
}
return $result;
}
/**
* Process evergreen re-shares: find articles marked as evergreen whose last
* successful post to each service was longer ago than the configured interval,
* and create new queue entries for them.
*
* @return array ['queued' => int]
*/
public static function processEvergreen(): array
{
$result = ['queued' => 0];
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
if (!$componentParams->get('evergreen_enabled', 1)) {
return $result;
}
$defaultInterval = (int) $componentParams->get('evergreen_default_interval', 30);
$maxPerRun = (int) $componentParams->get('evergreen_max_per_run', 3);
$db = Factory::getDbo();
$now = Factory::getDate()->toSql();
// Find published articles with evergreen=1 in attribs
$query = $db->getQuery(true)
->select('c.id, c.attribs')
->from($db->quoteName('#__content', 'c'))
->where($db->quoteName('c.state') . ' = 1')
->where($db->quoteName('c.attribs') . ' LIKE ' . $db->quote('%"mokojoomcross_evergreen":"1"%'));
$db->setQuery($query);
$articles = $db->loadObjectList() ?: [];
if (empty($articles)) {
return $result;
}
// Load all published services
$query = $db->getQuery(true)
->select('id, service_type')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('published') . ' = 1');
$db->setQuery($query);
$services = $db->loadObjectList() ?: [];
if (empty($services)) {
return $result;
}
// Load the system plugin for template rendering
PluginHelper::importPlugin('system');
$systemPlugin = null;
try {
$plugins = [];
Factory::getApplication()->getDispatcher()->dispatch(
'onMokoJoomCrossGetServices',
new \Joomla\Event\Event('onMokoJoomCrossGetServices', [&$plugins])
);
} catch (\Throwable $e) {
// Not critical for queuing
}
foreach ($articles as $article) {
if ($result['queued'] >= $maxPerRun) {
break;
}
$attribs = json_decode($article->attribs ?? '{}', true) ?: [];
$interval = (int) ($attribs['mokojoomcross_evergreen_interval'] ?? $defaultInterval);
if ($interval < 1) {
$interval = $defaultInterval;
}
// Per-article service filter
$selectedServiceIds = $attribs['mokojoomcross_services'] ?? null;
if (is_array($selectedServiceIds) && !empty($selectedServiceIds)) {
$selectedServiceIds = array_map('intval', $selectedServiceIds);
} else {
$selectedServiceIds = null;
}
// Load the full article for template rendering
$fullArticle = null;
foreach ($services as $service) {
if ($result['queued'] >= $maxPerRun) {
break;
}
// Per-article service filter
if ($selectedServiceIds !== null && !in_array((int) $service->id, $selectedServiceIds, true)) {
continue;
}
// Check last successful post for this article+service
$query = $db->getQuery(true)
->select($db->quoteName('posted_at'))
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('article_id') . ' = ' . (int) $article->id)
->where($db->quoteName('service_id') . ' = ' . (int) $service->id)
->where($db->quoteName('status') . ' = ' . $db->quote('posted'))
->order($db->quoteName('posted_at') . ' DESC')
->setLimit(1);
$db->setQuery($query);
$lastPosted = $db->loadResult();
if (empty($lastPosted)) {
// Never posted — skip, the initial cross-post will handle it
continue;
}
// Check if interval has elapsed
$lastDate = Factory::getDate($lastPosted);
$dueDate = Factory::getDate($lastPosted . ' + ' . $interval . ' days');
if ($dueDate->toUnix() > Factory::getDate()->toUnix()) {
// Not due yet
continue;
}
// Skip if there's already a queued/posting entry
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('article_id') . ' = ' . (int) $article->id)
->where($db->quoteName('service_id') . ' = ' . (int) $service->id)
->where($db->quoteName('status') . ' IN (' . $db->quote('queued') . ',' . $db->quote('posting') . ')');
$db->setQuery($query);
if ((int) $db->loadResult() > 0) {
continue;
}
// Load full article if not already loaded
if ($fullArticle === null) {
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__content'))
->where($db->quoteName('id') . ' = ' . (int) $article->id);
$db->setQuery($query);
$fullArticle = $db->loadObject();
if (!$fullArticle) {
break;
}
}
// Render message using default template
$template = $componentParams->get('default_template', "{title}\n\n{url}");
$message = self::renderEvergreenMessage($db, $fullArticle, $template);
// Create queue entry
$post = (object) [
'article_id' => (int) $article->id,
'service_id' => (int) $service->id,
'status' => 'queued',
'message' => $message,
'platform_post_id' => '',
'platform_response' => '',
'error_message' => '',
'retry_count' => 0,
'created' => $now,
'modified' => $now,
];
$db->insertObject('#__mokojoomcross_posts', $post);
self::log($db, $db->insertid(), (int) $service->id, 'info',
sprintf('Evergreen re-share queued for article %d to %s (interval: %d days)',
$article->id, $service->service_type, $interval));
$result['queued']++;
}
}
return $result;
}
/**
* Render a message for an evergreen re-share using the default template.
*/
private static function renderEvergreenMessage($db, object $article, string $template): string
{
$url = \Joomla\CMS\Uri\Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id;
if (!empty($article->catid)) {
$url .= '&catid=' . $article->catid;
}
$categoryName = '';
if (!empty($article->catid)) {
$query = $db->getQuery(true)
->select($db->quoteName('title'))
->from($db->quoteName('#__categories'))
->where($db->quoteName('id') . ' = ' . (int) $article->catid);
$db->setQuery($query);
$categoryName = $db->loadResult() ?: '';
}
$authorName = '';
if (!empty($article->created_by)) {
$query = $db->getQuery(true)
->select($db->quoteName('name'))
->from($db->quoteName('#__users'))
->where($db->quoteName('id') . ' = ' . (int) $article->created_by);
$db->setQuery($query);
$authorName = $db->loadResult() ?: '';
}
$introImage = '';
$images = json_decode($article->images ?? '{}');
if (!empty($images->image_intro)) {
$introImage = \Joomla\CMS\Uri\Uri::root() . ltrim($images->image_intro, '/');
}
// Resolve article tags
$tagNames = [];
if (!empty($article->id)) {
$query = $db->getQuery(true)
->select($db->quoteName('t.title'))
->from($db->quoteName('#__tags', 't'))
->join('INNER', $db->quoteName('#__contentitem_tag_map', 'm')
. ' ON ' . $db->quoteName('m.tag_id') . ' = ' . $db->quoteName('t.id'))
->where($db->quoteName('m.type_alias') . ' = ' . $db->quote('com_content.article'))
->where($db->quoteName('m.content_item_id') . ' = ' . (int) $article->id)
->where($db->quoteName('t.published') . ' = 1');
$db->setQuery($query);
$tagNames = $db->loadColumn() ?: [];
}
$tagsComma = implode(', ', $tagNames);
$hashtags = implode(' ', array_map(function ($tag) {
return '#' . preg_replace('/\s+/', '', $tag);
}, $tagNames));
$replacements = [
'{title}' => $article->title ?? '',
'{introtext}' => strip_tags(mb_substr($article->introtext ?? '', 0, 280)),
'{fulltext}' => strip_tags(mb_substr($article->fulltext ?? '', 0, 500)),
'{url}' => $url,
'{image}' => $introImage,
'{category}' => $categoryName,
'{author}' => $authorName,
'{date}' => Factory::getDate($article->publish_up ?? 'now')->format('Y-m-d'),
'{tags}' => $tagsComma,
'{hashtags}' => $hashtags,
];
$message = str_replace(array_keys($replacements), array_values($replacements), $template);
// Resolve custom field placeholders: {field:field_name}
$message = preg_replace_callback('/\{field:([a-zA-Z0-9_-]+)\}/', function ($matches) use ($db, $article) {
$fieldName = $matches[1];
$query = $db->getQuery(true)
->select('fv.value')
->from($db->quoteName('#__fields_values', 'fv'))
->join('INNER', $db->quoteName('#__fields', 'f') . ' ON f.id = fv.field_id')
->where('f.name = ' . $db->quote($fieldName))
->where('fv.item_id = ' . (int) $article->id);
$db->setQuery($query);
return $db->loadResult() ?: '';
}, $message);
return $message;
}
/**
* Manually retry one or more failed/permanently_failed posts.
*
* Resets status to 'queued' and retry_count to 0 so the queue processor
* picks them up on the next run.
*
* @param array $postIds Post IDs to retry
*
* @return int Number of posts re-queued
*/
public static function retryPosts(array $postIds): int
{
if (empty($postIds)) {
return 0;
}
$db = Factory::getDbo();
$now = Factory::getDate()->toSql();
$ids = implode(',', array_map('intval', $postIds));
$query = $db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('queued'))
->set($db->quoteName('retry_count') . ' = 0')
->set($db->quoteName('error_message') . ' = ' . $db->quote(''))
->set($db->quoteName('modified') . ' = ' . $db->quote($now))
->where($db->quoteName('id') . ' IN (' . $ids . ')')
->where($db->quoteName('status') . ' IN (' . $db->quote('failed') . ',' . $db->quote('permanently_failed') . ')');
$db->setQuery($query);
$db->execute();
$count = $db->getAffectedRows();
if ($count > 0) {
self::log($db, null, null, 'info', sprintf('Manual retry: %d post(s) re-queued', $count));
}
return $count;
}
/**
* Retry all failed posts for a specific service.
*
* @param int $serviceId Service ID
*
* @return int Number of posts re-queued
*/
public static function retryService(int $serviceId): int
{
$db = Factory::getDbo();
$now = Factory::getDate()->toSql();
$query = $db->getQuery(true)
->update($db->quoteName('#__mokojoomcross_posts'))
->set($db->quoteName('status') . ' = ' . $db->quote('queued'))
->set($db->quoteName('retry_count') . ' = 0')
->set($db->quoteName('error_message') . ' = ' . $db->quote(''))
->set($db->quoteName('modified') . ' = ' . $db->quote($now))
->where($db->quoteName('service_id') . ' = ' . $serviceId)
->where($db->quoteName('status') . ' IN (' . $db->quote('failed') . ',' . $db->quote('permanently_failed') . ')');
$db->setQuery($query);
$db->execute();
$count = $db->getAffectedRows();
if ($count > 0) {
self::log($db, null, $serviceId, 'info', sprintf('Bulk retry: %d post(s) re-queued for service %d', $count, $serviceId));
}
return $count;
}
/**
* Check if there are pending items in the queue.
*
* @return bool
*/
public static function hasPendingWork(): bool
{
$db = Factory::getDbo();
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
$maxRetry = (int) $componentParams->get('retry_max', 3);
$retryDelay = (int) $componentParams->get('retry_delay', 300);
$retryAfter = Factory::getDate('now - ' . $retryDelay . ' seconds')->toSql();
$now = Factory::getDate()->toSql();
// Queued posts ready to go
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('status') . ' = ' . $db->quote('queued'))
->where('(' . $db->quoteName('scheduled_at') . ' IS NULL OR '
. $db->quoteName('scheduled_at') . ' <= ' . $db->quote($now) . ')');
$db->setQuery($query);
$queued = (int) $db->loadResult();
// Failed posts eligible for retry
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__mokojoomcross_posts'))
->where($db->quoteName('status') . ' = ' . $db->quote('failed'))
->where($db->quoteName('retry_count') . ' < ' . $maxRetry)
->where($db->quoteName('modified') . ' <= ' . $db->quote($retryAfter));
$db->setQuery($query);
$retryable = (int) $db->loadResult();
return ($queued + $retryable) > 0;
}
/**
* Import mokojoomcross plugins and build a type → plugin instance map.
*
* @return array<string, MokoJoomCrossServiceInterface>
*/
private static function getServicePluginMap(): array
{
PluginHelper::importPlugin('mokojoomcross');
$servicePlugins = [];
try {
Factory::getApplication()->getDispatcher()->dispatch(
'onMokoJoomCrossGetServices',
new \Joomla\Event\Event('onMokoJoomCrossGetServices', [&$servicePlugins])
);
} catch (\Throwable $e) {
// Dispatcher may not be available in all contexts
}
$map = [];
foreach ($servicePlugins as $plugin) {
if ($plugin instanceof MokoJoomCrossServiceInterface) {
$map[$plugin->getServiceType()] = $plugin;
}
}
return $map;
}
/**
* Delete logs older than the configured retention period.
*/
private static function cleanupLogs($db, $componentParams): void
{
$retentionDays = (int) $componentParams->get('log_retention_days', 90);
if ($retentionDays <= 0) {
return;
}
$cutoff = Factory::getDate('now - ' . $retentionDays . ' days')->toSql();
$query = $db->getQuery(true)
->delete($db->quoteName('#__mokojoomcross_logs'))
->where($db->quoteName('created') . ' < ' . $db->quote($cutoff));
$db->setQuery($query);
$db->execute();
}
/**
* Acquire a MySQL advisory lock to prevent concurrent queue processing.
*
* Uses GET_LOCK() which is atomic — no race condition possible.
* The 0 timeout means non-blocking (returns immediately if lock is held).
* MySQL automatically releases the lock if the connection drops.
*/
private static function acquireLock(): bool
{
$db = Factory::getDbo();
$db->setQuery("SELECT GET_LOCK('mokojoomcross_queue', 0)");
return (int) $db->loadResult() === 1;
}
/**
* Release the MySQL advisory lock.
*/
private static function releaseLock(): void
{
$db = Factory::getDbo();
$db->setQuery("SELECT RELEASE_LOCK('mokojoomcross_queue')");
$db->execute();
}
/**
* Write a log entry.
*/
private static function log($db, ?int $postId, ?int $serviceId, string $level, string $message): void
{
$log = (object) [
'post_id' => $postId,
'service_id' => $serviceId,
'level' => $level,
'message' => mb_substr($message, 0, 2000),
'context' => '{}',
'created' => Factory::getDate()->toSql(),
];
$db->insertObject('#__mokojoomcross_logs', $log);
}
}
@@ -70,126 +70,4 @@ class DashboardModel extends BaseDatabaseModel
return !empty($params['migration_available']);
}
/**
* Get recent activity log entries.
*
* @param int $limit Number of entries to return
*
* @return array
*/
public function getRecentActivity(int $limit = 10): array
{
$db = $this->getDatabase();
$query = $db->getQuery(true)
->select('l.*, s.title AS service_title, s.service_type')
->from($db->quoteName('#__mokojoomcross_logs', 'l'))
->join('LEFT', $db->quoteName('#__mokojoomcross_services', 's')
. ' ON ' . $db->quoteName('s.id') . ' = ' . $db->quoteName('l.service_id'))
->order($db->quoteName('l.created') . ' DESC');
$db->setQuery($query, 0, $limit);
return $db->loadObjectList() ?: [];
}
/**
* Get posts-per-service breakdown for the analytics chart.
*
* @param string|null $since Only count posts created on or after this datetime
*
* @return array [['service_type' => '...', 'posted' => N, 'failed' => N, 'queued' => N], ...]
*/
public function getServiceBreakdown(?string $since = null): array
{
$db = $this->getDatabase();
$query = $db->getQuery(true)
->select([
$db->quoteName('s.service_type'),
$db->quoteName('s.title', 'service_title'),
'SUM(CASE WHEN ' . $db->quoteName('p.status') . ' = ' . $db->quote('posted') . ' THEN 1 ELSE 0 END) AS posted',
'SUM(CASE WHEN ' . $db->quoteName('p.status') . ' = ' . $db->quote('failed') . ' THEN 1 ELSE 0 END) AS failed',
'SUM(CASE WHEN ' . $db->quoteName('p.status') . ' = ' . $db->quote('queued') . ' THEN 1 ELSE 0 END) AS queued',
'COUNT(*) AS total',
])
->from($db->quoteName('#__mokojoomcross_posts', 'p'))
->join('INNER', $db->quoteName('#__mokojoomcross_services', 's')
. ' ON ' . $db->quoteName('s.id') . ' = ' . $db->quoteName('p.service_id'))
->group($db->quoteName(['s.id', 's.service_type', 's.title']))
->order('total DESC');
if ($since !== null) {
$query->where($db->quoteName('p.created') . ' >= ' . $db->quote($since));
}
$db->setQuery($query);
return $db->loadAssocList() ?: [];
}
/**
* Get posts-per-day for the last N days (for trend chart).
*
* @param int $days Number of days to look back
*
* @return array [['day' => '2026-05-28', 'posted' => N, 'failed' => N], ...]
*/
public function getDailyTrend(int $days = 14): array
{
$db = $this->getDatabase();
$cutoff = Factory::getDate('now - ' . $days . ' days')->format('Y-m-d');
$query = $db->getQuery(true)
->select([
'DATE(' . $db->quoteName('created') . ') AS day',
'SUM(CASE WHEN ' . $db->quoteName('status') . ' = ' . $db->quote('posted') . ' THEN 1 ELSE 0 END) AS posted',
'SUM(CASE WHEN ' . $db->quoteName('status') . ' = ' . $db->quote('failed') . ' THEN 1 ELSE 0 END) AS failed',
'COUNT(*) AS total',
])
->from($db->quoteName('#__mokojoomcross_posts'))
->where('DATE(' . $db->quoteName('created') . ') >= ' . $db->quote($cutoff))
->group('DATE(' . $db->quoteName('created') . ')')
->order('day ASC');
$db->setQuery($query);
return $db->loadAssocList() ?: [];
}
/**
* Get most cross-posted articles.
*
* @param int $limit Number of articles
* @param string|null $since Only count posts created on or after this datetime
*
* @return array
*/
public function getTopArticles(int $limit = 5, ?string $since = null): array
{
$db = $this->getDatabase();
$query = $db->getQuery(true)
->select([
$db->quoteName('c.id'),
$db->quoteName('c.title'),
'COUNT(*) AS post_count',
'SUM(CASE WHEN ' . $db->quoteName('p.status') . ' = ' . $db->quote('posted') . ' THEN 1 ELSE 0 END) AS success_count',
])
->from($db->quoteName('#__mokojoomcross_posts', 'p'))
->join('INNER', $db->quoteName('#__content', 'c')
. ' ON ' . $db->quoteName('c.id') . ' = ' . $db->quoteName('p.article_id'))
->group($db->quoteName(['c.id', 'c.title']))
->order('post_count DESC');
if ($since !== null) {
$query->where($db->quoteName('p.created') . ' >= ' . $db->quote($since));
}
$db->setQuery($query, 0, $limit);
return $db->loadAssocList() ?: [];
}
}
@@ -1,83 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Model;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\MVC\Model\AdminModel;
class PostModel extends AdminModel
{
public function getForm($data = [], $loadData = true)
{
$form = $this->loadForm(
'com_mokojoomcross.post',
'post',
['control' => 'jform', 'load_data' => $loadData]
);
if (empty($form)) {
return false;
}
// Lock article_id and service_id on existing records
$id = $this->getState('post.id', 0);
if ($id > 0) {
$form->setFieldAttribute('article_id', 'readonly', 'true');
$form->setFieldAttribute('service_id', 'readonly', 'true');
}
return $form;
}
protected function loadFormData()
{
return $this->getItem();
}
/**
* Prepare and sanitise the table prior to saving.
*/
protected function prepareTable($table)
{
$now = Factory::getDate()->toSql();
if (empty($table->id)) {
$table->created = $now;
$table->modified = $now;
if (empty($table->status)) {
$table->status = empty($table->scheduled_at) ? 'queued' : 'scheduled';
}
if (empty($table->retry_count)) {
$table->retry_count = 0;
}
if (empty($table->platform_post_id)) {
$table->platform_post_id = '';
}
if (empty($table->platform_response)) {
$table->platform_response = '';
}
if (empty($table->error_message)) {
$table->error_message = '';
}
} else {
$table->modified = $now;
}
}
}
@@ -65,22 +65,6 @@ class PostsModel extends ListModel
$query->where($db->quoteName('a.status') . ' = ' . $db->quote($status));
}
// Filter by service
$serviceId = $this->getState('filter.service_id');
if (!empty($serviceId)) {
$query->where($db->quoteName('a.service_id') . ' = ' . (int) $serviceId);
}
// Filter by search (article title or message content)
$search = $this->getState('filter.search');
if (!empty($search)) {
$search = '%' . $db->escape(trim($search), true) . '%';
$query->where('(' . $db->quoteName('c.title') . ' LIKE ' . $db->quote($search)
. ' OR ' . $db->quoteName('a.message') . ' LIKE ' . $db->quote($search) . ')');
}
// Ordering
$orderCol = $this->state->get('list.ordering', 'a.created');
$orderDirn = $this->state->get('list.direction', 'DESC');
@@ -1,39 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Model;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\Model\AdminModel;
class TemplateModel extends AdminModel
{
public function getForm($data = [], $loadData = true)
{
$form = $this->loadForm(
'com_mokojoomcross.template',
'template',
['control' => 'jform', 'load_data' => $loadData]
);
if (empty($form)) {
return false;
}
return $form;
}
protected function loadFormData()
{
return $this->getItem();
}
}
@@ -1,61 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Model;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\Model\ListModel;
class TemplatesModel extends ListModel
{
public function __construct($config = [])
{
if (empty($config['filter_fields'])) {
$config['filter_fields'] = [
'id', 'a.id',
'title', 'a.title',
'service_type', 'a.service_type',
'published', 'a.published',
'ordering', 'a.ordering',
];
}
parent::__construct($config);
}
protected function getListQuery()
{
$db = $this->getDatabase();
$query = $db->getQuery(true);
$query->select('a.*')
->from($db->quoteName('#__mokojoomcross_templates', 'a'));
$published = $this->getState('filter.published');
if (is_numeric($published)) {
$query->where($db->quoteName('a.published') . ' = ' . (int) $published);
}
$serviceType = $this->getState('filter.service_type');
if (!empty($serviceType)) {
$query->where($db->quoteName('a.service_type') . ' = ' . $db->quote($serviceType));
}
$orderCol = $this->state->get('list.ordering', 'a.ordering');
$orderDirn = $this->state->get('list.direction', 'ASC');
$query->order($db->escape($orderCol) . ' ' . $db->escape($orderDirn));
return $query;
}
}
@@ -70,15 +70,4 @@ interface MokoJoomCrossServiceInterface
* @return bool
*/
public function supportsMedia(): bool;
/**
* Get the media types this service supports.
*
* Return an array of supported types: 'image', 'video', 'gif', 'document'.
* Services that return an empty array are text-only.
* Default implementation returns ['image'] if supportsMedia() is true.
*
* @return string[] e.g. ['image', 'video', 'gif']
*/
public function getSupportedMediaTypes(): array;
}
@@ -1,25 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\Table;
defined('_JEXEC') or die;
use Joomla\CMS\Table\Table;
use Joomla\Database\DatabaseDriver;
class TemplateTable extends Table
{
public function __construct(DatabaseDriver $db)
{
parent::__construct('#__mokojoomcross_templates', 'id', $db);
}
}
@@ -13,53 +13,21 @@ namespace Joomla\Component\MokoJoomCross\Administrator\View\Dashboard;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Toolbar\ToolbarHelper;
use Joomla\Component\MokoJoomCross\Administrator\Helper\MokoJoomCrossHelper;
class HtmlView extends BaseHtmlView
{
protected $stats;
protected $migrationAvailable;
protected $recentActivity;
protected $serviceBreakdown;
protected $dailyTrend;
protected $topArticles;
public $sidebar;
public $period;
public function display($tpl = null): void
{
$model = $this->getModel();
// Read period parameter for date range filtering
$this->period = Factory::getApplication()->input->getInt('period', 30);
$validPeriods = [7, 30, 90, 0];
if (!in_array($this->period, $validPeriods, true)) {
$this->period = 30;
}
// Calculate the since date based on period (0 = all time)
$since = null;
if ($this->period > 0) {
$since = Factory::getDate('now - ' . $this->period . ' days')->toSql();
}
$this->stats = $this->get('Stats');
$this->stats = $this->get('Stats');
$this->migrationAvailable = $this->get('MigrationAvailable');
$this->recentActivity = $model->getRecentActivity(10);
$this->serviceBreakdown = $model->getServiceBreakdown($since);
$this->dailyTrend = $model->getDailyTrend($this->period ?: 365);
$this->topArticles = $model->getTopArticles(5, $since);
$this->addToolbar();
MokoJoomCrossHelper::addSubmenu('dashboard');
$this->sidebar = \Joomla\CMS\HTML\Sidebar::render();
parent::display($tpl);
}
@@ -14,8 +14,6 @@ namespace Joomla\Component\MokoJoomCross\Administrator\View\Logs;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
@@ -23,16 +21,12 @@ class HtmlView extends BaseHtmlView
protected $items;
protected $pagination;
protected $state;
public $filterForm;
public $activeFilters;
public function display($tpl = null): void
{
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->filterForm = $this->get('FilterForm');
$this->activeFilters = $this->get('ActiveFilters');
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->addToolbar();
@@ -43,14 +37,5 @@ class HtmlView extends BaseHtmlView
{
ToolbarHelper::title('MokoJoomCross — Activity Logs', 'share-alt');
ToolbarHelper::deleteList('JGLOBAL_CONFIRM_DELETE', 'logs.delete', 'JTOOLBAR_DELETE');
// Dashboard link in toolbar
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
}
}
@@ -1,59 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\View\Post;
defined('_JEXEC') or die;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
{
protected $form;
protected $item;
public function display($tpl = null): void
{
$this->form = $this->get('Form');
$this->item = $this->get('Item');
$this->addToolbar();
parent::display($tpl);
}
protected function addToolbar(): void
{
$isNew = empty($this->item->id);
ToolbarHelper::title(
'MokoJoomCross — ' . ($isNew ? Text::_('COM_MOKOJOOMCROSS_NEW_POST') : Text::_('COM_MOKOJOOMCROSS_EDIT_POST')),
'share-alt'
);
ToolbarHelper::apply('post.apply');
ToolbarHelper::save('post.save');
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
ToolbarHelper::cancel('post.cancel');
}
}
@@ -14,27 +14,19 @@ namespace Joomla\Component\MokoJoomCross\Administrator\View\Posts;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
use Joomla\Component\MokoJoomCross\Administrator\Helper\MokoJoomCrossHelper;
class HtmlView extends BaseHtmlView
{
protected $items;
protected $pagination;
protected $state;
public $filterForm;
public $activeFilters;
public $sidebar;
public function display($tpl = null): void
{
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->filterForm = $this->get('FilterForm');
$this->activeFilters = $this->get('ActiveFilters');
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->addToolbar();
@@ -44,39 +36,6 @@ class HtmlView extends BaseHtmlView
protected function addToolbar(): void
{
ToolbarHelper::title('MokoJoomCross — Post Queue', 'share-alt');
ToolbarHelper::addNew('post.add');
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->standardButton('retry', 'COM_MOKOJOOMCROSS_TOOLBAR_RETRY_FAILED', 'posts.retryFailed')
->icon('icon-refresh')
->listCheck(false);
$toolbar->standardButton('purge', 'COM_MOKOJOOMCROSS_TOOLBAR_PURGE_POSTED', 'posts.purgePosted')
->icon('icon-trash')
->listCheck(false);
$toolbar->standardButton('retry-selected', 'COM_MOKOJOOMCROSS_TOOLBAR_RETRY_SELECTED', 'posts.retrySelected')
->icon('icon-redo')
->listCheck(true);
$toolbar->standardButton('schedule', 'COM_MOKOJOOMCROSS_TOOLBAR_SCHEDULE', 'posts.schedule')
->icon('icon-calendar')
->listCheck(true);
ToolbarHelper::deleteList('', 'posts.delete', 'JTOOLBAR_DELETE');
// Export CSV button
$toolbar->appendButton(
'Link',
'download',
'COM_MOKOJOOMCROSS_EXPORT_CSV',
Route::_('index.php?option=com_mokojoomcross&task=posts.exportCsv&format=raw', false)
);
// Dashboard link in toolbar
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
}
}
@@ -1,61 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\View\Service;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
{
protected $form;
protected $item;
public function display($tpl = null): void
{
$this->form = $this->get('Form');
$this->item = $this->get('Item');
$this->addToolbar();
parent::display($tpl);
}
protected function addToolbar(): void
{
$isNew = empty($this->item->id);
ToolbarHelper::title(
'MokoJoomCross — ' . ($isNew ? Text::_('COM_MOKOJOOMCROSS_NEW_SERVICE') : Text::_('COM_MOKOJOOMCROSS_EDIT_SERVICE')),
'share-alt'
);
ToolbarHelper::apply('service.apply');
ToolbarHelper::save('service.save');
// Dashboard button in toolbar
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
ToolbarHelper::cancel('service.cancel');
}
}
@@ -1 +0,0 @@
<\!DOCTYPE html><title></title>
@@ -14,8 +14,6 @@ namespace Joomla\Component\MokoJoomCross\Administrator\View\Services;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
@@ -23,16 +21,12 @@ class HtmlView extends BaseHtmlView
protected $items;
protected $pagination;
protected $state;
public $filterForm;
public $activeFilters;
public function display($tpl = null): void
{
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->filterForm = $this->get('FilterForm');
$this->activeFilters = $this->get('ActiveFilters');
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->addToolbar();
@@ -47,14 +41,5 @@ class HtmlView extends BaseHtmlView
ToolbarHelper::publish('services.publish', 'JTOOLBAR_PUBLISH', true);
ToolbarHelper::unpublish('services.unpublish', 'JTOOLBAR_UNPUBLISH', true);
ToolbarHelper::deleteList('', 'services.delete', 'JTOOLBAR_DELETE');
// Dashboard link in toolbar
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
}
}
@@ -1,57 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\View\Template;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
{
protected $form;
protected $item;
public function display($tpl = null): void
{
$this->form = $this->get('Form');
$this->item = $this->get('Item');
$this->addToolbar();
parent::display($tpl);
}
protected function addToolbar(): void
{
$isNew = empty($this->item->id);
ToolbarHelper::title(
'MokoJoomCross — ' . ($isNew ? 'New Template' : 'Edit Template'),
'share-alt'
);
ToolbarHelper::apply('template.apply');
ToolbarHelper::save('template.save');
ToolbarHelper::cancel('template.cancel');
// Dashboard link in toolbar
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
}
}
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,60 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoJoomCross\Administrator\View\Templates;
defined('_JEXEC') or die;
use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Router\Route;
use Joomla\CMS\Toolbar\Toolbar;
use Joomla\CMS\Toolbar\ToolbarHelper;
class HtmlView extends BaseHtmlView
{
protected $items;
protected $pagination;
protected $state;
public $filterForm;
public $activeFilters;
public function display($tpl = null): void
{
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
$this->state = $this->get('State');
$this->filterForm = $this->get('FilterForm');
$this->activeFilters = $this->get('ActiveFilters');
$this->addToolbar();
parent::display($tpl);
}
protected function addToolbar(): void
{
ToolbarHelper::title('MokoJoomCross — Message Templates', 'share-alt');
ToolbarHelper::addNew('template.add');
ToolbarHelper::editList('template.edit');
ToolbarHelper::publish('templates.publish', 'JTOOLBAR_PUBLISH', true);
ToolbarHelper::unpublish('templates.unpublish', 'JTOOLBAR_UNPUBLISH', true);
ToolbarHelper::deleteList('', 'templates.delete', 'JTOOLBAR_DELETE');
// Dashboard link in toolbar
$toolbar = Toolbar::getInstance('toolbar');
$toolbar->appendButton(
'Link',
'home',
'COM_MOKOJOOMCROSS_SUBMENU_DASHBOARD',
Route::_('index.php?option=com_mokojoomcross&view=dashboard', false)
);
}
}
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -11,35 +11,12 @@
defined('_JEXEC') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Dashboard\HtmlView $this */
$stats = $this->stats;
$componentParams = ComponentHelper::getParams('com_mokojoomcross');
$queueProcessing = $componentParams->get('queue_processing', 'scheduler');
?>
<?php if ($queueProcessing === 'pageload' || $queueProcessing === 'both') : ?>
<div class="alert alert-warning d-flex align-items-start mb-3">
<span class="icon-exclamation-triangle me-2 mt-1" aria-hidden="true"></span>
<div>
<strong><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_PAGELOAD_WARNING_TITLE'); ?></strong><br>
<?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_PAGELOAD_WARNING'); ?>
</div>
</div>
<?php endif; ?>
<?php if ($stats->queued_count > 50) : ?>
<div class="alert alert-warning d-flex align-items-start mb-3">
<span class="icon-exclamation-triangle me-2 mt-1" aria-hidden="true"></span>
<div>
<strong><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_QUEUE_DEPTH_WARNING_TITLE'); ?></strong><br>
<?php echo Text::sprintf('COM_MOKOJOOMCROSS_DASHBOARD_QUEUE_DEPTH_WARNING', $stats->queued_count); ?>
</div>
</div>
<?php endif; ?>
<div class="row">
<div class="col-lg-9">
<div class="row">
@@ -77,71 +54,6 @@ $queueProcessing = $componentParams->get('queue_processing', 'scheduler');
</div>
</div>
<!-- Trend Chart -->
<?php if (!empty($this->dailyTrend)) : ?>
<div class="card mb-3">
<div class="card-header d-flex justify-content-between align-items-center">
<h5 class="card-title mb-0"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_TREND_CHART'); ?></h5>
<form method="get" class="d-inline">
<input type="hidden" name="option" value="com_mokojoomcross" />
<input type="hidden" name="view" value="dashboard" />
<select name="period" class="form-select form-select-sm" style="width: auto; display: inline-block;" onchange="this.form.submit();">
<option value="7" <?php echo $this->period == 7 ? 'selected' : ''; ?>><?php echo Text::_('COM_MOKOJOOMCROSS_PERIOD_7_DAYS'); ?></option>
<option value="30" <?php echo $this->period == 30 ? 'selected' : ''; ?>><?php echo Text::_('COM_MOKOJOOMCROSS_PERIOD_30_DAYS'); ?></option>
<option value="90" <?php echo $this->period == 90 ? 'selected' : ''; ?>><?php echo Text::_('COM_MOKOJOOMCROSS_PERIOD_90_DAYS'); ?></option>
<option value="0" <?php echo $this->period == 0 ? 'selected' : ''; ?>><?php echo Text::_('COM_MOKOJOOMCROSS_PERIOD_ALL_TIME'); ?></option>
</select>
</form>
</div>
<div class="card-body">
<canvas id="trendChart" height="80"></canvas>
</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.7/dist/chart.umd.min.js" integrity="sha384-UPIssOjNMqMfON6mDKHvO4sOY4hhxN1ymYcfl2MrDz69idMU/L3MNFlyJGlIRjQH" crossorigin="anonymous">
<script>
document.addEventListener('DOMContentLoaded', function() {
var trendData = <?php echo json_encode($this->dailyTrend); ?>;
var labels = trendData.map(function(d) { return d.day; });
var posted = trendData.map(function(d) { return parseInt(d.posted, 10); });
var failed = trendData.map(function(d) { return parseInt(d.failed, 10); });
new Chart(document.getElementById('trendChart'), {
type: 'line',
data: {
labels: labels,
datasets: [
{
label: '<?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_POSTED', true); ?>',
data: posted,
borderColor: '#198754',
backgroundColor: 'rgba(25, 135, 84, 0.1)',
fill: true,
tension: 0.3
},
{
label: '<?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_FAILED', true); ?>',
data: failed,
borderColor: '#dc3545',
backgroundColor: 'rgba(220, 53, 69, 0.1)',
fill: true,
tension: 0.3
}
]
},
options: {
responsive: true,
scales: {
y: { beginAtZero: true, ticks: { stepSize: 1 } }
},
plugins: {
legend: { position: 'bottom' }
}
}
});
});
</script>
<?php endif; ?>
<?php if ($this->migrationAvailable) : ?>
<div class="alert alert-info">
<h4 class="alert-heading"><?php echo Text::_('COM_MOKOJOOMCROSS_MIGRATION_TITLE'); ?></h4>
@@ -152,107 +64,6 @@ $queueProcessing = $componentParams->get('queue_processing', 'scheduler');
</a>
</div>
<?php endif; ?>
<!-- Analytics: Service Breakdown -->
<?php if (!empty($this->serviceBreakdown)) : ?>
<div class="card mt-3">
<div class="card-header">
<h5 class="card-title mb-0"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_SERVICE_BREAKDOWN'); ?></h5>
</div>
<div class="card-body">
<table class="table table-sm table-striped mb-0">
<thead>
<tr>
<th><?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_SERVICE'); ?></th>
<th class="text-center text-success"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_POSTED'); ?></th>
<th class="text-center text-danger"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_FAILED'); ?></th>
<th class="text-center text-warning"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_QUEUED'); ?></th>
<th class="text-center"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_TOTAL_POSTS'); ?></th>
<th class="text-center"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_SUCCESS_RATE'); ?></th>
</tr>
</thead>
<tbody>
<?php foreach ($this->serviceBreakdown as $row) :
$rate = $row['total'] > 0 ? round(($row['posted'] / $row['total']) * 100) : 0;
$rateClass = $rate >= 80 ? 'text-success' : ($rate >= 50 ? 'text-warning' : 'text-danger');
?>
<tr>
<td><?php echo htmlspecialchars($row['service_title'] . ' (' . ucfirst($row['service_type']) . ')'); ?></td>
<td class="text-center"><span class="badge bg-success"><?php echo (int) $row['posted']; ?></span></td>
<td class="text-center"><span class="badge bg-danger"><?php echo (int) $row['failed']; ?></span></td>
<td class="text-center"><span class="badge bg-warning text-dark"><?php echo (int) $row['queued']; ?></span></td>
<td class="text-center"><?php echo (int) $row['total']; ?></td>
<td class="text-center <?php echo $rateClass; ?> fw-bold"><?php echo $rate; ?>%</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
</div>
<?php endif; ?>
<!-- Analytics: Top Articles -->
<?php if (!empty($this->topArticles)) : ?>
<div class="card mt-3">
<div class="card-header">
<h5 class="card-title mb-0"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_TOP_ARTICLES'); ?></h5>
</div>
<div class="card-body p-0">
<div class="list-group list-group-flush">
<?php foreach ($this->topArticles as $row) : ?>
<div class="list-group-item d-flex justify-content-between align-items-center">
<span><?php echo htmlspecialchars($row['title']); ?></span>
<span>
<span class="badge bg-success"><?php echo (int) $row['success_count']; ?></span>
/
<span class="badge bg-secondary"><?php echo (int) $row['post_count']; ?></span>
</span>
</div>
<?php endforeach; ?>
</div>
</div>
</div>
<?php endif; ?>
<!-- Recent Activity -->
<div class="card mt-3">
<div class="card-header">
<h5 class="card-title mb-0"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_RECENT_ACTIVITY'); ?></h5>
</div>
<div class="card-body p-0">
<?php if (empty($this->recentActivity)) : ?>
<p class="p-3 mb-0 text-muted"><?php echo Text::_('COM_MOKOJOOMCROSS_DASHBOARD_NO_RECENT'); ?></p>
<?php else : ?>
<div class="list-group list-group-flush">
<?php foreach ($this->recentActivity as $entry) :
$levelClass = match ($entry->level) {
'error' => 'text-danger',
'warning' => 'text-warning',
default => 'text-muted',
};
$levelIcon = match ($entry->level) {
'error' => 'icon-times-circle',
'warning' => 'icon-exclamation-triangle',
default => 'icon-info-circle',
};
?>
<div class="list-group-item">
<div class="d-flex w-100 justify-content-between">
<span class="<?php echo $levelClass; ?>">
<span class="<?php echo $levelIcon; ?>" aria-hidden="true"></span>
<?php echo htmlspecialchars(mb_substr($entry->message, 0, 120)); ?>
</span>
<small class="text-muted"><?php echo \Joomla\CMS\HTML\HTMLHelper::_('date', $entry->created, 'Y-m-d H:i'); ?></small>
</div>
<?php if ($entry->service_title) : ?>
<small class="text-muted"><?php echo htmlspecialchars($entry->service_title); ?></small>
<?php endif; ?>
</div>
<?php endforeach; ?>
</div>
<?php endif; ?>
</div>
</div>
</div>
<div class="col-lg-3">
@@ -268,10 +79,6 @@ $queueProcessing = $componentParams->get('queue_processing', 'scheduler');
class="list-group-item list-group-item-action">
<?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_POSTS'); ?>
</a>
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&view=templates'); ?>"
class="list-group-item list-group-item-action">
<?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES'); ?>
</a>
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&view=logs'); ?>"
class="list-group-item list-group-item-action">
<?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_LOGS'); ?>
@@ -1,110 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Layout\LayoutHelper;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Logs\HtmlView $this */
HTMLHelper::_('behavior.multiselect');
$listOrder = $this->escape($this->state->get('list.ordering'));
$listDirn = $this->escape($this->state->get('list.direction'));
$levelBadges = [
'info' => 'bg-info',
'warning' => 'bg-warning text-dark',
'error' => 'bg-danger',
];
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&view=logs'); ?>" method="post" name="adminForm" id="adminForm">
<div class="row">
<div class="col-md-12">
<div id="j-main-container" class="j-main-container">
<?php echo LayoutHelper::render('joomla.searchtools.default', ['view' => $this]); ?>
<?php if (empty($this->items)) : ?>
<div class="alert alert-info">
<span class="icon-info-circle" aria-hidden="true"></span>
<?php echo Text::_('JGLOBAL_NO_MATCHING_RESULTS'); ?>
</div>
<?php else : ?>
<table class="table" id="logsList">
<caption class="visually-hidden"><?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_LOGS'); ?></caption>
<thead>
<tr>
<td class="w-1 text-center">
<?php echo HTMLHelper::_('grid.checkall'); ?>
</td>
<th scope="col" class="w-10">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_LEVEL'); ?>
</th>
<th scope="col">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_MESSAGE'); ?>
</th>
<th scope="col" class="w-15 d-none d-md-table-cell">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_SERVICE'); ?>
</th>
<th scope="col" class="w-10">
<?php echo HTMLHelper::_('searchtools.sort', 'COM_MOKOJOOMCROSS_HEADING_CREATED', 'a.created', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-5 text-center d-none d-md-table-cell">
<?php echo Text::_('JGRID_HEADING_ID'); ?>
</th>
</tr>
</thead>
<tbody>
<?php foreach ($this->items as $i => $item) :
$badgeClass = $levelBadges[$item->level] ?? 'bg-secondary';
?>
<tr class="row<?php echo $i % 2; ?>">
<td class="text-center">
<?php echo HTMLHelper::_('grid.id', $i, $item->id, false, 'cid', 'cb', ''); ?>
</td>
<td>
<span class="badge <?php echo $badgeClass; ?>">
<?php echo $this->escape(ucfirst($item->level)); ?>
</span>
</td>
<td>
<?php echo $this->escape($item->message); ?>
<?php if (!empty($item->context) && $item->context !== '{}') : ?>
<br><small class="text-muted"><code><?php echo $this->escape(mb_substr($item->context, 0, 200)); ?></code></small>
<?php endif; ?>
</td>
<td class="d-none d-md-table-cell">
<?php echo $this->escape($item->service_title ?? '—'); ?>
</td>
<td>
<?php echo HTMLHelper::_('date', $item->created, 'Y-m-d H:i:s'); ?>
</td>
<td class="text-center d-none d-md-table-cell">
<?php echo (int) $item->id; ?>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php echo $this->pagination->getListFooter(); ?>
<?php endif; ?>
<input type="hidden" name="task" value="">
<input type="hidden" name="boxchecked" value="0">
<?php echo HTMLHelper::_('form.token'); ?>
</div>
</div>
</div>
</form>
@@ -1,79 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Post\HtmlView $this */
HTMLHelper::_('behavior.formvalidator');
HTMLHelper::_('behavior.keepalive');
$postId = (int) ($this->item->id ?? 0);
$isNew = empty($postId);
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&layout=edit&id=' . $postId); ?>"
method="post" name="adminForm" id="adminForm" class="form-validate">
<div class="main-card">
<div class="row">
<div class="col-lg-8">
<h3><?php echo Text::_($isNew ? 'COM_MOKOJOOMCROSS_NEW_POST' : 'COM_MOKOJOOMCROSS_EDIT_POST'); ?></h3>
<?php if ($isNew) : ?>
<div class="alert alert-info">
<span class="icon-info-circle" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_POST_CREATE_HELP'); ?>
</div>
<?php endif; ?>
<?php echo $this->form->renderFieldset('details'); ?>
</div>
<div class="col-lg-4">
<?php if (!$isNew) : ?>
<div class="card">
<div class="card-header">
<h5 class="card-title mb-0">
<span class="icon-chart-bar" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_POST_RESULTS'); ?>
</h5>
</div>
<div class="card-body">
<?php echo $this->form->renderFieldset('readonly'); ?>
</div>
</div>
<?php
$status = $this->item->status ?? '';
if (in_array($status, ['failed', 'posted'])) : ?>
<div class="card mt-3">
<div class="card-body text-center">
<p class="text-muted mb-2"><?php echo Text::_('COM_MOKOJOOMCROSS_POST_REQUEUE_HELP'); ?></p>
<button type="button" class="btn btn-warning w-100"
onclick="document.getElementById('jform_status').value='queued'; Joomla.submitbutton('post.apply');">
<span class="icon-refresh" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_POST_REQUEUE'); ?>
</button>
</div>
</div>
<?php endif; ?>
<?php endif; ?>
</div>
</div>
</div>
<input type="hidden" name="task" value="">
<?php echo HTMLHelper::_('form.token'); ?>
</form>
@@ -1,136 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Layout\LayoutHelper;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Posts\HtmlView $this */
HTMLHelper::_('behavior.multiselect');
$listOrder = $this->escape($this->state->get('list.ordering'));
$listDirn = $this->escape($this->state->get('list.direction'));
$statusBadges = [
'queued' => 'bg-warning text-dark',
'posting' => 'bg-info',
'posted' => 'bg-success',
'failed' => 'bg-danger',
'scheduled' => 'bg-secondary',
];
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&view=posts'); ?>" method="post" name="adminForm" id="adminForm">
<div class="row">
<div class="col-md-12">
<div id="j-main-container" class="j-main-container">
<?php echo LayoutHelper::render('joomla.searchtools.default', ['view' => $this]); ?>
<?php if (empty($this->items)) : ?>
<div class="alert alert-info">
<span class="icon-info-circle" aria-hidden="true"></span>
<?php echo Text::_('JGLOBAL_NO_MATCHING_RESULTS'); ?>
</div>
<?php else : ?>
<table class="table" id="postsList">
<caption class="visually-hidden"><?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_POSTS'); ?></caption>
<thead>
<tr>
<td class="w-1 text-center">
<?php echo HTMLHelper::_('grid.checkall'); ?>
</td>
<th scope="col" class="w-10">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_STATUS'); ?>
</th>
<th scope="col">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_ARTICLE'); ?>
</th>
<th scope="col" class="w-15">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_SERVICE'); ?>
</th>
<th scope="col" class="w-15 d-none d-md-table-cell">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_MESSAGE'); ?>
</th>
<th scope="col" class="w-10 d-none d-md-table-cell">
<?php echo HTMLHelper::_('searchtools.sort', 'COM_MOKOJOOMCROSS_HEADING_POSTED_AT', 'a.posted_at', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-10 d-none d-lg-table-cell">
<?php echo HTMLHelper::_('searchtools.sort', 'COM_MOKOJOOMCROSS_HEADING_CREATED', 'a.created', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-5 text-center d-none d-md-table-cell">
<?php echo Text::_('JGRID_HEADING_ID'); ?>
</th>
</tr>
</thead>
<tbody>
<?php foreach ($this->items as $i => $item) :
$badgeClass = $statusBadges[$item->status] ?? 'bg-secondary';
?>
<tr class="row<?php echo $i % 2; ?>">
<td class="text-center">
<?php echo HTMLHelper::_('grid.id', $i, $item->id, false, 'cid', 'cb', $item->article_title ?? ''); ?>
</td>
<td>
<span class="badge <?php echo $badgeClass; ?>">
<?php echo $this->escape(ucfirst($item->status)); ?>
</span>
<?php if ($item->status === 'failed' && !empty($item->error_message)) : ?>
<br><small class="text-danger"><?php echo $this->escape(mb_substr($item->error_message, 0, 80)); ?></small>
<?php endif; ?>
<?php if ($item->retry_count > 0) : ?>
<br><small class="text-muted">Retries: <?php echo (int) $item->retry_count; ?></small>
<?php endif; ?>
</td>
<td>
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&task=post.edit&id=' . (int) $item->id); ?>">
<?php echo $this->escape($item->article_title ?? 'Article #' . $item->article_id); ?>
</a>
<?php if (!empty($item->scheduled_at)) : ?>
<br><small class="text-info"><span class="icon-clock" aria-hidden="true"></span> <?php echo HTMLHelper::_('date', $item->scheduled_at, 'Y-m-d H:i'); ?></small>
<?php endif; ?>
</td>
<td>
<?php echo $this->escape($item->service_title ?? ''); ?>
<br><small class="text-muted"><?php echo $this->escape($item->service_type ?? ''); ?></small>
</td>
<td class="d-none d-md-table-cell">
<small><?php echo $this->escape(mb_substr($item->message ?? '', 0, 100)); ?></small>
<?php if (!empty($item->platform_post_id)) : ?>
<br><small class="text-success">ID: <?php echo $this->escape($item->platform_post_id); ?></small>
<?php endif; ?>
</td>
<td class="d-none d-md-table-cell">
<?php echo $item->posted_at ? HTMLHelper::_('date', $item->posted_at, 'Y-m-d H:i') : '—'; ?>
</td>
<td class="d-none d-lg-table-cell">
<?php echo HTMLHelper::_('date', $item->created, 'Y-m-d H:i'); ?>
</td>
<td class="text-center d-none d-md-table-cell">
<?php echo (int) $item->id; ?>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php echo $this->pagination->getListFooter(); ?>
<?php endif; ?>
<input type="hidden" name="task" value="">
<input type="hidden" name="boxchecked" value="0">
<?php echo HTMLHelper::_('form.token'); ?>
</div>
</div>
</div>
</form>
@@ -1,216 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Service\HtmlView $this */
HTMLHelper::_('behavior.formvalidator');
HTMLHelper::_('behavior.keepalive');
$serviceType = $this->item->service_type ?? '';
$serviceId = (int) ($this->item->id ?? 0);
// Services that support OAuth authorize flow
$oauthServices = ['facebook', 'linkedin', 'twitter', 'threads', 'pinterest', 'tumblr', 'tiktok', 'constantcontact', 'blogger', 'googlebusiness'];
$showAuthorize = in_array($serviceType, $oauthServices) && $serviceId > 0;
// Map service types to KB article aliases on mokoconsulting.tech
$helpArticles = [
'facebook' => 'service-facebook-mokojoomcross',
'twitter' => 'service-twitter-mokojoomcross',
'linkedin' => 'service-linkedin-mokojoomcross',
'mastodon' => 'service-mastodon-mokojoomcross',
'bluesky' => 'service-bluesky-mokojoomcross',
'threads' => 'service-threads-mokojoomcross',
'pinterest' => 'service-pinterest-mokojoomcross',
'reddit' => 'service-reddit-mokojoomcross',
'tumblr' => 'service-tumblr-mokojoomcross',
'tiktok' => 'service-tiktok-mokojoomcross',
'nostr' => 'service-nostr-mokojoomcross',
'activitypub' => 'service-activitypub-mokojoomcross',
'telegram' => 'service-telegram-mokojoomcross',
'discord' => 'service-discord-mokojoomcross',
'slack' => 'service-slack-mokojoomcross',
'teams' => 'service-teams-mokojoomcross',
'googlechat' => 'service-googlechat-mokojoomcross',
'whatsapp' => 'service-whatsapp-mokojoomcross',
'matrix' => 'service-matrix-mokojoomcross',
'ntfy' => 'service-ntfy-mokojoomcross',
'mailchimp' => 'service-mailchimp-mokojoomcross',
'sendgrid' => 'service-sendgrid-mokojoomcross',
'brevo' => 'service-brevo-mokojoomcross',
'convertkit' => 'service-convertkit-mokojoomcross',
'constantcontact' => 'service-constantcontact-mokojoomcross',
'medium' => 'service-medium-mokojoomcross',
'wordpress' => 'service-wordpress-mokojoomcross',
'devto' => 'service-devto-mokojoomcross',
'ghost' => 'service-ghost-mokojoomcross',
'hashnode' => 'service-hashnode-mokojoomcross',
'blogger' => 'service-blogger-mokojoomcross',
'googlebusiness' => 'service-googlebusiness-mokojoomcross',
'webhook' => 'service-webhook-mokojoomcross',
'rssfeed' => 'service-rssfeed-mokojoomcross',
];
$helpAlias = $helpArticles[$serviceType] ?? '';
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&layout=edit&id=' . $serviceId); ?>"
method="post" name="adminForm" id="adminForm" class="form-validate">
<div class="main-card">
<div class="row">
<div class="col-lg-8">
<h3><?php echo Text::_('COM_MOKOJOOMCROSS_SERVICE_DETAILS'); ?></h3>
<?php echo $this->form->renderFieldset('details'); ?>
<hr>
<h3><?php echo Text::_('COM_MOKOJOOMCROSS_FIELDSET_CREDENTIALS'); ?></h3>
<p class="text-muted">
<?php echo Text::_('COM_MOKOJOOMCROSS_CREDENTIALS_HELP'); ?>
</p>
<?php echo $this->form->renderFieldset('credentials'); ?>
<?php if ($showAuthorize) : ?>
<div class="mt-3">
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&task=oauth.authorize&service_id=' . $serviceId); ?>"
class="btn btn-primary btn-lg">
<span class="icon-key" aria-hidden="true"></span>
<?php echo Text::sprintf('COM_MOKOJOOMCROSS_AUTHORIZE_BUTTON', ucfirst($serviceType)); ?>
</a>
<p class="form-text mt-2">
<?php echo Text::_('COM_MOKOJOOMCROSS_AUTHORIZE_HELP'); ?>
</p>
</div>
<?php endif; ?>
</div>
<div class="col-lg-4">
<div class="card">
<div class="card-header bg-info text-white">
<h5 class="card-title mb-0">
<span class="icon-question-circle" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_HELP_TITLE'); ?>
</h5>
</div>
<div class="card-body">
<p><?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_HELP_INTRO'); ?></p>
<ol class="mb-0">
<li><?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_STEP1'); ?></li>
<li><?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_STEP2'); ?></li>
<li><?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_STEP3'); ?></li>
<li><?php echo Text::_('COM_MOKOJOOMCROSS_SETUP_STEP4'); ?></li>
</ol>
</div>
</div>
<?php if (!empty($helpAlias)) : ?>
<div class="card mt-3">
<div class="card-body text-center">
<a href="https://mokoconsulting.tech/kb/mokojoomcross/<?php echo $helpAlias; ?>"
target="_blank" rel="noopener"
class="btn btn-outline-info w-100">
<span class="icon-book" aria-hidden="true"></span>
<?php echo Text::sprintf('COM_MOKOJOOMCROSS_SERVICE_HELP_LINK', ucfirst($serviceType)); ?>
</a>
</div>
</div>
<?php endif; ?>
<?php if ($showAuthorize) : ?>
<div class="card mt-3">
<div class="card-header bg-warning text-dark">
<h5 class="card-title mb-0">
<span class="icon-lock" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_OAUTH_HELP_TITLE'); ?>
</h5>
</div>
<div class="card-body">
<p><?php echo Text::_('COM_MOKOJOOMCROSS_OAUTH_HELP_BODY'); ?></p>
</div>
</div>
<?php endif; ?>
<?php if ($serviceId > 0 && !empty($serviceType)) : ?>
<div class="card mt-3">
<div class="card-header bg-secondary text-white">
<h5 class="card-title mb-0">
<span class="icon-plug" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_TITLE'); ?>
</h5>
</div>
<div class="card-body">
<p><?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_DESC'); ?></p>
<button type="button" id="btn-test-connection" class="btn btn-outline-primary w-100">
<span class="icon-broadcast" aria-hidden="true"></span>
<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_BUTTON'); ?>
</button>
<div id="test-connection-result" class="mt-2" style="display:none;"></div>
</div>
</div>
<script>
document.getElementById('btn-test-connection').addEventListener('click', function() {
var btn = this;
var resultDiv = document.getElementById('test-connection-result');
btn.disabled = true;
btn.textContent = '<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_TESTING'); ?>';
resultDiv.style.display = 'none';
var url = 'index.php?option=com_mokojoomcross&task=service.testConnection&id=<?php echo $serviceId; ?>&format=json';
fetch(url, {
method: 'POST',
headers: {
'X-CSRF-Token': Joomla.getOptions('csrf.token') || '1'
}
})
.then(function(response) { return response.json(); })
.then(function(json) {
resultDiv.style.display = 'block';
resultDiv.textContent = '';
if (json.success) {
var data = json.data || {};
var accountName = data.account_name || '';
var msg = '<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_SUCCESS'); ?>';
if (accountName) {
msg += ' \u2014 ' + accountName;
}
resultDiv.className = 'mt-2 alert alert-success';
resultDiv.textContent = msg;
} else {
resultDiv.className = 'mt-2 alert alert-danger';
resultDiv.textContent = json.message || '<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_FAILED'); ?>';
}
})
.catch(function() {
resultDiv.style.display = 'block';
resultDiv.className = 'mt-2 alert alert-danger';
resultDiv.textContent = '<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_ERROR'); ?>';
})
.finally(function() {
btn.disabled = false;
btn.textContent = '<?php echo Text::_('COM_MOKOJOOMCROSS_TEST_CONNECTION_BUTTON'); ?>';
});
});
</script>
<?php endif; ?>
</div>
</div>
</div>
<input type="hidden" name="task" value="">
<?php echo HTMLHelper::_('form.token'); ?>
</form>
@@ -1 +0,0 @@
<\!DOCTYPE html><title></title>
@@ -1,120 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Layout\LayoutHelper;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Services\HtmlView $this */
HTMLHelper::_('behavior.multiselect');
$listOrder = $this->escape($this->state->get('list.ordering'));
$listDirn = $this->escape($this->state->get('list.direction'));
$serviceIcons = [
'facebook' => 'icon-facebook',
'twitter' => 'icon-twitter',
'linkedin' => 'icon-linkedin',
'mastodon' => 'icon-globe',
'bluesky' => 'icon-cloud',
'mailchimp' => 'icon-envelope',
'telegram' => 'icon-comment',
'discord' => 'icon-comments',
'slack' => 'icon-comments-2',
];
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&view=services'); ?>" method="post" name="adminForm" id="adminForm">
<div class="row">
<div class="col-md-12">
<div id="j-main-container" class="j-main-container">
<?php echo LayoutHelper::render('joomla.searchtools.default', ['view' => $this]); ?>
<?php if (empty($this->items)) : ?>
<div class="alert alert-info">
<span class="icon-info-circle" aria-hidden="true"></span>
<?php echo Text::_('JGLOBAL_NO_MATCHING_RESULTS'); ?>
</div>
<?php else : ?>
<table class="table" id="servicesList">
<caption class="visually-hidden"><?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_SERVICES'); ?></caption>
<thead>
<tr>
<td class="w-1 text-center">
<?php echo HTMLHelper::_('grid.checkall'); ?>
</td>
<th scope="col" class="w-1 text-center">
<?php echo HTMLHelper::_('searchtools.sort', 'JSTATUS', 'a.published', $listDirn, $listOrder); ?>
</th>
<th scope="col">
<?php echo HTMLHelper::_('searchtools.sort', 'JGLOBAL_TITLE', 'a.title', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-15">
<?php echo HTMLHelper::_('searchtools.sort', 'COM_MOKOJOOMCROSS_FIELD_SERVICE_TYPE', 'a.service_type', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-10 text-center d-none d-md-table-cell">
<?php echo Text::_('COM_MOKOJOOMCROSS_HEADING_MODE'); ?>
</th>
<th scope="col" class="w-5 text-center d-none d-md-table-cell">
<?php echo HTMLHelper::_('searchtools.sort', 'JGRID_HEADING_ID', 'a.id', $listDirn, $listOrder); ?>
</th>
</tr>
</thead>
<tbody>
<?php foreach ($this->items as $i => $item) :
$credentials = json_decode($item->credentials ?: '{}', true) ?: [];
$mode = $credentials['mode'] ?? 'custom';
$icon = $serviceIcons[$item->service_type] ?? 'icon-cog';
?>
<tr class="row<?php echo $i % 2; ?>">
<td class="text-center">
<?php echo HTMLHelper::_('grid.id', $i, $item->id, false, 'cid', 'cb', $item->title); ?>
</td>
<td class="text-center">
<?php echo HTMLHelper::_('jgrid.published', $item->published, $i, 'services.', true); ?>
</td>
<td>
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&task=service.edit&id=' . $item->id); ?>">
<?php echo $this->escape($item->title); ?>
</a>
</td>
<td>
<span class="<?php echo $icon; ?>" aria-hidden="true"></span>
<?php echo $this->escape(ucfirst($item->service_type)); ?>
</td>
<td class="text-center d-none d-md-table-cell">
<?php if ($mode === 'default') : ?>
<span class="badge bg-primary">Default Bot</span>
<?php else : ?>
<span class="badge bg-secondary">Custom</span>
<?php endif; ?>
</td>
<td class="text-center d-none d-md-table-cell">
<?php echo (int) $item->id; ?>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php echo $this->pagination->getListFooter(); ?>
<?php endif; ?>
<input type="hidden" name="task" value="">
<input type="hidden" name="boxchecked" value="0">
<?php echo HTMLHelper::_('form.token'); ?>
</div>
</div>
</div>
</form>
@@ -1,44 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
/** @var \Joomla\CMS\Form\Form $this->form */
HTMLHelper::_('behavior.formvalidator');
HTMLHelper::_('behavior.keepalive');
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&layout=edit&id=' . (int) $this->item->id); ?>"
method="post" name="adminForm" id="adminForm" class="form-validate">
<div class="main-card">
<div class="row">
<div class="col-lg-9">
<?php echo $this->form->renderFieldset('details'); ?>
</div>
<div class="col-lg-3">
<div class="card">
<div class="card-body">
<h4><?php echo Text::_('COM_MOKOJOOMCROSS_FIELDSET_CREDENTIALS'); ?></h4>
<?php echo $this->form->renderFieldset('credentials'); ?>
</div>
</div>
</div>
</div>
</div>
<input type="hidden" name="task" value="">
<?php echo HTMLHelper::_('form.token'); ?>
</form>
@@ -1,57 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Template\HtmlView $this */
HTMLHelper::_('behavior.formvalidator');
HTMLHelper::_('behavior.keepalive');
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&layout=edit&id=' . (int) ($this->item->id ?? 0)); ?>"
method="post" name="adminForm" id="adminForm" class="form-validate">
<div class="main-card">
<div class="row">
<div class="col-lg-8">
<?php echo $this->form->renderFieldset('details'); ?>
</div>
<div class="col-lg-4">
<div class="card">
<div class="card-header">
<h5 class="card-title mb-0"><?php echo Text::_('COM_MOKOJOOMCROSS_TEMPLATE_PLACEHOLDERS'); ?></h5>
</div>
<div class="card-body">
<table class="table table-sm table-striped">
<tbody>
<tr><td><code>{title}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_TITLE'); ?></td></tr>
<tr><td><code>{url}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_URL'); ?></td></tr>
<tr><td><code>{introtext}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_INTROTEXT'); ?></td></tr>
<tr><td><code>{fulltext}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_FULLTEXT'); ?></td></tr>
<tr><td><code>{image}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_IMAGE'); ?></td></tr>
<tr><td><code>{category}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_CATEGORY'); ?></td></tr>
<tr><td><code>{author}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_AUTHOR'); ?></td></tr>
<tr><td><code>{date}</code></td><td><?php echo Text::_('COM_MOKOJOOMCROSS_PLACEHOLDER_DATE'); ?></td></tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
</div>
<input type="hidden" name="task" value="">
<?php echo HTMLHelper::_('form.token'); ?>
</form>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,103 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage com_mokojoomcross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Layout\LayoutHelper;
use Joomla\CMS\Router\Route;
/** @var \Joomla\Component\MokoJoomCross\Administrator\View\Templates\HtmlView $this */
HTMLHelper::_('behavior.multiselect');
$listOrder = $this->escape($this->state->get('list.ordering'));
$listDirn = $this->escape($this->state->get('list.direction'));
?>
<form action="<?php echo Route::_('index.php?option=com_mokojoomcross&view=templates'); ?>" method="post" name="adminForm" id="adminForm">
<div class="row">
<div class="col-md-12">
<div id="j-main-container" class="j-main-container">
<?php echo LayoutHelper::render('joomla.searchtools.default', ['view' => $this]); ?>
<?php if (empty($this->items)) : ?>
<div class="alert alert-info">
<span class="icon-info-circle" aria-hidden="true"></span>
<?php echo Text::_('JGLOBAL_NO_MATCHING_RESULTS'); ?>
</div>
<?php else : ?>
<table class="table" id="templatesList">
<caption class="visually-hidden"><?php echo Text::_('COM_MOKOJOOMCROSS_SUBMENU_TEMPLATES'); ?></caption>
<thead>
<tr>
<td class="w-1 text-center">
<?php echo HTMLHelper::_('grid.checkall'); ?>
</td>
<th scope="col" class="w-1 text-center">
<?php echo HTMLHelper::_('searchtools.sort', 'JSTATUS', 'a.published', $listDirn, $listOrder); ?>
</th>
<th scope="col">
<?php echo HTMLHelper::_('searchtools.sort', 'JGLOBAL_TITLE', 'a.title', $listDirn, $listOrder); ?>
</th>
<th scope="col" class="w-15">
<?php echo Text::_('COM_MOKOJOOMCROSS_FIELD_SERVICE_TYPE'); ?>
</th>
<th scope="col" class="d-none d-md-table-cell">
<?php echo Text::_('COM_MOKOJOOMCROSS_TEMPLATE_PREVIEW'); ?>
</th>
<th scope="col" class="w-5 text-center d-none d-md-table-cell">
<?php echo Text::_('JGRID_HEADING_ID'); ?>
</th>
</tr>
</thead>
<tbody>
<?php foreach ($this->items as $i => $item) : ?>
<tr class="row<?php echo $i % 2; ?>">
<td class="text-center">
<?php echo HTMLHelper::_('grid.id', $i, $item->id, false, 'cid', 'cb', $item->title); ?>
</td>
<td class="text-center">
<?php echo HTMLHelper::_('jgrid.published', $item->published, $i, 'templates.', true); ?>
</td>
<td>
<a href="<?php echo Route::_('index.php?option=com_mokojoomcross&task=template.edit&id=' . $item->id); ?>">
<?php echo $this->escape($item->title); ?>
</a>
</td>
<td>
<?php if ($item->service_type === 'default') : ?>
<span class="badge bg-primary">Default</span>
<?php else : ?>
<?php echo $this->escape(ucfirst($item->service_type)); ?>
<?php endif; ?>
</td>
<td class="d-none d-md-table-cell">
<code class="small"><?php echo $this->escape(mb_substr($item->template_body, 0, 80)); ?></code>
</td>
<td class="text-center d-none d-md-table-cell">
<?php echo (int) $item->id; ?>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php echo $this->pagination->getListFooter(); ?>
<?php endif; ?>
<input type="hidden" name="task" value="">
<input type="hidden" name="boxchecked" value="0">
<?php echo HTMLHelper::_('form.token'); ?>
</div>
</div>
</div>
</form>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,12 +1,2 @@
PLG_CONTENT_MOKOJOOMCROSS="Content - MokoJoomCross"
PLG_CONTENT_MOKOJOOMCROSS_DESCRIPTION="Adds cross-post status badges and per-article service selection to the article editor."
PLG_CONTENT_MOKOJOOMCROSS_FIELDSET_CROSSPOST="Cross-Posting"
PLG_CONTENT_MOKOJOOMCROSS_SKIP="Skip Cross-Posting"
PLG_CONTENT_MOKOJOOMCROSS_SKIP_DESC="Skip all cross-posting for this article."
PLG_CONTENT_MOKOJOOMCROSS_SERVICES="Post to Services"
PLG_CONTENT_MOKOJOOMCROSS_SERVICES_DESC="Select which services to cross-post to. Leave all unchecked to post to all enabled services."
PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN="Evergreen Content"
PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_DESC="Automatically re-share this article on a recurring schedule. Great for high-value content that stays relevant."
PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_INTERVAL="Re-share Interval (days)"
PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_INTERVAL_DESC="How many days to wait between automatic re-shares. Default: 30 days."
PLG_CONTENT_MOKOJOOMCROSS_DESCRIPTION="Adds cross-post status badges to articles in the admin backend."
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="content" method="upgrade">
<name>Content - MokoJoomCross</name>
<version>01.00.06-dev</version>
<version>01.00.00-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -13,157 +13,34 @@ namespace Joomla\Plugin\Content\MokoJoomCross\Extension;
defined('_JEXEC') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Event\Model\PrepareFormEvent;
use Joomla\CMS\Factory;
use Joomla\CMS\Form\Form;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoJoomCross\Administrator\Helper\CrossPostDispatcher;
use Joomla\Event\SubscriberInterface;
/**
* Content plugin that:
* 1. Adds cross-post status badges to article views in admin
* 2. Injects service selection checkboxes into the article editor (#19)
* Content plugin that adds cross-post status badges to article views.
*/
class MokoJoomCrossContent extends CMSPlugin implements SubscriberInterface
{
public static function getSubscribedEvents(): array
{
return [
'onContentBeforeDisplay' => 'onContentBeforeDisplay',
'onContentPrepareForm' => 'onContentPrepareForm',
'onContentAfterSave' => 'onContentAfterSave',
'onContentChangeState' => 'onContentChangeState',
'onContentBeforeDisplay' => 'onContentBeforeDisplay',
];
}
/**
* Inject cross-post service selection fields into article edit form.
* Add cross-post status indicator before article content in admin.
*
* Adds a "Cross-Posting" fieldset to the article attribs tab with:
* - Checkbox list of all enabled services
* - Skip cross-posting toggle
*/
/**
* Joomla 5/6 compatible — accepts both PrepareFormEvent and legacy Form signature.
*/
public function onContentPrepareForm($event): void
{
// Joomla 5+ passes PrepareFormEvent; extract the Form from it
if ($event instanceof PrepareFormEvent) {
$form = $event->getForm();
} elseif ($event instanceof Form) {
$form = $event;
} else {
return;
}
if ($form->getName() !== 'com_content.article') {
return;
}
$app = $this->getApplication();
if (!$app->isClient('administrator')) {
return;
}
$db = Factory::getDbo();
// Load enabled services for the checkbox list
$query = $db->getQuery(true)
->select('id, title, service_type')
->from($db->quoteName('#__mokojoomcross_services'))
->where($db->quoteName('published') . ' = 1')
->order($db->quoteName('ordering') . ' ASC');
$db->setQuery($query);
$services = $db->loadObjectList();
if (empty($services)) {
return;
}
// Build dynamic XML form for the attribs fieldset
$options = '';
foreach ($services as $svc) {
$label = htmlspecialchars($svc->title . ' (' . ucfirst($svc->service_type) . ')', ENT_XML1);
$options .= '<option value="' . (int) $svc->id . '">' . $label . '</option>';
}
$xml = <<<XML
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fields name="attribs">
<fieldset name="mokojoomcross" label="PLG_CONTENT_MOKOJOOMCROSS_FIELDSET_CROSSPOST">
<field
name="mokojoomcross_skip"
type="radio"
label="PLG_CONTENT_MOKOJOOMCROSS_SKIP"
description="PLG_CONTENT_MOKOJOOMCROSS_SKIP_DESC"
default="0"
class="btn-group btn-group-yesno">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field
name="mokojoomcross_services"
type="checkboxes"
label="PLG_CONTENT_MOKOJOOMCROSS_SERVICES"
description="PLG_CONTENT_MOKOJOOMCROSS_SERVICES_DESC"
showon="mokojoomcross_skip:0">
{$options}
</field>
<field
name="mokojoomcross_evergreen"
type="radio"
label="PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN"
description="PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_DESC"
default="0"
class="btn-group btn-group-yesno"
showon="mokojoomcross_skip:0">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field
name="mokojoomcross_evergreen_interval"
type="number"
label="PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_INTERVAL"
description="PLG_CONTENT_MOKOJOOMCROSS_EVERGREEN_INTERVAL_DESC"
default="30"
min="1"
max="365"
showon="mokojoomcross_skip:0[AND]mokojoomcross_evergreen:1"
/>
</fieldset>
</fields>
</form>
XML;
$form->load($xml);
}
/**
* Add cross-post status badges before article content in admin.
* @param string $context The context
* @param object $article The article
* @param object $params The article params
* @param int $page The page number
*
* Joomla 5/6 compatible — accepts both BeforeDisplayEvent and legacy parameters.
* @return string HTML to prepend to the article
*/
public function onContentBeforeDisplay($event): string
public function onContentBeforeDisplay(string $context, &$article, &$params, int $page = 0): string
{
// Joomla 5/6 compatibility
if ($event instanceof \Joomla\CMS\Event\Content\BeforeDisplayEvent) {
$context = $event->getContext();
$article = $event->getItem();
} elseif (is_string($event)) {
$context = $event;
$article = func_get_arg(1);
} else {
return '';
}
if ($context !== 'com_content.article') {
return '';
}
@@ -205,100 +82,4 @@ XML;
return '<div class="mokojoomcross-status mb-2">' . $badges . '</div>';
}
/**
* Dispatch cross-post when an article is saved and published.
*
* Joomla 5/6 compatible — accepts both AfterSaveEvent and legacy parameters.
*/
public function onContentAfterSave($event): void
{
// Joomla 5/6 compatibility
if ($event instanceof \Joomla\CMS\Event\Content\AfterSaveEvent) {
$context = $event->getContext();
$article = $event->getItem();
$isNew = $event->getIsNew();
} else {
$context = $event;
$article = func_get_arg(1);
$isNew = func_get_arg(2);
}
if ($context !== 'com_content.article') {
return;
}
if ((int) ($article->state ?? 0) !== 1) {
return;
}
$params = ComponentHelper::getParams('com_mokojoomcross');
if (!$params->get('auto_post_on_publish', 1)) {
return;
}
if ($params->get('post_on_first_publish_only', 0) && !$isNew) {
return;
}
$url = Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id;
if (!empty($article->catid)) {
$url .= '&catid=' . $article->catid;
}
CrossPostDispatcher::dispatch($article, $url, 'com_content.article');
}
/**
* Dispatch cross-post when article state changes to published.
*
* Joomla 5/6 compatible — accepts both ContentChangeStateEvent and legacy parameters.
*/
public function onContentChangeState($event): void
{
if ($event instanceof \Joomla\CMS\Event\Content\ContentChangeStateEvent) {
$context = $event->getContext();
$pks = $event->getPks();
$value = $event->getValue();
} else {
$context = $event;
$pks = func_get_arg(1);
$value = func_get_arg(2);
}
if ($context !== 'com_content.article' || $value !== 1) {
return;
}
$params = ComponentHelper::getParams('com_mokojoomcross');
if (!$params->get('auto_post_on_publish', 1)) {
return;
}
$db = Factory::getDbo();
foreach ($pks as $pk) {
$query = $db->getQuery(true)
->select('*')
->from('#__content')
->where('id = ' . (int) $pk);
$db->setQuery($query);
$article = $db->loadObject();
if (!$article) {
continue;
}
$url = Uri::root() . 'index.php?option=com_content&view=article&id=' . $article->id;
if (!empty($article->catid)) {
$url .= '&catid=' . $article->catid;
}
CrossPostDispatcher::dispatch($article, $url, 'com_content.article');
}
}
}
@@ -1,11 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
@@ -1,26 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="mokojoomcross" method="upgrade">
<name>MokoJoomCross - ActivityPub (Fediverse)</name>
<version>01.00.06-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
<authorUrl>https://mokoconsulting.tech</authorUrl>
<copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
<license>GPL-3.0-or-later</license>
<description>PLG_MOKOJOOMCROSS_ACTIVITYPUB_DESCRIPTION</description>
<namespace path="src">Joomla\Plugin\MokoJoomCross\Activitypub</namespace>
<files>
<filename plugin="activitypub">activitypub.php</filename>
<folder>src</folder>
<folder>services</folder>
<folder>language</folder>
</files>
<languages>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_activitypub.ini</language>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_activitypub.sys.ini</language>
</languages>
</extension>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,2 +0,0 @@
PLG_MOKOJOOMCROSS_ACTIVITYPUB="MokoJoomCross - ActivityPub (Fediverse)"
PLG_MOKOJOOMCROSS_ACTIVITYPUB_DESCRIPTION="Cross-post Joomla articles to ActivityPub (Fediverse)."
@@ -1,2 +0,0 @@
PLG_MOKOJOOMCROSS_ACTIVITYPUB="MokoJoomCross - ActivityPub (Fediverse)"
PLG_MOKOJOOMCROSS_ACTIVITYPUB_DESCRIPTION="Cross-post Joomla articles to ActivityPub (Fediverse)."
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,38 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage plg_mokojoomcross_activitypub
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\Extension\PluginInterface;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\DI\Container;
use Joomla\DI\ServiceProviderInterface;
use Joomla\Event\DispatcherInterface;
use Joomla\Plugin\MokoJoomCross\Activitypub\Extension\ActivitypubService;
return new class () implements ServiceProviderInterface {
public function register(Container $container): void
{
$container->set(
PluginInterface::class,
function (Container $container) {
$plugin = new ActivitypubService(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('mokojoomcross', 'activitypub')
);
$plugin->setApplication(Factory::getApplication());
return $plugin;
}
);
}
};
@@ -1,112 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage plg_mokojoomcross_activitypub
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Plugin\MokoJoomCross\Activitypub\Extension;
defined('_JEXEC') or die;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
use Joomla\Event\SubscriberInterface;
/**
* ActivityPub (Fediverse) service plugin for MokoJoomCross.
*
* Works with Mastodon-compatible APIs (Pleroma, Akkoma, Misskey, Pixelfed).
* Uses the /api/v1/statuses endpoint with Bearer token auth.
*/
class ActivitypubService extends CMSPlugin implements SubscriberInterface, MokoJoomCrossServiceInterface
{
public static function getSubscribedEvents(): array
{
return ['onMokoJoomCrossGetServices' => 'onMokoJoomCrossGetServices'];
}
public function onMokoJoomCrossGetServices(&$services): void
{
$services[] = $this;
}
public function getServiceType(): string { return 'activitypub'; }
public function getServiceName(): string { return 'ActivityPub (Fediverse)'; }
public function getMaxLength(): int { return 500; }
public function supportsMedia(): bool { return true; }
public function publish(string $message, array $media, array $credentials, array $params): array
{
$instanceUrl = rtrim($credentials['instance_url'] ?? '', '/');
$token = $credentials['access_token'] ?? '';
if (empty($instanceUrl) || empty($token)) {
return ['success' => false, 'platform_post_id' => '', 'response' => ['error' => 'Missing instance URL or access token.']];
}
$apiUrl = $instanceUrl . '/api/v1/statuses';
$payload = json_encode(['status' => mb_substr($message, 0, 500)]);
$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Content-Type: application/json',
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if ($httpCode >= 200 && $httpCode < 300 && !empty($data['id'])) {
return ['success' => true, 'platform_post_id' => (string) $data['id'], 'response' => $data];
}
return ['success' => false, 'platform_post_id' => '', 'response' => $data];
}
public function validateCredentials(array $credentials): array
{
$instanceUrl = rtrim($credentials['instance_url'] ?? '', '/');
$token = $credentials['access_token'] ?? '';
if (empty($instanceUrl) || empty($token)) {
return ['valid' => false, 'message' => 'Instance URL and access token are required.', 'account_name' => ''];
}
$ch = curl_init($instanceUrl . '/api/v1/accounts/verify_credentials');
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if (!empty($data['username'])) {
return ['valid' => true, 'message' => 'Connected', 'account_name' => '@' . $data['username'] . '@' . parse_url($instanceUrl, PHP_URL_HOST)];
}
return ['valid' => false, 'message' => $data['error'] ?? 'Failed to verify credentials.', 'account_name' => ''];
}
public function getSupportedMediaTypes(): array
{
return ['image', 'video'];
}
}
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,11 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
@@ -1,26 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="mokojoomcross" method="upgrade">
<name>MokoJoomCross - Google Blogger</name>
<version>01.00.06-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
<authorUrl>https://mokoconsulting.tech</authorUrl>
<copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
<license>GPL-3.0-or-later</license>
<description>PLG_MOKOJOOMCROSS_BLOGGER_DESCRIPTION</description>
<namespace path="src">Joomla\Plugin\MokoJoomCross\Blogger</namespace>
<files>
<filename plugin="blogger">blogger.php</filename>
<folder>src</folder>
<folder>services</folder>
<folder>language</folder>
</files>
<languages>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_blogger.ini</language>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_blogger.sys.ini</language>
</languages>
</extension>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,2 +0,0 @@
PLG_MOKOJOOMCROSS_BLOGGER="MokoJoomCross - Google Blogger"
PLG_MOKOJOOMCROSS_BLOGGER_DESCRIPTION="Cross-post Joomla articles to Google Blogger."
@@ -1,2 +0,0 @@
PLG_MOKOJOOMCROSS_BLOGGER="MokoJoomCross - Google Blogger"
PLG_MOKOJOOMCROSS_BLOGGER_DESCRIPTION="Cross-post Joomla articles to Google Blogger."
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,38 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage plg_mokojoomcross_blogger
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
use Joomla\CMS\Extension\PluginInterface;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\DI\Container;
use Joomla\DI\ServiceProviderInterface;
use Joomla\Event\DispatcherInterface;
use Joomla\Plugin\MokoJoomCross\Blogger\Extension\BloggerService;
return new class () implements ServiceProviderInterface {
public function register(Container $container): void
{
$container->set(
PluginInterface::class,
function (Container $container) {
$plugin = new BloggerService(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('mokojoomcross', 'blogger')
);
$plugin->setApplication(Factory::getApplication());
return $plugin;
}
);
}
};
@@ -1,115 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @subpackage plg_mokojoomcross_blogger
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Plugin\MokoJoomCross\Blogger\Extension;
defined('_JEXEC') or die;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
use Joomla\Event\SubscriberInterface;
/**
* Google Blogger service plugin for MokoJoomCross.
*
* Uses the Blogger API v3 with OAuth Bearer token.
*/
class BloggerService extends CMSPlugin implements SubscriberInterface, MokoJoomCrossServiceInterface
{
public static function getSubscribedEvents(): array
{
return ['onMokoJoomCrossGetServices' => 'onMokoJoomCrossGetServices'];
}
public function onMokoJoomCrossGetServices(&$services): void
{
$services[] = $this;
}
public function getServiceType(): string { return 'blogger'; }
public function getServiceName(): string { return 'Google Blogger'; }
public function getMaxLength(): int { return 0; }
public function supportsMedia(): bool { return true; }
public function publish(string $message, array $media, array $credentials, array $params): array
{
$token = $credentials['access_token'] ?? '';
$blogId = $credentials['blog_id'] ?? '';
if (empty($token) || empty($blogId)) {
return ['success' => false, 'platform_post_id' => '', 'response' => ['error' => 'Missing access token or blog ID.']];
}
$apiUrl = 'https://www.googleapis.com/blogger/v3/blogs/' . urlencode($blogId) . '/posts';
$payload = json_encode([
'kind' => 'blogger#post',
'title' => mb_substr(strip_tags($message), 0, 150),
'content' => $message,
]);
$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Content-Type: application/json',
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if ($httpCode >= 200 && $httpCode < 300 && !empty($data['id'])) {
return ['success' => true, 'platform_post_id' => (string) $data['id'], 'response' => $data];
}
return ['success' => false, 'platform_post_id' => '', 'response' => $data];
}
public function validateCredentials(array $credentials): array
{
$token = $credentials['access_token'] ?? '';
$blogId = $credentials['blog_id'] ?? '';
if (empty($token) || empty($blogId)) {
return ['valid' => false, 'message' => 'Access token and blog ID are required.', 'account_name' => ''];
}
$ch = curl_init('https://www.googleapis.com/blogger/v3/blogs/' . urlencode($blogId));
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true) ?: [];
if (!empty($data['name'])) {
return ['valid' => true, 'message' => 'Connected', 'account_name' => $data['name']];
}
return ['valid' => false, 'message' => $data['error']['message'] ?? 'Failed to verify credentials.', 'account_name' => ''];
}
public function getSupportedMediaTypes(): array
{
return ['image'];
}
}
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1 +0,0 @@
<!DOCTYPE html><title></title>
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="mokojoomcross" method="upgrade">
<name>MokoJoomCross - Bluesky</name>
<version>01.00.06-dev</version>
<version>01.00.00-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
@@ -23,29 +23,4 @@
<language tag="en-GB">language/en-GB/plg_mokojoomcross_bluesky.ini</language>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_bluesky.sys.ini</language>
</languages>
<config>
<fields name="params">
<fieldset name="basic" label="PLG_MOKOJOOMCROSS_BLUESKY_FIELDSET_DEFAULTS">
<field
name="default_pds_url"
type="url"
label="PLG_MOKOJOOMCROSS_BLUESKY_DEFAULT_PDS_URL"
description="PLG_MOKOJOOMCROSS_BLUESKY_DEFAULT_PDS_URL_DESC"
default="https://bsky.social"
/>
<field
name="auto_link_card"
type="radio"
label="PLG_MOKOJOOMCROSS_BLUESKY_AUTO_LINK_CARD"
description="PLG_MOKOJOOMCROSS_BLUESKY_AUTO_LINK_CARD_DESC"
default="1"
class="btn-group btn-group-yesno"
>
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
</fieldset>
</fields>
</config>
</extension>
@@ -1,7 +1,2 @@
PLG_MOKOJOOMCROSS_BLUESKY="MokoJoomCross - Bluesky"
PLG_MOKOJOOMCROSS_BLUESKY_DESCRIPTION="Cross-post Joomla articles to Bluesky."
PLG_MOKOJOOMCROSS_BLUESKY_FIELDSET_DEFAULTS="Bluesky Defaults"
PLG_MOKOJOOMCROSS_BLUESKY_DEFAULT_PDS_URL="Default PDS URL"
PLG_MOKOJOOMCROSS_BLUESKY_DEFAULT_PDS_URL_DESC="Default Bluesky PDS URL (e.g. https://bsky.social)."
PLG_MOKOJOOMCROSS_BLUESKY_AUTO_LINK_CARD="Auto Link Card"
PLG_MOKOJOOMCROSS_BLUESKY_AUTO_LINK_CARD_DESC="Automatically detect URLs and create link cards in posts."
@@ -17,7 +17,7 @@ use Joomla\CMS\Plugin\PluginHelper;
use Joomla\DI\Container;
use Joomla\DI\ServiceProviderInterface;
use Joomla\Event\DispatcherInterface;
use Joomla\Plugin\MokoJoomCross\Bluesky\Extension\BlueskyService;
use Joomla\Plugin\MokoJoomCross${CLASS_NAME}\Extension${CLASS_NAME}Service;
return new class () implements ServiceProviderInterface {
public function register(Container $container): void
@@ -127,9 +127,4 @@ class BlueskyService extends CMSPlugin implements SubscriberInterface, MokoJoomC
return json_decode($response, true) ?: [];
}
public function getSupportedMediaTypes(): array
{
return ['image'];
}
}
@@ -1,11 +0,0 @@
<?php
/**
* @package MokoJoomCross
* @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
* SPDX-License-Identifier: GPL-3.0-or-later
*/
defined('_JEXEC') or die;
@@ -1,26 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="mokojoomcross" method="upgrade">
<name>MokoJoomCross - Brevo (Sendinblue)</name>
<version>01.00.06-dev</version>
<creationDate>2026-05-28</creationDate>
<author>Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
<authorUrl>https://mokoconsulting.tech</authorUrl>
<copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
<license>GPL-3.0-or-later</license>
<description>PLG_MOKOJOOMCROSS_BREVO_DESCRIPTION</description>
<namespace path="src">Joomla\Plugin\MokoJoomCross\Brevo</namespace>
<files>
<filename plugin="brevo">brevo.php</filename>
<folder>src</folder>
<folder>services</folder>
<folder>language</folder>
</files>
<languages>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_brevo.ini</language>
<language tag="en-GB">language/en-GB/plg_mokojoomcross_brevo.sys.ini</language>
</languages>
</extension>

Some files were not shown because too many files have changed in this diff Show More