Joomla Tutorial

New to Joomla?
check out our Joomla Tutorial page.

Easy Paypal Tutorial PDF Print E-mail

To use Easy Paypal plugin, you have to install the plugin, configure and enable it first. Then, you can have "{easypapal}" in your article to have Paypal button shown. Please NOTE, the text MUST be in plain text, with no formatting, such as bold or italic. Examples below will have the text in bold to prevent the text being rendered.

Use the Extension

Dynamic Parameters

Demo

Paypal Buttons

Screen Shot

To enable this plugin:

Install the bot, configure it and then publish it.

 You can config the default bot behaviors using Joomla plugin configuration screen.

when placing the bot in the content, you can use {easypaypal} for default configuration or use {easypaypal parameter1=value1,parameter2=value2,parameter3=value3....} format for each content.

Parameters are seperated by commma, without any space in between. When setting email address in parameter, please remove any HTML tags around the email address added by Joomla.

Dynamic parameters:

cmd_type cmd_type defines the Paypal button actions, such as regular payment, subscription payment, shopping cart payment, view shopping cart and paypal Seal actions. Possible values of cmd_type are regular, subscription, shopping, seal and viewcart.
address This parameter specifies the account in which Paypal payment will be made to. You can use email address or merchant ID.
itemname Name of the item you want to sell.
itemnumber The numeric ID of the item you want to sell.
currency The accepted currency symobol for the amount. We accept all Paypal currencies.
amount and showamount The price for the item. This is required for regular payment or shipping cart. If you want end uses to be able to modify the amount, such as in a donation scenario, you can set the show amount=Yes. Note, showamount parameter is for regular payment ONLY, it does not apply to shopping cart or subscriptions.
button The URL for the payment button image. Easy Paypals comes with several Paypal images. You can also define your own purchase images.
tax The tax rate that should be applied to the purchase. If tax is set to 0, the tax field will not be submitted to Paypal, (ie. Paypal will use profile tax settings to calculate tax amount).
shipping and shipping2 Shipping defines the shipping cost of the transaction. If you want to specify additional shipping cost per additional unit, you can use shipping2 parameter. When both specified to 0, the field will be omitted, so that Paypal's profile based shipping policy will be used.
handling Handling defines the handling cost of the transaction.
quantity and showquantity You can define the quantity of the units. If you want end users to be able to modify the quantity, You can display the quantity input box by setting showquantity to Yes.
return, cancel_return You can specify return URL and cancellation URL. To set them dynamically, you need to use return and cancel_return parameters, default is your home page.
No_note, cn, showinput No_note, which could be 1 or 0. When No_note is set to 0, Paypal will allow user to input notes for the order. If you want to have a customized note header, you can specify th cn parameter, such as cn=Please enter your note;. showinput parameter allows payer to enter the note for the transaction.
on0, os0, on1, os1 These parameters define the optional fields for the transaction. On0 and on1 define the caption of the optional fields and os0 and os1 define the value of the optional fields. For drop down list, use : as delimiter, such as "Red:Green:Blue".
optionpricing A Yes or No value parameter. If you want to have different prices based on a select option list, you need to set this parameter to Yes. For example, if you want to charge $5 for red color, $10 for Green color, and $20 for Blue, you can have "optionpricing=Yes,on0=Color,os0=Red $5:Green $10:Blue $20"e;. Please note, you should only have ONE option select list with the price information.
optionpricingorder Easy Paypal assumes the first number in the description is the price. As such, if you have "Red Size 10 $20", the 10 will be taken as the price. To change this behavior, you can set optionpricingorder=Last.
a1, p1, t1 These are subscription payment (cmd_type=subscription) parameters. a1, p1, t1 defines Trial 1 amount, period, and period unit. t1 must be either D (day), W (week), M (month) or Y (year).
a2, p2, t2 These are subscription payment parameters. a2, p2, t2 defines Trial 2 amount, period, and period unit. t2 must be either D (day), W (week), M (month) or Y (year).
a3, p3, t3 These are subscription payment parameters. a3, p3, t3 defines subscription amount, period, and period unit. t3 must be either D (day), W (week), M (month) or Y (year).
src src, Recurring payments. If set to 1, the payment will recur unless your customer cancels the subscription before the end of the billing cycle. If omitted, the subscription payment will not recur at the end of the billing cycle, Optional.
sra sra, Reattempt on failure. If set to 1, and the payment fails, the payment will be reattempted two more times. After the third failure, the subscription will be canceled. If omitted and the payment fails, payment will not be reattempted and the subscription will be immediately canceled, Optional.
srt srt, Recurring Times (must be greater than 1, omit the field otherwise). This is the number of payments which will occur at the regular rate. If omitted, payment will continue to recur at the regular rate until the subscription is canceled, Optional.

Demo:

make sure plugin is in plain text, with no formatting. Examples below has "easypaypal" in bold.

Using default Easy Paypal bot settings.

{easypaypal}

Using following dynamic content configuration:

{easypaypal itemname=demo,itemnumber=100,quantity=3,amount=100,tax=0.5, currency=AUD,button=http://www.paypal.com/en_US/i/btn/x-click-but5.gif,cancel_return=http://www.yahoo.com}

Using following dynamic content configuration:

  Color    Size  

{easypaypal on0=Color,os0=Red:Green:Blue,on1=Size,os1=Please specify size}

Using following dynamic content configuration for Option based Pricing:

  Color    Size  

{easypaypal on0=Color,os0=Red $5:Green $10:Blue $20,on1=Size,os1=Please specify size,optionpricing=Yes}

With optionpricingorder=Last

  Color    Size  

{easypaypal on0=Color,os0=Red Size 1 $5:Green Size 2 $10:Blue Size 3 $20,on1=Size,os1=Please specify size,optionpricing=Yes,optionpricingorder=Last}

Using following dynamic content configuration example to allow buyer input notes:

{easypaypal amount=100,tax=0.5,shipping=2,handling=5, no_note=0, cn=Enter Your Note}

Using following dynamic content configuration example to show amount

Amount:Quantity:

{easypaypal showamount=Yes,amount=10,tax=0.6,showquantity=Yes}

Using following dynamic content configuration example to allow user to input quantity:

Quantity:

{easypaypal amount=38,tax=0.123456,showquantity=Yes,quantity=2,shipping=1,shipping2=2}

Using following dynamic content configuration example for subscription based payments:

{easypaypal cmd_type=subscription,a1=2,p1=2,t1=D,a2=1,p2=1,t2=W,a3=2,p3=2,t3=Y, src=1,sra=1, srt=,button=http://www.paypal.com/en_US/i/btn/x-click-but20.gif}

Using following dynamic content configuration example for shopping cart purchases:

{easypaypal cmd_type=shopping,amount=100,button=http://www.paypal.com/en_US/i/btn/btn_cart_LG.gif}

Using following dynamic content configuration example for shopping cart purchases:

{easypaypal itemname=demo,itemnumber=2, cmd_type=shopping, amount=150, tax=0.5,shipping=2,handling=5,button=http://www.paypal.com/en_US/i/btn/btn_cart_LG.gif}

View shopping cart:

{easypaypal cmd_type=viewcart,button=http://www.paypal.com/en_US/i/btn/view_cart_new.gif}

Using Easy Paypal for Verified Logo:

{easypaypal cmd_type=seal,button=http://www.paypal.com/images/verification_seal.gif}

Paypal Buttons: