Troubleshooting MokoOnyx

  • Applicable Software: MokoOnyx (Template)
  • Applicable Version: Development

Common Issues

Styles not loading after update

MokoOnyx cleans stale minified files during install/update. If styles still appear broken:

  1. Clear your browser cache (Ctrl+Shift+R).
  2. In Joomla admin, go to System > Clear Cache and purge all caches.
  3. 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:

  1. Delete the file templates/mokoonyx/.migrated
  2. Reload any frontend page.
  3. Check administrator/logs/mokoonyx_migrate.log.php for 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.css and media/templates/site/mokoonyx/js/user.js.
  • Delete any .min.css / .min.js counterparts to force regeneration.
  • Enable Development Mode to bypass minification temporarily.

Getting Help

If you encounter issues not covered here, please file an issue on our issue tracker.