VPCart Store Locator

Created : 24 March 2023
Last Modified : 24 March 2023

***********************************************************************************
Contents:

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW IT WORKS
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I. TROUBLESHOOTING
J. FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS


***********************************************************************************

A. SUMMARY
==========

VPCart Storelocator streamlines the process of guiding customers to your store locations, dealers, or distributors via desktop, mobile, or tablet devices, utilizing Google maps and directions. It allows you to add locations from anywhere in the world to increase your global reach.


Key features of VPCart Storelocator include:


***********************************************************************************

B. FILE STRUCTURE
===================

Files included in the zip are:
- $READ_ME_FIRST_storelocator900.HTML
- shoplocator.asp
- admin/storelocator_setup.asp
- admin/storelocator_setup_config.asp
- admin/storelocator_setup_process.asp
- admin/help/shoph_editrecord.asp
- admin/sqlscripts/storelocator/*

***********************************************************************************

C. INSTALLATION INSTRUCTION
============================

1. Upload below files to your VPCart site:
- shoplocator.asp
- admin/storelocator_setup.asp
- admin/storelocator_setup_config.asp
- admin/storelocator_setup_process.asp
- admin/help/shoph_editrecord.asp
- admin/sqlscripts/storelocator/*

2. Log into super admin and execute page below:
http://www.yourdomain.com/<your admin folder>/storelocator_setup.asp

Note: Replace the below with your VPCart site
{ www.yourdomain.com } : your site domain
{ your admin folder } : your admin folder

Click Install Now button.
On this installation process, A new table storelocator will be created.
Also a new config xstorelocator_enable will be added.
Please make sure to set this config xstorelocator_enable = Yes.

3. You will need to add a new admin menu for the Store Locator.

3a. Go to: Advanced Settings > Admin Navigation > Level 2 >
3b. In the " " dropdowns, please select: Store
3c. Then in the bottom form menu, please add this new menu:

Name: Store Locator
File Name: shopa_editdisplay.asp?table=storelocator
: Store Locator
: 09

3d. Click Add New Menu.
3e. Go to: Advanced Settings > Admin User Management > You should see the list of your admin users.
3f. Click edit for an admin user you want.
3g. In the " " Expand the Store, then tick/check the new menu "Store Locator"


3h. You can now see the new menu "Store Locator" under the Store dropdowns.



4. You will need to add a new front store menu for the Store Locator.
4a. Go to admin menu: Website > Menu Manager
4b. Click Add.
4c. Fill in new menu below:

: Custom
: Store Locator
URL: shoplocator.asp
Sequence Number: 80

4d. Click Submit button.

5. Open your file shopa_editrecord.asp located in your admin folder, using a notepad or text editor.
5a. Locate this code:

elseif (lcase(DBTable) = "gifts") then

5b. BEFORE the code above, please insert this:

elseif (lcase(DBTable) = "storelocator") then
helpstring = ""
select case lcase(fieldname)
case "storename"
helpstring = "document.all.help_storelocator_storename"
case "storelocation"
helpstring = "document.all.help_storelocator_storelocation"
case "storephone"
helpstring = "document.all.help_storelocator_storephone"
case "storeemail"
helpstring = "document.all.help_storelocator_storeemail"
case "storegmapaddress"
helpstring = "document.all.help_storelocator_storegmapaddress"
end select

5c. Save the file and upload back to your site.

6. Please make sure the following existing Google Maps configs to be set:

xGoogleMap = Yes
xGoogleMapAPIKey: Enter your Google Map Api Key.
Go to https://developers.google.com/maps/faq?csw=1#using-google-maps-apis to learn how to generate Google Map API key.
xGoogleMapZoomLevel = enter a zoom level. Default is 14.

7. This is optional. If you want your Store Locator page in front store to show without the left / right column so that the Google Map can display bigger, follow these:

7a. Go to admin menu: Website > Layout Manager >
7b. Locate "CONTENT LAYOUT CMS FORM " > Choose Checkout on first dropdowns then on next dropdown choose Edit.



7c. Click Action button.
7d. In the , enter shoplocator.asp and click Save Page button

.
7e. Click Save Changes.

8. Last change, you will need to update a CSS file. Please follow these:
8a. Open file main-responsive.css located in templates/default/css folder using a notepad or text editor.
8b. Locate this code:

#contactgooglemap #googlemap {
width: 100% !important;
}

8c. Directly BELOW it, please insert:

#contactgooglemap .googlemap {
width: 100% !important;
}

8d. Save the file and upload back to your site.

9. You are done.

***********************************************************************************

D. HOW IT WORKS
===============

You can start adding new store location from your administration after you have follow the installation above.
Go to admin menu: Store > Store Locator

Click Add a record button.

Then enter the details for your first store eg:

storename : Enter your store name eg VantageZ
storelocation : Enter your store address eg 123 Main St, Beverly Hills, CA US 90210
storephone : Enter your store phone eg 1-572-416-8988
storeemail : Enter your store email eg [email protected]
storegmapaddress : On your computer, open Google Maps, search your store, then Right-click your store on the map. You can find your latitude and longitude in decimal format at the top. Your value should be in format eg 38.8440851500402, -104.76223188726334

To view the store locator just load the page shoplocator.asp in your front store.

***********************************************************************************

E. CONFIGURATION SETTINGS
=================
xstorelocator_enable

F. DATABASE TABLES MODIFIED
===========================
New table storelocator with fields below:
[id] primary key
[storename] [nvarchar] (255)
[storelocation] [nvarchar] (4000)
[storephone] [nvarchar] (30)
[storeemail] [nvarchar] (255)
[storegmapaddress] [nvarchar] (4000)

G. LANGUAGE SETTINGS CHANGED
============================
NONE

H. CHANGE LOGS
============================
NONE

***********************************************************************************

I. TROUBLESHOOTING
============================
Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.

***********************************************************************************

J. FAQ
============================
NONE

***********************************************************************************
K. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2023 Rocksalt International Pty. Ltd.
All rights reserved.

This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .

LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.

Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.


***********************************************************************************

L. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.

THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.

LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.

LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.

LIMITATION OF LIABILITY.

ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.

IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.