Diese Bibliothek hilft bei der Benutzung der UWA-Widgets von Netvibes auf einer eigenen PHP-Seite. Sie benutzt die aktuelle IFrame Methode.
Features
- Eigenes Konfigurationsmenü möglich
- Dynamische Grössenanpassung
- Einfaches API
- Konfigurierbarer Header
Anwendung
Grundsätzlicher Einsatz
- Kopiere uwawidget.php irgendwo hin, wo es in der Applikation eingebunden werden kann.
- Kopiere proxy.html irgendwo in das Webverzeichnis. Diese Datei ist für die Kommunikation zwischen dem Widget und der Sweite zuständig.
- Im code muss die uwawidget.php Datei mit require_once eingebunden werden.
- Um ein neues uwawidget-Objekt zu erzeugen, werden folgende Infos benötigt:
- Die URL des Widgets: Man erhält sie von der UWA Ecosystems-Seite unter dem Source-Link der Detailseite des Widgets.
- Die Web-Url der proxy.html Datei.
- Erzeugen des uwawidget-Objekts: $uwawidget = new uwawidget($widgetURL, proxyHtmlUrl);.
- Nun noch das notwendige HTML auf der Seite ausgeben und man ist fertig: echo $uwawidget->getHtml();.
Eigenes Konfigurationsmenü
Der Header des Widgets mit dem Edit-Menü kann verborgen werden wenn als dritter Parameter des uwawidget-Konstruktors false übergeben wird. In diesem Falle muss ein eigenes Formular für die Konfigurationsdaten erstellt werden. Die Funktion $uwawidget->getPreferencesHtml() gibt ein Array mit label/input-HTML Paaren zurück. Die obersten Schlüssel des Arrays sind immer visible für sichtbare Elemente und hidden für versteckte Formular-Felder. In der Datei example.php id der detaillierte Gebrauch beschrieben.
Die übertragenen Formulardaten könnem mit der Funktion $uwawidget->setAndValidatePreferencesData($_POST['uwawidgetdata']) an das Widget übergeben werden. getHtml() kümmert sich um die Übertragung an das Widget.
Troubleshooting
In den Widgets gespeicherte Daten werden beim erneuten Aufruf nicht mehr geladen.
Wenn die Authentifizierung be einem Widget nicht über Cookies oder Login geschieht, kann man da leider nicht viel machen. Es sieht so aus als ob bei Netvibes das Einloggen in das Dashboard die gespeicherten Daten holt und den Widgets wieder zur Verfügung stellt. Kein Dashboard heisst also leider, dass es nur die Defaultwerte gibt.
Hilfsfunktionen
getMetaData() gibt die Metadaten des Wudgets als assoziatives Array zurück, getMetaDataHtml() gibt diese Daten schön formatiert zur Ausgabe zurück..
Weitere Hilfen
Eine Demo gibt es bei oncode.info. Diese Bibliothek wird auch im Moodle UWA Widget Block verwendet.
