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

I have tested this on my test board and I do not have a problem with the end box not closing. From looking at your template you have modified the original quite a bit you may try to remove the class from the table for the donor bar. As far as the bit of red thats normal, I did not see this as a big issue but if you think it is then I will have to adjust the code to remove it.

[tekguru]

Can you post the original template on site please so I can revert and see if that improves the look of it.

The red part I can live with but as three users have PM'ed me asking about it - it might be an idea to fix it if you can

[sinisterpain]

Originally Posted by tekguru

Can you post the original template on site please so I can revert and see if that improves the look of it.

The red part I can live with but as three users have PM'ed me asking about it - it might be an idea to fix it if you can

Fixed the issue with the small piece of the red bar showing to the left. Edited the templated and removed class= "alt2" from the donation bar <td> so box is closed. If you prefer you can remove the class= "tborder" from the table around the donation bar and put back the td class= alt2" its your choice.
Import the updated XML file from above overwrite.

[tekguru]

This update has fixed the red colour (our thanks) but even thouh we overwrote the XML completely the bar is still not closed using the Aria Sand+ Theme.

Any ideas?

[sinisterpain]

Originally Posted by tekguru

This update has fixed the red colour (our thanks) but even thouh we overwrote the XML completely the bar is still not closed using the Aria Sand+ Theme.

Any ideas?

You must have used your original template, because I have removed class= "alt2" from the template in the XML.

Remove the red highlighted from either here:

 <td class="alt2" nowrap="nowrap" align="left"><img src="http://www.your website.com/forums/images/your style/polls/bar1-l.gif" alt="" width="3" height="10">

or here but not both:

<table class="tborder" cellpadding="6" cellspacing="1" "border=0" width="500">
<br />
<tr>

Try editing one see how it looks then try by editing the other and see which one looks the best for your site.

[tekguru]

Cheers for that

We went with :

<table class="tborder" cellpadding="6" cellspacing="1" border="0" width="100%" align="center">
 <tr>
                                     <td align="center" class="alt2">
                        
                      $vboptions[donationtitle]
                             <br />    
                       $vboptions[donatexplain]
 <br />
                                
            We have received a total of $$vboptions[donormoney] in donations towards our goal of $$vboptions[goal]
  <br />
<table  cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" "border=0" width="500">
<br />
<tr>
  <td class="alt2" nowrap="nowrap" align="left">$barimag_left$barimag$barimag_right</td>
</tr>
</table>
      We have received a total of $donorbar%
                                         <br />
                               $vboptions[paypal]
                                           <br />
                                        $vboptions[bbtitle] would like to say thank you for helping to reach our goal.
                                     </td>
                                 </tr>
                     </table>

Which seems to work for us

[sinisterpain]

If you recently updated as of Aug 19th there is no further update at this time. The mod thread reflects updated due to an issue with the "last updated" date at the top of the page showing "never" instead of 8/19/07 which has been now corrected.
Sorry for any inconvience.
Sincerely,
Sinisterpain

[cpgaming]

I've installed this mod and everything works fine with the main module although when i attempt to install the vbadvanced cmps version I end up with it not working and showing some very odd code at the top of the main vbadvanced page. As I don't see any instructions in the download or in this thread that specifically explains how to install it into the vbadvanced settings and the download i extracted was a basic module I attempted to install it as such and chose php as the file type. Is it possible to have you explain the proper method to install the vbadvanced (running the 3.0 version on vbulletin 3.6.8) so that i can tell if I'm doing the installation of this module properly?

Code that is showing above the vbadvanced main page header is as follows:

a:2:{s:6:"module";a:11:{s:5:"title";s:12:"Donation Bar";s:10:"identifier";s:9:"donorbars";s:8:"filename";s:11:"donationbar";s:7:"inctype";s:8:"template";s:12:"templatelist";s:22:"adv_portal_donationbar";s:6:"parent";s:0:"";s:7:"colspan";s:1:"0";s:8:"formcode";s:0:"";s:8:"useshell";s:1:"1";s:4:"link";s:0:"";s:7:"options";s:1:"0";}s:9:"templates";a:1:{s:22:"adv_portal_donationbar";s:1278:" $vboptions[donationtitle] We have received $$vboptions[donormoney] in donations towards our goal of $$vboptions[goal] 

 $barimag_left$barimag$barimag_right 

$donorbar% of our goal has been reached. 

Thank You from $vboptions[bbtitle] 
$vboptions[paypal]
";}}

Any help is appreciated as we like this mod are really want to use it on both pages (main page and forums head page)

[cpgaming]

I have this sorted out I was uploading it manually and it wasn't adding the proper code to the templates i chose the upload/download module this time to see if that worked and it is working great and fixed the code error i was receiving at first. My apologies for not thinking of that initally and posting here and thanks for this and several other great mods you've made that my client is using they are really enjoying them so far and like the look of them. Great work :up:

[sinisterpain]

I am glad you got it sorted out. No need for apologies, and thanks for the kind words.