Contao-News

Contao Version 4.10.0 ist verfügbar. Das Release enthält neue Features wie z.B. verbessertes Routing, Mailer-Transports, erweiterte Simple-Tokens, hervorgehobene Events, eine verbesserte Suche, neue Insert-Tags, einen neuen Image-Service und einiges mehr.

In seinem Video 12 neue Features in Contao 4.10 stellt Christian die Neuerungen in Contao 4.10 vor. Und auch Yanick hat in seiner Stage Time auf YouTube bereits einen Einblick in einige der neuen Funktionen gegeben.

Verbessertes Routing

Das Routing, also die Zuweisung einer URL zu einer Seite in der Seitenstruktur, wurde in Contao 4.10 stark überarbeitet. Es ist nun möglich, pro Startpunkt einer Webseite ein individuelles URL-Präfix und URL-Suffix zu konfigurieren. Das URL-Präfix ist dabei nicht mehr auf eine gültige Locale beschränkt, so dass z.B. folgende URLs für die Übersetzung "Deutsch/Schweiz" möglich sind:

• https://domain.com/de/
• https://domain.com/de-ch/
• https://domain.com/de-schweiz/
• https://domain.com/schweizerdeutsch/
• https://domain.com/schweiz/

Es ist auch möglich, die Hauptseite ganz ohne URL-Präfix zu betreiben und nur für die übersetzten Startpunkte ein URL-Präfix zu definieren:

• https://domain.com/
• https://domain.com/support
• https://domain.com/de/
• https://domain.com/de/support

Da einige Drittanbieter-Erweiterungen unter Umständen nicht kompatibel mit dem neuen Routing sind, ist dieses standardmäßig deaktiviert und muss in der App-Konfiguration wie folgt aktiviert werden:

contao:
    legacy_routing: false

Ressourcen: #1516, #477, YouTube-Video

Mailer-Transports

Ein Mailer-Transport ist eine SMTP-Konfiguration (Server, Benutzername, Passwort und Absender), die in der App-Konfiguration definiert wird und anschließend im Backend für den Mail-Versand ausgewählt werden kann. Dadurch ist es möglich, Newsletter über ein anderes SMTP-Postfach und eine andere E-Mail-Adresse zu verschicken als Formulardaten oder Systemnachrichten.

Ressourcen: #1830, Dokumentation, YouTube-Video

Simple Tokens

Simple Tokens verwenden nun die Symfony Expression Language, wodurch der Funktionsumfang deutlich erweitert wird. Zum Beispiel sind nun AND/OR-Prüfungen möglich sowie reguläre Ausdrücke mittels matches.

• {if value == "foo" || value == "bar"}
• {if value in ["foo", "bar"]}
• {if value matches "^https?://"}

Der SimpleTokenParser-Service ermöglicht außerdem die Verarbeitung von Simple Tokens in eigenen Erweiterungen.

Ressourcen: #1509, #1756

Hervorgehobene Events

Analog zu hervorgehobenen News-Beiträgen ist es nun auch möglich, Events hervorzuheben und diese in den Eventlist-Modulen entsprechend zu filtern.

Ressourcen: #1465

Robots-Tag in News und Events überschreiben

In Contao 4.10 kann neben dem Meta-Titel und der Meta-Beschreibung jetzt auch das Robots-Tag pro News bzw. Event überschrieben werden.

Ressourcen: #1778

Verbesserung der Suche

Die Suchfunktion, insbesondere die Suche mit Platzhaltern, ist in Contao 4.10 spürbar performanter geworden. Außerdem wurde die Sortierung der Ergebnisse insofern verbessert, als dass die Relevanz nicht mehr anhand der Anzahl der Wörter berechnet wird, sondern nach TF-IDF (term frequency-inverse document frequency).

Ressourcen: #1679

Neue Insert-Tags

Mit den neuen Insert-Tags format_date und convert_date kann ein Datum formatiert bzw. von einem Format in ein anderes konvertiert werden.

Ressourcen: #1768

Formulardaten als Excel CSV

Formulardaten können nun auch in einem CSV-Format weitergeleitet werden, das von Microsoft Excel gelesen werden kann.

Ressourcen: #1870

Symfony Mailer

Contao 4.10 nutzt den Symfony Mailer anstatt SwiftMailer.

Ressourcen: #1829

Neue Commands

Mit den Commands contao:user:create und contao:user:list können Backend-Benutzer auf der Kommandozeile hinzugefügt bzw. aufgelistet werden.

Ressourcen: #1463, YouTube-Video

Image Studio

Das Image Studio ist ein Service, mit dem die Bild-Ausgabe einfach konfiguriert werden kann und anschließend einem Template hinzugefügt werden kann. Eine Twig-Extension stellt außerdem einen Helper für diejenigen zur Verfügung, die das Image Studio in Twig nutzen möchten.

Ressourcen: #1753, #1528, Dokumentation, Slack-Ankündigung

Erweiterung des Backend-Access-Voters

Der BackendAccessVoter kann nun alle Berechtigungen eines Backend-Benutzers prüfen. Die Klasse ContaoCorePermissions stellt entsprechende Konstanten zur Verfügung, um die Autovervollständigung der jeweiligen IDE nutzen zu können.

Ressourcen: #1864

Eigene Page-Controller

Mit der neuen @Page()-Annotation können Controller als Seiten markiert werden. Damit unterstützt Contao 4.10 nun folgende Service-Annotations:

Und einiges mehr

Eine Übersicht der weiteren Änderungen findet ihr im Changelog.

Symfony-Kompatibilität

Contao 4.10 ist mit Symfony 4.4 LTS kompatibel.

Hinweise zum Update

In Contao 4.10 kann der Rich-Text-Editor TinyMCE wahlweise in der Version 4 oder in der Version 5 installiert werden. Beim Upgrade von Contao 4.9 wird automatisch TinyMCE 5 installiert, es sei denn, ihr ergänzt vor dem Upgrade folgendes in eurer composer.json:

"require": {
    "contao-components/tinymce4": "^4.7"
}

Solltet ihr hingegen TinyMCE 5 verwenden wollen und können, so denkt bitte daran, eure Templates entsprechend anzupassen. Die TinyMCE-Templates nutzen nun Template-Blöcke, so dass ihr in euren eigenen Templates nicht mehr alles kopieren müsst (siehe #2135).

Siehe auch: Tickets | Versionsvergleich | Changelog