Nice Google Checkout for Wordpress Documentation
Shortcode Attribute Definitions
- Google Merchant ID
- Google Test Merchant ID
- Google Checkout Test Mode
- Currency Code
- Default Shipping Price
- Units of Weight
- Free Shipping Threshold
- International Shipping
- Hide Empty Cart
- Widget CSS
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!!
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"]
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"]
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.
name
[nicecheckout name="Item Name"]
The name of the item being sold. If omitted, payers enter their own name at the time of payment.
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."]
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"]
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.
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"]
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.
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"]
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.
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.
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.
Currency Code
Valid Google Checkout 3-letter currency codes: Pounds Sterling: GBP, U.S. Dollars: USD
Default Shipping Price
Enter your default shipping price. Leave blank for no default shipping price.
Units of Weight
Specify the units of weight measurement to use. Options are pounds: LB, Kilograms: KG
Free Shipping Threshold
Offer free shipping for orders over a set amount of money.
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 ";").
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.
Widget CSS
Modify the Google Checkout widget CSS as needed.
