WordPress auf eine neue Domain umziehen

Jeder der diesen Beitrag nicht über den Feedreader sondern im Blog liest, wird feststellen, dass wir umgezogen sind – ich und der Blog. Die alte Subdomain helmschrott.de leitet nun automatisch um auf helmschrott.de/blog.

Die Gründe für diesen Umzug sind schnell erklärt: Ich plane die Website in Zukunft etwas um den Blog herum auszubauen und habe gerne alles kompakt integriert. Der Blog wird dann nur ein Teil der Website sein. Damit das (egal mit welcher Software) ohne große Umstände möglich ist, will ich alles auf einem Host (also der selben Domain/Subdomain) laufen haben.

Um dem ein oder anderen behilflich zu sein, der in Zukunft irgendwann mal seinen WordPress-Blog umziehen will, halte ich hier mal die Schritte fest, die ich durchgeführt habe und die bei vermutlich jedem anderen Umzug nahezu identisch sein werden. Gut möglich, dass es für den ein oder anderen Schritt ein Plugin gibt. Ich habe das nicht geprüft. Wenn ihr diesbzgl. was wisst, gebt einfach in den Kommentaren bescheid, dann ergänze ich den Beitrag entsprechend.Damit der Umzug reibungslos funktioniert spielen mehrere Komponenten eine Rolle. Eine der wichtigsten ist dabei die Software – in diesem Fall WordPress – entsprechend auf die neuen gegebenheiten einzustellen. Im Falle von WordPress ist das leider schwieriger als bei anderen Systemen, da WordPress z.B. den Permalink zu einem Beitrag inklusive der kompletten URL in der Datenbank ablegt. Neben den Permalinks wird auch in den Optionen von WordPress zweimal die URL abgelegt. Diese beiden Änderungen lassen sich mit entsprechendem Zugang zur Datenbank und geringfügigen Kenntnissen leicht durchführen. Aber von Anfang an…

Ich glaube eigentlich nicht, dass ich das noch sagen muss, aber… doch, vermutlich muss ich es sagen: Vor dieser ganzen Aktion sollte natürlich ein Backup von Dateien und Datenbank angefertigt werden!

Wenn also dieses Backup angefertigt ist und die Daten an ihrem neuen Bestimmungsort angekommen sind, sollten folgende Schritte durchgeführt werden:

Konfiguration anpassen

In die Konfigurationsdatei von WordPress müssen ggf. neue Datenbank-Daten eingetragen werden. Sie nennt sich wp-config.php und liegt im Hauptverzeichnis von WordPress. Weiterhin muss die in der Datenbank gespeicherte URL des Blogs auf die neue angepasst werden. Das geht am einfachsten über ein Webfrontend zur Datenbankverwaltung wie z.B. phpMyAdmin. Der passende SQL-Query hierfür wäre z.B.

UPDATE wp_options SET option_value = replace(option_value, 'http://www.alte-blog-url.de/blog', 'http://neue.blog.url') WHERE option_name = 'home' OR option_name = 'siteurl';

Damit sollte der Blog schonmal über den Browser erreichbar sein und es kann überprüft werden ob die neuen Datenbankdaten stimmen. Vermutlich wird aber noch einiges im Blog nicht funktionieren. Dazu gehören z.B. die Links zu den einzelnen Beiträgen oder die in das Blog eingebundenen Bilder, sofern diese auf die alte Blog-Adresse zeigen.

Permalinks updaten

WordPress speichert leider zu jedem Beitrag den vollständigen Permalink in der Datenbank. Warum das so ist kann ich nicht sagen, andere Systeme kommen ohne diesen Schritt aus, und leider bietet WordPress auch keine einfache Möglichkeit die URLs zu ändern, weshalb wir auch hier wieder auf einen SQL-Query zurückgreifen:

UPDATE wp_posts SET guid = replace(guid, 'http://www.alte-blog-url.de/blog','http://neue.blog.url');

Als zusätzlicher Schritt kann es nötig sein im Adminbereich von WordPress unter Einstellungen -> Permalinks einmal die dortigen Werte zu speichern. Danach sollten die Links zu den Beiträgen auf dem neuen Blog funktionieren.

Bilder und Links in Beiträgen reparieren

Wird ein Bild im Beitrag eingebunden, so passiert dies oftmals über die vollständige URL des Bildes. Selbst wenn nicht, kann es beim Wechsel des Verzeichnisses zu Problemen kommen. Auch das lässt sich über eine Datenbankabfrage recht einfach korrigieren:

UPDATE wp_posts SET post_content = replace(post_content, 'http://www.alte-blog-url.de/blog', 'http://neue.blog.url');

Damit sollten die eingebauten Links und Bilder wieder funktionieren. Je nach Situation ist für jede dieser Datenbankabfragen eine Anpassung nötig. Bitte klärt das ab bevor ihr sie durchführt und macht das am besten auch nur, wenn ihr halbwegs wisst was ihr macht.

Umleitung der Aufrufe

Um uns mit Google & Co. und natürlich auch mit unserem Stammbesuchern so gut wie möglich zu stellen, müssen wir nun noch die Aufrufe auf die alte URl möglichst sauber umleiten. Für Google ist der Idealfall ein HTTP-Redirect (Permanent – 301). Den erreichen wir über einen einfachen Eintrag in der .htaccess-Datei unter der alten URL. In meinen fall sieht das so aus:

RewriteEngine on
RewriteRule (.*) https://helmschrott.de/blog/$1 [R=301,L] 

Die Umleitung am besten direkt testen – auch mit alten Beitrags-URLs. Idealerweise sollten alle Inhalte 1:1 sauber umgeleitet werden. Durch die Umleitung sollte Google normalerweise eingehende Links zur alten URL entsprechend weiterhin für die neue URL werten. Sicher ist das jedoch nie – in Sachen Google ist das immer ein Stück weit ein Spiel mit dem Feuer. Auf jeden Fall sollte darauf geachtet werden, dass die Umleitung dauerhaft bestehen bleibt – alte Links tun dies ja in der Regel auch.

Anpassung statischer Links, Plugins und anderen Diensten

Zum Schluss müssen wir nun noch die Templates des Themes nach evtl. händisch eingetragenen Links zum Impressum, zum Feed oder zu anderen Zielen durchsuchen um diese entsprechend anpassen zu können. Außerdem muss z.b. bei Feedburner (falls vorhanden) und ggf. anderen Diensten die URL des Feeds oder der Link zum Blog entsprechend angepasst werden.

Weiterhin müssen ggf. die Optionen der diversen eingesetzten Plugins kontrolliert werden, da es auch hier welche gibt, die die URL oder das Verzeichnis auf dem Server an diversen Stellen speichern.