TeamSpeak online counter v 1.0 Readme
Copyright (C) 2006 Bastian Schaar (www.teamspeak-einstieg.de)

----------------------------------------------
Table of contents
----------------------------------------------

1. License
2. System requierements
3. Install instructions
4. Website integration
5. Contact information

----------------------------------------------
1. License

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA 02111-1307, USA.

----------------------------------------------
2. System requierements

To run this script you need a webserver that supports PHP scripts. To check this,
create a new txt file containing the following code:

<?php
phpinfo()
?>

Save it as "info.php" (make sure you don't save it as "info.php.txt"), upload it to your
webspace and open it in your web browser. You should get a website showing info
about your PHP configuration. If not, your server is most likely not able to run PHP scripts.

NOTE:
Some providers will not allow you to establish outgoing connections to certain ports.
If this is the case, the query port (51234) might be blocked, too. This port has to be
open for the script to work. You might be able to bypass this problem by changing
the TCP query port of your server to something common like 80 (HTTP) or 21 (FTP).
Also note that these ports may be in use if you are running other servers on your machine.

----------------------------------------------
3. Install instructions

When you are sure your server supports PHP, open useronline.php in a text editor and change
the settings there to fit your server configuration. You have to edit the following variables:

$server_address
$server_tcpport
$server_udpport

Use the language variables to translate the output into your language.

When you are done, upload the script directory to your webspace. Make sure you keep the folder structure as it is. Open useronline.php in your webbrower to check if it's working. You should get some output like "document.write('47 users online');".

----------------------------------------------
4. Website integration

Website integration only works with internet browsers that are capable of executing JavaScript. Unlike "JScript" from Microsoft, JavaScript is not really dangerous so enabling it in your browser SHOULD be safe. However I cannot guaranty that it really is :)

To view the TeamSpeak online counter on your website, you have to edit this line of code and place it somewhere in your HTML code.

<script language="JavaScript1.1" src="http://www.example.com/ts_onlinecounter/useronline.php" type="text/javascript"></script>

If the online counter is running in a subdirectory of your homepage, you might want to use a relative link instead. It would look like this:

<script language="JavaScript1.1" src="example/folders/ts_onlinecounter/useronline.php" type="text/javascript"></script>

----------------------------------------------
5. Contact information

This script is not perfect. If you encounter any bugs, especially security holes, contact me
at my website.
I think there is not much more I can add to this script, but if you think something is missing
and you want to tell me use the contact information below.

Website:	http://www.teamspeak-einstieg.de
eMail:	webmaster@teamspeak-einstieg.de