Willkommen
Mit dem
Windows Live Messenger Web Toolkit können Sie einen
Windows Live
Messenger und verschiedene Windows Live-Funktionen besonders einfach in Ihre
Webseite integrieren.
Installation und Konfiguration für PHP 5 sind kinderleicht - wenn man ein paar Dinge
bereits weiß. Daher haben wir es uns mit dieser Webseite zum Ziel gemacht, PHP-Nutzern
die Integration mit einem Plugin noch weiter zu erleichtern.
Wir werden Sie mit zwei Tutorials sicher durch Installation und Konfiguration des
Plugins führen. Dabei setzen wir lediglich voraus, dass Sie Grund-Kenntnisse in HTML
und eine
Windows Live ID
haben.
Sehen Sie sich doch zunächst ein
Anwendungs-Video an:
Anwendungs-Video
Tutorial 1: Installation
Dieses Tutorial soll Sie sicher durch die Installation des Windows Live Messenger
Web Toolkit-Plugins führen.
Dabei setzen wir lediglich Grund-Kenntnisse in HTML voraus!
Voraussetzungen
Applikation installieren
Laden Sie
diesen Zip-Ordner herunter und entpacken Sie ihn in den
Ordner, in dem auch die HTML-Datei liegt, in die das Web Toolkit integriert werden
soll.
Verschieben Sie die Datei
wlmwt/refreshmessengertoken.php ein Verzeichnis nach
oben - also ebenfalls in den Ordner, in dem die HTML-Datei liegt.
Applikation registrieren
Für jede Domain, auf der Sie das Messenger Web Toolkit verwenden möchten,
benötigen Sie jeweils eine
Application ID.
Öffnen Sie das
Azure Services Developer Portal.
Hier können Sie
eine neue Applikation anlegen.
Notieren Sie sich die Projekt-Daten.
Öffnen Sie die Datei
wlmwt/conf/settings.xml und ersetzen Sie
%appid%
durch die notierte
Application ID sowie
%secret% durch den notierten
Secret Key. Speichern Sie die Datei. (Sollte Ihnen das Speichern verweigert
werden, öffnen Sie mit
Rechtsklick das Kontext-Menü, wählen Sie
Eigenschaften und entfernen Sie das Häkchen
Schreibgeschützt.)
Applikation integrieren
Nun müssen Sie nur noch ein Paar PHP-Funktionen in Ihrer HTML-Datei aufrufen, und
der Messenger ist betriebsbereit!
Ganz am Anfang Ihrer HTML-Datei -
Zeile 1, Zeichen 0 - müssen Sie das
Applikations-Plugin einbinden:
<?php include "wlmwt/plugin.php"; ?>
Ergänzen Sie das
HTML-Tag <html> mit diesem Code um ein Attribut:
<?php wlmwtInclude("html"); ?>
Im
Head ihres HTMLs müssen
Javascript- und
Stylesheet-Dateien
hinzugeladen werden. Kopieren Sie diesen Code an das Ende des Heads (direkt vor
</head>):
<?php wlmwtInclude("head"); ?>
Abschließend muss noch der XHTML-Container der Applikation eingefügt werden.
Kopieren Sie diesen Code an den Anfang des Bodys Ihres HTMLs:
<?php wlmwtInclude("body"); ?>
Stabilität testen
Nutzer können auf Ihrer Seite problemlos weitersurfen - erst beim Verlassen
Ihrer Domain wird die Session beendet:
Unterseite testen.
Tutorial 2: Integration
Dieses Tutorial zeigt Ihnen die einfache Einbindung von Windwos Live
Messenger Web Toolkit-Funktionen. Die erfolgreiche Installation aus
Tutorial 1 vorausgesetzt, können Sie die gezeigten PHP-Codes
einfach in Ihr HTML einfügen, fertig :)
Webbar integrieren
Die Webbar ist der unten am Rand dieses Fensters integrierte Messenger. Die
Webbar legt sich automatisch über Ihre Inhalte, so dass Ihre Seite nicht
beeinflusst wird und Ihre Nutzer auch im Chat browsen können.
Um die Webbar zu integrieren, kopieren Sie diesen Code an das Ende des Bodys
(direkt vor
</body>):
<?php wlmwtShow("webbar"); ?>
Anmelde-Button
Mit dem Anmelde-Button erlauben Sie Ihren Nutzern, sich im
Live
Messenger Toolkit anzumelden. Ist der Nutzer angemeldet, wird der Button
ausgeblendet:
[Ausgeblendet weil angemeldet]
<?php wlmwtShow("signin"); ?>
Display-Name
Den Display-Namen angemeldeter Benutzer erhalten Sie als Text, womit sie ihn
beleibig in Ihrem HTML einsetzen können:
<?php wlmwtShow("displayname"); ?>
Der Displayname kann onclick editierbar gemacht werden:
<msgr:display-name cid="$user" editable="true"></msgr:display-name>
Der Displayname kann mit dem Profil des Nutzers verlinkt werden:
<msgr:display-name cid="$user" linked="true"></msgr:display-name>
Ist der Nutzer nicht angemeldet, kann ein Platzhalter angezeigt werden:
<msgr:display-name cid="$user" default="Max Mustermann"></msgr:display-name>
Display-Bild
Das Display-Bild zeigt das aktuell verwendete Display-Bild im
Windows
Live Messenger und in
Windwos Live an:
<?php wlmwtShow("displaypicture"); ?>
Das Display-Bild kann in drei Größen angezeigt werden:
small,
medium und
large:
<msgr:display-picture cid="$user" size="small"></msgr:display-picture>
Das Display-Bild kann Presence-enabled werden:
<msgr:display-picture cid="$user" presence-enabled="true"></msgr:display-picture>
Status
Der Status zeigt den aktuellen Anmelde-Status des Nutzers an - in Farbe, Schrift
und - wenn der Nutzer angemeldet ist - mit Drowdown-Auswahl:
<?php wlmwtShow("status"); ?>
Personal Message
Die Personal Message angemeldeter Benutzer erhalten Sie als Text, den sie
beleibig in Ihrem HTML einsetzen können. Onclick wird er für den Nutzer
editierbar:
<?php wlmwtShow("personalmessage"); ?>
Add Contact
Der Kontakt-Hinzufügen-Button öffnet für angemeldete Benutzern ein Formular
zum Hinzufügen eines Kontaktes. Der Button wird nur angezegt, wenn der
Benutzer online ist:
<?php wlmwtShow("addcontact"); ?>
Contact-Picker
Der Contact-Picker zeigt angemeldeten Nutzern ihre Kontakte an, die gerade
online sind:
<?php wlmwtShow("contactpicker"); ?>
Contactlist
Die Kontaktliste ist ein umfangreiches Tool zur Kontakt-Auswahl und -Verwaltung.
Dem Angemeldeten Benutzer werden seine Kontakte gruppiert angezeigt - ein
vollständiges Adressbuch mit Kontext-Menü und Kontaktsuche:
<?php wlmwtShow("contactlist"); ?>
Geschützter Bereich
Sie können Inhalte dem Online-Status des Nutzers entsprechend anzeigen -
also nur wenn er angemeldet ist. So können Sie Ihre Nutzer per Anmeldung
entscheiden lassen, ob sie die Funktionen des
Messenger Web Toolkits
verwenden möchten oder nicht.
Umschließen Sie
nur nach Anmeldung anzuzeigendes HTML mit
<?php wlmwtShow("ifUserOnline"); ?> und
<?php wlmwtShow("ifEnde"); ?>