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.

[baby41]

Originally Posted by sinisterpain

You have to edit the template in admincp called donorbar
Maybe I will add an option to change currency symbol

This product is working fine on my forum but I do not have any donorbar file in the admincp ????? Can you see if that is the correct location and if I can translate this to portuguese aswell and if it is the same file,regards.

[sinisterpain]

Originally Posted by baby41

This product is working fine on my forum but I do not have any donorbar file in the admincp ????? Can you see if that is the correct location and if I can translate this to portuguese aswell and if it is the same file,regards.

If you are trying to change the currency symbol. You have to edit the template called donorbar. Admincp->styles/templates->donorbar.

[baby41]

Thanks I have found and easy to change.

[cagbaazee]

where do i put it

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

Code:
<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 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.

how do i put my paypal ID for that...

[baby41]

You need to go to your paypal account and click on Merchant Tools --> Key Features (donations) and follow the instructions,regards.

[sinisterpain]

What I mean by the link format is the slashes. ie (highlighted in red)
should look like this for links:

<form action="https://www.paypal.com/cgi-bin/webscr" method="post">

I do not mean that your info has to be the same as my example, just the link slashes.

[dizzine]

does this work on 3.5.4 with v2 by any chance.??..great add-on..!!

[sinisterpain]

I have not tested it with 3.5.4. The plugins may cause you problems

[Creed3020]

Is it possible to display somewhere other than forumhome, like inside a specific forum?

If yes what sort of changes would be needed.

Thanks!

[sinisterpain]

Just add the $donationbar into the template you wish to display it.