Dokumentation · Erste Schritte
Ersteinrichtung
Diese Anleitung erklärt, was ein WordPress-Administrator nach der Aktivierung des ADP Car Market Hub-Plugins konfigurieren sollte und in welcher Reihenfolge. Das Befolgen der empfohlenen Reihenfolge vermeidet die häufigsten Nacharbeiten – zum Beispiel das Ausführen eines Imports, bevor die API-Verbindung validiert ist, oder das Live-Gehen, bevor das Frontend auf einer echten Fahrzeugseite überprüft wurde.
Dieses Dokument behandelt den Einrichtungs-Ablauf. Detailliertes Referenzmaterial für jeden Admin-Tab finden Sie im Abschnitt Admin-Referenz. Eine eigene Referenz für den plugin-internen Ersteinrichtungs-Assistenten finden Sie unter Setup Wizard Reference.
Ersteinrichtungs-Assistent
ADP Car Market Hub wird mit einem Ersteinrichtungs-Assistenten ausgeliefert, der einen Administrator in sieben prägnanten Schritten durch die gängigsten Konfigurationsoptionen führt. Der erste Schritt ist die Lizenzaktivierung, die obligatorisch ist: Bis eine gültige Lizenz aktiviert ist, bleibt jeder funktionale Schritt des Assistenten (und jeder andere Admin-Tab des Plugins außer den Einstellungen) gesperrt. Sobald die Lizenz aktiv ist, sind die verbleibenden Schritte der empfohlene Einstiegspunkt sowohl für Demo-Evaluierungen als auch für Live-AutoScout24-Bereitstellungen, aber sie sind nicht zwingend erforderlich – jede angebotene Option kann auch manuell über die regulären Admin-Tabs konfiguriert werden, die in der Admin-Referenz dokumentiert sind.
Was der Assistent tut
- Aktiviert Ihre Lizenz als ersten Schritt. Die Lizenz schaltet die Premium-Bereiche des Plugins frei; ohne sie kann der Assistent den Lizenzbildschirm nicht überschreiten und die anderen Admin-Tabs zeigen einen "Lizenz erforderlich"-Bildschirm an.
- Lässt den Admin zwischen Demo-Einrichtung (installiert Demofahrzeuge, wendet Demo-Standardwerte an und aktiviert Analytics, damit die Dashboard- und Analytics-Seiten Daten zum Anzeigen haben) und Live-AutoScout24-Einrichtung (speichert echte Zugangsdaten und ausgewählte Seiten, ohne Demodaten zu installieren) wählen.
- Erfasst das Autohaus-Profil (Name, Adresse, Kontaktdaten, Logo).
- Erfasst die AutoScout24-Verbindung (Client ID, Client Secret, Seller ID, API-Basis-URL).
- Erstellt optional die öffentlich zugänglichen Seiten Fahrzeuge, Fahrzeuge vergleichen und Favoriten mit den kanonischen Shortcodes.
- Schaltet die gängigsten Standardfunktionen um (Social Sharing, PDF-Datenblatt, PDF-QR-Code, Betriebskosten pro 100 km, Vergleichen, Favoriten, Suchaufträge, Analytics-Tracking).
- Markiert die Einrichtung als abgeschlossen und leitet den Admin zum Dashboard zurück.
Wann der Assistent erscheint
- Nach der ersten Aktivierung des Plugins erscheint oben auf jeder WordPress-Admin-Seite ein Admin-Hinweis mit dem Titel Willkommen bei ADP Car Market Hub.
- Der Hinweis ist keine erzwungene Weiterleitung – der Admin kann weiterhin in WordPress surfen und den Assistenten später starten.
- Der Hinweis wird nur angezeigt, wenn alle folgenden Bedingungen erfüllt sind:
- Der aktuelle Benutzer verfügt über die Berechtigung zur Verwaltung des Plugins.
- Ein Zeitstempel der Erstaktivierung wurde aufgezeichnet.
- Der Assistent wurde nicht als abgeschlossen markiert.
- Der Assistent wurde nicht als übersprungen markiert.
- Plugin-Upgrades, die keine neue Aktivierung auslösen, lassen den Hinweis auf bestehenden Installationen nicht erscheinen.
So starten Sie den Assistenten
- Klicken Sie im Willkommenshinweis auf Einrichtungs-Assistenten starten, oder
- Öffnen Sie Car Market Hub → Dashboard und verwenden Sie den Link Einrichtungs-Assistenten ausführen ganz oben, oder
- Öffnen Sie Car Market Hub → Tools und verwenden Sie die Karte Einrichtungs-Assistent.
Der Assistent ist als versteckte Admin-Seite registriert, die unter wp-admin/admin.php?page=as24ci-setup-wizard erreichbar ist. Berechtigungs- und Nonce-Prüfungen werden bei jedem Schritt erzwungen.
So überspringen Sie den Assistenten
- Klicken Sie im Willkommenshinweis auf Vorerst überspringen. Der Hinweis wird bei nachfolgenden Ladevorgängen von Admin-Seiten nicht mehr angezeigt.
- Der Assistent bleibt über das Dashboard und den Tab "Tools" erreichbar, sodass er jederzeit fortgesetzt werden kann.
Schritte des Assistenten
- Lizenz – Geben Sie Ihren Lizenzschlüssel ein und aktivieren Sie ihn. Dieser Schritt wird zuerst erzwungen; der Assistent kann mit keinem funktionalen Schritt fortfahren, bis die Lizenz betriebsbereit ist. Der Lizenzschlüssel ist schreibgeschützt – er wird niemals auf dem Bildschirm vorausgefüllt.
- Modus – Wählen Sie Demo-Einrichtung oder Live-AutoScout24-Einrichtung; wählen Sie das Land des Autohauses, die Währung und die Admin-Sprache.
- Autohaus-Profil – Name, Straße, Postleitzahl, Ort, Land, Telefon, E-Mail, Website, Logo.
- AutoScout24 – Client ID, Client Secret, Seller ID und API-Basis-URL. Das Feld Client Secret wird absichtlich leer dargestellt (siehe Einrichtung der API-Zugangsdaten).
- Seiten – Wählen Sie für jede öffentliche Seite (Fahrzeuge, Fahrzeuge vergleichen, Favoriten) Automatisch erstellen, Bestehende Seite verwenden oder Überspringen.
- Funktionen – Aktivieren oder deaktivieren Sie die oben aufgeführten Standardfunktionen.
- Fertigstellen – Überprüfen Sie die Zusammenfassung und bestätigen Sie. Im Demo-Modus löst der Fertigstellungsschritt auch den vorhandenen Demodaten-Installer aus; im Live-Modus werden nur die Einstellungen des Assistenten gespeichert.
Sicherheit bei bestehenden Installationen
- Die Plugin-Aktivierung setzt nur zerstörungsfreie Standardwerte; sie überschreibt niemals vorhandene Optionswerte.
- Das Deaktivieren und Reaktivieren des Plugins öffnet den Assistenten nicht automatisch erneut und überschreibt keine Einstellungen.
- Der Assistent ändert nur Einstellungen, deren Formularfelder der Admin tatsächlich absendet.
- Die Demo-Einrichtung ist der einzige Weg, der Demodaten installiert und demo-gesteuerte Optionen zurücksetzt; dies ist ein expliziter Zurücksetzungs- und Befüllungsvorgang. Die Live-Einrichtung ist in Bezug auf Fahrzeuge und Kundeneinstellungen zerstörungsfrei.
Ausführliche Details zu Flags, Berechtigungen, der URL der versteckten Admin-Seite und dem Speicherverhalten der Schritte finden Sie unter Setup Wizard Reference.
Wann Sie dieses Dokument verwenden sollten
Verwenden Sie dieses Dokument, wenn Sie:
- ADP Car Market Hub auf einer frisch aktivierten Installation konfigurieren.
- Das Plugin nach einer Servermigration, einem Umgebungswiederaufbau oder einer Bereitstellung von Staging auf Produktion neu konfigurieren.
- Einen wiederholbaren Onboarding-Prozess für eine neue Kunden-Website dokumentieren.
Die Zielgruppe ist ein WordPress-Administrator, der bereits die Installationsanleitung abgeschlossen hat und Zugriff auf die AutoScout24-API-Zugangsdaten hat, die vom Konto des Autohauses oder dessen Integrationspartner bereitgestellt wurden.
Bevor Sie beginnen
Bestätigen Sie Folgendes, bevor Sie mit der Konfiguration beginnen:
- Das Plugin ist installiert und aktiviert und das Menü Car Market Hub erscheint im WordPress-Admin.
- Die Website erfüllt alle Anforderungen auf der Checkliste vor der Installation.
- Sie haben Ihren ADP Car Market Hub-Lizenzschlüssel. Die Lizenz ist erforderlich, um die Premium-Bereiche des Plugins freizuschalten: Bis sie aktiviert ist, zeigt jeder Admin-Tab außer Einstellungen einen "Lizenz erforderlich"-Bildschirm an, und Importe, Cron-Jobs und die anderen Funktionen bleiben gesperrt.
- Sie haben die für Ihr Konto erforderlichen AutoScout24-API-Zugangsdaten: API-Basis-URL, Seller ID(s), Client ID und Client Secret. Diese stammen aus dem AutoScout24-Konto des Autohauses oder von dem Integrationspartner, der den API-Zugang betreibt. Das Plugin stellt diese nicht bereit.
- Sie haben sich für geschäftliche Standardwerte entschieden, die die Konfiguration beeinflussen: Standardwährung, welchen rechtlichen/Einwilligungstext das Autohaus auf Kontaktformularen wünscht und welche Funktionen (Probefahrtbuchung, Suchaufträge, AI Assistant, Analytics) zum Start aktiviert werden sollen.
- Ein Backup der WordPress-Website ist vorhanden, und im Idealfall wird die Konfiguration auf einer Staging-Umgebung durchgeführt, die die Produktionsumgebung widerspiegelt.
Empfohlene Reihenfolge der Einrichtung
Die folgenden zehn Schritte sind die empfohlene Reihenfolge. Jeder Schritt baut auf dem vorherigen auf. Springen Sie nicht vor – aktivieren Sie beispielsweise keine automatischen Importe, bevor der Verbindungstest erfolgreich war.
- Lizenzaktivierung
- Systembereitschaft
- API-Zugangsdaten
- Verbindungstest
- Import-Einstellungen
- Layout- und Frontend-Einstellungen
- Rechtliche, Datenschutz- und Einwilligungseinstellungen
- Testimport
- Frontend-Validierung
- Go-Live-Prüfungen ---
Schritt-für-Schritt-Anleitung
Schritt 1 — Lizenzaktivierung
Öffnen Sie Car Market Hub → Settings und füllen Sie die Karte License Activation oben auf der Seite aus. Geben Sie Ihren Lizenzschlüssel ein und klicken Sie auf Activate. Eine erfolgreiche Aktivierung schaltet die Premium-Bereiche des Plugins frei; die Admin-Tabs von Car Market Hub (außer Settings) zeigen nicht mehr den Bildschirm „License required“ an, und Importe, Cron-Jobs sowie die Hintergrundverarbeitung werden verfügbar.
Der Lizenzschlüssel ist schreibgeschützt: Er wird Ihnen nach dem Speichern nie wieder angezeigt. Dieselbe Karte bietet auch Check license (validiert den gespeicherten Schlüssel erneut) und Remove license (löscht den Schlüssel, behält jedoch Ihre importierten Fahrzeuge, Seiten und Medien bei). Wenn Sie mit dem Ersteinrichtungs-Assistenten gestartet sind, ist die Lizenzaktivierung dessen erster Schritt, sodass dies bereits erledigt ist.
Fahren Sie nicht fort, bis die Lizenz aktiv ist. Ohne sie bleiben die restlichen Konfigurations-Tabs gesperrt.
Schritt 2 — Systembereitschaft
Öffnen Sie Car Market Hub → System & Help und überprüfen Sie die Systemprüfungen. Die Seite meldet den Status von PHP, JSON, OpenSSL, cURL, GD/Imagick, dem Uploads-Verzeichnis, dem Cron-Zeitplan, dem Token-Cache, der Protokolldatei und der Bildwarteschlange mit Status-Badges im Ampelstil.
Beheben Sie alle roten Badges, bevor Sie fortfahren. Typische Maßnahmen sind das Aktivieren einer fehlenden PHP-Erweiterung, das Korrigieren von Berechtigungen für das Uploads-Verzeichnis oder das Beheben eines nicht funktionierenden WP-Cron.
Für eine tiefergehende Überprüfung der Umgebung siehe Technische Systemanforderungen und API-, Netzwerk- und SSL-Anforderungen.
Schritt 3 — API-Zugangsdaten
Öffnen Sie Car Market Hub → Settings und füllen Sie die Karte API Connection & General Settings aus:
- API Base URL — die vollständige HTTPS-URL für Ihre AutoScout24-Umgebung oder Ihren Integrations-Endpunkt, einschließlich
https://. - Seller ID — eine oder mehrere Seller IDs, durch Kommas getrennt, wenn Sie mehrere Verkäuferkonten betreiben.
- Client ID und Client Secret — die für Ihren API-Zugriff ausgestellten Zugangsdaten.
- Default currency — die Standardwährung, die verwendet wird, wenn ein importiertes Inserat keine Währung angibt.
Klicken Sie unten auf der Karte auf Save Settings.
Eine vollständige Anleitung zu jedem Zugangsdaten-Feld, woher es stammt und wie man sicher damit umgeht, finden Sie unter Einrichtung der API-Zugangsdaten. Hintergrundinformationen zur Erlangung des API-Zugangs finden Sie unter AutoScout24 API Setup und External API Credentials.
Schritt 4 — Verbindungstest
Validieren Sie die Zugangsdaten nach dem Speichern vor jedem Import. Öffnen Sie Car Market Hub → Tools und verwenden Sie die Karte API Connection Test. Klicken Sie auf Test Connection. Ein erfolgreicher Test bestätigt, dass sich das Plugin gegenüber dem konfigurierten Token-Endpunkt authentifizieren und die AutoScout24-Inserate-API für die erste konfigurierte Seller ID erreichen kann.
Fahren Sie mit den Import-Einstellungen erst fort, wenn der Verbindungstest erfolgreich war. Das vollständige Verfahren, einschließlich der Interpretation des Ergebnisses und der Reaktion auf häufige Fehler, ist unter Verbindungstest dokumentiert.
Schritt 5 — Import-Einstellungen
Sobald die Verbindung funktioniert, konfigurieren Sie, wie Fahrzeuge importiert werden. Die relevanten Einstellungen befinden sich an zwei Stellen:
- Car Market Hub → Settings — Bildoptionen (ob Bilder importiert werden sollen, maximale Bilder pro Fahrzeug, optionale WebP-Konvertierung und -Qualität), Standard-Beitragsstatus und Beitragsautor für neu erstellte Fahrzeuge sowie die Option Default pages, die beim Speichern die Seiten Cars, Compare Cars und Favorites erstellen kann.
- Car Market Hub → Import & Limits — Zeitplan und Laufzeitverhalten: das WP-Cron-Intervall (stündlich, alle 6 Stunden, zweimal täglich, täglich oder benutzerdefiniert), die Startzeit für tägliche/zweimal tägliche Zeitpläne, der optionale Full Sync-Modus (der lokale Fahrzeuge löscht, die auf AutoScout24 nicht mehr vorhanden sind) und die Cron-Robustheitseinstellungen (maximale Fahrzeuge pro Cron-Durchlauf, Umschalter für die Bildwarteschlange).
Wählen Sie für die Ersteinrichtung konservative Werte:
- Lassen Sie die automatische Zeitplanung vorerst deaktiviert. Planen Sie diese erst nach einem erfolgreichen Testimport.
- Lassen Sie die Bildwarteschlange (image queue) aktiviert, damit Cron-Durchläufe die PHP-Timeouts nicht überschreiten.
- Lassen Sie Full Sync deaktiviert, bis Sie überprüft haben, dass alle erwarteten Fahrzeuge korrekt ankommen. Full Sync löscht lokale Beiträge einschließlich Bildern dauerhaft für jedes Inserat, das nicht von der API zurückgegeben wird.
Für externen (Server-Ebene) Cron, einschließlich des Token-gesicherten REST-Endpunkts, siehe Server Cron Setup.
Schritt 6 — Layout- und Frontend-Einstellungen
Konfigurieren Sie, wie Fahrzeuge im Frontend präsentiert werden, bevor Sie sie für Besucher sichtbar machen:
- Car Market Hub → Design & Styles — Farben, Schriftarten, Archiv- und Einzelfahrzeug-Layouts, Galerie-Layout, Lightbox, Zustands-Badges sowie Intro-/Footer-Texte auf Archivseiten.
- Car Market Hub → Layout Manager — Aktivieren/Deaktivieren einzelner Filter, die im Fahrzeugarchiv erscheinen (Marke, Modell, Jahr, Preis, Kilometerstand, Kraftstoff, Getriebe, Farbe, Karosserieform und andere).
- Car Market Hub → Mapping — Steuern Sie die lesbaren Bezeichnungen und die Sichtbarkeit jedes AutoScout24-Datenfelds auf Detailseiten. Die Standardwerte sind sinnvoll; passen Sie nur die Bezeichnungen oder die Sichtbarkeit an, die Sie tatsächlich ändern möchten.
- Car Market Hub → Shortcodes & Widgets — die Referenz für Shortcodes, die in benutzerdefinierten Seitenlayouts verwendet werden (z. B. die Vergleichs- und Favoritenseiten). Wenn Sie die Option Default pages in den Einstellungen aktiviert haben, existieren die entsprechenden Seiten bereits; andernfalls platzieren Sie die Shortcodes manuell.
Schritt 7 — Rechtliche, Datenschutz- und Einwilligungseinstellungen
ADP Car Market Hub verarbeitet Lead-Daten und optional Suchauftrags-Abonnements. Konfigurieren Sie die entsprechenden Einstellungen, bevor Sie live gehen:
- Car Market Hub → Leads — Konfigurieren Sie die Empfänger-E-Mail-Adresse, die sichtbaren Formularfelder, das Einwilligungs-Kontrollkästchen (Bezeichnung und Pflichtstatus) und die Benachrichtigungsmeldungen. Der Einwilligungstext und die sichtbaren Felder müssen der Datenschutzerklärung des Autohauses entsprechen.
- Car Market Hub → Leads — Konfigurieren Sie auf dieser Registerkarte auch die Optionen für die Probefahrtsbuchung (verfügbare Wochentage, tägliches Zeitfenster, Slot-Dauer, Sperrtage). Car Market Hub → Search Alerts — Wenn die Suchauftrags-Funktion auf der Registerkarte Settings (oder im Einrichtungs-Assistenten) aktiviert ist, verwalten Sie Abonnements hier. Suchaufträge verwenden eine DSGVO-konforme Double-Opt-In-E-Mail-Bestätigung; die E-Mail-Vorlagen für Autohaus- und Kundenbenachrichtigungen werden auf der Registerkarte „Search Alerts“ bzw. auf der Registerkarte „Leads“ konfiguriert.
- Website-weite Datenschutzerklärung — Die WordPress-Website muss eine veröffentlichte Datenschutzerklärung enthalten, die die vom Plugin erfassten Daten abdeckt (Kontaktformulardaten, optionale Analytics-Ereignisse, optionale Suchauftrags-Abonnements).
Hintergrundinformationen finden Sie unter Lead Data and Consent, Search Alerts Double Opt-In, GDPR / DSGVO Notes und Data Storage Overview.
Schritt 8 — Testimport
Führen Sie einen kleinen, kontrollierten Import durch, bevor Sie die automatische Zeitplanung aktivieren.
Zwei sichere Optionen:
- Dry Run (Trockenlauf). Öffnen Sie Car Market Hub → Tools und verwenden Sie die Karte Dry Run. Dies ruft eine Vorschau der Inserate für die konfigurierten Seller ID(s) ab, ohne Fahrzeug-Beiträge zu schreiben. Dies validiert, dass die Zugangsdaten echte Daten erreichen, ohne die Website zu verändern.
- Manueller Import über den Car Importer. Öffnen Sie Car Market Hub → Car Importer. Zeigen Sie die von der API zurückgegebenen Inserate in der Vorschau an und stoßen Sie einen Import für ein oder zwei einzelne Fahrzeuge an. Dies erstellt echte
as24ci_car-Beiträge und fügt Bilder an. Dies ist der schnellste Weg, um den gesamten Importpfad durchgängig zu validieren.
Sobald ein kleiner Import erfolgreich war, führen Sie einen vollständigen manuellen Import über den Batch-Wizard unter Car Market Hub → Import & Limits aus. Der Batch-Wizard läuft in adaptiven Stapeln mit einem Fortschrittsbalken und kann pausiert, fortgesetzt oder abgebrochen werden.
Überprüfen Sie anschließend die Registerkarte Logs, um sicherzustellen, dass keine Warnungen oder Fehler aufgetreten sind.
Schritt 9 — Frontend-Validierung
Validieren Sie nach dem Testimport das Frontend mit echten Daten:
- Öffnen Sie die Archivseite Cars (oder die Seite, auf der das Fahrzeugarchiv eingebettet ist). Vergewissern Sie sich, dass die Fahrzeugkarten korrekt gerendert werden, Bilder geladen werden, Filter wie konfiguriert funktionieren und die Paginierung sich wie erwartet verhält.
- Öffnen Sie mindestens eine Einzelfahrzeugseite. Überprüfen Sie die Galerie, die Fahrzeugdetailtabelle, die Ausstattungsliste, die Preisformatierung, das Kontaktformular (und das Einwilligungs-Kontrollkästchen) sowie alle optionalen Funktionen, die Sie aktiviert haben (Finanzierungsrechner, Probefahrtsformular, Social Sharing).
- Senden Sie ein Test-Kontaktformular von der Einzelfahrzeugseite ab. Vergewissern Sie sich, dass der Lead unter Car Market Hub → Leads erscheint und die Empfänger-E-Mail zugestellt wird.
- Wenn Suchaufträge aktiviert sind, führen Sie ein Test-Abonnement einschließlich der Double-Opt-In-Bestätigungs-E-Mail durch.
- Wenn der AI Assistant aktiviert ist, überprüfen Sie bei mindestens einem Fahrzeug, ob die KI-generierte Beschreibung (und andere von Ihnen aktivierte KI-Ausgaben) für die Veröffentlichung akzeptabel ist.
Beheben Sie eventuelle Probleme — Bezeichnungen, fehlende Felder, Layout —, indem Sie die entsprechende Registerkarte anpassen (Mapping, Design & Styles, Layout Manager, Leads, Settings) und erneut validieren.
Schritt 10 — Go-Live-Prüfungen
Bereiten Sie die Website erst nach Abschluss der vorherigen Schritte auf den Go-Live vor:
- Aktivieren Sie automatische Importe unter Car Market Hub → Import & Limits mit einem sinnvollen Intervall (für viele Autohäuser ist ein stündlicher Zeitplan angemessen; kleinere Kataloge können einen täglichen nutzen). Konfigurieren Sie bei Hostern, die WP-Cron drosseln, einen echten Server-Cron-Job, der auf den Token-gesicherten REST-Endpunkt des Plugins verweist, wie in Server Cron Setup beschrieben.
- Entscheiden Sie, ob Sie Full Sync aktivieren möchten, damit Inserate, die auf AutoScout24 entfernt wurden, auch von der Website gelöscht werden. Aktivieren Sie dies erst, nachdem Sie überprüft haben, dass alle erwarteten Fahrzeuge konsistent im Import erscheinen.
- Führen Sie den Verbindungstest als abschließende Plausibilitätsprüfung erneut durch.
- Gehen Sie die Go-Live-Checkliste durch, um alle verbleibenden übergreifenden Punkte (DNS, Caching, Sichtbarkeit in Suchmaschinen, Monitoring) zu erfassen.
Konfigurationshinweise
- Die Einstellungsseite speichert nur sichtbare Karten. Die Einstellungsseite gruppiert Optionen in Karten (API Connection & General Settings, Default Pages & Shortcodes usw.), die jeweils über eine eigene Schaltfläche Save verfügen. Speichern Sie die bearbeitete Karte, bevor Sie die Seite verlassen.
- Standardseiten (Default pages). Wenn die Option Default pages aktiviert ist und die entsprechenden Seiten noch nicht existieren, werden beim Speichern der Einstellungen automatisch die Seiten Cars, Compare Cars und Favorites erstellt. Wenn Sie diese Seiten manuell verwalten, lassen Sie die Option deaktiviert und platzieren Sie die Shortcodes aus der Registerkarte Shortcodes & Widgets.
- Standardwährung. Die Standardwährung betrifft nur neue oder aktualisierte Importe, für die die API keinen Währungswert zurückgibt. Bestehende Beiträge behalten ihre gespeicherte Währung.
- Mapping vs. Taxonomien. Die Registerkarte Mapping steuert Bezeichnungen und die Sichtbarkeit von Feldern nur in Detailtabellen. Sie ändert nicht die zugrunde liegenden WordPress-Taxonomien, in denen importierte Attributwerte gespeichert sind. Das Umbenennen einer Mapping-Bezeichnung verschiebt keine vorhandenen Taxonomie-Begriffe.
- Bildwarteschlange (Image queue). Wenn die Bildwarteschlange aktiviert ist, laden Cron-Importe nur das erste Bild pro Fahrzeug synchron herunter; die restlichen Bilder werden asynchron von einem Hintergrund-Worker verarbeitet. Dies ist die empfohlene Standardeinstellung und verhindert PHP-Timeouts bei großen Katalogen.
- Full Sync ist destruktiv. Full Sync löscht lokale Fahrzeug-Beiträge (einschließlich Bildern) dauerhaft für Inserate, die nicht mehr von der API zurückgegeben werden. Betrachten Sie dies als eine Option für den Produktivbetrieb und aktivieren Sie sie erst, wenn die Importe stabil laufen.
Betriebliche Hinweise
- Zuerst Staging, dann Produktion. Alle Konfigurationsschritte in diesem Dokument sollten zuerst auf einer Staging-Kopie durchgeführt werden. Sobald das Autohaus das Verhalten auf dem Staging-System freigibt, replizieren Sie die Konfiguration auf der Produktionsumgebung. Exportieren und importieren Sie nicht die gesamte WordPress-Datenbank zwischen Staging und Produktion, es sei denn, Sie verstehen die Auswirkungen auf URLs, Optionen und IDs.
- Täglicher Betrieb. Nach der Einrichtung werden die täglichen Aufgaben (Überwachung von Importen, Bearbeitung von Leads, Überprüfung von Protokollen) in Tägliche Arbeitsabläufe und im Benutzerhandbuch behandelt.
- Berechtigungen und Delegation. Die Ersteinrichtung erfordert einen vollständigen WordPress-Administrator. Für den laufenden Betrieb stellt das Plugin eine delegierte Berechtigung und Rolle bereit, sodass tägliche Benutzer keine vollständigen WordPress-Administrationsrechte benötigen. Siehe Zugriffssteuerung und Berechtigungen.
- Protokollierung. Alle API-Aufrufe, Token-Anfragen, Import-Aktionen und Fehler werden in den Plugin-Protokolldateien in
wp-content/uploads/as24ci-logs/mit Rotation protokolliert. Die detaillierte Protokollierung fügt Details pro Fahrzeug und Bild hinzu und sollte nur vorübergehend zur Fehlerbehebung aktiviert werden.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Was zu prüfen ist |
|---|---|---|
| System & Hilfe zeigt sofort nach der Aktivierung rote Badges. | Die Hosting-Umgebung erfüllt nicht die Anforderungen des Plugins (fehlende PHP-Erweiterung, nicht beschreibbares Uploads-Verzeichnis, fehlerhafter WP-Cron). | Beheben Sie jeden roten Badge mit Ihrem Hosting-Anbieter, bevor Sie fortfahren. Siehe Technische Systemanforderungen. |
| Die Einstellungsseite speichert die Zugangsdaten nicht, oder die Felder erscheinen nach dem Speichern leer. | Das Formular wurde von der falschen Karte gesendet, die Seite ist im Browser gecacht oder ein Sicherheits-Plugin blockiert die Anfrage. | Speichern Sie die richtige Karte. Laden Sie die Seite neu. Deaktivieren Sie vorübergehend andere Plugins, die POST-Anfragen filtern. |
| Der Verbindungstest schlägt fehl. | Falsche API-Basis-URL, falsche Zugangsdaten, blockiertes ausgehendes HTTPS, SSL-/Firewall-Probleme. | Folgen Sie Verbindungstest und API-Verbindungsfehler. |
| Der Testimport importiert null Fahrzeuge. | Die konfigurierte Seller ID hat keine Inserate, die Zugangsdaten authentifizieren sich für ein anderes Konto oder die API hat ein leeres Ergebnis zurückgegeben. | Überprüfen Sie die Seller ID erneut mit dem AutoScout24-Konto des Autohauses; bestätigen Sie dies über den Trockenlauf in den Tools. |
| Fahrzeugseiten werden ohne Bilder gerendert, oder Bilder erscheinen erst später. | Die Bildwarteschlange ist aktiviert (erwartetes Verhalten) und der Hintergrundprozess hat die Warteschlange noch nicht verarbeitet, oder PHP-Timeouts unterbrechen die Downloads. | Nutzen Sie den Status der Bildwarteschlange unter System & Hilfe; triggern Sie Bildwarteschlange jetzt ausführen. Siehe Bildimport-Fehler. |
| Cron-Importe laufen nach dem Aktivieren des Zeitplans nicht automatisch. | WP-Cron ist deaktiviert oder wird vom Hoster gedrosselt. | Konfigurieren Sie einen externen Server-Cron, der auf den REST-Endpunkt des Plugins verweist. Siehe Server-Cron-Einrichtung und Cron-Fehler. |
| Lead-E-Mails werden nicht empfangen. | Die Website kann keine E-Mails senden oder die Empfängeradresse ist falsch. | Überprüfen Sie die Empfänger-E-Mail unter Leads und die Konfiguration für den ausgehenden Mailversand der Website. Siehe E-Mail- und Lead-Fehler. |