Ein Theme mit dem RAD-Assistenten
Teil 6, Kapitel 3. Am schnellsten beginnen Sie ein Theme mit dem Assistenten Design-Extension in der Administration
(Setup > RAD, Adresse /setup/designextension). Er schreibt in einer Minute ein vollständiges, funktionierendes
Gerüst. Dieses Kapitel nimmt es als Ausgangspunkt und zeigt dann, wie aus dem Gerüst ein Theme wird. Den Assistenten
selbst, Feld für Feld, beschreibt das Tutorial Mit RAD: eine Design-Erweiterung;
den Ablauf, den alle Assistenten teilen, finden Sie in Der Rundgang durch die RAD-Werkzeuge.
1. Den Assistenten ausfüllen
| Feld | Für ein Theme |
|---|---|
| Name der Extension | der Maschinenname des Themes, in Kleinbuchstaben: mytheme |
| Titel | der lesbare Name: My theme |
| Base design | das Design, auf das Ihr Theme für jedes Template zurückfällt, das es nicht hat: meist base oder standard |
| Was hineinkommt | lassen Sie die Vorgaben (Pagelayout, Seitenteile, Stylesheets, JavaScript, Bilder, Template-Overrides, ezinfo.php); kreuzen Sie Siteaccess-Einstellungen an und geben Sie Ihren öffentlichen Siteaccess ein |
| Lizenz | die Lizenz, unter der Sie veröffentlichen werden; GPL-2.0-or-later entspricht dem Kernel |
Sehen Sie sich die Vorschau jeder Datei an und klicken Sie dann auf In extension/ anlegen (oder Als ZIP herunterladen, wenn der Webserver dort nicht schreiben darf).
2. Drei Korrekturen
Die erzeugten Dateien funktionieren, aber drei Dinge sollten Sie sofort ändern. Alle drei wurden beim Schreiben dieses Buchs gefunden, indem eine Design-Erweiterung erzeugt und jede Datei gelesen wurde:
- Der Siteaccess muss das Design nennen. Die erzeugte README sagt, das Design werde ohne weitere Einstellungen
gefunden. Registriert ist es zwar (
DesignExtensions[]), aber ein Siteaccess verwendet es nur, wenn seinesite.ini [DesignSettings]es nennt. Wenn Sie Siteaccess-Einstellungen ankreuzen, wird diese Datei für Sie geschrieben; sonst setzen Sie es selbst (Themes und Siteaccesses). - Verwenden Sie die Frontend-Listen. Die erzeugte
design.ini.append.phpregistriert die Dateien inCSSFileList[]undJavaScriptList[], die der Kernel als veraltet kennzeichnet. Ändern Sie sie inFrontendCSSFileList[]undFrontendJavaScriptList[]; das erzeugte Pagelayout lädt beide. - Aktivieren Sie die Erweiterung. Der Assistent nennt Ihnen die Zeile; solange Sie sie nicht hinzufügen, passiert nichts.
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' mytheme global
php bin/php/ezcache.php --clear-all3. Vom Gerüst zum Theme
Das Gerüst hat ein Pagelayout, einen Kopfbereich, eine Fußzeile, ein Stylesheet, ein Skript und einen Override (Artikel in der Vollansicht). Ein Theme braucht mehr. Arbeiten Sie in dieser Reihenfolge und prüfen Sie die Website nach jedem Schritt:
| Schritt | Dateien | Hilfe |
|---|---|---|
| Der Rahmen | templates/pagelayout.tpl, page_head.tpl, page_header.tpl, page_footer.tpl | Templates für Builder |
| Navigation | ein Menü-Template in templates/parts/, aus dem Kopfbereich eingebunden | Inhalte in Templates abrufen |
| Vollansichten Ihrer Klassen | override/templates/full/<class>.tpl plus je eine Regel | Template-Overrides |
| Listen | override/templates/line/<class>.tpl | View-Modi für Builder |
| Eingebettete Objekte | override/templates/embed/<class>.tpl | dasselbe |
| Formulare und Benutzerseiten | Kopien der user/- und content/-Templates des Kernels, die Sie ändern möchten | Die Design-Kette |
| Styles | stylesheets/site.css, in mehrere Dateien aufgeteilt, wenn es wächst | Theme-Assets, der Packer und CSP |
Kopieren Sie ein Kernel-Template nur dann in Ihr Design, wenn Sie es ändern. Jedes kopierte Template müssen Sie nach jedem Upgrade mit dem des Kernels vergleichen.
4. Unterwegs committen
Stellen Sie das Theme gleich nachdem der Assistent es geschrieben hat unter Git, vor Ihrer ersten Änderung. Dann ist jeder Schritt oben ein Commit, und Sie können jederzeit sehen, was der Assistent geschrieben und was Sie geändert haben.
cd extension/mytheme
git init
git add -A
git commit -m "Added: The theme skeleton written by the design extension wizard"Was schiefgehen kann
| Symptom | Ursache | Lösung |
|---|---|---|
| Die Website sieht unverändert aus | der Siteaccess nennt das Design nicht, oder die Erweiterung ist nicht aktiv | Kapitel Themes und Siteaccesses |
| Ein neues Template wird nicht verwendet | der Template-Override-Cache | php bin/php/ezcache.php --clear-id=template,template-override |
| Das Stylesheet fehlt | es steht in einer veralteten Liste, die das Pagelayout nicht liest, oder der Packer-Cache ist alt | prüfen Sie die Namen der Listen; leeren Sie die Caches |
| Die Seite ist unter dem Kopfbereich leer | ein Fehler in einem Template | schalten Sie Debug-Ausgabe und Template-Debugging ein (Templates debuggen) |
Verwandte Seiten
- Zurück: Der Aufbau einer Design-Erweiterung
- Weiter: Ein Theme von Hand
- Mit RAD: eine Design-Erweiterung
- RAD-Werkzeuge
- 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.