Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Ein Theme mit dem RAD-Assistenten

Beginnen Sie ein Theme mit dem Assistenten Design-Extension unter Setup > RAD und machen Sie aus seinem Gerüst ein echtes Theme - Siteaccess, Frontend-Listen, Basis-Design, Seitenteile, Ansichts-Templates - mit drei…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-6-theme-developers/a-theme-with-the-rad-wizard.md

On this page

This page is a translation. Read the English original

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

FeldFür ein Theme
Name der Extensionder Maschinenname des Themes, in Kleinbuchstaben: mytheme
Titelder lesbare Name: My theme
Base designdas Design, auf das Ihr Theme für jedes Template zurückfällt, das es nicht hat: meist base oder standard
Was hineinkommtlassen Sie die Vorgaben (Pagelayout, Seitenteile, Stylesheets, JavaScript, Bilder, Template-Overrides, ezinfo.php); kreuzen Sie Siteaccess-Einstellungen an und geben Sie Ihren öffentlichen Siteaccess ein
Lizenzdie 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:

  1. 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 seine site.ini [DesignSettings] es nennt. Wenn Sie Siteaccess-Einstellungen ankreuzen, wird diese Datei für Sie geschrieben; sonst setzen Sie es selbst (Themes und Siteaccesses).
  2. Verwenden Sie die Frontend-Listen. Die erzeugte design.ini.append.php registriert die Dateien in CSSFileList[] und JavaScriptList[], die der Kernel als veraltet kennzeichnet. Ändern Sie sie in FrontendCSSFileList[] und FrontendJavaScriptList[]; das erzeugte Pagelayout lädt beide.
  3. 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-all

3. 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:

SchrittDateienHilfe
Der Rahmentemplates/pagelayout.tpl, page_head.tpl, page_header.tpl, page_footer.tplTemplates für Builder
Navigationein Menü-Template in templates/parts/, aus dem Kopfbereich eingebundenInhalte in Templates abrufen
Vollansichten Ihrer Klassenoverride/templates/full/<class>.tpl plus je eine RegelTemplate-Overrides
Listenoverride/templates/line/<class>.tplView-Modi für Builder
Eingebettete Objekteoverride/templates/embed/<class>.tpldasselbe
Formulare und BenutzerseitenKopien der user/- und content/-Templates des Kernels, die Sie ändern möchtenDie Design-Kette
Stylesstylesheets/site.css, in mehrere Dateien aufgeteilt, wenn es wächstTheme-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

SymptomUrsacheLösung
Die Website sieht unverändert ausder Siteaccess nennt das Design nicht, oder die Erweiterung ist nicht aktivKapitel Themes und Siteaccesses
Ein neues Template wird nicht verwendetder Template-Override-Cachephp bin/php/ezcache.php --clear-id=template,template-override
Das Stylesheet fehltes steht in einer veralteten Liste, die das Pagelayout nicht liest, oder der Packer-Cache ist altprüfen Sie die Namen der Listen; leeren Sie die Caches
Die Seite ist unter dem Kopfbereich leerein Fehler in einem Templateschalten Sie Debug-Ausgabe und Template-Debugging ein (Templates debuggen)

Verwandte Seiten

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x