Custom Post Type (CPT)

Ein Custom Post Type (CPT) ist ein eigener Inhaltstyp in WordPress, der über die beiden Standard-Inhaltstypen „Beiträge“ und „Seiten“ hinausgeht. Mit CPTs lassen sich beliebige Arten von Inhalten strukturiert verwalten – etwa Produkte, Referenzen, Teammitglieder, Veranstaltungen, Rezepte oder, wie auf dieser Website, Wiki-Einträge. Custom Post Types machen WordPress von einem reinen Blog-System zu einem flexiblen Content-Management-System.

Technischer Hintergrund

WordPress bringt von Haus aus mehrere Post Types mit: post (Beiträge), page (Seiten), attachment (Medien), revision (Revisionen) und nav_menu_item (Menüpunkte). Eigene Post Types werden über die PHP-Funktion register_post_type() registriert, typischerweise in einem Plugin oder in der functions.php eines Themes.

Bei der Registrierung wird festgelegt, welche Funktionen der CPT unterstützt: Titel, Editor, Beitragsbild, Auszug, Kommentare, Revisionen und mehr. Außerdem wird konfiguriert, ob der CPT öffentlich sichtbar sein soll, ob er in der REST API verfügbar ist, ob er im Block-Editor bearbeitet werden kann und welche URL-Struktur (Slug) verwendet wird.

Custom Post Types können mit eigenen Taxonomien verknüpft werden, um die Inhalte zu kategorisieren und zu filtern. Über ACF oder ähnliche Plugins lassen sich zusätzlich benutzerdefinierte Felder (Custom Fields) hinzufügen, die strukturierte Daten pro Eintrag speichern.

Bedeutung für die WordPress-Wartung

CPTs sind ein mächtiges Werkzeug, bringen aber Abhängigkeiten mit sich. Wird ein CPT über ein Plugin registriert und dieses Plugin deaktiviert, verschwinden die zugehörigen Inhalte aus dem Backend und Frontend – die Daten bleiben zwar in der Datenbank erhalten, sind aber nicht mehr zugänglich. Das macht die Wahl des Plugins und dessen langfristige Pflege zu einer wichtigen Entscheidung.

Bei Migrationen und Backups müssen CPTs und ihre zugehörigen Meta-Daten mitberücksichtigt werden. Auch die URL-Struktur (Permalinks) muss nach Änderungen an einem CPT neu gespeichert werden, damit die Seiten korrekt erreichbar sind.

Häufige Probleme

• Inhalte werden unsichtbar, wenn das Plugin, das den CPT registriert, deaktiviert oder gelöscht wird.
• Permalink-Konflikte, wenn der Slug eines CPT mit einer bestehenden Seite oder einem anderen CPT kollidiert.
• Fehlende REST-API-Unterstützung, die dazu führt, dass der CPT nicht im Block-Editor bearbeitet werden kann.
• Performance-Probleme bei sehr vielen Einträgen ohne angemessene Indizierung der Datenbank.
• Registrierung des CPT im Theme statt in einem Plugin – beim Theme-Wechsel gehen die Inhalte verloren.

Best Practices

• Custom Post Types immer in einem Plugin registrieren, nicht im Theme, damit die Daten auch nach einem Theme-Wechsel erhalten bleiben.
• Aussagekräftige, aber kurze Slugs verwenden und auf Konflikte mit bestehenden Seiten oder WordPress-internen Routen prüfen.
• Die REST-API-Unterstützung aktivieren (show_in_rest), um den Block-Editor und moderne Integrationen zu ermöglichen.
• Regelmäßige Backups sicherstellen, die auch die CPT-Daten und zugehörigen Meta-Felder umfassen.
• Bei der Planung eines CPT die Taxonomie-Struktur mitdenken, um Inhalte sinnvoll filterbar und auffindbar zu machen.