The extension helps shoppers find the nearest physical stores with your products on a handy Google map.
The extension has 2 separate ways of installation, via Composer or by copying the code.
Please follow this Installation Guide to install the extension.
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
Meta Title - define the meta title of the store locator page
Meta Description - specify the meta description of the store locator page
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
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
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
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.
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;
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
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.
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
Before you import locations via a CSV file, you need to prepare the CSV file. You can download our sample import CSV by clicking Download Sample File that is close to Import Settings -> Entity Type field. Select "Store Locator by Ulmod" entity.
Please edit the CSV file to import on google docs or similar tools. If you edit on google docs, make sure to download as CSV (File ⟶ Download as ⟶ Comma-separated values(.csv, current sheet))
|id||Eg. 1||Required to enter data if Import Behavior type: Replace or Deleteis used.
No record will be replaced/delete if empty
|name||Eg. Store Computer Shop||
You can find the list of country codes here.
|address||Eg. 2501 Oakridge Farm Lane||
|status||1 = enabled; 0 = disabled||
Latitude. Leave empty to auto get from address (country, city, zip, address)
Longitude. Leave empty to auto get from address (country, city, zip, address)
Location sort order
|description||Eg: The meats are delicious and fresh!||
Location contact phone
|Eg: [email protected]||
Location contact email
Location website url
Location image. If specified, make sure that the filename exist under "pub/media/ulmod/umlocator/" directory. Eg. pub/media/ulmod/umlocator/storelocation.png. Leave empty for no image
Store view(s) to which the location will be assigned. Use store_id. Eg if you want to assign to the store_id = 1, use this: ,1,
To assign to store ids 1, 2 and 3, use: ,1,2,3,
To assign location to all store view use: ,0,
Location schedule. Replace each time by keeping the format.
Custom location marker image. If specified, make sure that the filename exist under "pub/media/ulmod/umlocator/" directory. Eg. pub/media/ulmod/umlocator/custommarker.png. Leave empty for no custom marker
|show_schedule||1 = yes; 0 = no||
Show schedule in frontend
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:
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 (,)
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.
Once the locations are created, they will display in frontend
Example of locations displaying in the frontend
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
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 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
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
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.
Should you have any questions or feature suggestions, please Contact Us. Your feedback is welcome!