URL Suffix bei Contao anpassen
- 4.4
- 4.9
- 4.13
- 5.3
- 5.7
Vorbereitung unter Contao 4.13
Unter Contao 5 steht die Option sofort zur Verfügung. Um den neuen Routingmodus unter Contao 4.13 zu aktivieren, musst du zuerst den Legacy-Routing-Modus in der Konfigurationsdatei config/config.yml deaktivieren. Folge dazu den Anweisungen im Contao Handbuch.
Einstellungen im Backend anpassen
Die Einstellungen kannst du beim Startpunkt der Website im Bereich "URL-Einstellungen" vornehmen. Wenn du z. B. kein URL-Suffix möchtest, dann lasse das Feld einfach leer.
1. Per (S)FTP mit dem Server verbinden
Per (S)FTP mit dem Server verbinden und in das folgende Verzeichnis wechseln
- Contao 4.9: /config
- Contao 4.4: /app/config
2. Anlegen der config.yml
Wenn noch nicht vorhanden, dann muss zusätzlich zur bereits vorhandenen parameters.yml Datei eine neue config.yml angelegt werden
3. Anpassung der config.yml
Die config.yml wird anschließend geöffnet und der folgende Code eingefügt:
contao:
url_suffix: ""4. Anwendungs-Cache erneuern
Damit die neue Konfiguration in Contao aktiv wird, musst du jetzt per Contao Manager den Anwendungs-Cache neu aufbauen. (Systemwartung > Prod.-Cache erneuern)
Wichtige Hinweise
Hinweis zur Funktionsweise
Die Zeichenfolge zwischen den Anführungszeichen gibt an, was einer URL hinten angestellt werden soll. Setzt du den url_suffix beispielsweise auf "/", dann wird an jede URL ein "/" gehängt. Lässt du die Zeichenfolge leer, wird der URL nichts mehr angefügt und die URL verliert den Zusatz ".html".
Hinweis zur Dateiformatierung
Damit Contao die Datei richtig lesen kann, sollte die Datei im Format "Unicode (UTF-8)" angelegt sein und als Zeilenumbruch "Unix (LF)" verwendet werden.
Wichtiger Hinweis
Wenn du diese Änderung bei einer bestehenden Website durchführst, dann solltest du anschließend unbedingt eine 301-Weiterleitung auf die neuen URLs einrichten, sonst gehen wichtige Rankings bei Google verloren!
Mehr zur Konfiguration einer Umschreibung per .htaccess unter:
https://plenta.io/contao-tipps-und-tricks/contao-4-ohne-html-suffix-seo-optimiert
Empfehlung: Basiskurs für Contao
Wenn du neu bei Contao bist und Webseiten mit Contao erstellen möchtest, dann empfehle ich dir unseren Contao Basiskurs. In unseren Online-Kursen lernst du anhand von praxisorientierten Schritt-für-Schritt-Anleitungen den Einsatz von Contao. Außerdem hast du die Möglichkeit bei Problemen Fragen an unseren Support zu stellen.
Möchtest du über neue Artikel informiert werden?
Dann trage hier deine E-Mailadresse ein und klicke auf „Abonnieren". Du erhältst regelmäßig aktuelle Infos über Contao und die Contao-Academy.
Über den Autor
Christian Feneberg ist der Initiator und Dozent der Contao Academy. Er bringt über 15 Jahre Praxiswissen in der professionellen Umsetzung von Contao-Websites mit. Zudem ist er Teil des Teams von trakked.io. Er liebt es, sich neues Wissen anzueignen und es weiterzugeben. Abseits des Bildschirms verbringt er am liebsten Zeit mit seiner Familie und in der Natur.
Folge Christian jetzt bei LinkedIn.
7 Kommentare
Christian
Hallo Christian,
bin genau wie Jens darüber gestolpert: Für eine Multisite mit mehreren Domains unterschiedliche url_suffix e einstellen zu können.
Die Frage wurde 2018 auch schon mal an die Core-Entwickler gestellt, aber leider nicht beantwortet:
https://github.com/contao/core-bundle/issues/629
Auch die Community hat darauf nichts geantwortet:
https://community.contao.org/de/showthread.php?72022-Ein-Backend-und-mehrere-Seiten-und-dann-noch-verschiedene-URL-Suffixe-M%C3%B6glich
Ich versuche es auch noch mal:
https://github.com/contao/contao/issues/3133
Hallo Christian,
das ist ab Contao 4.10 mit dem neuen Routing möglich. Ich werde den Blogbeitrag noch entsprechend erweitern.
Norman
Danke Christian,
für die letzte (wichtige) Ergänzung. :-)
Wir haben schon wie verrückt gesucht.
Zille
Moin,
Die Umschreibung der URL habe ich schon vor längerer Zeit erfolgreich vorgenommen. Mir geht es deshalb mehr um zukünftige Updates. »Unter Contao 4.8 wurden die Pfade angepasst … Der neue Pfad … «
Auch nach Update auf 4.9.1 existiert der neue Pfad /config/config.yml nicht – muss der "händisch" angelegt werden?
Und soll dann der gesamte Inhalt der alten parameters.yml in die neue config.yml übernommen werden, oder wird dort lediglich der Code für die Umschreibung des suffix eingetragen?
Danke.
Hallo Zille,
beim Update auf Contao 4.9 verschiebst du einfach den kompletten Ordner /app/config nach /config.
Der Ordner /config wird nicht automatisch erstellt. Nur bei einer kompletten Neuinstallation von Contao 4.9 wird der Ordner /config erstellt.
Nach dem Verschieben unbedingt auch den Anwendungscache über den Contao Manager leeren, sonst werden die Änderungen nicht erkannt.
Kurt Zumbrunn
Danke für diese Anleitung.
Die entsprechende Anleitung für Contao 3 enthält noch den Hinweis auf eine 301-Weiterleitung der alten URLs (sonst gehen wichtige Rankings bei Google verloren). Der Tipp könnte auch auf dieser Anleitung für Contao 4 ganz hilfreich sein.
Hallo Kurt,
vielen Dank für die Anmerkung. Ich habe nun einen entsprechenden Hinweis im Artikel eingefügt.
D.S.
Hallo Christian,
danke für die Anleitung. Hat mir sehr weitergeholfen. Da werde ich gleich noch weiter auf der Webseite nach anderen Tipps&Tricks schauen. Ich bin quasi Contao Neuling.
Danke für dein Feedback!
Otto Stiegler
Hallo Christian,
bei der Domain www.hindelang-software.de verwende ich Contao 4.7 mit .php 7.2. neueste Generation.
Ist der Befehl
contao:
url_suffix: ""
so korrekt, ODER soll das mit einfüssigen Anfürhrungszeichen stehen wie
contao:
url_suffix: ' '
?
Bei mir schmiert die Seite mit normalen Anführungszeichen ab. Mit einfüssigen Anführungszeichen bleibt .html trotzdem stehen.
Cache habe ich berücksichtigt.
Gruß Otto
Antwort von Maren Lange
Hallo Otto,
eigentlich sollte beides funktionieren.
Wenn es bei Dir Probleme gibt, vermute ich eher, dass Du den Hinweis zur Dateiformatierung nicht beachtet hast.
Jens
Hallo,
kann man das in der yml-Datei auch so einstellen, dass es für zwei Webseiten unter gleichem Backend unterschiedlich funktioniert? Die eine Domain möchte ich gerne OHNE .html die andere MIT .html laufen lassen ... oder gibt es eine Erweiterung, wo man völlig frei den Alias eingeben kann, also sowohl die Ordner-Struktur als auch ob mit oder ohne .html?
Vielen Dank schon mal! :)
Hallo Jens,
soweit ich weiß, kann man die Einstellung nur pro[nbsp]Installation machen.
Am besten du stellst die Frage noch mal im Contao Forum.
Evt. hat da jemand eine Idee ob das machbar ist.
Einen Kommentar schreiben