Announcement:Materials and articles for ProductCart 5 can be found at our brand new support center.

Create an account to edit articles | See Formatting Syntax for Wiki syntax | We look forward to your contribution!

Mobile Commerce Add-on: installation

Overview

Installing the ProductCart Mobile Commerce Add-on is very easy. The following assumes that you have installed and activated ProductCart on your Web server. If you haven’t done so, you will first need to perform the ProductCart installation (see Quick Start Guide), and then continue with the instructions below.

Download the Mobile Commerce Add-on

Download the latest copy of the Mobile Commerce Add-On from the ProductCart Web site. A link to the file will be provided by ProductCart as soon as the purchase is determined to be legitimate. Due to the high rate of fraudulent orders that a software company like ProductCart receives, we have to personally verify each order. Typically this takes less than an hour, but it may take longer during a weekend or on a holiday

If you purchased the software from a ProductCart reseller, you should have been provided a download link by the reseller, or the reseller may perform the installation for you.

Unzip the files

All ProductCart Mobile Commerce Add-On files are contained in a compressed (*.zip) file. Download and “unzip” the file on your local computer using your favorite unzip utility. If you don’t have an unzip utility, you can download a popular one at the following address: http://www.winzip.com/

Parent Paths Enabled/Disabled

Once you have unzipped the file you will notice that it contains two folders: one called Parent Paths Enabled and one named Parent Paths Disabled. Each folder contains all the files that you need to upload to your Web server to add the Mobile Commerce Add-On to your store.

You will use one folder or the other depending on whether you are using the Parent Paths Enabled (more likely) or Disabled (less likely) version of ProductCart. If you are using the Parent Paths Disabled version of ProductCart, the version number shown on the Control Panel’s Start page should show the letters “PPD”.

For more information about running ProductCart on a server with Parent Paths disabled, click here.

Folder contents

Each of the two folders contains the following sub-folders:

  • m: a new folder that contains most of the Mobile Commerce Add-on files.
  • includes: other files needed by the Mobile Commerce Add-on
  • pc: contains a file used to detect and redirect mobile devices
  • pcadmin: contains the database update script and other Control Panel files. Note that the pcadmin folder is typically renamed.

Upload the files

Now that you are ready to transfer the files, take the following steps:

  1. Back up overlapping files
    You will be overwriting some existing files located in the includes and pcadmin folders (the pcadmin folder has typically been renamed). Make a backup copy of your existing files before overwriting them. Here is a list:
    1. includes/pcPayPalClass.asp
    2. pcadmin/invoicing.asp
    3. pcadmin/ordDetails.asp
    4. pcadmin/pcv4_navigation_links.asp
    5. pcadmin/resultsAdvancedAll.asp
  2. Choose the correct version of ordDetails.asp:
    1. upload ordDetails.asp “as is” if you are running ProductCart v4.1 or higher
    2. use ordDetails_v4.asp if you are running ProductCart v4
      1. rename ordDetails.asp to ordDetails_v41.asp (i.e. you are backing up the v4.1 version of the file)
      2. rename ordDetails_v4.asp to ordDetails.asp (i.e. you are “activating” the v4 version of the file)
  3. FTP the new files to your server
    Upload the Mobile Commerce Add-On files to their respective folders, overwriting the existing files. For instance, you will update the contents of the “includes” subfolder on your Web server with the files contained in the “includes” subfolder that you have received together with this ReadMe file. DO NOT delete any of the files that are currently on your Web server. Note that the pcadmin folder has typically been renamed.

Make sure you are using the correct version of ordDetails.asp. The file is different depending on whether you are using v4.0 or v4.1. See the note above.

Update the database

  1. Log into your ProductCart Control Panel
  2. Load the page “upddb-mobile.asp”
  3. Follow the instructions on the screen
  4. Once the database has been updated, click on the link shown in the confirmation message (shown below) to update the Mobile Commerce Add-on settings.

Mobile Commerce database update script

Configure the Mobile Commerce settings

After updating the database, review and update the Mobile Commerce settings. This is a necessary step before you can start using the Mobile Commerce storefront.

See: Mobile Commerce settings.

PayPal Express Checkout

PayPal Express Checkout for Mobile Devices

The ProductCart Mobile Commerce Add-on requires PayPal Express Checkout.

We have chosen PayPal Express Checkout as the exclusive checkout system for the Mobile Commerce Add-on - at least for now - as it provides a fast, friendly user interface optimized for mobile devices.

You can easily activate PayPal Express Checkout from your ProductCart Control Panel.

Customers can complete a transaction by using their PayPal account or by using a credit card. Customers are briefly taken to a mobile-optimized version of the PayPal log in page where they can log into their PayPal account, if they have one, or chose to checkout using a credit card. They are then taken back to ProductCart to choose a shipping option (if any) and review the order before finalizing it.

Learn more about setting up Express Checkout on your ProductCart store

Add mobile device detection to your store

Now that the Mobile Commerce storefront has been uploaded to your Web server, you need to edit your standard ProductCart-powered storefront to redirect mobile devices to the mobile-optimized version. It's just a small edit to one file. Follow these simple steps:

  • Locate the file inc_header.asp in the pc folder of your ProductCart-powered store
    If you cannot find the file it means that you are not running ProductCart v4. Remember that the Mobile Commerce Add-on requires version 4. You need to upgrade to v4 before you can use this add-on.
  • Download it using your favorite FTP program
  • Make a backup copy of the file
  • Open the file in Notepad or your favorite HTML editor
  • At the top of the source code, you will see the following:
    <%
    private const scIncHeader="1"
    %>

  • Add the following code right below it:

    <%'Mobile-S%>
    <!--#include file="inc_mobiledetect.asp" -->
    <%'Mobile-E%>

  • So the top of the file should now look like this:

    <%
    private const scIncHeader="1"
    %>
    <%'Mobile-S%>
    <!--#include file="inc_mobiledetect.asp" -->
    <%'Mobile-E%>

  • Save the file and upload it back to your Web server, overwriting the existing version. Make sure you do so after you have uploaded the Mobile Commerce Add-on files. Otherwise your storefront will return an error as it cannot locate the ”inc_mobiledetect.asp” file in the folder.
  • The code will detect that a visitor is using a mobile device and redirect them to the mobile-optimized storefront

Stealth mode: if you want to use the Mobile Commerce Add-on in “stealth mode” so you can test it without your customers being redirected to it, simply re-upload the backup version of inc_header.asp. Since that version of the file does not include the reference to the file that performs the detection and redirect, mobile devices will not be redirected to the mobile-optimized storefront. However, you can still reach it with a mobile device by pointing it to the “m” folder.

You're done. The Mobile Commerce version of your storefront can now be reached in the “m” directory in the root of your ProductCart-powered store. Visit your storefront with a mobile device and should be automatically be redirected to the mobile-optimized storefront. Enjoy the Mobile Commerce Add-on!



QR Code
QR Code Mobile Commerce Add-on: installation (generated for current page)