mohsinrasool / paypal-pay-buy-donation-and-cart-buttons-shortcode Goto Github PK

=== PayPal Pay Now, Buy Now, Donation and Cart Buttons Shortcode === Contributors: mohsinrasool Donate link: http://mohsinrasool.wordpress.com/2013/01/11/wordpress-shortcode-for-paypal-pay-buy-donation-and-cart-buttons/ Tags: paypal, pay now, buy now, add to cart, shopping cart, donation, donate, pay button, cart button, paypal payment, paypal checkout, donate now Requires at least: 3.0.1 Tested up to: 6.3.1 Stable tag: 1.7 Author: Mohsin Rasool License: GPLv2

Adds a shortcode to display PayPal's pay now, buy now, donation and add to cart buttons with facility to customize your PayPal checkout page.

== Description ==

This plugin adds "paypal_button" shortcode to display pay now, buy now, donation and add to cart PayPal buttons with facility to customize their PayPal checkout page. Handy features of the plugins are

• Four types of button Pay Now, Buy Now, Add to Cart, Donation
• Customizable quantity field which is available as text box and drop down box with possible selected values or range of values for all types of buttons
• Customizable PayPal Payment Button
• Customizable PayPal Checkout page, change header logo and page color etc
• Output can be a PayPal form with Default or Customizable PayPal button or a URL to PayPal payment/cart page that can be used on linked texts
• All type of PayPal button options i.e. large, small, with and without Credit Card Logos
• Set Thank you page after successful payment to return the user back to your website
• Set Handling and Shipping charges
• Allow buyer to add a note to order
• Select language of your button. Supports 17 widely used languages
• Both Admin generated amount (based on quantity) and user filled amount payments

Plugin also adds a [paypal_view_cart_link] shortcode to be used to create view cart buttons.

Possible usage of the plugin are as follows

Pay Now Button: [paypal_button type="paynow" amount="100"]
Buy Now Button: [paypal_button type="buynow" name="WordPres Portfolio Theme" amount="100"]
Donation Button: [paypal_button type="donate" amount="100"] 
Add to cart Button: [paypal_button type="cart" name="Computer Table" amount="100"]
Payment Link: [paypal_button type="buynow" name="WordPres Portfolio Theme" amount="100" echo_link=1]

View Cart Link: <a href="[paypal_view_cart_link]">View Cart</a>

Set your PayPal E-Mail address and Checkout page customization in Settings->PayPal Buttons.

= Usage =

[paypal_button type="paynow|buynow|donate|cart" amount="100"]
<a href="[paypal_view_cart_link]">View Cart</a>

= Attributes =

**type**: 
(string) (optional) Type of transaction. Allowed Values are 
Possible Values: 'paynow', 'buynow', 'cart' or 'donate'

**id**: 
(string) (optional) Product Number
Possible Values: Any numeric product id

**email**: 
(string) (optional) Your PayPal E-Mail address. 
Possible Values: A valid PayPal E-Mail address

**name**: 
(string) (optional) Name of the Product
Possible Values: Any String

**amount**: 
(numeric) (optional) Product price to be charged. Yes, you can left empty for user to input amount. This can be used for donations.
Possible Values: Any numeric value

**quantity**: 
(numeric or string) (optional) Specfiy quantity as number or range or possible comma separated values. Leave empty to let user specify any quantity.
Possible Values: "1" or "1,5,10" or "1-10"

**quantity_txt_postfix**: 
(string) (optional) Post fix text to be shown in quantity dropdown.
Possible Values: " items" or " products"

**field_sep**: 
(string) (optional) HTML code to separate the generated visible HTML fields. Use "<br />" for new line.
Possible Values: "&nbsp;" or "<br />"

**amount_prompt**: 
(boolean) (optional) Setting to "1" will enable user to enter amount they would like to pay.
Possible Values: 1 or 0

**echo_link**: 
(boolean) (optional) Set to "1" for linked output
Possible Values: 1 or 0

**open_new_window**: 
(boolean) (optional) Set to "1" to open payment page in a new window
Possible Values: 1 or 0

**currency**: 
(string) (optional) Currency of the Transaction. 
Possible Values: 'USD' or 'CAD' or any currency code

**tax_rate**: 
(numeric) (optional) Tax rate in percentage applied to the total price.
Possible Values: 0.0001 to 100

**shipping_charges**: 
(numeric) (optional) Shipping charges for the product. 
Possible Values: Any numeric value

**btn_url**: 
(string) (optional) Set URL of your own customizable button. Global setting is used when left empty or default PayPal Button
Possible Values: A URL to an image

**btn_size**: 
(string) (optional) Set size of the button either 'large' or 'small'.
Possible Values: 'large' or 'small'

**btn_display_cc**: 
(string) (optional) Display Credit Cards Logo under the button.
Possible Values: 'yes' or 'no'

**add_note**: 
(string) (optional) Let buyer add a note to order.
Possible Values: 'yes' or 'no'

**thankyou_page_url**: 
(string) (optional) Buyer will be redirect to this page after successful payment.
Possible Values: An absolute URL e.g. http://abc.com/thankyou

**checkout_logo_url**: 
(string) (optional) URL to your Logo image.
Possible Values: An absolute URL e.g. http://abc.com/logo.png

**checkout_header_border_color**: 
(string) (optional) Set border color of the checkout page header.
Possible Values: A HTML Hexa-decimal code. e.g. FFFF00, 999999 etc

**checkout_header_bg_color**: 
(string) (optional) Change background color of the checkout page header.
Possible Values: A HTML Hexa-decimal code. e.g. FFFF00, 999999 etc

**checkout_bg_color**: 
(string) (optional) Change background color of the entire checkout page.
Possible Values: A HTML Hexa-decimal code. e.g. FFFF00, 999999 etc

== Installation ==

This section describes how to install the plugin and get it working.

1. Upload paypal-pay-buy-cart-buttons folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. You can now use "[paypal_button]" shortcode.
4. Visit Settings page to set the default values and merchant information.

== Frequently Asked Questions ==

= Do I need a PayPal Account? =

Yes, You do need a PayPal account to receive payments. Please visit http://paypal.com to sign up.

= Does it support all PayPal buttons =

It supports Pay Now, Buy Now, Donate and Add to Cart Buttons.

= How can I put my logo on checkout page using this shortcode? =

You can use Logo URL field in the admin settings to place your logo on checkout page. Please make sure it is not bigger than 750x90;

== Screenshots ==

1. Different flavors of the shortcode
2. Settings page in Admin -> Settings -> PayPal Buttons
3. Sample PayPal checkout page with logo replaced

== Changelog ==

= 1.7 =

• Backword compatiblity
• Latest WordPres Tested

= 1.6 =

• Backword compatiblity
• Latest WordPres Tested

= 1.5 =

• Added filters
• Added feature to open payment page in a new window
• Added feature to allow for user entered payments.

= 1.4 =

• Added support for 17 languages for PayPal buttons.
• Added CSS classes for customization.

= 1.3 =

• Customize the Payment Button. Set your button's URL either in settings page or in shortcode
• Fix Javascript error of quantity when used with buy now and cart buttons.

= 1.2 =

• Added quantity support for drop down box.
• Added support for payment using URL. You can now use it in achor tag's "href" attribute also.

= 1.1 =

• Customizable Quantity attribute
• Quantity Text Postfix
• Added Field Seperator

= 1.0 =

• First Revision

== Upgrade Notice ==

= 1.7 =

• Backword compatiblity
• Latest WordPres Tested

= 1.6 =

• Backword compatiblity
• Latest WordPres Tested

= 1.5 =

• Added filters
• Added feature to open payment page in a new window
• Added feature to allow for user entered payments.

= 1.4 =

• Added support for multilingual buttons.

= 1.3 =

• Added support for customizing the PayPal button.

= 1.2 =

• Fixed quantity feature for donation
• Added support for payment using URL. You can now use it in achor tag's "href" attribute also.

= 1.1 =

• Added Quantity drop down or text box feature to be selected by the user.
• Fix a Javascript error related to quantity