PayPal Easy Donate - Lite

[Billspaintball]

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! :)


Some features of this hack are:

No need to modify or edit any vB files!
Automaticly adds 'Donate' link on Navbar next to the FAQ link if desired.
Simple once off setup in the Admin Control Panel.
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
Fully Phrased


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 don't have much free time.

This script has been confirmed as working on

vB 3.7 Rc1



Known Bugs

Choosing the button instead of the Navbar link for the donations breaks xml validation (but still functions fine).
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.



Change log

Version 2.00 (21st March 2008)

First release for vB 3.7.*
Added - Fully Phrased.
Will only work with vB 3.7.* or newer



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

[Billspaintball]

Manual Template Edit
(if using modded navbar without the default hooks)

If your using a custom Navbar (or none at all) or just want to have the link to the donations page somewhere else, just add the following code into the desired position in your template.


<!-- PayPal Donations -->
<td class="vbmenu_control"><a href="billspaypal.php?">$vbphrase[billspp_donate]</a></td>
<!-- /PayPal Donations -->

If you wish to use a button image instead, use this code

<div align="right"><a href="billspaypal.php"><img src="https://www.paypal.com/en_US/i/btn/x-click-butcc-donate.gif" border="0" alt="Make payments with PayPal - it's fast, free and secure!" /></a></div>

[Boofo]

What does "lite" mean in this version as compared to the other versions?

[Big Boss]

That's what I'd like to know as well. Are you planning on releasing a paid version with other features?

[Jase2]

Hi Bill,

I have seen on one site that uses this; they use this image: https://vborg.vbsupport.ru/external/2008/03/3.gif and have three; one for ?, one for $ and one for €... is there anyway I can do this too?

Regards Jason :)

[Billspaintball]

What does "lite" mean in this version as compared to the other versions?

That's what I'd like to know as well. Are you planning on releasing a paid version with other features?

Lite as in just a basic donations system.

- Simple to install and use, (and remove too).
- No vB modifications necessary, no template edits, no database changes.
- Just a basic donations system without unnecessary complexity.

Also leaves room for the possibility of a more full featured version with the works in the future.

[Billspaintball]

Hi Bill,

I have seen on one site that uses this; they use this image: https://vborg.vbsupport.ru/external/2008/03/3.gif and have three; one for ?, one for $ and one for ?... is there anyway I can do this too?

Regards Jason :)

Its easy enough to change the donation button graphic.
Just rename it paypal_donate.gif and upload it to images/misc

As for 3 buttons for different currency's, yes it would be easy enough to hack that with a template modification. (but you would loose the ability to set the currency from the AdminCP)

[KURTZ]

just tagged for future use ... niceone Bill!

[Jase2]

Its easy enough to change the donation button graphic.
Just rename it paypal_donate.gif and upload it to images/misc

As for 3 buttons for different currency's, yes it would be easy enough to hack that with a template modification. (but you would loose the ability to set the currency from the AdminCP)

I see, care to share what template edit I could make?

Regards Jason :)

[liselotte]

thanks

[UltraFanatics]

Great mod, can anyone tell me how I add

1) add this to my usercp (link)
2) the text to add a clickable picture link on forum home

[UltraFanatics]

Ive now done the image

[Jase2]

Where about in the code do I edit to add three buttons, all in a different currency?

Regards Jason :)

[Billspaintball]

I see, care to share what template edit I could make?

Regards Jason :)

The template you need to edit is called
billspp_main

You will need to code the three donate buttons yourself.

You can use the same form code for each of the three donate buttons except for
<input type="hidden" name="currency_code" value="$currency" />
You will need to hardcode $currency to the currency code for that button.
Example: <input type="hidden" name="currency_code" value="AUD" />

[Jase2]

Hi Bill,

Thanks for your reply. Where would I code it, though? Is there any chance you can tell me the code to use, and where to place it?

Thank you.

Regards Jason :)

[reddog64]

What template do i edit to add the 'donate' in the navbar
I'm lost...

[Jase2]

The 'navbar' template ;)

[JADM]

Great mod! Only issue I am having is the images are messed up.

www.pebforum.com/forum.php

Any ideas?

[Jase2]

That's because you need to upload the images in binary mode.

[JADM]

Thanks! That worked beautifully...and also taught me something!

[infinityloop]

looks very nice!

are guests also able to donate? :)

[DawnsWebDesigns]

looks very nice!

are guests also able to donate? :)

It says in the description up there somewhere that guests can donate. :)

Otherwise I've installed it. I tried to use the nicer paypal donate button...renamed it too...but it wouldn't show up. So I used the other paypal verified button. Otherwise looking good so far. Thanks for this. :)

[Jase2]

You simply use the same name, and overwrite the one on the server to change the button.

[Allan]

French language :)

Translator: Red

[Billspaintball]

French language :)

Translator: Red


Excellent :)

[TsirhCitna]

How do I enable the vB CMPS Modue?

[Treasure Quest]

Hi Bill, nice mod. Any chance that members who donate can get a little "donated" pic or something under their avatar? That would show other members that they donated which would boost donations.

Greg

[member007]

Hi,
I am looking for a mod that members can donate to whoever moderate the forums. For example, many times it's hard to get people to moderate forums for you. In order to give moderators incentive, can you code paypal that has a donate link under each moderator? Each moderator has his/her own paypal account. This way, you can have many moderators willing to moderate your forums.
Thank you.

[Lombardo]

where's the module for vbadvanced?

[spinz4]

What did I do wrong? www.dsmftw.com

Thanks

Edit: I forgot I'm going through a server switch....I will find out in 24 hours if I did it right, lol.

[Lombardo]

where is the module for vbadvanced?

It's the only reason i installed this was because it has this module.

[JKatz]

Will this mod work for 3.6.10?

[athlon64bit]

Any chance that there could be an option to display multiple currencies to donate, like a drop down menu to donate in dollars or pound sterling etc?

[skywalker2208]

why is this mod not supported?

[gamerfu]

where is the module for vbadvanced?

It's the only reason i installed this was because it has this module.

I am wondering the same. :confused:

[Shazz]

Installed thanks bills

[davida500]

<a href="http://www.e3-clan.com/forums/billspaypal.php" target="_blank">http://www.e3-clan.com/forums/billspaypal.php</a>

Please visit the above link, you will see that it shows no images, i have uploaded the images to the image folder so i dont understand.

Please help me, thanks.

- David

[Xphusion]

nice mod looks great ! installed

[EmpireZ]

Thanks Bill,

@ Davida500: You need to upload the images into your styles misc folder. Right click on the red x and then properties to get the full directory of where the images should be.

[uReside.com]

Thanks Bill,

@ Davida500: You need to upload the images into your styles misc folder. Right click on the red x and then properties to get the full directory of where the images should be.

I made the same goof!

Great mod!

[aktifnet]

realy good.

thank you.

I 'm installed : http://www.mydnz.com/billspaypal.php?

[momo2]

[QUOTE=Billspaintball;1473215]Manual Template Edit
(if using modded navbar without the default hooks)

If your using a custom Navbar (or none at all) or just want to have the link to the donations page somewhere else, just add the following code into the desired position in your template.


<!-- PayPal Donations -->
<td class="vbmenu_control"><a href="billspaypal.php?">$vbphrase[billspp_donate]</a></td>
<!-- /PayPal Donations -->

If you wish to use a button image instead, use this code

<div align="right"><a href="billspaypal.php"><img src="https://www.paypal.com/en_US/i/btn/x-click-butcc-donate.gif" border="0" alt="Make payments with PayPal - it's fast, free and secure!" /></a></div>[/Q
if i dont use this code, I get donate button but
it wont match my theme, if i use ur extra code, one does match and second one also stays ,so how do i remove ur first one ?

[bart6767]

How do i get this not to insert the donate link in the nav bar when i install this?

[Vinyljunky]

Any chance that there could be an option to display multiple currencies to donate, like a drop down menu to donate in dollars or pound sterling etc?

I think you need the AWC Donating (https://vborg.vbsupport.ru/showthread.php?t=177437&highlight=donation)for that :up:

[momo2]

How do i get this not to insert the donate link in the nav bar when i install this?

I have the same problem like urs... hope someone can answer it.

[orcasea]

Just deleted an "other" PayPal donation add-on an installed this...it's much better!

Thank you!

[BizAdventure]

I know this mod isn't supported but could anyone tell me why the images are not showing up? I have uploaded them to the correct place.

Thank you!

Biz

[24hourForum.com]

can someone tell me why this error shows up

The seller accepts encrypted website payments only. You cannot pay the seller through un-encrypted buttons. Please contact your seller for more details

how can i change this?

[ziggylol]

Really cool mod, thanks

[effeff70]

It?s great....

Just one Problem: All images are in "misc" but when I Klick "Donate"
theres no Pic on the Button.]Why? Can somebody help?

[img=http://img243.imageshack.us/img243/2853/screenpaypalrh0.th.jpg] (http://img243.imageshack.us/my.php?image=screenpaypalrh0.jpg)[img=http://img243.imageshack.us/images/thpix.gif] (http://g.imageshack.us/thpix.php)

[effeff70]

Can nobody help?

[Billspaintball]

It?s great....

Just one Problem: All images are in "misc" but when I Klick "Donate"
theres no Pic on the Button.]Why? Can somebody help?

[img=http://img243.imageshack.us/img243/2853/screenpaypalrh0.th.jpg] (http://img243.imageshack.us/my.php?image=screenpaypalrh0.jpg)[img=http://img243.imageshack.us/images/thpix.gif] (http://g.imageshack.us/thpix.php)

Right click on the button and tell me what the path to the image is showing as.

[effeff70]

Hi,

it say?s:

http://endurojunkie.de/forum/billspaypal.php?

You meant that?

But when i click the button, the link to paypal works....

[Billspaintball]

Check your images folder forums/images/misc/
Make sure that a file called paypal_Spende.gif is in that folder.

Check the spelling and case of the filename if its in there.

[effeff70]

Check your images folder forums/images/misc/
Make sure that a file called paypal_Spende.gif is in that folder.

Check the spelling and case of the filename if its in there.



Thanks a lot, that was the mishap..... I did?n set another name for the .gif, was still called "donate".


Best Regards vom Germany
Frank

[effeff70]

Now there is something else, User klicks "Spenden"-Button, new Window open (your screenshot 2) currency is Eur-Euro (settings in AdminCP) then write maybe 10 euro Inbox and choose "Paypal" -Button.....new Window (paypal) opens.....currency here is now USD????? Settings in Options my Paypal-Account is Euro, too.....what´s wrong??

[effeff70]

can someone help?
Its still the same prob. from last post.

[effeff70]

Is here nowbody who has the same problem? No help?

[effeff70]

Thats really bad, no help---sucks--- uninstalled.

[Blue91]

Anyone with VB 3.8 installed this and confirmed that it's working yet?

[ouch]

I have installed this on 3.7.4 and once i realized i'd imported the images to the default misc file i corrected it and sent them to my custom skin...................works real good thankyou:up:

[tlwwolfseye]

How secure is this script, considering its not supported ?
Thanks in advance.

[Ohiosweetheart]

Are there currently any issues with 3.8?
Are there any plans to upgrade this mod to 3.8?

[Ohiosweetheart]

Well, I installed it on my 3.8.1 forum, and so far so good!

[mrcake]

Yep, working fine with 3.8 and Advanced Navbar links. 'Donate' added to the navbar with no issues and no manual tweaking with the template. Thanks for the great hack!

[Gene Steinberg]

Yep, working fine with 3.8 and Advanced Navbar links. 'Donate' added to the navbar with no issues and no manual tweaking with the template. Thanks for the great hack!

Too bad it'll never be compatible with vBulletin 4.0, or maybe someone could do the stuff needed to make it work?

Peace,
Gene

[BoneDust]

It works well in 4.14, but I don't see a donated page.

I thought that when people donate their names would appear in a "donated" page. Like a history of donators/donations. Am I wrong?

Other then that it works great in 4.14 :)