Jonathan Miller
3a30f1a088
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
Generic: Repo Health / Site Health (push) Has been cancelled
Generic: Repo Health / Site Health (pull_request) Has been cancelled
Generic: Repo Health / Access control (push) Has been cancelled
Universal: PR Check / Branch Policy (pull_request) Has been cancelled
Generic: Repo Health / Access control (pull_request) Has been cancelled
Universal: Auto Version Bump / Version Bump (push) Has been cancelled
Joomla: Extension CI / Release Readiness Check (pull_request) Has been cancelled
Universal: Secret Scanning / Gitleaks Secret Scan (pull_request) Has been cancelled
Universal: PR Check / Validate PR (pull_request) Has been cancelled
Update Server / Update Server (push) Has been cancelled
Joomla: Extension CI / Lint & Validate (pull_request) Has been cancelled
# Conflicts: # .mokogitea/cascade-dev.yml # src/templateDetails.xml # updates.xml
67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
[← Back to Home](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](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable).
|
|
|
|
## 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](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](https://git.mokoconsulting.tech/MokoConsulting/moko-platform) -- Moko Consulting*
|
|
|
|
---
|
|
|
|
*Repo: [MokoOnyx](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx) · [moko-platform](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home)*
|
|
|
|
| Revision | Date | Author | Description |
|
|
|---|---|---|---|
|
|
| 1.0 | 2026-05-09 | Moko Consulting | Initial version |
|