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 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!

You should re edit your donar bar template its missing the table for the bar and you do not show your goal that your striving for.

I would put back the original and edit the template as I described above.

and just change:

$donorbar% of our goal has been reached.

to:

$donorbar% of our $$vboptions[goal] goal has been reached.

[VHLinks]

Originally Posted by sinisterpain

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.

Oh it wasn't a complaint, I was just saying what I am using it with since someone asked. Clicked install. :I)

[Shazz]

Creative Idea, might use this in future timeframe

[Desi-Home]

i installed it but it didn't create any templates.. i added varialbe $donationbar but nothing appeard as it didn't add template so i created a template manually... but when i add $donationbar variable it doesn't show because the template is not inside FORUMHOME.. so please help me in adding varialbe thanks..

[yaoren]

Originally Posted by sinisterpain

You should re edit your donar bar template its missing the table for the bar and you do not show your goal that your striving for.

I would put back the original and edit the template as I described above.

and just change:

$donorbar% of our goal has been reached.

to:

$donorbar% of our $$vboptions[goal] goal has been reached.

Thanks.
It threw two of my skins off because of the missing table but as soon as I added that back in, Bingo... my two skins back to perfection again.
Much appreciated :up:

[tekguru]

Did anyone get this working with Bills Donate Mod at all, and if so could you share the changes needed?

[sinisterpain]

Originally Posted by Desi-Home

i installed it but it didn't create any templates.. i added varialbe $donationbar but nothing appeard as it didn't add template so i created a template manually... but when i add $donationbar variable it doesn't show because the template is not inside FORUMHOME.. so please help me in adding varialbe thanks..

How did you install it? The template is in the XML file if you imported it it would create athe template donorbar in styles/templates. If you can not get it running pm me and I will try and help you out. Please click installed for support.

[sinisterpain]

Originally Posted by tekguru

Did anyone get this working with Bills Donate Mod at all, and if so could you share the changes needed?

What are you looking for it to do? Please click install for support.

[tekguru]

All in and working now, I'm not realised initially it was stand alone

The difficult part was to get the PayPal form in the right format. I am curious though why the form has to use that particular format and button for the Mod to work ? If one wishes to link to an existing Donations page then surely that can not be possible.

Ideally I'd want to link to Bills Donation system and if one has to use the form specified in the instructions this is not the case - or am I missing something?

[sinisterpain]

Originally Posted by tekguru

All in and working now, I'm not realised initially it was stand alone

The difficult part was to get the PayPal form in the right format. I am curious though why the form has to use that particular format and button for the Mod to work ? If one wishes to link to an existing Donations page then surely that can not be possible.

Ideally I'd want to link to Bills Donation system and if one has to use the form specified in the instructions this is not the case - or am I missing something?

If you wish to point to your donation page just enter this instead of your form code.
and edit yoursite.com with your addy and your donation file with the php file you link too.

<a href="http://yourwebsite.com/forum/your donation file.php "><img 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!"></a>