The Arcive of Official vBulletin Modifications Site.It is not a VB3 engine, just a parsed copy! |
|
Paypal Donations for vBulletin 3.0.7 Details »» | ||||||||||||||||||||||||||
Due to real life I have ended support of this hack. Please see licensing information below. Please read the troubleshooting tips below before asking for support. ******************************** Paypal Donations for vBulletin 3.0.7 Release version: 1.07 Release Date: 28 June 2005 ChangeLog: Paypal Donations 1.08 Special Thanks:
dsboyce8624 SLeeeper And all of the Alpha Testers that helped out with this Hack! I couldn't have done it without you. What it does Quite simply this hack provides you a way to receive donations from your website's users and provide them with the recognition deserving of a donating member of you community. It uses Paypal exclusively because of Paypal's "Instant Payment Notification" system.The basics are this:
Features
**Coming Soon**
Stuff you have to do Files to upload: 34 Files to modify: 3 Templates to modify: 1 (required) / 2 (Optional) Queries to run: (The install script does this for you, uninstallation is also provided as well) Ease of install: easy, simply follow the instructions in the install script. Time of install: ~5 minutes ***REMEMBER! Add your email address that Paypal has on file in Donations settings. This step is not an option, your payments, although they may be valid, will all be considered invalid if you do not do this! Sign up for Paypal's Premiere Account (Business), and setup IPN. Paypal Registration You will need to register with Paypal for a premiere account if you have not already, if you have, but your account is probably a personal account, you will need to upgrade the account to a premiere account. Assuming that you have a premiere account and have been verified, you then go into your profile at http://www.paypal.com and the select Instant Payment Notification. There will be a checkbox that you must check, you do NOT have to point to the script at Paypal, if you choose not to do this, then you will need to make sure that your Notification URL is put in the settings or this script will NOT WORK!On most systems it will be either: http://www.yourdomain.com/ppverify.phpor http://www.yourdomain.com/forum/ppverify.phpThat's all there is to setting up Paypal to work with your site! Install Upload all the files in the archive into their provided directoriesRun the provided install file, setup your settings, after installation, DELETE THE FILE! This will usually be: http://www.yourdomain.com/forum/admi...ns_install.phpor http://www.yourdomain.com/admincp/donations_install.php How To Use The System To begin with, you simply upload all the files into their respective directories (keeping the structure in the archive).After you upload the files, point your browser to the installation file: donations_install.php and run the installer all the way through, remembering to save your settings at the end (you MUST put in your paypal email, and the path to donate.php, and the path to ppverify.php). Remember, if you have the system set in test mode, you will not be able to process LIVE transactions. If you are going live immediately, then change this setting to no! After you install, simply delete the donation_install folder and all files within it, and the install file. Now you are ready to play. The system is 100% phrased on the user viewable side, so you will need to edit some of the phrases to better suit your site, specifically the phrases titled: your_donations_are_appreciated all_donations_go_towards_furthering_goals donation_used_to_further_mission are the ones that I recommend redoing to suit your site. After editing the phrases, next comes adding your donation buttons and goals. Always add your goals first as the buttons can be attached to a specific goal so that the user gets credit for donating towards a specific goal (you can of course add a button that does not attach to a goal for a general coffer fund type of deal, but goals are the preferred method). After adding a goal, you can then add a button to the site. The settings for the buttons are self-explanatory for the most part, the only required input from you is the title, and the description of the button. Everything else will work fine without input. The system defaults to use the USD currency. If you change this currency in the Donations settings, then to get the correct exchange pricing, you need to run the CRON file to update your Exchange Rates table. To do this simply log into your AdminCP and then do the following:
From there, it's all fairly intuitive. The biggest thing to remember is that to use this hack you MUST have a paypal Business or Premiere account, and have turned IPN on in your Paypal profile. If you run into troubles with a transaction, make sure that you are not trying to verify a sandbox transaction with the live Paypal server and vice versa (the test setting). Secondly, this system will notify you of suspect transactions that Paypal refuses to validate. If you get an email stating that a transaction was invalid, it would suit you to investigate it to find out where the transaction came from and why it failed verification. If all is kosher you can add the donor to the AdminCP so that they get credit for the donation. To assist in this you can edit an invalid transaction to show as valid if the transaction turns out to be kosher. The steps to this are as follows:
After Install 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.To play in PayPal's Sandbox you will need to be registered with their developer network and setup a few sandbox accounts to play with the sandbox properly. I have throughly tested the sandbox functionality, and it is working until they decide to change coding standards again. Troubleshooting tips and procedures Due to the multitude of possible break-points between Paypal and this script I must request that the following be followed before reequesting support on this system from this point forward:
Lastly, if you have modified the base files in any way, I will NOT give support to this. The files are set in the way that they need to be to run under 90% of server installations. Any other installations that require files to be merged, etc., sorry but you are on yer own in that situation. FYI: The Paypal Notification is completely seperate from the user being sent back to your site. Thus the reason that the ppverify.php file is NOT a function of donate.php. How To Get vBadvanced CMPS v1 Module to work with vBadvance CMPS v2 Follow this link to aranthorn's Instructions on how to get this to work. https://vborg.vbsupport.ru/showpost.php?p=669033&postcount=231 Thank you aranthorn!!! ******************************** I sincerely hope that you enjoy this hack, Please feel free to send feedback to tnp@noblepagan.com! To view this in action head over to: http://damn.that-sucks.net or http://www.noblepagan.com Thank you! )O( Cloudrunner )O( P.s. Anyone who feels the need to donate to me (*hint hint*) feel free to do so, I won't stop you (yeah, I'm as greedy as the next guy). In fact we are a non-profit organization over at The Noble Pagan, so your donation would be tax-deductible . LICENSE: Quote:
Supporters / CoAuthors Show Your Support
|
Comments |
#552
|
|||
|
|||
Quote:
the donate.php is roughly 10k in the forum root, the one in the modules folder is about 3k, im running vbulletin 3.0.8 and VBA 2 |
#553
|
||||
|
||||
HOw do I start the installation??
|
#554
|
||||
|
||||
Quote:
Anyway, they have given me a reprieve from travelling for awhile, and I'll look into some of the problems ya'll have been having. Please don't get all frustrated and upset if I'm not around all the time, I do have a life outside the computer, and I am not always on the thing, plus I cannot promise that I won't be on a flight tomorrow to recover and rebuild hospitals in Texas, Louisiana again as I have been over the last month. Now, as for the rrors that folks seem to be having with the advanced module, first make sure that in your settings for the donations state to view the donation module. If you do not have that set to yes, the thing will never display the module, also make sure that your other settings for donations are as they should be for your specific site. I included alot of settings for the donations that will remove the functionality of some of the things that PPD does with one simple click on the settings. Please be as specific as possible when descibing your problem, use three pages of text if you have to, I am not a mind reader, nor do I have the ability to wave my magic pink faery wand and see into my crystal ball exactly what you are experiencing unless you put it in plain english for me. Now on a side note, I have been away quite abit, and will continue to be away off and on, I cannot promise that I will be able to support this hack any longer in the way that I used to. That being said, I am removing the supported check box on the thread; should you have a question or problem with this version, ask, be specific in your descriptions, and I will do my best to help when I can but as of this point, there are no promises being made. As well, I am not going to be adding any features for this version of the hack since 3.5 is nearing completion and gold status, but I am also not releasing any version for 3.5 beyond what I already have until vb has hit gold status. However, I will keep you updated on progress better of the new gold version of PPD. )O( Cloudrunner )O( |
#555
|
||||
|
||||
Quote:
|
#556
|
||||
|
||||
Quote:
|
#557
|
||||
|
||||
Quote:
|
#558
|
||||
|
||||
Quote:
By this I maen: 1) have a goal 2) have a button 3) have that goal assigned to that button 4) the user is logged in 5) the donation is made by clicking the button 6) the user completes the transaction by coming back to your site After you create the button / goal, it is ALWAYS good practice to go back and verify that something did not hiccup during the creation of the thing. It's very simple to do, just click edit on the goal or button and make sure everything is as it should be. If the associations are not correct, the stuff will break. Now, that being said, I cannot promise that IPN has not changed its protocol slightly in the last two months as I haven't even glimpsed at this hack for approximately that long, but I will look into the auto update not happening for you guys. Everyone needs to understand that as soon as 3.5 goes gold, I will drop support for this completely 100%, right now I'm only supporting this thing at 25%, even less while I was out and about for the company. |
#559
|
||||
|
||||
Quote:
|
#560
|
||||
|
||||
Quote:
That being said, it shows me just how lazy some folks are to read the information placed in the first post (majorj0nny), seems that the loudest one of all is also the one who did NOT read. That error that everyone is complaining about (can't find the phrase 'adv_portal_must_choose_0_include') is an error of the vBadvanced 2.0 system trying to read the 1.0 module inproperly. Not that I have figured ya'lls problem out, check the first post and read the whole thing., better yet, I'll quote a user from a couple of pages back Quote:
Now if you do those steps as listed by aranthorn, and it still doesn't work, then please, by all means, post your issue here and I will do what I can. * Cloudrunner walks off grumbling to himself on whether it is too much to ask for people to read... |
#561
|
||||
|
||||
Now that I think we've addressed everything, I'm going to rant abit...
While it's not my requirement to tell everyone what is going on in my life, it is my responsibility to everyone to support this thing, because I said I would. In that I have not done so in the last two months. The last month I have been in Louisiana, but for the month previous I have no excuses other than personal issues. Even so, although it is required for me to provide support here, I'll be honest folks, I'd rather not. The reason is that now that I'm home I'm working on the 3.5 version of this thing, and would like to put my efforts into that version of the software. I do not even use 3.0.x anymore on my sites, nor do I want to, but seeing as I said I would support this version, I will to the best of my abilities. Until 3.5 goes gold. Be ready for that folks, as soon as 3.5 goes gold, I will drop this version like a sack of rocks. This is the warning now, so what you see is what you get as of this point, I'm not going to add functionalities, nor toys to this version. Nor will I visit this thread after that time. This is just a forewarning. )O( Cloudrunner )O( |
|
|
X vBulletin 3.8.12 by vBS Debug Information | |
---|---|
|
|
More Information | |
Template Usage:
Phrase Groups Available:
|
Included Files:
Hooks Called:
|