Nice 2Checkout Button Documentation

Getting Started with the Nice 2Checkout Button Plugin

1. If you don't already have one, sign up for a 2Checkout account.

2. Install the Nice 2Checkout plugin using Joomla's extension Manager.

3. Go to Extensions>>Plugin Manager and click into the plugin “System – Nice 2Checkout Button.”

4. Enable the plugin.

5. Add your 2Checkout Seller ID to the Seller ID parameters on the right. Optionally, add your desired 2Checkout supported language code the Language parameter and set test mode for on or off, the default is off.

6.Click the Save button.

Adding a 2Checkout Button Listing

*IMPORTANT – When using 2Checkout's services all the products that you wish to sell must be on record with your 2Checkout account. 2Checkout assigns a product id to each product that you have listed with them. This 2Checkout product id is the id that you use in the button tag.

1. Login to your 2Checkout account

2. Add/Create a new product to sell.

3. Save your new item. Make a note of the product ID.

4. Log in to your Joomla site's admin area and create a new article in Joomla using the Article Manager.

5. In the Joomla Article Editor type in a button tag. When you are finished you should have something that looks like this: {nice2checkout:Buy Now|123}

6. Save your article and go view it from the front-end of the site. You will see a button were your button tag used to be!

Tag Usage

Usage is simple. Create a new article and add your desired content to it. Wherever you want a 2Checkout payment button to appear include this tag {nice2checkout:button text|product_id}.

Example {nice2checkout:Buy It|1}

Full Tag Syntax {nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

Example {nice2checkout:Purchase Now|23|1|Y|single|Y|http://mydomain.com/store/item-23|http://mydomain.com/pg/4}

When using the additional options you may choose to leave any additional item out by simply omitting the information between the pipes “|” that you wish to leave out, e.g. “fixed||skip landing”.

For example if you don't wish to set the payment routine, but want to set the payment to fixed and set the skip landing page parameter, you would use a tag like the one below.

{nice2checkout:Buy Now|123|1|Y||Y}

Tag Parameters

Button Text & Custom Button Graphics

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

The button text parameter sets the text that you want to display on the purchase button.

Example
{nice2checkout:Make a Donation|1}

Alternatively, you can specify a custom button graphic to be used by entering the full URL to the graphic.

Example
{nice2checkout:http://yoursite.com/images/donatebutton.jpg|1}

Product ID

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

In the product id field enter the 2Checkout ID for the product or service in your 2Checkout account.

Example
{nice2checkout:Make a Donation|3}

Or

Example
{nice2checkout:Make a Donation|25}

Quantity

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

The quantity field enter quantity of the product. (99 max value). If left blank the quantity will default to a value of 1.

Example
{nice2checkout:Joomla Coffee Mugs|123|6}

Fixed

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

Set the parameter to Y to remove the “Continue Shopping” button and lock the quantity fields during the buyer's 2Checkout hosted checkout and payment process. Otherwise ,leave this parameter blank.

Example
{nice2checkout:Joomla Coffee Mugs|123|6|Y}

Payment Routine

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

By default the plugin is set for 2Checkout's multi-page payment routine during checkout. To specify 2Checkout's single page payment routine, set the payment routine parameter to “single”. Otherwise, leave this field blank.

Example {nice2checkout:Joomla Coffee Mugs|123|6|Y|single}

Skip Landing Page

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

Entering Y in the Skip Landing parameter will skip the order review page of 2Checkout's purchase routine.

Example
{nice2checkout:Joomla Coffee Mugs|123|6|Y|single|Y}

Return URL

{nice2checkout:button text or custom graphic URL|product id|quantity|fixed|payment routine|skip landing|return url}

Enter a full URL to control where the Continue Shopping button will send the customer when clicked. (255 characters max)

{nice2checkout:Joomla Coffee Mugs|123|6|Y|single|Y|http://yoursite.com/returnpage.php}

63,819

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.