Projektumstieg von BASE Classic auf BASE (Mobile First)

Nutzbar ab: Version

Inhalte von bestehenden BASE Classic Projekten lassen sich mit überschaubarem Aufwand in eine BASE (Mobile First) Projektbasis übernehmen.

Alter Artikel

Dieser Artikel ist veraltet, da es mittlerweile ein weiteres Werkzeug für den Projektumstieg gibt, welches im Artikel Projektumstieg: Neue Projektgrundlage für bestehende Projekte nutzen beschrieben ist.
Das Vorgehen wie nachfolgend beschrieben hat dennoch seine Gültigkeit, wenn Sie z.B. auf das Werkzeug "Gesamtes Layoutprojekt neu installieren" verzichten wollen.

Um die Inhalte eines bestehenden BASE Classic 2.x Projektes in ein BASE (Mobile First) Projekt (BMF) zu überführen und dort zu nutzen, empfehlen wir die in diesem Artikel beschriebene Vorgehensweise.
In den meisten Fällen ist eine separate Domain bzw. Subdomain für den Neuaufbau die beste Alternative.

Tipp

Ab Weblication® CMS-Version 017.001.045.000 steht Ihnen für den Projektumstieg ein Werkzeug zur Verfügung.
Dies finden Sie über das Weblication® Panel unter den weiteren Werkzeugen beim "BASE Analyzer / Updater unter dem Punkt "Gesamtes Layout-Projekt neu installieren". Damit ziehen Sie alte BASE Classic Projekte und ältere BASE Mobile First Projekte auf eine aktuelle BASE für Version 17 um.Schritt 3 und 4 der nachfolgenden Anleitung können Sie dann überspringen.

Schritt 1: Projekteverzeichnisse bereinigen

Um die zu übernehmenden Daten so gering als möglich zu halten, bereinigen Sie bitte zuerst die Projektverzeichnisse (Inhalt, Assets, Global). Hierzu steht Ihnen über das Weblication® Panel die erweiterte Bereinigung als Werkzeug zur Verfügung.
Je nach Umfang des Projektes (Dateigrößen und Anzahl an Dateien) kann es ohne Projektbereinigung dazu führen, daß Sie ggf. den nächsten Schritt (Backup anlegen) nicht abschliessen können. Erfahrungshalber verhindern manchmal die Vielzahl an angelegten log-Dateien (requests, etc.), daß ein Backup-Archiv angelegt werden kann, weshalb Sie dies beachten sollten.

Schritt 2: Backup der Projektverzeichnisse anlegen

Erstellen Sie ein Backup des bestehenden BASE Classic 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. Zudem ist das Backup des Inhaltsprojektes und Assetsprojektes für die weiteren Schritte erforderlich.

Wenn Sie von der Auflistung der Weblics® in der Weblics®-Verwaltung ein Screenshot machen, können Sie für das neu aufzusetzende BASE (Mobile First) Projekt schnell überschauen, welche Weblics® Sie im alten Projekt im Einsatz bzw. zumindest installiert hatten und ggf. auch im neuen Projekt benötigen und somit installieren sollten.

Schritt 3: Installieren der aktuellsten BASE (Mobile First) Projektbasis

Eine Umstellung eines BASE 2.x Projektes auf die BASE (Mobile First) nehmen Sie am besten über eine separate Entwicklerumgebung 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.

Danach installieren Sie die neuste BASE (Mobile First) mit den 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.

Sichern Sie sich die .htaccess Datei (z.B. /de/.htaccess) der neuen BASE (Mobile First), um Änderungen, die zwischenzeitlich in dieser neuen Version vorgenommen wurden, nach Wiederherstellung des Backups (nächster Schritt) wieder einspielen zu können. Dies gilt ebenso für die .htaccess Datei des Assets-Projektes (z.B. /de-wAssets/.htaccess)!
Weiterhin sollten Sie den globalen Inhalt für die Cookie-Hinweise (z.B. /de/wGlobal/content/privacy) sichern,um diese im nächsten Schritt nach dem Einspielen des Inhaltsprojektes wieder übernehmen zu können (sofern diese im alten Projekt überhaupt vorhanden waren). Je nach Verwendung betrifft das auch andere content-Unterverzeichnisse (z.B. /de/wGlobal/content/content6Includes, usw.).

Schritt 4: Einspielen des bestehenden Inhaltsprojektes und Assets

Bei Nutzung des BASE Analysers/ Updaters spielen Sie das komplette Backup zurück und verwenden das Werkzeug "Gesamtes Layoutprojekt neu installieren"! (siehe Artikel Projektumstieg: Neue Projektgrundlage für bestehende Projekte nutzen)

Im neu installierten BASE (Mobile First) Projekt führen Sie nun eine Wiederherstellung des Inhaltsprojektes (z.B. /de) aus Ihrem Backup des derzeit bestehenden Projektes durch (siehe Schritt 2). Das Global-Projekt (z.B. /default-wGlobal) soll NICHT wiederhergestellt werden!

Beachten Sie beim Wiederherstellen:

  • Bei einer Wiederherstellung eines Backups werden alle Dateien überschrieben!
  • Verzeichnisse und Dateien, die im wiederherzustellenden Projekt vorhanden sind, im Backup aber nicht existieren, werden bei Wiederherstellung gelöscht!

Sie verfügen nun über die Struktur des BASE (Mobile First) Projektes mit Ihren Inhalten.

Da in neuen Projekten ggf. Änderungen in der .htaccess Datei des Inhalts- und Assets-Projektes erfolgt sind (siehe vorheriger Schritt), gleichen Sie dies am besten nach Wiederherstellung des Backups ab.
Wenn es rein um die WebP Unterstützung geht, können Sie dies auch über das weitere Werkzeuge "BASE Analyzer / Updater" nachtragen ("WebP Unterstützung in .htaccess ergänzen).
Beachten Sie den nachfolgenden Hinweis zu Umschreibregeln (RewriteEngine).
Sofern Ihr altes BASE Classic Projekt den im vorherigen Schritt genannten privacy-Ordner mit den Cookie-Hinweis Dateien haben, übernehmen Sie wieder die Dateien aus der Mobile First Installation. Dies gilt auch für andere eventuell verwendete globale Elemente bzw. Inhalte.

Zur Übernahme Ihrer bisherigen "Bilder / Assets / Dokumente" gehen Sie ähnlich vor und stellen diese über eine Backup-Wiederherstellung dem neuen Projekt zur Verfügung oder spielen diese manuell ein. Dies gilt auch für Bilder und andere Dateien, die ggf. im globalen Projekt (z.B. /default-wGlobal) abliegen (manuelle Übernahme dieser Dateien (z.B. Logo, Hintergrundbilder, etc.).

In den meisten Fällen wird die Präsenz bei Aufruf noch Fehlermeldungen und Hinweismeldungen bringen. Zu den uns bekannten Meldungen werden in den nächsten Schritten Lösungsmöglichkeiten aufgezeigt.

  • Sofern in einem Unterverzeichnis über eine .htaccess-Datei der Befehl "RewriteEngine on" gesetzt wird, gilt die Vererbung der im Verzeichnis höher liegenden .htaccess-Datei nicht mehr. Es müssen also in dieser neuen .htaccess-Datei alle Befehle erneut gesetzt werden (Pfadangaben ggf. anpassen)!

Schritt 5: 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 6: 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 7: 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 8: 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 9: 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.

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.