Integration with vBulletin - gTeamSpeak - TeamSpeak User Management

What is it?
[hr]-[/hr]gTeamSpeak* is a addon for vBulletin which allows your choice of usergroups to register for a TeamSpeak server. It creates a system in which you can link TeamSpeak users to a forum user accounts.

If you use this mod, please Mark as Installed, and if you really enjoy this mod, please Nominate for MOTM, and if you really really enjoy this mod, feel free to Support Developer! Thank you!

You can find more information about TeamSpeak at http://www.teamspeak.com. You should have good knowledge about running your own TeamSpeak server prior to using the mod.

* gTeamSpeak was previously known as vBTeamSpeak.

Follow me on twitter!

Support
[hr]value[/hr]I use my released mods daily, if I find an issue with them or add features for myself I will release updates. If there are significant bugs or simple feature requests I will do my best to release fixes. Some of my mods rely on fetching data from 3rd party websites, due to the unreliable results, my mods will require users to troubleshoot for themselves if they find the addon is not working for them specifically. I am offering my personal mods that work ok for me for you to use, I am sorry I do not have time to troubleshoot many user specific issues. Thank you for your understanding.

Features
[hr]-[/hr]

• Optionally connect to a remote TeamSpeak database you have administrative control over if TeamSpeak is not hosted on the same db as your vBulletin.
• Optionally automatically add links to navbar and quick launch menu.
• Choose what usergroups get SA by default.
• Choose what usergroups can access the sign up form.
• Limit access by days registered.
• Limit access by user post count.
• Promote/Demote SA.
• Delete user accounts.
• Ban users from creating accounts.
• Send broadcast message to server.
• Send text message to a user.
• Prune inactive users.
• Display who is online on forum home.
• Cron checks vBulletin ban list every 10 minutes and bans users from TeamSpeak accordingly.
• Plugins: People can write their own feature plugins for doing things like banning, kicking, messaging users etc...

Support
[hr]-[/hr]
I will offer limited setup/installation support this script. While I do use the Remote Server option personally, I will not support this feature, you should have advanced knowledge of your server setup and troubleshoot this yourself. If you have purchased TeamSpeak hosting from a voice comm service provider, it is highly unlikely they will grant you database access. For best results and performance, have your TeamSpeak server use your vBulletin database as it's database.

1. Setup TeamSpeak to use mySQL
[hr]-[/hr]By default TeamSpeak uses a file system called SQLite. To make it use a mySQL database edit the server.ini and add:

[DBEXPRESS]
sqldir=mysql_sql/
Drivername=mysql
Database=database_name
Hostname=localhost
User_name=database_username
Password=database_password
GetDriverFunc=getSQLDriverMYSQL
VendorLib=/usr/lib/libmysqlclient_r.so.10.0.0
LibraryName=./libsqlmy.so
Active=1

When you start the server it will create all the necessary tables:

• ts2_bans
• ts2_channels
• ts2_channel_privileges
• ts2_clients
• ts2_servers
• ts2_server_privileges

Make sure these tables exist and that your TeamSpeak server is actively using your mySQL database properly before even downloading the gTeamSpeak modification.

For more information about setting TeamSpeak up to use a mySQL database visit http://www.teamspeak.com.

2. gTeamSpeak Installation
[hr]-[/hr]

1. Make sure that your TeamSpeak server is setup to use a mySQL database prior to installing this product. For best results prevent users and admins ability to register with the server via client. Also password the server to something gibberish as you will not be supplying the password to anyone. Also disable the ability for SA to grant SA for security.
2. Upload all files prior to installing product.
3. Install the product.
4. Create a Single-Selection Menu User Profile Field.
   • /admincp/?loc=profilefield.php%3Fdo%3Dadd
   • Single-Selection Menu
   • Continue
   • Title: TeamSpeak Access
   • Description: Can register self with TeamSpeak server.
   • Options:
     • yes
     • no
   • Set Default: Yes, but No First Blank Option
   • Field Required: No
   • Field Editable by User: No
   • Private Field: Yes
   • Field Searchable on Members List: No
   • Show on Members List: No
   • Save
   • Look and see what the field name is for TeamSpeak Access, example field25.
5. Fill in the gTeamSpeak configuration options.
6. Install any plugins you wish to use from the /admincp/gtsplugin directory.
7. That is all, send people to the form to sign up.

Note: You need to add your user id to the config.php under superadministrators. I will attempt to remove the need to require this in a future version.

TeamSpeak Access Profile Field Usage
[hr]-[/hr]
This is used if you want to ban a user from TeamSpeak and do not want to ban them entirely from the forums or change their usergroup.

• Set this profile option to No to prevent a user from creating a TeamSpeak account.
• When a user is banned from the gTeamSpeak user management, this option is automatically set to No. If you wish to unban them, set this option to Yes and they will be able to create a TeamSpeak account again.

Changes
[hr]-[/hr]
v3.31 - Upload files, Import product with Overwrite enabled

• Fix Admin CP nav
• Fix Whois online display

v3.29 - Upload files, Import product with Overwrite enabled

• Non-essential style tweaks.

v3.27 - Import product with Overwrite enabled

• Fix template cache

v3.24 - Import product with Overwrite enabled. Upload gteamspeak.php

• Navbar links now use $template_hook introduced with vBulletin 3.6.6
• Added option to limit access by days registered.
• Added option to limit access by user post count.

v3.22 - Import product with Overwrite enabled.

• Fixed typo in product file.
• Release German translation by Trantor.

v3.21 - Import product with Overwrite enabled.

• Fixed potential XSS vulnerability. Thanks Apophis.

v3.20 - Upload all files, import product with Overwrite enabled.

• Fixed an error with enable/disable plugins.
• Added option to display who's online on TeamSpeak signup form.

v3.10 - Upload all files, import product with Overwrite enabled.

• Cron created to check for banned users and remove their TeamSpeak account.
• Fixed some query statements.

v3.00 - v2.00 users no need to upgrade if you do not wish. If you do, vBTeamSpeak needs to be un-installed, and then follow fresh installation instructions. Your existing TeamSpeak user database will stay intact.

• Initial Re-Release.
• vBTeamSpeak re-branded gTeamSpeak.
• Code clean up.
• User Profile field now needs to be created manually.
• Added a couple phrases.
• Change templates slightly.

Hooks
[hr]-[/hr]

• I will consider hook requests.

Copyright
[hr]-[/hr]gXboxLive, Copyright ? Ghryphen (https://github.com/ghryphen)
Please maintain copyrights in derivative works, thank you.

[Gryphon]

Well, I am not sure this mod is for you because I get the impression that you don't know how a TeamSpeak server works.

[Spank]

That's probably very true =D. Just curious, 'tis all. It does sound like a good feature to have though.

[Chadi]

Although mentioned as a bug, how do I remove the profile fields after I've uninstalled the plugin?

[Gryphon]

Just remove them like any other user profile.

[ringoflight]

Does this Support Teamspeak servers which don't run through a Database?
My Teamspeak installation is running on server hosted by my hosting company, and have only provided me with the Address, and Port number, aswell as the username and password.....

[Hamma]

Doubtful it uses mySQL to interface with accounts and passwords.

[jluerken]

Hi, I just updated from v2.0.0 to 3.1.0 and when I try to enable/disable a plugin I get this error message

Database error in vBulletin 3.6.5:

Invalid SQL:
UPDATE vb3_gteamspeak_plugin SET `enabled` = '0' WHERE `id` = '0';

MySQL Error : Unknown column 'id' in 'where clause'
Error Number : 1054
Date : Wednesday, March 7th 2007 @ 11:20:06 AM

It seems that the autoincrement field named "id" is missing.

Please can you tell me how to fix this?

[jluerken]

Ok here we go:

This is the old table

CREATE TABLE `vb3_vbteamspeak_plugin` (
`id` int(11) NOT NULL auto_increment,
`title` varchar(255) NOT NULL default '',
`description` text NOT NULL,
`version` varchar(255) NOT NULL default '',
`order` int(11) NOT NULL default '0',
`reqsa` int(11) NOT NULL default '0',
`enabled` int(11) NOT NULL default '0',
`menu` text NOT NULL,
`code` text NOT NULL,
`function` text NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

and this the new one

CREATE TABLE `vb3_gteamspeak_plugin` (
`title` varchar(255) NOT NULL default '',
`description` text NOT NULL,
`version` varchar(255) NOT NULL default '',
`order` int(11) NOT NULL default '0',
`reqsa` int(11) NOT NULL default '0',
`enabled` int(11) NOT NULL default '0',
`menu` text NOT NULL,
`code` text NOT NULL,
`function` text NOT NULL,
PRIMARY KEY (`title`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

I got v3.1.0 running with this

CREATE TABLE `vb3_gteamspeak_plugin` (
`id` int(11) NOT NULL auto_increment,
`title` varchar(255) NOT NULL default '',
`description` text NOT NULL,
`version` varchar(255) NOT NULL default '',
`order` int(11) NOT NULL default '0',
`reqsa` int(11) NOT NULL default '0',
`enabled` int(11) NOT NULL default '0',
`menu` text NOT NULL,
`code` text NOT NULL,
`function` text NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

Please if this is correct update the archive file

[jluerken]

Hi Blackjack,

v3.1.0 is working well after the above sql modification.

What about these old things?

1. Delete Teamspeak account if the vBulletin account is deleted
(except for SAs)
2. Add an additional page to show who's currently online
3. Stats page with:
How many users, channels, uptime etc.
4. Form to request a Channel or Channelchange

Questions:
1. Can also a secondary group make users automatically SA or only primary?
2. Is the login page fully phrased?

[Gryphon]

Ah, well the id field should be missing, I just forgot to update the plugin query for enable/disable. I will fix that.

Requests: 1. User accounts are currently deleted if the forum account is deleted.

Questions: 1. Yes, 2. Yes.