Content ElementsStore Locator

Store Locator

Sana Commerce 9.3
Your connector

Set up Store Locator

Store Locator is a content element which can be added to the web pages (flexi-pages, product and product list pages) and system pages of the Sana web store. For example, you can create a separate flexi-page with the "Store Locator" content element and add it to your web store navigation.

You can add only one Store Locator content element to the page.

The tables below provide description of the "Store Locator" content element settings.

Map settings

Field Description
Display in full width Use this option either to center the store locator on a page or to expand it to the full width of a page.
Google map key Enter the Google Maps JavaScript API key. You must enter the valid key before importing the CSV file with store locations.
Default zoom level Enter the default zoom level of the map. It is used when the map is loaded for the first time. The value should be between 1 and 20.
Default search zoom level Enter the default search zoom level of the map. It is used when search results are shown on the map. The value should be between 1 and 20. If the value of the default search zoom level is not 20, a user might not see the exact store location selected from the list, but the pin point group location instead.
Search radius (km) Enter the radius to search for store locations on the map. The value should be between 1 and 2147483647. If you enter 0 km, it will be considered as an unlimited search radius.
Google map API release channel The Google Maps JavaScript API team regularly updates the API with new features, bug fixes, and performance improvements.

Select Google Maps API release channel. For more information, see "Versioning".

  • The weekly channel is updated once per week, and is the most current.
  • The quarterly channel is updated once per quarter, and is the most predictable.
  • The version number is specified and updated once per quarter.
Google map 
API version
If you selected Version in the Google map API release channel field, then you should also enter the API version you want to use.

 

Location settings 

;

Field Description
Landing location
(latitude, longitude)
Enter the latitude and longitude of the default location which must be shown on the map, when it is loaded for the first time.

Enter the latitude and longitude in the following format: [latitude, longitude].
Pin point group icon The icon which is shown on the map, when two or more stores are located close to each other. It is shown on the map depending on the zoom level of the map. There is the default icon, which can be changed.

The recommended maximum size of the image is 64x64 px.

Pin point location icon The icon for a single store location on the map. There is the default icon, which can be changed.

The recommended maximum size of the image is 64x64 px.

 

Store settings

Field Description
Show opening hours Use this option to show and hide the opening hours of a store. It is shown, when a user clicks on a store location icon on the map.

To show the opening hours of a store, you must enter the schedule for at least one day in the CSV file.

Show additional properties Additional properties can be used to add an extra information about a store, for example the brands which you are selling.

You can add the necessary fields and data to the CSV file and import it to Sana. Additional fields must be added to the end of the CSV file on the right. These fields can be used only to filter the stores and it is not shown on the map. The filters with the list of all additional fields are available to the left of the map.

Operator to use in filtration Use the operator (AND, OR) to determine the relationship between multiple filter options (additional properties), and as a result, to narrow or broaden your filtering results.
  • AND - Searches for stores that include all selected filter values (additional properties).
  • OR - Searches for stores that include at least one of the selected filter values (additional properties).

 

CSV file settings

Select delimiters which are used in your CSV file to separate list values and as a decimal symbol. They might differ depending on the regional settings of the Web server.

Default format: List separator is "," and decimal symbol is "."
Alternative format: List separator is ";" and decimal symbol is "," 

Import store locations

Store locations can be imported from a CSV file. To import store locations, export the CSV template and fill it in with the necessary information. You can export the CSV template only when the page with the store locator content element has been already created.

Check the example of the CSV file for store locations.

In the "Import Store Locations" section of the "Store Locator" content element you can see the description of the fields which should be filled in. The CSV template helps users to fill it in with the necessary information and to avoid issues with store locations import because of the wrong data.

 NOTE

Don't remove any headers (field names) from the CSV template. Otherwise, you will not be able to import the CSV file to Sana. If you don't want to fill in some fields, you can leave them empty.

The following fields are required:

  • Id
  • Store Name
  • Latitude and Longitude or Google Address

On the map, you can only see the store name, its Google Address, website URL, phone number and opening hours. All other information from the CSV file is not shown. To show this information on the map requires add-on customization.

Store locations are determined on the map first by latitude and longitude, and if the coordinates are not found, then by Google address.

See examples of the Google address:

  • 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Van Nelleweg 1, 3044BC, Rotterdam, Netherlands

You can use the following address information to add the Google address:
<Street name> <house number>,<zip code>, <city>,<country>

 NOTE

If you enter only Google addresses of your stores in the CSV file, it can take more time for your customers to find a store rather than using Latitude and Longitude. Therefore, we recommend to use Latitude and Longitude.

You can also add an extra information about your stores to the CSV file, for example the brands which you are selling. You can add the necessary fields and data to the CSV file and import it to Sana. Additional fields must be added to the end of the CSV file on the right. Otherwise, you will not be able to import the CSV file to Sana. These fields can be used only to filter the stores and it is not shown on the map. The filters with the list of all additional fields are available to the left of the map. The filters are shown only when the option "Show additional properties" is enabled.

 NOTE

If you use Microsoft Excel to fill in the CSV file with your store locations, please remember that Excel does not handle correctly special characters (after it is saved) that are specific for some languages, for example é, ç, ü. In some cases, it leads to the encoding issues. This is because Microsoft Excel uses your locale's operating system codepage. Therefore, if you have special characters in the store locations, you can use some other editor, for example Notepad, which can handle the special characters correctly, or you can also import your CSV file to Microsoft Excel using the correct encoding. For more information, see "Import or export text (.txt or .csv) files".

Once the CSV file with all the necessary information is ready, you can import it to Sana. While importing store locations, the data in the CSV file is validated. If there is some wrong data in the CSV file, you will see the import summary - the number of successfully imported stores and failed. If some stores are not imported, you will see the reason of failure per line.

 

Once the CSV file with store locations is imported to Sana, clicking on the Export button will export the CSV file with all imported store locations, but not the CSV template.

Translations

When translating the page that contains the Store Locator content element to another language, the default settings of the Store Locator content element will be used for other languages.

Content ElementsStore Locator