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.

[sinisterpain]

Originally Posted by mickknutson

I am sorry if this is a bad question, but where is my FORUMHOME template? I looked in my Style Manager but I can't find it.

Style manager->Forum Home Templates->FORUMHOME

[Alfa1]

There is space between the navbar and the donation bar, but there is no space below the donation bar. How do I ad some space there?

I find it more effective to add the donation bar to the navbar, so it displays on all pages. How do I place this on the archive pages?

[AWJunkies]

<br /> or <br> after the code $donationbar

[Alfa1]

Thanks!

[AWJunkies]

No problem at all.

[sinisterpain]

Originally Posted by Alfa1

There is space between the navbar and the donation bar, but there is no space below the donation bar. How do I ad some space there?

I find it more effective to add the donation bar to the navbar, so it displays on all pages. How do I place this on the archive pages?

I would add the <br /> to the donorbar template rather than edit the FORUMHOME template further. Both will work but its better to keep the stock templates as clean as possible.

[AWJunkies]

Originally Posted by sinisterpain

I would add the <br /> to the donorbar template rather than edit the FORUMHOME template further. Both will work but its better to keep the stock templates as clean as possible.

I agree, I was just giving quick fix. Good call.

[tekguru]

It may well be worth noting that the :

PHP Code:

$barimag = "<img src=\"$stylevar[imgdir_poll]/bar2.gif\" alt=\"\" width=\"$donorbar%\" height=\"10\">"; 


codes within the XML are not XHTML complaint and should be as per:

PHP Code:

$barimag = "<img src=\"$stylevar[imgdir_poll]/bar2.gif\" alt=\"\" width=\"$donorbar%\" height=\"10\"/>"; 


to gain that requirement, that is the terminating '/' requires adding.

[elitemerlin]

reserved

[maidos]

i dont want my guest to view the donation bar, how do i do that