Fehlersuche bei Theme-Erweiterungen
Diese Seite ist für Designer und Administratoren, wenn sich ein Theme nicht wie erwartet verhält. Suchen Sie das Anzeichen, lesen Sie die Ursache, wenden Sie die Abhilfe an. Für Probleme innerhalb von Templates siehe Ein Design debuggen und Häufige Template-Fehler.
| Sie sehen | Wahrscheinliche Ursache | Abhilfe |
|---|---|---|
| Die Website zeigt das Standard-Design | Die Erweiterung ist nicht aktiv oder registriert ihr Design nicht | Ein Theme aktivieren, Das Design registrieren; den INI-Cache leeren |
| Die Administration verwendet plötzlich das Theme | Das Theme setzt SiteDesign global | SiteDesign in den Siteaccess der Website verschieben (Die Design-Einstellungen, die ein Theme mitliefert) |
Eine neue .tpl-Datei wird ignoriert; die Seite ist leer | Der Cache der Template-Overrides hat noch die alte Liste | php bin/php/ezcache.php --clear-id=template-override --allow-root-user |
| Das Template eines anderen Themes gewinnt | Ladereihenfolge | Ladereihenfolge und welches Theme gewinnt |
| Die Seite Über zeigt einen Strich als Version | ezinfo.php oder extension.xml fehlt sie, oder extension.xml hat einen anderen Wert | Alle Versionsfelder synchron halten |
Composer legt das Theme nach extension/my-theme | extra.ezpublish-legacy-extension-name fehlt | Der Composer-Installer und der Ordnername |
| „Unknown template operator“ für den Operator des Themes | autoloads/eztemplateautoload.php oder ExtensionAutoloadPath[] fehlt | Template-Operatoren in einem Theme |
| Eine neue PHP-Klasse wird nicht gefunden | Autoload-Array nicht neu erzeugt oder PHP-Dienst nicht neu geladen | php bin/php/ezpgenerateautoloads.php -e, dann PHP-FPM oder Velocity neu laden |
| Texte des Themes bleiben englisch | TranslationExtensions[] fehlt, oder der Übersetzungs-Cache | Übersetzungen in einem Theme |
| Ein geändertes Stylesheet erreicht den Browser nicht | Das gepackte Stylesheet ist im Cache | Packer- und Template-Block-Cache leeren (Packer-Cache und Deployment); den Browser hart neu laden |
| Das Exportieren des Themes wird verweigert | Das Exportieren ist aus, oder die Geheimnisprüfung hat etwas gefunden | Eine Erweiterung als Paket exportieren, Die Geheimnisprüfung |
| Hochladen Ihres Pakets: „existiert bereits“ | Ein Paket dieses Namens liegt auf dieser Installation | Das alte dort entfernen oder Ihres umbenennen |
Ein allgemeines Vorgehen
- Leeren Sie die Caches:
php bin/php/ezcache.php --clear-all --allow-root-user. - Erzeugen Sie die Autoloads neu:
php bin/php/ezpgenerateautoloads.php -e. - Laden Sie den PHP-Dienst neu, der die Website ausliefert.
- Schalten Sie das Template-Debugging für Ihre eigene IP-Adresse ein und lesen Sie die Pfadkommentare.
- Prüfen Sie
var/log/error.logund die Debug-Ausgabe der Website.
Bleibt das Problem und halten Sie es für einen Fehler in Exponential, melden Sie es (Wenn etwas schiefgeht).
Verwandte Seiten
- Checkliste: Die Theme-Erweiterung ist bereit
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.