Store Locator for Magento 2

Store Locator

Introduction

The extension helps shoppers find the nearest physical stores with your products on a handy Google map.

Installation

The extension has 2 separate ways of installation, via Composer or by copying the code.

Please follow this Installation Guide to install the extension.

Extension Configuration

Configuration Settings

To access the configuration settings of the extension, log into the Magento Admin panel and go to STORES ⟶ Configuration ⟶ ULMOD EXTENSIONS ⟶ Store Locator.

The module’s configuration contains four sections: General, Links, Map and Product Page

General

Meta Title - define the meta title of the store locator page

Meta Description - specify the meta description of the store locator page

Links

Show Locator Link in Top Links -  set "Yes" to show the store locator link at the top links of the page, and define the Link Text to appear at the top link

Show Locator Link in Footer -  set "Yes" to show the store locator link at the footer of the page, and define the Link Text to appear at the footer link

Map

Google Maps API Key -  insert your Google Maps API Key. Please check how to get the API key at the API Configuration section;

Zoom Levels -  define the initial resolution at which a map will be displayed. Eg: from 1 to 20. You can check the most common values with zoom level of Google Map: here

Search Radius -  define the available search radius values, separated with a comma;

Closed Store Text -  specify the text to appear when a store doesn't work on a specific day;

Use AM/PM for schedule time -  if "Yes", the store schedule time will use the AM/PM format. Eg 6:22 am - 10:05 pm

Product Page

Display location block at product page -  if "Yes", the locator link will show at the product page if there a store is assigned to the product

Location Text -  define the text to appear at the location link. Eg "Available In Stores"

Open URL on new tab -  set to "Yes" to open URL at new tab or page on click, or "No" to open at the current tab

Managing Locations

To view, edit or create a new location, please go to MARKETING ⟶ Store Locator by Ulmod ⟶ Locations.

Click "Add New" button to create a new location. The location contains General, Address, Products, and Schedule tabs.

General

In the General tab the following settings are available :

Active - choose "Yes" to enable the location in the storefront or "No" to disable it;

Name -  defines the name of the location that will be shown on the storefront;

Description -  defines the location description;

Show Schedule - choose "Yes" to show the schedule for this location or "No" to hide it;

Image - upload the location image;

Store Views -  select store views the location will be displayed at;

Sort Order -  specify the position of the location. 0 is the highest position;

Address

Choose the location Country, State/Province and specify the Street, City, Zip/Postal Code, Phone, E-mail and Website Url

Click the Auto Get From Address to automatically coordinates from the address specified above. You can also define the coordinates manually by filling the required Latitude and Longitude values.

Upload a Custom marker to override the default marker for the location. You can choose the desired location marker

Products

You can leave blank (If ALL of these conditions are TRUE :) to assign the location to all products. In case some products are available only in the location, you can add the conditions that the product should meet to be included in this location.

Schedule

In the Schedule tab, you can specify the working schedule for each location

Monday - Friday opening and closing hours

Saturday - Sunday opening and closing hours

Import Locations

To import locations, please go to SYSTEM ⟶ Data Transfer ⟶ Import.

In Entity Type field, select Store Locator by Ulmod. You can Download Sample File to get the example of the correct .CSV file that can be imported. While preparing your CSV import file, make sure that the column headings are spelled correctly.

Specify Import Behaviour:

  • Add/Update - this option is used to add new or update existing data;
  • Replace - this option is used to replace the new data;
  • Delete - this option is used to delete data that already exist in the database;

Choose to Stop on Error or Skip error entries when an error is encountered when importing data

In the Allowed Errors Count field, specify the number of errors that can occur before the import is canceled. The default value is 10

In the Field separator and Multiple value separator accept the default value of a comma (,)

Note: A comma is the default separator in a CSV file. If you want to use a different character, make sure that the data in the CSV file matches the character that you specify.

Mark Fields Enclosure if you want to enclose any special characters that might be found in the data as an “escape sequence

In the Select File to Import field, upload the CSV file that you prepared to import and click the Check Data button.

Frontend View

Once the locations are created, they will display in frontend

Index Page

Example of locations displaying in the frontend

Product Page

If locations are assigned to a product, the location block will display in the product page providing customers with additional information related to physical stores and their details.

The Store Locator extension is responsive to mobile devices and work great regardless the type of screen or device used to view your store

API Configuration

How Configure Google Maps API

To show locations in the map, you'll need to get the Google API Key, please follow these steps:

Please go to Google Cloud Platform and log in

If you have an existing project, select it in the Select a project dropdown, or click the NEW PROJECT button to create a new project

Define the Project Name and click the CREATE button:

Go to Google Places API and Maps JavaScript API and click the Enable button to enable both API

Go to APIs & Services > Credentials, click the Create Credentials dropdown and select the API Key option

A new API Key will be created

Click to open the API created

In the Application restrictions tab select the HTTP Referrers (websites) and add your website name

In the API restrictions tab select the Maps JavaScript API and Places API. You can also select any APIs that can be called with the created key.

Copy the created API key by clicking the ⧉ button and add the API key in the Map -> Google Maps API Key field under the extension settings

Extension Support

Need Help?

Ulmod Support team is always ready to assist you, no matter which part of the world you are in. If something does happen and you think you might be experiencing an issue or bug, please contact us via [email protected] or submit a ticket from our Helpdesk Ticket and we will help you out.

Got Questions?

Should you have any questions or feature suggestions, please Contact Us. Your feedback is welcome!

Extension Product Page