Jonathan Miller
3a30f1a088
# Conflicts: # .mokogitea/cascade-dev.yml # src/templateDetails.xml # updates.xml
4.0 KiB
MokoOnyx
A modern, lightweight Joomla site template built on Cassiopeia with Font Awesome 7, Bootstrap 5, dark mode, and analytics integrations.
| Type | Joomla Site Template |
| Version | 02.01.06 |
| Joomla | 5.x / 6.x |
| PHP | 8.1+ |
| License | GPL-3.0-or-later |
| Replaces | MokoCassiopeia (auto-migrates on install) |
| Platform | Gitea (primary) |
Overview
MokoOnyx is an enhancement layer built on Joomla's Cassiopeia template. It maintains minimal core overrides for maximum upgrade compatibility while adding modern features and integrations.
On install, MokoOnyx automatically migrates settings, content references, and custom files from MokoCassiopeia. After installing, MokoCassiopeia can be safely uninstalled.
Features
| Feature | Description |
|---|---|
| Font Awesome 7 | Fully integrated into Joomla's asset manager with 2,000+ icons |
| Bootstrap 5 | Extended utility classes and responsive grid system |
| Dark Mode | Built-in light/dark toggle with system preference detection |
| Table of Contents | Automatic TOC generation for long articles |
| GTM / GA4 | Google Tag Manager and Analytics integration with smart visitor detection (login status, user group, page type) |
| Template Overrides | Overrides for all core Joomla modules, Community Builder, and DPCalendar |
| Cassiopeia Base | Minimal core overrides for maximum Joomla upgrade compatibility |
Installation
- Download the latest
mokoonyx-{version}.zipfrom Releases - Install via Joomla's Extension Manager (Extensions > Manage > Install)
- Set MokoOnyx as the default site template (System > Site Templates)
- If migrating from MokoCassiopeia, settings are auto-migrated on install
Requirements
- Joomla 5.x or 6.x
- PHP 8.1 or higher
Directory Structure
| Directory | Purpose |
|---|---|
html/ |
Template overrides for core modules and extensions |
css/ |
Compiled stylesheets including dark mode |
js/ |
JavaScript for TOC, dark mode toggle, analytics |
images/ |
Template images and icons |
language/ |
Language files |
Configuration
MokoOnyx template parameters are configured in the Joomla admin under System > Site Templates > MokoOnyx.
Key parameters include:
- Dark Mode: Enable/disable, set default mode
- Font Awesome: Enable/disable icon library loading
- Google Tag Manager: GTM container ID
- GA4: Measurement ID and tracking options
- Table of Contents: Auto-generate TOC for articles with heading threshold
Related Wikis
| Repo | Purpose |
|---|---|
| Template-Client-WaaS | Client site template (extends MokoOnyx) |
| MokoWaaS | WaaS system plugin |
| joomla-api-mcp | Joomla Web Services API MCP |
| deploy-mcp | Git-based deployment MCP |
moko-platform -- central standards hub for all Moko Consulting projects.
Repo: MokoOnyx · moko-platform
| Revision | Date | Author | Description |
|---|---|---|---|
| 1.0 | 2026-05-09 | Moko Consulting | Initial version |
End-User Documentation
This wiki is for developers and contributors. For end-user guides (installation, configuration, usage), see the Knowledge Base on our website:
MokoOnyx Template Support Articles
The website documentation covers step-by-step instructions for non-technical users.