---
title: "Theme-Editor"
description: "Ein eigenes Theme ohne CSS-Kenntnisse im Plattform-Admin gestalten: Farben für hell und dunkel, Rundungen, Schriften, Logo, Live-Vorschau und Kontrastprüfung"
---

Mit dem **Theme-Editor** gestalten Sie ein eigenes Theme direkt im Plattform-Admin – ohne CSS-Kenntnisse und ohne ZIP-Datei. Sie wählen Farben, Rundungen, Schriften und Logo, sehen das Ergebnis sofort in einer Vorschau (hell und dunkel) und bekommen Hinweise, wenn Farben schlecht lesbar sind.

Das Ergebnis ist ein ganz normales hochgeladenes Theme: Es hat Fassungen und ein Archiv, lässt sich als ZIP-Datei herunterladen und auf einer anderen Installation hochladen (siehe [Theme installieren](/anpassen/theme-installieren)). Beide Wege passen zusammen – im Editor anfangen, als ZIP herunterladen, mit eigenem CSS verfeinern und wieder hochladen.

<Note>
Denselben Editor gibt es auch je Community: Der Owner gestaltet unter **Einstellungen → Darstellung** ein eigenes Template nur für seine Community – ohne Schlüssel, Logo und App-Icons. Siehe [Darstellung der Community](/handbuch/owner/darstellung).
</Note>

<Frame caption="Plattform-Admin → Darstellung → Theme-Editor">
  ![Theme-Editor mit den Einstellungen Allgemein und Farben links und rechts der Vorschau mit Kopfleiste, Hero-Fläche, Seitentitel, Tabs, Karten, Formularfeldern und Knöpfen sowie dem Kasten Kontrast](/images/handbuch/plattform-admin/theme-editor.png)
</Frame>

## Editor öffnen

- **Neues Theme:** Plattform-Admin → **Darstellung** → **Neues Template erstellen**, eine **Basis** wählen und **Im Editor erstellen** klicken.
- **Vorhandenes Theme bearbeiten:** In der Template-Liste unter **Darstellung** hat jedes mit dem Editor erstellte Theme die Schaltfläche **Im Editor bearbeiten**.

Als Basis eignet sich jedes Theme der Installation:

| Basis | Was übernommen wird |
| --- | --- |
| `quicktribe`, `mitternacht` | Farben, Rundungen und Schriften des mitgelieferten Themes (bei `mitternacht` auch die Gestaltung der Kopfleiste und Knöpfe als eigenes CSS) |
| `arena`, `verein`, `schuetzen`, `reiterhof`, `parcours`, `business` | Farben, Rundungen, beide Schriften samt Lizenz, Emblem (bei `business` auch für dunkel) und App-Icon des mitgelieferten Themes; seine ganze Gestaltung (Kopfleiste, Knöpfe, Hero-Flächen, Palette) als eigenes CSS. Unverändert gespeichert sieht das neue Theme fast aus wie das Original (die Vorschau im Editor zeigt das eigene CSS nur näherungsweise) |
| ein mit dem Editor erstelltes Theme | alle Einstellungen samt Logo und Schriften |
| ein als ZIP hochgeladenes Theme | Name, Standardmodus und Logo; Farben starten mit den Werten von `quicktribe` |

Ein als ZIP hochgeladenes Theme ohne Editor-Daten lässt sich nicht im Editor bearbeiten, nur als Basis für ein neues verwenden. Dasselbe gilt für ein Editor-Theme, dessen `theme.css` oder `theme.json` später von Hand geändert und wieder hochgeladen wurde – sonst gingen diese Änderungen beim nächsten Speichern im Editor verloren.

## Allgemein

| Feld | Bedeutung |
| --- | --- |
| **Name** | Anzeigename in der Template-Auswahl, höchstens 60 Zeichen |
| **Schlüssel** | nur bei einem neuen Theme: Kleinbuchstaben, Ziffern und Bindestrich, höchstens 40 Zeichen; lässt sich später nicht ändern. Die Schlüssel der mitgelieferten Themes und bereits vorhandene sind vergeben |
| **Beschreibung** | optional, erscheint in der Auswahl |
| **Standardmodus** | wie das System, hell oder dunkel – gilt für alle, die nicht selbst hell oder dunkel gewählt haben |

## Farben

Unter **Farben** schalten Sie zwischen **Hell** und **Dunkel** um. Jede Farbe lässt sich über den Farbwähler oder als Wert `#rrggbb` eingeben; die Vorschau folgt sofort.

| Farbe | Wofür |
| --- | --- |
| **Primärfarbe** | Hauptknöpfe, aktive Navigation, aktive Filter und Tabs, Fortschrittsbalken, Hero-Flächen |
| **Hover der Primärfarbe** | Hauptknöpfe beim Überfahren mit der Maus |
| **Text auf Primärfarbe** | Beschriftung auf Primärflächen |
| **Seitenhintergrund** | Hintergrund aller Seiten |
| **Kartenfläche** | Karten, Menüs, Dialoge, Eingabefelder |
| **Kopfleiste** | Hintergrund der Kopfleiste |
| **Textfarbe** | Grundtextfarbe |
| **Fokusfarbe** | Rahmen um das Element, das per Tastatur ausgewählt ist |
| **Akzent (Links)** | Links im Fließtext von Beiträgen, Lektionen und Rechtstexten |

Mit dem Haken **automatisch** leitet der Editor eine Farbe selbst ab:

- **Hover:** etwas heller (bei dunklen Primärfarben) bzw. dunkler als die Primärfarbe.
- **Text auf Primärfarbe:** Weiß oder Schwarz – je nachdem, was auf der Primärfarbe besser lesbar ist.
- **Kopfleiste:** wie die Kartenfläche.
- **Fokus** und **Links:** die Primärfarbe, falls nötig so weit angepasst, dass der Kontrast reicht.

Im **dunklen Modus** schlägt der Editor alle Farben aus den hellen vor (Farbton der Primärfarbe, dunkle Flächen, heller Text). Jede Farbe lässt sich überschreiben; **Alle dunklen Farben neu vorschlagen** stellt alle wieder auf automatisch.

## Kontrastprüfung

Der Kasten **Kontrast** neben der Vorschau prüft laufend, ob Farbpaare nach WCAG AA gut lesbar sind:

- Text (auf Seitenhintergrund, Kartenfläche, Kopfleiste und Primärfarbe) sowie Links brauchen mindestens **4,5 : 1**.
- Primärfarbe gegenüber Fläche und Seitenhintergrund (Knöpfe, Markierungen) und der Fokusrahmen brauchen mindestens **3 : 1**.

Jede Warnung nennt Modus, Farbpaar, gemessenen und nötigen Wert. Die Flächen- und Seitenfarben des aktiven Editor-Themes sind auch die Grundlage, gegen die Communities ihre eigene Primärfarbe prüfen lassen (siehe [Communities mit eigener Farbe und eigenem Logo](/anpassen/theme-gestalten#communities-mit-eigener-farbe-und-eigenem-logo)). Beim Speichern mit Warnungen fragt der Editor nach – **Trotzdem speichern** übernimmt das Theme dennoch. Besser ist, die Farben anzupassen: Schlecht lesbare Farben schließen Menschen mit Sehschwäche aus und sind auf Smartphones in der Sonne kaum zu erkennen.

## Rundungen

Fünf Voreinstellungen – **Eckig**, **Leicht**, **Weich** (wie `quicktribe`), **Rund** und **Pille** (runde Knöpfe) – setzen alle Rundungen auf einmal. Unter **Einzeln anpassen** stellen Sie Knöpfe, Eingabefelder, Karten, große Boxen und Dialoge sowie Hero-Flächen getrennt in Pixeln ein (9999 = Pillenform).

## Schriften

Für **Text** und **Überschriften** stehen Systemschriften zur Auswahl (ohne Serifen, humanistisch, geometrisch, abgerundet, mit Serifen, Slab, Monospace); Überschriften können auch **wie der Text** aussehen. Systemschriften laden nichts nach – angezeigt wird die passende Schrift des jeweiligen Geräts.

Eine **eigene Schrift** laden Sie als **WOFF2-Datei** (höchstens 2 MB) hoch; sie liegt danach im Theme selbst, externe Schrift-Dienste wie Google Fonts sind nicht möglich. Die Auswahl darüber dient als Ersatz, bis die Schrift geladen ist. Dazu gehört die Bestätigung **Ich darf diese Schrift verwenden** (z. B. SIL Open Font License oder eine gekaufte Webfont-Lizenz), optional ein Lizenzhinweis und eine Lizenzdatei (TXT oder MD), die ins Theme gepackt wird. Eine Datei enthält einen Schnitt; variable Schriften decken alle Stärken ab.

## Logo und App-Icons

- **Logo** und optional **Logo für den dunklen Modus:** PNG, WebP, JPEG oder SVG bis 5 MB. Bilder werden neu kodiert (WebP, höchstens 1200 × 300 Pixel); SVG-Dateien werden nach denselben Regeln geprüft wie beim Hochladen eines Themes (keine Skripte, keine fremden Verweise).
- **Plattformname neben dem Logo zeigen:** sonst steht nur das Logo in der Kopfleiste.
- **App-Icons:** Favicon und die Icons der installierten App (192 und 512 Pixel) entstehen automatisch aus einem PNG-, WebP- oder JPEG-Logo. Aus einem SVG-Logo lassen sich keine Icons erzeugen – laden Sie dann ein **eigenes App-Icon** (PNG, WebP oder JPEG, am besten quadratisch) hoch, sonst gelten die Standard-Icons.

Ein unter **Darstellung → Logo** hochgeladenes Logo hat weiterhin Vorrang vor dem Logo des Themes.

## Eigenes CSS (für Fortgeschrittene)

Im aufklappbaren Feld **Eigenes CSS** ergänzen Sie Gestaltung, die über die Einstellungen hinausgeht, etwa für die `data-ui`-Haken (siehe [Theme gestalten](/anpassen/theme-gestalten#data-ui-haken)). Es gelten exakt dieselben Regeln wie beim Hochladen eines Themes (siehe [Sicherheitsregeln](/anpassen/theme-gestalten#sicherheitsregeln-csp)); Fehler zeigt der Editor schon beim Tippen mit Zeilennummer. `url()` darf auf Dateien des Themes verweisen, z. B. `url('fonts/text.woff2')` oder `url('logo.webp')`.

<Note>
Die Vorschau zeigt eigenes CSS näherungsweise und nur innerhalb des Vorschau-Bereichs. Prüfen Sie das Ergebnis nach dem Speichern auf den echten Seiten (siehe [Testen](/anpassen/themes#testen)).
</Note>

## Vorschau

Die Vorschau zeigt eine Muster-Oberfläche mit Kopfleiste und Navigation, Hero-Fläche, Seitentitel, Tabs, Karten mit Link, Plaketten und Fortschrittsbalken, Formularfeldern sowie den Knöpfen primär, sekundär, dezent und gefährlich. Mit **Hell** und **Dunkel** über der Vorschau schalten Sie den Modus um; beim Wechsel der Farben auf **Dunkel** schaltet sie mit.

## Speichern

- **Speichern** legt das Theme an bzw. speichert eine neue Fassung. Die vorige Fassung wandert ins Archiv und lässt sich unter **Darstellung** mit **Vorige Fassung wiederherstellen** zurückholen. Unveränderte Einstellungen erzeugen keine neue Fassung.
- **Speichern und aktivieren** schaltet das Theme zusätzlich für die ganze Plattform ein. Ist das Theme über `APP_TEMPLATE` festgelegt, ist dieser Knopf gesperrt.
- **Als ZIP herunterladen** (bei einem gespeicherten Theme) liefert das Paket wie unter **Darstellung → Herunterladen**.

Hochgeladene Dateien liegen bis zum Speichern in einem Entwurfsbereich und werden nach 24 Stunden automatisch gelöscht, wenn das Theme nicht gespeichert wird. Speichern und Datei-Uploads sind auf 120 je Stunde begrenzt.

## Was im Paket steht

Ein mit dem Editor erstelltes Theme enthält neben `theme.json` und `theme.css` die Datei `editor.json` mit den Einstellungen des Editors, eine `LIESMICH.txt` sowie Logo, Icons und Schriften. Sie können das Paket herunterladen und `theme.css` offline weiter verfeinern – danach öffnet der Editor das Theme nicht mehr (als Basis für ein neues bleibt es nutzbar). Wer zurück in den Editor will, ändert nur dort.
