Custom Post Types und Taxonomien

Dieses Dokument beschreibt die vom Plugin ADP Car Market Hub registrierten Custom Post Types und Taxonomien: welche Slugs sie verwenden, wie sie konfiguriert sind, welche Berechtigungen sie erfordern und wie sie im WordPress-Admin erscheinen.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument, wenn Sie:

• Die genauen Post-Type- und Taxonomie-Slugs in benutzerdefinierten Abfragen, Templates oder Theme-Code referenzieren müssen.
• Verstehen möchten, welche Rollen Fahrzeuge und Leads bearbeiten können.
• Eine benutzerdefinierte Integration, REST-Abfrage oder WP_Query für Fahrzeugdaten planen.

Für Details auf Spalten- und Feldebene siehe Database Schema und Data Model.

Übersicht

Das Plugin registriert zwei Custom Post Types und 15 Fahrzeugattribut-Taxonomien:

• as24ci_car — öffentlicher Custom Post Type, der ein einzelnes Fahrzeuginserat darstellt. Registriert durch AS24CI\CPT.
• as24ci_lead — privater Custom Post Type, der Kontaktformular-Einsendungen speichert. Registriert durch AS24CI\Leads_CPT.
• 15 nicht-hierarchische Taxonomien, die an as24ci_car angehängt sind. Registriert durch AS24CI\Taxonomies.

Alle übersetzbaren Strings verwenden die Textdomain adp-car-market-hub.

Anforderungen oder Voraussetzungen

Für die Registrierung dieser Objekte ist keine zusätzliche Konfiguration erforderlich. Die Post Types und Taxonomien werden bei der Aktion WordPress init registriert, wann immer das Plugin aktiv ist.

Wenn Sie Fahrzeuge oder Leads über die REST-API abfragen möchten, beachten Sie bitte, dass nur as24ci_car freigegeben ist (show_in_rest ist true). Der Post Type as24ci_lead hat absichtlich show_in_rest auf false gesetzt.

Der Post Type as24ci_car

Registriert in AS24CI\CPT::register_post_type() auf init mit Priorität 5. Schlüsselkonfiguration:

Da map_meta_cap aktiviert ist, ordnet WordPress generische Berechtigungen (wie edit_post) dem benutzerdefinierten Singular/Plural-Set des Plugins zu.

Permalinks

Jedes Fahrzeug wird unter /cars/<slug>/ veröffentlicht. Der Importer stellt über AS24CI\Importer::ensure_slug_has_listing_id() sicher, dass der Slug mit der AutoScout24 Listing ID endet, damit die URL bei Re-Importen stabil bleibt. Nach der Aktivierung werden die Rewrite-Regeln einmalig geleert, sodass das /cars/-Archiv sofort funktioniert. Wenn das Archiv einen 404-Fehler zurückgibt, rufen Sie Einstellungen → Permalinks auf und speichern Sie einmal, um den Rewrite-Cache neu aufzubauen.

Berechtigungen

AS24CI\Plugin::ensure_roles_and_caps() gewährt das Berechtigungsset as24ci_car / as24ci_cars an:

• Die benutzerdefinierte Rolle as24ci_editor (wird bei der Aktivierung erstellt, falls sie nicht existiert).
• Die Rolle administrator.

Die Berechtigung manage_as24_imports (Plugin::CAP_MANAGE) schützt die Benutzeroberfläche für Importer, Einstellungen, Tools und Logs und wird nur Administratoren gewährt. WordPress-Benutzer («Redakteur») erhalten nicht automatisch Fahrzeugberechtigungen.

Admin-UI: Meta-Boxen

AS24CI\CPT::register_meta_boxes() fügt dem Bearbeitungsbildschirm für Fahrzeuge zwei Meta-Boxen hinzu:

• AutoScout24 API Import (as24ci_details_editable) — kombinierte Meta-Box, die Folgendes enthält:
• Die Tabs «Fahrzeugdaten», einer pro Mapping-Gruppe, die in AS24CI\Field_Mapping::GROUPS definiert ist (ausser Ausstattung, die durch AS24CI\Equipment_Metabox gerendert wird).
• Den Block AutoScout24 Ausstattung (gerendert durch AS24CI\Equipment_Metabox::render_metabox()).
• Die kombinierte Galerie (manuelle + importierte Bilder).
• Badges (as24ci_badges) — Sidebar-Metabox, mit der der Bearbeiter die automatische Erkennung von Neu / Gebraucht / Aktion manuell überschreiben und das Flag «Top-Angebot» umschalten kann. Die automatische Erkennung basiert auf den Spalten condition_type, price und list_price des Fahrzeugs; manuelle Überschreibungen werden in den Postmeta-Feldern _as24ci_badge_override_new, _as24ci_badge_override_used, _as24ci_badge_override_sale und _as24ci_top_offer gespeichert.

Schreibgeschützte Felder

Felder, die ausschliesslich vom Importer verwaltet werden, sind im Bearbeitungsformular als schreibgeschützt markiert. Die Liste ist in AS24CI\CPT::FORM_READONLY_KEYS definiert und umfasst:

• Identifikation: _as24ci_id, _as24ci_seller_id, _as24ci_seller_vehicle_id, _as24ci_serial_number, _as24ci_vin, _as24ci_external_id, _as24ci_certification_number.
• Status und Zeitstempel: _as24ci_status, _as24ci_status_last_modified, _as24ci_created_date, _as24ci_last_modified_date.
• Quell-Flags: _as24ci_live, _as24ci_language, _as24ci_version_identification_method.

Lange Werte (_as24ci_teaser, _as24ci_description, _as24ci_images) werden als Textareas gerendert. Numerische Felder (Preis, Kilometerstand, Abmessungen usw.) werden als <input type="number"> gerendert.

Manuelle Galerie

Die kombinierte Galerie-Auswahl speichert manuell ausgewählte Anhang-IDs im Postmeta-Schlüssel _as24ci_manual_image_ids. Manuelle Galerie-Anhänge werden absichtlich als benutzerdefiniert behandelt und niemals durch den Lösch- oder Deinstallationscode des Plugins entfernt, selbst wenn importierte Anhänge gelöscht werden.

Admin-Listen-Spalten

AS24CI\CPT fügt der Admin-Liste Cars benutzerdefinierte Spalten hinzu (beispielsweise ein Vorschaubild und einen Stern für «Top-Angebot»). Die Spalte für das Vorschaubild wird über Inline-CSS skaliert, das auf dem Bildschirm edit.php für den Post Type injiziert wird.

Der Post Type as24ci_lead

Registriert in AS24CI\Leads_CPT::register_post_type() auf init mit Priorität 5. Schlüsselkonfiguration:

Lead-Beiträge sind in den standardmässigen WordPress-Admin-Listen nicht sichtbar, da das Plugin einen dedizierten Tab für die Verwaltung von Leads bereitstellt. Der Text der Kontaktformular-Einsendung wird als Beitragstitel (Name des Besuchers) und in Postmeta-Schlüsseln gespeichert, die durch AS24CI\Leads_CPT::save_lead() definiert sind:

• _as24ci_lead_name, _as24ci_lead_email, _as24ci_lead_phone, _as24ci_lead_message
• _as24ci_lead_vehicle_id, _as24ci_lead_vehicle_title, _as24ci_lead_vehicle_listing_id, _as24ci_lead_vehicle_url
• _as24ci_lead_source_url, _as24ci_lead_date, _as24ci_lead_email_sent
• _as24ci_lead_status (einer von new, contacted, closed, spam; Standardwert ist new)
• _as24ci_lead_appointment_date, _as24ci_lead_is_test_drive (für Probefahrt-Buchungen)

Die gültigen Statuswerte sind als Konstanten auf AS24CI\Leads_CPT freigegeben (STATUS_NEW, STATUS_CONTACTED, STATUS_CLOSED, STATUS_SPAM).

Fahrzeug-Taxonomien

AS24CI\Taxonomies::register_all() registriert 15 nicht-hierarchische Taxonomien, die an as24ci_car angehängt sind. Jede Taxonomie wird mit denselben Optionen registriert:

Taxonomie-Referenz

Die obigen Labels sind die unübersetzten Quell-Strings. Die tatsächlichen Labels, die in der Admin-UI gerendert werden, werden über die Textdomain adp-car-market-hub übersetzt.

Begriff-URLs (Term-URLs)

Da jede Taxonomie public ist und query_var aktiviert hat, sind Begriffe über standardmässige WordPress-Taxonomie-URLs erreichbar (zum Beispiel /as24ci_brand/<term-slug>/). Diese URLs steuern die Archivfilter und können in benutzerdefinierten Navigationsmenüs oder Theme-Widgets verwendet werden.

Anzeigewerte

AS24CI\Taxonomies::get_display_value() ist der kanonische Helper für das Rendern eines kategorischen Fahrzeugfelds im Frontend. Er bevorzugt den Namen des Taxonomie-Begriffs (der im Admin-Bereich umbenannt werden kann, ohne den Link zu den importierten Daten zu verlieren) und fällt auf den rohen Postmeta-Wert zurück, wenn kein Begriff zugewiesen ist.

Schritt-für-Schritt-Anleitung

Die Post Types und Taxonomien erfordern keine manuelle Einrichtung. Die folgenden Arbeitsabläufe sind typisch:

1. Aktivieren Sie das Plugin. WordPress führt den Aktivierungs-Hook aus, der Rollen und Berechtigungen erstellt und die Rewrite-Regeln leert. Das Archiv /cars/ ist sofort verfügbar.
2. Führen Sie den Importer aus. Importierte Inserate werden in den Post Type as24ci_car geschrieben, wobei ihre Taxonomie-Begriffe durch den Mapper zugewiesen werden.
3. Bearbeiten Sie ein Fahrzeug. Öffnen Sie ein Fahrzeug über das Admin-Menü CMH Cars. Verwenden Sie die Meta-Box AutoScout24 API Import, um importierte Felder zu überschreiben (vorbehaltlich der oben genannten schreibgeschützten Liste), und die Meta-Box Badges, um zu steuern, welche Badges angezeigt werden.
4. Verwalten Sie Taxonomien. Verwenden Sie die Untermenü-Einträge von CMH Cars (Marke, Modell, Karosserieform usw.), um Begriffe umzubenennen, zusammenzuführen oder auszublenden. Das Umbenennen eines Begriffs aktualisiert das angezeigte Label auf der gesamten Website, da get_display_value() den Begriffsnamen gegenüber dem rohen Wert bevorzugt.
5. Verwalten Sie Leads. Verwenden Sie den dedizierten Admin-Tab Leads. Die zugrunde liegenden as24ci_lead-Beiträge werden in der standardmässigen WordPress-Beitragsliste nicht angezeigt.

---

Konfigurationsreferenz

Betriebliche Hinweise

• Der Post-Typ und die Taxonomien werden bei init registriert. Benutzerdefinierter Code, der diese ausliest, darf frühestens bei init Priorität 5 ausgeführt werden.
• Das Abfragen von Fahrzeugen über WP_Query ist unkompliziert (post_type => 'as24ci_car'). Für typisierte numerische Abfragen oder Bereichsabfragen sollte die dedizierte Tabelle as24_vehicles über AS24CI\Vehicle_Repository bevorzugt werden, da Postmeta-basierte Abfragen bei grossen Katalogen langsam sein können.
• Das Umbenennen eines Taxonomie-Begriffs aktualisiert das Frontend-Label sofort und erfordert keinen erneuten Import: Der Helper Taxonomies::get_display_value() liest den Begriffnamen direkt aus.
• Wenn das Plugin entfernt wird, während as24ci_delete_data_on_uninstall auf 1 gesetzt ist, werden alle as24ci_car- und as24ci_lead-Beiträge sowie die in _as24ci_image_ids erfassten Anhänge gelöscht. Manuelle Galerie-Anhänge und Taxonomie-Begriffe werden nicht automatisch entfernt.

Fehlerbehebung

• /cars/ gibt einen 404-Fehler zurück. Rufen Sie Einstellungen → Permalinks auf und speichern Sie einmal, um die Rewrite-Regeln neu zu generieren. Das Plugin führt dies bereits bei der Aktivierung durch, sodass ein 404-Fehler meist bedeutet, dass ein Drittanbieter-Plugin oder ein Theme die Rewrite-Regeln überschrieben hat.
• Ein Benutzer mit der Rolle Redakteur (Editor) kann keine Fahrzeuge bearbeiten. Redakteure erhalten nicht automatisch das Berechtigungsset as24ci_car. Weisen Sie ihnen entweder die Rolle as24ci_editor zu oder fügen Sie die Berechtigungen des Plugins über Ihr Rollenverwaltungstool zur Rolle Redakteur hinzu.
• Importierte Ausstattungsänderungen gehen beim nächsten Import verloren. Der Ausstattungsblock wird vom Importer verwaltet. Änderungen, die in der Ausstattungs-Metabox vorgenommen werden, können überschrieben werden, es sei denn, sie laufen über die manuelle Override-Ebene, die im Datenmodell beschrieben ist. Überprüfen Sie das Verhalten in der aktuellen Plugin-Version, bevor Sie sich auf manuelle Bearbeitungen der importierten Ausstattung verlassen.
• Lead-Beiträge erscheinen in einer generischen Admin-Liste. Der Post-Typ setzt show_ui auf false; wenn Leads in einer benutzerdefinierten Admin-Ansicht erscheinen, überschreibt ein Drittanbieter-Plugin oder ein Filter den Standard. Verwenden Sie den integrierten Leads-Tab für das Lead-Management.

Zugehörige Dokumente

• Architektur-Übersicht
• Datenmodell
• Datenbankschema
• Speicherung von Optionen und Einstellungen
• Sektionsübersicht