Umbenennen von Projekten

Veröffentlichungsdatum: 30. Mai 2017
Änderungsdatum: 15. Mai 2023

projekt name verzeichnis pfad umbenennen

Sollen im nachhinein die Verzeichnisnamen eines Projektes umbenannt werden, können Sie hierzu die Werkzeuge von Weblication® CMS verwenden.

Wollen Sie die Verzeichnisnamen Ihres Projektes umbenennen, können Sie sich der Werkzeuge von Weblication® CMS bedienen. Dieses Vorgehen kann übrigens auch zum Erstellen einer Projekt Kopie herangezogen werden.

Tipp:
Mit aktuellster CMS 15 Version kann eine Umbenennung auch über den Weblication® Dateiexplorer vorgenommen werden, sofern es sich rein auf das Inhaltsprojekt bezieht (Assets- und Global-Pfade bleiben bestehen). Ein Backup sollte sicherheitshalber bei solch globalen Änderungen immer angelegt werden.
Zur Umbenennung klicken Sie auf oberster Ebene des Dateiexplorers per Rechtsklick auf das Verzeichnis und wählen "Umbenennen" aus und bestätigen das Anpassen der Links auf das Verzeichnis.
Aktualisieren Sie nach erfolgter Umbenennung noch den Dateiexplorer.

Alternativ:
Über den Weblication® Support können Sie gerne anfragen, ob dieser die Projektpfad Umbenennungen über ein Skript durchführen kann. Auch wenn zur Anwendung des Skriptes entsprechendes Wissen erforderlich ist, kann eine Umbenennung meist innerhalb kurzer Zeit vorgenommen werden. Meist kann dies als kostenfreier Service vom Support durchgeführt werden.
Wenn Sie diesen Service nutzen wollen, senden Sie dies als Anfrage bitte über den Supportbutton der entsprechenden Installation rein. Geben Sie dabei bitte wie unten beispielhaft angeführt die alte und neue Pfadbenennung, ein Weblication Admin-Login, FTP-Login und am besten einen Zeitraum an, in welchem die Umbenennung erfolgen kann (also keine redaktionellen Änderungen, etc. mehr erfolgen).

Manuelle Umsetzung - Allgemeines

Am Beispiel eines Projektes mit folgender Verzeichnisstruktur wird erläutert, wie Sie Schritt für Schritt vorzugehen haben. Beachten Sie dabei die Reihenfolge der einzelnen Schritte!

Sie verfügen z.B. über folgende Verzeichnisstruktur:

  • /de
  • /de-wAssets
  • /de-wGlobal

Die Verzeichnisnamen wollen Sie wie folgt umbenennen:

  • /deutsch
  • /deutsch-wAssets
  • /deutsch-wGlobal

Lesen Sie bitte zuerst die komplette Anleitung durch und gehen Sie danach wie folgt vor:

Schritt 1: Projekt bereinigen

Bereinigen Sie das Inhalts-, Assets- und Global-Projekt über das Werkzeug "Projekt bereinigen" im jeweiligen Projekt (siehe auch weiterführende Links unten).
Tipp:
Ab CMS-Version 10.x können Sie Log-Dateien auch löschen (z.B. älter als 1 Monat), um beim späteren Backup weniger an Datenmenge sichern zu müssen.

Schritt 2: Backup des gesamten Projektes

Erstellen Sie ein Backup des bestehenden Projektes (Inhalt, Assets, Global). Die Backups der Projektverzeichnisse können Sie entweder über die Werkzeuge zum jeweiligen Projekt oder direkt über die Administration vornehmen (siehe weiterführende Links unten).
Somit verfügen Sie über eine Sicherung der bisherigen Projektstruktur, auf die Sie ggf. wieder zurückgreifen können.

Schritt 3: Suchen und Ersetzen für neue Verzeichnispfade

Über das Werkzeuge "Suchen und Ersetzen" im jeweiligen Projekt (siehe weiterführende Links unten) passen Sie nun die Pfade auf die neue Projektbenennung an. Führen Sie während dieser Aktionen kein Refresh im Backend durch!

Ab CMS-Version 12.x stehen Ihnen hierzu im "Suchen und Ersetzen" Werkzeug Makros zur Verfügung, welche Ihnen die Arbeit beim Ersetzen erleichtern!

Achten Sie darauf, daß Sie folgende Optionen beim Suchen/Ersetzen Durchlauf aktiviert haben:

  • Dateitypen: *  (alle)
  • Unterverzeichnisse einbeziehen
  • Systemverzeichnisse einbeziehen (ab CMS 11.x)
  • Groß-, Kleinschreibung berücksichtigen

Anpassen der Pfade in allen Projektverzeichnissen ( /de, /de-wAssets und /de-wGlobal):

  1. Mit führendem und endendem Slash:
    Suchen nach: /de/
    Ersetzen durch: /deutsch/
    Führen Sie diese Ersetzen-Aktion in allen Projektverzeichnissen  ( /de, /de-wAssets und /de-wGlobal) durch!
  2. Nur mit führendem Slash:
    Suchen nach: /de-wGlobal
    Ersetzen durch: /deutsch-wGlobal
    Führen Sie diese Ersetzen-Aktion in allen Projektverzeichnissen  ( /de, /de-wAssets und /de-wGlobal) durch!
  3. Nur mit führendem Slash:
    Suchen nach: /de-wAssets
    Ersetzen durch: /deutsch-wAssets
    Führen Sie diese Ersetzen-Aktion in allen Projektverzeichnissen  ( /de, /de-wAssets und /de-wGlobal)durch!

Hinweis:
Die Pfade in .htaccess Dateien prüfen Sie bitte manuell (am besten über FTP), da diese ggf. durch Suchen/Ersetzen nicht erfasst werden. In der Regel gibt es folgende .htaccess Dateien (am Beispiel der o.g. Pfade):

/.htaccess
/de/.htaccess
/de-wAssets/.htaccess

Sollten Sie weitere .htaccess Dateien im Einsatz haben, gilt dies für diese entsprechend.

Schritt 4: Umbenennen der Projekte

Nachdem im vorigen Schritt alle Pfade in den Projektdateien angepasst wurden, benennen Sie nun die Projektverzeichnisse um. Dies nehmen Sie als Administrator über die Dateiverwaltung vor ("Verzeichnis umbenennen", siehe weiterführende Links unten).

  1. Inhaltsprojekt umbenennen (z.B. von /de in /deutsch)
    Wichtig:
    "Links auf das Verzeichnis anpassen" während der Umbenennung auswählen!
  2. Assetsprojekt umbenennen (z.B. von /de-wAssets in /deutsch-wAssets)
    Wichtig:
    "Links auf das Verzeichnis anpassen" während der Umbenennung auswählen!
  3. Globalprojekt umbenennen (z.B. von /de-wGlobal in /deutsch-wGlobal)
    Wichtig:
    "Links auf das Verzeichnis anpassen" während der Umbenennung auswählen!

Schritt 5: Projekte einchecken (optional)

Dieser Schritt ist nur dann erforderlich, wenn nach Neuladen des Backends das umbenannte Projekt nicht in der Projektverwaltung erscheint.

Um die Projekte im Backend innerhalb der Projektverwaltung ersichtlich zu haben, müssen Sie diese ggf. einchecken: So binden Sie manuell installierte Projekte im Backend ein.

Schritt 6: Weiterleitung auf Projekt anpassen

Die oberste /index.php beinhaltet normalerweise den Verweis auf das entsprechende Inhaltsprojekt. Passen Sie in dieser Datei den Pfad zum neu benannten Projektverzeichnis entsprechend an. Somit ist gewährleistet, dass bei Aufruf der Domain die Weiterleitung auf das Inhaltsprojekt korrekt erfolgt.

Beispiel: Inhalt der /index.php mit neuem Projektverzeichnisnamen /deutsch

require_once($_SERVER["DOCUMENT_ROOT"]."/weblication/grid.php");
  wRequest::includePage('/deutsch/index.php');
  • Sollen Aufrufe über die alten Verzeichnispfade nicht ins Leere führen, können Sie dies z.B. über eine .htaccess Datei mit Umschreiberegeln (Rewrite) vornehmen (siehe weiterführende Links).
  • Melden Sie ggf. die neuen Pfade in den gewünschten Suchmaschinen wieder an.
  • Prüfen Sie nach Abschluss am besten über die Linkprüfung, ob alle LInks im Projekt korrekt funktionieren.

Onlinedokumentation - Werkzeuge - Backup
So binden Sie manuell installierte Projekte im Backend ein
Onlinedokumentation - Werkzeuge - Bereinigen
Onlinedokumentation - Werkzeuge - Suchen und Ersetzen
Onlinedokumentation - Verzeichnis umbenennen
Onlinedokumentation - Werkzeuge - Linkprüfung
apache.org: URL Rewriting Guide - Apache HTTP Server
FAQs are only visible for Weblication ai search and editors!
Wie können Verzeichnisnamen eines Projekts in Weblication CMS umbenannt werden?
Sie können die Umbenennung der Verzeichnisnamen Ihres Projekts mit den Werkzeugen von Weblication® CMS vornehmen. Alternativ kann dies auch über den Weblication® Dateiexplorer erfolgen, wenn es sich rein auf das Inhaltsprojekt bezieht (Assets- und Global-Pfade bleiben bestehen).
Kann die Umbenennung auch zum Erstellen einer Projektkopie genutzt werden?
Ja. Das Vorgehen zum Umbenennen von Projektverzeichnissen kann auch zur Erstellung einer Projekt Kopie herangezogen werden.
Wie funktioniert die Umbenennung über den Weblication® Dateiexplorer (CMS 15), wenn es nur das Inhaltsprojekt betrifft?
Mit der aktuellsten CMS 15 Version kann eine Umbenennung über den Weblication® Dateiexplorer vorgenommen werden, sofern es sich rein auf das Inhaltsprojekt bezieht (Assets- und Global-Pfade bleiben bestehen). Vorgehen: - Rechtsklick im Dateiexplorer auf das Verzeichnis auf oberster Ebene - „Umbenennen“ auswählen und bestätigen, dass die Links auf das Verzeichnis angepasst werden - Nach der Umbenennung den Dateiexplorer aktualisieren
Warum sollte bei globalen Änderungen immer ein Sicherheitshalter/Verfahren angelegt werden?
Bei globalen Änderungen sollte sicherheitshalber immer ein entsprechender Sicherheitshalter (für den Fall unvorhergesehener Effekte) angelegt werden.
Welche Alternative gibt es zur manuellen Umbenennung über den Support?
Über den Weblication® Support können Sie anfragen, ob der Support die Projektpfad-Umbenennungen über ein Skript durchführen kann. Meist ist dies innerhalb kurzer Zeit möglich und kann als kostenfreier Service angeboten werden.
Welche Informationen muss ich dem Weblication® Support für eine Skript-Umbenennung schicken?
Senden Sie eine Anfrage über das angegebene Kontaktformular. Geben Sie dabei bitte: - alte und neue Pfadbenennung (wie im Beispiel) - einen Weblication Admin-Login - einen FTP-Login - am besten einen Zeitraum, in dem die Umbenennung erfolgen kann (damit keine redaktionellen Änderungen mehr passieren)
Was sind die wichtigsten Schritte bei der manuellen Umsetzung einer Projekt-Umbenennung?
Gehen Sie in dieser Reihenfolge vor: 1. Manuelle Umsetzung - Allgemeines 2. Schritt 1: Projekt bereinigen 3. Schritt 2: Backup des gesamten Projektes 4. Schritt 3: Suchen und Ersetzen für neue Verzeichnispfade 5. Schritt 4: Umbenennen der Projekte 6. Schritt 5: Projekte einchecken (optional) 7. Schritt 6: Weiterleitung auf Projekt anpassen Wichtig: Beachten Sie die Reihenfolge der Schritte.
Wie bereinige ich ein Projekt vor einer Umbenennung?
Bereinigen Sie das Inhalts-, Assets- und Global-Projekt über das Werkzeug „Projekt bereinigen“ im jeweiligen Projekt. Zusätzlich gilt: Ab CMS-Version 10.x können Sie Log-Dateien löschen (z.B. älter als 1 Monat), um beim späteren Backup weniger Daten sichern zu müssen.
Muss ich vor der Umbenennung ein Backup erstellen?
Ja. Erstellen Sie ein Backup des bestehenden Projektes (Inhalt, Assets, Global). Die Backups können Sie entweder über die Werkzeuge zum jeweiligen Projekt oder direkt über die Administration vornehmen.
Wie passe ich die Pfade im Projekt auf die neue Benennung an (Suchen und Ersetzen)?
Nutzen Sie das Werkzeug „Suchen und Ersetzen“ im jeweiligen Projekt und passen Sie die Pfade auf die neue Projektbenennung an. Wichtig: - Während der Aktionen kein Refresh im Backend durchführen. - Ab CMS-Version 12.x stehen im „Suchen und Ersetzen“ Makros zur Verfügung, die die Arbeit erleichtern.
Welche Optionen sollte ich beim Durchlauf „Suchen und Ersetzen“ aktivieren?
Achten Sie darauf, dass folgende Optionen beim Suchen/Ersetzen aktiviert sind: - Dateitypen: * (alle) - Unterverzeichnisse einbeziehen - Systemverzeichnisse einbeziehen (ab CMS 11.x) - Groß-, Kleinschreibung berücksichtigen
Welche konkreten Ersetzen-Aktionen müssen für /de, /de-wAssets und /de-wGlobal durchgeführt werden?
Führen Sie diese Ersetzen-Aktionen in allen Projektverzeichnissen (/de, /de-wAssets, /de-wGlobal) durch: 1. Mit führendem und endendem Slash: - Suchen: /de/ - Ersetzen durch: /deutsch/ 2. Nur mit führendem Slash: - Suchen: /de-wGlobal - Ersetzen durch: /deutsch-wGlobal 3. Nur mit führendem Slash: - Suchen: /de-wAssets - Ersetzen durch: /deutsch-wAssets
Müssen .htaccess Dateien bei der Pfadänderung manuell geprüft werden?
Ja. Prüfen Sie die Pfade in .htaccess Dateien bitte manuell (am besten über FTP), da diese ggf. durch Suchen/Ersetzen nicht erfasst werden. Typische .htaccess Dateien sind z.B.: - ./.htaccess - /de/.htaccess - /de-wAssets/.htaccess Wenn weitere .htaccess Dateien im Einsatz sind, entsprechend ebenfalls prüfen.
Wie benenne ich die Projektverzeichnisse nach dem Pfadanpassen um?
Nachdem alle Pfade in den Projektdateien angepasst wurden, benennen Sie die Projektverzeichnisse als Administrator über die Dateiverwaltung um („Verzeichnis umbenennen“). Während der Umbenennung muss „Links auf das Verzeichnis anpassen“ ausgewählt werden. Typischer Ablauf: - Inhaltsprojekt umbenennen (z.B. /de → /deutsch) - Assetsprojekt umbenennen (z.B. /de-wAssets → /deutsch-wAssets) - Globalprojekt umbenennen (z.B. /de-wGlobal → /deutsch-wGlobal)
Wann muss ich Projekte im Backend einchecken?
Dieser Schritt ist nur erforderlich, wenn nach dem Neuladen des Backends das umbenannte Projekt nicht in der Projektverwaltung erscheint. Dann müssen Sie die Projekte im Backend in der Projektverwaltung ggf. einchecken.
Wie passe ich die Weiterleitung auf das neu benannte Inhaltsprojekt an?
Die oberste /index.php beinhaltet normalerweise den Verweis auf das entsprechende Inhaltsprojekt. Passen Sie in dieser Datei den Pfad zum neu benannten Projektverzeichnis an, damit bei Aufruf der Domain die Weiterleitung korrekt funktioniert.
Wie sieht ein Beispiel für die Anpassung der /index.php aus?
Beispiel für neuen Projektverzeichnisnamen /deutsch: require_once($_SERVER["DOCUMENT_ROOT"]."/weblication/grid.php"); wRequest::includePage('/deutsch/index.php');
Was kann ich tun, damit Aufrufe über alte Verzeichnispfade nicht ins Leere führen?
Sie können z.B. über eine .htaccess Datei mit Umschreiberegeln (Rewrite) sicherstellen, dass Aufrufe über die alten Verzeichnispfade sinnvoll umgeleitet werden.
Muss ich die neuen Pfade nach der Umbenennung auch bei Suchmaschinen melden?
Ja, melden Sie ggf. die neuen Pfade in den gewünschten Suchmaschinen.
Wie prüfe ich nach Abschluss, ob die Umbenennung korrekt war?
Prüfen Sie nach Abschluss am besten über die Linkprüfung, ob alle Links im Projekt korrekt funktionieren.