Extension configuration
Extension settings are available in Admin Panel - Stores - Configuration - Store Locator
GENERAL SETTINGS
Enable Extension
Enable or disable the Store Locator
Page Title
Specify the page and SEO Meta Title
URL Path to Page
Specify the URL path for the store locator page. Example: /dealers or /store-locator
Show Link To Store Locator In The Header
If it is set to yes then a text link to the store locator will be added in your store's header
Text For The Link
If the Show Link To Store Locator In The Header is set to yes, then enter the text link that will be shown in your store's header
CMS Block To Show Above The Map
If desired, select a cms block that will be used to display content and banners above the store locator
Meta Keywords & Meta Description
Enter the SEO keywords and description for the page
MAP API SETTINGS
Connection Status
This field shows if the connection to the selected map API was successful.
Select Maps API:
You can choose which mapping service will be used to show the map.
HERE WeGo
App Key
This key is used to connect to the maps service. You can get the key by following this guide:
Sign In or Register:
-
Visit developer.here.com.
-
Click on "Sign In" to log in to your existing account or select "Sign Up" to create a new one.
Choose a Plan:
-
After signing in, navigate to the "Pricing" section.
-
Select a plan that suits your development needs.
-
Select REST API and click “Register your app”
-
Within your project, navigate to the "REST" section.
Copy the provided API key:
Marker Icon Image
Here you can add an image for store markers to show up on the map.
GOOGLE MAPS
Browser API Key
-
To activate the Google map on the store locator, enter the browser's API key.
In order to obtain the key, go to https://developers.google.com/maps/documentation/javascript/get-api-key
and follow the instructions.
Create the project
Also, make sure that you enable all services related to maps
Once you get the key, copy it
Marker Icon
Upload a custom location marker that is used on the map to identify found locations
Scrollwheel Zooming
Enable/disable the ability for users to zoom with the scroll wheel on their mouse
Map Type Control
Enable/disable if the user can change the type of map (Satellite or map view)
Scale Control
Enable/disable if the scale on the map is to be shown
STORE SEARCH SETTINGS
Search Automatically Once Page Is Loaded
Control if the search will automatically start locating results for the user once the page finishes loading (auto-search)
Turn On Pagination
Enable/disable pagination if more locations are found than what is allowed to be shown per page
Number Of Stores On Page
Control how many stores to display in the search results
Enable Filter by Radius
Determine if users can filter their search results by a radius. If yes, then enter radius options that the user can choose from
Available Radius Options
If users can filter by radius, then specify the radius options for the user
Default Radius Value
If users cannot filter by radius, then specify the default radius that is applied for users automatically
Distance Units
Control if the map will use miles or kilometers to determine the distance
Sort Search Results By
Specify if search results will be displayed by distance, position, or title
Message If No Stores Found
Enter the message shown to users if no locations were found in their search
LOOK AND FEEL
Disable Stretching To Page Width:
This option allows you to show the map on the whole page, or shrink it to the width specified by the theme.
Hidden placeholders:
This option doesn’t show a placeholder image for a location if enabled.
Default location image
An image to be shown near the location description, if no image is assigned on the store configuration page.
Highlight search result
If set to yes, the search area will be highlighted using the parameters below.
Two parameters to set the search zone infill:
- Search Zone Color
- Search Zone Opacity
And three parameters to configure the outline for the search zone:
- Line Color
- Line Opacity
- Line thickness
LOCATIONS AUTOFILL:
Stores To Fill Per Run
Number of stores that will be automatically processed at once. This parameter allows you to set the desired number of stores to avoid overloading the API.
Enable Autofill By Schedule
If set to Yes, this parameter will let you configure how often autofill will work and set the start time of the autofill task.
STORE PICKUP:
A shipping method was added by the Store Locator extension. It allows to configure shipping to the stores, where customers can pick up their orders.
Enable
The option enables or disables the extension
Field Title
This parameter sets the shipping method name to be displayed on the frontend
Minimum Order Total
You can restrict the shipping method to appear only if the total is more than the specified amount
Ship to Applicable Countries
If you have stores in several countries, you can use this option to enable or disable this shipping method for some of them. If you set this option to “Specified Countries”, then you can select the countries from the list below.
Information About Extension
This section contains the extension version and a link to the documentation.
Adding the stores.
To add the stores, go to Admin Panel - Content - Zest Logic Store Locator - Stores.
There are the following ways to add more stores:
Click Add New item.
In this case, you’ll be redirected to the store creation page. Fill in at least the required information and click Save Store to create a new store. Please note that coordinates are not required. If you fill in parameters such as country, city, street, and ZIP, they can be calculated automatically using autofill or by going to the Store Coordinates tab and clicking Get Location.
Importing stores.
Also, you can import the stores. Just go to Admin Panel - Content - Zest Logic Store Locator - Stores and click Import. You will be able to download an example import file, fill in the needed information, and upload it to the store.
Filling coordinates (latitude and longitude)
Auto Fill button allows you to fill in the latitude and longitude for the imported or created stores using parameters such as country, city, street, and zip, and connecting to the selected maps API. Please note that if you have a significant number of stores, it is recommended to set up Autofill By Schedule in the extension settings, so they can be processed in small batches, avoiding overloading the API.
Exporting the stores list
The export button allows you to export the filled stores to make a backup or transfer this data to another environment (such as dev or staging).
Mass actions
Also, the extension supports mass actions, so you can enable, disable, or delete some stores from the grid.