The Joomla! Paypal plugin turns our form builder, RSForm!Pro into a small shopping cart.
With the RSForm!Pro - PayPal plugin you can add products to the form. The integration uses the standard PayPal website payment method, the customer will be redirected to the Paypal page when the form is submitted where he will need to log in to his PayPal account and manually approve the transaction. After the payment is approved PayPal will send a notification to your site and the submission status will be changed to paid. If the transaction is not approved within 12 hours the payment will be marked as declined.
Tutorial - Using RSForm!Pro - Paypal plugin
The RSForm!Pro - Paypal Plugin is a Joomla! plugin that once installed and enabled will add paypal functionality to your RSForm!Pro installation. In this tutorial, you will learn how to install the plugin, then we will add a Paypal Single Product component to an existing RSForm!Pro form, and will see how the submissions change once the payment is validated.
Additionally, we have made a video tutorial that explains how to install, configure and setup a small Joomla! shopping cart using the RSForm!Pro and the Paypal plugin.
The example uses the Multiple Products field and a Dropdown to list the products.
Ep. 25 - How to add Paypal functionality to your Joomla! forms using the RSForm!Pro Paypal Plugin
In order to make the plugin work, you need:
- Joomla! 1.5, 2.5 or 3
- Latest revision of RSForm! Pro
Getting the RSForm!Pro - Joomla! Paypal plugin
In order to download the RSForm!Pro - Paypal plugin you must have at least one active RSForm!Pro subscription. Simply go to the My Downloads section of our website(You must be logged-in in order to see the My Downloads section).
In the list of downloads go to the RSForm!Pro section, and download the file called rsfppaypal.zip
Installing the plugin
Once you have downloaded the RSForm!Pro - Paypal plugin, you can install it using the default Joomla! installer as shown in the image
The Paypal plugin should auto-publish itself, but if that doesn't happen, you can go to Extensions / Plugin Manager and enable it. The plugin is located in the System group and you can identify it by the name of "System - Rsfppaypal"
Configuring the Paypal Plugin
After installing and enabling the plugin, go to Administrator » RSForm!Pro » Configuration. You will notice that a new tab named Paypal appeared. That's where you must set up the plugin as follows:
- Paypal E-mail account: This is the account where the money will be sent.
- Return URL: After the payment is complete, the user will be redirected to this configured URL. Example: http://site.com
- Cancel URL: If the user cancels the payment from within the PayPal payment page, he will redirected to this URL.
- Tax Type: Percent (%) / Fixed Rate
- Tax value: Amount that will be added to the overall purchase price. This will be calculated as percentage or a fixed rate depending on the Tax Type selection.
- Live mode: Set this option to "No" in order to test the plugin with a dummy transaction. You must have a Paypal Sandbox account.
- Currency: Type here the currency which the plugin will use to operate the form. Use values such as EUR, USD, AUD, GBP etc.
- Thousands Separator: This is where you set the number formatting (thousands separator(if any)).
- Decimal Separator: You can set it to "." or ",".
- Number of decimals: How many decimals do your prices have.
Important: In order for this plugin to actually work you will need to have the "Save data to database" option enabled. This option is found in the Form Properties tab.
Using the Paypal form components
Once you have enabled the plugin, go to RSForm!Pro » Manage Forms and edit the form where you want to use the Paypal functionality. You will notice on the left side of the screen, just under the common form components, the new Paypal plugin form components.
There are two usage scenarios. You can use the Single product or the Multiple Products options, but never both field types on the same form. The Single product can be used for fixed donations, attachment emailing and all sorts of scenarios.
The Multiple product field type can be added for as many times you like, transforming your form into a small shopping cart. By adding the "Total" paypal field type, it will automatically calculate the total of your selected items. The multiple product items can be set as follows:
- Select: this can be used as an anthet for your product dropdown. It does not have any value, just for aestethics.
- price1: actual price of the product. No currency simbols are needed (the currency is picked from the plugin configuration area), just a numerical value.
- Description1: can be used a product name or label (optional, without "|Description1"). This will actually be concatenated upon displaying it in the frontend. A view option has also been added: Dropdown and Chekbox group.
- Example of using the form with a Single Product field:
3 ways to create a small Joomla! shopping cart with RSForm!Pro and PayPal
- Example of using the form with the Multiple Products field:
3 ways to create a small Joomla! shopping cart with RSForm!Pro and PayPal - Part 2
- Custom PayPal example: automatically calculate the total amount of the selected products and their quantities and passe it further to the PayPal page.
3 ways to create a small Joomla! shopping cart with RSForm!Pro and PayPal - Part 3
The plugin will redirect the customer to the Paypal Pay page. At this time, the transaction status is set to "Pending". Once Paypal sends a notification to your script, the status will automatically change to "Accepted". If no notification is received from PayPal, the submission status will remain set as "Pending".
Examples and screenshots