Miscellaneous Hacks - Cyb - PayPal Donate

FEATURE UPDATES WILL BE RELEASED HERE:
https://vborg.vbsupport.ru/showthread.php?t=177563

===========

Info:
Advanced PayPal Donate system for vBulletin.


Features:
-Allow users to donate suggested or custom amounts, or both
-Set minimum amount accepted
-Set currency
-Block usergroups from using Donate system
-Donations list
-Subscriptions (for Business/Premier PayPal Accounts)
-Donation Bar
-Mark donations as confirmed/unconfirmed
-Delete donations
-Move or add confirmed donators to your VIP/Donator usergroup
-Donate statistics (total donations, total amount, numbers of confirmed/unconfirmed donations)
-Block usergroups from viewing Donations or statistics details
-Add donations manually
-Edit donations
-PM reports

See screenshots for more details...


Installation:
1. Import XML file (as product): AdminCP > Plugin System > Manage Products > [Add/Import Product]

2. OPTIONAL (for some customized styles)
Open template "navbar" and add "$cyb_paypal_donate_link" after "vbphrase[user_cp]</a></td>" surrounded by proper TD tags
3. OPTIONAL (for some customized styles)
Open template "navbar" and add "$cybpaypal_donlist_link" after "vbphrase[miscellaneous]</td></tr>" surrounded by proper TD/TR tags
4. OPTIONAL (to put DonBar to desired page)
a) set THIS_SCRIPT option in hack settings
b) Open desired template and put "$cybpaypal_donbar" where you wish to have Donation Bar shown


To set options:
Go to your AdminCP > vBulletin Options > Cyb - PayPal Donate


Versions:
v1.0 - Oct 13. 2005.
- First Release
v1.5 - Nov 28. 2005.
- Added 5th donate option
- Added option to donate custom ammount (as 6th option - can be enabled/disabled in AdminCP)
v2.0 - Apr 20. 2006.
- All known bugs fixed
- Layout and functionality improved
- Some options and settings added (check updated screenshots)
v2.1 - Apr 22. 2006.
- Typo fixed ("bellow" > "below")
- Fixed little error on donations page
- Added option to turn system on or off
- Predefined error message is displayed to users when system is disabled
- Templates now goes to "Cybernetec" group in Style Manager
v2.2 - Jun 03. 2006.
- Uncached template bug fixed
v2.5 - Jul 30. 2006.
- No more file uploads
- Donate options are now opened below navbar when "Donate" link is clicked
- Two plugins removed
- Codes improved
v2.6 - Jul 30. 2006.
- Now "Donate" box can be opened from any page
Link is shown always, not only on forumhome like in v2.5.
v2.7 - Jul 30. 2006.
- Fixed bug with donate form (conflict with several vB forms)
v2.8 - Aug 04. 2006.
- Release of this hack for vB v3.6
v2.9 - Aug 06. 2006.
- Added option to Show/Hide navbar link
- Now you can link to donate system from thread or portal or another site,... (index.php?do=donate)
v3.0 - Aug 25. 2006.
- If your forum's index.php file was renamed, for any reason, now you can enter new filename in ACP hack options to have this hack working properly
- Added "Product Version Checking" - https://vborg.vbsupport.ru/showthread.php?t=124679
v3.1 - Mar 03. 2007.
-New: Usergroup-based permissions (set who can use donate system)
-Fix: Guests now can see Donate link in NavBar (if usergroup 1 is not blocked in above function)
-New: Added Subscriptions (durations adjusted in ACP, can be disabled)
-New: Changed from "index.php?do=donate" to "misc.php?do=donate" (Update your custom links!))
-New: Unlimited number of donate options (list amounts in one line, separate with commas)
-Few other functionality and make-up changes...
v3.2 - Mar 04. 2007.
-New: Added text field to enter custom values when Custom is chosen in menu. Otherwise this field is hidden.
-New: Set minimum amount accepted
-New: Unit of time for "Subscriptions time periods" changeable (d, w, m, y)
-New: BB Codes enabled for "Donate Box Note" (smilies, easy text formatting etc...)
-New: Currencies switcher in ACP (easier way to choose your currency)
-Fix: Using "1" in "Subscriptions time periods" disabled (you can not subscribe for 1x and this will give you error at PayPal)
-Few code changes for better compatibility with different server/board configurations
v3.3 - Mar 07. 2007.
-Fixed NavBar link
v3.4 - Mar 14. 2007.
-Fixed bug (if Subscriptions disabled donate amount info not sent properly)
-Improved compatibility with Right to Left direction styles
v3.5 - Apr 28. 2007.
-New: Donator list
-Options to choose which usergroups can see the list of Donators
-List updated automatically on new donations but new item is visible to administrators only
-Admin can mark donation as confirmed, unconfirmed, or delete it
-Admin can manually add Donators to list
-"Display Options" allows you to sort donators by username, donation date, or donation amount, and choose sort order
-Javascript code on Donate page improved
v3.6 - Jun 02. 2007.
-Total/unconfirmed donations info
-Edit donation
-Quick confirm/delete donation
-Option to change background color for unconfirmed donations
-Changeable values are underlined for administrators
-To change any value just type over it and hit Update
v3.7 - Jun 03. 2007.
-Fixed Unconfirmed counter
-Fixed text color in dark styles
v3.8 - Jun 04. 2007.
-Added option to sort donations by confirmation status
-IP address shown instead of username for unknown donators (viewable to admins only)
-Admin have option to resolve unknown donator IP address into hostname
-Added "Donate Statistics" block into drop-down menu
-Added confirmed donations count
-Added total amount info
-Added option to choose which stats users can view (admins can view all)
v3.9 - Jun 10. 2007.
-Fixed tab indexes in "add new donator"
-Fixed listing for users with unknown both username and ip
-Added options to confirm/unconfirm/delete multiple items
-Group membership checking works now for supplementary usergroups too, not only primary one
-Currency list updated to support all currencies currently accepted by PayPal
-Added option to disable suggested amounts and use just input field instead of drop-down menu
v3.9.1 - Jul 23. 2007.
-Fixed security exploits
v4.0 - Aug 9. 2007.
-New: Option to move donator to your Donator/VIP usergroup
-New: Added page navigation to donation list page
-New: Option to disallow non-administrators to view amounts on donation list page
v4.1 - Aug 21. 2007.
-New: PM Reports (any of these can be enabled/disabled):
*Send PM to user after donating
*Send PM to user when donation is confirmed
*Send PM to user when donation is confirmed (manually added donations)
*Send PM notices to Staff when someone uses Donate system
v4.2 - Sep 30. 2007.
-New: Confirmation dialogs before performing actions on Donations page
-New: After completing the payment at PayPal.com user is redirected to your "Thank you" page (message = phrase [cybpaypal_thanks])
-New: Choose if you wish to move or add confirmed donator to your VIP/Donator usergroup
-New: Option to choose to load PayPal login/donate form in current or new browser window/tab
-New: Sort donations by usergroupid
-Subscription options removed (I will not support this anymore so please keep old version if you really need subscriptions)
-General cleanup, known bugs fixes, optimization...
--Save content of "Donate Page - Note" setting field before upgrade (you'll need it to update [cybpaypal_note] phrase later)
v4.3 - Oct 18. 2007.
-Fixed bug with permissions (now admin's primary usergroup must not be 6 to be able to confirm/unconfirm/delete donations)
-Added option to disable BB codes in Donate Note (when BB is disabled then you can use HTML)
-Some minor bug fixes
v4.4 - Dec 10. 2007.
-New: Switch date format (d-m-y or m-d-y)
-New: Add your site logo to PayPal login/donate page
-New: Donation bar
-Fixed problem where some users get a shipping charge
v4.5 - Apr 30. 2008.
-CSRF protection added
-Compatible with vBulletin 3.7 Gold (may not work with Beta/RC releases)
-Minor bugs fixed
v4.6 - Jul 25. 2008.
-Fixed bug (sorting wrong on donation list when switched to next page)
-Fixed bug (unconfirmed/confirmed info disappears on donation list when switched to next page)
-Fixed bug (wrong # values shown to non-admins on the first page of donation list)
-Fixed bug ('Donate Now' in Donation Bar not hidden when already on Donate page)
-New: option to change "Donate" navbar link color, or set it to style default
-New: amounts must not be 5,10,200 anymore, but also can be 5.5,10.5 etc...
-New: Subscriptions (I added this again, but much better implemented this time)
-Many other bug fixes/improvements
v4.7 - Jul 27. 2008.
-Fixed bug ("Minimum amount allowed..." message appears unexpectedly)
-New: Option to set which day in month Donation Bar resets
-Some minor bugs fixed


If you like this hack please click INSTALL.

[mfyvie]

Originally Posted by Peter_Rosado

I'm having a problem, when adding a donator manually the date doesn't update. Example: i put 19 - 06 - 07 and look: http://www.mundopoesia.com/foros/misc.php?do=donlist

Only admins and groups you configure can see the donate list. Pasting a link here and asking us to look makes no sense at all. Use a screenshot instead.

[Dannyloski]

Awesome hack, downloaded and will install tomorrow ...

I would love to see the feature that XtAzY requeseted in the next release, that would be great.

Another "feature" to think about would be for a user to receive an image next to their username in the postbit template once they make a donation and are added to the donator's list page. What Im talking about is something similar to what v3 Arcade has when a user is wins a Championship on a game, they get a trophy added next to their name. Then when you click on their username and the drop-down list comes up you see at the bottom a "Username's Arcade Awards" section, well for this Hack maybe it could be "Username's Donation History" and show their donation info (Date and Amount). Just a thought I think would be a cool to have for this Donation Hack.

EDIT: I added an attachment so that you guys can see what I meant with all that I wrote above ...

[H1MendlessDark]

This is a great hack. Great Job! I was just wondering if there is a way to make multiple donations menus. Maybe like [/misc.php?do=donate][/misc.php?do=donate2] and have more than just one donations page. If that is possible, I would put a different price for each page, as it is what I want to do with my site. Thanks. It would be great if I could add multiple menus.

[mfyvie]

Originally Posted by H1MendlessDark

This is a great hack. Great Job! I was just wondering if there is a way to make multiple donations menus. Maybe like [/misc.php?do=donate][/misc.php?do=donate2] and have more than just one donations page. If that is possible, I would put a different price for each page, as it is what I want to do with my site. Thanks. It would be great if I could add multiple menus.

You'll need to edit the plugin called "Cyb - PayPal Donate - Ext"

Look for the first line which looks like this:

if (($_REQUEST['do'] == 'donate') AND $vbulletin->options['cybpaypal_enable'] AND !is_member_of($vbulletin->userinfo, split(',', $vbulletin->options['cybpaypal_cantuse'])))

Follow it all the way to the end, which is just ABOVE this line:

if (($_REQUEST['do'] == 'donlist') AND $vbulletin->options['cybpaypal_enable'] AND !is_member_of($vbulletin->userinfo, split(',', $vbulletin->options['cybpaypal_cantuse'])) AND is_member_of($vbulletin->userinfo, split(',', $vbulletin->options['cybpaypal_canseelist'])))

Now copy and paste that entire block, but change the request value from donate to donate2. Then, within your copied block, find the line:

$navbits = construct_navbits(array('' => $vbphrase['cybpaypal']));

Change the name of the phrase to cybpaypal2, and insert a new phrase via the phrase manager identical to the first, but with the contents changed.

If you follow all those steps correctly, you should get what you want. If you are using fixed suggested amounts for both pages, you won't get what you wanted, I'd suggest using only an amount that the user enters themselves.

[Mrdby]

i haven't updated yet..so what are the main problems using 3.6.7?

[Dannyloski]

^ Absolutely nothing, works perfectly for me in vB 3.6.7 PL1 ...

[mfyvie]

Originally Posted by Mrdby

i haven't updated yet..so what are the main problems using 3.6.7?

Is it just me, or does it actually say 3.6.7 as the version this runs on? Did you also think about looking back through this thread if you wanted to see if there were any issues?

[H1MendlessDark]

Thanks mfyvie! And yes I was going to use fixed suggested amounts for each different donate page. I wanted a different fixed amount for each page so people have to pay that certain amount... Is there any way possible to do that?

[DJLy5y]

Originally Posted by Peter_Rosado

That would be a GREAT feature.

Great idea !

[jheigl]

Didn't read through the 23 pages, but if it hasn't been reported, I noticed that in the subscription- Time Periods box, when you put 2,3,4,5,6,7,8,9,10,11,12 and then save it, go to the donate link, the choices for subscriptions it gives you is 2,3,4,5,6,7,8,9,10,11,112....it says 112 instead of 12.