Veröffentlichungsdatum: 19. Juli 2023
Änderungsdatum: 21. Juli 2023
weblication cms projekte projektbasis base classic mobile first umstieg projektumstieg umstellen
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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:
.elementLinkBack {
display:none; /* zum Aktivieren des zurück-Links auf display:block; setzen */
}
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.
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.
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.
Danach installieren Sie die neuste BASE 2.x 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.
Erstellen Sie danach gleich ein Backup von diesem Verzeichnis (speziell bei BASE 1.x Projekten erforderlich):
/de/wGlobal/content/contentPortal/
Dieses Verzeichnis beinhaltet die Datei für die Portalinhalte (default.php), weshalb Sie das Backup in den nächsten Schritten wieder benötigen. Bei Bedarf können Sie das Backup auf den gesamten /de/wGlobal/content/ Ordner ausweiten, da je nach Projektstand im alten Projekt diverse globale Inhaltsdateien (contentXincludes, dropdowns, errordocs, redirects, etc.) noch nicht vorhanden waren.
Sie sollten zudem die .htaccess Datei (z.B. /de/.htaccess) der neuen BASE sichern, um Änderungen, die zwischenzeitlich in neueren BASE-Versionen 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)!