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.

[DeMiNe0]

Great hack. I allready have something like this coded at fusionclan.com, but this seems to be far better. I was planning to release mine, but you obviously beat me too it .

[Gryphon]

Thanks, I developed it a while ago as a non-vB feature on one of my sites and decided to convert it into my first vB product.

[SCS_Rocket-Devi]

Hey mate I keep getting this error on the teamspeak.php page

Database error in vBulletin 3.6.0 Release Candidate 3:

Invalid SQL:
SELECT * FROM ts2_clients WHERE s_client_name = 'scsrocketdevil.1' AND i_client_server_id = '1';

MySQL Error  : Table 'vbulletin6.ts2_clients' doesn't exist
Error Number : 1146
Date         : Monday, July 31st 2006 @ 01:22:48 PM
Script       : http://www.*******.org/forum/teamspeak.php
Referrer     : 
IP Address   : 86.140.217.226
Username     : SCS_Rocket-Devil
Classname    : vB_Database

and in admincp/vbteamspeak.php i get this error

Fatal error: Call to undefined function rpm_print_stop_back() in f:\domains\*******.org\wwwroot\forum\admincp\vbteamspeak.php on line 30

[Gryphon]

On the first error, are you accessing a remote database for TeamSpeak or is TeamSpeak sharing your vBulletin DB?

For the second, that is my fault I will fix the error, however the error is happening because you do not have your User ID in the config file under super admins. I will look into a way to improve that.

[jluerken]

Hi Blackjack, I installed your hack and while creating an account I get this error

Database error in vBulletin 3.6.0:

Invalid SQL:
INSERT INTO teamspeak2.ts2_forum_account SET ts2_client = '386', userid = '3', username = 'CFN|LordSoth';

MySQL Error : Table 'teamspeak2.ts2_forum_account' doesn't exist
Error Number : 1146
Date : Sunday, August 6th 2006 @ 12:01:44 AM
Classname : vb_database

Can you help please?

TS2 is running in a different db on the same server. Data is correct.

[Gryphon]

Did you do step 4 and create the table?

I have a new version in the works that will make that table not needed. I should have it available next week.

[jluerken]

I made step 4 and now its working.

The picture on the right side is not showing up and I found something nice.
I had an admin and he created an ts account. He got SA as normal.
Now I made him a normal user but he has still SA on the TS Server.

There should be a job in the sheduled task area that checks such things.

Maybe you can keep this in mind for your next version

In the admincp I get the following error message:

PHP Code:

Fatal error: Call to undefined function: rpm_print_stop_back() in /path/forum/admincp/vbteamspeak.php on line 30 


[rouven]

go to line 30 in admincp/vbteamspeak.php

change:
rpm_print_stop_back("You don't have permission to access this page.");

to:
print_cp_no_permission();

cheers

[jluerken]

This is not working rouven. It removes the error message but still my normal admins do not have access to this page.
It seems that only superadmins have that permission but normal admins not.

[Gryphon]

Currently only superadmins are allowed to access it, I have changed that in the next version.

For the image, put ts2/teamspeak_help.gif in the misc folder for any custom style you have.

For SA they need to drop/join for it to take effect, I can probably make the change take effect immediately, but it will only work if you have the tcp query port available, otherwise it is not possible.