Suchen!

Contao Website für Kreuzbund-Verbände und Partner

Hinweise zum Upgrade auf Contao 4

Möchten Sie ein Upgrade von Version 3 zu 4 vornehmen, beachten Sie, in der 4er-Version folgende Module zu installieren:

  • rocksolid-columns
  • rocksolid-custom-elements
  • rocksolid-icon-picker
  • rocksolid-mega-menu
  • rocksolid-slider
  • rocksolid-theme-assistant

Außerdem könnten in Ihrer 3-er Version ebenfalls noch diese Module installiert sein, die Sie ggf. ebenfalls übernehmen möchten:

  • BackupDB [do-while/contao-backupdb-bundle]
  • m17StickyBEFooter [jrgregory/m17-sticky-backend-footer]

Bitte nehmen Sie das Upgrade nur vor, wenn Sie technisch ein bisschen bewandert sind.
Es gibt leider kein "vollautomatisches Upgrade auf Knopfdruck". Bitten Sie Ihren techn. Ansprechpartner um Unterstützung.
Anleitungen zum Upgrade finden sich zahlreich bei entsprechender Suche im Forum, z.B. hier:
https://community.contao.org/de/showthread.php?72751-Upgrade-von-Contao-3-5-auf-4-4&p=488559&viewfull=1#post488559

Allgemeiner Hinweis: Es handelt sich eher um eine "Migration" als um ein Update: Es wird eine neue 4er-Version installiert (bitte eigene Domain/Subdomain dafür verwenden!), und in diese werden dann die Inhalte der 3-er-Version importiert.

Um Probleme zu vermeiden, empfehle ich, nur eine LTS-Version zu verwenden (z.B. Contao 4.4).

Nach dem Upgrade

Templates "Navigation" anpassen

Editieren Sie die Templates "nav_default.html5" und "nav_rsmm.html5" (müssen ggf. neu angelegt werden),
und ersetzen Sie das Tag <strong> durch das Tag <span> (schließendes Tag nicht vergessen!)

Theme anpassen

Editieren Sie die Themes (unter Themes > Seitenlayouts > [Name des Themes]):
• Im Abschnitt "jQuery" entfernen Sie den Haken bei "j_mediaelement"

Javascript-Templates anpassen

  1. Editieren Sie das Template "j_colorbox.html5". Dort ersetzen SIe die Zeile 
    $GLOBALS['TL_CSS'][] = 'assets/jquery/colorbox/'. $GLOBALS['TL_ASSETS']['COLORBOX'] .'/css/colorbox.min.css|static';
    durch diese: 
    $GLOBALS['TL_CSS'][] = 'assets/colorbox/css/colorbox.min.css|static';
  2. Editieren Sie das Template "j_accordion.html5". Dort ersetzen SIe die Zeile 
    <script src="<?= TL_ASSETS_URL ?>assets/jquery/ui/<?= $GLOBALS['TL_ASSETS']['JQUERY_UI'] ?>/jquery-ui.min.js"></script>
    durch diese: 
    <script src="<?= $this->asset('js/jquery-ui.min.js', 'contao-components/jquery-ui') ?>"></script>

 

PHP-Version

Bitte verwenden Sie in der Contao-Version 3.5 maximal die PHP-Version 7.4.
Sollte es zu Fehlern kommen (bitte Frontend und Backend überprüfen), die sich nicht beheben lassen, senken Sie die PHP-Version stufenweise. PHP-Version 7.2 sollte unter keinen Umständen irgendwelche Probleme bereiten.

Contao-Version 4 läuft mit PHP 7.4 oder höheren.

Allgemeine Hinweise zu Systemvoraussetzungen finden Sie natürlich auf der Seite des Anbieters:
https://docs.contao.org/manual/de/installation/systemvoraussetzungen/

 

Weitere Hinweise für "danach"

Abstände

In der Contao 4 gibt es in den Elementen die Einstellungsmöglichkeit "Abstand davor/dahinter" nicht mehr. Die zuvor vergebenen Werte werden nach dem Upgrade einfach gelöscht, daher kann es in Einzelfällen sein, dass Abstände nicht mehr stimmen.

Sie können die Abstände vor und nach einem Element über das Feld "CSS-Klasse" lösen. Tragen Sie in das Feld "CSS-Klasse" einen der folgenden Werte ein, um die Abstände weiterhin besser kontrollieren zu können (das funktioniert auch schon in der 3er-Version so!):

• margin-top-xs
• margin-top-s
• margin-top-m
• margin-top-l
• margin-top-xl

, um einen Abstand nach oben ("top") in der Größenordnung xs, s, ... xl zu erzeugen.

Das selbe funktioniert dann auch mit "bottom" statt "top", um einen Abstand nach unten zu erhalten.

Wenn Sie statt "margin" das Wort "padding" verwenden, so wird ein entsprechend großer Innen-Abstand statt Außenabstand generiert.

Mehrere Werte im Feld CSS-Klasse? Um mehrere CSS-Klassen zuzuweisen (z.B. Abstand nach oben und unten), schreiben Sie die versch. Werte einfach leerzeichengetrennt in das Feld hinein, z.B. so: margin-top-m padding-top-xl margin-bottom-l padding-bottom-xl

System - Einstellungen

Ich habe beobachtet, dass nach einem Upgrade die Einstellungen unter "System > Einstellungen > Datei-Uploads" in den Felder "Maximale Bildbreite" und "Maximale Bildhöhe" verloren gegangen sind. Sie könnten hier also manuell neue Werte eintragen, wenn Sie das möchten. Ich würde das empfehlen, um den Server (und die Besucher) nicht mit unnötig großen Bildern zu belasten. Tragen Sie in die Felder z.B. 3840 und 2160 ein, um ggf. noch Bilder in 4K-Größe zuzulassen. Um Bilder in Full-HD-Auflösung zuzulassen, verwenden Sie 1920 und 1080.