Files
Jonathan Miller 3a30f1a088
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (push) Successful in 6s
Universal: PR Check / Branch Policy (pull_request) Successful in 3s
Generic: Repo Health / Access control (pull_request) Successful in 3s
Universal: Auto Version Bump / Version Bump (push) Failing after 14s
Joomla: Extension CI / Release Readiness Check (pull_request) Failing after 12s
Universal: Secret Scanning / Gitleaks Secret Scan (pull_request) Successful in 11s
Universal: PR Check / Validate PR (pull_request) Failing after 10s
Update Server / Update Server (push) Successful in 18s
Joomla: Extension CI / Lint & Validate (pull_request) Failing after 35s
Joomla: Extension CI / Tests (PHP 8.2) (pull_request) Has been cancelled
Joomla: Extension CI / Tests (PHP 8.3) (pull_request) Has been cancelled
Joomla: Extension CI / PHPStan Analysis (pull_request) Has been cancelled
Joomla: Extension CI / Build RC Pre-Release (pull_request) Has been cancelled
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
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Generic: Repo Health / Release configuration (pull_request) Has been cancelled
Generic: Repo Health / Scripts governance (pull_request) Has been cancelled
Generic: Repo Health / Repository health (pull_request) Has been cancelled
Merge remote-tracking branch 'origin/main' into dev
# Conflicts:
#	.mokogitea/cascade-dev.yml
#	src/templateDetails.xml
#	updates.xml
2026-05-30 20:51:21 -05:00

2.4 KiB

← Back to Home

Installation

Requirements

Requirement Minimum Version
Joomla 5.x or 6.x
PHP 8.1 or higher

Download

Download the latest mokoonyx-{version}.zip from the Releases page.

Install via Joomla Admin

  1. Log in to your Joomla administrator panel
  2. Navigate to System → Install → Extensions
  3. Upload the mokoonyx-{version}.zip file
  4. Wait for the installer to complete

The installer performs a preflight check to verify your PHP and Joomla versions meet the minimum requirements. If they do not, installation will be blocked with an error message.

Set as Default Template

  1. Navigate to System → Site Templates
  2. Click the star icon next to MokoOnyx to set it as the default site template

First Page Load (Migration)

If you are migrating from MokoCassiopeia, the migration runs automatically during install:

  1. Visit any page on your site after installation -- the template activates immediately
  2. Check administrator/logs/mokoonyx.log.php to confirm the migration completed
  3. Once confirmed, uninstall MokoCassiopeia from Extensions → Manage

See the Migration page for full details on what gets migrated.

Post-Install Notes

  • The extension is automatically locked after install to prevent accidental uninstallation
  • Stale .min files from previous versions are cleaned automatically
  • Favicon stamps are cleared so favicons regenerate on the next page load
  • MokoCassiopeia references in article content and modules are automatically updated to MokoOnyx

Update Server

MokoOnyx includes an automatic update server. Joomla will notify you when new versions are available via System → Update → Extensions. Two update servers are configured for redundancy:

Priority Server
1 Gitea (git.mokoconsulting.tech)
2 GitHub (github.com)

Built with moko-platform -- Moko Consulting


Repo: MokoOnyx · moko-platform

Revision Date Author Description
1.0 2026-05-09 Moko Consulting Initial version