Geolocation Detection 🧪

Route Visitors and Display Conditional Elements Based on Country or City.

UNDER DEVELOPMENT Watch this space.

Use Cases

• Route visitors to a Country-specific home page

• Route visitors to a City-specific contact-us page

Feature Roadmap

Completed

• Route user by Country

• Routing table support

  • Supports routing any defined path, e.g. /about to any Geo-specific variants you have, e.g. /about/gb, /about/au, /jp/about.

  • Routed sources and destinations are unlimited, no enforced path rules.

• Standardized GeoInfo object, to consistently describe the detection regardless of the GeoIP handler source

• Cached responses, for minimal GeoIP service traffic

  • One request per unique user

GeoIP handlers;

• IPInfo support. 50,000 requests/mo free.

Planned

• Route user by Continent

• Route user by City

• Cache duration as a setting

• Named route efficiency

  • Modify page paths on e.g. Home / to the routed page variant, to avoid unnecessary redirects.

Override support;

• The ability to apply the current setting to a Dropdown, and automatically indicate the current Country, City, etc.

• The ability to change country, city, etc and have that override the detected settings.

GeoIP handlers;

• Support for multiple Geoip handlers

  • Ability to select in config

Considering

Developer support;

• Expose and document the Detect objects for use in code, e.g.;

  • Data-binding support, populate a form's Zip code field, select a country, etc.

  • Auto-center maps

• Automatic Filter-binding support for FS-Filter

GeoZone definitions;

• Collection of countries, cities, zips, etc into a Zone, like "Europe"

GeoIP handlers;

• Ability to select the GeoIP handler dynamically in config

• Fallback handlers

More Ideas

GeoZone definitions;

• Point-and-radius

• Sort list by nearest ( branch locators, etc. )

• Zip to data chaining

GeoIP handlers;

• Possibly a Sygnal-specific Geoip handler

Usage Notes

Routing Rules

Routing rules are configured just before the library is loaded in the script section indicated with // Routing rules ( see quick start ).

• You may have multiple rule configurations in this section, though this is mostly a future design facilitation. Most likely, the first rule matched will be applied.

Route by Country

Specify the rule type as geo-country.

Supply your routes, from country code to path, exactly as in the structure below. You may have as few or as many routes as you like.

If the visitor's country is not in the list, they will not be routed. They will simply match the default page.

We're working on a design for grouped countries as a regional definition.

<script>
// Routing rules
window['sa5_route'] = [{
    type: 'geo-country',
    path: '/',
    route: [
        ["NZ", "/nz"],
        ["AU", "/au"],
        ["US", "/us"],
        ["GB", "/gb"],
    ]
}];
</script>