Jonathan Miller
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 [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API) -- Moko Consulting*
|
|
|
|
---
|
|
|
|
*Repo: [MokoOnyx](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx) · [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home)*
|
|
|
|
| Revision | Date | Author | Description |
|
|
|---|---|---|---|
|
|
| 1.0 | 2026-05-09 | Moko Consulting | Initial version |
|