The Arcive of Official vBulletin Modifications Site.

PayPal Easy Donate - vB 3.6 · **Released**: 08-05-2006

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

BBI-Ross · #**302** 05-15-2007, 09:28 AM

Is there an option to show who has donated and how much underneath or above the forum statistics? or anywhere else?

Cheers

DementedMindz · #**303** 05-16-2007, 01:38 PM

BBI-Ross its been asked alot but no there is not.

Billspaintball · #**304** 05-25-2007, 08:46 AM

Quote:

Originally Posted by BBI-Ross

Is there an option to show who has donated and how much underneath or above the forum statistics? or anywhere else?

Cheers

Im currently testing that version on my live site.
http://www.billspaintball.com/vb3/

It works well enougth, (communicates with PayPal, adds data when verified from PayPal etc) and I think all the major bugs are gone, back end is complete (except for goals) but the front end is not polished enougth for release just yet.

Attached a pic of the back end

Fireproof · #**305** 05-25-2007, 02:04 PM

Bill,

Why is this happening? I have installed per the directions, but I had to manually edit my "header" (which is where the navbar is) to add the Donate link. But it points to mysite.com/billspaypal.php? rather than mysite.com/forums/billspaypal.php?

Also, even if I manually insert the "/forums" in the address bar to test it, none of the images are coming through (because they likely are missing the /forums as well.

How do I fix?

Fireproof · #**306** 05-25-2007, 02:22 PM

Quote:

Originally Posted by Fireproof

Bill,

Why is this happening? I have installed per the directions, but I had to manually edit my "header" (which is where the navbar is) to add the Donate link. But it points to mysite.com/billspaypal.php? rather than mysite.com/forums/billspaypal.php?

Also, even if I manually insert the "/forums" in the address bar to test it, none of the images are coming through (because they likely are missing the /forums as well.

How do I fix?

Okay - I fixed the images issue. Had to upload them into my custom_style/misc folder. So that's done.

But I can't get the following code to work right on the navbar, so that it picks up the /forums ...

Code:

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

DementedMindz · #**307** 05-26-2007, 02:46 AM

Bill let me know if you need help

Billspaintball · #**308** 05-26-2007, 10:56 AM

1.32.366 is now available for download.

1.32.366 is simply version 1.32 modified to make use of the new template hooks that were implemented from vB 3.6.6 onwards.

If your 1.32 version is working fine there is no need to upgrade.

The benefit of this version is that it should be more likely to work on boards with modified templates and styles, and much more likely to continue to work when new versions on vB are released.

Please note that vB 3.6.6 is the absolute minimum requirement for 1.32.366 to work.
People using vb3.6 to vb3.6.5 beed to use the attached 1.32 zip.

Billspaintball · #**309** 05-26-2007, 11:01 AM

Quote:

Originally Posted by Fireproof

Okay - I fixed the images issue. Had to upload them into my custom_style/misc folder. So that's done.

But I can't get the following code to work right on the navbar, so that it picks up the /forums ...

Code:

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

Have you tried using

Code:

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

[/QUOTE]

or as a last resort

Code:

<!-- PayPal Donations -->
<td class="vbmenu_control"><a href="http://www.mysite.com/forums/billspaypal.php?">$vbphrase[billspp_donate]</a></td>
<!-- /PayPal Donations -->

[/QUOTE]

One of those should work in this case.

Billspaintball · #**310** 05-26-2007, 11:04 AM

Quote:

Originally Posted by DementedMindz

Bill let me know if you need help

Tempting.....

Im pretty useless with standards compliant XML, might send a PM your way when I tidy a couple of things up

(yes Ive been very slow but I do have it running on my live site at least

)

djbaxter · #**311** 05-26-2007, 02:04 PM

Installation error message for version 1.32-366:

Quote:

The following dependencies were not met:
This product is not compatible with version 3.6.7 of vBulletin. (Compatible starting with 3.66)

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.07225 seconds Memory Usage 2,324KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (4)bbcode_code (5)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (2)pagenav_pagelinkrel (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.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/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.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 showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!