Store Locator Plugin Guide

Geolocation Prompt Dialog

With Agile Store Locator users have multiple options on how their visitors' current location may or may not be detected. Moreover, detecting a location is done with a geolocation prompt that appears when the map is loaded. Furthermore, these options can be either selected or a shortcode can be added to bring about the change.

Geo-location option in the ASL Settings

The options for geolocation prompts that are listed in “ASL Settings” include:

  1.  NONE - Effectively disables the geolocation prompt so users will not be prompted to provide their current location.

The corresponding shortcode is the following:

[ASL_STORELOCATOR prompt_location="0"]
Option 1: Geolocation popup disabled
Option 1: Geolocation popup disabled

2. GEOLOCATION DIALOG- Enables a geolocation prompt that will detect your current location. Therefore, users simply need to click “USE LOCATION” on the prompt and their location will be detected.

The corresponding shortcode is the following:

 [ASL_STORELOCATOR prompt_location="1"]
Option 2 - Geolocation Dialog
Option 2 - Geolocation Dialog

  1. TYPE YOUR LOCATION Dialog - Prompts users to manually type in their location in the address bar and click on “LOCATE” to detect your location. In addition, the address bar is embedded with Google Place API so a list of addresses will drop down for the user to choose from.

The corresponding shortcode is the following:

[ASL_STORELOCATOR prompt_location="2"]
Option 3- Type your location dialog
Option 3- Type your location dialog
  1. GEOLOCATION WITHOUT DIALOG - Detection of your location upon page load without giving you a geolocation popup. However, this only works with secure HTTPS connections. Furthermore, some users may encounter an error with this option as shown in the below image. If this error does occur, all you need to do is go to preferences and select the “Always allow…” option. The corresponding shortcode is the following:
[ASL_STORELOCATOR prompt_location="3"]
Allow to Access Location
Allow to Access Location
Option 3 - Geolocation without dialog
Option 3 - Geolocation without dialog

Why is Geolocation Not Working?

Sometimes users might come across a situation where the geolocation feature will not work.

The main reason why the geolocation feature does not work is if "Block" is selected instead of "Allow" on the "geolocation prompt". Moreover, the selection will be saved in the browser preferences.

"Block" or "Allow" Geolocation
"Block" or "Allow" Geolocation

The solution is to go to your browser "Preferences" and allow geolocation to be used.

Geolocation Setting
Geolocation Setting

GEOJS API Service

GEOJS is a free API service that is recently included in the Store Locator to locate your GeoLocation, Agile Store Locator is not responsible for its accuracy and results as it is a third-party API, it works based on the IP of the user to geo-locate his position.