Nice Google Checkout for Wordpress Documentation

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

Installation

Basic Usage

Shortcode Attributes

Shortcode Attribute Definitions

Plugin Options

 

Installation

1. Unzip the Nice Google Checkout plugin.

2. Upload the entire niceGoogleCheckout folder to your wp-content/plugins/ directory.

3. Activate the plugin through the 'Plugins' menu in WordPress.

4. Go to Settings>>Nice Google Checkout.

5. Configure the Nice Google Checkout options, i.e. Google Merchant id, currency, locaiton, etc.

6. Click the "Updates Settings" button.

7. The nice Google Checkout shortcodes in any post or page.

8. That's it! You are all ready to start making money!!

^top

 

Basic Usage

Usage is simple. Create a new post or page add your content to it. Wherever you want a Google Checkout button to appear include a shortcode like the following example. When you view your published post or page the shortcode will be automatically replaced with a corresponding Google Checkout button.

 

Shortcode Example

[nicecheckout name="WordPress Coffee Mug" price="12.50"]

 

Shortcode Syntax

[nicecheckout attribute_name="attribute_value"]

^top

 

Shortcode Attributes

The Nice Google Checkout plugin provides a number of options through the inclusion of 6 shortcode attributes. These attributes are as follows.

  • price
  • name
  • description
  • image
  • digital
  • shipping
  • weight
  • options

Each attribute can be set in the shortcode by including the attribute name followed by an equals sign and the attribute value in quotes.

 

Attribute Example

[nicecheckout name="WordPress Coffee Mug" price="12.50" shipping="4.95"]

[nicecheckout price="17.85" name="WordPress Logo T-Shirt" description="A t-shirt with the WordPress logo." image="http://trinitronic.com/images/t-shirt_example.jpg"]

^top

 

Shortcode Attribute Definitions

price

[nicecheckout price="0.00"]

The price or amount of the product or service, not including shipping & handling, or tax. If omitted from Buy Now payers enter their own amount during checkout on the Google payment page. 

IMPORTANT: Do not enter a currency symbol, just the numerical amount.

^top

 

name

[nicecheckout name="Item Name"]

The name of the item being sold. If omitted, payers enter their own name at the time of payment.

^top

 

description

[nicecheckout description="item description"]

Optionally, use the “description” attribute to specify a description of the item.

 

Example

[nicecheckout description="10oz. coffee mug with WordPress logo."]

^top

 

image

[nicecheckout image="image url"]

Enter the fully qualified URL for your product image.

 

Example

[nicecheckout image="http://trinitronic.com/images/t-shirt_example.jpg"]

^top

 

digital

[nicecheckout digital="false"]

For digital items such as ebooks, where there will be no shipping charges or shipping information needed, enter true. Otherwise omit this attribute.

*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.

^top

 

shipping

[nicecheckout shipping="0.00"]

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, omit the shipping attribute. 

 

Example

[nicecheckout shipping="4.95"]

^top

 

weight

[nicecheckout weight="0.0"]

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

^top

 

options

[nicecheckout options="type;attribute;option:price(optional)"]

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 price="17.85" name="WordPress Logo T-Shirt" description="A t-shirt with the WordPress logo." image="http://trinitronic.com/images/t-shirt_example.jpg" options="drop;color;Green;Red;Blue"]

 

[nicecheckout price="17.85" name="WordPress Logo T-Shirt" description="A t-shirt with the WordPress logo." image="http://trinitronic.com/images/t-shirt_example.jpg" options="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::field;embroidery;Enter text for embroidery;8"]

^top

 

Plugin Options

The Nice Google Checkout plugin allows you to configure the plugin's global settings. Configuration of the plugin is made quick and easy through the use of it's options page. You can find the options page at Admin>>Settings>>Nice Google Checkout. The Global settings that are made available to you are as follows.

 

Google Merchant ID

Enter your valid Google Checkout account merchant id. Payments will be made to the Google Checkout account associated with this specified merchant id.

^top

 

Google Test Merchant ID

Enter your valid Google Checkout sandbox test seller merchant id. This attribute is optional. Test payments will be made to the sandbox account associated with this specified merchant id. To use this feature you must have a Google Checkout developer account.

^top

 

Google Checkout Test Mode

Select on or off to put all Google Checkout buttons in and out of test mode. When true is specified all transactions are sent to the Google Checkout sandbox. To use this feature you must have a Google Checkout developer account.

^top

 

Currency Code

Valid Google Checkout 3-letter currency codes: Pounds Sterling: GBP, U.S. Dollars: USD

^top

 

Default Shipping Price

Enter your default shipping price. Leave blank for no default shipping price.

^top

 

Units of Weight

Specify the units of weight measurement to use. Options are pounds: LB, Kilograms: KG

^top

 

Free Shipping Threshold

Offer free shipping for orders over a set amount of money.

^top

 

International Shipping

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...

 

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 ";").

^top

 

Hide Empty Cart

Select Yes to hide the floating Google Checkout Cart when it is empty. Select No to leave the cart up at all times.

^top

 

Widget CSS

Modify the Google Checkout widget CSS as needed.

^top

64,758

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.