📊 State of Magento 2025

The Home for Magento 2 Excellence

Quality-tested Magento 2 modules. Explore. Evaluate. Elevate. #magento2

613 Modules
401 Ready
211 Need Help
🏆 Leaderboard
Top 10% by Downloads Stale v2.2.1

Module 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.

508,355
Downloads
2x above avg
51
GitHub Stars
Above average
2y ago
Last Release
36
Open Issues
Build Passing
Ready to install

Build Tests

Composer Install
DI Compile
Templates

Code Quality

CS Coding Standard
1091 warnings
PHPStan Failed

Tested on Magento 2.4.8-p3

Recent Test History

Each release is tested against the latest Magento version at that time.

v2.2.1 on Magento 2.4.8-p3
Dec 28, 2025

Share This Module's Status

Module Store Locator Magento compatibility status badge

README

Loaded from GitHub

Smile Store Locator

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

Requirements

The module requires:

How to use

  1. Install the module via Composer:

composer require smile/module-store-locator

  1. Enable it:

bin/magento module:enable Smile_StoreLocator

  1. 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

  1. 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

This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.