[ABD] Advanced PayPal Donation MOD 1.0.B4

[Highway of Life]

Modification name: Advanced PayPal Donation MOD

Author: Highway of Life

Modification description: - Adds a page to your site that allows you to accept PayPal Donations in multiple currencies and add donators to a supporters group automatically.
This MOD integrates with your existing PayPal account and automatically verifies transactions and notifies the administrator upon successful donation.

Note:
Version 1.0.B4 has been released to the public as an update to version 1.0.B3 that was tested by the STG Supporters (the Private Beta Group). This release includes bug fixes discovered in Beta3. The next release (Beta5) will be released to the Private Beta Group once again, with all new features. If you would like to participate in the Private Beta Group (requires donation), please contact me for more information.

No support will be provided for Public Beta4. The Private Beta Group still receives full support for all versions.

Modification version: 1.0.B4

Tested on phpBB version:

• 3.0.0
• 3.0.1
• 3.0.2
• 3.0.3-dev

Supported Languages: (Credits)

• English by Highway of Life

Supported Databases:

• MySQL (all versions)
• MySQLi
• MSSQL
• MSSQL ODBC
• Firebird
• PostgreSQL
• SQLite
• Oracle

Styles supported:

• prosilver
• subsilver2 -- Will be available for STG Supporters (Private Beta Testers)

MOD Format:


Requirements:

• PHP 5.0 or above -- this MOD will NOT run on PHP4

Features:
- Daily currency rate conversions.
- Allows users to donate in the currency of their choice
- User is automatically added to supporters group upon successful donation
- Allows admin to set a minimum donation amount to be added to supporters group
- Test your account setup using the PayPal sandbox
- 18 Currencies supported
- 189 Countries listed
- Integration with PayPal and PayPal Sandbox
- Manual and Automatic transaction verification
- Admin may choose to receive e-mails or private messages upon completed donation
- Transaction logging
- Automatic MOD installation
- ACP Control Panel to control config values
- Wrapper for servers without cURL compiled.
- Full Debugging and Logging control

Known Limitations:
- Unable to define benefits (coming in Beta5)
- subsilver2 styles not yet supported (coming in Beta5)
- In some cases, alternate currencies if donated the minimum amount, won’t automatically add the user to the special group. If the user donated above the minimum in the alternate currency, this is not an issue.

Planned Features:
- Admin definable donation benefits and rewards
- Site donation Goals status and progress
- Site supporters list for users and separately for admins.
- Quick Register: Allows the user to fill out registration (if not registered) while donating.
- Login box to allow users to easily login
- Donation reports
- Integration with Handyman's Cash MOD
- Admin selectable amount of cash points added to user account based on amount donated.
- Option to allow "anonymous donations"
- and more...

Support Topics:

• STG Support Topic

Development Topics: (No Support)

• STG Development Topic
• phpBB.com Development Topic
• phpBBModders Development Topic

Screenshots:
-- N/A --

Demo:
prosilver demo

Download file:
http://startrekguide.com/community/down ... hp?id=4893
Download topic:
http://startrekguide.com/community/view ... 127&t=8230

Installation:





--------

FAQ
----
Q. Getting this error:

Code: Select all

[phpBB Debug] PHP Notice: in file /donate/index.php on line 113: Undefined variable: source

A. Replace:

Code: Select all

$donate->display($source);  

with:

Code: Select all

$donate->display();  

----
Q. Multiple PM problem.
A. In the functions_paypal.php file:
FIND:

Code: Select all

'payment_gross'        => $this->data['mc_gross'],
            'payment_fee'        => $this->data['payment_fee'], 

REPLACE, WITH:

Code: Select all

'payment_gross'        => (float) $this->data['mc_gross'],
            'payment_fee'        => (float) $this->data['mc_fee'], 

FIND:

Code: Select all

'payment_gross'        => '',
            'payment_fee'        => 0, 

REPLACE, WITH:

Code: Select all

'mc_gross'            => 0.00,
            'mc_fee'            => 0.00, 

See the following posts for details on the error: 1, 2, 3
----
Q. There is an error when attempting to access the sandbox, or when using Google Chrome to donate. Submit brings you to the PayPal home page instead of the correct page.
A. The PayPal URL is set to port 80 (http), but PayPal redirects to port 443 (https), but for some reason, Google Chrome does not handle that correctly.
in functions_paypal.php
FIND:

Code: Select all

$this->u_paypal = ($config['paypal_sandbox'] || PAYPAL_DEBUG) ? 'http://www.sandbox.paypal.com/cgi-bin/webscr' : 'http://www.paypal.com/cgi-bin/webscr'; 

REPLACE, WITH:

Code: Select all

$this->u_paypal = ($config['paypal_sandbox'] || PAYPAL_DEBUG) ? 'https://www.sandbox.paypal.com/cgi-bin/webscr' : 'https://www.paypal.com/cgi-bin/webscr'; 

----

[expx]

sounds very nice..
I've got 2 requests though:

1. can you make it so there is an option to display a list of the donators on index.php and the amount they donated... eg username1 ($xx) , username2 ($x) etc
2. can you make it compatible with handymans cash mod.. where the donor gets x points/cash per every $1 donated?

[MagicMike304]

Looking go so far. The only suggestions I would have is to have a time limit on being in the user group, like 1 year, 2 year, 6 months, etc. And also have a option to set up more then one fix amount donations.


Thanks,
Mike

[Highway of Life]

1. can you make it so there is an option to display a list of the donators on index.php and the amount they donated... eg username1 ($xx) , username2 ($x) etc

IMO this is more private information, but I added the option for the user to hide the details from the public lists... so hopefully that will help.

2. can you make it compatible with handymans cash mod.. where the donor gets x points/cash per every $1 donated?

Oh yes, thanks! -- I forgot about that.
-- Added

I would have is to have a time limit on being in the user group, like 1 year, 2 year, 6 months, etc.

Hmm... that seems like it would be better as an extended group management MOD rather than a PayPal donation integration MOD.
However, the list on the ACP page will show the date the users were added to x-groups, so from that list, you can manage user and remove them from those groups when the admin wishes. -- I don’t want to get too complicated with the features here, so I don’t think it would be a good idea for me to add that. -- If I get a lot of feature requests for this, I’ll reconsider adding it.

And also have a option to set up more then one fix amount donations.

What do you mean?
-- Like right now the user can enter in any donation amount they choose, but you would want a drop down menu to select, for example: $5, $15, $25, etc?
-- If I added this kind of ability, it would make it extremely difficult to work with the multiple currencies, because currencies around the world vary so much in value.

[expx]

ok cool, btw will this be like the phpbb2 donation mod, where it uses paypal IPN and the php function fsockopen to receive IPN?

[Highway of Life]

I don’t know anything about the phpBB2 MOD...

Do you think it would be worth it to incorporate that functionality?

[MasterZ]

Using the paypal IPN is definatly a plus, because that's the only way for your script to verify that the user actually donated the money.

Otherwise they could enter $100 for the donation, submit it, then cancel in the paypal screen and your script would probably never know it. IPN will notify your script of success and failed payments so you can do with the user what you like after receiving conformation.

[Highway of Life]

Okay, I’ll look into using IPN integration with this MOD.
My PayPal Donation MOD does not do anything with the user until successful completion of the transaction anyways, the user can cancel all you want, but no credit will be given to the user unless the transaction has actually been completed. But I suppose the IPN could be a good "double check".

[MasterZ]

Just wondering how you verify that the transaction is completed then?

Also, I can't wait until this mod is finished Looking forward to putting it on one, if not both of my forums.

[Highway of Life]

There are two ways I verify the transaction has completed.

First, the completion (final) page of the transaction has a special URL, and it detects certain details about the referring URL to make the completed actions.
If for some reason, the referring URLs are turned off (i.e. the user is on a Proxy) it won’t automatically insert the user into the selected group, but instead set them to pending and notify the administrator of this action. -- they can then verify with the PayPal email and/or receipt that the user has indeed donated, and manually approve the user to the group.

[MasterZ]

is it possible to fake this process? i.e. go to that URL so the forum thinks you paid?

[Highway of Life]

Lets put it this way... a hacker would be able to do it.
I can make it very difficult, but it would still be possible.

But even if someone did fake it, the administrator would still receive the PM, and would be able to take action if he felt there was some kind of forgery involved.

[chadtm80]

Very nice Mod.. Any ideas on a release date?

[MasterZ]

There are always ways around things, just wanted to make sure it wasn't easy to get around

[marcushouse]

oooh. i want this.
When can we get a alpha / beta or whatever.
You will get lots of feedback once we can play with it.