Update von Version 3.3.X auf Contao 3.4

Um Ihr Theme auf einer neuen Installation von Contao 3.4 aufzusetzen reicht es der üblichen Installationsanleitung zu folgen, es sind keine weiteren Schritte nötig.

Diese Anleitung unterstützt Sie dabei Ihre bestehende Contao 3.3.X Installation zu aktualisieren. Ihre Inhalte bleiben dabei erhalten.

Bevor Sie mit dem Update beginnen, sollten Sie unbedingt alle Dateien, Ordner und die Datenbank sichern. Wir übernehmen keinerlei Haftung für mögliche Fehler beim Update!

Im Contao-Community-Forum gibt es eine Sammlung hilfreicher Tipps & Tricks zum Update auf Contao 3.4.

Zuerst: Contao Core aktualisieren

Aktualisieren Sie Contao über ein manuelles Update oder über den Live Update Service. Weitere Informationen über das Update auf Version 3.4 finden Sie auf contao.org und im Contao-Community-Forum.

Achten Sie beim Datenbankupdate darauf, dass Sie keine Spalten oder Tabellen löschen (DROP-Anweisungen), ansonsten könnten wichtige Daten verloren gehen.

Danach: Erweiterungen aktualisieren

Aktualisieren Sie alle RockSolid Erweiterungen auf die aktuellste Version. Navigieren Sie dazu im Contao-Backend zu System › Erweiterungsverwaltung, klicken Sie bei allen RockSolid Erweiterungen auf die Checkbox auf der linken Seite, klicken Sie dann auf "Markierte Erweiterungen aktualisieren" und folgen Sie dem Installations-Assistenten bis alle Erweiterungen fertig aktualisiert wurden.

Optional: Template Anpassungen

Wenn Sie von den neuen Features Gebrauch machen möchten und Responsive Images bzw. das <picture>-Element einsetzen möchten, sind folgende Anpassungen vorzunehmen:

Suchen Sie im Ordner templates/THEMENAME nach <img>-Tags und ersetzen Sie alle mit <?php $this->insert('picture_default', $this->picture) ?>. Achen Sie dabei bitte darauf, dass Sie für $this->picture dieselbe Variable verwenden die vorher für $this->src verwendet wurde. Ersetzen Sie z. B. folgenden Code:

<img src="<?php echo $image->src ?>" alt="<?php echo $image->alt ?>"<?php echo $image->imgSize ?>>

mit diesem:

<?php $this->insert('picture_default', $image->picture) ?>

Dabei wurde vorher für das src-Attribut die Variable $image verwendet und demnach lautet die korrekte Variable für das Picture-Template $image->picture.

Im zweiten Schritt werden alle Konfigurationen der Custom Elements angepasst, die eine Einstellung für die Bildgröße enthalten. Suchen Sie dazu in allen templates/THEMENAME/rsce_..._config.php-Dateien nach $GLOBALS['TL_CROP'] und ersetzen es mit \System::getImageSizes().

Party: Glückwunsch – es ist Zeit zu feiern

Ihre Contao 3.4 Installation und Ihr RockSolid Theme sind nun auf dem neusten Stand.

Gab es Unklarheiten oder haben Sie einen Fehler in diesem Artikel entdeckt? Geben Sie uns Bescheid und hinterlassen Sie Ihr Feedback.