vb.org Archive - PayPal Easy Donate

vb.org Archive (https://vborg.vbsupport.ru/index.php)

- vBulletin 3.5 Add-ons (https://vborg.vbsupport.ru/forumdisplay.php?f=113)

- - PayPal Easy Donate (https://vborg.vbsupport.ru/showthread.php?t=113159)

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

Manual Template Edit
(if using modded navbar)

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.

Code:

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

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>

hmmm the input type kinda looks like mine does.... looks like you liked the code huh :)

Intalled and working fine ;)

http://phonexpo.net/billspaypal.php

ok installed.. one thing i've noticed from your screenshot the paypal suppose to be centered on my board is to the left column. "The please enter money part"..

any idea to get it centered.

thanks

i sent him a pm on that already to center it with a <div align="center">

Quote:

Please enter your donstion amount above,
and then click on the donate button below.

donstion should be donation

:)

Quote:

Originally Posted by puertoblack2003

ok installed.. one thing i've noticed from your screenshot the paypal suppose to be centered on my board is to the left column. "The please enter money part"..

any idea to get it centered.

thanks

Sorry, I didnt test in Firefox.
Will release an update shortly.

Quote:

Originally Posted by phonexpo

donstion should be donation

:)

Doh!!!
Its late here ok. :tired:

I will fix it in the morning.

I've fixed it; (just change the currency to what you want in the file as
I have it in €)

yeah there is a few bugs on it make it 100% html complaint too... close the break and also make it lower case break too

example

Code:

<div align="center"><span class="smallfont">Please enter your donstion amount above,<br>and then click on the donate button below.</span></div>

should be

Code:

<div align="center"><span class="smallfont">Please enter your donstion amount above,<br />and then click on the donate button below.</span></div>

Quote:

Originally Posted by phonexpo

I've fixed it; (just change the currency to what you want in the file as
I have it in €)

ok cool no prom

edited i don't think there's a need to change currency as the default he has it as aus. just change it to USD unless from what ever country you in

Quote:

Originally Posted by phonexpo

I've fixed it; (just change the currency to what you want in the file as
I have it in ?)

Hmmm......
I never thought of that.
Will do something so it changes depending on what currency you set in the Admin CP.

Good idea. Thanks for the hack anyway, great work. :)

Quote:

Originally Posted by Billspaintball

Hmmm......
I never thought of that.
Will do something so it changes depending on what currency you set in the Admin CP.

i tested it and seem to work on my end ...didn't change any currency only in cp to usd.

Quote:

Originally Posted by puertoblack2003

ok cool no prom

edited i don't think there's a need to change currency as the default he has it as aus. just change it to USD unless from what ever country you in

You can change the default currency by the admin CP setting.

I will change the layout a little in the morning so that it shows what currency is the default on the donation submit page.

That's because the USA and OZ us the same symbol ;) ...

Updated to 1.1
Version 1.1 has been released.
Please update as it resolves a couple of issues.

Changelog

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 om donation page

Quote:

Originally Posted by Billspaintball

great outstanding job, worked for me...:banana:

Any plans for it to show who has donated like the cloudrunner version did?

Quote:

Originally Posted by Billspaintball

Thanks for this hack!

The currency symbol is after changing to EUR not shown up - € -.

Any idea?

And how can i disable the "Donate" in the navbar?

great thanks for this one - with the verified area, is it possible to change the country for verification from OZ?

Quote:

Originally Posted by Pady

great thanks for this one - with the verified area, is it possible to change the country for verification from OZ?

Yeah, open the xml file in word pad then search for the link then change it to what you want, that's what I did. Then re-upload it.

Quote:

Originally Posted by .Tim

Any plans for it to show who has donated like the cloudrunner version did?

Short answer is maybe.
Depends on me being able to work out how to do it.

Quote:

Originally Posted by klaush

Thanks for this hack!

The currency symbol is after changing to EUR not shown up - € -.

Any idea?

Yes you need to enter your currency symbol in the Admin CP as well as EUR. Its the next setting down.

Look at the attached screenshots. Cur1.jpg shows the 2 settings you need to change in the Admin CP, while Cur2.jpg shows what it looks like on the donation page when changed.

Quote:

Originally Posted by .Tim

Any plans for it to show who has donated like the cloudrunner version did?

there is alot of flaws in his... hence why everyone is leaving it... his script is very buggy i had it installed for a total of 2 days after the errors i removed it... and made the one i did.... but it would be a nice feature...

Quote:

Originally Posted by DementedMindz

I know that, which is why I'm asking if it will be done in this one because I'd like to get away from that one.

Quote:

Originally Posted by klaush

And how can i disable the "Donate" in the navbar?

Easy.
Admin CP -> Plugin System -> Plugin Manager

Then make the plugin called "Bills Paypal Donations" Inactive.

See attached screenshot to see what you make inactive.

I will add this ability directly to the donate settings in the control panel next version.

Quote:

Originally Posted by DementedMindz

I don't have a problem with the code. I like it and don't feel the need to remove it.

Good hack. I've just installed it in my forums.

http://www.techtalkz.com/forum.php

Hope somebody'll donate a few bucks as i need to renew the domains :D

Than you so much Bill. This is excellent. :)

Cheers

Clancy

Quote:

Originally Posted by Billspaintball

Thanks for your fast support!

What a great clean "donate" mod!!

I would love to install this but i'd personally need it so I was able to either show what members had donated with the option of displaying the amount donated as well as the username in a vBA CMPS block or/and be able to automatically put the user into a secondary user group for donators for obvious extra privileges/access reasons.

Have you plans to do any of these? It would make this hack THE definitive and standard donator hack for vB!

as for a block i told Bill he could use mine and change the stuff around so it would work with his mod... if he dont want to ill make the block but it wont show who donated it will just give them a option on the main vbadvanced page...

also you need to group the templates together in admincp

under the </form> add a </div> and on the bottom verify image do this <img src="$stylevar[imgdir_misc]/paypal_verified.gif" border="0" alt="Official PayPal Seal" /> and its 100% html complaint

Awesome hack.... i decided to leve cloud's hack and switch to this.

But i was wondering if u can add the Goals per month, Total Donated this month, Donation Needed, or something like that. Thanks!

Quote:

Originally Posted by DementedMindz

under the </form> add a </div> and on the bottom verify image do this <img src="$stylevar[imgdir_misc]/paypal_verified.gif" border="0" alt="Official PayPal Seal" /> and its 100% html complaint

Thanks.
Will be fixed in next version.

Quote:

Originally Posted by trancetopia

What a great clean "donate" mod!!

Thanks ! :)

Quote:

I would love to install this but i'd personally need it so I was able to either show what members had donated with the option of displaying the amount donated as well as the username in a vBA CMPS block or/and be able to automatically put the user into a secondary user group for donators for obvious extra privileges/access reasons.

Have you plans to do any of these? It would make this hack THE definitive and standard donator hack for vB!

Ive been chatting to DementedMindz about convering his vBA CMPS donate block into a product, so you will be able to set the options up in the AdminCP. Im not sure how sucessfull this will be due to the way vBA handles blocks, but all I can do is try and see.
Wont be for a little while though.

As for adding users to other usergroups, Im currently researching PayPal callbacks. If I can get my head around that then its quite possible.

Phrase Groups Available:

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.01561 seconds Memory Usage 1,853KB Queries Executed 10 (?)
More Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (4)bbcode_code_printable (20)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)pagenav (1)pagenav_curpage (2)pagenav_pagelink (1)post_thanks_navbar_search (1)printthread (40)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start pagenav_page pagenav_complete bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: