PayPal Easy Donate

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

[Kihon Kata]

I am receiving donations, so it's working. Just an error (sometimes) displaying to users.

[Boofo]

Well, try to capture the error and we may be able to narrow down what is causing it. It isn't this hack, so at least we have a place to start from.

[DementedMindz]

i noticed the error to but its not the mod its on paypals end... the mod really cant give a error from donating as its only really a form being used to submit the info...

[Billspaintball]

Originally Posted by Kihon Kata

Apparently, according to some, they told me that AFTER submitting payment inside paypal, it would somehow send them to a page on another site of mine. Why would it do this? Paypal setting?

There is a PayPal setting to send users to another URL once they have made a payment.

PayPal -> Profile -> Selling Preferences -> website Payment preferences

Make sure you either dont have autoreturn on, or if you do, that it goes to a valid page on your site.

[Billspaintball]

Originally Posted by sinn3d

Sorry for this.

Where can i find my formatting tags, as them i use for my navbar?

You will need to look at the other menu links in your nav menu.

They will either have formatting tags or a class name.

You need to add that to the donations link code so it will use your custom formatting.

If you post the code for a couple of those links in your custom navbar menu here we may be able to tell you exactly what you need to enter.

[sinn3d]

I hope this is right, here's some of them:

<!-- nav buttons bar -->
<div align="center">
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="0" border="0" width="100%" align="center" style="border-top-width:0px">
<tr align="center" style="height: 24px;">
<if condition="$show['member']">
<td class="topnav"><a href="usercp.php$session[sessionurl_q]">$vbphrase[user_cp]</a></td>
</if>
<if condition="$show['registerbutton']">
<td class="topnav"><a href="register.php$session[sessionurl_q]" rel="nofollow">$vbphrase[register]</a></td>
</if>
<td class="topnav"><a href="faq.php$session[sessionurl_q]" accesskey="5">$vbphrase[faq]</a></td>
<td class="topnav"><a href="memberlist.php$session[sessionurl_q]">$vbphrase[members_list]</a></td>
<td class="topnav"><a href="calendar.php$session[sessionurl_q]">$vbphrase[calendar]</a></td>
<if condition="$show['popups']">

[Boofo]

Originally Posted by Billspaintball

There is a PayPal setting to send users to another URL once they have made a payment.

PayPal -> Profile -> Selling Preferences -> website Payment preferences

Make sure you either dont have autoreturn on, or if you do, that it goes to a valid page on your site.

I forgot all about this. Now it makes sense.

[DementedMindz]

not sure what you changed from previous build but now its not 100% HTML compliant fixed alot on mine i have 2 left to fix

[Boofo]

Can you share the fixed one with us here, sir, when you get it done?

[Billspaintball]

Originally Posted by sinn3d

I hope this is right, here's some of them:

<!-- nav buttons bar -->
<div align="center">
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="0" border="0" width="100%" align="center" style="border-top-width:0px">
<tr align="center" style="height: 24px;">
<if condition="$show['member']">
<td class="topnav"><a href="usercp.php$session[sessionurl_q]">$vbphrase[user_cp]</a></td>
</if>
<if condition="$show['registerbutton']">
<td class="topnav"><a href="register.php$session[sessionurl_q]" rel="nofollow">$vbphrase[register]</a></td>
</if>
<td class="topnav"><a href="faq.php$session[sessionurl_q]" accesskey="5">$vbphrase[faq]</a></td>
<td class="topnav"><a href="memberlist.php$session[sessionurl_q]">$vbphrase[members_list]</a></td>
<td class="topnav"><a href="calendar.php$session[sessionurl_q]">$vbphrase[calendar]</a></td>
<if condition="$show['popups']">

Yeah that looks like it.
You custom style is using a different name to the default one (vbmenu_control).

<td class="topnav"><a href="billspaypal.php?">$vbphrase[billspp_donate]</a></td>

should do the trick.

So, If we want to have the link between your FAQ and Members you need to find

<td class="topnav"><a href="faq.php$session[sessionurl_q]" accesskey="5">$vbphrase[faq]</a></td>
<td class="topnav"><a href="memberlist.php$session[sessionurl_q]">$vbphrase[members_list]</a></td>

and change it to

<td class="topnav"><a href="faq.php$session[sessionurl_q]" accesskey="5">$vbphrase[faq]</a></td>
<td class="topnav"><a href="billspaypal.php?">$vbphrase[billspp_donate]</a></td>
<td class="topnav"><a href="memberlist.php$session[sessionurl_q]">$vbphrase[members_list]</a></td>

Hope that make sense