Fragen und Antworten

Hier findest du eine Sammlung der häufigsten Fragen mit den passenden Antworten.

Wenn du selbst einen Vorschlag für diesen Bereich hast, verwende den Link »Diese Seite bearbeiten« oben rechts. Besitzt du ein GitHub-Konto und bist angemeldet, erstellt GitHub automatisch einen Fork, in dem du deine Vorschläge hinzufügen kannst. Anschließend kannst du über GitHub einen Pull-Request erstellen.

Allgemein

Ich habe mein Administrator-Passwort vergessen, wie kann ich es zurücksetzen?

Falls es in der Datenbank-Tabelle »tl_user« mehrere Datensätze gibt, bei denen das Admin-Flag gesetzt ist, kannst du den Wert zunächst bei allen zurücksetzen, um anschließend im Contao Install-Tool einen neuen Administrator anzulegen.

Ich habe das Install-Tool Passwort vergessen, wie kann ich es zurücksetzen?

Entferne in der Datei »system/config/localconfig.php« die Zeile beginnend mit $GLOBALS['TL_CONFIG']['installPassword'] vollständig. Anschließend kannst du über das Install-Tool ein neues Passwort vergeben.

Kann ich mit Contao mehrere Webseiten pflegen?

Ja. Contao unterstützt den Multidomain-Betrieb und Mehrsprachige Webseiten.

Kann ich mit Contao »Mehrsprachige Webseiten« pflegen?

Ja. Contao unterstützt Mehrsprachige Webseiten.

Wie aktiviere ich den Contao Debug-Modus?

Du kannst den Contao Debug-Modus über das Backend aktivieren.

Wo finde ich weitere Contao-Ressourcen?

Weitere Contao-Ressourcen findest du auf der Projektwebseite.

Darf ich Contao für kommerzielle Projekte verwenden?

Ja, die GNU Lesser General Public License (LGPL), unter der Contao seit der Version 2.5 lizenziert ist, erlaubt die Verwendung des Systems für kommerzielle Projekte. Beachte jedoch, dass die Copyright-Hinweise in den Contao-Dateien gemäß den Lizenzbedingungen nicht entfernt oder verändert werden dürfen.

Wie kann ich über die Konsole den »Anwendungs-Cache« erneuern?

Falls du den »Anwendungs-Cache« erneuern möchtest kannst du dies über die Konsole durchführen:

vendor/bin/contao-console cache:clear --no-warmup
vendor/bin/contao-console cache:warmup

Template

Wie kann ich alle Variablen meines Templates anzeigen?

Die Information hierzu findest du unter Template-Daten anzeigen.

Wie kann ich den TinyMCE-Editor konfigurieren?

Die Information hierzu findest du unter TinyMCE-Editor Konfiguration.

Installation

Meldung: Ihr Datenbank-Server läuft nicht im Strict-Mode!

Es handelt sich um einen Hinweis wie du den Strict Mode aktivieren kannst. Weitere Informationen findest du hier.

Konfiguration und Einstellung

Kann ich das Verzeichnis »web« nach »public« ändern?

Ja. Du mußt dazu das Verzeichnis umbenennen. Überprüfe ob in der »composer.json« der Eintrag "public-dir": "web" existiert und entferne diesen oder ändere den Eintrag auf public. Setze dann dieses Verzeichnis als Document Root über das Admin-Panel deines Hosting-Providers. Starte anschließend über den Manager oder der Konsole composer install.

Wie kann ich den Contao Backend-Pfad ändern?

ab 4.13 Du kannst in der config.yaml den Eintrag route_prefix hinzufügen. Anschließend musst du über den Contao-Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.

# config/config.yaml
contao:
    backend:
        route_prefix: '/myadmin'
Es wird keine E-Mail über mein Formular versendet, was muss ich machen?

Überprüfe in der parameters.yaml die SMTP-Angaben deines Hosters oder füge diese hinzu. Anschließend musst du über den Contao-Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.

Kann ich eine andere E-Mail-Adresse als Absender für Formulare benutzen?

Die im Bereich »Einstellungen > E-Mail-Adresse des Systemadministrators« gesetzte E-Mail-Adresse wird u. a. auch als Absender für Formulare herangezogen. Du kannst im Bereich »Seitenstruktur« für den Seitentyp »Startpunkt einer Webseite« eine zusätzliche E-Mail-Adresse eintragen. Anschließend wird diese dann als Absender genutzt. Ab Contao 4.10 kannst du dies konfigurieren.

Wie kann ich das Sprachkürzel der URL hinzufügen?

Du kannst in der config.yaml den Eintrag prepend_locale: true hinzufügen. Anschließend musst du über den Contao-Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.

# config/config.yaml
contao:
    prepend_locale: true
Kann man die URL Suffix ».html« entfernen?

Du kannst in der config.yaml den Eintrag url_suffix: '' hinzufügen. Anschließend musst du über den Contao-Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.

# config/config.yaml
contao:
    url_suffix: ''
Warum werden meine HTML-Angaben im TinyMCE-Editor nicht übernommen?

Antworten findest du im Bereich TinyMCE-Editor Konfiguration.

Dateiverwaltung

Meine Bilder werden im Frontend nicht angezeigt, was kann ich machen?

Überprüfe in der Dateiverwaltung, ob das Verzeichnis mit deinen Bildern als »Öffentlich« gekennzeichnet ist. Stelle außerdem sicher, dass sich keine veraltete .htaccess Datei im Order /web oder einem übergeordneten Ordner deiner Installation befindet.

Kann man die Suche in der Dateiverwaltung ausblenden?

Ja. Über einen DCA-Eintrag:

    //contao/dca/tl_files.php
    unset($GLOBALS['TL_DCA']['tl_files']['list']['sorting']['panelLayout']);

Theme

Warum werden Änderungen an meinen SCSS-Dateien nicht übernommen?

Bei Änderungen an einer SCSS Partial-Datei musst du im Anschluss in der »Systemwartung« den Scriptcache leeren.

Contao Manager

Wozu benötige ich den Contao Manager?

Du benötigst den Contao Manager, um Contao und Erweiterung zu installieren/aktualisieren/deinstallieren. Weiterführende Informationen findest du unter Über den Contao Manager.

Kann ich den Contao Manager einer bestehenden Installation hinzufügen?

Ja, der Contao Manager erkennt bei der Installation deine bestehende Contao Installation.

Wie kann man den Contao Manager aktualisieren?

Der Contao Manager führt beim Aufruf automatisch im Hintergrund eine Prüfung durch. Sollte eine neue Version verfügbar sein, aktualisiert sich der Contao Manager selbst.

Was ist die Composer Resolver Cloud?

Die Composer Resolver Cloud erlaubt die Installation von Composer-Abhängigkeiten über den Contao Manager, selbst wenn dein Server nicht über genug Arbeitsspeicher verfügt.

Wie kann ich über den Contao-Manager den »Anwendungs-Cache« erneuern?

Falls du den »Anwendungs-Cache« erneuern möchtest kannst du dies im Contao Manager im Bereich »Systemwartung/Anwendungs-Cache« durchführen.

Der Contao Manager hat sich »aufgehangen«

Sollte es vorkommen, dass der Contao Manager nicht mehr reagiert, das Fenster der Konsolenausgabe sich nicht schließen lässt oder nach einem Reload der Manager-Seite man immer wieder zur selben Ausgabe kommt, lösche im Verzeichnis contao-manager die Datei task.json.

Anschließend sollte der Contao Manager wieder laufen.

Kann ich die ».phar« Datei umbenennen?

Ja. Du kannst einen beliebigen Dateinamen verwenden. Allerdings ist der Contao Manager dann nicht mehr über das Backend erreichbar. In diesem Fall kannst du die config.yaml entsprechend anpassen. Anschließend musst du über den Contao Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.

# config/config.yaml
contao_manager:
    manager_path: dein-name.phar.php