Add-On Releases - Donation Progress Bar-Forumhome

What Donations Bar Is:
It is a simple way for Admins to show a donation progress bar on their forum home page with Admin set goals and donations recieved. Because the donation bar is a stand alone it can be utilized with any donation system your using. It adds more visability of your site donation goal requirements and donation button to your members for hopefully more through put in donations.

Can Be Used With:

• Any paypal/donate system.
• PayPal Easy Donate - vB 3.6
  
• Cyb Paypal donate
  Will auto update donor bar now, but must be set in donation bar options.
• Vb Subscriptions (Can be used as manual or auto updating)

This script adds:

1. 3 Plugins
2. 1 Template

Installation:

1. Import the product-donationbar.xml through admin cp
2. If you use Cyb-Paypal mod you must select it in vboptions->Donation Bar->Cyb-paypal set to yes.
3. If you use Vb subrcriptions you must select it in vboptions

Post Installation:
Make sure when entering the form code for your Paypal button the links are formated as follows:

<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
 <input type="hidden" name="business"
      value="sample@sample.com">
                             <input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-butcc-donate.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!"></form>

If your using this mod in 3.6.10 or higher and your sending people directly to paypal instead of your donation page from the button you need to add the below or you will recieve the security token error on clicking the button

<input type="hidden" name="securitytoken" value="$bbuserinfo[securitytoken]" />

If you do not use this format for the links your button will not show. Please do not copy and past my info above you must fo to your Paypal account and create a button with your account code and email info.
If you wish instead of a paypal button link you can put the URL to your donation page.

Update Version:

• 1.00 First Realease
• 1.01 updated template to be more in line with default vbulletin style.
• 1.02 Added donation bar color to change to green when 100% or greater donations met.
  Also added version check.
• 1.03 Fixed the color of the bar to not show small piece of red bar on left. Edited donorbar
  template to fix broken donor bar box.
• 1.04 Added Cyb-paypal intergration in admincp donation bar options. Thanks goes to AWJUNKIES for the adddition.
• 1.0.5 Fixed XHTML missing tag. Added ability to enter vbsubscription amount through Admincp. Bar will display only 100% now and once reached will post a thank you below donor button if you have a thank you message set. Fixed the donorbar template to be in the template group and not part of vbulletin so updating updates the template.
• 1.0.6 Added Auto updating of the donor bar for Vb paid subscriptions
• 1.0.7 Added option for auto insert of the donation bar under navbar, you can now float the donation bar if you are using chatbox, option for selection of usergroups able to see donor bar, You have option to enter which page to display donation bar on or show on all pages. General code clean-up.
• 1.0.8 Fixed issue with template not being cached. Added ability to change currency symbol from admincp.
• 1.1.0 Added setting in admincp for setting goal period

Upgrading Instructions:

When upgrading to Version 1.0.7 please make sure you remove the
FORUMHOME template edit as its no longer required. Failure to do so will produce two donor bars on forum index page.

IMPORTANT: If updating from an earlier version than 1.0.5 you must uninstall the earlier version and delete the old donorbar template before importing the new XML file.

Go to your Admincp->Plugin&Products->Manage products->Add/Import Product make sure you select overwrite.

Please report any and all bugs within this thread with as much detail as possible.

Click Mark as Installed for support and so that you will be notified instantly upon any major updates.

CMPS Add On:
CMPS Donation Bar Add on

Thanks to AWJUNKIES for adding the integration of Cyb-paypal to the donor bar mod.

[yaoren]

I haven't had a donation since I added it... Yet, but I know once you receive notification that you received XX amount, you can add that XX amount in via the control panel.

Hope that helps a little

[RaceJunkie]

Originally Posted by yaoren

I haven't had a donation since I added it... Yet, but I know once you receive notification that you received XX amount, you can add that XX amount in via the control panel.

Hope that helps a little

Thanks after further review I believe the same thing.

[yaoren]

Now... if you want to come to my site and donate $1, i'll be able to find out if it updates automatically or not.

**Update**

Donations do not move the progress bar, you have to manually enter the amount via admincp
Just remember to put the "Total" amount you have received and not just the "last donation" you received.

[VHLinks]

Originally Posted by mrahul

Do u use any other hack to receive paypal donations ? & is tweaking needed just as u made it to get it below & etc.. or just to get it work u had to tweak ?

I use Bill's PayPal hack, but that really doesn't interface at all with the bar. The bar's stats are all manually entered in via the control panel. So when someone donates, I still have to put in the amounts.

The only tweaks I made were just using the parts of the HTML code I needed and putting them in the forumhome template where I wanted them. So yeah it's fairly simple if you know how to edit those templates, which I know most people here do.

[sinisterpain]

Originally Posted by VHLinks

I use Bill's PayPal hack, but that really doesn't interface at all with the bar. The bar's stats are all manually entered in via the control panel. So when someone donates, I still have to put in the amounts.

The only tweaks I made were just using the parts of the HTML code I needed and putting them in the forumhome template where I wanted them. So yeah it's fairly simple if you know how to edit those templates, which I know most people here do.

It was not meant to directly interface with them if it did it would specific to that hack only and I would have to release a different bar for each one. Which is why I made it manual so it could be used with any donation mod. And please click install if you like the mod.

[yaoren]

Any way I can turn off the $ amount received and just have the % towards our goal showing?

[radarhunter]

Originally Posted by yaoren

Any way I can turn off the $ amount received and just have the % towards our goal showing?

Remove this code from the xml file

<tr align="center">
                  <td class="alt1">We have received a total of $$vboptions[donormoney] in donations towards our goal of $$vboptions[goal]
                   <br />
                       <br />
<table class="tborder" align="center" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" "border=0" width="500">
                       <tr>

[sinisterpain]

Originally Posted by yaoren

Any way I can turn off the $ amount received and just have the % towards our goal showing?

Do not edit the XML.
Just edit the template donorbar and remove just the wording

 We have received a total of $$vboptions[donormoney] in donations towards our goal of $$vboptions[goal]
  <br />

Radarhunter please do not use the quote function for showing any code or template info instead use code function ie..."#"

[yaoren]

Thanks, I just had to re-center it as it threw it all over to the left side but sorted now

P.s... Donations are doing well since installing this thank you!

[radarhunter]

Originally Posted by sinisterpain

Radarhunter please do not use the quote function for showing any code or template info instead use code function ie..."#"

gottcha