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

[DragonByte Tech]

Originally Posted by Barbecue_Eater

Thanks so far.
Which exact language setting are we talking about here?
I'll probably have to download the english language xml, we only have the German one.

I'm pretty sure there is nothing broken about the files, I remember having the bug before upgrading to the newer version (4.2.1 > 4.2.2).


EDIT:
By setting the language to English (US), the problem is resolved.
How do I fix it with the German language?

It's probably because of the decimal separator.
In the US, you use as a decimal separator - here in middle EU you use


The same applies to the thousand separator: you're using while we're using

But the code needs to be changed in order for the plugin to work properly.

.
.
.
.
-- EDIT 2: Our fix that we use from now:

I fixed it by changing Line 26 of dbtech\vbdonate\includes\functions.php to

$dbt_vbd_pp_amount_options = explode('/', $vbulletin->options['dbtech_vbdonate_don_amount']);

and started separating the amounts by the character "/" in the vBDonate settings and using a comma instead a dot as the decimal character.

This will not work for the english language pack though, therefore I suggest you guys implement an automatic parser that converts the amounts to the correlating decimal systems of the language. There is a vbulletin variable that can read the decimal character, you can use that automatically based on the users language setting.

Regards.

That's an interesting fix to the problem, I was going to post that it might be the issue. I'll see if I can work forward with that idea.

We have found with several things that the language decimals/separators are usually the issue. Changing the settings in the main options seems to work better than using the language separators.

I'll see if I can work a permanent fix in for you.

Matt

[Maniac199]

I know many of you have asked for this so here is a widget I made that will show the username, date, and amount of the last 10 donations. You can feel free to modify, use, and do whatever you want with this code. Make it as a PHP direct execution.

$output = "<table width=\"100%\"><tr><td width=\"40%\">Username:</td><td width=\"35%\">Date:</td><td width=\"25%\">Amount:</td></tr>";
$result=vB::$db->query_read("
SELECT userid, amount, dateline
FROM " . TABLE_PREFIX . "dbtech_vbdonate_donations ORDER BY id DESC LIMIT 10");
$i = 0;
while ($array = vB::$db->fetch_array($result))
{
$thename = vB::$db->query_first("
SELECT username FROM " . TABLE_PREFIX . "user WHERE userid = '$array[userid]'");
$output .= "<tr><td width=\"40%\"><a href=\"/member.php?" . $array[userid] . "\">" . $thename[username] . "</a></td><td width=\"35%\">" . date("m/d/y", $array[dateline]) . "</td><td width=\"25%\">$" . $array[amount] . "</td></tr>";
}
$output .= "</table>";

[Barbecue_Eater]

Though we fixed the comma at the point I told you, the system didn't recognize the money that was contributed.

Just a question in general: About when can we count for the new version?

[DragonByte Tech]

Originally Posted by Barbecue_Eater

Though we fixed the comma at the point I told you, the system didn't recognize the money that was contributed.

Just a question in general: About when can we count for the new version?

What do you mean about it not recognizing? If you can elaborate today I might be able to get the fix out tomorrow. I'm working on it atm in the spare time I get between Classifieds and work.

Matt

[Barbecue_Eater]

I mean: Using the German language pack - no matter what way you donate, it doesn't show up in the added contributions list and also not in the overall contribution amount of the donation bar.
So for example my donation goal is 100€, I can donate any amount I want, it will not come any closer to the goal.
The sandbox mode is not activated.

Also, the custom amount doesn't work with the commas, showing an error which states that the entered amount is not a number if I have a comma in it. There must be some other part of a script responsible for stripping the custom amount as well.

Don't you have a development version of vBulletin anywhere that you can simply drop the language pack on and see yourself?

[DragonByte Tech]

I'm taking a look at this now to see if I can trace a solution. There have always been problems in the way the language packs pass settings of customized numbers back to scripts.

I've an idea on how we can permanently resolve the issue in v2 which will have to wait until then as it will require some of the additions/changes we plan on implementing. In the mean time, if you can, test it by clearing the language settings for your German pack. If that passes the variable correctly, it is the language pack that is definitely causing the issue. If not, then it's something else.

I've got a Spanish pack installed I used for testing the Classifieds money settings on which I'll have a play around with now. How I fixed it for Classifieds requires the changes I mentioned above for vBDonate.

Matt

[DragonByte Tech]

Having looked at this, I think I have a solution. I've tested this as far as I can (On my dev install I can't go beyond the PayPal payment section).

I've created a setting now that let's you choose your separator for the values and the system checks that. My tests show fine. It's my guess that your contributions are going into the 'unconfirmed' section in your tests.

Once I've marked it as confirmed the correct amount is added to the banner.

Let me know if you want to give the code a test as per the PM I sent you and we can see if we've got a fix for you.

Matt

[DragonByte Tech]

Hi everyone,

An update for vBDonate (1.4.7) includes some bug fixes as well as a new setting aimed at improving support for other languages. It had been problematic trying to create values if the language you had on your site used a comma ',' for the decimal point (separator), i.e. 20,00 instead of 20.00. Now it's possible to use the comma as the decimal point and change the separator we use for the amounts available to users to pick from. Before the amounts needed to be listed like 5.00,10.00,15.00. But with the Amount Separator setting you can choose to use another character such as '/' allowing users who need the comma for their decimal point to be able to do so. Several of the fixes also improved the formatting of the currency values for other languages, something we will be continuing to expand as we move towards version 2 of vBDonate.

Lite version is available here, vBDonate DragonByte Tech - vBulletin Mods & Addons or here vBulletin.org. The Pro version is available in your Customer Area if you have purchased a license and it is still valid.

If you like the product you can show your support by nominating it for mod of the month here, vBDonate Donations - Donate Manager - vBulletin.org Forum and also please rate it to help cancel out the users who 1 star our mods.

A full changelog is below:

Bug Fixes And Issue Fixes:
Fixed: Bad image links in the Lite version Admin Dashboard area
Fixed: Number formatting for total amount received on the main donation bar
Fixed: Redirect Error when returning from PayPal
Fixed: Incorrect links in one phrase

Additions To Product From Feature Requests Or Just Something Else Added:
Feature: Setting to allow for changing the the amount separator for values that can be donated to allow for using a comma ',' as a decimal separator for various languages in the language settings

Matt

[kamran_dotnet]

any plan for add new feature to use local vbulletin payment api?
you already done this in db AD

[DragonByte Tech]

We've got a few plans to expand things like that, yes.

Matt