Modovisa for Joomla (System Plugin)

Lightweight Joomla plugin that injects the Modovisa real-time tracking script into your site’s <head> on the front-end.

  • Extension type: System Plugin
  • Package: plg_system_modovisa-1.0.1.zip
  • Supports: Joomla 5.x (tested on 5.3.x) and 4.4+
  • Scope: Front-end only (never loads in /administrator)
Requirements
  • Joomla 5.x or 4.4+
  • A valid Modovisa project token (from your Modovisa dashboard)
  • PHP 8.1+ recommended
Install

You can install the plugin in any of three ways:

A) Upload Package File (recommended)
  1. In Joomla admin, go to System → Extensions → Install.
  2. Choose Upload Package File, select plg_system_modovisa-1.0.1.zip.
  3. Click Upload & Install.
B) Install from URL
  1. Go to System → Extensions → Install → Install from URL.
  2. Enter the direct URL, e.g.:
    https://cdn.modovisa.com/joomla/releases/plg_system_modovisa-1.0.1.zip
  3. Click Check & Install.
C) Install from Folder / CLI

Upload the extracted plugin to your server and install from folder:

/home/<account>/joomla_root/tmp/plg_system_modovisa/

Then in Install from Folder, point to that path and click Check & Install.

After installation, if the plugin is not yet enabled, go to System → Plugins, find System – Modovisa and enable it.
Enable & Configure
  1. Go to System → Plugins.
  2. Find System – Modovisa (plg_system_modovisa) and set Status: Enabled.
  3. Open it and configure:
    • Enable tracking: On
    • Project token: paste your Modovisa token (required)
    • Script URL (optional): defaults to https://cdn.modovisa.com/modovisa.min.js
    • Defer script (optional): On by default (loads non-blocking in <head>)
  4. Click Save.
Verify It’s Working
  1. Visit a front-end page while not logged in as an excluded group (use a private window if needed).
  2. View page source and confirm a tag like:
<script id="modovisa-tracker"
          src="https://cdn.modovisa.com/modovisa.min.js"
          async defer
          data-token="YOUR_TOKEN"></script>

Within a few seconds, the visit should appear in your Modovisa dashboard.

Updates (Joomla Update System)

The plugin integrates with Joomla’s update mechanism.

  • Go to System → Update → Extensions and click Check for Updates.
  • If a newer version is available, install it with one click.

If your site cannot reach the update feed, you can always upload a newer ZIP via Upload Package File and Joomla will upgrade safely.

Uninstall

Go to System → Extensions → Manage, search for System – Modovisa and click Uninstall. This removes the plugin only; it does not affect your Modovisa account or data.

How it Works (technical)
  • Hooks onBeforeCompileHead on the site application (never admin).
  • Uses Joomla 4/5 Web Asset Manager to register the external script.
  • Falls back to a raw <script> tag in <head> if needed.
  • Loads non-blocking with async and optional defer.
  • Guards against duplicate injection if a script URL containing modovisa.min.js already exists.
Common Issues & Troubleshooting
No script in source
  • Ensure Status: Enabled in System → Plugins.
  • Confirm Project token is filled and has no extra spaces.
  • Clear System → Clear Cache and any CDN/edge caches.
Script appears but no tracking
  • Confirm the tag includes your data-token.
  • Verify the domain is allowed in your Modovisa project (if you enforce domain restrictions).
  • Ad/script blockers may suppress network calls; test in a clean browser profile.
Optimization plugins (JCH Optimize, Rocket Loader, etc.)
  • Add an exclusion for:
    • cdn.modovisa.com/modovisa.min.js
    • #modovisa-tracker (script ID)
  • If a tool rewrites third-party scripts, disable that rule or whitelist Modovisa.
Template overrides

Not applicable. The plugin injects into the document head; templates don’t need changes.

Privacy & Consent

Modovisa processes typical web analytics metadata (e.g., URL, referrer, user-agent, device hints, IP/geo per your configuration). If your region requires consent (e.g., GDPR/PECR), wire your consent logic so the plugin injects the script only after consent, or use Modovisa’s consent APIs/features as applicable. Update your site’s privacy policy accordingly.

FAQ

Does it run in the admin backend?
No. It’s explicitly front-end only.

Can I exclude logged-in users?
Yes—choose user groups to exclude in the plugin settings (e.g., Registered, Administrator).

Will enabling Defer delay tracking?
The tag is placed in <head> with async and optionally defer. Browsers generally prioritize async; either way, the script loads non-blocking and as early as practical.

Multisite or staging domains?
You can reuse the same token on staging, but data will go to the same Modovisa project. If you need isolation, create a separate project/token.

Changelog
  • 1.0.1 — Release
    • Front-end head injection (Web Asset Manager + fallback)
    • Async load; optional defer
    • Duplicate-load guard
    • Joomla Update System integration
Support
Security

If you discover a security issue, please contact [email protected]. Do not disclose publicly until we confirm a fix and a patched release.

Appendix: Manual CLI Install (advanced)
# From your Joomla root:
                  php cli/joomla.php extension:install \
                  --path="/absolute/path/to/plg_system_modovisa-1.0.1.zip"

Then enable in System → Plugins.

© 2025 Modovisa — Modovisa for Joomla is free software, released under the GPL-2.0-or-later.