vBulletin LTS

Ventrilo Stats Block without needing vBadvanced
Mod Version: 3.00, by Crimm

This mod has been replaced! Ultimate Ventrilo Status

This mod does NOT require vbadvanced. So some people liked my vbadvanced mod that displayed the Ventrilo Status, but didn't want vbadvanced.

I have now made this one that doesn't require vbadvanced, but it does require Style changes. I hope you enjoy!

Support Thread: http://www.mmo-mods.com/forum/showthread.php?p=13858

Author:

Crimm - Included because I have been finding my mods all over the internet taken via RSS :P

Description:

This will place a Ventrilo status block in a column on your vbulletin home. It uses some of the files found on Ventrilo.com's download section plus things I have learned to integrate them into vBulletin.

NOTE 1: Debug option may display server information. Hide the block to non-admins when debugging the block or else malicious individuals could get their hands on your server information.

NOTE 2: Style Changes required! To place this on your forum home, you must make some changes to your forumhome template. All styles are not made the exact same. I will offer examples below, but I can NOT support all the styles for vBulletin. If you have trouble I suggest you contact the style developer for your style.

Difficulty:

6/10 - It's mainly normal installs, but it's difficult to debug this ventrilo status script and it requires template edits.

Requirements:

• http://vbulletin.com
• http://ventrilo.com
  
• PHP SAFE MODE OFF http://www.php.net/manual/en/features.safe-mode.php - Edit php.ini and turn off

Safe mode being off is very important and will be the biggest problem people have with this script. To test and see if you pass this requirement follow these steps:

1. Create a file called info.php
2. Put this line inside it:

3. Upload it to your website.
4. Visit the new page by going to: http://yoursite.com/info.php or wherever you uploaded it.
5. Look for a line that says: "safe_mode"
6. If that says - On next to it... then contact your host, because you can't go any further.

**I was going to try and implement a check, but can't seem to figure out how to do that.**


Support:

Here or my site: mmo-mods.com I spend the majority of my online time at my site so feel free to stop by and ask for help.

FAQ's:

Q: Yes I have seen this mod: http://www.vbulletin.org/forum/showthread.php?page=5&t=113432 Isn't this the same mod?

A: No, it isn't like that. It's a side block. - See screenshots.

Q: I'm getting this: CVentriloStatus->Request() failed. PHP Unable to start external status process. Or this error: (Since friendly errors were turned on in version .2) "Can't find or run ventrilo_status"

A: Please post and I will try to help, best bet is to visit my site where this information is being culminated as a community and where I spend most of my time. http://mmo-mods.com. Experience tells me it has to be one of these three things:

1. Permissions: Make sure to chmod your ventrilo_status to 755 if you are on linux. If you are on Windows, make sure that whatever is running your IIS process can execute ventrilo_status.exe
2. You are in PHP safe mode. This won't work in PHP Safe mode.
3. It's a path problem - I made everything relative. I have included some testing scripts, please use them as directed below.
4. Make sure that you have chosen the correct environment set in your settings.

Q: I'm getting this error: "No response."

A: Check your Server information. You can obtain this from your ventrilo host.

Q: I'm getting this error: "Unknown Error."

A: Copy/Paste the exact error and post it here with your domain so that I can take a look

Q: Whats the best way to debug an issue?

A: I included a debug option in the Ventrilo Status Block Options in vBulletin options, but note be very careful as it displays server information that could be useful to hackers. Make sure to hide the block from non-admins when you have this option checked.

Q: I need to hide this block for non-administrators until I can get it working... What do I do?

A: I was going to show you guys how to do IF statements to hide it from Non administrators but it became to combersome. If you need to hide it. Then do this:

• Go to admincp->Style Manager
• Click add new style
• For title put in: Testing
• Hit save.
• Do the template edits below in the testing style instead of your forum style.
• Once completed go back to admincp->Style manager
• Click the style you just created and you will see what it looks like.
• After you are done testing you can go back to admincp->Style manager and delete the style and click your default style to go back to it.

In future version coming soon ... I will add a way to hide this in the vb options.

Installation:

1. Download the ZIP file attached
2. Upload the includes folder to your forum folder
3. Browse to the includes/ventrilo folder and chmod ventrilo_status to 755 for linux and check execute permissions if you are using Windows.
4. Go to admincp -> Products -> Install the product in the zip file
5. Go to Admincp -> vb options -> Ventrilo Block Settings
6. Put in your server information and check your environment and other settings
7. Now edit go to Styles & Templates -> Edit the FORUMHOME template of your style (MAKE A BACKUP FIRST!!!!!) and input the following information:
   
   Special note: This has been tested and operational on the default style. For other styles, please contact your style author as I can't troubleshoot other people's work in respect of that developer.
   • [For a right column status block do this:]
     • FIND
       
       
       Code:

       $navbar

     • BELOW ADD:
       
       
       Code:

       <!-- Ventrilo Status side column -->
       <table border="0" width="100%" cellspacing="0" cellpadding="0" align="center">
       <tr>
       <td valign="top">
       <!-- / Ventrilo Status side column -->

     • FIND
       
       
       Code:

       $footer

     • ABOVE ADD
       
       
       Code:

       <!-- Ventrilo Status side column -->
       </td>
       <td width="10px"></td>
       <td valign="top" width="160px">
       <table class="tborder" border="0" cellspacing="$stylevar[cellspacing]" cellpadding="$stylevar[cellpadding]" width="100%" align="center">
       <tr>
       <td class="thead">
       <center>Ventrilo Status</center>
       </td>
       </tr>
       <tr>
       <td class="alt1">
       $ventrilo_include 
       </td>
       </tr>
       <tr>
       <td class="alt2">
       <center><font size="-3">$display2</font></center>
       </td>
       </tr>
       </table>
       </td>
       </tr>
       </table>
       <!-- / Ventrilo Status side column -->

   • [For a left column do this:]
     • FIND
       
       
       Code:

       $navbar

     • ADD BELOW
       
       Code:

       <!-- Ventrilo Status side column -->
       <table border="0" width="100%" cellspacing="0" cellpadding="0" align="center">
       <tr>
       <td valign="top" width="160px">
       <table class="tborder" border="0" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" width="100%" align="center">
       <tr>
       <td class="thead">
       <center>Ventrilo Status</center>
       </td>
       </tr>
       <tr>
       <td class="alt1">
       $ventrilo_include 
       </td>
       </tr>
       <tr>
       <td class="alt2">
       <center><font size="-3">$display2</font></center>
       </td>
       </tr>
       </table>
       </td>
       <td width="10px"></td>
       <td valign="top">
       <!-- / Ventrilo Status side column -->

     • FIND
       
       
       Code:

       $footer

     • ABOVE ADD
       
       
       Code:

       <!-- Ventrilo Status side column -->
       </td>
       </tr>
       </table>
       <!-- / Ventrilo Status side column -->

   
   
8. If you get an error check the FAQ's above before asking for help.
9. Problems? Post here No problems? Then you are good to go.

Crimm notation on block:

Please leave the notation back to me in the block to help spread the word. I left it small, so it wouldn't bother your site. Us freelancers have to get some fame somehow

Mark as installed:

Please mark as installed if you use this script, and I will assist you with a higher priority than everyone else.

Special Thanks!:

How To Include A Custom Template Via Plugins - This tutorial and those mods are how I figured out how to add the columns successfully. Thank you very much to Kerry-Anne.

Revisions:

Version 1: Starting to gather scripts together
Version 2: Updated installer and worked on style changes
Version 3: Tested and completed install of product and removed call to global.php
Version 4: Updated Readme and FAQ because of copy/paste mistake :P

Also: Added screenshots

EDIT: Added Product updating code from vb.org