phpCart Currency Test Page

This page is intended as a test of using multiple currencies with phpCart.

Step 1 - Create Multiple Currencies

Go to the Admin Control Panel and select "Currencies" from the Drop Down Box. Enter the currencies you want to use. Choose a Primary Currency and insert any Currency Conversion Rates, if you want phpCart to convert your prices for you.


Step 2 - Create your Product Definitons

If you want to display "add to cart" buttons with prices for each currency, you can use either the html link or html form method. Create product definitions with prices reflecting each currency. Label each cart button with something like: Click this product for US Dollars for button 1 and Click this product for Canadian Dollars for button 2.

If you want to display a single "add to cart" button, you can use the html form method to create a product definition. You just enter your price and add a drop box or radio buttons for a currency selector and add a message like: Choose Your Currency.

For product definitions using html links, just add the currency code in this format:
&currency=usd

For product definitions using html forms, just add the currency code in this format:
<input type="hidden" name="currency" value="usd">


How the cart works

When your customer adds a product to phpCart, it will check if it's the primary currency and if not, it will check if it should perform a currency conversion on it before putting it into the cart.

The cart template has been updated to include this message:
The prices shown are being displayed in X currency

And along side the prices in the cart, the currency symbol displayed will be the one that you entered in the Admin Control Panel.

phpcart will also convert your shipping and tax values if you have a conversion rate set.


Examples

The following examples show the two ways that you can create product defintions for multiple currencies.

In order for this test to run properly, you will need to have both US Dollars and Canadian Dollars in the currency settings in the Admin Control Panel. For testing purposes, you can switch primary on the currencies and add conversion rates to see how they perform.



     

Currency Test with an html link

Test 1: Two Currency Buttons

Holiday Flower Basket

$65.99 (U.S. Dollars)
($3.95 shipping for first item, and $2.95 for subsequent items)

Click here to buy with U.S. Dollars

Click here to buy with Canadian Dollars

Currency Test with html forms

Test 1: Two Currency Buttons

Holiday Flower Basket

$64.99 (in Canadian Dollars)

$65.99 (in U.S. Dollars)

Test 2: One Currency Button with Currency Selector

Holiday Flower Basket
$65.99 (in U.S. Dollars)