Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
PayPal Easy Donate Details »
PayPal Easy Donate
Mod Version: 1.31, by Billspaintball (Member) Billspaintball is offline
Developer Last Online: Nov 2011 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.5.4 Rating: (7 votes - 4.71 average) Installs: 175
Released: 16 Apr 2006 Last Update: 05 Aug 2006 Downloads: 725
Not Supported Uses Plugins Template Edits Additional Files  

Hack Description

This hack is the easiest way to add the ability to accept PayPal donations for your site.
You simply upload 2 php files, and a couple of images and then import the product XML and thats it!
No messing round with template edits or anything like that, its all done for you!

:banana: Also includes a vB CMPS Module so you can use this hack on your vB CMPS pages. :banana:
The vB CMPS is basicly just a straight port of DementedMindz excellent Paypal Module (dropdown) On vBa CMPS modified so that it can be setup from the AdminCP.
Many thanks to DementedMindz for allowing me to mod his module.

Some features of this hack are:
  • No need to modify or edit the standard vB files!
  • Automaticly adds 'Donate' link on Navbar next to the FAQ link if desired.
  • Simple once off setup in the Admin Control Panel.
  • You can change all text and headings from the Admin CP.
  • All PayPal settings such as preferred currency are set in the Admin CP.
  • The Donors forum username is on the emailed receipt from PayPal.
  • People do not have to be registered on your site to donate.
  • You and toggle the PayPal Verified seal on or off.
  • Its a product so no need to redo hacks when you upgrade vB next time.
  • Works with default IE settings!
  • vB CMPS Modue Available
  • Configurable Thank you page for donors
  • Default / suggested donation amount if desired
  • Works on vB 3.6 without any modifications
Well thats about it for the moment. I may add more features later, if there is a demand for them.

Please note that you have to have either a Business or Premiere PayPal account, else you will need to upgrade to one of these before you can accept donations. Its easy to do, just follow the guide on the PayPal site.

Also note that this is a product, not a plug-in. You must import it using the import product feature in the Admin CP.

I will try and offer support, but work and family commitments mean I dont have much free time.

This is a work in progress and currently a beta version.
This script has been confirmed as working on
  • vB 3.5.3
  • vB 3.5.4
  • vB 3.6.0 Beta 1
  • vB 3.6.0 Beta 2
  • vB 3.6.0 RC1
  • vB 3.6.0
It should work on earlier versions of vB 3.5 as well, but I have no verification of that.

Known Bugs
None on a standard vB 3.5.X install. However, if you use custom templates the automatic donate link insertion may not work. If thats the case, you will need to edit the navbar template manually as listed in the 2nd post.

This has been tested in a totally clean install of vB 3.5.4 and in my live and hacked site as well.

Changelog

Version 1.31 (5th August 2006)
  • Added - Ability to choose default donations amount if desired.
  • Added - Thankyou page for donors.
  • Added - Ability to choose if donations open in same or new page.
  • Fixed - XML compliance.
  • Fixed/Added - A couple of things that slip my mind at the moment.

Version 1.30 (9th May 2006)
  • Added - Ability to choose different PayPal submit donate buttons
  • Added - Ability to choose to display payment type accepted icons on donate page
  • Added - One setting now controls Currency, Currency Symbol and Country
  • Added - All images are now local, not called from PayPal
  • Fixed - Breadcrumbs not showing correctly
  • Fixed - Various minor template bugs
  • Fixed - Typo in Where On Line plugin
  • Fixed - Template Caching
Credits: I've had a lot of help and advice from Boofo on this version.

Version 1.21 (28th April 2006)
  • Fixed - PayPal verified link was not working

Version 1.2 (16th April 2006)
  • Added - Admin CP selector for Navlink, Button, or nothing
  • Added - Donate button in header on right (selectable on/off)
  • Added - Couple of tweaks for vB CMPS module addon
  • Added - Grouped templates in style manager
  • Fixed - Couple of minor changes to make it 100% HTML compliant

Version 1.1 (16th April 2006)
  • Added - Ability to enter default currency symbol in Admin CP
  • Added - Display default currency code on donations page
  • Added - Display default currency symbol on donations page
  • Fixed - Firefox centering issue
  • Fixed - Typo on donation page

Version 1.0 (16th April 2006)
  • Initial Release

Upgrade Instructions
To upgrade from 1.2x to 1.3 just download the zip, it contains the latest files.
Then upload the billsdonate.php and image files then import the XML file again.
Make sure you select overwrite when you import.

Credits
Huge thanks to DementedMindz who made my V1.31 code XML compliant

I have been inspired by Cloudrunners PayPal Donations and Cybernetec's Cyb Paypal. Both have their good points, but neither were quite what I wanted, which is what inspired me to write this.

Thanks also to Paul M and hambil in helping me work out how to insert the donate link without any manual edits.
Also, espically to DementedMindz for his assistance, advice, and use of his vB CMPS module.
Much appreciested guys

And finally, a huge thanks to Boofo who was a great help in making the 1.30 release and supplied the new template, and much help.


Click on Install
If you have this script installed then please click on the install link because;
  • You will get notified if any security issues are reported.
  • You will get notified when there are any upgrades to this script
  • It gives me a warm fuzzy feeling and motivates me to develop more

Donations
First of all, to be clear. This script is 100% free.

However if you feel an urge to donate I'm not going to say no.
Donations can be made at http://www.billspaintball.com/vb3/billspaypal.php

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	dobnate-cp.jpg
Views:	1763
Size:	31.1 KB
ID:	45779   Click image for larger version

Name:	donate.jpg
Views:	3363
Size:	35.0 KB
ID:	45780   Click image for larger version

Name:	donate-menu.jpg
Views:	2521
Size:	9.9 KB
ID:	45781  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Miscellaneous Hacks Cyb - PayPal Donate Valter vBulletin 3.6 Add-ons 918 09 Jul 2015 01:42
Miscellaneous Hacks Cyb - PayPal Donate Valter vBulletin 3.7 Add-ons 656 11 Dec 2014 02:53
Miscellaneous Hacks PayPal Easy Donate - Lite Billspaintball vBulletin 3.7 Add-ons 66 23 Jun 2011 19:22
Miscellaneous Hacks PayPal Easy Donate - vB 3.6 Billspaintball vBulletin 3.6 Add-ons 446 23 Jun 2011 02:44
Cyb - PayPal Donate Valter vBulletin 3.5 Add-ons 116 21 Feb 2010 11:10

  #46  
Old 20 Apr 2006, 13:34
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
Updated to 1.2
Version 1.2 has been released.

Changelog

Version 1.2 (16th April 2006)
  • Added - Admin CP selector for Navlink, Button, or nothing
  • Added - Donate button in header on right (selectable on/off)
  • Added - Couple of tweaks for vB CMPS module addon
  • Added - Grouped templates in style manager
  • Fixed - Couple of minor changes to make it 100% HTML compliant
Reply With Quote
  #47  
Old 20 Apr 2006, 13:56
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
vB CMPS Module available
A vB CMPS module for this is now available.

Download this module from the opening post.
Reply With Quote
  #48  
Old 20 Apr 2006, 14:06
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Originally Posted by Billspaintball
vB CMPS Module available
A vB CMPS module for this is now available.

Download this module from the opening post.
Hey Bill, I modified the text that shows on the donate page. I cannot remember if it was a phrase or just plain HTML. If I modified that, will upgrading to 1.2 kill my modification?

Also, one reccomendation for future upgrades: It would be nice to be able to pass the USERNAME to PayPal so that we can see who is donating. That is if it's not a guest donating.
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign
Reply With Quote
  #49  
Old 20 Apr 2006, 14:21
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
Originally Posted by Kihon Kata
Hey Bill, I modified the text that shows on the donate page. I cannot remember if it was a phrase or just plain HTML. If I modified that, will upgrading to 1.2 kill my modification?
It depends what you actually modified.
If you modified billspaypal.php then it will be right as long as you dont reupload that file (there is no need to, its unchanged).
If you actually modified a template, your changes will probably get overwriten.
Also, one reccomendation for future upgrades: It would be nice to be able to pass the USERNAME to PayPal so that we can see who is donating. That is if it's not a guest donating.
Look at 'Item/Product Name:" on your emailed paypal notification.
It already contains the doners forum Username

Thats only a stop gap solution until I get my head around the PayPal call backs, but it works.

Last edited by Billspaintball; 20 Apr 2006 at 14:35.
Reply With Quote
  #50  
Old 20 Apr 2006, 14:25
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Originally Posted by Billspaintball
It depends what you actually modified.
If you modified billspaypal.php then it will be right as long as you dont reupload that file (there is no need to, its unchanged).
If you actually modified a template, your changes will probably get overwriten.
Thanks for the quick reply Bill! Oh yeah, I'm sure it was prolly a template mod, I just couldn't remember if it was phrased or not(too lazy to go look lol). I can copy my template changes before upgrading.


Look at 'Item/Product Name:" on your emailed paypal notification.
It already contains the doners Username
Thats only a stop gap solution until I get my head around the PayPal call backs, but it works.
Oh ya, I saw this. Sorry :-) Nice hack, btw
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign
Reply With Quote
  #51  
Old 20 Apr 2006, 14:28
DementedMindz DementedMindz is offline
 
Join Date: Jan 2006
yeah basicly the way things are setup now you dont really need any template mods... it can all basiclly be done via admincp..
Reply With Quote
  #52  
Old 20 Apr 2006, 14:41
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Originally Posted by DementedMindz
yeah basicly the way things are setup now you dont really need any template mods... it can all basiclly be done via admincp..
What I was saying is that I had already installed this and modded up the text. When I upgrade, I wanted to make sure that it didn't overwrite my text changes.
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign
Reply With Quote
  #53  
Old 20 Apr 2006, 18:21
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Ok, so....I upgraded to 1.2 and it kept all the settings and text. I had only edited the text inside the vb options > Bill's PayPal Donate

Thanks
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign
Reply With Quote
  #54  
Old 21 Apr 2006, 13:44
phonexpo's Avatar
phonexpo phonexpo is offline
 
Join Date: Sep 2005
Location: Dublin
Real name: Patrick
I've messed up the module, I want to take some text from it so I done that in word pad, now vB wont read the file as a module , how do I sort that?
Reply With Quote
  #55  
Old 21 Apr 2006, 14:09
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
Re-import the module and overwrite the damaged one.

If you want to edit a module, log into your Admin CP
then
Styles & Templates -> Style Manager - Edit Templates

Then just edit the template called "adv_portal_paypal"
Reply With Quote
  #56  
Old 25 Apr 2006, 01:44
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Bill, I sent you a PM regarding how to cache the cached template the template
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign

Last edited by Kihon Kata; 25 Apr 2006 at 02:10.
Reply With Quote
  #57  
Old 25 Apr 2006, 02:07
Desihunk Desihunk is offline
 
Join Date: Mar 2006
Nice hack. I would've used it if you would've given the 'Donation Goal' feature...Anyways thanks
Reply With Quote
  #58  
Old 25 Apr 2006, 02:21
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
Originally Posted by Kihon Kata
Bill, I sent you a PM regarding how to cache the cached template the template
Where are you getting that message specifically?
Just on the billspaypal.php page or everywhere?

Also, did you do a clean install of the 1.2 release, or have you upgraded from an earlier one?

Last edited by Billspaintball; 25 Apr 2006 at 02:26.
Reply With Quote
  #59  
Old 25 Apr 2006, 02:24
Billspaintball's Avatar
Billspaintball Billspaintball is offline
 
Join Date: Sep 2003
Real name: Bill
Originally Posted by Desihunk
Nice hack. I would've used it if you would've given the 'Donation Goal' feature...Anyways thanks
Its still a work in process.
Currently Im working on getting it to insert the PayPal IPN data into the database.
Once thats working fine then I can look at other features such as Goals, Top Donors, Donor Icons for members and so on.
Reply With Quote
  #60  
Old 25 Apr 2006, 04:22
Kihon Kata's Avatar
Kihon Kata Kihon Kata is offline
 
Join Date: Nov 2003
Originally Posted by Billspaintball
Where are you getting that message specifically?
Just on the billspaypal.php page or everywhere?

Also, did you do a clean install of the 1.2 release, or have you upgraded from an earlier one?
Hi Bill! I upgraded it so I didn't lose my settings and YES it's showing on all pages. Lemme know what to do
__________________
3MultiMedia.com - Simple, Effective CMS WebDesign
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Forum Jump


New To Site? Need Help?

All times are GMT. The time now is 04:28.

Layout Options | Width: Wide Color: