Administrator-Handbuch

Dieses Handbuch dokumentiert die administrativen Verantwortlichkeiten für das ADP Car Market Hub WordPress Plugin. Es deckt die Zuständigkeit für die Ersteinrichtung, Benutzerberechtigungen, Importkonfiguration, geplante Abläufe, Systemzustandsüberwachung und Supportkoordination ab.

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:

• Das Eingeben und Pflegen gültiger API-Zugangsdaten.
• Das Konfigurieren des Importzeitplans und die Wahl zwischen WP-Cron und Server-Cron.
• Das Festlegen des korrekten Standard-Beitragsstatus, Autors, der Bildverarbeitung und der Währung.
• Das Gewähren oder Einschränken des Zugriffs auf die Admin-Oberfläche des Plugins.
• Die Pflege der Verkaufsansprechpartner der Garage, die den Kunden angezeigt und für das Lead-Routing verwendet werden (CMH Team).
• Die Überwachung des Systemzustands des Plugins, der Log-Ausgabe 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 neuer und WordPress 6.2 oder neuer 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 Rollen

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ässig 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 im standardmässigen WordPress-Bildschirm 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.

---

Erste Einrichtung

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 (verifizieren Sie die korrekte URL mit AutoScout24 oder Ihrem Integrationspartner).
4. Geben Sie eine oder mehrere Seller IDs (kommagetrennt) ein, die Ihrem/Ihren AutoScout24-Händlerkonto/-konten 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 Standardwerten abweichen, die von der Basis-URL abgeleitet werden.
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 WebP-Konvertierungsoptionen.
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 Vollimport mit dem Batch-Wizard aus.

---

Konfigurieren des Importzeitplans

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 bei 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 Live-Umgebungen)

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 mit crontab), um diese URL im gewünschten Intervall mittels curl oder wget aufzurufen.
5. Wenn Sie das Token neu generieren müssen (beispielsweise 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 Transient-basierte Sperre (ca. 40 Minuten), um überschneidende Importläufe zu verhindern. Wenn bereits ein Import läuft und ein zweiter Trigger eingeht (über WP-Cron, Server-Cron oder manuell), wird der zweite Durchlauf übersprungen. Dies ist ein normales Verhalten.

---

Verwalten von Bildimporten

• Bildwarteschlangen-Modus: Bei geplanten Cron-Importen wird zunächst nur das erste Bild pro Fahrzeug sofort heruntergeladen. Die restlichen Bilder werden von einem Hintergrund-Queue-Worker ca. alle 5 Minuten verarbeitet. Dies verhindert PHP-Timeout-Fehler bei grossen Importen.
• Überwachung der Bildwarteschlange: Der Reiter System & Help zeigt die aktuelle Grösse der Bildwarteschlange und eine Warnung an, wenn die Warteschlange 1'000 Elemente überschreitet.
• Manuelle Warteschlangenverarbeitung: Verwenden Sie die Schaltfläche Bildwarteschlange jetzt ausführen auf dem Reiter System & Help, um die Warteschlange sofort zu verarbeiten.
• Bildwarteschlange löschen: Die Schaltfläche Bildwarteschlange löschen auf demselben Reiter entfernt alle ausstehenden Bildeinträge, ohne sie zu verarbeiten. Verwenden Sie dies mit Vorsicht.
• WebP-Konvertierung: Falls 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. Wenn diese aktiviert ist, werden alle Fahrzeugbeiträge in WordPress dauerhaft gelöscht, die im Live-Bestand von AutoScout24 für den/die konfigurierten Händler nicht mehr vorhanden sind.

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, einschliesslich 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 Logdatei des Plugins protokolliert.

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

---

Systemzustandsüberwachung

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

Wichtige Prüfungen:

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

---

Log-Überwachung

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

• Das Log protokolliert 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 Logzeilen hervor.
• Der Log Viewer zeigt die letzten N Zeilen der vollständigen Logdatei (konfigurierbar, 100–2'000 Zeilen).
• Die Logdatei wird automatisch rotiert, sobald sie 10 MB erreicht.
• Um die Logdatei manuell zu löschen, klicken Sie auf die Schaltfläche Logdatei löschen. Dies kann nicht rückgängig gemacht werden.
• Ausführliche Protokollierung (wenn in den Einstellungen aktiviert) schreibt Details pro Fahrzeug und pro Bild in das Log. Deaktivieren Sie die ausführliche Protokollierung in Live-Umgebungen, wenn das Log zu schnell wächst.

---

Diagnose-Export

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

• Plugin-Version
• WordPress-Version
• PHP-Version
• Website-URL
• Grösse und Pfad der Logdatei
• Zusammenfassung der Systemumgebung

Wenn Sie den Support kontaktieren, exportieren Sie diese Datei und teilen Sie sie mit Ihrem Support-Team. Teilen Sie die rohe Logdatei nicht öffentlich, da sie API-URLs und Inserats-IDs enthalten kann.

---

---

Funktionen verwalten

Die meisten optionalen Funktionen werden über die Seite Einstellungen und nicht über einen speziellen Tab "Funktionen" aktiviert oder deaktiviert. Öffnen Sie Car Market Hub → Einstellungen und nutzen Sie die Karten Frontend-Funktionen und Admin-Funktionen, 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 / Wunschliste
• Fahrzeugvergleich
• PDF-Datenblatt
• 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 dass gespeicherte Daten gelöscht werden. Siehe die Einstellungsreferenz für die vollständige Liste aller Optionen.

Ausgehende Webhook-URLs (neuer Lead, neuer Import) und das Webhook-Secret werden auf der Seite Leads konfiguriert – siehe die Leads-Referenz. Die Option für das PDF-Datenblatt befindet sich unter Einstellungen, 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/Aus-Schalter in diesem Sinne. Der AI Assistant wird auf seiner eigenen Seite CMH Center → AI Assistant konfiguriert, und das Content Studio ist ein separater Arbeitsbereich unter CMH Center → Content Studio. Diese Funktionsbereiche erfordern möglicherweise auch eine aktive Plugin-Lizenz, bevor sie genutzt werden können. Solange das Plugin für diese Bereiche nicht lizenziert ist, wird die Seite durch einen Hinweis "Lizenz erforderlich" ersetzt und bestehende Daten bleiben unberührt.

---

Das CMH Team verwalten

CMH Team ist ein separates Hauptmenü für die vom Plugin verwalteten Verkaufsansprechpartner der Garage. 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 Seiten:

Wie ein Kontakt für ein bestimmtes Fahrzeug ermittelt wird: Ein manuell zugewiesener Kontakt pro Fahrzeug hat Vorrang, danach folgt der Standort-/Seller-Standard und anschliessend der globale Standard. Manuelle Entscheidungen (manuell, allgemein, keine) werden vom Importer niemals überschrieben; automatische Zuweisungen können beim Import aktualisiert werden. Siehe CMH Team und Kontakt-Routing für die vollständige Referenz und Workflow für das Lead-Management für Informationen darüber, wie das CMH Team das Routing von Lead-Benachrichtigungen beeinflusst.

---

Leads verwalten

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

Verantwortlichkeiten des Administrators:

• Konfigurieren der Empfänger-E-Mail-Adresse für Lead-Benachrichtigungen (Tab "Leads").
• Regelmässiges Überprüfen der Lead-Status und Aktualisieren dieser auf Kontaktiert, Geschlossen oder Spam falls zutreffend.
• Exportieren von Leads als CSV für den CRM-Import oder zur Archivierung.
• Löschen veralteter Leads oder Spam-Leads aus dem Tab "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.

---

Deinstallation und Bereinigung

Der Tab Einstellungen 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), bleiben bei der Deinstallation des Plugins alle Daten in WordPress erhalten. 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-Koordination

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

1. Überprüfen Sie den Tab Protokolle auf relevante Fehlermeldungen und notieren Sie den Zeitstempel.
2. Exportieren Sie die Diagnosedatei aus dem Tab Werkzeuge.
3. Notieren Sie die Plugin-Version (angezeigt in der Plugin-Liste und im Tab "System & Hilfe") sowie die WordPress- und PHP-Versionen.
4. Überprüfen 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.

---

Fehlerbehebung

---

Verwandte Dokumente

• Benutzerhandbuch
• Workflows für den täglichen Gebrauch
• Workflow für den Fahrzeugimport
• Workflow für das Lead-Management