Nice Paypal Buttons

Getting Started with the Nice PayPal Button Plugin

1. If you don't already have one, sign up for a business PayPal account.
2. Install the plugin using Joomla's Extension Manager.
3. Go to Extensions>>Plugin Manager and click into the plugin “content – nicepaypalbtn”.
4. Enable the plugin.

5. Add your PayPal account email to the parameters on the right.
6. Optionally add your sandbox sellers account email if you plan to do testing.
7. Optionally set the test mode to “true” or “false” - default is false.
    * Please note, on some systems it is necessary to enter 1 or 0 instead of true or false. Enter 1 to turn test mode on and 0 to turn it off.

8. Optionally enter your PayPal supported 3 letter currency code – default is USD.
9. Save your changes.
10. Important - If you are using email cloaking then, in the Plugin Manager, you will need to change the order of the Nice PayPal Button plugin is that it appears below the Email Cloaking plugin in the plugin list. Otherwise, the PayPal buttons that the Nice PayPal plugin creates won't display up properly.
11. Add the tag code {nicepaypal:button type|price|item name} to your article where you want the PayPal button to show up.

Place the Nice PayPal Button tag in your article content.

A PayPal button replaces the Nice PayPal button tag.

Basic Tag Usage

Usage is simple. Create a new article and add your desired content to it. Wherever you want a PayPal button to appear include this tag {nicepaypal:button type|price|item name}.

Tag Syntax {nicepaypal:button type|amount|item name}

Examples
 

For a PayPal Buy Now button use this syntax {nicepaypal:buy|5.00|Fluffy Bunny}

For a PayPal Dontation button use this syntax {nicepaypal:donate|0.00|Feed the Children}

Notice that the purchase amount is set to 0, if you set it to 0.00 or leave it blank, e.g. {nicepaypal:donate||Feed the Children}, then the payer will have the option to specify their own donation amount during the PayPal checkout process.

For a PayPal Cart button use this syntax {nicepaypal:cart|5.00|Fluffy Bunny}

Items will be added to the PayPal Cart system as the payer continues to shop, until they checkout. This creates a convenient method for the payer to purchase multiple items from your site and a great way for you to maximize sales.

Extended Tag Usage

This plugin has a number of extended options that make it very flexible and convenient for most merchant's needs.

Extended Tag Syntax {nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

Full Extended Usage Example
 

{nicepaypal:cart|9.95|Delicious Coffee Beans – 1lbs.|sku-1234|4.50|1.25|.73}

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. “item number|||tax”. The example below illustrates an item to be sold utilizing PayPal's cart system with no item number or alternative shipping amount for additional quantities of the same item.

Partial Extended Usage Example
 

{nicepaypal:cart|9.95|Delicious Coffee Beans – 1lbs.||4.50||.73}

The tag above defines a button that is set to buy one pound of coffee for $9.95 with a shipping charge of $4.50 and a tax of $0.73. Note the blank parameters, the missing information between the pipes “||” omits the option from the button.

Tag Parameter Definitions
 

Button type

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

Select between 3 different button operational types; the PayPal Buy Now button, the PayPal Donation button; and the PayPal Cart button. If omitted the button sill default to a “Buy Now” button.

Valid entries are “buy”, “donate”, or “cart”

Amount

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

The price or amount of the product, service, or contribution, not including shipping & handling, or tax. If omitted from Buy Now or Donate buttons, payers enter their own amount at the time of payment.

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

Item name

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

Description of item. If omitted, payers enter their own name at the time of payment.

Item number

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

Pass-through variable for you to track product or service purchased or the contribution made. The value you specify passed back to you upon payment completion.

Shipping

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

The cost of shipping this item. If you specify shipping and shipping2 is not defined, this flat amount is charged regardless of the quantity of items purchased.
This use of the shipping variable is valid only for Buy Now and Add to Cart buttons.
Default – If profile-based shipping rates are configured, buyers are charged an amount according to the shipping methods they choose.

Shipping2

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

The cost of shipping each additional unit of this item. If omitted and profile-based shipping rates are configured, buyers are charged an amount according to the shipping methods they choose.
Valid only for Buy Now and Add to Cart buttons.

Tax

{nicepaypal:button type|amount|item name|item number|shipping|shipping2|tax}

Transaction-based tax override variable. Set this to a flat tax amount to apply to the transaction regardless of the buyer’s location. This value overrides any tax settings set in your account profile. Valid only for Buy Now and Add to Cart buttons. Default – Profile tax settings, if any, apply.