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]

No, they can be on separate systems. You need remote access to the database on the TeamSpeak system however.

[jluerken]

Hi Gryphon,

I found a big logic bug in your hack and I hope you can write an update.

Background:
I am running a Teamspeak Server with 3 Virtual Servers (3 different Ports).
The Teamspeak Server is using its own Database.
I've installed two vBulletin Systems now on the Webserver and both vB Installations have
gTeamspeak installed.

Now the problem:
If you have a user called "test" with the id1 on both Servers you cannot delete it for only one.
Also the MANAGE USERS option in the AdminCP shows all users in the database but it should only show Users which use this gTeamSpeak installation, otherwise it could happen that Admins delete or ban the wrong users.

Possible solution:
gTeamSpeak should internally use the following system to store user information:
<username>.<boardid>.<serverport>

All User manage options should then show and use only users where the port matches the one entered in the gteamspeak settings.

I hope you got the problem?
I never thought about this but now where I have this setup I think this could be critial.

Kind regards
jluerken

[jluerken]

Update:

Hi Gryphon,

you should update the product .xml file

<template name="gts_vbnav_navbarlink" templatetype="template" date="0" username="Gryphon" version="1.00"><![CDATA[<td class="vbmenu_control"><a href="gteamspeak.php$session[sessionurl_q]">$vbphrase[gts_vbnav]</a></td>]]></template>
		<template name="gts_vbnav_quicklink" templatetype="template" date="0" username="Gryphon" version="1.00"><![CDATA[<tr><td class="vbmenu_option"><a href="gteamspeak.php$session[sessionurl_q]">$vbphrase[gts_vbnav]</a></td></tr>]]></template>

should be

<template name="gts_vbnav_navbarlink" templatetype="template" date="0" username="Gryphon" version="1.00"><![CDATA[<td class="vbmenu_control"><a href="$vboptions[bburl]/gteamspeak.php$session[sessionurl_q]">$vbphrase[gts_vbnav]</a></td>]]></template>
		<template name="gts_vbnav_quicklink" templatetype="template" date="0" username="Gryphon" version="1.00"><![CDATA[<tr><td class="vbmenu_option"><a href="$vboptions[bburl]/gteamspeak.php$session[sessionurl_q]">$vbphrase[gts_vbnav]</a></td></tr>]]></template>

Kind regards
jluerken

[Gryphon]

Originally Posted by jluerken

Hi Gryphon,

I found a big logic bug in your hack and I hope you can write an update.

Yeah, I have know about this. The script was never intended to work across multiple boards using the same TeamSpeak database. I really want to just rewrite the entire script.

Originally Posted by jluerken

Update:

Hi Gryphon,

you should update the product .xml file

Thank you. However absolute urls are not standard coding practice for vBulletin templates. As well, I despise absolute urls as it hinders portability and boards with parked domains.

[boxerman]

will this work with 3.7 beta 5?

[Gryphon]

Originally Posted by boxerman

will this work with 3.7 beta 5?

Yes

[shcchief]

nice mod, but yep i'm another user that has multiple boards therefore cannot use it.

will check back in the future for an update.

Thanks.

[socom0810]

i went in the config.php and changed it to 1 and 6 but still when i click plugins that command prompt it says super.admin and a pass but thats not my user nam or my pass where do i enter that at?

[PlymWS]

I have a slight problem with this hack.

I have my TS server running with a MySQL Db fine. The tables are present and when I use the hack to create a user the data is inserted correctly into the tables.

However when I try and connect to the server through the TS client I get a Bad Login error from the client.

If I login using the default admin or superadmin details that were created by TS I log in fine, so the server is running as it should.

It appears that only the plain text stored passwords ( i.e. the ones generated by this hack ) are the ones that can't connect.

I'm using MySQL 5 . Any help on this would be much appreciated as this will be very useful for my forum.

[Gryphon]

@socom0810 I am unsure why it would not be working for just your board.

@PlymWS TeamSpeak only uses plain text passwords, this mod does not do anything differently. First thing that pops to mind is really make sure both are accessing the same database, make sure TS didn't somehow default back to sqlite. I am not sure how mySQL 5 interacts with the script, I don't imagine there should be any issue. If you create a user view the TS client, does that user appear in the database?