Next Inventory 6.1.0: App Manager, dark mode, and more Joomla 6.1 "Nyota" Is Here Building the Future of Joomla Extensions
NextSoftware
Smart Local Google Analytics — Documentation

Geo-Detection

The Geo-Detection tab lets you show the consent dialog only to visitors from regions that require it, while allowing others through automatically.

Geo-Detection tab

Browser Language Detection

Setting Details
Field Browser Language Detection
Type Toggle (Yes/No)
Default No (disabled)

When enabled, the plugin reads the visitor's Accept-Language HTTP header to infer their region. Visitors from consent-required regions see the dialog; others are handled according to the non-EU action setting.

Setting Details
Field Consent Required Regions
Type Checkboxes
Default All checked
Visible when Browser Language Detection is Yes

Select which regions require the consent dialog:

Region Languages Detected Countries
EU Countries de, fr, it, es, pt, nl, pl, cs, sk, hu, ro, bg, hr, sl, lt, lv, et, fi, sv, da, el, ga, mt All 27 EU member states
EEA (Norway, Iceland) no, is Norway, Iceland
UK & Ireland en-gb, en-ie United Kingdom, Ireland

Action for Non-EU Visitors

Setting Details
Field Action for Non-EU Visitors
Type Dropdown
Default Auto-agree
Visible when Browser Language Detection is Yes
Option Behavior
Auto-agree Silently sets the consent cookie to agree and injects GA/GTM immediately. The visitor never sees the consent dialog. (default)
Show consent box Shows the consent dialog to all visitors regardless of region. Useful if you want to offer the choice everywhere.
Skip plugin entirely The plugin does nothing for non-EU visitors — no consent cookie, no GA injection, no dialog. Use this only if another mechanism handles analytics for non-EU traffic.

How It Works

  1. When a visitor loads a page, the plugin checks the Accept-Language header
  2. The header contains language tags like en-US,en;q=0.9,de;q=0.8
  3. The plugin checks each tag against the configured consent regions
  4. If any tag matches a consent region, the visitor sees the consent dialog
  5. If no tags match, the non-EU action is applied

Important Notes

  • Safe default: If no Accept-Language header is present (e.g., bots, API clients), the consent dialog is shown as a precaution
  • English is special: The bare language code en does not trigger consent — only en-gb and en-ie do. This prevents showing the dialog to en-us visitors when only the UK region is selected
  • Not IP-based: This detection uses browser language preferences, not IP geolocation. A German user traveling in the US will still see the consent dialog because their browser language is de
  • No external API calls: The detection is entirely server-side using the HTTP header — no third-party geolocation services are contacted

Limitations

Browser language detection is an approximation. It reflects the visitor's language settings, not their physical location. This means:

  • A visitor using a browser set to English in Germany will not be detected as EU
  • A visitor using a browser set to German in the US will be detected as EU

For most sites, this is a reasonable trade-off that avoids the privacy concerns and costs of IP-based geolocation. When in doubt, disable geo-detection to show the consent dialog to all visitors.

All Extensions