Administrator-Handbuch

Dieses Handbuch dokumentiert die administrativen Verantwortlichkeiten für das ADP Car Market Hub WordPress Plugin. Es umfasst die Eigenverantwortung bei der Ersteinrichtung, Benutzerberechtigungen, die Importkonfiguration, geplante Abläufe, die Überwachung des Systemzustands und die Support-Koordination.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie:

• Ein WordPress-Administrator sind, der für die Installation, Konfiguration und Wartung des Plugins verantwortlich ist.
• Verstehen müssen, welche Berechtigungen erforderlich sind und wie diese verwaltet werden.
• Dafür verantwortlich sind, dass Importe zuverlässig laufen, und Fehler untersuchen müssen.
• Sich mit dem technischen Support oder einem Integrationspartner abstimmen.

Für alltägliche betriebliche Aufgaben wie das Überprüfen des Importstatus, das Prüfen von Leads und das Validieren des Frontends siehe Tägliche Arbeitsabläufe.

---

Übersicht

ADP Car Market Hub erfordert eine sorgfältige Erstkonfiguration, bevor Fahrzeuge importiert werden können. Der Administrator ist verantwortlich für:

• Die Eingabe und Pflege gültiger API-Zugangsdaten.
• Die Konfiguration des Import-Zeitplans und die Wahl zwischen WP-Cron und Server-Cron.
• Das Festlegen des korrekten Standard-Beitragsstatus, des Autors, der Bildverarbeitung und der Währung.
• Das Gewähren oder Einschränken des Zugriffs auf die Admin-Benutzeroberfläche des Plugins.
• Die Pflege der Autohaus-Ansprechpartner für den Verkauf, die den Kunden angezeigt und für die Lead-Weiterleitung verwendet werden (CMH Team).
• Die Überwachung des Systemzustands des Plugins, der Protokollausgabe und des Importerfolgs.
• Die Abstimmung mit AutoScout24 oder Ihrem Integrationspartner, wenn API-Probleme auftreten.

---

Anforderungen oder Voraussetzungen

• WordPress-Administratorzugriff ist erforderlich, um das Plugin zu installieren und Berechtigungen zu verwalten.
• PHP 8.1 oder höher und WordPress 6.2 oder höher müssen auf dem Server laufen.
• Gültige AutoScout24 API-Zugangsdaten (API-Basis-URL, Seller ID(s), Client ID, Client Secret, Token-URL, Audience) müssen vor der Einrichtung von AutoScout24 oder Ihrem Integrationspartner bezogen werden. Ohne diese kann das Plugin keine Fahrzeuge importieren.
• Der Server muss ausgehende HTTPS-Verbindungen zum konfigurierten API-Endpunkt zulassen.
• Wenn der Server-Cron gegenüber WP-Cron bevorzugt wird, muss die Hosting-Umgebung geplante Aufgaben (Crontab oder Ähnliches) unterstützen.

---

Berechtigungen und Fähigkeiten

Plugin-Verwaltungsberechtigung

Das Plugin führt eine benutzerdefinierte WordPress-Berechtigung ein: manage_as24_imports.

• Diese Berechtigung ist erforderlich, um auf das ADP Car Market Hub-Admin-Menü zuzugreifen, Importe auszuführen, Einstellungen zu ändern, Leads anzuzeigen und alle Admin-Tools zu nutzen.
• Bei der Aktivierung wird WordPress-Administratoren (Rolle administrator) automatisch manage_as24_imports gewährt.
• Andere Benutzerrollen (Redakteur, Shop-Manager usw.) erhalten diese Berechtigung standardmäßig nicht. Ein WordPress-Administrator muss sie explizit über ein Rollenverwaltungs-Plugin oder benutzerdefinierten Code zuweisen, wenn ein Zugriff für Nicht-Administratoren erforderlich ist.

WordPress Beitragsberechtigungen

Der benutzerdefinierte Beitragstyp as24ci_car (das Menü CMH Cars) verwendet eigene, dedizierte WordPress-Berechtigungen (edit_as24ci_cars, publish_as24ci_cars usw.). Fahrzeugdatensätze erscheinen unter CMH Cars → All Cars, nicht in der standardmäßigen WordPress-Ansicht Beiträge. Der Zugriff auf die dedizierten Plugin-Admin-Seiten unter CMH Center und CMH Team erfordert zusätzlich manage_as24_imports.

Schutz sensibler Einstellungen

API-Zugangsdaten (Client ID und Client Secret) werden in der Optionstabelle von WordPress gespeichert. Der Zugriff auf den Reiter „Einstellungen“ ist durch manage_as24_imports geschützt. Stellen Sie sicher, dass nur vertrauenswürdige Administratoren über diese Berechtigung verfügen.

---

Ersteinrichtung

Befolgen Sie diese Schritte, wenn Sie das Plugin zum ersten Mal konfigurieren:

1. Installieren und aktivieren Sie das Plugin über WordPress-Admin → Plugins → Installieren oder durch Hochladen des Plugin-Archivs.
2. Navigieren Sie zu ADP Car Market Hub → Settings.
3. Geben Sie die API-Basis-URL für Ihre AutoScout24-Umgebung ein. Typische Basis-URLs sind die regionalen AutoScout24 API-Hosts (überprüfen Sie die korrekte URL mit AutoScout24 oder Ihrem Integrationspartner).
4. Geben Sie eine oder mehrere Seller IDs (kommagetrennt) ein, die Ihrem AutoScout24-Händlerkonto entsprechen.
5. Geben Sie die von AutoScout24 bereitgestellte Client ID und das Client Secret ein.
6. Geben Sie die Token-URL und die Audience ein, falls diese von den aus der Basis-URL abgeleiteten Standardwerten abweichen.
7. Stellen Sie die Standardwährung so ein, dass sie mit der in Ihren Inseraten verwendeten Währung übereinstimmt.
8. Konfigurieren Sie den Standard-Beitragsstatus (publish, um Fahrzeuge sofort sichtbar zu machen, draft, um sie vor der Veröffentlichung zu überprüfen).
9. Legen Sie den Standard-Beitragsautor auf den WordPress-Benutzer fest, der als Autor der Fahrzeugbeiträge aufgeführt werden soll.
10. Konfigurieren Sie die Einstellungen für den Bildimport: ob Bilder importiert werden sollen, die maximale Anzahl von Bildern pro Fahrzeug und Optionen zur WebP-Konvertierung.
11. Aktivieren Sie die Option Standardseiten erstellen, damit das Plugin automatisch das Fahrzeugarchiv und die Vergleichsseiten erstellt.
12. Klicken Sie auf Einstellungen speichern.
13. Verwenden Sie den Verbindungstest auf dem Reiter System & Help oder Tools, um zu bestätigen, dass die API-Zugangsdaten funktionieren.
14. Navigieren Sie zu Import & Limits und führen Sie den ersten vollständigen Import mit dem Batch-Wizard aus.

---

Konfiguration des Import-Zeitplans

WP-Cron (Standard)

WordPress verfügt über ein integriertes Cron-System (WP-Cron), das bei Seitenaufrufen ausgelöst wird. Dies ist für viele Websites ausreichend, kann sich jedoch auf Websites mit geringem Traffic verzögern.

1. Navigieren Sie zu ADP Car Market Hub → Import & Limits.
2. Aktivieren Sie den Automatischen Import.
3. Wählen Sie das Intervall: stündlich, alle 6 Stunden, zweimal täglich, täglich oder ein benutzerdefiniertes Intervall (mindestens 15 Minuten).
4. Legen Sie für tägliche und zweimal tägliche Zeitpläne die bevorzugte Startzeit fest.
5. Speichern Sie die Automatisierungseinstellungen.

Server-Cron (empfohlen für Produktivsysteme)

Für eine zuverlässige Zeitplanung konfigurieren Sie einen externen Server-Cron, der den REST-Endpunkt des Plugins aufruft:

1. Navigieren Sie zu ADP Car Market Hub → Import & Limits.
2. Stellen Sie den Cron-Modus auf Server-Cron.
3. Kopieren Sie die angezeigte Cron-Endpunkt-URL (enthält ein Sicherheits-Token).
4. Fügen Sie einen Cron-Job auf Ihrem Server hinzu (beispielsweise über crontab), um diese URL im gewünschten Intervall mittels curl oder wget aufzurufen.
5. Wenn Sie das Token neu generieren müssen (z. B. nach einem Sicherheitsvorfall), klicken Sie auf demselben Reiter auf Token neu generieren und aktualisieren Sie Ihren Server-Cron-Job mit der neuen URL.

Importsperre

Das Plugin verwendet eine auf Transients basierende Sperre (ca. 40 Minuten), um überschneidende Importläufe zu verhindern. Wenn bereits ein Importlauf aktiv ist und ein zweiter Auslöser eingeht (über WP-Cron, Server-Cron oder manuell), wird der zweite Durchlauf übersprungen. Dies ist ein normales Verhalten.

---

Verwalten von Bildimporten

• Bild-Warteschlangenmodus: Bei geplanten Cron-Importen wird zunächst nur das erste Bild pro Fahrzeug sofort heruntergeladen. Die restlichen Bilder werden von einem Hintergrund-Warteschlangen-Prozess etwa alle 5 Minuten verarbeitet. Dies verhindert PHP-Timeout-Fehler bei großen Importen.
• Überwachung der Bild-Warteschlange: Der Reiter System & Help zeigt die aktuelle Größe der Bild-Warteschlange und eine Warnung an, wenn die Warteschlange 1.000 Elemente überschreitet.
• Manuelle Verarbeitung der Warteschlange: Verwenden Sie die Schaltfläche Bild-Warteschlange jetzt ausführen auf dem Reiter System & Help, um die Warteschlange sofort abzuarbeiten.
• Bild-Warteschlange leeren: Die Schaltfläche Bild-Warteschlange leeren auf demselben Reiter entfernt alle ausstehenden Bildeinträge, ohne sie zu verarbeiten. Verwenden Sie dies mit Vorsicht.
• WebP-Konvertierung: Wenn aktiviert, werden heruntergeladene Bilder mit GD oder Imagick in das WebP-Format konvertiert. Der Reiter System & Help zeigt an, ob diese Erweiterungen verfügbar sind.

---

Full Sync

Full Sync ist eine Einstellung auf dem Reiter Import & Limits, die bei Aktivierung jeden Fahrzeugbeitrag in WordPress dauerhaft löscht, der im Live-Bestand von AutoScout24 für den oder die konfigurierten Verkäufer nicht mehr vorhanden ist.

Verwenden Sie Full Sync nur, wenn Sie möchten, dass WordPress den Live-Bestand von AutoScout24 exakt widerspiegelt. Wenn aktiviert:

• Wird jeder lokale Fahrzeugbeitrag, der im aktuellen Remote-Bestand nicht gefunden wird, dauerhaft gelöscht, einschließlich aller angehängten Bilder.
• Dies betrifft auch Fahrzeuge, die manuell bearbeitet, mit zusätzlichen Inhalten angereichert oder auf den Status „Entwurf“ gesetzt wurden.
• Die Löschung wird in der Protokolldatei des Plugins aufgezeichnet.

Deaktivieren Sie Full Sync, wenn Sie Fahrzeuge in WordPress behalten möchten, selbst nachdem sie aus AutoScout24 entfernt wurden.

---

Überwachung des Systemzustands

Der Reiter System & Help bietet eine umfassende Übersicht über die Serverumgebung und den Plugin-Status. Überprüfen Sie diesen regelmäßig, um potenzielle Probleme zu erkennen, bevor sie sich auf die Importe auswirken.

Wichtige Prüfungen:

Statusanzeigen verwenden ein Ampelsystem: Grün (OK), Gelb (Warnung), Rot (Problem).

---

Protokollüberwachung

Der Reiter Logs zeigt das Aktivitätsprotokoll des Plugins an.

• Das Protokoll erfasst API-Aufrufe, Token-Anfragen, Importaktionen, Bild-Downloads, Fehler und Warnungen.
• Die Bereiche Recent Errors und Recent Warnings oben auf dem Reiter „Logs“ heben die neuesten Fehler- und Warnungseinträge aus den letzten 2.000 Protokollzeilen hervor.
• Der Log Viewer zeigt die letzten N Zeilen der vollständigen Protokolldatei (konfigurierbar, 100–2.000 Zeilen).
• Die Protokolldatei wird automatisch rotiert, sobald sie eine Größe von 10 MB erreicht.
• Um die Protokolldatei manuell zu leeren, klicken Sie auf die Schaltfläche Protokolldatei leeren. Dies kann nicht rückgängig gemacht werden.
• Ausführliche Protokollierung (wenn in den Einstellungen aktiviert) schreibt detaillierte Informationen pro Fahrzeug und Bild in das Protokoll. Deaktivieren Sie die ausführliche Protokollierung im Produktivbetrieb, wenn das Protokoll zu schnell anwächst.

---

Diagnose-Export

Der Reiter Tools enthält eine Funktion zum Diagnose-Export. Diese generiert eine JSON-Datei mit folgenden Inhalten:

• Plugin-Version
• WordPress-Version
• PHP-Version
• Website-URL
• Größe und Pfad der Protokolldatei
• Zusammenfassung der Systemumgebung

Wenn Sie den Support kontaktieren, exportieren Sie diese Datei und stellen Sie sie Ihrem Support-Team zur Verfügung. Geben Sie die rohe Protokolldatei nicht öffentlich frei, da sie API-URLs und Inserats-IDs enthalten kann.

---

---

Managing features

Die meisten optionalen Funktionen werden über den Bildschirm Settings und nicht über einen speziellen Reiter „Features“ aktiviert oder deaktiviert. Öffnen Sie Car Market Hub → Settings und nutzen Sie die Karten Frontend Features und Admin Features, um einzelne Funktionen ein- oder auszuschalten. Änderungen werden sofort nach dem Speichern wirksam. Zu den verfügbaren Optionen gehören:

• Strukturierte Daten von Schema.org und Open Graph Meta-Tags
• Social-Sharing-Buttons
• Favoriten / Wunschzettel
• Fahrzeugvergleich
• PDF datasheet
• Sitemap-Integration
• Dashboard-Widget
• Lazy Loading
• Massenaktionen
• Export
• REST API
• Analytics-Tracking
• Finanzierungsrechner (mit konfigurierbarem Zinssatz, Kreditlaufzeit und Anzahlung)
• Probefahrt-Buchung
• AI Assistant

Das Deaktivieren einer Funktion entfernt deren Funktionalität sowohl aus dem Frontend als auch aus dem Admin-Bereich, ohne gespeicherte Daten zu löschen. Siehe die Referenz für Import und Limits für die vollständige Liste der Optionen.

Ausgehende Webhook-URLs (neuer Lead, neuer Import) und das Webhook-Geheimnis werden auf dem Bildschirm Leads konfiguriert – siehe die Leads-Referenz. Die Option für das PDF datasheet befindet sich unter Settings, während die Vorlagen und das Branding im PDF Manager verwaltet werden (siehe die PDF-Manager-Referenz).

Der AI Assistant und das Content Studio sind keine einfachen Ein-/Ausschalter in gleicher Weise. Der AI Assistant wird auf seinem eigenen Bildschirm CMH Center → AI Assistant konfiguriert, und das Content Studio ist ein separater Arbeitsbereich unter CMH Center → Content Studio. Diese Betriebsbereiche erfordern möglicherweise auch eine aktive Plugin-Lizenz, bevor sie genutzt werden können; solange das Plugin nicht für sie lizenziert ist, wird der Bildschirm durch den Hinweis „Lizenz erforderlich“ ersetzt und vorhandene Daten bleiben unberührt.

---

Managing the CMH Team

CMH Team ist ein separates Hauptmenü für vom Plugin verwaltete Verkaufsansprechpartner des Autohauses. Teammitglieder werden vollständig innerhalb des Plugins gespeichert (es ist kein WordPress-Benutzerkonto erforderlich) und können auf den Fahrzeugdetailseiten angezeigt sowie als bevorzugte Empfänger für Leads verwendet werden.

Das Menü CMH Team bietet die folgenden Bildschirme:

Wie ein Ansprechpartner für ein bestimmtes Fahrzeug ermittelt wird: Ein manuell zugewiesener Kontakt pro Fahrzeug hat Vorrang, danach der Standort-/Verkäufer-Standard und schließlich der globale Standard. Manuelle Auswahlen (manuell, allgemein, keine) werden vom Importer niemals überschrieben; automatische Zuweisungen können beim Import aktualisiert werden. Siehe CMH Team and Contact Routing für die vollständige Referenz und Lead-Management-Workflow für Informationen darüber, wie sich das CMH Team auf die Weiterleitung von Lead-Benachrichtigungen auswirkt.

---

Managing leads

Kundenkontakt- und Probefahrtanfragen werden als benutzerdefinierte WordPress-Beiträge (as24ci_lead) gespeichert und im Reiter Leads angezeigt.

Verantwortlichkeiten des Administrators:

• Konfigurieren Sie die Empfänger-E-Mail-Adresse für Lead-Benachrichtigungen (Reiter Leads).
• Überprüfen Sie regelmäßig den Lead-Status und aktualisieren Sie ihn nach Bedarf auf Kontaktiert, Geschlossen oder Spam.
• Exportieren Sie Leads als CSV für den CRM-Import oder die Archivierung.
• Löschen Sie veraltete oder Spam-Leads aus dem Reiter Leads.

Hinweis: Lead-Beitragsdatensätze werden in WordPress gespeichert. Wenn in den Einstellungen Daten bei Deinstallation löschen aktiviert ist, werden diese Datensätze dauerhaft entfernt, wenn das Plugin deinstalliert wird.

---

Uninstall and cleanup

Der Reiter Settings enthält die Option Daten bei Deinstallation löschen. Wenn diese aktiviert ist:

• Durch die Deinstallation des Plugins über WordPress Admin → Plugins werden alle importierten Fahrzeugbeiträge, Lead-Beiträge, importierten Bilder und Plugin-Optionen dauerhaft gelöscht.

Wenn diese Option deaktiviert ist (Standardeinstellung), verbleiben bei der Deinstallation des Plugins alle Daten in WordPress. Sie können das Plugin dann neu installieren und den Betrieb ohne Datenverlust fortsetzen.

Aktivieren Sie diese Option nur, wenn Sie eine vollständige Entfernung beabsichtigen. Dies kann nach Abschluss der Deinstallation nicht mehr rückgängig gemacht werden.

---

Support coordination

Wenn ein Problem eine Eskalation an AutoScout24 oder Ihren Integrationspartner erfordert:

1. Überprüfen Sie den Reiter Logs auf relevante Fehlermeldungen und notieren Sie den Zeitstempel.
2. Exportieren Sie die Diagnose-Datei aus dem Reiter Tools.
3. Notieren Sie die Plugin-Version (angezeigt in der Plugin-Liste und im Reiter System & Hilfe) sowie die WordPress- und PHP-Versionen.
4. Bestätigen Sie, ob der API-Verbindungstest erfolgreich ist (System & Hilfe → Verbindungstest).
5. Stellen Sie all diese Informationen Ihrem Support-Ansprechpartner zur Verfügung. Geben Sie das rohe Client Secret nicht weiter.

---

Troubleshooting

---

Related documents

• Benutzerhandbuch
• Tägliche Arbeitsabläufe
• Fahrzeug-Import-Workflow
• Lead-Management-Workflow