Troubleshooting

Troubleshooting Mokonyx

Details
Category: Troubleshooting
  • Applicable Software: Mokonyx
  • Min Version Number: Development
  • Max Version Number: Not Applicable

Common Issues

Styles not loading after update

Mokonyx 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/mokonyx/css/theme/light.custom.css
  • Dark: media/templates/site/mokonyx/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/mokonyx/.migrated
  2. Reload any frontend page.
  3. Check administrator/logs/mokonyx_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/mokonyx/vendor/fa7free/webfonts/

user.css or user.js not taking effect

  • Ensure the files exist at media/templates/site/mokonyx/css/user.css and media/templates/site/mokonyx/js/user.js.
  • Delete any .min.css / .min.js counterparts to force regeneration.
  • Enable Development Mode to bypass minification temporarily.

“Regular Labs data detected” keeps showing on the dashboard

The dashboard now advertises a Regular Labs import only when there is genuine, not-yet-imported Regular Labs data present (one or more real source rows). If you have already imported, or the Regular Labs tables are empty (or only the shared library is installed), the banner will no longer appear. A stale banner after a successful import simply means the page was cached - clear the admin cache to refresh it.

Blank / white screen on the Regular Labs import

The import action has been hardened against large JSON payloads that previously produced a blank page. If you still hit a white screen, retry the import; the process now streams and closes the response cleanly instead of exhausting memory mid-render.

Hits: 138

Read more …