[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.

Reserved - Screenshots coming soon.

Thank you for creating this. I'm glad to see support for channel groups on your to do list - I'll be adopting this for use on my forum as soon as that is implemented.

Well since you gave some feedback, why not help me make this the best TS mod for you, how do you want to support channel groups? Should it be per user or per usergroup? Do you want it as easy as possible or are you ok with entering number combinations like (channel_id => channel_group_id)

I am installing this mod as we speak I think the best TS3 mod for VB would be this:
http://addons.teamspeak.com/director...chokiller.html

If this mod could do all or even 90% of what the above app can do then people that have a vbulliten forum can host TS3 servers \ reseller.

Thanks for the mod :)

That is essentially what I want to do, except with VBulletin as the backend. (I use that already, and even want to incorporate TSFTP into this as well)

Ok lets see

I get an error when I try and edit the usergroup

Database error in vBulletin 4.1.0:

Invalid SQL:

SELECT text, languageid, special
FROM phrase AS phrase
LEFT JOIN phrasetype USING (fieldname)
WHERE phrase.fieldname = 'error'
AND varname = 'neo_teamspeak_error' AND languageid IN (-1, 0, 1);

MySQL Error : MySQL server has gone away
Error Number : 2006
Request Date : Thursday, December 23rd 2010 @ 04:03:09 PM
Error Date : Thursday, December 23rd 2010 @ 04:03:20 PM
Script : http://forum.outkasts.net.au/admincp...&usergroupid=6
Referrer : http://forum.outkasts.net.au/admincp....php?do=modify
IP Address : 60.230.100.202
Username : Trippy
Classname : vB_Database
MySQL Version :

Ok Mysql error has gone away now I am getting

TeamSpeak Teamspeak Error 110: Connection timed out.

Take it password or port is wrong

The MySQL error was something with your server, however the Connection timed out error most likely points to wrong settings, double check the settings in vbulletin->options->Neoobs-Teamspeak

Installed but in group Settings changes not saved.

When I have selected Default Teamspeak Server Group Serveradmin, normal or guest allways appears like Serveradmin. :eek:

Will be fixed in next release which should be out very soon (couple days max)

Installed and working.

Only when someone switches usergroups(vb) it is not updated.
The user is added to the new servergroup(ts3) and not removed from the older servergroup so he is added to two groups on teamspeak.

I got paid subscriptions so there is some switching between usergroups on VB.

Thanks

I will add that to the list of things that need to be fixed. As of right now it only updates when you edit a user (and that is a lot of work) I will try and find a way to sync when people are moved from one usergroup to another.

A new version is up, 0.8 adds channel group support and multiple server group support.

Also because of the way things are set up, you will need to set up server groups again. Sorry just couldn't make it work right.

Thanks for the update.

Hope you find a way to do it.

Did this latest update fix the problems?

Wow, it really is Christmas! =)

So I just installed this on 4.06 (edited the XML version so I could) and I understand you say it may work, etc. But wanted to give you an error report incase it's something else.

When editing a usergroup, I get the following error once per channel or server group, not sure.

Warning: in_array() expects parameter 2 to be array, boolean given in [path]/admincp/usergroup.php(201) : eval()'d code on line 15

I have a few hundred users of my TS server with anywhere from about 25-50 on most of the time. This is pretty much something I started to write myself at one point and then didn't have the time. (I even had the profile field already there and configed the same. heh).

Anyway, if you don't wanna support 4.06 that's cool, just trying to help out where I can. =) Please let me know why you think it might not work on 4.06 so I can either try to work around it or see if I want to attempt an upgrade (my site is pretty custom so... things tend to break a lot with upgrading).

Questions, Etc.

I'd like all members within a specific usergroup to be able to generate tokens (which is looks like you have) that allow specific things. However, I'd also like to somehow validate that they are the ones using those tokens if possible. Not sure how to do this, but... I just want members to be able to be as self reliant as possible.

Along those lines, set (per usergroup) how many times within X time they can generate a token. I'd like them to be able to do it once every 30 days for example. Otherwise they need to talk to an admin to see what the problem is.

As you already mentioned, trapping when someone's usergroup is changes would be very nice.

The viewer doesn't display custom icons for server groups. Not sure if these can be downloaded from the server or if they'd need to be uploaded to the web server manually, but either way would be good.

An icon displayed in the postbit as to the users current TS status would be nice, a mouse over tooltip of what channel they are in and how long they've been connected/idle too.

I'm not sure how heavy that would be on the server, but for myself... I'd like to try it anyway and see.

I'll come up with more ideas later, I guess I really just need to get it working first though. heh

Shoot me a PM so we can get it working as soon as possible. I will also add your suggestions to the list. About support, I don't support it because I don't have a forum running it to check for errors. However I am more than willing to try if someone wants to let me.

PM Sent, I have no problems at all providing you with whatever you need to make it work. =)

The update does not safe the default servergroup within usergroups on VB 4.1.0.

I reinstalled and it is not working only the older version 0.7 works.

Do you mind PM'ing me your forum addy and an admin username and password, I kinda want to see why it isn't saving because it saves in all 3 forums I have (2 test and 1 production)

Just a quick note, good support from the developer on this, fixed things up for me quickly. Excellent mod and I can't wait to see how it grows!

Send the PM.

Just to be sure i removed 0.7 and installed the 0.8 version.
But still it does not safe the servergroup.

Edit: Thanks to Neo_obs for fixing my problem!

A new version was supposed to be out Monday night, sadly personal issues came up. But I should have it done by Wednesday.

This will be the last beta and will include quite a bit more than the previous 0.8 version including:
* Custom number of tokens instead of just 3
* Move away from profile fields and into custom fields for Unique ID
* Lookup users by Unique ID(s)
* Multiple Unique IDs
* Support for Secondary Usergroups
* List and Remove active tokens

I just want to thank Trek for letting me test things on his forum along with his wonderful insight on new features and generous donations (which helped a lot since my credit card was stolen and that was all I had)
Also a thank you to Hendrik83 who found a bug in 0.8

No problem Neo_obs, glad to help! .9 should be a large improvement, can't wait!

Awaiting screen shots before I move from my custom hack job of a TS3 integration.

Screen shots will come as soon as 0.9 is out

I just released 0.9, I am asking everyone to remove 0.8 and 0.7 before uploading 0.9 as some changes have been overwritten. Also you no longer have to create a profile field. If you have an issues please reply here and let me know so I can fix them ASAP.

EDIT: Also added screen shots per user request, a full group of screens are in the zip

I am going to try it.

Thanks.

Very interested in this mod; does it change usergroup on TS3 when you change it on the site?

It updates the users TS3 Group when they update their Unique ID.

This mod needs the users to enter their Unique ID in order to work, the Unique ID is the only way to make sure the person is who they say they are as you can not fake a Unique ID (normally) in the TS3 Client

Excellent Mod. Mostly needed!!!

Problem follows :(

When pressing the generate key that's what's happening..

Server logs Protocol mismatch. Running TS3 3.0.0-beta30 (latest).

Maybe they changed something..

Keep up the good work!

Thanx a mil.

Tested.

I have the same error on generate token.

If both of you could add your webservers IP to your white list that should solve the problem. If not let me know and I can troubleshoot further.

I am using 127.0.0.1 which is by default in the whitelist and I have also double checked that.
I have also put the Internet IPs too with no luck. Same problem.

It is already white listed for my ts viewer.

A protocol mismatch can be caused by quite a few things, but the usual problem is that the server and client are two different versions. As of right now this only works with 3.0.0-beta30 [Build: 12998]

If both of you have that can you private message me with an admincp login I will see if there is a different problem.

You still have mine?

I don't believe I ever got a login... and I usually delete the PM shortly after helping so that it isn't saved anywhere for people to use

Thanx Neo_obs. It's working now..

Next steps..

1. ts3icon.php is missing so custom server icons show up as broken pics. Flags do show tho.
2. I suggest you put a new variable for autoconnect to server and not the one you have for server query. I have it 127.0.0.1 so autoconnect doesn't work. Work arround is to put real server address but it's not good security wise. (query)

Other than that it's very good!