Integration with vBulletin - TS3 Group Manager

TS3 Group Manager is a lightweight plugin that allows TeamSpeak 3 server groups to integrate with vBulletin usergroups. You can configure the plugin to correlate any number of vBulletin usergroup IDs to TS3 server group IDs.

Mark as Installed to receive support.

Quick note! This is my first ever plugin for vBulletin so if something's wrong just yell at me angrily in all caps and I'll try my best to fix it Everything seems to be working perfectly in my tests though.

This should work with older versions of vBulletin, though I'm not exactly sure how to test it. If anyone knows how I can find out what the minimum version of vBulletin required to run this is, please post.

I do plan to add integration with vbExperience soon that would change a user's group in TS3 based on their vbExperience points.

Instructions

1. Upload the items in the "upload" folder to your forum directory
2. Add a custom user profile field (this will contain the user's TS3 unique ID)
   • This should be a single-line textbox
   • I also recommend to set this field to Required: Yes, Always, to avoid possible complications
   • Field length of 50 should suffice
3. Install the product (product-ts3groupmgr.xml)
4. Configure the TS3 server info through the plugin menu
5. Configure group settings through the plugin menu
   • TS3 Unique ID Field Name setting can be viewed in the User Profile Field Manager. Field would most likely be named field1, field2, etc
   • For example, if you want vBulletin usergroup id 9 to correspond to TS3 server group id 333, and vB usergroup 8 to correspond to TS3 server group 334 - in TS3 Group IDs you would type "333,334" and in vBulletin Group IDs you type "9,8".

REMEMBER! You must set a custom user profile field containing each user's TS3 Unique ID!

Hook Information
This plugin activates 2 hooks by default. 1 hook (useradmin_update_save) will update the user's TS3 groups when editing their account with the User Manager in the vBulletin admin panel.

The 2nd hook (profile_updateprofile) will edit their TS3 groups when the user updates their profile.

For security reasons (if you do not want a user to be able to change their TS3 unique ID field to someone else's unique ID) you must de-activate the profile_updateprofile hook.

Suggestions for other areas to hook will be taken into consideration for future updates.

Credits
Par0noid for his outstanding TS3 administration php class
optimatez for the idea

Suggestions
Please make suggestions for new features! This plugin is still in its infancy and there are many more possibilities.

Changes
1.01 -> 1.02 - Fixed bug that deleted all TS3 groups when removing all additional vB usergroups
1.00 -> 1.01 - Fixed bug that didn't read primary usergroup from admin panel hook

If you find this plugin useful, please donate a nice meal to a starving college student

[Raeven]

Very nice Addon.
Waht would be nice, if it would also add (Forum) Moderators as (TS3) Chanel Admins

[nhdriver4]

Nice addon. Thanks for your work on this.

I'm having an issue where both hooks appear to be attempting to update the TS3 server, but are timing out right away. I've confirmed that the connecting address is in my "query_ip_whitelist.txt" file. I'm not sure where to begin troubleshooting. I know that the query login and pass are correct because I can use them on other scripts I've installed.

Here's the log entry that shows up in my ts3 logs:

11/29/2010 5:30:30 PM   VirtualServer   Info   query client disconnected 'serveradmin from 69.164.199.178:43922'(id:1) reason 'reasonmsg=connection lost'

Update: Tried this from another web server with the same result.

Update again: After some debug, it seems that the line it's getting stuck on is

PHP Code:

$ts3_cid = $ts3->ClientDbFind($ts3_uid, "-uid"); 


I think it's got something to do with the executeCommand function in the class file (line 1966) thinks there's an error.
Class Debug Output:

Error while fetching: 'Welcome to the TeamSpeak 3 ServerQuery interface, type "help" for a list of commands and "help " for information on a specific command.'
Error while fetching: 'cldbid=5'

[ImmortalForums]

May of been a code change in the latest revision of teamspeak as I had to update my web based admin panel. The script needs to be updated.

[nhdriver4]

I gave up with Par0noid's php class. It's broked

I've got everything working with Planet TeamSpeak's TeamSpeak 3 PHP Framework. It's sort of a hack of this mod into a new framework. I'll stay installed on this mod for some time, but will probably leave soon.

Thanks for your work.

[Olli2k]

I can confirm nhdriver4's problem. Connection timed out. Mod is not working.

TS³ Server: 3.0.0-beta30 [Build: 12998] Linux

[Niak_Judge]

Hello,
I want to know if this mod is "fixed" now ? Is it working ?
Is there any way to get it working ?

[initzero]

Hi,

so still no updated on this Mod?

[Haziel]

How do I use this mod? I installed and set everything up, but can't really find the way to make it work (assign groups to people on the forum and allow them to login etc.)