/PayPal-Mobile-Plugin-Zen-Cart

PayPal mobile e-commerce in a box plugin for Zen Cart

Primary LanguagePHPOtherNOASSERTION

PayPal Mobile Plugin Installation Instructions

Powered by ezimerchant

  1. Click the 'ZIP' button at the top of this page to download the plugin.

  2. If you haven't already setup PayPal Express Checkout inside your Zen Cart installation, please follow these instructions, if you have already done so, please skip to step 3:

    • a. Login into your PayPal account
    • b. Under the 'My Account' tab, click 'Profile'
    • c. Under the 'Selling Online' section, click the 'Update' button next the API Access line.
    • d. Under Option 2 on the next screen, click 'View API Signature'
    • e. You will use these details on the page to fill out the API credentials in Zen Cart.
    • f. Login to Zen Cart
    • g. Go to Modules -> Payment and click on PayPal Express checkout.
    • h. Use the details from step 2e. and copy and paste the details accross.
    • i. Hit Save.

  3. Unpack the contents of the plugin into your public directory. mobile.php will be in the base of your public directory, while the 'mobile' and 'includes' folder will be subfolders within that.

  4. Make a backup of your current .htaccess file inside your public hosting directory - if you have one.

  5. Merge mobile.htaccess file with your existing .htaccess file (if you already have one). The mobile.htaccess file contains the mobile user agent detection. Note: If you do not have an existing .htaccess file, then rename the mobile.htaccess to .htaccess.

  6. Check the site is still functional on your desktop computer as originally designed.

  7. Check the site on your phone and test the transaction flow.

ZenCart Modifications to support Return to Mobile Site after going back to Desktop.

  1. The steps above inserted three files into your includes directory of your ZenCart store to display a sidebox that would display when a mobile user has come back to the desktop. This allows the user to then return to the mobile site.

    The files have been installed to ZenCart default directories so that user intervention is not needed for the installation to work for all templates. That said, it is in the interest of the site operator to move the following files to the applicable template directory for your template.

    In the below paths, substitute YOUR_TEMPLATE with the name of your template, for example if using earthy-boutique then the first file would be moved to: includes/languages/english/extra_definitions/earthy-boutique/ontechpaypalmobilegoto_sidebox_defines.php

    from: includes/languages/english/extra_definitions/ontechpaypalmobilegoto_sidebox_defines.php to: includes/languages/english/extra_definitions/YOUR_TEMPLATE/ontechpaypalmobilegoto_sidebox_defines.php from: includes/modules/sideboxes/ontechpaypalmobilegoto_sidebox.php to: includes/modules/sideboxes/YOUR_TEMPLATE/ontechpaypalmobilegoto_sidebox.php from: includes/templates/template_default/sideboxes/tpl_ontechpaypalmobilegoto_sidebox.php to: includes/templates/YOUR_TEMPLATE/sideboxes/tpl_ontechpaypalmobilegoto_sidebox.php

  2. Login to your ZenCart folder as a user that can access the Tools->Layout Boxes Controller, make the sidebox visible, and relocate the sidebox as desired.

  3. Check the site on your phone and test the flow to the desktop view and verify that the sidebox appears as desired, then return to the mobile site.

Revert Installation Instructions

  1. Remove the changes to the .htacess file that you have made. Or use the backed up .htaccess to overwrite the changes. This should restore previous functionality in itself.

Optional Steps

  1. Remove the mobile.php file in the root of your public hosting directory.

  2. Remove the mobile subdirectory uploaded previously.