support@magestore.com sales@magestore.com Phone: +1-606-657-0768 STORE LOCATOR USER GUIDE Extension version: 1.0 Magento Compatibility: CE 2.0
Table of Contents 1. INTRODUCTION 3 Outstanding Features...3 For Customers 3 For Admin 4 Others 4 2. HOW TO USE 5 2.1. Store Listing Page...5 2.2. Store Detailed Page... 10 3. HOW TO CONFIGURE 12 3.1. Manage Stores... 12 3.1.1. Add Store 13 3.1.2. Edit Store 17 3.2. Manage Tags... 18 3.3. Manage Holidays... 20 3.4. Manage Special Days... 21 3.4. Settings... 22 Store Locator v.1.0 User Guide 2
1. INTRODUCTION You have multiple physical stores and don t know how to give your Customers chances to select their closest one? If so, no need to look any further as our Magento Store Locator extension is exactly the right solution for you. With various search fields and a friendly user interface, Customers can easily locate the most convenient store, such as the one within 5 kilometers of their homes for instance, and then get instant directions on Google map. In particular, Magento Store Locator extension can help promote your stores effectively by allowing Customers to view and give Facebook comments on the store. Outstanding Features For Customers Search for stores easily with various criteria View the list of all stores with custom pin icon on Google map Filter stores by tags Search stores by distance Search stores by country, state/ province, city & zip code Get instant directions from a location to any store Choose the preferable view between map, satellite Access store info in 1 click Access store's official website or social channels such as Facebook View contact details of each store including address, phone, email Notice special promotions of each store in description Know opening hours, days off & special working days Explore store via many photos & Street View mode View and give comments on Facebook Store Locator v.1.0 User Guide 3
For Admin Import stores & locations in mass from CSV files Provide store details such as address, contact info, website, tags, images etc. supported) Promote stores with custom pin, banner, embedded form... (HTML & WYSIWYG Edit store's meta info for better SEO Set store's open times & days off flexibly Choose default search criteria for better experience of customers Change color & map style to fit your theme Others Responsive Magento Store Locator extension (Hot) Magento Store Locator extension supports multiple stores Magento Store Locator extension is 100% Open source License Certificate valid for 1 live Magento installation and unlimited test Magento installations (No license key required). Easy to install and configure User-friendly interface Store Locator v.1.0 User Guide 4
2. HOW TO USE This section shows you how Customers can make use of the Store Locator extension in frontend. The module creates a separate page listing all stores and detailed pages for each store. To go to the Store Listing page, Customers can click on Store Locator on header bar. 2.1. Store Listing Page As can be seen, this page contains 2 main parts: Search and Store List. Store Locator v.1.0 User Guide 5
Search: In this section, Customers can search for stores either by distance from a specific location or by store location such as country, city, etc. After Customers fill in search criteria and click on the Search button, all matching results will be shown. Clicking button Reset will return Customers to the list of all stores. For example, if a Customer wants to search for stores within a 100-mile radius of his location, such as Boston, MA, United States, he simply fills corresponding information into the Search by Distance fields. With Google Suggest integrated, when the Customer enters some first characters into Your Location, a list of matching locations is shown in the dropdown so he can conveniently pick a suitable one. After Customers click on the Search button, the results are shown on both G-map and store list as below: Customers can also get directions to each store by entering a specific location and clicking on the Go button. The detailed directions are as follows: Store Locator v.1.0 User Guide 6
Moreover, customers can see the real street that the store locates in by clicking on Street View link: Store Locator v.1.0 User Guide 7
Store List: This part shows all stores of your site on both list and G-map. Each store is shown with name, address, Street View, Direction link and store image, etc. Customers can click on any store they want to know more in details, t h e n they will be redirected to a Store Detailed page. In addition, store s information can include a link if you provide it in backend. It can be the official website URL, store Facebook fan page URL, etc. so that Customers can view more information about the store. When Customers click on a store on the list, its location is marked on the map by a colored pin. For example, after a Customer selects the Mariana store, the extension will show its location on the map as below: Then Customers can zoom in/ out the map to have a clearer view. Information of a store can be displayed on the map as a tooltip. Customers can turn the tooltip off if they want. Store Locator v.1.0 User Guide 8
Another helpful feature is the Filter by Tags bar at the bottom of the Store Listing page, which allows Customers to narrow down their choice of stores. When Customers click on any tag as preferred, the extension shows stores tagged with that label. This will certainly save much time for Customers from scrolling up and down on the list, especially when the list of stores is too long. Store Locator v.1.0 User Guide 9
2.2. Store Detailed Page Customers will be navigated to the Store Detailed page if they click on the store name they want. On this page, Customers can see store address, opening time, special days, holidays and store images. Besides, Customers not only can view comments about the store but also can give their own comments to discuss with others on Facebook. Similar to the Store Listing page, Customers can get directions to a store by entering their location and clicking on Get Directions to see instructions: Store Locator v.1.0 User Guide 10
Store Locator v.1.0 User Guide 11
3. HOW TO CONFIGURE You have seen how Store Locator works in front-end for customers. The following part will guide you through how to configure and manage the extension in back-end. *New release: One of the most important Google Maps APIs Standard Plan updates implemented on June 22, 2016 was that required future product updates are only available for requests made with an API key. This means active domains created before June 22, 2016, continue to be able to access the Google Maps JavaScript API, Static Maps API, and Street View Image API without an API key. They are not affected by keyless access being unavailable for new domains. However, Google Maps APIs Standard Plan advise all developers to use a key in order to guarantee their quality of service. Applications that continue to make keyless requests may experience some periodic service degradation if other keyless applications' usage spikes and draws down the global unchanged quota. In order to get API key, follow the steps listed here. 3.1. Manage Stores To set up stores with location, opening time and other information, go to Store Locator > Manage Stores. On this Store Manager page, you can view a list that shows information of all stores in your site such as name, address, city, country, zip code and status. Store Locator v.1.0 User Guide 12
You can use the mass action to delete or change status of stores. Besides, you can also export the list of stores to CSV or XML files. 3.1.1. Add Store To add a new store, click on the Add Store button. The Store Information page includes 7 tabs General Information tab: There are 4 fields in this tab including: General Info, Contact Info, Meta Info. o General Info: in this tab you can provide a lot of detailed information about your store to help your Customer locate it easier. Besides important information such as Store name, Description, Status, here are some extra fields you should use to optimize user experience: Store s link: enter a link to the store s official website or social channel such as Facebook fan page. Sort order: Sort the display order of store on the store listing page. The store with higher sort order will be shown first. This value will be used as the Default option of List Store by in Settings. Store Locator v.1.0 User Guide 13
o Contact Info: fill in with the following information about the store in order to allow Customers to contact with store owners or store assistants easier. o Meta Info: allows you to optimize search information in each store s detail page. Store Locator v.1.0 User Guide 14
Image Gallery tab: Upload as many store images as you want. The base image will be shown in the store list. Google Map Location tab: Fill your store s address in this field or pin from the map, remember to click on the Save Store or Save And Continue Edit button to save your work. After that, store s location will be updated automatically on Google Map. There are 4 fields in this tab including Zoom Level, Store Latitude, Longitude and Store Icon. o Zoom Level: It is used when previewing the store s location on Google Map in backend and on the Store Listing page in frontend. The higher number you set, the higher zoom-in level is. o Store Latitude and Store Longitude: You do not need to fill them out if you do not remember your store s coordinates. If you pin a store directly from G-map, these fields will be filled automatically. o Store Icon: You can upload an icon to use as store s marker on G-map instead of the default pin icon. Store Locator v.1.0 User Guide 15
Store s Schedule tab: This tab allows you to choose a Schedule from a list to apply for this store. Let us take Monday for example: o If your store opens on Monday, choose Yes for Open. o If your store opens from 8 am to 10 pm, set Open Time as 8:00 and Close Time as 22:00. o The extension also allows you to set break time for each store if you want. Similarly, you can set opening hours for each remaining day of the week. To quickly set up, click on the Apply to other days button on the top right corner of the Monday section. Other days will have the same working time as Monday. Store Locator v.1.0 User Guide 16
After entering all the necessary data, remember to click on the Save or Save and Continue Edit button to save your work. 3.1.2. Edit Store In order to edit a store, you can click on the Edit link of any store row on the Store Manager grid. Besides existing fields as when you add a new store, you should pay attention to the Google Map tab. When a store is imported or created manually, the system will automatically get the coordinates based on the store address by using Google API. However, in some cases, this way may be not completely accurate. Therefore, the Google Map tab allows you to edit store coordinates manually. Store Locator v.1.0 User Guide 17
If the pin on the map is not in the right place, you can drag and drop it to where you want to set a new location.. After editing, remember to click on the Save or Save and Continue Edit button to save your work. 3.2. Manage Tags Click Store Locator >>> Manage Tag to access Tag Manager. This tab manage all tags that are used to filter stores. Click on the Add New Tag button to create new one. Store Locator v.1.0 User Guide 18
General Information Choose a suitable Tag Name, write a description and upload Icon to make it pop out on store listing page. Stores of Tag Select stores from the list to be shown up when Customers clicking on Coffee tab. Then Save Tag. Store Locator v.1.0 User Guide 19
3.3. Manage Holidays To set days off for your stores, go to Store Locator > Manage Holidays on the menu in backend. You will be navigated to the Holiday Manager page listing all holidays created. Click on Add Holiday to create a new one. On the General Information page: Set the Holiday Name Select the start date and end date of holiday Fill in the Comment field if needed Remember to click on the Save and continue edit button after entering required fields to save your work. On the Stores of Holiday page: tick all stores that you want this holiday to be applied, then Save Holiday Store Locator v.1.0 User Guide 20
3.4. Manage Special Days To set days with special working time for your stores, go to Store Locator > Manage Special Days on the menu in backend. You will be navigated to the Special Day Manager page listing all special days created. Click on the Add New Special Day button to create a new one. On the Add Special Day page: Select the start date and end date of special days Choose open and closing time applied to these special days Remember to click on the Save Special Days button to save your work. * Note: Special days have the highest priority compared with holidays and other days. If a specific date is assigned as both store s special day and holiday, it will be counted as special working day. The store still opens on that date but with special opening hours as you configured. On the Stores of Holiday page: tick all stores that you want this special day to be applied, then Save Special Day Store Locator v.1.0 User Guide 21
3.4. Settings To configure the Store Locator extension, go to Store Locator > Settings on the menu in backend. The configurations here are divided into 3 groups including General, Service API and Store Search. General: Store Locator v.1.0 User Guide 22
No. Field Sample Result 1 Enable Yes Store Locator extension is enabled on your site. 2 Display Top Link Yes Store Locator s top link is shown on your site. 3 List Store by Alphabetical order Distance Store full list and store search result list are sorted by alphabetical order. If Customers search stores by distance, the result list is sorted from the nearest to the furthest ones. *Note: this configuration is not applied to Search by Area and the store full list since Customers do not enter a specific location. Default Store list is sorted based on Sort Order of each store. 4 Page title Locate Store The title of Store Listing and Store detailed pages in frontend is Locate Store. 5 Display holidays and special days in the next 6 List Store page size 30 Stores holidays and special days within the next 30 days will be shown on Store Detailed pages. 10 Show up to 10 stores in store listing page 7 Image gallery 30 Allow to upload up to 30 images for each store. Store Locator v.1.0 User Guide 23
Service API: o To integrate Google API in your site, fill your Google Map API key into this field. You can get this key by following the guide link or going to Store Locator > Guide on the menu in backend. o Choose Yes to enable Facebook comment for your stores. To integrate Facebook social plugin in your site, you must enter Facebook API key into this field. To register this key, please follow the guide link. Store Search: Store Locator v.1.0 User Guide 24
No. Field Sample Result 1 Search criteria Country, Zip Code Customers can search for stores by area using Country and Zip Code criteria. 2 Default Radius for search 100 When searching for stores by distance, if Customers do not specify a radius, the system auto uses the default value and shows stores within the radius of 100 kilometers (or miles). 3 Distance unit Kilometers The unit to measure radius is Kilometer. Now, if you are here, in the last line of our guide, you have completely finished studying our Store Locator extension with all of its striking features! Hope you find this manual useful. -----------------------------------------THE END------------------------------------------- Store Locator v.1.0 User Guide 25