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

Drix · #**332** 05-28-2007, 05:35 PM

Quote:

Originally Posted by tommykjensen

I just upgraded to the latest version. But now the paypal image appears here

Attachment 64812

instead of at the top.

Attachment 64813

Yeah, i noticed that as well. Looks weird, so i changed it to navbar..

Billspaintball · #**333** 05-28-2007, 08:38 PM

Quote:

Originally Posted by tommykjensen

Ok. Think I will use the navbar link option instead then. The button look out of place there.

What is that hook called? Can you also tell me what to look for in the XML file so I can see how to do this because I think I want to use that for my simple global announcement hack as that position is exactly where I want it.

The hook location is called

Code:

$template_hook[navbar_buttons_left]

Its all done by this plugin

PHP Code:


			
        <plugin active="1" executionorder="5">

            <title>Bills Paypal Insert Link</title>

            <hookname>global_start</hookname>

            <phpcode><![CDATA[

            if ($vbulletin->options['billspp_displaylink'] == "0" )

            {eval('$template_hook[navbar_buttons_left] .= "' . fetch_template('billspp_navinsert') . '";');}

            if ($vbulletin->options['billspp_displaylink'] == "1" )

            {eval('$template_hook[navbar_buttons_left] .= "' . fetch_template('billspp_buttoninsert') . '";');}

    ]]></phpcode>

        </plugin>

txsbmw · #**334** 05-29-2007, 12:05 AM

Is there anyway to add a comments field to this that will get processed. For example on the donation page have a comments field in the form where the user can type why they are donating or leave comments etc.. that will get processed with the payment, so when we receive the payment via paypal and the e-mail they send out it shows the comments on why they are giving the donation, etc... should they choose to leave any?

Hope I made sense, lol.

Billspaintball · #**335** 05-29-2007, 02:18 AM

Quote:

Originally Posted by txsbmw

Is there anyway to add a comments field to this that will get processed. For example on the donation page have a comments field in the form where the user can type why they are donating or leave comments etc.. that will get processed with the payment, so when we receive the payment via paypal and the e-mail they send out it shows the comments on why they are giving the donation, etc... should they choose to leave any?

Hope I made sense, lol.

Yes that makes sense

Its not a hard thing to do, just another field in the submit form really.
Its a good idea and I will make it a CP option in the next update.

DementedMindz · #**336** 05-29-2007, 02:39 AM

Quote:

Originally Posted by txsbmw

Is there anyway to add a comments field to this that will get processed. For example on the donation page have a comments field in the form where the user can type why they are donating or leave comments etc.. that will get processed with the payment, so when we receive the payment via paypal and the e-mail they send out it shows the comments on why they are giving the donation, etc... should they choose to leave any?

Hope I made sense, lol.

Quote:

Originally Posted by Billspaintball

Yes that makes sense

Its not a hard thing to do, just another field in the submit form really.
Its a good idea and I will make it a CP option in the next update.

yeah Ill stick with my old version or hopefully you can shut it off in admincp cause that ain't needed since it can be done when they send the donation via paypal. my thoughts would be why waste time coding that when other more important things can be added donation goals, who donated, etc.

tommykjensen · #**337** 05-29-2007, 04:03 AM

Quote:

Originally Posted by Billspaintball

The hook location is called

Code:

$template_hook[navbar_buttons_left]

Its all done by this plugin

PHP Code:


			
        <plugin active="1" executionorder="5">

            <title>Bills Paypal Insert Link</title>

            <hookname>global_start</hookname>

            <phpcode><![CDATA[

            if ($vbulletin->options['billspp_displaylink'] == "0" )

            {eval('$template_hook[navbar_buttons_left] .= "' . fetch_template('billspp_navinsert') . '";');}

            if ($vbulletin->options['billspp_displaylink'] == "1" )

            {eval('$template_hook[navbar_buttons_left] .= "' . fetch_template('billspp_buttoninsert') . '";');}

    ]]></phpcode>

        </plugin>

Thanks.

txsbmw · #**338** 05-29-2007, 09:42 AM

Quote:

Originally Posted by Billspaintball

Yes that makes sense

Its not a hard thing to do, just another field in the submit form really.
Its a good idea and I will make it a CP option in the next update.

I didn't think it was, but I cannot get it to work. I went to paypal and did generate button so I could compare the HTML code given. Found

Code:

<input type="hidden" name="cn" value="Comments">

and added it to the template. Changed it to a none hidden field, but when I filled it in and clicked donate it didn't show up on paypal (where it shows what you donated and asks you to log in or choose a payment option). Obviously I could not go past that step because you cannot pay yourself

And it has been so long since I have created a paypal form to use on a website that my mind is going blank when it comes to this, lol.

So any ideas on how to get it to work until you can release your next version? Thanks in advance!

Billspaintball · #**339** 05-29-2007, 10:33 AM

Quote:

Originally Posted by txsbmw

I didn't think it was, but I cannot get it to work. I went to paypal and did generate button so I could compare the HTML code given. Found

Code:

<input type="hidden" name="cn" value="Comments">

and added it to the template. Changed it to a none hidden field, but when I filled it in and clicked donate it didn't show up on paypal (where it shows what you donated and asks you to log in or choose a payment option). Obviously I could not go past that step because you cannot pay yourself

And it has been so long since I have created a paypal form to use on a website that my mind is going blank when it comes to this, lol.

So any ideas on how to get it to work until you can release your next version? Thanks in advance!

I think it would be best to use the PayPal 'memo' variable.

Something lke

<input type="textarea" name="memo" rows="5" cols="40" value="" />

Riccardo83 · #**340** 05-29-2007, 08:05 PM

hi guys, one question. my paypal donation link redirects to the german paypal. my account is in germany, but shouldnt it be possible to have the english interface running because most of my visitors are english speaking?

http://alizee-forum.com/billspaypal.php?

Billspaintball · #**341** 05-29-2007, 11:30 PM

Quote:

Originally Posted by Riccardo83

my account is in germany, but shouldnt it be possible to have the english interface running because most of my visitors are english speaking?

http://alizee-forum.com/billspaypal.php?

Im not sure If PayPal allow you to change your language when you register to a specific country or not.
A Way around it may be to set up another PayPal account under PayPal UK, or just PayPal.com and select Euro as your default currency there.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.11726 seconds Memory Usage 2,354KB 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 (2)bbcode_php (9)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!