Shortcode Attribute Definitions
- PayPal Account Email / Merchant Account ID
- PayPal Test Mode Email / Test Merchant Account ID
- PayPal Test Mode
- Currency Code
- PayPal Country Code
- Button Language Code
- Default Button Size
- New Window Target
Usage is simple. Create a new post or page add your content to it. Wherever you want a PayPal 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 PayPal button.
[nicepaypallite name="WordPress Coffee Mug" amount="12.50"]
The Nice PayPal Button Lite plugin provides a number of options through the inclusion of 8 shortcode attributes. These attributes are as follows.
Each attribute can be set in the shortcode by including the attribute name followed by an equals sign and the attribute value in quotes.
[nicepaypallite name="WordPress Coffee Mug" amount="12.50" shipping="4.95"]
Shortcode Attribute Definitions
[nicepaypallite name="Item Name"]
The name of the item being sold. If omitted, payers enter their own name at the time of payment.
The price or amount of the product, service, or contribution, not including shipping & handling, or tax. If omitted from Buy Now payers enter their own amount during checkout on the PayPal payment page.
*IMPORTANT:* Do not enter a currency symbol, just the numerical amount.
The id number or sku number for your item. A 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.
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.
Default – If profile-based shipping rates are configured, buyers are charged an amount according to the shipping methods they choose.
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.
Transaction-based tax override variable. Set this to a flat tax to the transaction regardless of the buyer’s location. This value overrides any tax settings set in your account profile.
Default – PayPal profile tax settings, if any, apply. To use your PayPal account tax settings simply exclude the tax attribute.
The number of items or item quantity included in the purchase. For example, if you wanted to sell 10 golf balls at once, you would set the item quantity to 10.
The weight of the item. If PayPal account based shipping rates are configured with a basis of weight, the sum of weight values is used to calculate the shipping charges for the transaction. To enable PayPal account based shipping exclude the shipping and shipping2 attributes. After which you can optionally specify a item weight by entering a numerical (float) weight value, e.g. 1.5.
You may specify pounds or kilograms by adding a suffix of lbs or kgs to your weight value. If no suffix is provided the units of weight will default to pounds.
The Nice PayPal Button Lite 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 PayPal Button Lite. The Global settings that are made available to you are as follows.
PayPal Account Email / Merchant Account ID
Enter your valid PayPal account email address. Or, enter your valid Merchant Account ID, which you can find in your PayPal account profile under My Business Info. Payments will be made to the PayPal account associated with this specified email address or merchant id.
PayPal Test Mode Email / Test Merchant Account ID
Enter your valid PayPal sandbox test seller email address. Or, enter your valid Merchant Account ID, which you can find in your PayPal sandbox account profile under My Business Info. Test payments will be made to the sandbox account associated with this specified email address. To use this feature you must have a PayPal developer account.
PayPal Test Mode
Select on or off to put all PayPal buttons in and out of test mode. When on is specified all transactions are sent to the PayPal sandbox. To use this feature you must have a PayPal developer account.
Valid PayPal 3-letter currency codes: Australian Dollars: AUD, Canadian Dollars: CAD, Euros: EUR, Pounds Sterling: GBP, Yen: JPY, U.S. Dollars: USD, New Zealand Dollar: NZD, Swiss Franc: CHF, Hong Kong Dollar: HKD, Singapore Dollar: SGD, Swedish Krona: SEK, Danish Krone: DKK, Polish Zloty: PLN, Norwegian Krone: NOK, Hungarian Forint: HUF, Czech Koruna: CZK, Israeli Shekel: ILS, Mexican Peso: MXN.
PayPal Country Code
Enter your 2 digit country code to set the language used on the PayPal payment page. PayPal uses a two-character country code (ISO 3166). Some examples are United States: US, Great Britain: GB, France: FR, Spain: ES, Netherlands: DL, Poland: PL, German: DE. If you don't know your country code, or you can Google PayPal Country Codes.
Button Language Code
PayPal uses a 5 character code to designate the language of its buttons. For example, United States English is designated with en_US. Enter the 5 character code for the desired button language. Other code examples are Great Britain English: en_GB, French: fr_FR, Spanish: es_ES, Dutch: nl_NL, Polish: pl_PL, German: de_DE. If you don't know the code for your desired language, log into PayPal use the button creater and search the resulting HTML code for this https://www.paypal.com/en_US/i/btn/btn_buynow_LG.gif. Notice the en_US in the URL, it's the language code for the button.
Default Button Size
Select the default button size. You can choose between Small and large.
New Window Target
Choose how you want the buyer to be sent to PayPal, either in their current browser window or a new browser window.