You're awesome. Can I give you some money?

How do I set up the plugin?

What does Sandbox Mode mean?

How do I find my Merchant ID?

What currency should I use?

How do I add a product to my blog?

What is a shortcode and how do I use one?

Arg! Something isn't working! Help?!

When I add products they don't show up in the products list! What gives?

What's all this about usage data?

Still stuck? Get in touch!

Answers

You're awesome. Can I give you some money?

You're too kind! Of course you can, there is a Donate link at the top of this page that will take you to a page with a link to my PayPal on it. Donations are greatly appreciated and will find you a place in my heart. Right next to my love of programming and The Big Bang Theory.

Back to top

How do I set up the plugin?

The first thing you need to use this plugin is a Google Checkout account. Head on over to Google Checkout and sign in with your Google Account. Once you have an account you need to set up your bank account and verify it (bank account verification can take a few days so don't worry if it doesn't happen instantly).

Next, you should set up your tax settings. This is done in your Google Checkout account under the Preferences in the Settings tab. This plugin does not define any taxing rules so this makes it your sole responsibility to ensure you are taxing your customers correctly.

Next you will want to look into setting up shipping. You can do this either in your Google Checkout account or on each individual item in the plugin. If you are going to do this via your Google Checkout account, you will want to go to Settings > Shipping Setup and follow the instructions there.

Lastly, you need to enter your merchant ID. The plugin will not function at all without your merchant ID. This can be found either in the top right hand corner of the screen when you are logged in to your Google Checkout account or under Profile in the Settings tab. If you are wanting to use Sandbox Mode to test out your system please note that your sandbox merchant ID will be different and there is a box in this plugin's settings page where you can specify this.

Back to top

What does Sandbox Mode mean?

Sandbox Mode is something offered by Google to let you test your Google Checkout system without accidentally processing any orders. You can read more on it here.

(In the "Moving to Production" section of that link, don't worry about the steps they specify. All of that is handled by the plugin provided you have entered the correct merchant ID).

Back to top

How do I find my Merchant ID?

Your Merchant ID can be found either in the top right hand side of your screen when you are logged into your Google Checkout account or under "Profile" in the Settings tab of your Google Checkout account. It will be a long (~15 digits) number.

Back to top

What currency should I use?

I believe that Google Checkout only currently supports the UK and the US. I could be wrong. For now it is advised you use GBP if you are in the UK and USD if you are in the US. If you have any further info on this I'd be glad to hear about it, my email is samwho@lbak.co.uk

Back to top

How do I add a product to my blog?

To add a product to your database and then your blog there are a few easy steps:

1. Click on "Add Products" at the top of this screen and fill out the form.
2. When you have filled the form out and clicked "Add", click on "View Products" at the top of this page, find the product you just added and click "Get Shortcode".
3. Paste this shortcode into a blog post and viola! If you have configured the plugin correctly then your users should now be able to purchase your product.

Back to top

What is a shortcode and how do I use one?

A shortcode is a bit of text you can put in your posts that get filtered and changed into something useful. For example, a lot of forums use "bbcode" which stands for bulletin board code, which is a type of short code. They have tags like [b] for bold, [i] for italic and so on.

LBAK Google Checkout uses its own shortcode system to let you easily post your products to your blog. Simply enter:

[checkout product="1"]

To post the product with an ID of 1 to your blog. The product attribute also supports lists of comma separated values for posting multiple products to your blog. Example:

[checkout product="1, 2, 23, 5"]

This will print out 4 products with the respective 1, 2, 23 and 5 product IDs. Product also supports the "all" value which is seld explanatory . You can also print out everything in a category by specifying the category attribute:

[checkout category="Example"]

This will print out everything in the category "Example". You can combine this with the product attribute to print out items not in the specified category.

Other attributes:
price - let's you specify pricing rules such as price=">20" will only print out products that cost more than 20 of whatever currency it is you are trading in. You can use >, <, >=, <= or specify a range like "x-y" with x and y being 2 numbers, eg "20-30". This can only be used in conjunction with product and or category. Just typing [checkout price="<20"] will show nothing, you would have to do [checkout product="all" price="<20"] to display all of your products under 20 of whatever currency you're trading in.

style - The style attribute will apply CSS styles to the outer most div on the product. This is useful for specifying things like size: [checkout product="all" style="width: 50%"] for example.

Back to top

Arg! Something isn't working! Help?!

A few users have noticed that the plugin breaks when they update. This is because some settings don't always get carried across in the update process. Fortunately, the fix is simple:

Go to the Plugins menu, find the LBAK Google Checkout plugin and deactivate, then reactive it. That should fix most problems.

Back to top

When I add products they don't show up in the products list! What gives?

A lot of people have been reporting this to me recently and I believe I have cornered the cause. When upgrading from a version before multiple pricings to a version after it, the database does not properly add the new columns.

The fix is to deactivate the plugin and then reactivate it (don't worry, this will not affect your product database). this should run the update script and add the right columns to your database and fix the problem.

If it does not, please contact me on samwho@lbak.co.uk and I will try and fix the problem ASAP :)

Back to top

What's all this about usage data?

The LBAK usage statistics is a feature released in version 1.3 to help me get a better idea of who is using the plugin, what they are using it for and primarily for reporting errors back to me.

The information that gets sent to my server varies. At various points in the code I call a function that sends a message to my server and that usually contains your website URL, the page you were viewing, the data that was sent to that page, the time it happened, what PHP version you were using and then a customised message for that log report.

By default you are opted in to sending this data but it is easy to turn it off. Just untick the box labelled "Send usage data?" and data will not be sent to my server.

Back to top