PHPackages                             limesharp/stockists - 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. [PDF &amp; Document Generation](/categories/documents)
4. /
5. limesharp/stockists

ActiveMagento2-module[PDF &amp; Document Generation](/categories/documents)

limesharp/stockists
===================

This is a stockists store locator extension for magento2

2.0.18(1y ago)6765.0k43[10 issues](https://github.com/ClaudiuCreanga/magento2-store-locator-stockists-extension/issues)MITPHPPHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0|~7.3.10|~7.4.0|~8.1.0|~8.2.0|~8.3.0CI passing

Since Jul 30Pushed 10mo ago13 watchersCompare

[ Source](https://github.com/ClaudiuCreanga/magento2-store-locator-stockists-extension)[ Packagist](https://packagist.org/packages/limesharp/stockists)[ Docs](https://github.com/ClaudiuCreanga/magento2-stockists-extension)[ RSS](/packages/limesharp-stockists/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (1)Versions (31)Used By (0)

Magento2 stockists store locator extension
==========================================

[](#magento2-stockists-store-locator-extension)

This is a feature rich stockists store locator extension for magento2.

**Table of Contents**

- [Magento2 stockists store locator extension](#)
    - [Install](#install)
    - [Features](#features)
    - [Usage](#usage)
        - [Basic](#basic)
        - [Import](#import)
        - [Export](#export)
    - [Support](#support)
    - [Demo](#demo)
    - [Uninstall](#uninstall)

Install
-------

[](#install)

```
$ composer require limesharp/stockists
$ composer update
$ php bin/magento setup:upgrade
$ php bin/magento setup:static-content:deploy
$ php bin/magento cache:clean

```

Or you can download the latest zip file from releases, drop it into your app folder, copy the contents of src folder into the main folder and then run the last 2 commands above.

Or you can also get it from the [ magento2 marketplace.](https://marketplace.magento.com/limesharp-stockists.html) (there it is the old version 1.0.6 with less features)

It requires magento 2.2 or above and php 7.1+ (for php 5.6 use v.1.0.6).

Visit the extension website:

**You need to use your own gmaps api key**. Go to  and get your own key and then insert it in configuration &gt; stockists &gt; Gmaps Api Key. Otherwise the map may not work because of Gmaps' daily limits.

Features
--------

[](#features)

- Details: name, address, city, country, postcode, internal link, external link, telephone, email, schedule, description, intro, nearest station, distance;
- Images: upload images of your stores. Two images can be uploaded, one for index page and one for individual store pages;
- Individual store pages on your website;
- Import: import your stores from a csv file;
- Export: export stores to a csv file;
- Interactive map: stores positioned on the map via longitude and latitude;
- Geolocation: show nearest stores to user (in chrome only via https);
- Search: search functionality in the sidebar;
- Directions: show directions from user location to store (driving, walking, cycling or public transport);
- Map Styles: choose from over 10 different map styles to fit your store;
- Breadcrumbs: show/hide breadcrumbs;
- SEO: edit titles, meta descriptions and keywords;
- Url: chose your url where your store locator appears;
- Radius: Select and style your radius in settings;
- Unit: Chose between miles and kilometres;
- Pin: Use custom map pin;
- Responsive: Mobile responsive templates;
- Templates: Choose from 3 different templates;
- Api key: Use your own Gmaps api key for higher traffic;

Usage
-----

[](#usage)

### Basic

[](#basic)

- The default url is /stockists. So once installed go to [www.website.com/stockists](http://www.website.com/stockists) (insert store code if necessary);
- Location in admin is inside content menu &gt; stockists;
- Name, latitude and longitude are required values;
- Bear in mind that chrome and some other browsers allow geolocation services only via https;

### Import

[](#import)

- The csv file needs to be comma separated and values should be quoted;
- check the sample csv file in in [docs folder](https://github.com/ClaudiuCreanga/magento2-store-locator-stockists-extension/tree/master/docs);
- name, latitude and longitude are required;
- country field should be the 2 letter ISO code. Example: GB for United Kingdom and US for USA;
- image should be the path of the image which is built from the first to letters separated by slash and then the name of the image. Example: for image test.png the path is /t/e/test.png. The image should be placed in folder pub/media/limesharp\_stockists/stockist/image/t/e/ (last 2 letters changed of course);
- if you want a stockist to be in multiple stores you can pass the ids of stores comma separated inside the store\_id field;
- To make sure your csv file is formatted correctly, you can open it in a text editor. It should look like this (comma separated and quoted values):

[![csv](docs/images/csv.jpg?raw=true "CSV")](docs/images/csv.jpg?raw=true)

### Export

[](#export)

- Just click export stores and a file will be saved by your browser on your computer;

Support
-------

[](#support)

- I **DO NOT** offer any free technical support in installing or customizing this extension.
- This extention works out of the box with any magento 2.1 site, but depending on your theme it may need further styling.
- If you need help please ask questions on  .

Demo
----

[](#demo)

- Main dashboard:

[![Main dashboard](docs/images/main.jpg?raw=true "Main dashboard")](docs/images/main.jpg?raw=true)

- Location in admin:

[![Locationd](docs/images/location.jpg?raw=true "Location")](docs/images/location.jpg?raw=true)

- Settings:

[![Settings](docs/images/settings1.jpg?raw=true "Settings")](docs/images/settings1.jpg?raw=true)[![Settings](docs/images/settings2.jpg?raw=true "Settings")](docs/images/settings2.jpg?raw=true)[![Settings](docs/images/settings3.jpg?raw=true "Settings")](docs/images/settings3.jpg?raw=true)

- Frontend full page:

[![Frontend](docs/images/front.jpg?raw=true "Frontend")](docs/images/front.jpg?raw=true)

- Frontend store window:

[![window](docs/images/window.jpg?raw=true "Window")](docs/images/window.jpg?raw=true)

- Store Details:

[![window](docs/images/store-details.png?raw=true "Window")](docs/images/store-details.png?raw=true)

- Frontend search:

[![search](docs/images/search.jpg?raw=true "search")](docs/images/search.jpg?raw=true)

- Driving directions:

[![Driving directions](docs/images/directions.jpg?raw=true "Driving directions")](docs/images/directions.jpg?raw=true)

Uninstall
---------

[](#uninstall)

- If you installed it manually:

    - remove the folder app/code/Limesharp/Stockists;
    - drop the tables limesharp\_stockists\_stores (drop table limesharp\_stockists\_stores);
    - remove the config settings. DELETE FROM core\_config\_data WHERE path LIKE 'limesharp\_stockists/%'
    - remove the module Limesharp\_Stockists from app/etc/config.php
    - remove the module Limesharp\_Stockists from table setup\_module: DELETE FROM setup\_module WHERE module='Limesharp\_Stockists'
- If you installed it via composer:

    - run this in console: php bin/magento module:uninstall -r Limesharp\_Stockists.

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance43

Moderate activity, may be stable

Popularity41

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity89

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90.2% of commits — single point of failure

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 ~104 days

Recently: every ~532 days

Total

30

Last Release

602d ago

Major Versions

1.0.16 → 2.0.x-dev2017-04-03

PHP version history (8 changes)1.0.0PHP ~5.6.0|~7.0.0

1.0.7PHP ~7.0.0

2.0.8PHP 7.0.2|7.0.4|~7.0.6|~7.1.0

2.0.13PHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0

2.0.14PHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0|~7.3.10

2.0.16PHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0|~7.3.10|~7.4.0

2.0.17PHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0|~7.3.10|~7.4.0|~8.1.0

2.0.18PHP 7.0.2|7.0.4|~7.0.6|~7.1.0|~7.2.0|~7.3.10|~7.4.0|~8.1.0|~8.2.0|~8.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/d84016b58ff6970512024c05d202bd6af68d631dd704661978455b581d8b8db3?d=identicon)[claudiu.creanga](/maintainers/claudiu.creanga)

![](https://www.gravatar.com/avatar/9718baf2e62228c845f8e3eedfeeb6d29a2d0c60e9c77ebb91a46909b0835d92?d=identicon)[limesharp](/maintainers/limesharp)

---

Top Contributors

[![ClaudiuCreanga](https://avatars.githubusercontent.com/u/7690659?v=4)](https://github.com/ClaudiuCreanga "ClaudiuCreanga (229 commits)")[![vmalyk](https://avatars.githubusercontent.com/u/5318027?v=4)](https://github.com/vmalyk "vmalyk (7 commits)")[![motou](https://avatars.githubusercontent.com/u/1215956?v=4)](https://github.com/motou "motou (4 commits)")[![tasselchof](https://avatars.githubusercontent.com/u/7921861?v=4)](https://github.com/tasselchof "tasselchof (2 commits)")[![juhanihaapala](https://avatars.githubusercontent.com/u/3079827?v=4)](https://github.com/juhanihaapala "juhanihaapala (2 commits)")[![muhammadshakeel](https://avatars.githubusercontent.com/u/4094268?v=4)](https://github.com/muhammadshakeel "muhammadshakeel (2 commits)")[![jajajaime](https://avatars.githubusercontent.com/u/13631233?v=4)](https://github.com/jajajaime "jajajaime (2 commits)")[![LucaGallinari](https://avatars.githubusercontent.com/u/5822554?v=4)](https://github.com/LucaGallinari "LucaGallinari (1 commits)")[![dmitriy-convert](https://avatars.githubusercontent.com/u/36471150?v=4)](https://github.com/dmitriy-convert "dmitriy-convert (1 commits)")[![genfish](https://avatars.githubusercontent.com/u/9285058?v=4)](https://github.com/genfish "genfish (1 commits)")[![ak077](https://avatars.githubusercontent.com/u/40765322?v=4)](https://github.com/ak077 "ak077 (1 commits)")[![piontuso](https://avatars.githubusercontent.com/u/3667397?v=4)](https://github.com/piontuso "piontuso (1 commits)")[![shahabhameed](https://avatars.githubusercontent.com/u/941996?v=4)](https://github.com/shahabhameed "shahabhameed (1 commits)")

---

Tags

csvdriving-directionsgmapsmagentomagento2-extensionstore-locatormagentogoogle mapsmagento2store locatorstockists

### Embed Badge

![Health badge](/badges/limesharp-stockists/health.svg)

```
[![Health](https://phpackages.com/badges/limesharp-stockists/health.svg)](https://phpackages.com/packages/limesharp-stockists)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.6M39](/packages/smile-elasticsuite)[markshust/magento2-module-disabletwofactorauth

The DisableTwoFactorAuth module provides the ability to disable two-factor authentication.

2292.8M9](/packages/markshust-magento2-module-disabletwofactorauth)[magewirephp/magewire

A framework that makes building reactive and dynamic interfaces simple in Magento 2

2601.4M38](/packages/magewirephp-magewire)[redchamps/module-clean-admin-menu

It will merge all third party extensions menu items to single menu item named 'Extensions'.

164438.8k](/packages/redchamps-module-clean-admin-menu)[smile/elasticsuite-for-retailer

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

18240.1k](/packages/smile-elasticsuite-for-retailer)[imaginaerum/magento2-language-fr-fr

Magento2 French Language Pack (fr\_FR)

41749.0k2](/packages/imaginaerum-magento2-language-fr-fr)

PHPackages © 2026

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