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

Themes sind Erweiterungen

Warum ein Exponential-Theme als Erweiterung mit einem Design-Ordner gepackt wird, was Ihnen das gegenüber dem Bearbeiten der Design-Ordner des Kernels bringt und wie ein Theme mit Designs, Siteaccesses und der…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-6-theme-developers/themes-are-extensions.md

On this page

This page is a translation. Read the English original

Themes sind Erweiterungen

Teil 6, Kapitel 1. Exponential hat keinen eigenen „Theme“-Mechanismus. Ein Theme ist eine Erweiterung, deren wichtigster Inhalt ein Design-Ordner ist: extension/<name>/design/<design name>/ mit Templates, Stylesheets, Skripten und Bildern. Dieses Kapitel erklärt, warum das gut so ist, und führt die drei Begriffe ein, die dieser Teil ständig verwendet.

Drei Begriffe

BegriffBedeutung
Designein benannter Satz von Templates und Dateien, zum Beispiel simple, standard, admin4. Ein Design-Name ist ein Ordnername unter einem Ordner design/
Design-Erweiterungeine Erweiterung, die Design-Ordner beisteuert, registriert in design.ini [ExtensionSettings] DesignExtensions[]
Siteaccessein Einstiegspunkt der Installation (eine öffentliche Website, die Administration, eine Redaktionsseite), der in site.ini [DesignSettings] die Designs wählt, die er verwendet

Ein Theme ist also eine Design-Erweiterung, die ein Design für einen oder mehrere Siteaccesses bereitstellt.

Warum nicht die Design-Ordner des Kernels bearbeiten?

Der Kernel hat sein eigenes design/standard/, design/admin/ und weitere. Sie könnten Ihre Templates dort ablegen. Tun Sie es nicht:

  • Updates überschreiben sie. Die Ordner des Kernels gehören zu den Releases des Kernels.
  • Sie können Ihre Dateien nicht von denen des Kernels unterscheiden. Ein Jahr später weiß niemand mehr, welches Template Sie geändert haben.
  • Sie können das Theme nicht wiederverwenden. Es ist mit einer einzigen Installation vermischt.

In einer Erweiterung hat das Theme seinen eigenen Ordner, sein eigenes Git-Repository, seine eigene Version und Lizenz und lässt sich mit Composer in beliebig viele Websites installieren.

Ein echtes Beispiel

se7enxweb/sevenx_themes_simple ist ein öffentliches Theme, und ein gutes zum Lesen. Auf oberster Ebene hat es genau das, was Teil 3 dieses Buchs für jede Erweiterung beschreibt:

sevenx_themes_simple/
  composer.json  extension.xml  ezinfo.php  LICENSE
  design/simple/            the design "simple"
  settings/                 design.ini and site.ini additions, and per-siteaccess settings
  packages/                 content class packages the theme's templates expect
  translations/             the theme's interface texts

Seine settings/design.ini.append.php beginnt mit der Zeile, die es zu einer Design-Erweiterung macht:

[ExtensionSettings]
DesignExtensions[]=sevenx_themes_simple

Das nächste Kapitel geht den Rest durch: Der Aufbau einer Design-Erweiterung.

Was ein Theme kann und was nicht

Ein Theme kannEin Theme sollte nicht
jedes Template ersetzen, vom Pagelayout bis zur Ansicht eines einzelnen AttributsPHP-Geschäftslogik enthalten (legen Sie sie in eine eigene Erweiterung)
View-Modi und Override-Regeln hinzufügenKernel-Einstellungen ändern, die nichts mit dem Aussehen zu tun haben
Stylesheets, Skripte, Schriften und Bilder mitbringenInhalte ausliefern; liefern Sie Inhaltsklassen stattdessen als Pakete aus (wie sevenx_themes_simple)
Template-Operatoren hinzufügen, die es braucht (in seinem eigenen autoloads/)von den Knoten-IDs einer bestimmten Installation abhängen

Der letzte Punkt ist wichtig, wenn ein Theme geteilt wird: Ein Template, das den Knoten 254 abruft, funktioniert auf Ihrer Website und sonst nirgends. Verwenden Sie für solche Werte Einstellungen mit einem sinnvollen Standardwert.

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