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.

[tekguru]

That is superb, jsut what was needed. My thanks!

[sinisterpain]

Originally Posted by tekguru

That is superb, jsut what was needed. My thanks!

Your welcome glad I could help

[thetootall]

Very nice! Thanks!

[sinisterpain]

Your welcome. If you have any suggestions l;et me know.

[TheBlackPoet]

i had to use the other link to go through to my paypal.. if i was using the default link, would it automatically update the progress bar?? because right now, i have to manually update it...

either way.., its really good, it has increased money to my site more than the common donate link...

so... thank you...

[sinisterpain]

Originally Posted by TheBlackPoet

i had to use the other link to go through to my paypal.. if i was using the default link, would it automatically update the progress bar?? because right now, i have to manually update it...

either way.., its really good, it has increased money to my site more than the common donate link...

so... thank you...

Yes, the info that I put as an example is just that, an example to show the format of the link you must input into the admin cp->vb options->donations bar field for paypal button link. You must put your specific paypal info so the link goes to your paypal page.
The alternative is if you are using a paypal mod (ie..paypal donations3.5, billpaintball, cyberpaypal etc..) you may elect to link to your donation page.
It has to be updated manually as it does not link into any other mod. It was meant as a standalone or could be added to one of the other paypal mods.

[luckid]

If you want simply to add a button of connection to the page of (es: PayPal Easy Donate - vB 3.6)
Inserted this in the options:

<form action="http://www.srilanka-w.org/srilanka/forum/billspaypal.php?" method="post">
                             <input type="image" src="http://www.srilanka-w.org/srilanka/mkportal/templates/Water%20Green/images/paypal_donate.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!"></form>

Change only 2 link your linki on page off the mod:

http://www.srilanka-w.org/srilanka/forum/billspaypal.php?

And the for you image:

http://www.*******.org/srilanka/mkportal/templates/*******/images/paypal_donate.gif

I hope of to have been of help to someone.
excused my English are Italian (google)

Bye.... ciuazzzzzzzzzzzzzzzzzzz

[tekguru]

Anyone know how the colour of the bar can be changed say to green if the donations made figure equals or is greater than that needed for the current month?

[sinisterpain]

Originally Posted by tekguru

Anyone know how the colour of the bar can be changed say to green if the donations made figure equals or is greater than that needed for the current month?

Import the updated XML file and allow overwrite.
This will change the bar color to green when 100% or greater donations are recieved.

[tekguru]

Superb

Only one problem we modified the template as in this post to make it cleaner and now we get a slight piece of red at the start of the bar, and no closing box at the end as you can see here.

Any ideas?

Superb responce to the request though If the template can't be fixed I'll go back to the original template