Joomla Tutorials and Blog Posts

OSDonate - A Paypal Donate Button for Joomla

February 12, 2011 | Written by Nick Savov

OSDonate

OSDonate is the first Paypal Donate Button on the JED for Joomla 1.6, 1.7, and 2.5. We have also made it available for Joomla 1.5. It's packed with features, it's simple to use, and it even hovers in a fixed position on the page! It's a great choice for anyone who wants their donation button noticed. It is especially useful for someone who wants a full page layout, such as Joomla developers who have a forum and can't put a donate button in a regular module position because of "lack of space".

Main Features

  • Easy to Setup
  • Secure
  • Integrates with Paypal
  • Lots of Options (if needed)
  • Hovers/Floats on page while scrolling! (Optional)
  • Adjustable distances from edge of screen
  • Inserts within Article (Optional)
  • Customizable intro text (Optional)
  • Success return page
  • Cancel return page
  • Company logo within Paypal's Donation Form
  • Customizable Paypal description within Paypal's Donation Form
  • Standard or adjustable donation amount
  • Currency selector
  • Affiliate Program (Optional)
  • Display powered by OsTraining which links to your OsTraining Affiliate ID
  • Use Weblinks for the affiliate link
  • Full language file for easy translation
Download OSDonate for Joomla 2.5
Enter email to download:

Invalid input. You must input a valid email. Notifications of new versions and security vulnerabilities (if any are found) will be sent via our newsletter.



Download OSDonate for Joomla 1.5
Enter email to download:

Invalid input. You must input a valid email. Notifications of new versions and security vulnerabilities (if any are found) will be sent via our newsletter.




This tutorial will show you how easy and flexible it is to set up.

Install

tutuploadsmedia_1297107111716.png

Extensions >> Extension Manger >> Browser... >> Upload & Install

Note: for Joomla 1.5 it will be Extensions >> install/uninstall (rather than Extension Manger as shown in the screenshot)

Access the Module Via Module Manager

tutuploadsmedia_1297146883628.png

Extensions >> Module Manger >> OSDonate

Basic Options

tutuploadsmedia_1297147573978.png
  • Open in new window: When the Paypal button is clicked, do you want the Paypal Donate page to open in a new window? 
  • Success return page: After the user has donated at Paypal, to which page do you want the user to return? 
  • Cancel return page: If the user cancels at the Paypal Donate page, to which page do you want the user to return? 
  • Company Logo URL: This logo will appear on the Paypal Donate page. Pretty cool, huh? 
  • Paypal button image: You can leave this as the default. It's the URL to the Paypal Donate image that the user should click on to go to the Paypal Donate form. 
  • Show intro text: Do you want to show an into text? 
  • Intro text: Type your intro text here. You can style it with html if desired. 
  • E-Mail/PayPal ID: Enter yours.  
  • Paypal Description: You can display a custom description in the Paypal Form to the user.  
  • Currencies: Which currencies do you want to allow the user to select? Separate with a comma(,). The first currency will be the default. Check with Paypal to make sure the currency is available. 
  • Paypal language: Select the language in which the Paypal form should appear 
  • Show amount field: Do you want to show the amount? 
  • Amount: Pre-fill the amount if desired. You can leave it blank if desired.

*Module Class Suffix: You can skip this part. This is an advanced feature that comes with almost all modules in Joomla and is generally not needed for this module. See our Module Class Suffix tutorial for more info.

Examples of Basic Options

tutuploadsmedia_1297150861307.png
tutuploadsmedia_1297150926001.png

Sticky options

tutuploadsmedia_1297151392659.png
  • Use sticky hover: Do you want OSDonate to stay in the same position even when the page scrolls? This is an awesome feature to get it noticed! 
  • Horizontal Reference Side: Do you want it to be closer to the right or left? 
  • Horizontal distance: How far in pixels? (*no need to add the px, just use digits) 
  • Vertical Reference Side: Do you want it to be closer to the top or bottom? 
  • Vertical distance: How far in pixels? (*no need to add the px, just use digits) 
  • Font Color: If the default font does not match the template very well, enter the hex value or a valid color name in here.  
  • Width: If the default is too narrow you can make it wider.

Example of Sticky

tutuploadsmedia_1297151912100.png

Affiliate Program

tutuploadsmedia_1297153615593.png
  • Show Powered By: Do you want the "Powered by" link to show under the paypal button? To show our gratitude to our users, we integrated the OSDonate "Powered by" Link with OSTraining.com's affiliate program, in order to attract more customers to our affiliate program. 
  • Affiliate ID: Your OSTraining Affiliate ID 
  • Use Joomla's weblink instead of appending Affiliate ID: If you use Joomla's weblinks component, then you can enter the relative url here. e.g. If the weblink was http://www.ostraining.com/weblinks/joomla/ostraining, just paste joomla/ostraining. This overrules the ID. For our students, the weblinks tutorial is available in session 36.

Benefits of keeping the "Powered By"

  • 40% Commission
  • Low key and unobtrusive
  • An additional way to make money no matter how many people donate.

To sign up, visit OSTraining.com's affiliate program

Example of Affiliate Link

tutuploadsmedia_1297155201044.png

Configure Module

tutuploadsmedia_1297155265857.png
  • Show Title: Generally set to "No."
  • Position: Usually debug position is the best practice. Note: Some templates do not have a debug position. You can follow the How to Add a Debug Position tutorial to add it if needed. 
  • Published: Published. *In Joomla 1.5 this will be Enabled.*
tutuploadsmedia_1297155457995.png

Menu Assignment: Determine on which pages you want the Paypal donate to appear.

Save

tutuploadsmedia_1297155536507.png

Save and you're done! Preview it, and configure to your liking!

Support

If you have any questions, suggestions, comments, or bugs to report, please contact us via our contact form. Please do not call us about OSDonate. We generally answer the within 24 hours to support requests and would be more than glad to help with any issues.

Leave a Review

Show your gratitude and leave a review on the JED! It means a lot to us!


 

Comments  

 
#1 Nikola 2011-02-25 04:19
This is a great extension!!!
I have enjoyed a lot!
Thank You!
 
 
#2 iowawebco 2011-03-16 20:20
You're very welcome, Nikola! :)

Kind regards,
Nick
 
 
#3 iowawebco 2011-04-05 21:29
Hi Nikola,

We've now published OSDonate to the Joomla Extension Directory. It would be great if you could leave a review for it :)

extensions.joomla.org/.../...

Kind regards,
Nick
 
 
#4 keiserlupe 2011-04-15 17:28
awesome feature. Thanks for sharing
 
 
#5 iowawebco 2011-04-15 17:42
Hi Lupe,

It would be awesome if you could leave a review for it on the Joomla Extension Directory :)
extensions.joomla.org/.../...

Kind regards,
Nick
 
 
#6 Rock 2oo5 2011-04-25 12:56
Thanks dude, exactly what I need for one of my costumers.
 
 
#7 iowawebco 2011-04-25 13:00
You're welcome! Any chance you can leave a review on the JED for it?
extensions.joomla.org/.../...

It would mean a lot! :)

Kind regards,
Nick
 
 
#8 Eric 2011-07-01 14:19
This is one truly great module! Thank you!
However I would be very glad to know how to insert it within one particular article (the button only) - I am not able to make this work ...

Many thanks.
Best,

Eric
 

Add comment