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

[Devil_Dog]

Any chance of getting something like this for Ventrilo?

[optimatez]

Confirmed working on vBulletin 3.8 :-D fantastic work.

[WhatPulse]

Originally Posted by Devil_Dog

Any chance of getting something like this for Ventrilo?

It might be possible, I'm almost positive RCon can be accessed in a similar way as the TS3 serverquery but I'm not interested in making that at the moment. Ventrilo groups and permissions are much more basic than TS3 and I don't feel it would benefit greatly from a plugin.

[ImmortalForums]

Fantastic to see this mod!

What happens if a user gets promoted via the automatic promotion system in vb?

[WhatPulse]

Originally Posted by ImmortalForums

Fantastic to see this mod!

What happens if a user gets promoted via the automatic promotion system in vb?

Unfortunately promotions are done via cronjob script which does not contain any hooks.
Might be possible to hack in there though, I'll look into this for future versions.

[ImmortalForums]

Originally Posted by WhatPulse

Unfortunately promotions are done via cronjob script which does not contain any hooks.
Might be possible to hack in there though, I'll look into this for future versions.

What about putting another cron that follows through on that? Not sure if that's even possible.

[WhatPulse]

Generally the less cronjobs running the better, it would probably just be easier to add a custom hook into the promotions cron script and distribute that along with a plugin. I'm currently working on getting plugins working to integrate with vBExperience, so I'll see about those promotions when I'm done.

[ImmortalForums]

I found a bug, if the user is in a secondary usergroup and a primary usergroup then you remove all their secondary usergroups but leave their primary usergroup the user is removed from all groups in teamspeak.

[WhatPulse]

Good catch. I've submitted an update and the issue should now be fixed.