Miscellaneous Hacks - PayPal Easy Donate - vB 3.6

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!

Also includes a vB CMPS Module so you can use this hack on your vB CMPS pages. - Note: Module has not been updated to add latest currencys.
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
  

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.7 Beta 3
• vB 3.6.7PL1
• vB 3.6.7
• vB 3.6.6
• vB 3.6.5
• vB 3.6.4
• vB 3.6.3
• vB 3.6.2
• vB 3.6.1
• vB 3.6.0
• vB 3.6.0 RC1
• vB 3.6.0 Beta2
• vB 3.6.0 Beta1

Add Ons
Colonel Ingus has made quite a nice flash addon for this hack.
Full details of this addon are here - http://www.vbhackers.com/f76/audible...144/#post51661
Well worth checking out and seeing if it can enhance your donations page.

Known Bugs
vB Donations Hack - None on a standard vB 3.6.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.
vB CMPS Module - Wont work with Euros for some bizare reason, under investigation.
- Not updated to add new V1.32 currencys yet.

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

Changelog

Version 1.32.366 (26th May 2007)

• Changed - Uses new template hooks instead of modifying cached templates.
• Will only work with vB 3.66 or newer

Version 1.32 (9th January 2007)

• Added - 9 new Paypal supported currencys.
• Added - Version checking in vB Product Manager.
• Added - Product URL in vB Product Manager.
• Fixed - Heading in AdminCP not displaying correctly.

Version 1.31 (6th August 2006)

• Initial vB 3.6 Release

Upgrade Instructions
The 1.31 release for vB 3.6 is identical to the 1.31 vB 3.5 release.
https://vborg.vbsupport.ru/showthread.php?t=113159
No upgrading is necessary if you were running the 1.31 version on your vB 3.5 board.
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/bd_donate.php

[DementedMindz]

glad it worked I wasnt sure if thats the one you ment. your arcade you need to do that in your navbar too

[corsacant]

I've had a quick tinker of the navbar now.

[DementedMindz]

lol yeah you have to do that but you can also add them files in your vbadvanced settings Header Replacements,Navbar Replacements

[silurius]

Hi Bill. Great hack, clicked Install. Seems to be working just fine for my needs.

One suggestion: would it be feasible to add a feature so that this tool collects userid's who have landed back at /forum/billspaypal_donated.php?

Alternatively, does anyone here know how I might turn on some kind of reporting feature for a PayPal Premiere or Business account? I've taken payments for auctions and the like before, but I need to expose my donations to the site owner so as to continue to maintain trust etc.

[DementedMindz]

there will be a new features like that in the future right now bill just had a kid and hes with family so as soon as he has time im sure it will be out.

[silurius]

Originally Posted by DementedMindz

there will be a new features like that in the future right now bill just had a kid and hes with family so as soon as he has time im sure it will be out.

Totally understood! No pressure.

Would appreciate any feedback or insight on the second question (PayPal reporting or the like) if anyone has any.

My use case is: I don't own the site, but I do all administration and most moderation. In order to make the site owner feel better I need to keep things as transparent as possible, and with a minimal amount of extra work to make it so.

[Kopland]

I wanted to be able to display this as a block on my vbPortal front page, so I took some of the code from the billspaypal.php file and did the following.

1. In the vbPortal Control Panel, expand the "Block Layouts" tab and click on "Default Side Blocks".
2. Click on the "Add New Block" button, choose PHP block type. I put in "Online Donation" for my Block Title, "Right" for my Default Column, and "Yes" for Templates.
3. Add the following code to the Content box:
   
   PHP Code:

   $DonationMsg="Thank you for donating.  Every little bit helps to maintain the site and its upkeep costs.";
$navbits = construct_navbits(array('' => 'Donations'));
$country = $vbulletin->options['billspp_currency'];
$email = $vbulletin->options['billspp_email'];
$payfor = $vbulletin->options['billspp_payfor']." From: ". $vbulletin->userinfo['username'];
$buttontype = $vbulletin->options['billspp_showverify'];

if ($country == "0") {$currency = "AUD"; $currencylong = "Australian Dollars"; $cursym = "$";}
if ($country == "1") {$currency = "CAD"; $currencylong = "Canadian Dollars"; $cursym = "$";}
if ($country == "2") {$currency = "EUR"; $currencylong = "Euro"; $cursym = "€";}
if ($country == "3") {$currency = "GBP"; $currencylong = "Pounds Sterling"; $cursym = "?";}
if ($country == "4") {$currency = "JPY"; $currencylong = "Japanese Yen"; $cursym = "?";}
if ($country == "5") {$currency = "USD"; $currencylong = "U.S. Dollars"; $cursym = "$";}

if ($buttontype == "2") {$buttontype = "$stylevar[imgdir_misc]/paypal_verified_donate.gif";}
else {$buttontype = "$stylevar[imgdir_misc]/paypal_donate.gif";}


echo $DonationMsg;

echo "<br /><br />
<form action=\"https://www.paypal.com/cgi-bin/webscr\" target=\"_blank\" method=\"post\">
    <div align=\"left\">
    <strong>Currency</strong>: $currency - $currencylong<br /><br />
    <strong>Amount</strong>: $cursym
    <input type=\"text\" name=\"amount\" size=\"6\" value=\"$vboptions[billspp_defaultamount]\" />
    <input type=\"hidden\" name=\"cmd\" value=\"_xclick\" />
    <input type=\"hidden\" name=\"business\" value=\"$email\" />
    <input type=\"hidden\" name=\"item_name\" value=\"$payfor\" />
    <input type=\"hidden\" name=\"no_note\" value=\"1\" />
    <input type=\"hidden\" name=\"currency_code\" value=\"$currency\" />
    <input type=\"hidden\" name=\"tax\" value=\"0\" />
    <input type=\"hidden\" name=\"return\" value=\"$vboptions[bburl]/billspaypal_donated.php\" />
   </div>
    <br />
  <div align=\"left\">
   <span class=\"smallfont\">Please enter your donation amount above, then click on the Donate button below.</span></div>
    <br />
   <div align=\"center\"><input type=\"image\" src=\"$buttontype\" alt=\"Give Securely With Any Major Credit Card Through PayPal!\" title=\"Give Securely With Any Major Credit Card Through PayPal!\" />
    <br />
    <br />
  </div>
 </form>
"; 

4. Click Save

Voil?! The block has been created! Now all you have to do is insert the block into your desired module and your Donations block should show up beautifully! I'm pretty new at this, so I don't know if all the code that is in there is required, but that worked for me. You can see it at www.kopland.net (new site, not sure what I'll do with it yet, lol)

Billspaintball, if I need to add anything to the top to help give credit to you, just lemme know what I need to add and I'll make sure to do it.

[morrow]

I imported the vbAdvanced module but it still doesn't show up. Any ideas?

[DementedMindz]

Is it turned on?

[smoknz28]

Anyone got this working under vB 3.6.1 yet?

Thanks