PayPal Donations For vBulletin 3.5.0
 

Paypal Donations 2.01

• Fixed a small bug in the display of the top / last donors on the donate page.

Paypal Donations 2.00

• Ported system over to vBulletin 3.50
• Added ability for the installer to install template edits automatically
• System installs plugins automatically
• Fixed some minor bugs that were present in 1.07 of the 3.0.7 vBulletin donations system.

Paypal Donations is a complete system that controls donations and how they are received via backend interfacing between your vBulletin server and Paypal's payment gateway server. The beauty of this marriage of servers is quite simply automation of the donation process as well as security of the transactions for both you, the administrator, and your users. With the Paypal donations system installed on your forums, you will be able to bring in that much needed income to not only keep your forums alive, but also to help defer costs of doing so to the users of your site without having to bug everyone and beg for money.

This seamless integration of Paypal as your backend payment processor not only provides your user with a well known and safe payment processor, but you are saved the hassle of opening a merchant account with your banking institution as well as saves you time in the process as it takes only a few short minutes to sign up with Paypal if you are not already an account holder there.
OS: vBulletin 3.5 (if you are running this already, then your server has the required installation, GD libraries are required, as well as CURL capabilities for this system to work)

Direct File Edits To vB Resident Files: 1 (needed to group templates in AdminCP)
File Uploads: 34 (Of which 18 will be deleted after installation, leaving a total of 16 Files on your server)
Direct Database Queries: None, the installer does these for you
Direct Plugin Installation: None, the installer does these for you
Direct Template Modification: None, the installer installs all new templates, and modifies the resident templates as needed

The uninstaller will remove all modifications (to include the templates) should you decide to remove the system from your server.

Installation and Upgrading are as easy as a human like me could make it. Simply upload all the files from the archive to your server keeping the folder hierarchy intact and then point your browser to the installation file. On most servers it will be one of the following:

• http://www.yourdomain.com/admincp/donations_install.php
• http://www.yourdomain.com/forum/admi...ns_install.php

Just follow the prompts from there folks, the installer does all the database, template, plugin, phrasing, and settings automatically for you!

If you ever decide to remove the system, just upload the install files and folder again and run the installer and choose uninstall. The uninstaller will remove any and all modifications that it did to your files, database, and templates automatically as well. Its as easy as you can get!

Time to install: less than five minutes depending on your upload speed.

1. You must make sure that you have either a Business or Premiere account with Paypal.
   1. If you do not, then you will need to upgrade your Paypal account to that level before this system will work.
2. You must have Paypal's IPN (Instant Payment Notification) turned on in your Paypal Profile.
   1. You do not need to have it pointing at any particular file for this system to work as the system will tell Paypal where to send the IPN to credit your users and notify you of the transaction.
3. You will need to run through the donations settings at the end of the installer and make sure that you have all the required information in there.
4. Please note that this system can be placed into test mode (default setting is ON when system is first installed).
   1. This setting tells the system whether to speak with the real Paypal Server for transactions or with Paypal's Sandbox (testing) server. If you wish to test the system before going live you will need to have access to Paypal's Sandbox server, you can sign up for access there at: http://developer.paypal.com.
5. You will need to input your Paypal Account Email into the settings
6. You will need to input the full URL to your donate.php file so that your users can make it back to your site after payment
7. You will need to input the full URL to your ppverify.php file so that Paypal can send your IPNs to you and your system can process the information and give your users credit for the donation

I am releasing this authorization in the hopes that someone will be able to carry on the work that was begun.

You will need to add a link somewhere in your navigation system for vBulletin pointing your users to the donations page (if you installed the vBadvanced Module then you have a link on the home page, but you might want to add one in the nav bar as well), as well as setting up your paypal account to give IPN responses to you, you can do this in your Paypal Profile under Instant Payment Notification.


Thank you!

)O( Cloudrunner )O(

P.s. Should you feel the need to donate to me in thanks, I will not stop you ;), in fact I will say thank you and that your support is greatly appreciated. If you do donate to me for this hack, I will give the recognition here as well as on The Noble Pagan. You can find my donations page here (also works as a demo site should you feel the need to check it out):

The Noble Pagan Donation Page

Interesting blank hack :p

Satan

As will be most likely request within the first ten posts, here are some basic screens of the system.

Yeah you like that? Thought some might...

Seriously though, I'm working getting the post finished now, will be up shortly.

)O( CR )O(

Just to answer a question that may come up, yes this system is on a live server running 3.5.0.

Sorry folks, missed one little thing in the system. It has to do with the sorting of the top or last donors on the donate.php page. Typical upgrade techniques are in effect here: Upload all files, overwriting all old ones, and then run the installer running the upgrade. Simple as that.

You don't have to do this upgrade as any following upgrades will address this small issue as well. This does not affect you if you choose to show the TOP donors, only if you want to show the true LAST donors will it affect you.

I've updated the zip with the update.

Love and light to all!

)O( Cloudrunner )O(

Great hack, thanks!

Thank you!

I am curious as to everyone's experience with the installer, was it worth the hours of getting that to work with the templates and the plugs installed at the same time without needing to do the edits manually, should something be adjusted in the installer? In general, I'm looking for feedback on the installer as it is a write from scratch deal...

wow you got that out fast :)

I just finished installing it on vb3.0.7 just working on getting my sand box setup :) I'm looking forward to vb3.0.5 going gold :)

6 Liters of Mountain Dew will do that to one who was nabbed by the matrix...LOL

Database error in vBulletin 3.5.0 Beta 3:

Invalid SQL:
CREATE TABLE forum_donation_donors (
id int(100) NOT NULL auto_increment,
userid int(255) NOT NULL default '0',
ip varchar(255) NOT NULL default '',
total decimal(10,2) NOT NULL default '0.00'
PRIMARY KEY (id)
) TYPE=MyISAM;;

MySQL Error : You have an error in your SQL syntax. Check the manual that corresponds to your MySQL server version for the right syntax to use near '(id)
) TYPE=MyISAM' at line 6
Error Number : 1064
Date : Sunday, July 3rd 2005 @ 11:29:17 PM
Script : http://....../admincp/donations_install.php
Referrer : http://....../admincp/donations_install.php

Classname : vb_database

Well, that goofed...Sorry folks, found an issue with the WOL, as well had a user point out a goof in the cold install of the system. I have updated the archive with the new file, if you had problems with a cold install then do an uninstall first, then reinstall, if you installed without problems, then simply run the upgrader.

If you had installation problems from a cold install, and you do not uninstall first, then you will run into multitudes of problems (we had this glitch in the 3.0.7 for awhile).

Lemme know if you run into any more problems!

)O( Cloudrunner )O(

Works Now :D Thanks

no problem, it was a stupid comma missing....I hate that...

Top Donors
Sorted by Total Donations View All Donors
View All Donors

Takes you to the wrong link

http://www.example.com/forums/alldonors.php

explain...

The View All Donors link takes you to the alldonors.php page...not the donate.php page...

Picture Missing

I'll get you a picture

this section takes you to the following Link
http://www.example.com/forums/alldonors.php
Not
http://www.yoursiteaddressgoeshere.c.../alldonors.php

If you are getting bar draw problems, then open the file ./includes/pp_image.php and at the bottom find: and add just below thatso that the final code looks like thisWe had some issues with that line in previous 3.0.7 installations. I will fix that file and get it in the next update.

the view all donors link is coded in the template to run off of whatever you have in your vboptions for the bburl.

so if you are getting a link of http://www.example.com/forums/alldonors.php then you have that coded in your options in the AdminCP. The link for the options page that that setting is in is: (otherwise known as vBulletin Options) under the heading of "Site Name / URL / Contact Details". The setting name is "Forum URL"

is the line of code in relation to the image thats not working
Same problem im having for the show all donations
http://www.example.com/ <<< Is not changing to what my site link is

remind me not to let that monkey ever install anything on my forum :roll: need to have words with the other techie...

Note: he didnt set up the board properly ;)

least the problems fixed now :D

Fix your vbulletin options bro...

Here's how ALL the links in the system are coded in the templates:This is standard vBulletin templating. Even with the new standard of it works in the templates. The reason I kept the standard instead of changing to the new standard for the coding is I could not get the bloody $vbulletin->options[whatever] to read in the templates, but the $vboptions is still supported.

The only thing left is for you to go into your settings (I suggest view all), make sure your forum URL does not state "http://www.example.com" and then hit save to refrog your datamanager. Check all that and let me know, a screen of the URL settings for your Admincp would help.

so it's good then? The problem was in the options?

Yeh, should have knowen it was his fault... Had to go change a lot after he installed it :roll: not surprised id missed something he'd not done

want me to pass him a message from you for causing you hassle? :evil:

Nah, just hoping that you didn't pay him lol.

Can you create this for 3.0.6?

Search and you will find:

Paypal Donations For vBulletin 3.0.7

To my knowledge it doesn't break with any of the 3.0.x series...

$vbulletin->options won't work in templates ;)

All the default vB templates use $vboptions :)

Satan

My bad :-p I try and check everday for new hacks, must have missed it...Thanks a bunch ;-)

Thank god No! Just a boot up his backside for being a lazy sod and not doing his job correctly

Technically, works, but do you know how many of thos damned curly braces I'd have to add to my templates for this? So I left it as $vboptions.

no problem

I'm not running this version of vb, so cant test it and therefore not sure what it offers different to your 3.07 one, but i thought the following might be of help since your in development with this version appose to carrying on with the other for 3.07..

I installed in on my site and one of my members comments about his ammount not being private, obviously you can donate as a guess but not all members will think about that.

So i thought a possible thought towards making donation ammounts secret or the user them selves secret from being listing in the donators section etc, at first i never thought about that, and like in life some people do like donating but rather keep anonymouse about it.

Hope you dont mind this suggestion, maybe of use.

Yes with the parentheses it works, but you said $vbulletin->options without any :p

Satan

The users can already OPT-OUT from the display recognition, if you did all the template adjustments, and the file edits in the old version, they only need to go into their profile options and turn that option off...

Touche'