Documentation

RokQuickCart is a simple Javascript based shopping cart on a single page. It hooks directly into PayPal and Google Checkout. It provides very basic cart functionality but with support for different currency types, size and color options, and support for shipping amounts and taxes.

Cart Items

You can setup items that will be in your cart in the RokQuickCart Manager. From here you can create, edit, publish, unpublish, and delete cart items. When editing a cart item you can set all its information, set a full size image for it, and give it a full html description.

Images

When you select an image for the cart item, you can upload it right for the image picker, or use the standard Joomla media manager to upload your images. These images must be in the RokQuickCart directory in order to be accessed by the image picker. Thumbnails for the shelf and cart images are automatically generated based on the sizes you set in the configuration, so all you have to do is upload the full size image of the product you want to sell.

Checkout Methods

RokQuickCart supports both PayPal and Google Checkout as checkout methods.

PayPal

If you wish to use PayPal as a checkout provider you must set up a business PayPal account (at http://www.paypal.com) and provide that business PayPal email to RokQuickCart.

Taxes with Paypal

When using PayPal as a checkout provider, you can add taxes into the RokQuickCart display. These will be passed on to PayPal. The taxes as a simple Tax Amount. The Tax Rate is based on a single unit of currency (1.00). So if you want to do a 10% tax rate, you would set the tax rate field in the configuration to 0.10.

Shipping amounts with PayPal.

Shipping amounts with PayPal are totalled by the cart and passed to PayPal as a line item in the cart. There are four different types of shipping calculation methods:

• Per Item Shipping: Shipping cost is based on the shipping cost per item. If you use a different method, make sure each cart items shipping amount is set to 0.
• Flat Rate: One set shipping price for the whole order.
• Quantity Rate: Shipping cost per item no matter what item it is.
• Percentage of Total: Shipping cost is calculated as a percent of total sales.

The Shipping will be added as a line item

Google Checkout

If you want to use Google Checkout as your cart processor, please follow the instructions on signing up with Google Checkout http://code.google.com/apis/checkout/developer/Google_Checkout_Shopping_Cart_Signing_Up.html. Following these instructions you will signup

At this point, RokQuickCart uses the Google Checkout HTML API. Sp be sure to turn OFF the "Shopping cart post security" as talked about on the Signup Page. This must be turned off for both the Sandbox and Production Google Checkout accounts in order for your cart to be processed.

Taxes and Shipping with Google Checkout

Taxes and Shipping for google checkout are handled in the Google Checkout Setup. It is based on your location and the location of the purchaser. You can customize your tax rates and shipping based on multiple rules that you define. There for only the tax rate is passed to google checkout from RokQuickCart. Google Checkout will only add the taxes and shipping in if you define it to do so in the setup.

Checkout Modes

RokQuickCart provides both Production and Sandbox modes to allow you to easily test your cart and the switch it to production.

SandBox Mode

Sandbox mode allows you to test the cart against the PayPal and Google Checkout Sandboxes. Using your sandbox ids, you can test the carts against the checkout provider and make sure they are working for your needs. When in sandbox mode no real orders will be taken, and no real charges will be applied.

PayPal Sandbox

You can create accounts for the PayPal sandbox at https://developer.paypal.com/. Please see the PayPal developers information on how to setup and use the paypal sandbox. https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/howto_testing_sandbox

Google Checkout Sandbox

You can create a Google Checkout Sandbox account by signing up at http://sandbox.google.com/checkout/sell/signup. Please see the page on working with Google Checkout on a Development Site (http://code.google.com/apis/checkout/developer/Google_Checkout_Basic_HTML_Sandbox.html) in order to get more information on using the Google Checkout Sandbox.

Production Mode

Production mode will make your cart live. You can take orders and charges. It hits the main PayPal and Google Checkout sites.

When switching to Production Mode, make sure you set your Merchant ID or PayPal email to your production accounts.

Legend:

* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note

------- 2.0.0 Release [27-May-2013] -------
+ Added RokUpdater Support

------- 1.3 Release [21-Nov-2012] -------
# Fixed Cart not loading in Panacea Template
# Fixed RokQuickCart price calculation issue while removing items
# Fixed PHP Parse error: syntax error, unexpected T_ENDFOREACH in /var/www/html/administrator/components/com_rokquickcart/views/cartitem/tmpl/edit.php on line 89
# Fixed strict standards error in RokQuickCartModelCartItem::prepareTable()
# Fixed language string missing for menu item type
+ Joomla! 3.0 Compatibility 

------- 1.2 Release [13-Mar-2012] -------
# Missing buttons in Joomla 1.7/2.5
# some colors not loading on rokquickcart page
# template html overrides for 1.7/2.5 are broken

------- 1.1 Release [16-Dec-2011] -------
# Missing Language strings for com_menus
# installer broken

------- 1.0 Release [10-Nov-2010] -------

! Initial Release

Legend:

* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note


------- 1.3 Release [17-Aug-2010] -------

+ Added new paypal currencies
+ MooTools 1.2 compatibility


------- 1.2 Release [30-May-2009] -------

+ Added shelf and car image height and width functions
# Replaced eregi references with preg due to deprecation


------- 1.1 Release [07-Sep-2009] -------

^ Moved thumbnail creation to cache dir for better compatibility
# Fixed item description not saving html markup.


------- 1.0 Release [31-Aug-2009] -------

! Initial Release