Projektumstieg: Neue Projektgrundlage für bestehende Projekte nutzen

Inhalte von bestehenden Projekten (ältere BASE (Mobile First) aber auch BASE Classic Projekte) lassen sich mit überschaubarem Aufwand auf eine aktuelle BASE Projektbasis übernehmen.

Dieser Artikel beschreibt die Vorgehensweise für einen Projektumstieg unter Zuhilfenahme eines "BASE Analyzer / Updater" Werkzeugs.

Schritt 1: Entwicklungsumgebung schaffen

Eine Umstellung eines älteren Projektes auf die aktuelle BASE nehmen Sie am besten über eine separate Entwicklungsumgebung vor. Hierfür bietet sich eine Subdomain der lizenzierten Domain an (z.B. relaunch.IhreLizenzierteDomain.tld), welche auf eine eigene DOCUMENT_ROOT zeigt.

Installieren Sie unter dieser Subdomain Weblication® CMS über das Setup-Skript.

Direkt nach der Installation des CMS können Sie das bestehende Projekt auf unterschiedlichen Wegen auf dem Server ablegen. Das manuelle Übertragen der Einzel-Dateien und -Verzeichnisse empfehlen wir nicht, da dies zu fehleranfällig ist und auch viel länger dauert.

In Schritt 2 finden Sie nachfolgend zwei Wege beschrieben, wie Sie vorgehen können. Wählen Sie entweder Schritt 2a oder Schritt 2b.

Schritt 2: Kundenprojekt anlegen

Um das Kundenprojekt in der Entwicklungsumgebung anzulegen, gibt es mehrere Wege, wie dies vorgenommen werden kann. Nachfolgend werden zwei Möglichkeiten aufgezeigt (Schritt 2a oder Schritt 2b).

Schritt 2a: Projektinstallation und Wiederherstellen des Kundenprojektes

Bei dieser Alternative für das Ablegen des bestehenden Kundenprojektes gehen Sie wie folgt vor:

Installieren Sie die neuste BASE mit den gleichen Pfaden, die Sie im bestehenden Projekt auch schon nutzen, z.B.:

/de
/de-wAssets
/de-wGlobal

Sofern die Pfade von den hier genannten Beispielpfaden abweichen, setzen Sie die Pfade entsprechend Ihrem bestehenden Projekt. Sollten Sie mit dem Projektumstieg auch neue Pfadangaben wünschen, ist dies auch möglich. Wir empfehlen aber zuerst einmal den Umstieg mit Nutzung der bisherigen Projektverzeichnispfade vorzunehmen und erst nach Abschluß eine Projektumbenennung vorzunehmen. Wenden Sie sich für die Projektumbenennung bitte über ein Supportticket an den Support.

Nachdem das Projekt installiert ist, laden Sie über das Backup-Werkzeug die zuvor von der Kundenumgebung gesicherten Projekt-Backups hoch und führen danach eine Wiederherstellung durch. Überschreiben Sie bei allen drei Backups (Inhalts-, Assets- und Global/Layout-Projekt) die bestehenden Inhalte (auch die Logs).

Das bestehende Kundenprojekt liegt nun  in der Entwicklungsumgebung ab. Prüfen Sie über einen Aufruf der Webseiten sicherheitshalber, ob alles korrekt angezeigt wird. Sofern es Darstellungsprobleme gibt, speichern Sie über "Layout anpassen" die design.css (bei BASE Classic) bzw. page.scss (bei BASE (Mobile First)) nochmals ab.

Weiter geht es bei Schritt 3.

TIPP:
Alternativ zur Neuinstallation eines Projektes können Sie das bisherige Projekt auch direkt auf dem Server über z.B. die Shell in die Entwicklungsumgebung kopieren.

Schritt 2b: Wiederherstellen des Kundenprojektes

Bei dieser Alternative für das Ablegen des bestehenden Kundenprojektes gehen Sie wie folgt vor:

Rufen Sie nach Installation des CMS (ohne Projektinstalltaion) direkt das Weblication® CMS Backend auf (Link unterhalb der Login-Maske). In der linken Leiste des Backends klicken Sie auf die Schaltfläche "Backup".

Laden Sie über das Backup-Werkzeug die zuvor von der Kundenumgebung gesicherten Projekt-Backups hoch und führen danach eine Wiederherstellung durch.

Das bestehende Kundenprojekt liegt nun in der Entwicklungsumgebung ab. Prüfen Sie über einen Aufruf der Webseiten sicherheitshalber, ob alles korrekt angezeigt wird. Sofern es Darstellungsprobleme gibt, speichern Sie über "Layout anpassen" die design.css (bei BASE Classic) bzw. page.scss (bei BASE (Mobile First)) nochmals ab.
Stellen Sie sicher, daß die Projekte eingecheckt sind, was Sie über den Projekte-Report vornehmen können.

Weiter geht es bei Schritt 3.

Schritt 3: Gesamtes Layout-Projekt neu installieren

Rufen Sie über das Weblication® Panel unter Weitere Werkzeuge das "BASE Analyzer / Updater" Werkzeug auf und gehen Sie die Schritt-für-Schritt Anleitung durch, welche Sie dort vorfinden.
Der letzte Schritt dieser Anleitung wird nachfolgend ab Schritt 4 nochmals ausführlicher beschrieben.

Schritt 4: Installieren benötigter Weblics® / Templates nachrüsten

Als Administrator erhalten Sie in der Präsenz eine Hinweismeldung, wenn im Projekt Elemente vorhanden sind, zu denen keine XSLT-Templates bestehen. Meist ergibt sich aus dem genannten Typ des Elementes schon, welches Weblic® noch nicht installiert ist.

Am Beispiel der folgenden Meldung handelt es sich bei "layout.clearer" um das Weblic® "Zeilenumbruch / Abstand" der BASE Classic.

Installieren Sie diese Elemente / Weblics® über die Weblic®-Verwaltung nach bzw. übernehmen Sie individuelle Weblics® / Elemente in das neue Projekt.
Im Beispiel des Zeilenumbruch-Elementes wurde dies in der Mobile First über einen anderen Type umgesetzt (layout.clearerSpacer anstatt layout.clearer). Für diesen Fall können Sie das weitere Werkzeuge "BASE Analyzer / Updater" zu Hilfe nehmen. Dies stellt Ihnen u.a. auch das Werkzeug "Umbruch-Element anpassen" zur Verfügung, welches per Klick alle Umbruch-Elemente von type="layout.clearer" auf type="layout.clearerSpacer" für das gewählte Verzeichnis rekursiv umstellt. Auch die Funktion "Überschriften anpassen" sollten Sie nutzen, um beim Einsatz von Sonderzeichen (z.B. das & Zeichen) in der Überschrift auf die Gegebenheiten in der Mobile First eingehen zu können.
Nutzen Sie ggf. weitere Werkzeuge, um Inhaltsbereiche zu ergänzen, IMG nach PICTURE zu konvertieren, etc.

Strukturelement - Hinweis "kein Template definiert"
Strukturelement - Hinweis "kein Template definiert"

Elemente, zu denen Sie im  Weblics® Portal kein Weblic® finden, sind sehr wahrscheinlich individuell angepasste oder selber erstellte Weblics®. Zu diesen Elementen laden Sie sich die erforderlichen XSLT-Templates und zugehörigen Skripte aus dem alten Projekt in das neue BASE (Mobile First) Projekt. Prüfen Sie zuerst, ob es ggf. passende Weblics® gibt, die diese individuellen Elemente künftig überflüssig machen.

Beachten Sie, daß ggf. die Bildergalerie- bzw. Teaser-/Banner-Elemente in den Seiten nochmals erneut eingebunden und gegen die bisherigen Elemente ersetzt werden müssen.

Sollten zu den Hinweismeldungen auch Fehlermeldungen erscheinen, kann dies z.B. an fehlenden Skriptaufrufen, nicht (mehr) existierenden Listen-Templates, Datenbankaufrufen, etc. liegen. Passen Sie dies individuell an.

Prüfen Sie zudem, ob auch sonstige eigene XSL-Template oder Objekt-Templates ggf. nachgezogen werden müssen.

Schritt 5: Layout wählen und anpassen, CSS-Only-Varianten nachinstallieren

Wählen Sie nun über Layout anpassen die gewünschte Seitendarstellung für Ihr Layout, die Navigation usw. aus, welche Ihrem bisherigen Projekt am nächsten kommt.

Wenn Sie Ihre bisherigen Struktur definiert haben bzw. dieser so nah wie möglich gekommen sind, passen Sie das Layout wieder an Ihre individuellen Anforderungen an. Meist handelt es sich dabei um CSS-Anpassungen. Viele dieser CSS-Anpassungen können komfortabel über die Pflegemasken des Layoutwizards vorgenommen werden. Für weitergehende Anpassungen wechseln Sie in das Quelltext-Register und passen die CSS-Definitionen und Formatierungen manuell an.

CSS-Only-Varianten nachinstallieren / übernehmen

Wurden im alten Projekt CSS-Only-Varianten (für z.B. Inhaltsboxen, Mehrspaltige Inhaltscontainer, Listen, BannerSlider, Bildergalerien, etc.) verwendet, welche im neuen Projekt so im Standard nicht enthalten sind, installieren Sie diese durch Auswahl passender Varianten nach. Individuell definierte CSS-Only-Varianten ziehen Sie auf neuer Basis manuell nach.

Optional: Zurück-Link bei aktuellen Meldungen

Sofern Sie unter BASE Classic bei aktuellen Meldungen (News) in den Detailseiten den zurück-Button genutzt haben und in der Mobile First vermissen, können Sie diesen über CSS aktivieren:

Beispiel: Auszug aus /[IHR-LAYOUT-PROJEKT]/wGlobal/layout/styles/objects/objectNews.scss

  .elementLinkBack {
    display:none; /* zum Aktivieren des zurück-Links auf display:block; setzen */
  }

Schritt 6: Textbausteine, Variablen, Kategorien, etc. nachziehen

Zentrale Einstellungen der Projektkonfiguration in Ihrem bisherigen Projekt übernehmen Sie am besten manuell in das neue BASE (Mobile First) Projekt. Öffnen Sie hierzu die Projektkonfiguration des alten Projektes und des neuen Projektes parallel und legen Sie beide Fenster nebeneinander auf den Bildschirm.
Auf diese Weise können Sie die Einträge schnell abgleichen und übernehmen.

Gleiches Vorgehen bietet sich für die Textbaustein-Dateien an (siehe Bearbeiten einer Textdatei bzw. Texteverwaltung (global)).

Ebenso verhält es sich für sonstige globale Dateien / Inhalte, welche im Global-Projekt abliegen. Dazu gehören unter anderem die Kategorien-Dateien unterhalb /[IHR-LAYOUT-PROJEKT]/wGlobal/content/categories/ . Übernehmen Sie diese am besten manuell aus dem alten Projekt.

Schritt 7: Prüfen Sie das gesamte Projekt auf Funktionalität

Nach Abschluss der vorangegangenen Schritte sollten Sie alle Seiten Ihres Projektes durchgehen und auf Funktionalität prüfen.
Gerne können Sie bei Problemen auch den Support kontaktieren, um den Aufwand für eine Hilfestellung ungefähr abschätzen zu können.

Schritt 8: Umstellen der Domain auf das neue Projekt

Stellen Sie nun die lizenzierte Domain auf das neue BASE (Mobile First) Projekt um. Je nachdem, wo Sie das neue Projekt aufgesetzt haben, ist die Vorgehensweise unterschiedlich.

Haben Sie das Projekt unter einer Subdomain umgesetzt, reicht es in der Regel, die Projektverzeichnisse (Inhalt, Assets, Global) auf die lizenzierte Domain rüberzuziehen und zuvor die bisherigen Projektverzeichnisse umzubenennen und danach zu löschen.

Weitere Hinweise

  • Während der Umstellphase sollten Sie einen Pflegestopp verhängen, damit die Daten des bisherigen Projektes nicht aktueller sind als die des neu umgesetzten Projektes!
  • Sind diverse Protokollierungen (Monitoring, Klickanalyse, etc.) für Sie von Bedeutung, übernehmen Sie diese nach der Umstellung wieder in das neue Projekt.
  • Individuelle Umschreibregeln (mod_rewrite) in .htaccess Dateien müssen ggf. wieder nachgezogen werden.
  • Anderweitige individuelle (Skript-) Umsetzungen müssen ggf. wieder nachgezogen werden.
  • Über das in den weiterführenden Links gelistete CSS-Konvertierungsskript können Sie die gängigsten CSS-Selektoren auslesen und so vom bisherigen Projekt leichter in die design.css des neuen Projektes übernehmen. Das Skript können Sie individuell anpassen.