Store Locator

smile/module-store-locator

Adds a store locator to your website, allowing customers to find retailers on a map. Requires the Retailer and Map modules.

No errors foundPHPStan level 2Build passingSemVer violations (90% compliant)

Supported Magento versions: 2.4.9
License: OSL-3.0
Categories: Search

551,958 installs★ 49 stars5,588 downloads/monthLatest: v2.2.3Released 2026-07-22

composer require smile/module-store-locator

README

Reproduced from the package’s own README, under its own license, as of 2026-10-31. Links and images point back at the source repository.

Smile Store Locator

This module adds a store locator to the website. You can search a retailer on map.

Requirements

The module requires:

Retailer >= 2.0.*
Map >= 2.1.*

How to use

Install the module via Composer:

composer require smile/module-store-locator

Enable it:

bin/magento module:enable Smile_StoreLocator

Optionnal : Drop old SMILE_RETAILER_ADDRESS_RETAILER_ID unique key:

if you already used older Smile_StoreLocator module on your projects, and you want to upgrade it, before upgrading, you will have to DROP your current UNIQUE KEY from table smile_retailer_address : SMILE_RETAILER_ADDRESS_RETAILER_ID This is necessary in order to get a db_schema.xml working correctly.

ALTER TABLE smile_retailer_address DROP INDEX SMILE_RETAILER_ADDRESS_RETAILER_ID

Install the module and rebuild the DI cache:

bin/magento setup:upgrade

How to configure

Stores > Configuration > Services > Smile Map > Map Settings

Maximum number of visible stores: Above this limit, the list of stores will be not display

Add autocompletion

To add autocompletion you need to add this module:

RetailerSearch /!\ be careful with dependencies