Bericht: Umstellung der Homepage

Serendipity wird bei mir prinzipiell als Shared-Blog installiert. Das heißt, die erforderlichen Dateien werden an eine zentrale Stelle auf dem Webspace abgelegt. Für den Blog werden Dateien aus dem deployment-Verzeichnis genutzt, die auf die Kern-Dateien verweisen. Das spart Platz und beschleunigt das umkopieren/verschieben von Dateien erheblich.
Zuerst legte ich mir ein Verzeichnis „blog“ an und kopierte alle Dateien, die für Serendipity notwendig sind, aus dem Web-Root in das neue Verzeichnis. Auch die .htaccess und die serendipity_config_local.inc.php nicht vergessen! Nun musste ich im „blog“-Verzeichnis die .htaccess anpassen:

ErrorDocument 404 /blog/index.php
DirectoryIndex /blog/index.php

RewriteEngine On
RewriteBase /blog/

Wie man sieht, habe ich an drei stellen /blog eingefügt. Mehr musste nicht gemacht werden. Die restlichen Einträge mit den RewriteRules blieben unberührt. Als nächstes musste ich jede einzelne Serendipity-Datei öffnen und den Pfad zu einer Konfigurations-Datei anpassen. Diese ist von mir selbst erstellt worden und enthält den Pfad zu den Serendipity-Kern-Dateien. Wenn man nun den Blog über die neue URL www.example.com/blog/ aufruft, sollte man keinen Fehler bekommen. Allerdings sind noch alle Links auf den alten Blog gerichtet. Die Anpassung habe ich direkt in der Datenbank in der Tabelle s9y_config vorgenommen. "s9y_" ist übrigens der Tabellen-Prefix, der standardmäßig auf "serendipity_" steht. Um jetzt dem Blog die richtigen URLs beizubringen, müssen folgende drei Einträge geändert werden:

name	value (alt)	value (neu)
serendipityPath	/<absoluterBlogpfad>/	/<absoluterBlogpfad>/blog/
serendipityHTTPPath	/	/blog/
baseURL	http://www.example.com/	http://www.example.com/blog/

Nun war der Serendipity im Unterverzeichnis „blog“ betriebsbereit. Und auch der alte Blog verwies nun schon auf die neuen Einträge. Was aber nicht meine Intension war. Ich will meine eigenen Seiten im Web-Root ablegen. Deshalb störte der alte Blog. Und die Weiterleitungen mussten noch angelegt werden.
Dazu musste die .htaccess-Datei im Web-Root angepasst werden. Dort fügte ich einfach eine 301er-Weiterleitung ein. Nun weiß eine Suchmaschine, das ein Eintrag permanent an die neue Stelle verschoben wurde. Hier nun die .htaccess:

RewriteEngine On
RewriteBase /

RewriteRule ^((archives/([0-9]+)-[0-9a-z\._!;,\+\-%]+\.html)/?) blog/$1 [NC,L,R=301]
RewriteRule ^((authors/([0-9]+)-[0-9a-z\._!;,\+\-%]+)) blog/$1 [NC,L,R=301]
RewriteRule ^(feeds/categories/([0-9;]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,R=301]
RewriteRule ^(feeds/authors/([0-9]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,R=301]
RewriteRule ^(categories/([0-9;]+)-[0-9a-z\._!;,\+\-%]+) blog/$1 [NC,L,R=301]
RewriteRule ^(archives([/A-Za-z0-9]+)\.html) blog/$1 [NC,L,R=301]
RewriteRule ^(([0-9]+)[\-][0-9a-z\-]*\.html) blog/$1 [L,NC,R=301]
RewriteRule ^(feeds/(.*)) blog/$1 [NC,L,QSA]
RewriteRule ^(unsubscribe/(.*)/([0-9]+)) blog/$1 [L,R=301]
RewriteRule ^(approve/(.*)/(.*)/([0-9]+)) blog/$1 [L,R=301]
RewriteRule ^(delete/(.*)/(.*)/([0-9]+)) blog/$1 [L,R=301]
RewriteRule ^((admin|entries)(/.+)?) blog/$1 [L,R=301]
RewriteRule ^(archive/?) blog/$1 [L,R=301]
RewriteRule ^((index|atom[0-9]*|rss|b2rss|b2rdf).(rss|rdf|rss2|xml)) blog/$1 [L,R=301]
RewriteRule ^((plugin|plugin)/(.*)) blog/$1 [L,R=301]
RewriteRule ^(search/(.*)) blog/$1 [L,R=301]
RewriteRule ^(comments/(.*)) blog/$1 [L,R=301]

Wie man sieht, ist das ein Teil aus der .htaccess-Datei von Serendipity. Ich schicke alle Aufrufe die was mit dem alten Blog zu tun haben nach blog/ weiter. Die dortige .htaccess kümmert sich dann um die Weiterleitung an Serendipity.

Meine .htaccess hat noch einige mehr Einträge, die für meine neue HP notwendig sind. Natürlich muss man auch aufpassen, ob eine URL, die von Serendipity genutzt wird, evtl. mit der neuen Homepagestruktur Probleme verursacht. Zum Beispiel gibt es einen Nebeneffekt, wenn man unter www.example.com/admin einen eigenen Admin-Bereich aufbaut. Es wird automatisch nach www.example.com/blog/admin/ weitergeleitet und man landet im Login von Serendipity. Um dies zu umgehen muss man folgendes ändern:
Alt:

RewriteRule ^((admin|entries)(/.+)?) blog/$1 [L,R=301]

Neu:

RewriteRule ^(entries(/.+)?) blog/$1 [L,R=301]


Damit ist das Problem umgangen. Und es gibt noch eine Besonderheit:

RewriteRule ^(feeds/(.*)) blog/$1 [NC,L,QSA]

Alles was über www.example.com/feeds/ aufgerufen wird, wird nicht mit einer 301 weitergeleitet, sondern 1:1 von www.example.com/blog/feeds/ zurückgegeben. Auf deutsch: Die RSS-Feeds ist über zwei URLs erreichbar.
Aber hier:

RewriteRule ^(feeds/categories/([0-9;]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,R=301]
RewriteRule ^(feeds/authors/([0-9]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,R=301]

Die Feeds nach Kategorien und Autoren geordnet sind 301er Weiterleitungen. Theoretisch könnte man auch hier schreiben:

RewriteRule ^(feeds/categories/([0-9;]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,QSA]
RewriteRule ^(feeds/authors/([0-9]+)-[0-9a-z\._!;,\+\-%]+\.rss) blog/$1 [NC,L,QSA]

Oder noch kürzer: Diese Einträge könnten gelöscht werden, da diese durch den anderen Feed-Eintrag weiter unten ebenfalls weitergeleitet werden. Auch hier kümmert sich die .htaccess von Serendipity um die korrekte Umwandlung.

Als nächstes habe ich nun die Dateien für meine neue HP hochgeladen und die alten Serendipity-Dateien im Web-Root umbenannt. Nun sollte man noch alle Blog-Einträge anpassen, die Dateien aus der Medien-Datenbank eingebunden haben. Zum Schluss, nachdem alles funktionierte, habe ich die alten Serendipity-Dateien im Web-Root gelöscht.

Die ganze Umstellung hat mit kopieren, Einträge ändern und Test etwa eine halbe Stunde gedauert. Allerdings hatte ich die .htaccess-Datei schon vorbereitet und getestet. Wer keine Shared-Installation vorgenommen hat, muss natürlich einige Dateien mehr verschieben. Sonst dürften die Schritte die selben sein.