Welcome!

Thank you for purchasing Dynamo Checkout!

You are just minutes away from optimizing the most important area of your online store -- the checkout. By combining the entire account creation and checkout process into a single page, you have opened the door to maximizing your conversion rates and sending your sales through the roof!

Installation is an extremely simple 7-step process and professional installation and customization is available as well. For more information, please contact: support@dynamoeffects.com

Installation Instructions

Do a complete backup of your store and database before installing this!

STEP #1 - Backup Your Store

1. Completely backup your store AND database and download them to your computer.

STEP #2 - Upload the new files

1. /catalog/checkout.php
2. /catalog/includes/checkout/ (and all files inside)

STEP #3 - Modify /catalog/includes/application_top.php

1. FIND these lines of code around line 52:
   // include the list of project filenames require(DIR_WS_INCLUDES . 'filenames.php');
2. ABOVE those lines, add these lines:
   /* Dynamo Checkout Modification - START */ require(DIR_WS_INCLUDES . 'checkout/checkout.config.php'); /* Dynamo Checkout Modification - END */

STEP #4 - Modify /catalog/includes/classes/order.php

• For osCommerce 2.2MS2, follow these instructions:
  
  
  1. FIND these lines of code around line 147:
     $tax_address_query = tep_db_query("select ab.entry_country_id, ab.entry_zone_id from " . TABLE_ADDRESS_BOOK . " ab left join " . TABLE_ZONES . " z on (ab.entry_zone_id = z.zone_id) where ab.customers_id = '" . (int)$customer_id . "' and ab.address_book_id = '" . (int)($this->content_type == 'virtual' ? $billto : $sendto) . "'"); $tax_address = tep_db_fetch_array($tax_address_query);
  2. REPLACE them with these lines:
     /* Dynamo Checkout Modification - START */ if (!defined('CHECKOUT_ONE_PAGE')) { $tax_address_query = tep_db_query("select ab.entry_country_id, ab.entry_zone_id from " . TABLE_ADDRESS_BOOK . " ab left join " . TABLE_ZONES . " z on (ab.entry_zone_id = z.zone_id) where ab.customers_id = '" . (int)$customer_id . "' and ab.address_book_id = '" . (int)($this->content_type == 'virtual' ? $billto : $sendto) . "'"); $tax_address = tep_db_fetch_array($tax_address_query); } else { global $customer_country_id, $customer_zone_id; $tax_address = array('entry_country_id' => $customer_country_id, 'entry_zone_id' => $customer_zone_id); } /* Dynamo Checkout Modification - END */
• For osCommerce 2.2 RC or newer, follow these instructions:
  
  
  1. FIND these lines of code around line 207:
     if ($this->content_type == 'virtual') { $tax_address = array('entry_country_id' => $billing_address['entry_country_id'], 'entry_zone_id' => $billing_address['entry_zone_id']); } else { $tax_address = array('entry_country_id' => $shipping_address['entry_country_id'], 'entry_zone_id' => $shipping_address['entry_zone_id']); }
  2. REPLACE them with these lines:
     /* Dynamo Checkout Modification - START */ if (!defined('CHECKOUT_ONE_PAGE')) { if ($this->content_type == 'virtual') { $tax_address = array('entry_country_id' => $billing_address['entry_country_id'], 'entry_zone_id' => $billing_address['entry_zone_id']); } else { $tax_address = array('entry_country_id' => $shipping_address['entry_country_id'], 'entry_zone_id' => $shipping_address['entry_zone_id']); } } else { global $customer_country_id, $customer_zone_id; $tax_address = array('entry_country_id' => $customer_country_id, 'entry_zone_id' => $customer_zone_id); } /* Dynamo Checkout Modification - END */

STEP #5 - Modify /catalog/includes/classes/shipping.php

1. FIND these lines around line 36:
   include(DIR_WS_LANGUAGES . $language . '/modules/shipping/' . $include_modules[$i]['file']); include(DIR_WS_MODULES . 'shipping/' . $include_modules[$i]['file']);
2. REPLACE those lines with the following:
   include_once(DIR_WS_LANGUAGES . $language . '/modules/shipping/' . $include_modules[$i]['file']); include_once(DIR_WS_MODULES . 'shipping/' . $include_modules[$i]['file']);

STEP #6 - Modify /catalog/includes/functions/general.php

Note that the lines below may look differently if you have the SEO URL contribution installed. Just make sure that the function is wrapped with the below lines of code.

1. FIND these lines around line 20:
   function tep_redirect($url) { if ( (strstr($url, "\n") != false) || (strstr($url, "\r") != false) ) { tep_redirect(tep_href_link(FILENAME_DEFAULT, '', 'NONSSL', false)); } if ( (ENABLE_SSL == true) && (getenv('HTTPS') == 'on') ) { // We are loading an SSL page if (substr($url, 0, strlen(HTTP_SERVER)) == HTTP_SERVER) { // NONSSL url $url = HTTPS_SERVER . substr($url, strlen(HTTP_SERVER)); // Change it to SSL } } header('Location: ' . $url); tep_exit(); }
2. BEFORE those lines, add this:
   if (!CHECKOUT_ONE_PAGE) {
3. AFTER those lines, add this:
   }

STEP #7 - Modify /catalog/checkout_success.php

1. DELETE the following lines found around line 16:
   if (!tep_session_is_registered('customer_id')) { tep_redirect(tep_href_link(FILENAME_SHOPPING_CART)); }

STEP #8 - CHMOD /includes/checkout/error_log.txt

1. Using your FTP software, go to the /includes/checkout/ directory and chmod the error_log.txt file to 777. If you don't know what that means, refer to your FTP software's help manual.

Do you have STS installed?

Click Here for STS Installation Instructions

Upgrade Instructions

Upgrading Process

1. Download the /catalog/includes/checkout/checkout.config.php file and save it to your computer.
2. Upload the new files to your server, overwriting the old ones.
3. Upload the checkout.config.php file you downloaded back to where it was.
4. Test the checkout and ensure that all features are working correctly.

Configuration

Detailed explanations of each of the configuration settings in checkout.config.php.

• General Settings

  • CHECKOUT_ONEPAGE_ENABLED - Enable or disable the one page checkout. When you disable this checkout, the standard osCommerce checkout takes over.
  • CHECKOUT_IMG_LOGO - The path to the logo that will be displayed throughout the checkout.
  • CHECKOUT_COUNTRY_DEFAULT - The default country that will be selected in the checkout when the page loads. US = 223 and the UK = 222
  • CHECKOUT_AUTO_LOGIN - Set this to "true" if you would like the customer to be automatically logged in after their account is created.
  • CHECKOUT_DISPLAY_CART - Display the shopping cart on the checkout page. Set to "false" to shorten the checkout even more.
  • CHECKOUT_CART_IMAGES - Enable or disable product images in the shopping cart.
  • CHECKOUT_RIGHT_COLUMN - Display or hide the right column in the checkout.
  • CHECKOUT_SEND_BUG_REPORTS - Send bug reports to Dynamo Effects as they're generated. It is highly suggested that you leave this on as it helps to resolve problems in the checkout.
  • CHECKOUT_DYNAMIC_SHIPPING - Set this to "false" if you don't use non-dynamic shipping modules such as the flat rate or per-item shipping module.
  • CHECKOUT_DEBUG_MODE - Used only for development. Should not be enabled in a live store.
  • CHECKOUT_CREATE_ACCOUNT - Enable/disable automatically creating an account during checkout.
  • CHECKOUT_GENERATE_PASSWORD - If an account is to be created, do you want the password auto-generated or not. Benefits to having it automatically generated is that it is one less field on the checkout.
  • CHECKOUT_FORCE_BILLING_ADDRESS - Force the customer to use their billing address as their shipping address.

• Field Settings

  These fields have three possible settings depending on your preference:
  R = Require the field
  O = The field is optional
  H = Hide the field and don't collect that information
  
  
  
  • CHECKOUT_REQUIRE_EMAIL - Email field control setting.
  • CHECKOUT_REQUIRE_COMPANY - Company field control setting.
  • CHECKOUT_REQUIRE_GENDER - Gender field control setting.
  • CHECKOUT_REQUIRE_DOB - Date of birth field control setting.
  • CHECKOUT_REQUIRE_SUBURB - Suburb field control setting.
  • CHECKOUT_REQUIRE_STATE - State field control setting. (R and O only)
  • CHECKOUT_REQUIRE_POSTCODE - Postcode field control setting. (R and O only)
  • CHECKOUT_REQUIRE_TELEPHONE - Telephone field control setting.

• Contribution Settings

  • CHECKOUT_CONTRIB_CCGV - Enable or disable support for CCGV.
  • CHECKOUT_CONTRIB_DISCOUNT_COUPON - Enable or disable support for Discount Coupons.
  • CHECKOUT_CONTRIB_IPISP - Enable or disable support for Order IP Recorder v1.0.
  • CHECKOUT_CONTRIB_STS_4 - Enable or disable support for STS 4.
  • CHECKOUT_CONTRIB_STS_2 - Enable or disable support for STS 2.
  • CHECKOUT_CONTRIB_HOW_DID_YOU_HEAR - Enable or disable support for the "How Did You Hear About Us?" contribution.
  • CHECKOUT_CONTRIB_POINTS_AND_REWARDS - Enable or disable support for the Points and Rewards contribution.
  • CHECKOUT_CONTRIB_OPTIONS_TYPE - Enable or disable support for the product options type contribution.
  • CHECKOUT_CONTRIB_GIFTWRAP - Enable or disable support for the Giftwrap contribution.

Troubleshooting

Common problems and solutions

Q: The standard credit card and money order modules in osCommerce 2.2 RC1 don't show any fields on the checkout page.

A: In later versions of osCommerce, the payment fields were moved from the checkout payment page to the checkout confirmation page. You will need to install earlier versions of these modules (prior to the RC versions) in order to display those fields properly.


Q: When you submit your order, the progress bar doesn't move and the error log shows "Access Denied."

A: Log into the configuration section of your admin and set Configuration -> GZip Compression -> Enable Gzip Compression to false. This product will NOT work with gzip compression turned on.

Still having problems? Browse the Knowledgebase

Requirements

• osCommerce 2.2 MS2 or higher
• PHP 4.3.0+

Supported Contributions

This is a list of contributions that are known to work with this version of Dynamo Checkout. These are not the only contributions that work with Dynamo Checkout, only those that are non-standard in some way and required modifications to either the module or the checkout.

Coupon Contributions

• CCGV(trad)
  Tested Version: 21 May 2007
• Credit Class & Gift Voucher
  Tested Version: 3 Mar 2007
• Discount Coupon Codes
  Tested Version: 27 Sep 2007

Payment Modules

• Authorize Net AIM module (GPL)
  Tested Versions: 3 Aug 2008 & 14 Aug 2008
• PayPal Pro Direct Payments & Express Checkout
  Tested Version: 17 Apr 2008
• CyberSource SOP Module
  Tested Version: 6 Aug 2007
• Protx Direct v2.0
  Tested Version: 4 Aug 2007
• Protx Form
  Tested Version: 24 Feb 2008
• Worldpay 4.0 - V1.0
  Tested Version: 2 Nov 2006
• osCommerce PayPal IPN Module v1.0 For 2.2MS2
  Tested Version: 16 Nov 2007
• Credit Card with CVV2 Traditional
  Tested Version: 17 Oct 2008
• PayPal IPN
  Tested Version: Standard Version with osCommerce 2.2 MS2
• PayPal Standard
  Tested Version: Standard Version with osCommerce 2.2 RC+
• PayPal Express Checkout
  Tested Version: Standard Version with osCommerce 2.2 RC+
• PayPal UK Express Checkout
  Tested Version: Standard Version with osCommerce 2.2 RC+
• GoChargeIt
  Tested Version: 1.0
• SecureHosting
  Tested Version: 7 Jun 2007
• eSec (SecurePay) Australia
  Tested Version: 28 Sep 2005
• Alertpay
  Tested Version: 17 Apr 2007
• Nochex APC
  Tested Version: 15 Dec 2006
• Gateway Services Credit Card
  Tested Version: Standard Version (Required bug fixes)
• Gateway Services Check
  Tested Version: Standard Version (Required bug fixes)
• eWAY XML Payment Module
  Tested Version: 17 Jun 2008 (Requires modifications found here.)
• SagePay Form / Protx Form
  Tested Version: 25 Oct 2009 (The module as tested does not work for non-UK transactions. This is a limitation of the module, not the checkout.)
• Bankpass
  Tested Version: 11 Sep 2008 (Requires modifications found here.)
• Gate2Shop
  Tested Version: 10 Apr 2008 (Available by request from Gate2Shop)

Shipping Modules

• Individual Product Shipping Prices - v1.0
  Tested Versions: 13 Feb 2007

Miscellaneous

• How Did You Hear About Us
  Tested Version: 15 May 2007
• Order IP Recorder v1.0
  Tested Version: 3 Jun 2008
• osC_GiftWrap_v1.0
  Tested Version: 19 Apr 2008
• ## POINTS AND REWARDS MODULE ##
  Tested Version: 19 Jul 2006
• Product Attributes - Option Type Feature
  Tested Version: 7 May 2008
• Simple Template System (STS)
  Tested Version: 23 Jan 2008
• Affiliate Program - Sales Tracking
  Tested Version: 17 May 2003
• Unique Order Number
  Tested Version: 19 Nov 2008

STS Installation

If you use STS, there are a few additional steps you'll need to take in order to make the checkout fully functional.

STEP #1 - Create your new template

1. In your /includes/sts_templates/TEMPLATE_DIR/ directory, copy your default template and rename the copy, "checkout.php.html"

STEP #2 - Add the stylesheet

1. Open checkout.php.html and find the line where your stylesheets are set. It will look like this:
   <link rel="stylesheet" type="text/css" href="stylesheet.css">
2. After that line, add this STS tag:
   $checkout_stylesheet