Joomla

​

Requirements

• Joomla 5.0+
• PHP 8.1+
• MySQL 8.0+

​

Installation

1. Download pkg_xenarch.zip from the releases page
2. Go to System → Install Extensions in your Joomla admin panel
3. Upload pkg_xenarch.zip

​

What gets installed

​

Configuration

​

Onboarding flow

1. Register — create your publisher account
2. Add site — link your Joomla site to the Xenarch platform
3. Set payout wallet — enter your Base/Ethereum address for USDC payouts

​

Settings

​

Bot category policies

{
  "ai_search": "allow",
  "ai_assistants": "charge",
  "ai_agents": "charge",
  "ai_training": "charge",
  "scrapers": "charge",
  "general_ai": "charge"
}

​

Per-bot overrides

{
  "GPTBot": "allow",
  "ClaudeBot": "charge"
}

​

Pricing rules

[
  { "path_contains": "/premium/", "price_usd": 0.01 },
  { "path_contains": "/research/", "price_usd": 0.005 }
]

​

How it works

​

Request flow

1. Skip — logged-in users, static assets, and /.well-known/* paths always pass through
2. Check token — if the request has a valid Authorization: Bearer <token>, allow it
3. Detect bot — match User-Agent against 100+ known AI bot signatures, then score headers
4. Apply policy — check per-bot override, then category default
5. Respond — allow (200), challenge (403 + browser proof), or gate (402 + payment payload)

​

Discovery documents

• /.well-known/pay.json — machine-readable pricing for AI agents
• /.well-known/xenarch.md — human-readable payment instructions

​

Bot detection

1. Signature match — 100+ known AI bot User-Agent strings
2. Trusted search crawlers — Googlebot, Bingbot, etc. (always allowed)
3. HTTP client signatures — python-requests, curl, wget, Go-http-client
4. Browser proof cache — valid proof cookie from a previous challenge
5. Header scoring — missing Accept, Accept-Language, Sec-Fetch-* headers increase suspicion score

​

Build from source

cd xenarch-plugins/joomla
./scripts/build-release.sh
# Output: src/packages/pkg_xenarch.zip

​

Local development

cd xenarch-plugins/joomla
docker compose up -d
# Joomla 5.4 + MySQL 8 at localhost:8889

​

Admin UI development

cd xenarch-plugins/joomla/admin-ui
npm install
npm run build