Benutzerhandbuch

Dieses Handbuch bietet eine praktische Anleitung zur Verwendung des ADP Car Market Hub WordPress Plugins. Es richtet sich an das Personal von Garagen, B2B-Kunden und alle, die im täglichen Betrieb mit dem Plugin interagieren – von der Überprüfung importierter Fahrzeuge über die Verwaltung von Leads bis hin zum Verständnis dessen, was das Frontend den Kunden anzeigt.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie:

• Ein Administrator oder Redaktor sind, der für die Pflege des Fahrzeugbestands auf einer durch dieses Plugin betriebenen WordPress Website verantwortlich ist.
• Verstehen müssen, was das Plugin tut und wie seine Hauptbereiche funktionieren.
• Lernen möchten, wie Sie durch die Admin-Benutzeroberfläche navigieren, Importe überwachen, Leads überprüfen und das Frontend kontrollieren.

Für einen tieferen Fokus auf administrative Verantwortlichkeiten, Berechtigungen und Systemzustand lesen Sie bitte das Administrator-Handbuch.

---

Übersicht

ADP Car Market Hub verbindet eine WordPress Website mit einer Live-Fahrzeugquelle (der AutoScout24 API, mobile.de oder carcuro) – unter mehreren auf der Verbindungsseite verfügbaren Datenquellen – und importiert Fahrzeugangebote als WordPress Beiträge. Es verwaltet den gesamten Lebenszyklus eines Fahrzeugangebots: Abrufen der Daten von der Quelle, Speichern in WordPress, Anzeigen im Frontend und Erfassen von Kundenanfragen.

Das Plugin verwendet einen dedizierten Custom Post Type (as24ci_car) und 15 Fahrzeugattribut-Taxonomien (Marke, Karosserietyp, Kraftstoffart, Getriebe, Zustand und andere). Dadurch werden Fahrzeugdaten über native WordPress Archivseiten, Taxonomieseiten und Shortcodes verfügbar gemacht.

Importierte Fahrzeuge werden als WordPress Beiträge mit dem Status publish oder draft erstellt, je nach konfigurierter Standardeinstellung. Alle zugehörigen Bilder werden heruntergeladen und an den Beitrag angehängt. Fahrzeug-Metadaten – Preis, Kilometerstand, Motorspezifikationen, Ausstattung und mehr – werden in den Beitrags-Metadaten und einer dedizierten Datenbanktabelle gespeichert.

Das Plugin fügt der WordPress Admin-Seitenleiste drei Hauptmenüs hinzu, die direkt unter dem WordPress Dashboard gruppiert sind:

• CMH Center – der Hauptarbeitsbereich des Plugins (Dashboard, Car Importer, Leads, Content Studio, Einstellungen und alle anderen Tools).
• CMH Cars – der Fahrzeugbestand selbst (der Beitragstyp as24ci_car), in dem einzelne Fahrzeugdatensätze aufgelistet, bearbeitet und veröffentlicht werden.
• CMH Team – vom Plugin verwaltete Verkaufsansprechpartner der Garage, die auf den Fahrzeugdetailseiten angezeigt und zur Weiterleitung von Leads verwendet werden können.

Die Labels behalten das feste Markenpräfix "CMH" und übersetzen nur das Wort danach (zum Beispiel "CMH Zentrale" / "CMH Fahrzeuge" / "CMH Team" im Deutschen).

---

Anforderungen oder Voraussetzungen

Bevor Sie das Plugin verwenden, müssen die folgenden Voraussetzungen erfüllt sein:

• WordPress 6.2 oder neuer und PHP 8.1 oder neuer sind erforderlich.
• Das Plugin muss von einem WordPress Administrator installiert und aktiviert sein.
• Eine Datenquelle muss auf der Seite Verbindungen verbunden sein. Für AutoScout24 bedeutet dies API-Zugangsdaten (API-Basis-URL, Seller ID(s), Client ID, Client Secret, Token URL und Audience), die von AutoScout24 oder Ihrem Integrationspartner bereitgestellt wurden; für mobile.de bedeutet dies API-Zugangsdaten; für carcuro bedeutet dies ein carcuro-Firmentoken. Passwörter und Secrets werden verschlüsselt gespeichert. Ohne eine verbundene Quelle können keine Fahrzeuge importiert werden.
• Die WordPress Website muss in der Lage sein, ausgehende HTTPS-Verbindungen zum konfigurierten API-Endpunkt herzustellen.
• Für den Bildimport muss das WordPress Upload-Verzeichnis für den Webserver beschreibbar sein.

---

---

Schritt-für-Schritt-Anleitungen

Navigation zum Plugin

1. Melden Sie sich im WordPress-Admin-Dashboard an.
2. Klicken Sie in der linken Seitenleiste auf CMH Center, um das Hauptmenü des Plugins auszuklappen. (CMH Cars und CMH Team sind zwei weitere Menüs auf oberster Ebene direkt darunter.)
3. Das Menü CMH Center enthält die folgenden Einträge, geordnet nach dem Arbeitsablauf der Garage (zuerst die täglichen operativen Einstiegspunkte, dann Geschäftsanalysen, Marketing- und Ausgabetools, Design- und Konfigurationsbereiche und schliesslich technische Tools, Logs, System und Support). Die Reihenfolge ist in jeder Sprache dieselbe, auch wenn die sichtbaren Beschriftungen übersetzt sind. Eine vollständige Übersicht über alle Ansichten finden Sie in der Admin-Referenz und der Admin-Menü-Übersicht.

Optionale Funktionen (AI Assistant, Content Studio, Analytics, Market Insights, Search Alerts, Locations, EnVKV / Energy, PDF Manager) werden erst nützlich, wenn die entsprechende Konfiguration hinterlegt ist; die Menüeinträge selbst sind jedoch immer vorhanden. Das Content Studio und einige operative Bereiche erfordern unter Umständen auch eine aktive Lizenz, bevor sie genutzt werden können.

Die Menüs CMH Cars und CMH Team

Zwei zusätzliche Menüs auf oberster Ebene befinden sich direkt unter CMH Center:

• CMH Cars listet jedes importierte Fahrzeug auf (der Custom Post Type as24ci_car). Öffnen Sie CMH Cars → All Cars, um einzelne Fahrzeugdatensätze zu überprüfen, zu bearbeiten, zu veröffentlichen oder in den Papierkorb zu verschieben. Fahrzeugentwürfe werden hier verwaltet, nicht im standardmässigen WordPress-Bildschirm Beiträge.
• CMH Team verwaltet die vom Plugin gesteuerten Verkaufsansprechpartner der Garage. Sie können Teammitglieder hinzufügen (Name, Foto, E-Mail, Telefon), standortbezogene und globale Standardkontakte festlegen, einzelnen Fahrzeugen einen Kontakt zuweisen und automatische Zuweisungsregeln definieren. Der ermittelte Ansprechpartner wird auf der Fahrzeugdetailseite angezeigt und als bevorzugter Empfänger für Leads verwendet. Teammitglieder benötigen nie ein eigenes WordPress-Login. Siehe CMH Team and Contact Routing.

Nutzung des Dashboards

Der Dashboard-Tab bietet eine geschäftliche Übersicht über den Fahrzeugbestand:

• KPI-Zeile – zeigt wichtige Kennzahlen wie die Gesamtzahl der veröffentlichten Fahrzeuge, Entwürfe, in den letzten 7 Tagen hinzugefügte Fahrzeuge und Indikatoren für die Kundeninteraktion.
• Fahrzeug-Vollständigkeit – zeigt Vollständigkeitsindikatoren an, z. B. Fahrzeuge ohne Bilder oder Kurzbeschreibungen.
• Handlungsbedarf – hebt direkt lösbare Probleme im aktuellen Bestand hervor.
• Bestandstrend-Diagramm – zeigt die im Laufe der Zeit importierten Neufahrzeuge.
• Kundeninteresse-Diagramm – zeigt die Seitenaufrufe im Zeitverlauf (erfordert die Aktivierung der Analytics-Funktion).
• Beliebteste Fahrzeuge – listet Fahrzeuge nach Aufrufen oder Leads auf.
• Letzte Leads – zeigt die neuesten Kundenanfragen an, die über das Kontaktformular eingegangen sind.

Die Dashboard-Daten werden für ca. 3 Minuten zwischengespeichert. Laden Sie die Seite neu, um sie zu aktualisieren.

Nutzung des Car Importers

Der Car Importer-Tab zeigt alle Angebote an, die aus der verbundenen Live-Quelle (dem oder den konfigurierten AutoScout24-Verkäuferkonten, mobile.de oder carcuro) verfügbar sind.

1. Navigieren Sie zu CMH Center → Car Importer.
2. Die Seite zeigt zwei Tabellen: - Importierte Fahrzeuge – Angebote, die bereits in WordPress vorhanden sind. - Ausstehende Fahrzeuge – über die API verfügbare Angebote, die noch nicht importiert wurden.
3. Verwenden Sie das Suchfeld, um Angebote nach Marke, Modell oder anderen Identifikatoren zu filtern.
4. Um ein einzelnes Fahrzeug zu importieren, klicken Sie auf die Schaltfläche Import neben dem Angebot.
5. Um ein bereits importiertes Fahrzeug erneut zu importieren (zu aktualisieren), klicken Sie auf die Schaltfläche Re-import.
6. Um ein einzelnes Fahrzeug aus WordPress zu entfernen, klicken Sie auf die Schaltfläche Delete. Dadurch werden der Beitrag und die angehängten Bilder dauerhaft gelöscht.
7. Um mehrere Fahrzeuge gleichzeitig zu importieren oder zu löschen, verwenden Sie die Kontrollkästchen und das Dropdown-Menü für Massenaktionen.
8. Verwenden Sie die Steuerung Einträge pro Seite, um die Anzahl der angezeigten Angebote anzupassen.

Ausführen eines manuellen Vollimports

Ein manueller Vollimport (Batch-Wizard) verarbeitet alle Remote-Angebote nacheinander:

1. Navigieren Sie zu CMH Center → Import & Limits.
2. Klicken Sie auf Start Import Now (oder die entsprechende Schaltfläche auf dieser Registerkarte), um den Batch-Wizard zu starten.
3. Ein Fortschrittsbalken zeigt die Anzahl der verarbeiteten Fahrzeuge, die geschätzte verbleibende Zeit und den aktuellen Status an.
4. Sie können den Import jederzeit pausieren, fortsetzen oder abbrechen.
5. Nach Abschluss des Imports zeigt die Statuszusammenfassung, wie viele Fahrzeuge hinzugefügt, aktualisiert oder übersprungen wurden.

Leads überprüfen

Leads sind Einsendungen von Kundenkontaktformularen, die über die Fahrzeugdetailseiten eingehen.

1. Navigieren Sie zu CMH Center → Leads.
2. Die Lead-Liste zeigt das Sendedatum, den Kundennamen, die E-Mail-Adresse, die Telefonnummer, die Nachricht und das Fahrzeug, auf das sich die Anfrage bezog.
3. Jeder Lead hat einen Status: New, Contacted, Closed oder Spam. Ändern Sie den Status, während Sie die jeweilige Anfrage bearbeiten.
4. Um alle Leads (oder gefilterte Leads) in eine CSV-Datei zu exportieren, klicken Sie auf die Schaltfläche Export CSV. Die Datei enthält ein UTF-8-BOM für die korrekte Darstellung in Microsoft Excel.
5. Um einen Lead zu löschen, verwenden Sie die Löschaktion daneben.

Überprüfung im Frontend

Nach dem Import der Fahrzeuge erscheinen diese im Frontend gemäss Ihrer WordPress-Permalink- und Template-Konfiguration:

• Die Fahrzeug-Archivseite listet alle veröffentlichten Fahrzeuge in einem kartenbasierten Rasterlayout mit Filtersteuerungen auf.
• Einzelne Fahrzeugdetailseiten zeigen das vollständige Angebot: Bildergalerie, Spezifikationstabelle, Ausstattungsliste, Beschreibung, Preis, Kontaktformular, Finanzierungsrechner (falls aktiviert) und Probefahrtformular (falls aktiviert).
• Die Vergleichsseite (über den Shortcode [as24ci_compare]) ermöglicht es Besuchern, ausgewählte Fahrzeuge direkt miteinander zu vergleichen.
• Die Favoritenseite (über den Shortcode [as24ci_favorites]) zeigt die vom Besucher gespeicherten Fahrzeuge an.

So überprüfen Sie die Fahrzeug-Archivseite:

1. Öffnen Sie im WordPress-Admin-Bereich Seiten und überprüfen Sie, ob die Archivseite existiert und veröffentlicht ist.
2. Vergewissern Sie sich unter CMH Cars → All Cars, dass die einzelnen Fahrzeuge veröffentlicht sind, und klicken Sie dann auf Anschauen, um die Frontend-Seite zu öffnen und zu prüfen, ob die Fahrzeuge angezeigt werden.
3. Wenn die Seite leer ist oder einen Fehler anzeigt, überprüfen Sie die Seite Connections, um sicherzustellen, dass die Quelle verbunden ist (und dass die AutoScout24-Zugangsdaten und Seller-IDs korrekt sind), und prüfen Sie den Tab Logs auf Importfehler.

---

---

Konfigurationsreferenz

Die folgenden Einstellungen sind für reguläre Benutzer relevant. Die vollständige Konfigurationsdokumentation finden Sie im Abschnitt Admin-Referenz.

---

Betriebliche Hinweise

• Änderungserkennung: Der Importer speichert einen Inhalts-Hash und einen Bild-Hash für jedes importierte Fahrzeug. Bei wiederholten Importen werden Fahrzeuge, deren Daten sich nicht geändert haben, übersprungen. Dies hält die Importläufe schnell.
• Full Sync: Wenn Full Sync auf der Registerkarte "Import & Limits" aktiviert ist, wird jedes Fahrzeug, das im Remote-Live-Inserat (AutoScout24, mobile.de oder carcuro) nicht mehr vorhanden ist, dauerhaft aus WordPress gelöscht, einschliesslich seiner angehängten Bilder. Aktivieren Sie diese Option nur, wenn der lokale Bestand die Live-Quelle exakt widerspiegeln soll.
• Bildwarteschlange: Bei geplanten (Cron-)Importen wird nur das erste Bild pro Fahrzeug sofort heruntergeladen. Die restlichen Bilder werden asynchron von einem Hintergrund-Queue-Worker verarbeitet. Dies verhindert PHP-Ausführungszeitüberschreitungen bei grossen Importen. Die Warteschlange wird ungefähr alle 5 Minuten abgearbeitet.
• Entwurfsfahrzeuge: Fahrzeuge, die mit dem Beitragsstatus draft importiert wurden, werden in WordPress gespeichert, sind aber im Frontend nicht öffentlich sichtbar. Sie können in der Liste CMH Cars → All Cars überprüft und manuell veröffentlicht werden.
• Taxonomien: Fahrzeugdaten werden in 15 nativen WordPress-Taxonomien gespeichert. Taxonomie-Archive (zum Beispiel alle Fahrzeuge einer bestimmten Marke) sind ohne zusätzliche Konfiguration verfügbar.
• Übersetzungen: Das Plugin ist über die Textdomäne adp-car-market-hub vollständig übersetzbar. Übersetzungen müssen separat bereitgestellt werden.
• Log-Rotation: Die Log-Datei des Plugins wird automatisch rotiert, wenn sie 10 MB überschreitet. Vorherige Log-Dateien werden mit einem Zeitstempel archiviert.

---

Fehlerbehebung

---

Verwandte Dokumente

• Administrator-Handbuch
• Tägliche Arbeitsabläufe
• Arbeitsablauf für den Fahrzeugimport
• Arbeitsabläufe im Lead-Management
• Arbeitsabläufe im Frontend
• Verbindungsreferenz