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 Vorgänge, die Überwachung des Systemzustands und die Supportkoordination.

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 die Überprüfung des Importstatus, die Durchsicht von Leads und die Validierung des Frontends lesen Sie bitte die Täglichen 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 Verbinden einer Datenquelle und das Verwalten ihrer Zugangsdaten auf der Seite Verbindungen.
• Das Konfigurieren des Importzeitplans 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 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, mobile.de, carcuro oder Ihrem Integrationspartner, wenn Probleme mit der Quelle 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 Datenquellen-Zugangsdaten müssen vor der Einrichtung eingeholt werden. Für AutoScout24 sind dies die API-Basis-URL, die Seller ID(s), die Client ID, das Client Secret, die Token-URL und die Audience (von AutoScout24 oder Ihrem Integrationspartner); für mobile.de sind dies API-Zugangsdaten; für carcuro ist es ein carcuro-Firmentoken. Das Plugin kann keine Fahrzeuge ohne eine verbundene Quelle 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 Äquivalent) unterstützen.

---

Berechtigungen und Capabilities

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 zugewiesen.
• 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 der 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 Standard-Beitragsübersicht von WordPress. Der Zugriff auf die dedizierten Plugin-Admin-Seiten unter CMH Center und CMH Team erfordert zusätzlich manage_as24_imports.

Schutz sensibler Einstellungen

Datenquellen-Zugangsdaten (wie das AutoScout24 Client Secret oder das carcuro-Firmentoken) werden auf der Seite Verbindungen eingegeben und über den Secret-Store des Plugins verschlüsselt gespeichert (encrypted at rest). Der Zugriff auf Verbindungen und 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 CMH Center → Verbindungen und klicken Sie auf die Zeile der Quelle, die Sie verbinden möchten.
3. Für AutoScout24 geben Sie die API-Basis-URL für Ihre Umgebung ein (verifizieren Sie die korrekte URL mit AutoScout24 oder Ihrem Integrationspartner), eine oder mehrere Seller IDs (kommagetrennt), die zu Ihren Garagen-Konten passen, sowie die von AutoScout24 bereitgestellte Client ID und das Client Secret. Geben Sie die Token-URL und die Audience ein, falls diese von den Standardwerten abweichen, die von der Basis-URL abgeleitet werden.
4. Für carcuro geben Sie Ihr carcuro-Firmentoken ein und wählen Sie aus, welche Fahrzeuge synchronisiert werden sollen. (Sie verbinden nur die Quelle, die die Garage tatsächlich nutzt; die anderen Live-Quellen sind optional.)
5. Speichern Sie die Quelle. Die Status-Pille wechselt zu Verbunden, und die eingegebenen Secrets werden verschlüsselt gespeichert.
6. Navigieren Sie zu CMH Center → Einstellungen und stellen Sie die Standardwährung so ein, dass sie mit der in Ihren Inseraten verwendeten Währung übereinstimmt.
7. Konfigurieren Sie den Standard-Beitragsstatus (publish, um Fahrzeuge sofort sichtbar zu machen, draft, um sie vor der Veröffentlichung zu prüfen).
8. Legen Sie den Standard-Beitragsautor auf den WordPress-Benutzer fest, der als Autor der Fahrzeugbeiträge aufgeführt werden soll.
9. Konfigurieren Sie die Einstellungen für den Bildimport: ob Bilder importiert werden sollen, die maximale Anzahl von Bildern pro Fahrzeug und WebP-Konvertierungsoptionen.
10. Aktivieren Sie die Option Standardseiten erstellen, damit das Plugin automatisch das Fahrzeugarchiv und die Vergleichsseiten erstellt.
11. Klicken Sie auf Einstellungen speichern.
12. Verwenden Sie den Verbindungstest auf dem Tab System & Hilfe oder Tools, um zu bestätigen, dass die Verbindung zur Quelle funktioniert.
13. Navigieren Sie zu Import & Limits und führen Sie den ersten vollständigen Import mit dem Batch-Wizard aus.

---

---

Configuring the import schedule

WP-Cron (default)

WordPress has a built-in cron system (WP-Cron) that triggers on page loads. This is sufficient for many sites but may be delayed on low-traffic sites.

1. Navigate to CMH Center → Import & Limits.
2. Enable Automatic import.
3. Choose the interval: hourly, every 6 hours, twice daily, daily, or a custom interval (minimum 15 minutes).
4. For daily and twice-daily schedules, set the preferred start time.
5. Save the automation settings.

Server cron (recommended for production)

For reliable scheduling, configure an external server cron to call the plugin's REST endpoint:

1. Navigate to CMH Center → Import & Limits.
2. Set Cron mode to Server cron.
3. Copy the displayed cron endpoint URL (includes a security token).
4. Add a cron job on your server (for example, using crontab) to call this URL at the desired interval using curl or wget.
5. If you need to regenerate the token (for example, after a security incident), click Regenerate token on the same tab and update your server cron job with the new URL.

Import lock

The plugin uses a transient-based lock (approximately 40 minutes) to prevent overlapping import runs. If an import run is already in progress and a second trigger arrives (from WP-Cron, server cron, or a manual trigger), the second run is skipped. This is normal behaviour.

---

Managing image imports

• Image queue mode: During scheduled cron imports, only the first image per vehicle is downloaded immediately. Remaining images are processed by a background queue worker approximately every 5 minutes. This prevents PHP timeout errors during large imports.
• Image queue monitoring: The System & Help tab displays the current image queue size and a warning if the queue exceeds 1,000 items.
• Manual queue processing: Use the Run image queue now button on the System & Help tab to process the queue immediately.
• Clear image queue: The Clear image queue button on the same tab removes all pending image entries without processing them. Use this with caution.
• WebP conversion: If enabled, downloaded images are converted to WebP format using GD or Imagick. The System & Help tab shows whether these extensions are available.

---

Full Sync

Full Sync is a setting on the Import & Limits tab that, when enabled, permanently deletes any vehicle post in WordPress that is no longer present in the live AutoScout24 listing for the configured seller(s).

Use Full Sync only when you want WordPress to mirror the live AutoScout24 inventory exactly. When enabled:

• Any local vehicle post not found in the current remote listing is permanently deleted, including all attached images.
• This includes vehicles that were manually edited, enriched with additional content, or set to draft status.
• The deletion is logged in the plugin's log file.

Disable Full Sync if you want to retain vehicles in WordPress even after they are removed from AutoScout24.

---

System health monitoring

The System & Help tab provides a comprehensive overview of the server environment and plugin status. Review this regularly to identify potential problems before they affect imports.

Key checks:

Status indicators use a traffic light system: green (OK), yellow (warning), red (problem).

---

Log monitoring

The Logs tab displays the plugin's activity log.

• The log records API calls, token requests, import actions, image downloads, errors, and warnings.
• The Recent Errors and Recent Warnings panels at the top of the Logs tab highlight the latest error and warning entries from the last 2,000 log lines.
• The Log Viewer shows the last N lines of the full log file (configurable, 100–2,000 lines).
• The log file is automatically rotated when it reaches 10 MB.
• To clear the log file manually, click the Clear log file button. This is irreversible.
• Verbose logging (when enabled in settings) writes per-vehicle and per-image detail to the log. Disable verbose logging in production if the log grows too quickly.

---

Diagnostics export

The Tools tab includes a Diagnostics export function. This generates a JSON file containing:

• Plugin version
• WordPress version
• PHP version
• Site URL
• Log file size and path
• System environment summary

When contacting support, export this file and share it with your support team. Do not share the raw log file publicly as it may contain API URLs and listing identifiers.

---

Managing features

Most optional features are enabled or disabled from the Settings screen rather than from a dedicated "Features" tab. Open CMH Center → Settings and use the Frontend Features and Admin Features cards to toggle individual capabilities. Changes take effect immediately after saving. Available toggles include:

• Schema.org structured data and Open Graph meta tags
• Social sharing buttons
• Favorites / Wishlist
• Vehicle Compare
• PDF datasheet
• Sitemap integration
• Dashboard widget
• Lazy loading
• Bulk actions
• Export
• REST API
• Analytics tracking
• Financing calculator (with configurable interest rate, loan term, and down payment)
• Test Drive booking
• AI Assistant

Disabling a feature removes its functionality from both the frontend and admin without deleting any stored data. See the Settings Reference for the full list of toggles.

Outbound webhook URLs (new lead, new import) and the webhook secret are configured on the Leads screen — see the Leads Reference. The PDF datasheet feature toggle is on Settings, while its templates and branding are managed on PDF Manager (see the PDF Manager Reference).

The AI Assistant and Content Studio are not simple on/off toggles in the same way. The AI Assistant is configured on its own CMH Center → AI Assistant screen, and Content Studio is a separate CMH Center → Content Studio workspace. These operational areas may also require an active plugin licence before they can be used; while the plugin is not licensed for them, the screen is replaced with a "licence required" notice and existing data is left untouched.

---

---

Managing the CMH Team

CMH Team ist ein separates Hauptmenü für vom Plugin verwaltete 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 Ansichten:

Wie ein Kontakt für ein bestimmtes Fahrzeug ermittelt wird: Ein manuell zugewiesener Kontakt pro Fahrzeug hat Vorrang, gefolgt vom Standort-/Seller-Standard und schliesslich dem globalen Standard. Manuelle Auswahlen (manuell, allgemein, keine) werden vom Importer niemals überschrieben; automatische Zuweisungen können beim Import aktualisiert werden. Siehe CMH Team und Contact Routing für die vollständige Referenz und Arbeitsabläufe im Lead-Management für Informationen darüber, wie sich CMH Team auf die Weiterleitung von Lead-Benachrichtigungen auswirkt.

---

Managing leads

Kundenkontakt- und Probefahrtanfragen werden als WordPress Custom Posts (as24ci_lead) gespeichert und im Tab Leads angezeigt.

Verantwortlichkeiten des Administrators:

• Konfigurieren Sie die Empfänger-E-Mail-Adresse für Lead-Benachrichtigungen (Tab Leads).
• Überprüfen Sie die Lead-Status regelmässig und aktualisieren Sie diese 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 Tab Leads.

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

---

Uninstall and cleanup

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

• Durch das Deinstallieren des Plugins über WordPress Admin → Plugins werden alle importierten Fahrzeug-Beiträ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 anschliessend 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 Tab Logs auf relevante Fehlermeldungen und notieren Sie den Zeitstempel.
2. Exportieren Sie die Diagnose-Datei aus dem Tab Werkzeuge.
3. Notieren Sie die Plugin-Version (angezeigt in der Plugin-Liste und im Tab System & Hilfe) sowie die Versionen von WordPress und PHP.
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.

---

Troubleshooting

---

Related documents

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