# Magento2 Store Locator

the best store locator extension for magento2 (and it's free)

# Store Locator

the best store locator extension for magento2

## Installing with composer is easy:

    	$ 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 zip file, drop it into your app folder, copy the contents of src folder into the main folder and then run the last 2 commands above.
- you can also get it from the magento2 marketplace.

Note! It requires magento 2.1 or above and php7 (for php5.6 use v.1.0.6).

You should use your own gmaps api key. Go to https://developers.google.com/maps/documentation/javascript/get-api-key and get your own key and then insert it in configuration > stockists > Gmaps Api Key. Otherwise the map may not work because of Gmaps' daily limits.

## 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

Rated 5/5 based on 11 customer reviews
Free

## Usage

Basic | The default url is /stockists. So once installed go to www.website.com/stockists (insert store code if necessary); | Location in admin is inside content menu > stockists; | Name, latitude and longitude are required values; | Bear in mind that chrome and some other browsers allow geolocation services only via https;
Import | The csv file needs to be comma separated and values should be quoted; | Check the sample csv file in documentation folder; | Name, latitude and longitude are required; | Country field should be the 2 letter ISO code. Example: GB for United Kingdom and US for USA; | The 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); | 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):
Export | Just click export stores and a file will be saved by your browser on your computer

## Demo

- Frontend full page

- Frontend store window

- Store Details

- Frontend search

- Driving directions

- Main dashboard

- Location in admin

- Settings 1

- Settings 2

- Settings 3

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

## Go Get It

Download Now View On Github Download User Guide

* Site theme taken from Slick, thanks!