January 2011 - Recommended Installation Steps
1.OPTIONAL STEP: Backup your language files in Virtuemart folder /administrator/components/com_virtuemart/languages/common and your basket.php in /administrator/components/com_virtuemart/html/basket.php
2. If you upgrade from a previous version of OPC please backup your OPC template files in /components/com_virtuemart/themes/default/templates/onepage as the default files will get overwritten
3. Install with Joomla installer
4. Go to Components -> One Page Checkout -> Configuration, (optionally change the configuration) and click SAVE
If you don't save the default configuration after install you may get php notices of missing variables at checkout page or javascript errors.
5. Test it -> Make a test order and see if everything is as should be. By default your Virtuemart template files are used to show the checkout. If you want to override them you can follow template installation steps.
Template installation (since version 1.2.146) OPTIONAL
After installing OPC (or upgrading) you can copy content of OPC template files to your own directory in this example path: /components/com_virtuemart/themes/default/templates/onepage/YOURNEWTEMPLATE You can copy these files and directory: onepage.logged.tpl.php, onepage.unlogged.tpl.php, onepage.css, overrides (directory), index.html should be located in every single directory for security reasons.
Overrides directory
You can copy any of your Virtuemart template files here and modify it for One Page Checkout as you want. They will be automatically loaded from here at the checkout page. The only exception are basket files like basket_b2c.tpl.php and basket_b2b.tpl.php, they are searched by file called basket.html.php See the one attached in standard distribution. For basket files to work you must check "override basket" in the configurator or "use shipping as select box in the basket" or "use payment as select box in the basket".
For upgrading from an older version of OPC, you can follow this guide to upgrade template files.
Previous versions
Since October 2010 OnePage Checkout component can be installed via Joomla installer.
Installation
- Install via Joomla installer
- Backup your language files in /administrator/components/com_virtuemart/languages/common and /administrator/components/com_virtuemart/html/basket.php (only files that get modified) New language variables with prefix ONEPAGE will be inserted
- Configure onepage checkout, from a link after sucessfull installtion or from menu and click save. Only changed language variables will be saved. Other files will not be touch. You should get a message "Configuration saved".
- Go to Installation tab and choose installation method:
- shop.cart will overwrite your basket.php and will use your normal basket page as checkout page, everytime a customer click on "add to cart" and "view cart" he will see the cart including checkout
- if you choose redirect to component installation method, the customer after coming to your shop.cart page will be redirected to the component page. The only advantage of this solution is that you can set up itemId of it and disable or enable additional modules in Joomla for this page. Redirect is done by javascript as a test of javascript. You can also add com_onepage to any menu in Joomla and customer will see the basket including checkout there.
If you are upgrading please consider rewrite of your template files in installation tab. We might have added new elements there to support new features.
How to reinstall
- install with joomla installer
- go to Components -> Onepage Checkout -> Configuration
- Choose installation/upgrade tab
- CHECK TO OVERWRITE TEMPLATE (backup manually first)
- select shop.cart as installation method
- click install
IMPORTANT - In all versions !
If you moved templates from default directory to your own template directory, you might need to merge new elements with your designed template. Template files will not get overwritten in your own template directory. For template editing please notice, that for correct functionality of shipping address there must be a checkbox with id "sachone" which indicates whether shipping address should be saved or not.
Description of onepage.cfg.php for manual editting
- onepage.cfg.php variables and language settings are described in the file.
- To find out ids of your payments you will have to search it in your database or in source code of your normal checkout. We recommend Mozilla Firebug plugin. Search for <input id="name of your payment option" ... value="xyz" name="payment_method" > Change variables in config file as following or modify language variables according to configuration section:
$payment_info[payment_id] = "text that is shown above confirm order to explan what will happen after clicking on it. For example: After clicking on the bottom button you will be redirected to PayPal terminal where you will be able to pay with credit card. After payment please click on <b>return to shop</b> so we can update your payment in our system. Please don't use navigation buttons in your browser duting payment."
If you set up $payment_info for a payment id, you MUST set up text on the button as well:
$payment_button[payment_id] = "Proceed to PayPal";
Change language variables according to your needs. $msg1 is standard thank you info, which is shown when there is no payment processing. If standard payment is bank order you can put our bank account information here.
If your button class of "Procced to Checkout" is not ".checkout_link" then you have to find it out. (with firebug or so) If you want to hide "Continue shopping" you can add style for .continue_link {display: none;} as well. Or for mynxx template it is ".cart-checkout-bar"
5. Copy all the files according to the structure in zip file inc. modified onepage.cfg.php to your joomla installation direcotry
6. Insert anything in your basket above minimum order and at first view of basket registration of component in virtuemart functions and classes is done.
Please send bug reports and incompatibilities to onepage (-at-) rupostel.sk
Stan Scholtz, RuposTel s.r.o.
October 2010
