Integration with vBulletin - [Neoobs] Teamspeak3 Integration

** Find more information about this project along with source code and bug/support tracker here **

Please remember to click Mark as Installed if you use this modification.
Please feel free to nominate this modification for the MOTM, and/or use the donate link provided (Support Developer).

This mod integrates Teamspeak 3 with VBulletin by synchronizing VBulletin usergroups with Teamspeaks server groups. It also issues tokens to users and has a small viewer. More functionality will be added upon request or as needed.

NOTE: You must have a Teamspeak 3 server with ServerQuery Login. (Other permissions may be required, a full list of permissions will be added later.)

Options / Features :
* The ability to turn the whole modification on/off.
* The ability to show the modification in Quick Links.
* Automatically add users to TS3 groups (server and channel) based off of their Unique ID (set in profile)
* The ability to look up users by username or userid (if they used a token generated by this script)
* The ability to look up users by unique ID
* The ability to allow certain usergroups to generating tokens.
* The ability to allow certain usergroups to reset token counts.
* The ability to allow certain usergroups to administer tokens.
* Custom number of tokens and unique ID's

Two new usergroup permissions are provided in the usergroup manager.

* Default Teamspeak Server Group - The Teamspeak 3 server groups that users will be placed into.
* (Channel Name) - The Teamspeak 3 channel group that users will be placed into for that channel. (Only one group is allowed per channel, select none to not set a channel group)
* Can Generate Tokens
* Can Reset Tokens
* Can Admin Teamspeak
* Number of Tokens allowed (also used for number of unique ID's)

Two new user fields have been added and are editable through the user manager or the teamspeak script.

* Teamspeak Unique ID (variable depending on settings for primary usergroup)
* Tokens (the number of tokens they have generated)

* All other modification settings are in vBulletin Options > Neoobs - Teamspeak.

To install or upgrade;

• Unzip the files.
• Upload contents of upload folder to forum root.
• Import the product into vBulletin using the ACP Product Manager.
• Set your groups in the usergroup manager.
• Set your settings in the settings manager.

Note that by default all usergroups are not set up, you must set them each to your own server groups. (This will be fixed in a future release)



Support
Support will not be provided for vBulletin 4 Alpha, Beta or RC versions.
Feel free to PM me if you have any problems and I will try my best to fix them in a timely manner.
Low priority will be given to posters who do not have this marked as installed
In some cases, support can only be provided if I have an admin login and ftp access.


To Be Added
* Update TS3 Group when VB3 Group is updated
* Viewer on ForumHome
* Add FAQ and Admin Help Topics


History:
v0.9.9 : 4-May-2011 : Initial Stable Release.

Beta Releases
v0.9 Beta : 31-Dec-2010 : Added support for custom number of tokens, Moved away from profile fields, Added lookup page, Added support for multiple unique ID's, Added support for secondary usergroups. Added Screens (NOTE: Phrases are not complete in this version. However if you would like to add phrases for another language let me know)
v0.8 Beta : 23-Dec-2010 : Added lookup page, Added multiple server groups, Added channel groups
v0.7 Beta : 22-Dec-2010 : Initial Beta Test.



GNU COPYRIGHT NOTICE: This mod uses Teamspeak3 PHP Framework provided by Sven 'ScP' Paulsen of Planet TeamSpeak.

[Kraxell]

I add the right "b_virtualserver_token_add" and get now this error:
"Teamspeak Error 2568: insufficient client permissions (failed on privilegekeyadd 17300/0x4394). "

[Neo_obs]

Can you PM me details to your TS server including server query login so I can check your permissions?

[LuucEarth]

Found a problem in the viewer where custom icon's were not downloading properly.

Traced it down to a problem in the ts3icon.php

/* load framework library */
require_once("../libraries/TeamSpeak3/TeamSpeak3.php");

needs to be changed to:

/* load framework library */
require_once("../teamSpeak/TeamSpeak3.php");

to match the structure you have set up in your product.

Once done with that custom channel and group icons do appear properly.

**This is in the 0.9.7b version***

On another note 0.9.7b did solve my token generation error of improper paramaters.

[Neo_obs]

Originally Posted by LuucEarth

Found a problem in the viewer where custom icon's were not downloading properly.

Traced it down to a problem in the ts3icon.php

/* load framework library */
require_once("../libraries/TeamSpeak3/TeamSpeak3.php");

needs to be changed to:

/* load framework library */
require_once("../teamSpeak/TeamSpeak3.php");

to match the structure you have set up in your product.

Once done with that custom channel and group icons do appear properly.

**This is in the 0.9.7b version***

On another note 0.9.7b did solve my token generation error of improper paramaters.

Thank you for the bug fix, it is now fixed in the source code. Glad to hear 9.7 solved token generation errors for you.

[LuucEarth]

Found another bug fix in the Post bit Display.

Line 191 - 193 of String.php (Helper Folder)

    if($regexp)
    {
      return (preg_match("/" . $pattern . "/i", $this->string)) ? TRUE : FALSE;
    }

This throws an error when Unique ID's have a / in them

Fix:

    if($regexp)
    {
       $pattern= preg_quote($pattern, '/ ');
      return (preg_match("/" . $pattern . "/i", $this->string)) ? TRUE : FALSE;
    }

Without the preg-quote there could be a serious security vulnerability in some situations.

If you allow users to set their own UID and have postbit on/offline notification turned on it calls this function.
Someone could put a highly recursive Regex pattern in place of their Unique ID and cause a CPU Cycle related DoS

[Neo_obs]

Originally Posted by LuucEarth

Found another bug fix in the Post bit Display.

Line 191 - 193 of String.php (Helper Folder)

    if($regexp)
    {
      return (preg_match("/" . $pattern . "/i", $this->string)) ? TRUE : FALSE;
    }

This throws an error when Unique ID's have a / in them

Fix:

    if($regexp)
    {
       $pattern= preg_quote($pattern, '/ ');
      return (preg_match("/" . $pattern . "/i", $this->string)) ? TRUE : FALSE;
    }

Without the preg-quote there could be a serious security vulnerability in some situations.

If you allow users to set their own UID and have postbit on/offline notification turned on it calls this function.
Someone could put a highly recursive Regex pattern in place of their Unique ID and cause a CPU Cycle related DoS

That is actually part of the framework I use... I will let the developer know and add this to my release now.

[Neo_obs]

I have 4 more bug fixes before I release Beta 0.9.8, however I need people to help me figure out what is wrong. If you reported a bug fix please contact me via PM or check the googlecode site for information.

Also a lot of people have been having issues with serverquery information. I will be adding more information to the readme in 0.9.8 that will explain better how to get your serverquery information. If you are hosting your own server, the username is usually serverquery and the password is a randomly generated password that contains numbers, letters, and symbols. You can not change the username or password. However if you are using another company to host your server, then you will need to contact them as your information may need to be set up either by them or by you.

[LuucEarth]

Originally Posted by Neo_obs

That is actually part of the framework I use... I will let the developer know and add this to my release now.

Its an issue in the framework if that function is intended to work with something that can be based on human input.

The problem I ran into was when the postbit online status was turned on.

I would get multiple:

Warning: preg_match(): Unknown modifier 'n' in [path]\teamspeak\Helper\String.php on line 192

One for each post that had a user with a UID entered in a particular thread.
And only when that UID had a / in it


Having a very small test bed of users with their UID known, it wasnt hard to notice that each unknown modifier was a part of the UID directly proceeding a /
That was causing the issue in that one bit of code. I guess the question is whether the function was flawed or the usage of it. =o)

[Neo_obs]

I can tell you that the usage is exactly the way it is written in the documentation, however because teamspeak 3 is still in beta, the php framework for working with ts3 is still in beta, and that is a major reason my mod is still beta.

However I have redesigned the way the postbit display works and should fix almost all issues you have. I have also applied the patch you gave me just in case. I still have 4 more open bugs but if the users don't respond with more information or an updated status I will be closing the bugs as invalid and releasing beta 0.9.8 this Thursday or Friday.

[fishinstud]

The TS Viewer is the nicest that I've ever seen. We have custom user group icons aswell as channel icons. Will your script display the channel icons? My custom group icons aren't showing. I saw the default icon picks in the folder. However my issue is that my user groups are: Guest, Friend, Trusted, Server Editor, and Admin; so the user group icons wont download and I cant alter your images due to the amount of user groups. Thanks for the hard work on the scripting.