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

Admin-Designs im Überblick

Die Designs der Administration (admin, admin2, admin3, admin4, admin4l, editor, adminui), wie sie aufeinander aufbauen, was admin4 hinzufügt (Token, Komponenten, dunkler Modus) und die Regeln, die jede Template-Änderung…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/theme-design/admin-designs-overview.md

On this page

This page is a translation. Read the English original

Admin-Designs im Überblick

Diese Seite ist für Designer, die das Aussehen der Administration ändern oder die Admin-Seiten einer Erweiterung gestalten. Sie beantwortet: welche Admin-Designs es gibt, wie sie aufeinander aufbauen und welche Regeln für jedes Template und jedes Stylesheet gelten, das Sie ihnen hinzufügen.

Inhalt

  1. Die Designs
  2. Wie sie aufeinander aufbauen
  3. Was admin4 mitbringt
  4. admin4l: die Administration mit Layouts gezeichnet
  5. Das Design editor
  6. Regeln für jedes Admin-Template
  7. Wie es weitergeht

Die Designs

DesignOrdnerWas es ist
admindesign/admindas klassische Administrationsdesign; zugleich der letzte Rückfall der neueren
admin2, admin3design/admin2, design/admin3Zwischendesigns; admin3 brachte den responsiven Rahmen
admin4design/admin4das aktuelle Design: vollständig und eigenständig, mit Token, gemeinsamen Komponenten und einem dunklen Modus (Das Design admin4)
admin4ldesign/admin4lein dünnes Design auf admin4, dessen Rahmen von Layout-Blöcken gezeichnet wird
editordesign/editorder Siteaccess editor: fast leer, der Unterschied liegt in seinen Einstellungen
adminuiextension/exp_adminui/design/adminuidie Administration AdminUI, mit eigenem Stylesheet und einer Kopie für rechts nach links

Wie sie aufeinander aufbauen

Auf der Demonstrationsinstallation:

Der Kasten Oberfläche in der rechten Spalte mit der Liste Administrationsdesign unten, in der ein Benutzer das Admin-Design wählt
Der Kasten Oberfläche in der rechten Spalte mit der Liste Administrationsdesign unten, in der ein Benutzer das Admin-Design wählt
admin    siteaccess: admin4l > admin4 > admin3 > admin2 > admin > standard
editor   siteaccess: editor > admin4l > admin4 > admin3 > admin2 > admin > standard
adminui  siteaccess: adminui > admin4l > admin4 > admin3 > admin2 > admin > standard

Ein angemeldeter Benutzer kann das Administrationsdesign für sich selbst auch mit dem Oberflächenschalter wechseln (Oberflächenschalter: Design); testen Sie Admin-Änderungen daher in jedem Design, das ein Benutzer wählen kann.

Was admin4 mitbringt

  • Token. Farben, Abstände, Größen, Radius und Schriften sind CSS-Custom-Properties --a4-* in design/admin4/stylesheets/components.css, mit dunklen Werten unter html[data-a4-theme="dark"] (admin4-Token).
  • Gemeinsame Komponenten. .a4-card, .a4-btn, .a4-table, .a4-toolbar, .a4-filterbar, .a4-tag / .a4-badge, .a4-sr-only, .a4-skip-link und mehr, in derselben Datei (admin4-Komponenten).
  • Modul-Stylesheets. Eine Datei pro Bereich in stylesheets/modules/ (setup.css, content.css, people.css, structure.css, workflow.css, help.css), geladen über design.ini [StylesheetSettings] AdminComponentCSSFileList[] (admin4-Modul-Stylesheets).
  • Heller, dunkler und Systemmodus. Ein Skript vor dem ersten Zeichnen (javascript/a4_head.js, von page_head_style.tpl als Datei geladen) setzt data-a4-theme vor dem ersten Zeichnen (Der Theme-Umschalter und der Schutz vor dem ersten Zeichnen).
  • Rechts nach links. Durchgehend logische CSS-Eigenschaften (Designs für rechts nach links).
  • Bereit für Content Security Policy. Keine Inline-Skripte oder -Stile in seinen Templates.

admin4l: die Administration mit Layouts gezeichnet

design/admin4l enthält ein pagelayout.tpl und etwa zwei Dutzend Block-Templates unter templates/explayouts/block/ (admin_logo.tpl, admin_tab_menu.tpl, admin_left_menu.tpl, admin_breadcrumb.tpl, admin_module_result.tpl, admin_footer.tpl, admin_theme_switch.tpl ...). Der Rahmen der Administration ist ein Admin-Layout (Layouttypen admin_3col, admin_2col, admin_full in explayouts.ini), dessen Zonen diese Blöcke enthalten, sodass sich der Rahmen mit dem Layout-Editor umordnen lässt. Das Pagelayout fragt fetch( 'explayouts', 'resolve_admin_layout', hash( 'module', ..., 'view', ... ) ) nach dem Layout der aktuellen View, hinter dem Sicherheitsschalter explayouts.ini [AdminLayoutSettings] Enabled. Alles andere kommt von admin4.

Das Design editor

design/editor enthält nur ein README und leere Ordner. Sein README erklärt, dass das, was die Administration des Redakteurs unterscheidet, in den Einstellungen des Siteaccess steht (settings/siteaccess/editor): weniger Menüreiter, Module, die mit 404 antworten, keine Entwicklerleiste. Fügen Sie dort nur Templates hinzu, wo die Administration des Redakteurs anders aussehen muss.

Regeln für jedes Admin-Template

Das sind die Regeln des Projekts für jedes Admin-Design (admin, admin3, admin4, admin4l und neue) und für Admin-Templates von Erweiterungen; tests/tests/design/AdminStylingRulesTest.php setzt sie durch:

  • Kein <style>-Block und kein style=""-Attribut in einem Template. CSS gehört in die stylesheets/ des Designs.
  • Verwenden Sie die gemeinsamen Komponenten wieder, bevor Sie CSS schreiben; fügen Sie eine neue gemeinsame Komponente nur zentral hinzu, wenn nichts passt.
  • Nur Token für Farben, Radius, Abstände und Schriften; keine fest eingetragenen Werte, keine lokalen Token-Aliasse. Ein Akzent, ein Radius.
  • Jedes neue Farbtoken bekommt einen dunklen Wert für html[data-a4-theme="dark"], in derselben Änderung.
  • Modul-CSS gehört in stylesheets/modules/<group>.css, mit Klassennamen .a4-<module>-*.
  • Prüfen Sie hell und dunkel, bei 1440 px (Skalierung 1) und 960 px mit Skalierung 2 (200 % Zoom): keine weiße Karte auf dunklem Hintergrund, Kontrast mindestens 4,5:1, kein waagrechter Überlauf, keine Fehler in der Konsole.
  • CSS erreicht den Browser über den Packer: Fügen Sie Links nie Versionsabfragen wie ?v= hinzu.

Die Dokumentation für Mitwirkende ist Gestaltung der Administration.

Wie es weitergeht

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