Technische Dokumentation Hier finden Sie die technische Dokumentation für die Einbindung des Bestseller-Widgets. Die Dokumentation soll als Hilfestellung dienen und kann keinen Anspruch auf Vollständigkeit erheben. Schritt 1 Download Die aktuelle Version des SPIEGEL-Bestseller-Widgets können Sie auf unserer Website unter Entwicklertools herunterladen. Hinweis: Um das Widget in Ihr Shopsystem einzubinden, sollten Sie alle serverseitigen Skriptsprachen beherrschen. Schritt 2 Dateien entpacken Der Download beinhaltet folgende Dateien: Entpacken Sie diese vorläufig auf Ihrem lokalen Laufwerk (z.b. Desktop). Verschieben Sie nun den Ordner script auf Ihren Desktop. Dieser Ordner braucht nicht auf dem Server abgespeichert zu werden, da die Inhalte später in bestehende Shopdateien eingebunden werden. Hinweis: Um die Datei zu entpacken, können Sie z.b. Winrar benutzen.
Schritt 3 Dateien auf dem Server ablegen Kopieren Sie nun den Widget-Ordner auf den gewünschten Server. Sie verfügen jetzt über alle notwendigen Dateien um das Widget in Ihrem Shop korrekt einzubinden. Schritt 4 widget.php einbinden Um auf die Funktionen des Widgets zugreifen zu können, muss die widget.php in ihr System eingebunden werden. Dies kann an beliebiger Stelle vor der Einbindung des Codes aus den Dateien full.tpl und/oder small.tpl geschehen. Dazu kopieren Sie den folgenden code an die passende Stelle: require_once./widget/php/widget.php ; Hier müssen Sie den relativen Pfad zu der Datei widget.php angeben.
Schritt 5 Großes Widget in das Shopsystem einbinden Öffnen Sie die lokal gespeicherte full.tpl. Hier kopieren Sie den gesamten Inhalt. <!-- #### BESTSELLER WIDGET FULL START #### -->... <!-- #### BESTSELLER WIDGET FULL ENDE #### --> Dieses können Sie nun an der gewünschten Stelle in Ihrem Shopsystem einbinden. In den meisten Fällen wird für die SPIEGEL-Bestseller-Liste eine gesonderte Unterseite angelegt. Folgender Code aus der full.tpl muss nun an Ihr Shopsystem angepasst werden: Pfad zur CSS Datei anpassen: <link rel= stylesheet type= text/css href= http://www.ihrshop.de/widget/css/style.css media= all /> An dieser Stelle muss der Pfad zu Ihrer CSS-Datei angegeben werden. URL ihres XML-Feeds anpassen (vorhandene URL ist der Testfeed) define( FEEDURL, http://www.buchreport.de/feed.php?id=100 ); An dieser Stelle müssen nach Vertragsabschluss die von buchreport zur Verfügung gestellte URL für Ihren XML-Feed einbinden. Pfad zu den Bildern anpassen define( IMAGEPATH, http://www.ihr-shop.de/widget/bilder/ ); Hier müssen Sie den Pfad angeben, an dem Sie die den Ordner bilder abgelegt haben. Pfad zum Artikel anpassen $sbestsellerarticlepath = PFAD ZUM ARTIKEL ; Hier müssen Sie den Pfad angeben, der auf die Detailansicht des Artikels linkt. Da dieser Pfad auf jedem Shopsystem verschieden sein kann, muss er manuell angepasst werden. Um variable Inhalte, wie ISBN oder Titel des Artikels, anzupassen, könnten Sie die im Script genutzten Variablen verwenden. Pfad zum Warenkorb anpassen $sbestsellerbasketpath = PFAD ZUM WARENKORB ; Hier müssen Sie den Pfad angeben, der den Artikel in den Warenkorb legt. Auch dieser Pfad ist auf jedem Shopsystem verschieden und muss manuell angepasst werden. Um variable Inhalte, wie ISBN oder Titel des Artikels, anzupassen, könnten Sie die im Script genutzten Variablen verwenden.
Schritt 6 Kleines Widget in das Shopsystem einbinden Öffnen Sie die lokal gespeicherte small.tpl. Hier kopieren Sie den gesamten Inhalt. small.tpl <!-- #### BESTSELLER WIDGET SMALL START #### -->... <!-- #### BESTSELLER WIDGET SMALL ENDE #### --> Dieses können Sie nun an der gewünschten Stelle in Ihrem Shopsystem einbinden. In den meisten Fällen wird die kleine Ausführung des Widgets in der Sidebar eingbunden. Folgender Code aus der small.tpl muss nun an Ihr Shopsystem angepasst werden: Pfad zur CSS Datei anpassen <link rel= stylesheet type= text/css href= http://www.ihrshop.de/widget/css/style.css media= all /> An dieser Stelle muss der Pfad zu Ihrer CSS-Datei angegeben werden. URL ihres XML-Feeds anpassen (vorhandene URL ist der Testfeed) define( FEEDURL, http://www.buchreport.de/feed.php?id=100 ); An dieser Stelle müssen nach Vertragsabschluss die von buchreport zur Verfügung gestellte URL für Ihren XML-Feed einbinden. Pfad zu den Bildern anpassen define( IMAGEPATH, http://www.ihr-shop.de/widget/bilder/ ); Hier müssen Sie den Pfad angeben, an dem Sie die den Ordner bilder abgelegt haben. URL zu dem großen Widget define( FULLWIDGETPATH, http://www.ihr-shop.de/grosses-widget.htm ); Hier müssen Sie den Link angeben, der auf das große Widget zeigt. Dies ist für das Zusammenspiel zwischen dem kleinen und großen Widget notwendig. Pfad zum Artikel anpassen $sbestsellerarticlepath = PFAD ZUM ARTIKEL ; Hier müssen Sie den Pfad angeben, der auf die Detailansicht des Artikel linkt. Da dieser Pfad auf jedem Shopsystem verschieden sein kann, muss er manuell angepasst werden. Um variable Inhalte, wie ISBN oder Titel des Artikels, anzupassen, könnten Sie die im Script genutzten Variablen verwenden.
Schritt 7 Hinweis für die verschiedenen Shopsysteme An der Stelle an der der Code aus den Dateien full.tpl und small.tpl eingebunden wird, muss sichergestellt werden, dass dort PHP interpretiert werden kann. Viele Shopsysteme nutzen eine eigene Template-Engine, in der PHP Code unter anderen Voraussetzungen interpretiert wird. In diesem Fall muss die Syntax des Codes angepasst werden. Beispiel Normaler PHP Code: <?php...?> Sonderfall Template-Engines: [php]... [/php] oder [{php}]... [{/php}]