--- title: Kategorien description: Kategorien in CrispyCMS verstehen, anlegen und konfigurieren. navIcon: "🗂️" --- import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert" import { Badge } from "@/components/ui/badge" import { Icon } from "@/components/ui/icon" ## Kategorien und Seiten — Baum und Blätter CrispyCMS organisiert Inhalte in einer Baumstruktur: **Kategorien** bilden die Äste, **Seiten** die Blätter. Eine Kategorie ist ein Container, der andere Kategorien oder Seiten aufnehmen kann. Sie definiert einen URL-Pfad (z. B. `/blog` oder `/leistungen/webentwicklung`) und gibt allen darin enthaltenen Seiten ihre Position innerhalb der Website-Struktur. Seiten selbst tragen den eigentlichen Inhalt — Text, Bilder, Medien — und hängen immer an **genau einer Kategorie**. Diese Hierarchie lässt sich beliebig tief verschachteln: eine Kategorie kann Unterkategorien enthalten, die wiederum weitere Unterkategorien oder Seiten aufnehmen. --- ## Kategorien verwalten Der Menüpunkt **Redaktion → Kategorien** öffnet die Baumansicht aller Kategorien Ihrer Website, ausgehend vom **Wurzelverzeichnis**. Ein Klick auf eine Kategorie öffnet rechts daneben das Bearbeiten-Panel. ![Kategorienübersicht als Baumstruktur ausgehend vom Wurzelverzeichnis](../assets/img/redaktion/kategorien-uebersicht.png) ### Eine neue Kategorie erstellen Mit einem Klick auf **+ Erstellen** oben rechts öffnet sich der Dialog zum Anlegen einer Kategorie. ![Dialog Kategorie erstellen mit Name, übergeordneter Kategorie und Eigenschaften](../assets/img/redaktion/kategorien-erstellen.png) | Feld | Beschreibung | | :--- | :--- | | **Name** | Der sichtbare Name der Kategorie, z. B. „Leistungen" oder „Blog". Daraus wird automatisch der Slug abgeleitet. | | **Übergeordnete Kategorie** | Die Kategorie, in der die neue Kategorie angelegt wird. Bestimmt zusammen mit dem Slug den vollständigen URL-Pfad. Ohne Auswahl entsteht die Kategorie im Wurzelverzeichnis. | | **Kategorien Eigenschaften** | Die Schalter **Öffentlich**/**Privat** und **Feeds** — siehe die Abschnitte „Sichtbarkeit" und „Feed-Modus" weiter unten in diesem Kapitel. | ### Eine Kategorie bearbeiten Ein Klick auf eine Kategorie im Baum öffnet das Panel **Kategorie Bearbeiten** mit allen Details: ![Panel Kategorie Bearbeiten mit ID, Name, Slug, erzwungener Vorlage und Eigenschaften](../assets/img/redaktion/kategorien-bearbeiten.png) | Feld | Beschreibung | | :--- | :--- | | **ID** | Die eindeutige interne Kennung der Kategorie, schreibgeschützt. | | **Name** | Der sichtbare Name der Kategorie. | | **Slug** | Der URL-Bestandteil der Kategorie, z. B. `blog`. Ergibt zusammen mit dem Pfad der übergeordneten Kategorie die vollständige URL. | | **Erzwungene Vorlage** | Optional. Ist hier eine Vorlage gesetzt, müssen alle Seiten in dieser Kategorie **und** ihren Unterkategorien diese Vorlage verwenden. Bereits bestehende Seiten mit einer anderen Vorlage behalten ihre aktuelle Vorlage, bis sie geändert wird. | | **Kategorien Eigenschaften** | Dieselben Schalter wie beim Erstellen: Öffentlich/Privat und Feeds. | Über **Verschieben** ordnen Sie die Kategorie samt allen enthaltenen Unterkategorien und Seiten einer anderen übergeordneten Kategorie zu. **Löschen** entfernt die Kategorie unwiderruflich — enthaltene Seiten und Unterkategorien werden dabei ebenfalls entfernt. **Speichern** übernimmt Ihre Änderungen. Löschen wirkt rekursiv Beim Löschen einer Kategorie werden alle enthaltenen Unterkategorien und Seiten mit gelöscht — auch tief verschachtelte. Es gibt keine Wiederherstellung über die Oberfläche. Prüfen Sie vor dem Löschen sorgfältig den Inhalt der Kategorie. --- ### Kategorie-Startseite Eine Seite kann in den [Erweiterten Eigenschaften](/benutzerhandbuch/redaktion/seiten#spezialoptionen) als **Kategorie-Startseite** markiert werden. Sie wird dann ausgeliefert, wenn ein Besucher den URL-Pfad der Kategorie direkt aufruft — also ohne weiteren Slug dahinter (z. B. `/blog`). --- ## Sichtbarkeit Jede Kategorie kann auf **Öffentlich** oder **Privat** gestellt werden. Eine private Kategorie ist nicht öffentlich zugänglich — das gilt automatisch und rekursiv für alle enthaltenen Unterkategorien und Seiten, unabhängig von deren eigener Einstellung. Rekursiver Effekt Wenn Sie eine Kategorie auf Privat setzen, werden alle darin enthaltenen Inhalte — auch tief verschachtelte Unterkategorien und Seiten — sofort aus der öffentlichen Sicht genommen. Prüfen Sie daher vor der Änderung, welche Unterseiten betroffen sind. ### Sichtbarkeit beim Verschieben Wird eine Kategorie in eine andere verschoben, behält sie ihren eigenen Status. Das bedeutet: - Eine **private** Kategorie bleibt privat, auch wenn sie in eine öffentliche Eltern-Kategorie verschoben wird. - Eine **öffentliche** Kategorie behält den Status „Öffentlich", auch wenn sie in eine private Eltern-Kategorie verschoben wird — sie ist dann jedoch trotzdem nicht erreichbar, weil die übergeordnete Kategorie privat ist. Der eigene Status einer Kategorie und die Erreichbarkeit über die Eltern-Hierarchie sind damit zwei unabhängige Dinge. --- ## Feed-Modus (RSS & JSON) Kategorien können als Feed betrieben werden. Im Feed-Modus stellt CrispyCMS die Inhalte einer Kategorie maschinenlesbar bereit — nützlich etwa für Blog-Abonnements, Aggregatoren oder eigene Integrationen. Ist der Feed-Modus für eine Kategorie aktiv, sind folgende URLs erreichbar: | URL | Beschreibung | | :--- | :--- | | `/meine/kategorie.rss` | RSS-Feed aller Seiten der Kategorie | | `/meine/kategorie.json` | JSON-Feed aller Seiten der Kategorie | | `/meine/seite.json` | Einzelne Seite als JSON abrufbar | Benutzerdefinierte Eigenschaften in Feeds Benutzerdefinierte Eigenschaften von Seiten werden in Feeds vollständig ausgegeben. Tragen Sie dort keine vertraulichen Informationen ein — sie sind für jeden öffentlich auslesbar, sobald der Feed-Modus aktiv ist.