Content ElementsStore Locator

Store Locator

Sana Commerce 9.2
Your connector

Setup Store Locator

Store Locator is a content element which can be added to the web pages (flexi-pages, product and product list 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.

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

Map settings

Field Description
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.
Use full screen width This option is used to show the map on a page in the full-screen mode (full-page width).

 

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.
Pin point location icon The icon for a single store location on the map. There is the default icon, which can be changed.

 

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.
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
  • Google Address
  • Latitude and Longitude
  • Opening Hours

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>

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