Ventrilo Status v1.0

Keywords: Ventrilo, Voice, Chat, VoIP, FORUMHOME

Description:

Displays clients connected to your Ventrilo server on your FORUMHOME -- similar to that of "Who's Online".

Details:

Basically, this is a modified version of the publically available PHP Ventrilo Status Scripts. This version, however, has been modified to allow for direct vBulletin integration. All settings are managed through the AdminCP and all output is configured via templates.

Usage of this script requires knowledge of Ventrilo server administration. Your server must first be configured to receive and process UDP messages. This can be done in the server's INI file under the [Status] section. All server versions 2.1.2 and higher come with examples showing the options available to you. However, the UDP support is disabled by default so that they are compliant with older versions. Reference the "ventrilo_srv.htm" file that accompanies the server package for more details.

This thread on vBulletin.org will not address proper server configuration or server related connectivity issues, for all questions relating to those topics or similar, please visit the official Ventrilo Tech Support forums.

Installation:

1. Download the attached archive and import the product-ventrilo_status.xml file via the Product Manager.

2. Upload the files located in the archive to their respective folders.

3. Obtain the ventrilo_status* (or ventrilo_status.exe for Win32 platforms) and put it in a preferred location (ie. /forum/) and CHMOD the file to 755.

4. Configure the options via your AdminCP (vBulletin Options > Ventrilo Status Settings)

Version History:

• 1.0 - Initial release, here's to hoping...
• 1.1
  • Patched a theoretical XSS vulnerability. By theoretical, I mean the script would only be vulnerable under a specific set of circumstances which are less likely to occur than that of your server being directly hit by an errant meteor. However, if you're the paranoid sort, feel free to upgrade. Otherwise, there are no other changes.

* The file ventrilo_status(.exe) is NOT included with this package as it is distributed with the Ventrilo server package (Linux/Win32). If you are not personally hosting your Ventrilo server and instead using a hosting company, you can obtain this file by downloading the appropriate package here. You ONLY need the ventrilo_status(.exe) file.

[Cloudrunner]

Okay folks here's the backstory:

To get this to work if, like me, you use one host for webserver, and another for the ventrilo, you are going to have invisible problems.

The reason is this:
1) Most ventrilo servers that you rent won't have their .ini setup to allow it to talk to the ventrilo_status file on your web server.
2) Most web hosts will have the php querying another file blocked for any file that is NOT on your host.
3) The file ventril_status is an executable binary. Most commercial hosts won't allow this for fear of it being an automated bot of some sort used to hack, phish, spam etc.
4) The script wasn't written to display specific php errors in regards to whether it communicates or not. To make sure you are able to use the system download the example scripts at www.ventrilo.com and run the ventrilotest.php file. That will give you a better idea what is going on with your setup. You'll need to hand edit the config file first, so read the readme!

If you are using separate hosts then be prepared to don your diplomatic hat for awhile if you are serious about getting this to work.

For the most part this is designed for the folks who run their own servers where the ventrilo and the webserver are under their control.

At least that is what I have found so far. I'm being diplomatic with my webhost, so we'll see if I can get it to work. I'll detail what I run into if my host says I can use the executable.

[magnus]

Cloudrunner, great information. Thanks for posting it.

Only thing I can comment on, though, is:

Originally Posted by Cloudrunner

For the most part this is designed for the folks who run their own servers where the ventrilo and the webserver are under their control.

While, yes, I do run my own webserver.. I do not run my own Ventrilo server. I purchase hosting from East Coast Gaming Network -- this is the same server I developed this hack on, without any intervention required from their part.

For what it's worth, I've been with them almost 2 years and have no complaints.

But yes, I can see where some webhosts may not be too keen on allowing files with executable permissions. C'est la Vie.

[Cloudrunner]

I'm using ECG as well They're a good company, but cragi from tech can come off harsh at times, but for the most part, he gives good input.

That said, since they are who you tested with that rules out a problem on their side with me, so I'll have to look at my hosts setup to see if I can get this to work .

Thanks Mag!

CR

[Cloudrunner]

Something to note while testing your setup before you run this:

Originally Posted by ventrilo staff

When starting the ventrilotest.php script from a web browser one of several things will happen. It will either:

A) Work perfectly and give you all of the requested information from the server.
B) Display the error: No response from server.
C) Display the error: PHP Unable to start external status process.

If (A) then nothing else needs to be done unless you want to tweak the server and tighten down the hatches, which we would encourage you to do. However, if it suddenly stops working then you are not configuring the system correctly and the responsibility is yours to figure it out. If you do not fully understand the advanced options of the servers INI file then you should let some more qualified set it up for you.

If (B) then you are at least able to spawn the external status program successfully. This usually means that you either didn't specify the correct IP address or host name in the m_cmdhost option, the wrong port number in the m_cmdport option, the wrong password in the m_cmdpass option, the server is not up and running, the server is not accessible from this machine due to router/firewall constraints or any Filter commands in the server INI file.

If (C) then you have not specified the correct path and file name for the ventrilo_status program.

Enjoy

[GFX Brands]

alright heres the question i have i just download the regular ventrilo.exe ?

Windows i386 - 32bit this one right for installing on my vb board ?

[Cloudrunner]

You need to download the server program.

In that you will find an executable named ventrilo_status. If you are using a windows webserver then the executable to grab from the server installation archive is ventrilo_status.exe, if you are using linux, etc then it's just plain old ventrilo_status.

It all depends on what your webserver is running. If you try to run a linux file on a windows webserver, it won't run. If you try to run a windows executable on a linux webserver, it won't work either.

Make sure you know the OS of the webserver you are running your vB on, then grab the server download for ventrilo for that particular OS. Once you have that, unzip it and in the resulting folder is the ventrilo_status file you will need.

Good luck.

[GFX Brands]

or what is also possible to do not sure if you can try to do this but go to
ventrilolive.com go to query server (right under download ventrilo) and get the code something like this

<script language="javascript" type="text/javascript">
var vl_width=250;
var vl_height=450;
var vl_server="voice04.proclanhosting.com:4001";
</script>
<script language="javascript" type="text/javascript" src="http://www.ventrilolive.com/ext/ventrilo.js"></script>

now all that needs to be done is modify it so it can be shown where the magnus's has it at

now this is a easier way for noobs who cant install ventrilo php script on there server
(me and possibly other people)

and if i anyway broke any rules I do aplogize

[KHALIK]

I need help installing this script,

Downloaded the files, uploaded aswell (755) and installed the plugin.

I cannot see anyone;
http://www.fragmasters.co.uk/forum/index.php


Please help!

[richab]

any luck with a vba module block for this?

[hipplewm]

If you go to http://www.omega-guild.net and see if that is what you want, I can help duplicate that...