Beispiel-Einbindung des toksta* IM

Bitte beachten Sie, dass der toksta* IM nur richtig funktionieren kann, wenn Sie die Einbindung wie in dieser Anleitung beschrieben vornehmen. Falls Sie den Code temporär entfernen oder die Einbindung zu einem späteren Zeitpunkt vornehmen möchten, können Sie das komplette Skript jederzeit im Kundenbereich von toksta.com einsehen. Bei Fragen zur Einbindung stehen wir Ihnen jederzeit unter support@toksta.info zur Verfügung.

1. Schritt: Einbindung in den <BODY> Bereich

Mit dem folgenden Skript wird in einem ersten Schritt der User bei toksta* initialisiert und autorisiert. Hierzu werden Name und ID des Users übermittelt sowie optional weitere Informationen wie z.B. das Alter oder die Postleitzahl.
Bitte beachten Sie: Je mehr Informationen wir von Ihnen bekommen, desto zielgerichteter können wir Werbung einblenden. Entsprechend höher fallen demnach auch Ihre Einnahmen aus dem Revenue Share Programm aus.
Als nächstes wird ein JavaScript eingebunden, welches benötigt wird, um den User bei einer Chateinladung umgehend zu benachrichtigen (der sogenannte "ChatWatcher"). Außerdem wird ein JavaScript zum Start eines neuen Chats eingebunden.
Achtung:Das nachfolgende Skript muss in jede Seite Ihrer Community eingebunden werden, wenn der User angemeldet ist. Der User kann nur über neue Chat-Einladungen informiert werden, wenn der Chat-Watcher eingebunden ist.
Dieses Skript muss an das Ende des <BODY> Bereichs Ihres Quellcodes eingefügt werden:

<?PHP
//script for the <BODY> area of your source code, transferring necessary user data
//place this script on every page if the user is logged in !!!

$tk_name = "THE_USERNAME"; //<-- please set the username here
$tk_user_id = "THE_USER_ID"; //<-- please set the user ID here
$tk_gender = ""; //<-- optional (the gender of the user can be female or 'male')
$tk_age = ""; //<-- optional (the age of the user e.g. '23')
$tk_single = ""; //<-- optional (is the user single? 'Yes', 'no', '0' = no information)
$tk_profile_url = ""; //<-- optional (url to the users profile)
$tk_pic = ""; //<-- optional (url of the users picture)
$tk_city = ""; //<-- optional (city where the user is located, e.g. 'Berlin')
$tk_zip = ""; //<-- optional (users zip code, e.g. '92553')
$tk_country = ""; //<-- optional (country where the user is located, e.g. 'Germany')

//DO NOT EDIT THE FOLLOWING CODE!
$tk_user_data="name:".$tk_name. ";gender:".$tk_gender. ";age:".$tk_age. ";single:".$tk_single. ";url:".$tk_profile_url. ";pic:".$tk_pic. ";city:".$tk_city. ";tk_zip:".$tk_zip. ";country:".$tk_country;

//implements the js needed by the chatWatcher and to start a chat

$tk_hash = md5($tk_user_id.$tk_user_data."[[password]]");
$tk_js = "<script type='text/javascript' src='http://www.toksta.com/js/w/?tk_hash=" . $tk_hash . "&app_id=[[application_id]]&app_user_id=".$tk_user_id."&tk_user_data=".rawurlencode($tk_user_data)."'></script>" . "<script type='text/javascript' src='http://www.toksta.com/js/tokstaIm/?tk_hash=" . $tk_hash . "&app_id=[[application_id]]&app_user_id=".$tk_user_id."&tk_user_data=".rawurlencode($tk_user_data)."'></script>";
echo $tk_js;
?>

2. Schritt: Einbindung des "Chat starten" - Links in den <BODY> Bereich

Um eine Chateinladung an einen User zu versenden, muss die JavaScript Funktion tokstaChat" (mit der ID des anzuchattenden Users) aufgerufen werden.
Die "tokstaChat" Funktion wurde im <BODY> Bereich bereits initialisiert (s. Schritt 1). Der Link sollte also überall dort eingefügt werden, wo die Möglichkeit bestehen soll, einen User anzuchatten (z.B. auf dem User-Profil, der Freundesliste etc.).

<?php
$tk_chat_to_user_id = "PROFILE_USER_ID"; //Replace with user ID
$tk_link = "<a href=\"javascript:tokstaChat('" . $tk_chat_to_user_id . "')\">Chatten</a>";
echo $tk_link;
?>

Herzlichen Glückwunsch! Der toksta* Instant Messenger ist nun in Ihrer Community einsatzbereit!