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

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