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

[ImmortalForums]

Also what about handling banned users?

[WhatPulse]

I do see a "Ban User" function in the admincp with a length of time to select. It is definitely possible to ban a user in TS3 for a certain amount of time that would be equivalent to their ban length on the forum. Problem is, again, there are no hooks in the ban user script for vBulletin.
I like the idea though and I'll definitely work on seeing if there's another way.

[ssslippy]

Originally Posted by WhatPulse

I do see a "Ban User" function in the admincp with a length of time to select. It is definitely possible to ban a user in TS3 for a certain amount of time that would be equivalent to their ban length on the forum. Problem is, again, there are no hooks in the ban user script for vBulletin.
I like the idea though and I'll definitely work on seeing if there's another way.

Hmm what about if banned via the warning system?

[ImmortalForums]

Also when a user changes usergroup via the user cp with permission groups.

[Devil_Dog]

Does someone have this running live. I'd like to check it out.

[ImmortalForums]

Originally Posted by Devil_Dog

Does someone have this running live. I'd like to check it out.

We are running it but its for guild mates only. I can say this it works great it just needs a couple more features so its more automated. The admin interface could be better but it works. Run run our own teamspeak server off our dedicated server and it has no trouble interfacing with our server.

[optimatez]

we are running it on our server, as the developer is in our team :-p

you are welcome to come see it in action if you want. Rush is the one who made it (whatpulse here). ts3: voice.teampulverize.com:9987
website: teampulverize.com

i wont be around until sunday night though.

[WhatPulse]

Post any other loose ends you can think of, I'm going to put out a big update next with everything and vbExperience support when the vbExperience dev fixes something.

[ImmortalForums]

Instead of disabling the hook could you check for duplicate unique id's in the DB when submitting?

[6FRGaming]

Edit: NM. I guess my server provider doesn't allow a permission that this script requires.