Search Documentation

Search for pages and headings in the documentation

Kategorien

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

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

FeldBeschreibung
NameDer sichtbare Name der Kategorie, z. B. „Leistungen” oder „Blog”. Daraus wird automatisch der Slug abgeleitet.
Übergeordnete KategorieDie 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 EigenschaftenDie 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

FeldBeschreibung
IDDie eindeutige interne Kennung der Kategorie, schreibgeschützt.
NameDer sichtbare Name der Kategorie.
SlugDer URL-Bestandteil der Kategorie, z. B. blog. Ergibt zusammen mit dem Pfad der übergeordneten Kategorie die vollständige URL.
Erzwungene VorlageOptional. 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 EigenschaftenDieselben 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.


Kategorie-Startseite

Eine Seite kann in den Erweiterten Eigenschaften 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.

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:

URLBeschreibung
/meine/kategorie.rssRSS-Feed aller Seiten der Kategorie
/meine/kategorie.jsonJSON-Feed aller Seiten der Kategorie
/meine/seite.jsonEinzelne Seite als JSON abrufbar