PHPackages                             smile/elasticsuite-for-retailer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. smile/elasticsuite-for-retailer

ActiveMetapackage[Search &amp; Filtering](/categories/search)

smile/elasticsuite-for-retailer
===============================

Smile ElasticSuite for Retailers - Magento2 toolkit for Retailers : Store Locator, Availability and Prices per store, etc...

2.4.2(1y ago)18235.4k↑20.4%9[6 issues](https://github.com/Smile-SA/elasticsuite-for-retailer/issues)OSL-3.0PHP ^8.1

Since Mar 20Pushed 1y ago11 watchersCompare

[ Source](https://github.com/Smile-SA/elasticsuite-for-retailer)[ Packagist](https://packagist.org/packages/smile/elasticsuite-for-retailer)[ Docs](https://github.com/Smile-SA/elasticsuite-retailers)[ RSS](/packages/smile-elasticsuite-for-retailer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (11)Versions (32)Used By (0)

News
----

[](#news)

### Compatibility

[](#compatibility)

Due to all new paradigms introduced by Magento 2.1 (entity manager, forms based on UI components, staging for the EE edition, ...), the **required minimum version of Magento for using this module is Magento 2.1**

If your project is based on Magento 2.1.x you can start working with ElasticSuite for Retailer today using the latest **1.2.0-alpha1 release**.

This module support PHP 8.3

### Requirements

[](#requirements)

The module requires:

- [ElasticSuite](https://github.com/Smile-SA/elasticsuite) &gt; 2.11.\*
- [Offer](https://github.com/Smile-SA/magento2-module-offer) &gt; 2.0.\*
- [Seller](https://github.com/Smile-SA/magento2-module-seller) &gt; 2.0.\*
- [Retailer](https://github.com/Smile-SA/magento2-module-retailer) &gt; 2.0.\*
- [Store Locator](https://github.com/Smile-SA/magento2-module-store-locator) &gt; 2.2.\*
- [Retailer Offer](https://github.com/Smile-SA/magento2-module-retailer-offer) &gt; 2.0.\*
- [Store Delivery](https://github.com/Smile-SA/magento2-module-store-delivery) &gt; 2.0.\*

It's a toolkit module to install the RetailerSuite modules.

### How to use

[](#how-to-use)

1. Install the module via Composer:

ElasticSuite VersionModule VersionElasticSuite **2.1.x**Latest release: `composer require smile/elasticsuite-for-retailer:"^1.4"`ElasticSuite **2.3.x**Latest release: `composer require smile/elasticsuite-for-retailer:"^1.4"`ElasticSuite **2.6.x**Latest release: `composer require smile/elasticsuite-for-retailer:"^1.4"`ElasticSuite **2.7.x**Latest release: `composer require smile/elasticsuite-for-retailer:"~1.5.0"`ElasticSuite **2.8.x**Latest release: `composer require smile/elasticsuite-for-retailer:"~1.6.0"`ElasticSuite **2.9.x**Latest release: `composer require smile/elasticsuite-for-retailer:"~2.2.0"`ElasticSuite **2.11.x**Latest release: `composer require smile/elasticsuite-for-retailer:"~2.3.0"`ElasticSuite **2.11.x**Latest release: `composer require smile/elasticsuite-for-retailer:"~2.4.0"`2. Enable it:

`bin/magento module:enable Smile_Offer`

`bin/magento module:enable Smile_Seller`

`bin/magento module:enable Smile_Retailer`

`bin/magento module:enable Smile_StoreLocator`

`bin/magento module:enable Smile_RetailerOffer`

`bin/magento module:enable Smile_StoreDelivery`

3. Optionnal: Drop old SMILE\_RETAILER\_ADDRESS\_RETAILER\_ID unique key

*if you already used older retailersuite modules 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`

4. Install the module and rebuild the DI cache:

`bin/magento setup:upgrade`

How to configure
----------------

[](#how-to-configure)

> Stores &gt; Configuration &gt; Elasticsuite &gt; Elastic Suite for Retailer

Navigation mode: Retailer/Drive
\* Drive mode: the customer will only see the catalog of the chosen retailer in Front Office.
\* Retail mode: the customer will browse the Web catalog by default.
Display offers on product page: Yes/No (When enabled, offers of all stores will be displayed on product page.)

What is ElasticSuite for Retailers ?
------------------------------------

[](#what-is-elasticsuite-for-retailers-)

This package is a suite of several modules aiming to help merchants dealing with retail and omnichannel mechanics in Magento 2 (Store Locator, Product availability/price per store, pickup in store, etc...).

The package relies on our custom Search and Merchandising tool called ElasticSuite which can be found [here](https://github.com/Smile-SA/elasticsuite).

For more information, read **the User Guide "Smile ElasticSuite for retailer"**. It's available [here](https://github.com/vipra93/elasticsuite-for-retailer/blob/master/doc/static/User%20Guide%20Smile%20ElasticSuite%20for%20Retailer%20Magento%202%20v1.pdf).

Who is developping ElasticSuite for Retailer ?
----------------------------------------------

[](#who-is-developping-elasticsuite-for-retailer-)

 [![SmileLab](https://github.com/Smile-SA/elasticsuite/raw/master/doc/static/smilelab-logo.png)](http://www.smile-oss.com)

SmileLab is the innovation and experimentation department of Smile. Smile is the **European leader of Open Source** and also a four-times **Europe Partner of the the Year** (2010-2014) and two-times **Spirit of Excellence** (2015-2016) awarded by Magento.

Our multidisciplinary team brings together experts in technology, innovation, and new applications.

Together we explore, invent, and test technologies of the future, to better serve our clients.

Main Features
-------------

[](#main-features)

### Current version

[](#current-version)

The current **2.4.0** version has been focused on compatibility with Magento 2.4.6:

Some functionnalities example: - **Store Locator :**

    This feature allows you to **create and manage your shops** in Magento's back-office. The module comes by default with several pre-configured attributes such as Shop Address, GPS coordinates, Opening Hours, etc...

    Once you have created all your shops, your customers will be able to navigate through them in the Front-Office on a **map**.

[![Stores Map](doc/static/shop-map.png)](doc/static/shop-map.png)

Each of your stores has also a **Shop detail page** and eventually a **Contact Shop page** if you enable this option on the store.

Your customer will be able to choose his favorite shop and this will keep it during all his navigation through your website.

- **Store Offers:**

    This features let you create **specific offers for a given product and a given shop**: you'll be able to define the price and/or the availability for a product in each shop.

 [![Offer Step one](doc/static/offer-step-one.png)](doc/static/offer-step-one.png) [![Offer Step two](doc/static/offer-step-two.png)](doc/static/offer-step-two.png)

You will be able to enable an option to filter the navigation of the customer to the products available in his favorite shop:

 [![Shop Availability](doc/static/shop-availability.png)](doc/static/shop-availability.png)

The customer will even have the possibility to see **product's availability in the other shops** on the product detail page:

 [![Shop Offer List](doc/static/shop-offer-list.png)](doc/static/shop-offer-list.png)

- **In Store delivery:**

    This feature allow the customer to choose between stores for the shipping address of his order.

 [![Store Delivery](doc/static/home-store-delivery.png)](doc/static/home-store-delivery.png)

This is handled during checkout via a Store chooser in a popin.

 [![Store Delivery](doc/static/store-delivery-chooser.png)](doc/static/store-delivery-chooser.png)

### And more to come!

[](#and-more-to-come)

The next versions that will be coming will include the following features:

- **Shops in autocomplete:**

    We plan to add the shops to the autocomplete box results for faster access.
- **And many more!**

    We will announce and integrate more features to the roadmap soon.

Documentation
-------------

[](#documentation)

Documentation is available [here](https://github.com/Smile-SA/elasticsuite-for-retailer/wiki).

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity44

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~100 days

Recently: every ~291 days

Total

28

Last Release

627d ago

Major Versions

1.6.x-dev → 2.0.02019-10-30

1.7.x-dev → 2.1.x-dev2020-08-25

### Community

Maintainers

![](https://www.gravatar.com/avatar/3c4859b63b960878ef37185d533dbd629247859679dfcdf465259d6a4a488ee7?d=identicon)[romainruaud](/maintainers/romainruaud)

![](https://www.gravatar.com/avatar/53fd29100f3b7087742b99c75f58c5488b95a3858d68636f3ad6d3d8b5f91168?d=identicon)[rbayet](/maintainers/rbayet)

![](https://www.gravatar.com/avatar/eec2e5954b2e6498e1a5c17e39fe41ea5a02382e7224569bc4ddb58c0dd5e20c?d=identicon)[Fdec](/maintainers/Fdec)

![](https://avatars.githubusercontent.com/u/2339173?v=4)[Matthieu Leclercq](/maintainers/mleclercq)[@mleclercq](https://github.com/mleclercq)

![](https://www.gravatar.com/avatar/eef36b94d52b885eb8f4990c77496218b7c3eddf69ea54eeb979770ddda5b8e7?d=identicon)[fadec](/maintainers/fadec)

---

Top Contributors

[![romainruaud](https://avatars.githubusercontent.com/u/15340849?v=4)](https://github.com/romainruaud "romainruaud (12 commits)")[![vipra93](https://avatars.githubusercontent.com/u/23741784?v=4)](https://github.com/vipra93 "vipra93 (9 commits)")[![Fdec](https://avatars.githubusercontent.com/u/5850723?v=4)](https://github.com/Fdec "Fdec (4 commits)")[![livca-smile](https://avatars.githubusercontent.com/u/48252963?v=4)](https://github.com/livca-smile "livca-smile (3 commits)")[![delyriand](https://avatars.githubusercontent.com/u/465524?v=4)](https://github.com/delyriand "delyriand (1 commits)")

---

Tags

magento2magento2-extensionmerchandisingomnichannelretailstore-locatorsearchelasticsearchmagentomerchandisingmagento2retailerstore locator

### Embed Badge

![Health badge](/badges/smile-elasticsuite-for-retailer/health.svg)

```
[![Health](https://phpackages.com/badges/smile-elasticsuite-for-retailer/health.svg)](https://phpackages.com/packages/smile-elasticsuite-for-retailer)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[smile/module-elasticsuite-cms-search

Smile Elasticsuite - Cms Pages Search Module for Smile Elasticsuite.

25916.7k1](/packages/smile-module-elasticsuite-cms-search)[elasticsearch/elasticsearch

PHP Client for Elasticsearch

5.3k178.3M943](/packages/elasticsearch-elasticsearch)[smile/module-elasticsuite-rating

Smile ElasticSuite - Rating search module.

1492.1k2](/packages/smile-module-elasticsuite-rating)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[jsq/amazon-es-php

Support for using IAM authentication with the official Elasticsearch PHP client

9310.6M13](/packages/jsq-amazon-es-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
