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:

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

TROUBLESHOOTING

Please make sure, that
- you use the latest version
- followed the install instructions, uploaded each file to the correct location


TS3 Related Troubleshooting

My server is displayed as offline, but I can connect to the server!

Step 1: First, make sure you entered the correct port, queryport and serverID. it is crucial, that these informations are correct, otherwise the script won't get an answer or will pull the details from the wrong server.

Step 2: Firewall/NAT -
If your server is behind a firewall or a port filter tool, you need to allow datatransfer between the local server and the webserver. If you search for "Port forwarding", you should find enough material and tutorials to solve this issue

Step 3: query whitelist -
For the webserver being allowed to query information from the teamspeak server, you need to add the webserver's ip to the ip whitelist. The File is called "query_ip_whitelist.txt" and located in the ts3 server directory.
Add the webserver's ip in a separated line to the file and save the document. You may have to restart the ts3 server to apply these changes. (This step is not necessary if your teamspeak server runs on the same machine like the vB forum)

Step 4: For the query script to be allowed to pull specific information about the server, you need to grant special permissions to the guest and/or guest server query group.
First of all, you need to enable the advanced rights management inside of your ts3 client settings, so you can actually see what you're doing.
The specific setting is located in the settings window (ALT+P), under the "Anwendung / Application" Tab in the gorup "Verschiedenes / Misc" on the left hand side, named "Erweitertes Rechtemanagement / Advanced permissions system". Make sure the box is ticked.
Open the rights management from within the ts3 client while connected to your server, navigate to Server Groups. Then you need to grant these rights for the groups Guest and Guest Server Query:

• b_virtualserver_info_view
• b_virtualserver_channel_list
• b_virtualserver_client_list
• b_virtualserver_select

You'll find those rights via filter in the section Virtual Server > Information. (Make sure you have the selectbox set to "Display Names" on the bottom of the window)
If you are not able to solve this problem on your own or run in complications, please contact your ts3 server provider or the official teamspeak forums for assistance, since this problem is beyond the scope of this mod.

Also, you might want to check out this post on details how to enable these guest rights.

If you've gone through these 4 steps and still can't get the viewer to work, contact me via PM with this information:

• TS3 Server IP:
• TS3 Port:
• TS3 Queryport:
• TS3 Server IP:
• TS3 Server version:
• vBulletin Version:
• Product version:
• Problem description: Error messages, logs, observations, etc.

General F.A.Q.

I'm getting a blank site with PHP errors of classes that could not be found

You forgot to upload the query libaries or you put it in the wrong place.
Make sure you uploaded the necessary php files into the ./forum/includes directory and set
the correct permissions so the webserver can access it.
Also check if you're using the correct version.
If you update the plugin file, always update the libary file(s) too!

The viewer output doesn't print at all, how can I display it?

Check first, if you enabled the ts viewer in your vBulletin Settings -> "Advanced Voicetool Viewer".
Also, check in your ServerOverview panel, if there are any servers which are active.
If you chose to hide offline servers, check if at least one server is online.
When using a custom template, you may have different hook names than the default vbulletin style.
Check the template code for the right hook names where you want the viewer to appear or consult
your designer for help.
If all this didn't help, check the template files IF you modified them or ask in the mod thread for help.

The Viewer doesn't update immediately, sometimes I have to refresh the page multiple times for it to update the viewer!

This happens when you didn't set up a proper cron job for vbulletin.
Check the section "Cron jobs" in the readme file for more information.



CHANGELOG

Its saying our vent is offline when its not! Any suggestions?

Its saying our vent is offline when its not! Any suggestions?

I tried that Mod ony my 4.10 vB and I get this MySQL error.

There were no previous Versions of TSX installed. Whats wrong ?

Nice app. Installed.

Did you use the correct ip and port?
Please PM me the connection details to your vent server, I'll take a look.

Huh, never heard of that one before. 4.1.0 you say? I'll check back and see what's the problem. Didn't encounter something like this myself yet.

Installed and working.

I am new to CMS so how do I go about creating a forum block for this or widget?

Thriled with the idea of not using an outside source for this information.

I did get the cronjob setup correctly so that is a start. =)

I have the same problem on 4.1.3 when adding an TS3 server...

mee too

You need to read the directions. You have to put the correct ID of the TS in to stop the errors.

I installed it correctly on my site but says the server is offline. I have allowed my website into the ip whitelist for TS3 and no change. ?

Invalid SQL:
INSERT INTO `vb_tsx_server` (`active`, `name`, `ip`, `port`, `queryport`, `serverID`, `type`, `order`, `cacheTime`, `signalTime`, `status`, `created`, `password`) VALUES ( 0, 'Teamspeak 2', 'xxx.xxx.xxx.xxx', 8767, 59176, 0, 1, 999, 0, 0, 3, '1307378271' );

'value' for 'password' is missing in sql-query ... the last value ('1307378271') in the query is the value for the 'created' timestamp.


vBulletin 4.1.3 pl1
avv 1.3

Edit 2 - solution:

tsxview_class.php, find line 126:

VALUES ( %d, '%s', '%s', %d, %d, %d, %d, %d, %d, %d, %d, '%s' )",

replace it with

VALUES ( %d, '%s', '%s', %d, %d, %d, %d, %d, %d, %d, %d, %d, '%s' )",

The MYSQL error is now fixed.

For all those with version 1.3, just download the package, upload the file
includes/tsxview_class.php and overwrite the old version.
Or alternatively, try the fix from Rabillo. Now you should be able to add new servers.

Can you PM the ts3 information to me so i can check what's wrong?

ip:
port:
queryport:
serverid:

I like this mod... Wonder if I can recommend an enhancement or two... Take them or leave them.

Where it says JOIN SERVER, if you have ventrilo and a default visitor name, it will try and overwrite the local profile.. any way for it to join and keep default user name if one exists?

I think it should have an icon that says "Voice Servers" and then list the servers under that by type with icon and status.....

Should probably be able to define the color of the JOIN SERVER link.

Thanks again, this is very useful

Hi Doctor Death,
most of the features are already covered by the way you can modify the templates on your own. Given that you have the according HTML/CSS knowledge or someone who does.

Not sure what you mean by "default user name". Does ventrilo has a setting like this? I'm not sure how ventrilo handles these things, but possibly it should be enough to leave the user name parameter in the url blank, right?

You can modify the 2 templates accordingly to fit this kind of output.
I'm not sure it would be a wise idea to implement this kind of output and then nobody uses it. The template vars should be enough to let you style the output exactly how you like them to be. If something in particluar is missing, let me know!

You already can!
Put this in your CSS > additional.css template:
Replace the color codes with the colors you like and the link should have that color!

I've updated the Hack on my forums and it still doesn't connect to Vent... it says Offline!

Would be awesome if it could display a small box on the CMS frontpage!

Hello,

i want to enable "b_virtualserver_select" but the voice always say error. Any idea?

/EDIT
Works =)

But one little Problem. Names with special signs are not working. Any idea to solve it?

2. Question:
How to show it only for a special usergroup?

By "not working" you mean the name gets displayed just without special chars, or some weird characters showing insted or no username at all?

Sure, you can edit the viewer_overall template and add these conditional tags around the content:
where 1, 2, 3 are the group ids of the groups, where the user must be a member of (at least one)

Names shows as ?????

Ok, thanks for help =)

AH sehe gerade, deutsch? :)

Dachte die Flagge und die Location h?tten mich schon enttarnt ;)

I'll look into it, probably something wrong with utf8 encoding.
Which server types show this behaviour? TS2/TS3/Vent or all servers?

Steht nur GER da, keine Flagge :P
EDIT: Ah....Avatar und so :D

I use TS3.

i've installed last version and don't see server.usercount looks like phrases not added.

It's possible to see cyrillic fonts in user names?

The special processing with specific charsets will be improved in the next version, i'll try to release it this week.

Can't seem to be able to get my TS3 server showing as online on my forums.
http://www.flycay.com/forums
99% sure server details are right but still shows as offline

Did you follow the troubleshooting in post #2?
https://vborg.vbsupport.ru/showpost....35&postcount=2

If after that you still can't get it to work, send me your ts server credentials per PM and I'll take a look.

What is withs MUMBLE ?????

\avv-1_3_2FIX-product\images\misc\mumble.gif <----

I started to implement mumble as well, but mumble is from a developer perspective just utter cr4p so I scrapped it completely.

As long as they don't provide an usable query API: No way.

I have the same problem as the previous poster installed fine but says offline when at the time of seeing this there are 7 people in ventrilo, i've checked and double checked the IP, Port and Password

check your PMs

Pm sent thanks for the fast reply.

I have my server IP address in, but which port do I use? I know what the Queryport is but password must be query port password

TS3 ServerID, Im not sure what we are suppose to put here

As TS3 QueryPort use: 10011, as connect port (obsolete, gets pulled by the script: 9987)
If that doesn't work, ask your hoster/provider for the correct ports

I actually own the physical servers and the license so theres no hoster involved.

Ive done all that but doesnt work, im guessing TS3 Server ID is wrong maybe

Did you set the correct query Permisions?
Otherways send me your server credentials per pm for further assistance

Is it possible to add the list in a widget?

Our host wont allow us to edit the whitelist and our server is showing offline, is there any way round this?

Not that I know of.

Maybe it's enough to give the necessary query permissions to the guest account like described here?

Otherwise, consult the official Teamspeak Support forum or change your host.

Note: This is beyond the scope of my mod and a ts3-related problem.

Is there any logging we can view to see why this mod shows offline? Really would like to get it working as its the best one weve seen

Well, you can hover over the last positive signal entry, if there was any socket response or a negative answer from the ts3 server, you can see it there.
But still, it's not a problem of the mod, it's simply a problem where no socket connection to the ts server could be established.