Credits:
Current Support Thread at Zen Cart Forums: https://www.zen-cart.com/showthread.php?220781-One-Page-Checkout-Support-Thread
This section identifies how the One-Page Checkout presents itself to your customers and your admin users.
This plugin streamlines the flow that your customers see during your store's checkout process, combining the handling required for the checkout_shipping
, checkout_payment
and checkout_confirmation
into a single-page display.
The plugin's design utilizes standard Zen Cart HTML/CSS layout when rendering its new pages, so the look-and-feel of your store gets "inherited". Some templates make drastic modifications to that layout — removing those standard HTML/CSS selectors — which causes this plugin's newly-added pages to display improperly. The following templates are known to be incompatible with the One-Page Checkout plugin:
One-Page Checkout's installation loads all the plugin's files into the folders associated with the template_default template's use; that way, the processing is available for all templates you might use in your store. If you make changes to those default files, you'll use the Zen Cart "override" system to make your updates. For example, if you're adding a top-of-page message, you'll copy the file /includes/languages/english/checkout_one.php to the /includes/languages/english/YOUR_TEMPLATE folder and make your changes there.
The plugin has been validated on Zen Cart 1.5.4 and Zen Cart 1.5.5a, using the following shipping, order-total and payment methods:
Once you've installed the plugin, an additional item is available in your admin's Configuration menu: One-Page Checkout Settings. The following settings are available:
There are also a couple of constants present in the plugin's language file (/includes/languages/english/checkout_one.php) that you can use to control the checkout_one
page's display. Each of these values are an empty string (i.e. no display produced) as-shipped by the plugin.
p
tag, defines any upper-page instructions you might want to give to your customers.p
tag within a fieldset
tag, defines any lower-page instructions just above the form's submit button.legend
tag; if the value is set as '', no legend is generated.Starting with v1.0.4, the checkout_one_confirmation
page's language file also has an instructional constant that you can use to customize your customers' experience: CHECKOUT_ONE_CONFIRMATION_INSTRUCTIONS. These instructions are displayed just before the page's progress-spinner and should be supplied if your store requires additional time to process.
Note: If you're going to change those constants, be sure to make a template-override copy of the plugin's as-shipped language file so the file isn't mistakenly overwritten on an update to the plugin!
When you've enabled the One-Page Checkout, the customer will see a single-page similar to the image below; the actual layout will depend on the template that is currently active for your store. The customer uses the form to apply any coupon (or gift-certificate) codes, choose their shipping and payment methods and then clicks that "Confirm Order" button … which takes them to a transitional confirmation page and subsequently to the "checkout_success" page. If they've chosen a payment method that accepts credit-cards onsite, then an additional confirmation page is displayed from which the customer re-confirms their order.
Note: Starting with v1.0.4, customers that access your site using a version of Internet Explorer less than 9.0 will continue to see the "traditional" multi-page version of the checkout process.
Click on an area in the image to view additional information about that section, or just scroll down to see that information.
This section identifies the procedure you'll use to install/update or remove the plugin for your Zen Cart.
Notes:
There are core-file and template-override changes required by this plugin; you should always backup your cart's database and files prior to making any changes. Unzip the plugin's package file and then:
/zc155a/includes/classes/payment.php
to your store's copy of /includes/classes/payment.php
, making sure to merge any currently-existing changes prior to the copy.checkout_one
and checkout_one_confirmation
pages, you'll need to edit your template's version of /includes/languages/english/meta_tags.php
and add those two page-names to the end of that constant's comma-separated-list.First, delete the files that were copied to your Zen Cart installation's file-system. Then use your admin's Tools->Run SQL Patches to run the file /docs/checkout_one/uninstall/checkout_one_uninstall.sql
.
This section identifies the files added or modified for this plugin as well as the plugin's change history.
Notes:
The plugin provides the following files in its distribution zip-file:
You can view the details of these changes on the plugin's GitHub repository.
#bannerSix
block is also hidden on the plugin's confirmation page.ROBOTS_PAGES_TO_SKIP
in the readme's installation instructions./includes/languages/english/order_total
to /includes/languages/english/modules/order_total
.jscript_framework.php
gets copied.