Major Additions - [DBTech] vBDonate Donations - PayPal Donate Manager v1 (vB4)

vBDonate: What is it?
vBDonate is a professional donation mod, allowing administrators accept donations/contributions via PayPal to their sites from the members. It works on vB versions 4.1.x and 4.2.x

Uses

vBDonate is perfect for any forum, both small and big alike. vBDonate is the ideal product to allow administrators accept donations/contributions via PayPal to their sites from the members. This functions similar to other popular donation mods found on vB.org

Mod Of The Month Winner

vBDonate won Mod Of The Month here on vB.org January 2013! Thanks everyone who voted for the mod.

-------------------------------------------------------------------------------------------

If you like this mod please hit the button to the right ---->

Please remember to click the, button to the right if you installed the mod ---->

What does 'Marking As Installed' do ?

* It helps you to stay on top of updates - members who have installed modifications will be notified by us whenever new updates are available.

* For security issues - vbulletin.org will contact all members who have installed a modification whenever a security issue is brought to their attention.

* Marking a modification as installed also helps us know how many people are using our work, giving us extra incentive to provide more features and new modifications.

We appreciate the support!
-------------------------------------------------------------------------------------------

Priority support & Product Demos available at: http://www.dragonbyte-tech.com/
-------------------------------------------------------------------------------------------

Translations may be available @ http://www.dragonbyte-tech.com/forums/91-Translations
Support for translations handled by the translator in its respective threads only.

-------------------------------------------------------------------------------------------
Major Features

Auto Confirming (PRO Only): Donations will auto confirm from PayPal once the donation has actually been processed through PayPal's system Pro Only.

PayPal Testing Environment: Ability to set the donation system to a testing environment via PayPal's SandBox mode.

Marquee Block: A fully customizable marquee block can be placed just about anywhere on your site.

Payment Options: Administrators can set donation amounts to Custom, Suggested, or Suggested and Custom.

Contribution Options: Users can donate anonymously and/or have their donation amounts undisclosed, if set in the ACP.

Interactive Donation List Page: Administrators can confirm, unconfirm, and edit donations from the contribution list page

Donation Goal Bar: A donation goal bar can be placed just about anywhere on your site.

Donator Page: Donators will be able to view a "My Contributions" page which will list only their donations.

Donation Listings Pages: vBDonate admins can view unconfirmed, anonymous and undisclosed donations on separate pages.

Awards System (PRO Only): The Pro version comes with a awards system, to show a award in the postbit of users that donated.

Import Donations (PRO Only): The Pro version comes with a importer to import donations from VSA or AWC donation mods.

vBulletin Versions: Compatible with vB versions 4.1.x and 4.2.x


Complete Feature List

Lite Features

• StyleVars
  • 12+ Stylevars for added flexibility.
• General Settings
  • Toggle plugin on or off.
  • Disable the donation system temporarily.
  • Set usergroup permissions to which groups can act as vBDonate administrators.
  • Change the reason for turning the modification off temporarily. (Shown to a user if the system is disabled)
  • Option to display the product version or not.
  • Select which usergroups can "NOT" use the donation system.
  • Change the message if a user who is in a group not allowed to use the donation system.
  • Change the data format M-D-Y or D-M-Y.
  • Disable showing the contribution menu on the sub-navbar.
  • Disable showing the donate navtab on the navbar. (Only works with vB versions 4.1.x not 4.2)
  • Show the donate navtab on the second navbar if you have vBNavTabs Pro. (Only works with vB versions 4.1.x not 4.2)
  • Enable BB codes in subheader text.
  • Change the text in the subheader.
  • Change the subheader height.
  • Show PayPal image on the donation block (non verified accounts).
  • Change PayPal image on the donation block (non verified accounts).
  • Show Verified PayPal image on the donation block (verified accounts).
  • Change Verified PayPal image on the donation block (verified accounts).
  • Show smaller images on the vBDonate DashBoard.
  • Easily change the General Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the PayPal Payment Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the Donator List Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the Change Usergroups Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the Send PM Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the Donation Bar Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the SideBlock Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the PostBit Settings image shown on the vBDonate DashBoard in the ACP.
  • Show image instead of Submit Button on the donation page.
  • Easily change the image shown on the donation page.
  • Change the marquee block header text.
  • Change the marquee message text.
  • Change the marquee message color.
  • Change the marquee message background.
  • Change the marquee message text size.
  • Change the marquee message scroll speed.
  • Enable start/stop buttons to the marquee that users can click on to start/stop the scrolling.
  • Show the marquee block above the contribution list.
  • Show the marquee block above the contribute block.
  • Show the marquee block above the goal meter.
  • Show the marquee block above the users contribution list.
  • Option to enter the directory of your admincp.
  • Turn off the edit icons next to some block elements.
  • Eet pre-define subjects for users to pick from when using the vBDonate Contact Us form.
  • Show or not show a contributions benefits block on the contribution page.
  • Enter the benefits a contributor will get by contributing to the site.
  • DBTech Affiliate ID support
• PayPal - Payment Settings
  • Set your PayPay E-Mail.
  • Enable PayPal SandBox Testing.
  • Set your PayPay SandBox E-Mail.
  • Choose from three different donation amount types, Suggested Only, Suggested and Custom or Custom Only.
  • Set the suggested donation amounts to your choosing.
  • Choose the currency type you want donated (choose between 22 different types) only one type allowed.
  • Set the minimum amount you will take as a donation, for Custom Donations.
  • Have the PayPal donation screen open in a new window in the browser.
  • Display accepted payment types with their respective images, Visa, MasterCard, Discover, American Express, PayPal.
  • Turn on or off anonymous contributions.
  • Set which usergroups can make anonymous contributions.
  • Turn on or off undisclosed contributions.
  • Set which usergroups can make undisclosed contributions.
• Donator List Settings
  • Change the results per page to show on the donation list.
  • Select which usergroups can see the donation list.
  • Show three different configurations for donation statistics, Don't Show, Total Donations Only or Total Donations and Amount.
  • Show donation amounts of each donor, on the donation list, to usergroups who can view the donation list.
  • Show donations list link on the Quick Links menu, Community menu or both.
  • Change the message shown to a user who is in a group not allowed to see the donation list.
  • Enable / disable a right border on the donation list.
  • Enable / disable a top border on the donation list.
  • Change the default listing of donations between ascending or descending.
  • Show the actual donation id number on the donation list.
  • Ability to turn off the Back To Top button on the donation lists pages.
• Change Usergroup Settings
  • Enable usergroup change upon donating.
  • Set the usergroup to switch the donator to.
  • Add the user to a usergroup (additional usergroups) or change the user to a usergroup (primary usergroup).
  • Change the users display group upon donating.
  • Change the users title, the user title is what is displayed below the user's name like in the postbit.
  • Set what the donators user title will be.
  • Set which usergroups are excluded from usergroup changes.
  • Set which usergroups are excluded from adding to usergroups
• Send PM Settings
  • Enable the PM system.
  • Set which user sends the PM's.
  • Send a PM to a user after donating.
  • Send a PM to a user after the donation is confirmed.
  • Send a PM to a user if you manually added the donation.
  • Send a PM to staff members upon someone donating.
  • Choose which staff members receive the PM's.
• Donation Bar Settings
  • Enable the donation bar.
  • Enter your donation goal amount.
  • Have the goal reset Monthly or Yearly.
  • Show the goal amount on the donation bar or just a percentage.
  • Have a message display below the donation bar.
  • Change the text shown below the donation bar.
  • Set the width of the donation goal block.
  • Center the donation goal block on the page if it is set smaller than 100%.
  • Change the donation bar height.
  • Change the donation bar width.
  • ASet the THIS_SCRIPT locations to display the donation bar on.
  • Choose one of three different locations to display the donation bar on.
  • Change the text position of the text on the donation goal block (center, left).
  • Show a Contribute image instead of Contribute Now text on the donation goal block.
  • Switch the Contribute Now text or Contribute image from above the bar to below the Donate Bar Note Text.
  • Easily change the Contribute image shown on the Donation block.
  • Hide the admin menu found in the donation bar header dropdown.
  • Display a welcome message with the users current time and date below the goal meter.
  • Display accepted payment types with their respective images, Visa, MasterCard, Discover, American Express, PayPal.
  • Ability to show everything in the goal block one background color.
  • Ability to show the total contributions to the site above the goal meter.
  • Ability to show a countdown timer to goal above the goal meter.
  • Set the date for the countdown timer.
• Side Block Settings
  • Turn Forum sideblocks on or off.
  • Select which usergroups see the sideblocks.
  • Option to fix broken display issues with sideblocks that some skins seem to have, so far it's only BP skins.
  • Show PayPal verified image or non PayPal verified image in Forum sideBlock.
  • Easily change the verified PayPal image shown on the Forum sideBlock.
  • Easily change the non verified PayPal image shown on the Forum sideBlock.
  • Show a goal meter on the sideblocks.
  • Change the currency display on the sideblock to a symbol in front of the amount.
  • Easily change what symbol shown in front of the amount donated on the sideblock.
  • Set the character limit for usernames in the sideblocks.
  • Display accepted payment types with their respective images, Visa, MasterCard, Discover, American Express, PayPal.
  • Remove the radius on the goal meter for the contributed amount on the sideblock.
  • Replace the Contribute Now text with a image on the sideblock.
  • Easily change the contribute now image shown on the Forum sideBlock.
  • Ability to show a countdown timer to goal below the goal meter on the forum sideblocks.
• Postbit Settings
  • Show a donate block in the postbit.
  • Easily change the image in the postbit block.
  • Show the postbit block on the first post only.
  • Eight different locations to choose from in the postbit to display the block.
  • Set which usergroups see the donate postbit block.
  • Easily change the postbit header title.
  • Easily change the postbit message.
  • Easily change the text to display it showing the postbit info in the control area of the postbit.
  • Easily change the width of the donate block if it is shown in the signature area of the postbit.
  • Ability to toggle on / off the updating of user ranks after a contributors contributions is confirmed (only works if you add or change the contributors usergroups).
  • Ability set the path to your contributor group rank.

Pro Additional Features

• StyleVars
  • 5+ additional Stylevars to customize the banner.
• General Settings
  • Show a Additional block about Verified accounts.
  • Change text shown on the Verified block header.
  • Easily change the verified image shown on the Verified block header.
  • Change text shown on the Verified block sub-header.
  • Easily change the Change Rotating Banner Settings image shown on the vBDonate DashBoard in the ACP.
  • Easily change the Sliding Banner Settings image shown on the vBDonate DashBoard in the ACP.
• PayPal - Payment Settings
  • Have a image show on the PayPal payment screen.
  • Easily change the image show on the PayPal donation screen.
• Donator List Settings
  • Ability to show contributions as net amount (the amount you got after PayPal fees) or gross amount (the amount the user actually sent through PayPal), this will show everywhere the contribution amounts are shown now.
• SideBlock Settings
  • Turn off jquery on the vBadvanced donation module if it causes issues with other mods already running jquery on the vBAdv page.
  • Eet which version of jquery you would like to run if you have it enabled on the vBadvanced donate module.
  • Show a countdown timer to goal below the goal meter on the vBAdvanced Module.
• Postbit Settings
  • Show the donate postbit info on different usergroups postbit, so you can select it to only show on Admin postbit, or any usergroups you have.
  • Show the donate postbit info on one specific user.
  • Enable or disable awards from showing in the postbit of users who contributed.
  • Set the image to display in the users postbit if they contributed.
  • Turn off automatic deployment of the award in the postbit, so you can add it anywhere via a template edit.
  • Center the award in the postbit.
  • Ability to show a users contribution stats.
  • Select where in the postbit to display the users contribution stats.
• Send PM Settings
  • Send a pm to staff, if a contribution has been auto confirmed.
• Rotating Banner Settings
  • Show rotating banner, image changes every time the page is refreshed.
  • Change the default banner size for fixed skins and smaller screen resolutions.
  • Set the THIS_SCRIPT locations to display the rotating banner on.
  • Choose one of three different locations to display the rotating banner on.
  • Choose which usergroups can not view the rotating banners.
  • Have a new page open in the browser if a user clicks on the banner, which redirects them to the donate page.
  • Change the text shown when a user hovers over the banner.
  • Show a sliding banner, image will change via javascript, on a determined amount of time.
  • Have jQuery load or not, as to not cause conflicts with other mods.
  • Set the jQuery Version.
  • Set the sliding banner display time, how long you want the image to show before another one is loaded.
• Slider Banners
  • Change if the image shows on the CMS page from the main content page.
  • Change if the image shows on the Forum pages from the main content page.
  • Toggle each images active status from the main content page.
  • Click on edit to change each existing image.
  • Delete each image from the main content page.
  • Set the each banners title on the create content page.
  • Add each banners url on the create content page.
  • Have the image show on the CMS page on the create content page.
  • Have the image show on the Forum page on the create content page.
  • Set the image active on the create content page.
• Auto Post Settings
  • Enable/disable the thread/post system.
  • Choose to post as a new thread or a reply to a post.
  • Option to enter the ID of the person making the post.
  • Thread/post to count towards the posters postcount or not.
  • Select which forum the new thread should be posted in.
  • Set the thread id if you choose to post as a reply to a post.
  • Set the post id if you choose to post as a reply to a post.
  • Set the thread as open or closed if you choose to post as a new thread.
  • Enter which post icons to use.
  • Set as sticky if you choose to post as a new thread.
  • Ten different options to enter the thread/post title for the system to randomly use.
  • Ten different options to enter the thread/post content for the system to use.
• Importer
  • Import donations from VSA donation system.
  • Import donations from AWC donation system.
• Awards Utility
  • Recalculate all users awards based upon them having a confirmed contribution.
  • Reset user awards, so no users have them.
• Download Contributions CSV File
  • Ability to download confirmed contributions as a CSV file.
  • Ability to download unconfirmed contributions as a CSV file.
  • Ability to download anonymous contributions as a CSV file.
  • Ability to download undisclosed contributions as a CSV file.
  • Ability to download test contributions as a CSV file.

-------------------------------------------------------------------------------------------
This mod displays a copyright notification in the footer of all pages which includes:

• 1 Link to DragonByte Technologies homepage
• 1 Link to Product Description page of this modification

[wildheart]

Sorry but I am going to ask again to be sure. According to the read me file Upgrading:
Upload all files from the "upload" folder to your forums directory.

2. Import the product-dbtech_vbdonate.xml file from the "XML" folder at AdminCP -> Plugins & Products -> Manage Products -> Add/Import Product

Wont that replace all the donations already done?

[sonic83]

Greetings. vbDonate works with "vBExperience" or not recognized for delivering awards and achievements?

thanks

[DragonByte Tech]

Originally Posted by wildheart

Sorry but I am going to ask again to be sure. According to the read me file Upgrading:
Upload all files from the "upload" folder to your forums directory.

2. Import the product-dbtech_vbdonate.xml file from the "XML" folder at AdminCP -> Plugins & Products -> Manage Products -> Add/Import Product

Wont that replace all the donations already done?

No that will not replace the contributions already in place, you are simply overwriting the templates and settings that are already there, not removing anything from the database.

Chris

[DragonByte Tech]

Originally Posted by VBLUIS

Greetings. vbDonate works with "vBExperience" or not recognized for delivering awards and achievements?

thanks

No it is not integrated with vBExperience.

Chris

[wildheart]

I received an e-mail from Paypal that says:

Hello .....

Please check your server that handles PayPal Instant Payment Notifications (IPN). IPNs sent to the following URL(s) are failing:

http://reptile-parrots.com/forums/vbdonate_gateway.php

If you do not recognize this URL, you may be using a service provider that is using IPN on your behalf. Please contact your service provider with the above information. If this problem continues, IPNs may be disabled for your account.

Thank you for your prompt attention to this issue.

Is this a concern and how can I fix it?

[DragonByte Tech]

Can you check the following three items?

1. Check your Paypal IPN History page (in your Paypal account) and make sure that IPNs are not currently disabled. Note that disabled is different than turned off (more on that later). To see if IPNs are disabled, check your IPN history (My Account => History => IPN History), do a search for recent IPNs, and see if your recent IPN messages have a delivery status of "disabled" (Look for Delivery status Disabled). If they are disabled, then contact Paypal to get them re-enabled. Until you do this no IPNs will work.
2. Check your Paypal IPN settings and make sure IPNs are turned off (not disabled) for your account. To check this, visit your IPN History page (My Account => History => IPN History); it should say: "The IPN feature is turned off. You must turn on IPN in order to create history data." If instead of that message, it shows a field with your Notification URL, then you need to turn the feature off. This needs to be off because (a) it is not necessary, since vBDonate sends Paypal the correct URL to send the IPN to along with the payment request.* (This is the notify_url parameter in the vbdonate_gateway.php file). (b) If you have your vBulletin URL there, then Paypal will send IPN messages for all of your Paypal transactions, not only the ones that originate from your vBDonate installation. This will eventually cause Paypal to disable (see point #1) IPN for your account due to the failed IPNs.
3. Make sure your Forum URL is correct in your vBulletin settings. (vBulletin Options => Site Name / URL / Contact Details => Forum URL) It should be the URL to your forums, with no trailing slash (/). The notify_url parameter is generated using this setting.

* Paypal will send the IPN message even when the IPN feature is turned off in your Paypal account [reference]

The IPN message will always be sent to your notification URL unless receiving IPNs have been disabled. Even though you have not enabled receiving IPN messages in your Profile or you have reset your preference by turning off IPN messages, PayPal still sends IPN messages to the notification URL you specify for a specific payment.

The difference between "turned off" and "disabled" is confusing. I'll try to clarify:

Turned off -- This is if you choose to turn off the IPN feature in the Paypal interface.
Disabled -- This is an automatic Paypal sanction that is applied to accounts that have too many failed IPN messages. (has nothing to do with you turning the IPN feature on or off)

Chris

[wildheart]

On my Paypal account under the History tab I only have: Basic Search and Download History.
When I click on History it brings up all the transactions. On that page I have 2 more drop down tabs, Select that brings up dates and More Filters and there is nothing about IPN.

Checked my forum Url and it does not have a \ : http://reptile-parrots.com/forums

I followed your link to paypal and read through their instructions and my Paypal looks completely different from what they have. I do not have a Selling Preferences column and therefore do not have Instant Payment Notification Preferences. The bar that they show on that page is also completely different from the one on my Paypal.

[Nelson58]

The Donation mod has a bug in it. It is supposed to move any regular or contributing member to the participating member group (more access). It is supposed to EXCLUDE moderators, supermoderators and administrators. The setting to do just that is below. It put my moderators and supermoderators in the participating class after they donated, so it is NOT working right.

Select which usergroups are excluded from the
change group option.
Selected groups will not have their usergroup changed upon auto confirming
or manual confirming of contributions. Administrators
Banned Users
Contributing Users
Inactive Banned Users
Moderators
Participating Users
Registered Users
Super Moderators
Unregistered / Not Logged In
Users Awaiting Email Confirmation
Users Awaiting Moderation

The moderators, super moderators and admins are checked in this setting.
Can you give me some idea how to fix this?

Thank you!

[DragonByte Tech]

Yeah that is pretty much there for the auto confirming of donations in the pro version, if you are manually confirming donations choose the option, Mark confirmed but don't change usergroup for users you don't want to change groups.

I will see about adding the check though to the next version.

Chris

[DragonByte Tech]

wildheart I think I know what I need to do just waiting for verification so stand by.

Chris