1. Einleitung Diese Handbuch wendet sich Betreiber einer Web-Pr\u00e4senz, die Teile der Schlagzeilen von nightloop.de in das eigene Angebot \u00fcbernehmen wollen. Es wendet sich sowohl an erfahrene Programmierer als auch an Webbetreiber mit geringeren Kenntnissen \u00fcber die Programmeirung dynamischer Webseiten.<\/p>\n Die wichtigsten Abk\u00fcrzungen und Begriffe werden am Schluss dieses Handbuchs in einem Glossar erl\u00e4utert. Verweise auf dieses Glossar werden im Text mit \u201e\uf061\u201c gekennzeichnet.<\/p>\n Das nightloop.de-Interface ist weitestgehend programmiersprachen-unabh\u00e4ngig und kann mit jeder Programmiersprache genutzt werden, die \uf061 HTTP und\/oder \uf061 SOAP unterst\u00fctzt. Die HTTP-Unterst\u00fctzung ist in den meisten Programmiersprachen bereits implementiert, die SOAP-Unterst\u00fctzung wird, wenn nicht vorhanden, h\u00e4ufig von externen Bibliotheken zur Verf\u00fcgung gestellt. Die eingesetzten Softwareprodukte sollten mindestens in den angebenenn Versionsnummern installiert sein.<\/p>\n Auch wenn Sie sich nicht in die Tiefen von PHP, Perl und HTML begeben wollen, ist es Ihnen m\u00f6glich, die Schlagzeilen von nightloop.de in Ihre Web.Pr\u00e4senz zu integrieren. Die anzuzeigende Kategorie. Es kann nur eine Kategorie ausgew\u00e4hlt werden.<\/p>\n Anzahl der h\u00f6chstens dargestellten Schlagzeilen. Die Schlagzeilen werden in absteigender chronologischer Reihenfolge dargestellt.<\/p>\n Farbe der Titelzeile (\u201enightloop.de\u201c). Diese Farbe sollte sich gut vom Hintergrund abheben.<\/p>\n Farbe des Hintergrundes der Titelzeie. Diese Farbe sollte sich vom der Farbe der Titelzeile abheben.<\/p>\n Farbe des Textes der Schlagzeilen. Diese Farbe sollte sich gut vom Hintergrund abheben.<\/p>\n Farbe des Hintergrundes der Schlagzeile. Diese Farbe sollte sich gut vom Text abheben.<\/p>\n Farbe eines Links, der vom Benutzer noch nicht angew\u00e4hlt wurde.<\/p>\n Farbe des Links, den der Benutzer momentan anw\u00e4hlt.<\/p>\n Farbe eines Links, den der Benutzer bereits angew\u00e4hlt hat.<\/p>\n Farbe des Tabellenrandes.<\/p>\n St\u00e4rke des Tabellenrandes in Pixel. Der Tabellenrand umschlie\u00dft die gesamte Tabelle und unterteilt die Schlagzeilen.<\/p>\n Der Text der Schlagzeilen kann linksb\u00fcndig, rechtsb\u00fcndig oder zentriert ausgerichtet werden.<\/p>\n Programmiersprache, f\u00fcr die das Programmskript erstellt werden soll. Zur Zeit stehen die Sprachen PHP und Perl zur Verf\u00fcgung.<\/p>\n Die Schlagzeilen von nightloop.de k\u00f6nnen auf verschiedene Weise \u00fcberrtagen werden. Die Daten k\u00f6nnen entweder \u00fcber eine URL vom Server abgefragt werden, oder es kann ein SOAP-Interface genutzt werden. Die R\u00fcckgabe der Daten erfolgt im \uf061 XML- oder \uf061 RDF Format. Das \uf061 RSS-Format wird noch nicht unterst\u00fctzt. Bei beiden Arten der Datenanforderung \u00fcber eine URL oder SOAP werden die gleichen Parameter zur Definition der gew\u00fcnschten Daten benutzt. Es stehen foglende Parameter zur Verf\u00fcgung: Die Daten k\u00f6nnen \u00fcber die URL \u201ehttp:\/\/www.nightloop.de\/backend.php<\/a>\u201c mit Angabe der gew\u00fcnschten Parameter vom Server angefordert werden. Die Parameter werden von der Adress durch eine Fragezeichen getrennt, die einzelnen Parameter untereinander wiederum durch ein \u201e&\u201c (\u201eAmpersand\u201c, \u201eKaufmanns-Und\u201c).<\/p>\n Im folgenden Beispiel werden aus der Kategorie \u201emagazin_stars\u201c elf Schlagzeilen im RDF-Format angefordert:<\/p>\n http:\/\/www.nightloop.de\/backend.php?cat=magazin_stars&items=11&format=rdf<\/a><\/p>\n Die Gro\u00df- und Kleinschreibung und die Reihenfolge der Parameter ist nicht relevant. Wird diese Zeile aus einem Programm oder einem Browser an den Server geschickt, sendet dieser ein XML\/RDF-Dokument mit den angeforderten Daten zur\u00fcck. Die Datenanforderung \u00fcber ein SOAP-Interface unterscheidet sich bei den verschiedenen prorammiersprachen stark. Aus diesem Grund wird in diesem Handbuch beispielhaft f\u00fcr die Sprachen PHP und Perl vorgestellt.<\/p>\n F\u00fcr die Programmierung eines SOAP-Interfaces f\u00fcr PHP gibt es eine Reiher verschiedener Bibliotheken. Eine einfache, objektorientierte Variante ist \u201enusoap\u201c (\u201ehttp:\/\/dietrich.ganx4.com\/nusoap<\/a>\u201c). Im folgenden Beispiel werden aus der Kategorie \u201emagazin_stars\u201c zehn Schlagzeilen im RDF-Format angefordert.<\/p>\n F\u00fcr Perl gibt es verschiedene Implementierungen f\u00fcr des SOAP-Protokolls. Die am h\u00e4ufigsten verwendete und am einfachsten einzusetzende Bibliothek ist \u201eSOAP::Lite\u201c, die unter anderem \u00fcber das CPAN-Netzwerk zu beziehen ist (http:\/\/cpan.org<\/a>\u201c). Erl\u00e4uterungen:<\/p>\n Das XML-Format hat folgende Struktur:<\/p>\n Darstellung als Quellcode (variable Werte sind als \u201e…\u201c angegeben):<\/p>\n
\n1.1 Zielgruppe<\/span>
\n1.2 Glossar<\/span>
\n2. Technische Vorraussetzungen
\n2.1 Vorraussetzungen f\u00fcr den Einsatz der Beispielprogramme<\/span>
\n2.1.1 PHP<\/span>
\n2.1.2 Perl<\/span>
\n3. Das Web-Interface
\n3.1 Allgemeines<\/span>
\n3.2 Bedeutung der Elemente<\/span>
\n3.2.1 Kategorie<\/span>
\n3.2.2 Anzahl der Schlagzeilen<\/span>
\n3.2.3 Titel<\/span>
\n3.2.4 Titelhintergrund<\/span>
\n3.2.5 Text<\/span>
\n3.2.6 Hintergrund<\/span>
\n3.2.7 Neuer Link<\/span>
\n3.2.8 Hover Link<\/span>
\n3.2.9 Besuchter Link<\/span>
\n3.2.10 Tabellenrand<\/span>
\n3.2.11 St\u00e4rke Tabellenrandes<\/span>
\n3.2.12 Textausrichtung<\/span>
\n3.2.13 Sprachen<\/span>
\n4. Die Schnittstellen
\n4.1 Grundlagen<\/span>
\n4.2 Daten anfordern<\/span>
\n4.2.1 Datenanforderung \u00fcber eine URL<\/span>
\n4.2.2 Datenanforderung \u00fcber ein SOAP-Interface<\/span>
\n4.2.2.1. PHP<\/span>
\n4.2.2.2. Perl<\/span>
\n4.3 Daten verarbeiten<\/span>
\n4.3.1 Das XML-Format<\/span>
\n4.3.2 Das RDF-Format<\/span>
\n4.4 Das nightloop-Tool f\u00fcr Perl und PHP<\/span>
\n4.4.1 Perl<\/span>
\n4.4.2 PHP<\/span>
\n5. Glossar<\/p>\n1. Einleitung<\/h1>\n
1.1 Zielgruppe<\/h2>\n
1.2 Glossar<\/h2>\n
2. Technische Vorraussetzungen<\/h2>\n
\nSoll eines der mitgelieferten Beispiele genutzt werden, so muss Ihr Webserver entweder PHP ab der Version 4.3.0 mit \uf061 DOM-Unterst\u00fctzung oder Perl ab der Version 5.8.0 unterst\u00fctzen. Sie m\u00fcssen au\u00dferdem die Berechtigung besitzen, auf Ihrem Webserver Skripte ausf\u00fchren zu d\u00fcrfen.
\nSollten Sie sich nicht sicher sein, ob diese Vorraussetzungen auf Ihrem Server gegeben sind, so wenden Sie sich bitte an Ihren Administrator oder Provider.<\/p>\n2.1 Vorraussetzungen f\u00fcr den Einsatz der Beispielprogramme<\/h2>\n
2.1.1 PHP<\/h3>\n
\n
2.1.2 Perl<\/h3>\n
\n
3. Das Web-Interface<\/h1>\n
3.1 Allgemeines<\/h2>\n
\nMit Hilfe der webbasierten Benutzerschnittstelle k\u00f6nnen Sie alle notwendigen Parameter f\u00fcr eine individuelle Darstellung des nightloop.Panels einstellen.
\nDie Farben k\u00f6nnen direkt eingegeben werden (z.B. \u201e#000000\u201c oder \u201eblack\u201c) oder aber aus einem Men\u00fc (\u201eColor Chooser\u201c) ausgew\u00e4hlt werden. Dazu m\u00fcssen Sie hinter dem gew\u00fcnschten Element auf den Knopf \u201eFarben\u201c dr\u00fccken. Daraufhin \u00f6ffnet sich ein weiteres Fenster, das Ihnen eine Auswahl der Farben anbietet. Klicken Sie auf einer dieser Farben so schlie\u00dft sich das fenster, der Wert der Farbe wird in das entsprechende Feld eingetragen und die Beispieltabelle auf der rechten Seite passt sich den neuen Parametern an.<\/p>\n3.2 Bedeutung der Elemente<\/h2>\n
3.2.1 Kategorie<\/h3>\n
3.2.2 Anzahl der Schlagzeilen<\/h3>\n
3.2.3 Titel<\/h3>\n
3.2.4 Titelhintergrund<\/h3>\n
3.2.5 Text<\/h3>\n
3.2.6 Hintergrund<\/h3>\n
3.2.7 Neuer Link<\/h3>\n
3.2.8 Hover Link<\/h3>\n
3.2.9 Besuchter Link<\/h3>\n
3.2.10 Tabellenrand<\/h3>\n
3.2.11 St\u00e4rke Tabellenrandes<\/h3>\n
3.2.12 Textausrichtung<\/h3>\n
3.2.13 Sprachen<\/h3>\n
4. Die Schnittstellen<\/h1>\n
4.1 Grundlagen<\/h2>\n
\nWelches Format soll ich benutzen?
\nWenn Sie einen Client speziell f\u00fcr nightloop.de schreiben, ist das XML-Format einfacher zu implementieren. Soll der Client allerdings auch f\u00fcr andere Datenquellen genutzt werden, so ist das RDF-Format flexibler.<\/p>\n4.2 Daten anfordern<\/h2>\n
\ncat (Defaultwert: keiner)
\nDieser Parameter bestimmt die Kategorie, aus der die Schlagzeilen ausgew\u00e4hlt werden. Es muss genau eine Kategorie angegeben werden, bei der Angabe mehrerer Kategorien wird nur die erste Angabe ausgewertet. Das Fehlen dieses Parameters erzeugt eine Fehlermeldung.
\nitems (Defaultwert: 10)
\nDieser Parameter bestimmt die Anzahl der zu \u00fcbertragenden Schlagzeilen. Sind weniger Schlagzeilen als angefordert vorhande, so werden ohne Fehlermeldung alle vorhandenen Schlagzeilen \u00fcbertragen. Wird kein Wert angegeben, so werden maximal zehn Schlagzeilen \u00fcbertragen. Die Angabe eines Wertes kleiner Null oder eines nicht-numerischen Wertes erzeugt keine Fehlermeldung.
\nformat (Defaultwert: XML)
\nDieser Parameter bestimmt das Format, mit dem die Daten \u00fcbertragen werden. Wird kein Wert oder ein anderer Wert als \u201eRDF\u201c \u00fcbergeben, so werden die Daten im \u21d2 propriet\u00e4rem XML-Format \u00fcbertragen. Das Format der Daten wird in Kapitel XXX und XXX erl\u00e4utert.<\/p>\n4.2.1 Datenanforderung \u00fcber eine URL<\/h3>\n
\nDiese Art der Datenanforderung ist sprachenunabh\u00e4ngig und kann mit jeder mordernenProgrammeirsprache verwendet werden. <\/p>\n4.2.2 Datenanforderung \u00fcber ein SOAP-Interface<\/h3>\n
4.2.2.1. PHP<\/h4>\n
\r\n# URL des Nightloop-SOAP-Backends.\r\n$url = \"http:\/\/www.nightloop.de\/backend_soap.php<\/a>\";\r\n\r\n# Wir brauchen das SOAP-Modul\r\nrequire_once(\"include\/nusoap.php\");\r\n\r\n# einen neuen Client erzeugen und mit dem SOAP-backend verbinden.\r\n$soap_client = new soapclient($url);\r\n\r\n# Die notwendigen Parameter erstellen\r\n$parameters = array(\"cat\"=>\u201cmagazin_stars\u201c, \"items\"=>10);\r\n\r\n# Den SOAP-Server abfragen und den XML-String zurueckgeben.\r\n$xml $soap_client->call('backend', $parameters);\r\n<\/pre>\n
\nErl\u00e4uterungen:<\/em><\/p>\n
\nDie Variable $url beinhaltet die Internetadresse des Programms, das f\u00fcr die Erstellung des XML-Dokuments \u00fcber SOAP zust\u00e4ndig ist.\n<\/li>\n
\nDas nusoap-Modul wird in das Programm eingebunden.\n<\/li>\n
\nEs wird ein neues SOAP-Client-Objekt erzeugt.\n<\/li>\n
\nIn der Variablen $parameters werden die Parameter angegeben, die an den Server \u00fcbertragen weredn sollen. Der Parameter format wurde nicht angegeben, so das der Server maximal zehn Schlagzeile zur\u00fcckgeben wird.\n<\/li>\n
\nDie Anfrage wird mit den vorher definierten parametern an den Server \u00fcbergeben. Gleichzeitig wird die R\u00fcckgabe des Servers in der Variablen $xml gespeichert und kann anschlie\u00dfend weiterverarbeitet werden.\n<\/li>\n<\/ul>\n4.2.2.2. Perl<\/h4>\n
\nIm folgenden Beispiel werden aus der Kategorie \u201emagazin_stars\u201c elf Schlagzeilen im XML-Format angefordert.<\/p>\n\r\nuse SOAP::Lite; # Das notwendige SOAP-Modul einbinden.\r\n\r\n# URI des SOAP-Backend-Skriptes\r\n$url = \"http:\/\/www.nightloop.de\/backend_soap.php<\/a>\";\r\n\r\n# Das SOAP-Modul mit den entprechenden Parametern aufrufen und das\r\n# XML Dokument als String an den Aufrufer zurueckgeben.\r\n$xml = SOAP::Lite\r\n -> uri('http:\/\/nightloop.de\/Backend\/<\/a>')\r\n -> proxy($url)\r\n -> backend('magazin_stars', 11)\r\n -> result;\r\n<\/pre>\n
\n
\nDas SOAP::Lite-Modul wird in das Programm eingebunden.\n<\/li>\n
\nDie Variable $url beinhaltet die Internetadresse des Programms, das f\u00fcr die Erstellung des XML-Dokuments \u00fcber SOAP zust\u00e4ndig ist.\n<\/li>\n
\nDem SOAP::Lite-Objekt werden die Parameter \u00fcbergeben und es \u00fcbergibt die SOAP-Anforderung an den Server. Gleichzeitig wird die R\u00fcckgabe des Servers in der Variablen $xml gespeichert und kann anschlie\u00dfend weiterverarbeitet werden.\n<\/li>\n<\/ul>\n4.3 Daten verarbeiten<\/h2>\n
4.3.1 Das XML-Format<\/h3>\n
\r\nhttp:\/\/www.w3.org\/1999\/02\/22-rdf-syntax-ns#<\/a>\" xmlns:dc=\"http:\/\/purl.org\/dc\/elements\/1.1\/<\/a>\">\r\n