Nice Google Checkout Documentation

Google announced that Checkout will be discontinued.
"Merchants can continue to accept payments using Google Checkout until November 20, 2013."

Getting Started

Tag Usage & Syntax

Tag Parameter Definitions

International Shipping

Upgrading

IMPORTANT: Starting with version 1.50 for Joomla 1.6 - 2.5 (filename: Joomla_1.6-2.5_nicegooglecheckout_1.50.zip), you no longer need to uninstall your previous version of the Nice Google Checkout plugin before upgrading. Simply install the extension using Joomla's native installer and your installation of the extension will automatically be upgraded. As a precaution, you still need to make a backup of your site's files and database before upgrading. Other than backing up, no special steps are required to upgrade your site.


Getting Started with Nice Google Checkout Plugin

1. If you don't already have one, get a Google Checkout account now.
2. Install the plugin using Joomla's Extension Manager.
3. Go to Extensions>>Plugin Manager and click into the plugin “System – Nice Google Checkout.”
4. Enable the plugin.

Enable Nice Google Checkout Plugin

5. Add your Google Checkout Merchant Id to the parameters on the right.

Enter your Google Checkout Merchant Id in the parameters

6. Optionally add your sandbox sellers Merchant Id if you plan to do testing.
7. Optionally set the test mode to “on” or “off” - default is false.
8. Designate your preferred currency by entering either USD or GBP – default is USD.
9. Optionally set an amount for free shipping.
10. Save your changes.
11. Add the tag code {nicecheckout:item price|item title|image URL|shipping price} to your article where you want the Nice Google Checkout product listing to show up.

Place the Nice Google Checkout tag in your article content.

Add the Nice Google Checkout tag to your article content.

Product listing replaces the Nice Google Checkout tag.

Nice Google Checkout product listing appears where you rplaced the tag.

Google Cart floats in the browsers right hand upper corner on site pages.

Google Cart floats in upper right corner of browser on site pages.

Google Cart expands to display e-customers items.

Google Cart expands to display e-customers items.

Tag Usage & Syntax

Usage is simple. Create a new article and add your desired content to it. Wherever you want a Google Checkout product listing to appear include this tag {nicecheckout:item price|item title|image URL|shipping price}.

Tag Syntax {nicecheckout:item price|item title|item image|shipping price|digital item|weight|options}

For Example

{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|2.50}

Tag Parameter Definitions

Item Price

{nicecheckout:item price|item title|image URL|shipping price|digital item|weight}

Enter the desired price of the item for sale. Omit any currency symbols. Currency symbols will be added for you automatically.

Item Title

{nicecheckout:item price|item title|image URL|shipping price|digital item|weight}

Enter the desired name for your product.

Image URL

{nicecheckout:item price|item title|image URL|shipping price|digital item|weight}

Enter the fully qualified URL for your product image

Shipping Price

{nicecheckout:item price|item title|image URL|shipping price|digital item|weight}

Enter the desired shipping amount to be charged for the item. Omit any currency symbols. Currency symbols will be added for you automatically.

In some instances it may be desired to utilize shipping parameters that are already established within your Google Checkout account. In these instances enter "account" instead of a numerical value.When you use your account settings for calculating shipping you are required to use the weight field as well. Notice that we skip the digital item field in the example below by using a double pipe "||".

For Example

{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|account||1.5}

Digital Item

{nicecheckout:item price|item title|image URL|shipping price|digital item|weight}

For digital items such as ebooks, where there will be no shipping charges or shipping information needed, enter true. Otherwise leave this blank, e.g. {nicecheckout:item price|item title|image URL|shipping price} or enter false.

*Please note that the Nice Google Checkout plugin does not manage downloadable files. It only facilitates the transaction of monies from the buyer to your Google Checkout account.

Weight

{nicecheckout:item price|item title|item image|shipping price|digital item|weight}

The only time you will need to enter a weight is if you are using your Google Checkout account (See Shipping Price above) settings to calculate the shipping for you.

Options

{nicecheckout:item price|item title|item image|shipping price|digital item|weight|options}

The options field allows you to specify product attributes, such as color, size or style. The product attribute options may be non-price changing or may change prices based on specific parameter settings.

To define product attributes you need to use the following syntax:

type;attribute;option:price(optional)

There are 3 types "field" "drop" and "dropprice". Use field to create a text input attributes box. Using the drop type allows you to specify non price changing attributes. Using dropprice allows you to specify price changing attributes.

Example

...|field;engraving;Enter text to be engraved;8}

...|drop;color;red;green;blue}

...|dropprice;size;Sm:13.00;Md:15.00;Lg:17.00;Xl:20.00}

Use ";;" to separate multiple attribute definitions.

Example

...|drop;color;green;red;blue;;drop;style;Crew Neck;V-Neck}

Below are few complete tag examples to get you started.

{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|2.50||.5|drop;color;Green;Red;Blue}


{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|2.50||.5|drop;color;green;red;blue;;drop;style;Crew Neck;V-Neck}


{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|2.50||.5|drop;color;green;red;blue;;drop;style;Crew Neck;V-Neck;;dropprice;size;Sm:16.00;Md:17.00;Lg:18.00;Xl:19.00}

International Shipping

1. If you want to use the new international shipping and have set shipping in your button tags, please remove the shipping value from your tag.

Example

tag with shipping
{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg|10.00}

tag with shipping removed
{nicecheckout:16.00|T-Shirt|http://trinitronic.com/images/t-shirt_example.jpg}

2. Go to Admin>>Extensions>>Plugin Manager>>System - Nice Google Checkout

3. Find the "International Shipping" field in the parameters.

4. Enter one shipping setting per line.

5. Click save.


Shipping setting syntax

Each shipping setting can be one of three types: rate, allow or exclude. Setting the type to "rate" allows you to set a shipping rate. Setting the type to "allow" correlates which countries are allowed to use which "rates". And setting a type to "exclude" tells the system which countries to exclude from which rates.

Rate Type

Syntax
type:rate id number:1st item rate:additional item rate:maximum rate:rate name

Example
rate:1:10.00:5.00::Domestic Ground
rate:2:15.00:6.00:27.00:Domestic Priority
rate:3:16.00:7.00::International Air - Canada, Mexico
rate:4:25.00:8.00:42.00:Global Priority

Note, that you specify rate id number consecutively starting with #1. Each additional id number increases by 1 example 1, 2, 3, etc.

The "1st item rate" relates to the first item purchased by the buyer. Shipping rates for addtional units of the same item are speocified by the "additional item rate". The "maximum rate" is the maximum amount to be charged in shipping. If you don't want to set a maximum rate leave the "maximum rate" field/value blank by using a double column "::", or use a zero value ":0:"

Allow Type

Syntax
type:correlating rate id number:country(s)

Examples
rate:1:10.00:5.00::Domestic Ground
rate:2:15.00:6.00:27.00:Domestic Priority
rate:3:16.00:7.00::International Air - Canada, Mexico
rate:4:25.00:8.00:42.00:Global Priority
allow:1:US
allow:2:CA;MX
allow:3:world

The correlating rate id number is the rate id number of the shipping rate you wish to allow a buyer of a certain country to use.

Specify countries by ISO country code initials. You can specify more than one country by separating them with a semi-colon ";".

ISO Country Code List
http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm

Additionally you can assign a shipping rate to the whole world by substituting the word "world" for a country code.

Exclude Type

Syntax
type:correlating rate id number:country(s)

Example
exclude:4:US;MX

The "exclude" type works exactly the same way as the "allow" type. The only difference is that with the exclude type you are listing countries that you wish to exclude from a particular rate.

Remember each shipping setting needs to appear on its own line. You need to push the enter key after you type out each line. When you put it all together it should look something like the example below.

Example
rate:1:10.00:5.00::Domestic Ground
rate:2:15.00:6.00:27.00:Domestic Priority
rate:3:16.00:7.00::International Air - Canada, Mexico
rate:4:25.00:8.00:42.00:Global Priority
allow:1:US
allow:2:US
allow:3:CA;MX
allow:4:world
exclude:4:US;MX

In the shipping settings example above we have set 4 rates. 2 of the rates are domestic and 2 are international. In this example we set the shipping to allow for US buyers to be able to use the two domestic shipping rates. We then allow Canadain and Mexico to use the "International Air" rate. For buyers in the rest of the world we allow the use of the "Global Priority" shipping rate. Of course we do not want our US buyers to be able to use "Global Priority". So, we have set an exclude statement to, well, exclude them (along with Mexico for the purpose of demonstrating how the multi-country list works with a semi-colon ";").

67,244

total customer downloads. Wow!! That's a lot.

Thanks for all the love! :)

Learn more about our Nice Bundle

Get Our Newsletter!

Get 20% off our Nice Bundle when you sign-up for our free newsletter!

Get Our Downloads!

Checkout our other fantastic downloads

We have spent a lot of time building a bunch of great downloads for you. Take a few minutes and check out some of our fantastic downloads now.