Common Issues
Styles not loading after update
MokoOnyx cleans stale minified files during install/update. If styles still appear broken:
- Clear your browser cache (Ctrl+Shift+R).
- In Joomla admin, go to System > Clear Cache and purge all caches.
- If using a CDN (Cloudflare, etc.), purge the CDN cache.
Custom theme not appearing
Ensure your custom CSS file exists at the correct path:
- Light:
media/templates/site/mokoonyx/css/theme/light.custom.css - Dark:
media/templates/site/mokoonyx/css/theme/dark.custom.css
Also verify you selected Custom in the Theme tab of template settings.
Migration did not run
The automatic migration from MokoCassiopeia runs only once. To re-trigger:
- Delete the file
templates/mokoonyx/.migrated - Reload any frontend page.
- Check
administrator/logs/mokoonyx_migrate.log.phpfor results.
Font Awesome icons not showing
- Check if a FA Kit code is entered in settings but invalid.
- Clear the Kit field to fall back to local FA7 Free.
- Verify the font files exist at
media/templates/site/mokoonyx/vendor/fa7free/webfonts/
user.css or user.js not taking effect
- Ensure the files exist at
media/templates/site/mokoonyx/css/user.cssandmedia/templates/site/mokoonyx/js/user.js. - Delete any
.min.css/.min.jscounterparts to force regeneration. - Enable Development Mode to bypass minification temporarily.
Copying Database Problem Details
If the MokoOnyx Admin Extender plugin is enabled, the database maintenance screen makes schema problems easy to copy for support. Go to System > Maintenance > Database: each extension with problems shows a coloured badge (for example One Problem or 2 Problems) in the Problems column. Click the badge to open a modal listing every problem — it also copies the full detail to your clipboard automatically, so you can paste the exact errors into a support request. Press Esc or Close to dismiss. Green No Problems badges are not clickable.
Getting Help
If you encounter issues not covered here, please file an issue on our issue tracker.