Forum Home Enhancements - Advanced Voicetool Viewer (Teamspeak 2, Teamspeak 3, Ventrilo viewer)

INFO

This is a more advanced version of my old tsxviewer plugin. It was written from scratch and offers a lot more features!
It displays a list of users connected to a voicetool like Teamspeak 2, Teamspeak 3 or Ventrilo and displays them on the Forumhome page inside the what's going on box, or anywhere else!

Templates allow you to fully customize the viewer, which can display unlimited amounts of viewers for your voicetool servers!

Keep track your server's uptime with the cron logger, which logs every time a server times out or comes back online!


*** Despite the product description saying mumble is supported, it is NOT. Sorry for any confusion ***

FEATURES

- Multiple Server Viewers on a single page
- Fully customizable Templates
- Query caching
- Server Uptime Logging
- No iFrames! Fits perfectly into vbulletn. Make search engines love you!

INSTALLATION

Extract the archive and upload the files according to their structure:

- forum root
	- admincp
		+ tsxview_admin.php
	- includes
		- cron
			+ tsxview_cron.php
		- xml
			+ cpnav_advancedvoicetoolviewer.xml
		+ tsxview_class.php
		+ ts2status.php
		+ ts3status.php
		+ ventstatus.php
	- images
		- cms
			+ delete_small.png
			+ edit_small.png
			+ permission-not-set_small.png
			+ permission-set_small.png
		- misc
			+ mumble.gif
			+ teamspeak2.gif
			+ teamspeak3.gif
			+ ventrilo.gif
			+ ts3_off.png (optional)
			+ ts3_on.png (optional)

Install the correct plugin xml file in your vBulletin ACP.
If you have any previous tsxviewer product installed prior to 1.3, uninstall it first! (Important!)

READ THE INCLUDED README FILE BEFORE INSTALLING THE PLUGIN! (srsly, spare you the headache!)

[techanalyst]

I still cant get it to work :P

[Disasterpiece]

Originally Posted by techanalyst

I still cant get it to work :P

you are using the IP adress instead of the hostname, right?

[techanalyst]

Correcto boss, I own both the physical servers and they both reside on the same network and same subnet, I also control the firewall and have a host to host any any set

[yoni007]

I found a little "error", repeated word, into "tsxviewer_vb4_v1_3.xml".

<h3 class="blocksubhead">{vb:raw server.indicator}&nbsp;&nbsp;<span class="ts_servername">{vb:raw server.icon}&nbsp;{vb:raw server.name}</span>&nbsp;{vb:phrase phrase_tsx_currentuser, {vb:raw server.usercount}}</h3>

should be

<h3 class="blocksubhead">{vb:raw server.indicator}&nbsp;&nbsp;<span class="ts_servername">{vb:raw server.icon}&nbsp;{vb:raw server.name}</span>&nbsp;{vb: phrase tsx_currentuser, {vb:raw server.usercount}}</h3>

[drainpan]

I have mumble instead of teamspeak and ventrilo and this mod says it is also for mumble... it says so in the plugins and products area description of the installed mod.....

but..... when adding servers... there is no mumble choice..... there is no mumstatus.php... am I missing something?

[Disasterpiece]

mumble has been scrapped before the release due to some very unusual views of the developers.
It may come someday, but not in the next days/weeks/months.

The plugin description still says mumble, but this is from an early beta release. Some of the code is still existant, but the "interesting" part is missing. Sorry for the confusion.

If you're interested in the discussion, read this: http://sourceforge.net/projects/mumb.../topic/3867568

[odie3]

NM - finally got it working... had to go to "Settings | Options | Application" and check on "Advanced permission systems".

Now I can get into my test server - now to make this happen with our hosted/rented server.

[odie3]

Ok, I am trying to setup my cron job but the email i am getting back is:

Status: 500 Internal Server Error
X-Powered-By: PHP/5.2.17
Content-type: text/html

Not sure if I have my host site/cron setup properly (the path) but I think I do.

Looks like my path is correct, there is a php error log that is growing in the \cron\ directory

[30-Aug-2011 20:58:50] PHP Warning: require_once(DIR/includes/tsxview_class.php) [<a href='function.require-once'>function.require-once</a>]: failed to open stream: No such file or directory in /home/XXXXXX/public_html/includes/cron/tsxview_cron.php on line 9
[30-Aug-2011 20:58:50] PHP Fatal error: require_once() [<a href='function.require'>function.require</a>]: Failed opening required 'DIR/includes/tsxview_class.php' (include_path='.:/usr/lib/php:/usr/local/lib/php') in /home/XXXXXX/public_html/includes/cron/tsxview_cron.php on line 9

[Disasterpiece]

Originally Posted by odie3

Ok, I am trying to setup my cron job but the email i am getting back is:

Status: 500 Internal Server Error
X-Powered-By: PHP/5.2.17
Content-type: text/html

Not sure if I have my host site/cron setup properly (the path) but I think I do.

Looks like my path is correct, there is a php error log that is growing in the \cron\ directory

you shouldn't access the tsxview cron script directly, but the vbulletin cron.php file located in the forum root dir.

Important keywords marked in bold:

CRON JOBS
=========

To make the uptime logger work properly and keep the viewers up to date every time a user refreshes the
page, you need to add a cron job to your webserver.
This can happen in multiple ways, so pick the right one for your environment:

- You own a Root server or a VPS and have shell access to the console:
Great! the only thing you need to do is to add a cron entry to the crontab as root or your web user.
You can access the crontab by entering 'crontab -e' with your favourite text editor.
Then you need to paste the following line after you entered the correct values:

*/5 * * * * /usr/bin/php5 /var/www/htdocs/forum/cron.php >/dev/null 2>&1

What it does:
The first 5 columns define the time the cron entry should be executed (you may check google for the
according crontab syntax if you're unsure), the 6th column defines the binary, which should be your
php bin file. In my example I located the php bin in /usr/bin/php5, you have to check for your correct
bin file, ask your admin/hoster for assistance if you're unsure.
The 7th column is the absolute path to the cron.php located in your vbulletin root directory.
The last parts separated with a space (not a tab) tells the crontab to hide all output from the php parser

- You are on a VPS or a hosting, but have access to an admin Panel where you can add cron entries (or Sheduled Tasks)
Depending on how exactly the crontabs are managed, you might be able to enter a term like the example
above or you need to specify one line for execution.

PLESK for example uses "Sheduled Tasks" for specific domains.
In the Minute Field, you use "*/5", Hour, DoM, Month, DoW: "*"
Command: "/usr/bin/php5 -f "/var/www/htdocs/forum/cron.php"
The command has to be adapted to your server environment, especially the path to the php binary and the
path to your cron.php located in the forum root dir.

Ask your admin/hoster for assistance if you're unsure or use a different administration tool

- You don't have access to any of that or don't want or can't define a sheduled task:
No worries, the addon will work anyway. However there are 2 things you should be aware of:
Because of the vbulletin's style of running cronjobs, in the case that you had no user visiting your
forum for more than 10 minutes, the viewer will not update until the page is refreshed again.
This is because the update is called AFTER the page has been loaded for the user.
Second: The uptime logger may not work properly, because the script doesn't update every 10 minutes,
but at least 10 minutes from the last page load.

[odie3]

Doh! What a mis-read on my part! Thanks for helping me out!

[S]Ok, I have the correct "cron.php" being used any my email that I get from my VPS/Hosting is "GIF89a". From the forums I am not really seeing the TS3 server update within each minute (and I am not hearing the "guest" connected like when I force a reconnect by just editing my server in admin settings). Is there some vB Cron setup I am lacking?[/S]

NM, found the scheduled task in vB Admin/Settings - it's working as it should now. I had no clue about those scheduled tasks.