Anleitung: Serendipity einbetten

Autor: Martin Gürtel

Zum Einbetten von Serendipity gibt es bereits zwei englischsprachige Tutorials: http://www.s9y.org/55.html und http://www.s9y.org/123.html. Mit diesen kam ich allerdings nicht gut zurecht (kann auch an meinen Englisch-Kenntnissen liegen), und so habe ich meine eigene Lösung gefunden, die unter Umständen nicht ganz dem entspricht, was die Entwickler vorsehen. Aber sie ist einfach umzusetzen und funktioniert.

Als erstes sollte man S9Y konfigurieren (dazu muss es natürlich bereits lauffähig installiert sein):

Konfiguration von Serendipity

Die drei folgenden Einstellungen sind nötig:

Administration - Konfiguration - Pfade

Index-Datei: wrapper.php (Name des Wrapper-Files [2], siehe dort)

Administration - Konfiguration - Design und Optionen

Eingebettete Nutzung von Serendipity aktivieren? JA

GZIP-Kompression verwenden NEIN

Dann benötigt ein

"Container-File" [1]

Diese Datei enhält den HTML- und/oder PHP-Code, der den S9Y-Block umgeben soll, z. B. mit Menü, Seitenkopf und -fuß etc. Das sollte eine komplett eigenständig darstellbare Seite sein. Wenn du S9Y irgendwo einbetten willst, existiert sie vermutlich schon. Ich nenne sie mal container.php.

Sie enthält an der richtigen Stelle (dort, wo S9Y erscheinen soll, am besten innerhalb eines <div>-Blocks) folgenden Code:

<?php
echo $serendipity_contents; // S9Y-Inhalt ausgeben
?>

Bis jetzt hat die obige Variable $serendipity_contents keinen Inhalt. Den erhält sie im

Wrapper-File [2]

Das Wrapper-File (im Beispiel wrapper.php muss im Ordner mit der S9Y-Installation liegen, normalerweise in /serendipity.

Die Datei enhält nichts außer folgendem PHP-Code:

<?php
  ob_start();
  require("index.php");        // Die S9Y-Startseite
  $serendipity_contents = ob_get_contents();
  ob_end_clean();
  require("../container.php");    // Das Container-File [1]
?>

Alle Pfadangaben absolut zum Server-Rootverzeichnis oder relativ zum Verzeichnis mit der S9Y-Installation angeben.

WICHTIGER HINWEIS:

wrapper.php muss als Startseite verwendet werden, notfalls in der index.html eine automatische Weiterleitung auf http://www.domain.tld/serendipity/wrapper.php einrichten!

S9Y gibt nur den reinen HTML-Code aus, der mit CSS beliebig gestylt werden kann - am besten verwendet man als Basis die CSS-Datei eines fertigen Templates.