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]

I see, what I added will not do that. I may look into doing what you are asking, however I am unsure how soon I can do that.

[JokeAss]

Nice plugin!

But why is it that you need it to switch to MySQL? o_O

It should be possible to do all this via the TCP interface.

[mjdnet]

Not sure if I have made an install mistake but I cannot access this and do not see the Navbar entry? I have selected the Navbar and quick link entry but neither show. If I add the gteamspeak.php path manually I get a message that I am not authorised to view this,,,

Any help?

[Gryphon]

Originally Posted by mjdnet

Not sure if I have made an install mistake but I cannot access this and do not see the Navbar entry? I have selected the Navbar and quick link entry but neither show. If I add the gteamspeak.php path manually I get a message that I am not authorised to view this,,,

Any help?

The navbar and quicklink entries are style dependant, if there are any modifications to the style they probably won't get added properly.

When going to gteamspeak.php and you get the message that you are not authorized to view, you need to setup the usergroup access permissions and custom profilefield, though, admin should be enabled by default.

There isn't really much I can do to help without knowing how your board is setup or what you did to setup the mod, just make sure you go over all instructions and settings carefully, this mod isn't plug n' play, it takes some setup time.

[Iratus]

Hi Gryphon,

Great mod but I'm having the PHP 5 / MySQL 5 compatability issue where you enter your password to create the account but it just refreshes the screen and never proceeds (and doesn't create the table entry)

I have Teamspeak working just dandy on SQL and so I know that's not the problem so I'm wondering if it's a PHP compatability issue. Any chance you can point me at where the user creation section of the script is, I'm going to have a crack at fixing it but am having a blonde moment and can't see it.

Cheers,

Iratus

[jluerken]

Hi Iratus,

can you please do the following?
Empty the server.log file, start your server and try to manage it via this mod.
Wait for the error and then post the content of your server.log file here?

/jluerken

[Iratus]

It isn't erroring in the TS log, that's what's making me think that it's some type of PHP error, IE it's never getting as far as the SQL

---------------------------------------------------------------
-------------- log started at 26-11-07 10:44 -------------
---------------------------------------------------------------
26-11-07 10:44:23,ALL,Info,server, Server init initialized
26-11-07 10:44:23,ALL,Info,server, Server version: 2.0.24.1 Linux
26-11-07 10:44:24,ALL,Info,server, Starting VirtualServer id:1 with port:8767
26-11-07 10:44:24,ALL,Info,server, Started VirtualServer id:1 with port:8767
26-11-07 10:44:25,ALL,Info,server, Server init finished
26-11-07 10:44:25,WARNING,Info,server, TeamSpeak Server daemon activated

and just for congruity to show I'm hooking into sql properly

[Main Config]
BoundToIp1=
ExternalIPDectection=1
HTTPServer Port=14534
HTTPServer Enabled=1
DateTimeFormat=dd-mm-yyyy hh:nn:ss
TCPQueryPort=51234
AllowedClientNameChars=
DisAllowedClientNameChars=()[]{}

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

[debug]
MessageTypes=LMTALL
MessageDepths=LMDALL

[WebPost]
AdminEmail=na
ISPLinkURL=na
ISPName=Private
ISPCountryNumber=5317
Enabled=1
PostURL=
ListPublic=0
UserAgent=teamspeak

[log]
access_r=0
access_u=0
channel_registerred=0
channel_unregisterred=0
sa=0
chat=0
kick_server=0
kick_channel=0

[Spam]
max_commands=10
in_seconds=2

Just for reference

PHP Version 5.2.3
Apache 2.2.3
MySQL 5.0.27
(So typical of Linux that staying on top of security updates has screwed me )

I was taking Gryphons advice that he wouldn't support it to a seperate database so I could have a problem with the connection but as it uses the same login details as TS itself I can't see where the problem is. Shall I just try connecting it to my VBulletin Database and creating the tables there and see if that works? I was trying to avoid it because I'd have to do the password compatibility change on the VBulletin dba account.

[Gryphon]

I am not positive of the differences in PHP 4/5 and MySQL 4/5 so unfortunately I can not help much in that regard. I am unsure why this would be happening and it will require that someone who does know help answer this and I will implement a possible compatibility fix if needed.

[Brandje]

In installed this on my TS server that was allready running a Mysqldb, and it works like a charm! thanks for the great mod!

Ohw, and I am using php5/mysql5, and found no errors what so ever

[xTerMn8R]

Will this hack work if I'm connecting to MYSQL using dbxODBC instead of dbxmda which costs 70-150 bucks. My 30 days just ran out and I see on goteamspeak they have alternative methods of connecting TS to MySQL using odbc.

Thanks,
xTerMn8R
www.superskunkracing.org