Dokumentation · Erste Schritte
Erste Einrichtung
Diese Anleitung erklärt, was ein WordPress-Administrator nach der Aktivierung des ADP Car Market Hub-Plugins und in welcher Reihenfolge konfigurieren sollte. Das Befolgen der empfohlenen Reihenfolge vermeidet die häufigsten Nacharbeiten – wie beispielsweise das Ausführen eines Imports, bevor die API-Verbindung validiert ist, oder das Liveschalten, 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 Referenz zum Einrichtungs-Assistenten.
Ersteinrichtungs-Assistent
ADP Car Market Hub wird mit einem Ersteinrichtungs-Assistenten ausgeliefert, der einen Administrator in sieben prägnanten Schritten durch die gängigsten Konfigurationsentscheidungen führt. Der erste Schritt ist die Lizenzaktivierung, die obligatorisch ist: Bis eine gültige Lizenz aktiviert ist, bleibt jeder operative Schritt des Assistenten (und jeder andere Admin-Tab des Plugins ausser "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 obligatorisch – jede Option, die sie bieten, kann auch manuell über die regulären Admin-Tabs konfiguriert werden, die in der Admin-Referenz dokumentiert sind.
Was der Assistent macht
- Aktiviert Ihre Lizenz als ersten Schritt. Die Lizenz schaltet die Premium-Bereiche des Plugins frei; ohne sie kann der Assistent den Lizenzbildschirm nicht überspringen und die anderen Admin-Tabs zeigen einen Bildschirm "Lizenz erforderlich" an.
- Lässt den Administrator zwischen Demo-Einrichtung (installiert Demo-Fahrzeuge, 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 Demo-Daten zu installieren) wählen.
- Erfasst das Garagenprofil (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, Suchabos, Analytics-Tracking).
- Markiert die Einrichtung als abgeschlossen und leitet den Administrator zurück zum Dashboard.
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 Administrator 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 Vorläufig überspringen. Der Hinweis wird bei nachfolgenden Ladevorgängen von Admin-Seiten nicht mehr angezeigt.
- Der Assistent bleibt über das Dashboard und den Tools-Tab erreichbar, sodass er jederzeit fortgesetzt werden kann.
Schritte des Assistenten
- Lizenz – Lizenzschlüssel eingeben und aktivieren. Dieser Schritt wird zuerst erzwungen; der Assistent kann mit keinem operativen Schritt fortfahren, bis die Lizenz betriebsbereit ist. Der Lizenzschlüssel ist schreibgeschützt – er wird auf dem Bildschirm niemals vorausgefüllt.
- Modus – Wählen Sie Demo-Einrichtung oder Live-AutoScout24-Einrichtung; wählen Sie das Land der Garage, die Währung und die Admin-Sprache.
- Garagenprofil – Name, Strasse, 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 bestehenden Demo-Daten-Installer aus; im Live-Modus speichert er nur die Einstellungen des Assistenten.
Sicherheit bei bestehenden Installationen
- Die Plugin-Aktivierung setzt nur zerstörungsfreie Standardwerte; sie überschreibt niemals bestehende Optionswerte.
- Das Deaktivieren und Reaktivieren des Plugins öffnet den Assistenten nicht automatisch wieder und überschreibt keine Einstellungen.
- Der Assistent ändert nur Einstellungen, deren Formularfelder der Administrator tatsächlich absendet.
- Die Demo-Einrichtung ist der einzige Pfad, der Demo-Daten installiert und demo-gesteuerte Optionen zurücksetzt; es handelt sich um einen expliziten Zurücksetzungs- und Befüllungsvorgang. Die Live-Einrichtung ist in Bezug auf Fahrzeuge und Kundeneinstellungen zerstörungsfrei.
Ausführliche Informationen zu Flags, Berechtigungen, der URL der versteckten Admin-Seite und dem Speicherverhalten der Schritte finden Sie unter Referenz zum Einrichtungs-Assistenten.
Wann Sie dieses Dokument verwenden sollten
Verwenden Sie dieses Dokument, wenn Sie:
- ADP Car Market Hub auf einer neu aktivierten Installation konfigurieren.
- Das Plugin nach einer Servermigration, einem Neuaufbau der Umgebung oder einem Wechsel von Staging zu Produktion neu konfigurieren.
- Einen wiederholbaren Onboarding-Prozess für eine neue Kunden-Website dokumentieren.
Die Zielgruppe ist ein WordPress-Administrator, der die Installationsanleitung bereits abgeschlossen hat und Zugriff auf die AutoScout24-API-Zugangsdaten hat, die vom Konto der Garage oder deren 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 Punkte 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 ausser Einstellungen einen Bildschirm "Lizenz erforderlich" an, und Importe, Cron 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 der Garage oder von dem Integrationspartner, der den API-Zugang betreibt. Das Plugin stellt diese nicht zur Verfügung.
- Sie haben sich für geschäftliche Standardwerte entschieden, die die Konfiguration beeinflussen: Standardwährung, welchen rechtlichen/Einverständnistext die Garage auf Kontaktformularen wünscht und welche Funktionen (Probefahrtbuchung, Suchabos, AI Assistant, Analytics) beim Start aktiviert sein sollen.
- Ein Backup der WordPress-Website ist vorhanden, und im Idealfall wird die Konfiguration auf einer Staging-Umgebung durchgeführt, die die Produktion widerspiegelt.
Empfohlene Reihenfolge der Einrichtung
Die folgenden zehn Schritte sind die empfohlene Reihenfolge. Jeder Schritt baut auf dem vorherigen auf. Überspringen Sie keine Schritte – 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
- Checks vor dem Liveschalten
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 (ausser Settings) zeigen nicht mehr den Bildschirm "License required" an, und Importe, Cron 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 aber Ihre importierten Fahrzeuge, Seiten und Medien bei). Wenn Sie mit dem Ersteinrichtungs-Assistenten gestartet haben, 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 Logdatei und der Bildwarteschlange mit Status-Badges im Ampelstil.
Beheben Sie alle roten Badges, bevor Sie fortfahren. Typische Massnahmen 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, einschliesslich
https://. - Seller ID — eine oder mehrere Seller IDs, durch Kommas getrennt, falls 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-Zugriffs finden Sie unter AutoScout24 API-Einrichtung und Externe API-Zugangsdaten.
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 Importeinstellungen erst fort, wenn der Verbindungstest erfolgreich war. Das vollständige Verfahren, einschliesslich der Interpretation des Ergebnisses und der Reaktion auf häufige Fehler, ist unter Verbindungstest dokumentiert.
Schritt 5 — Importeinstellungen
Sobald die Verbindung funktioniert, konfigurieren Sie, wie Fahrzeuge importiert werden. Die relevanten Einstellungen befinden sich an zwei Orten:
- Car Market Hub → Settings — Bildoptionen (ob Bilder importiert werden sollen, maximale Anzahl 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 Anzahl 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 einschliesslich Bildern für jedes Inserat, das nicht von der API zurückgegeben wird, dauerhaft.
Für externen (Server-Ebene) Cron, einschliesslich des token-gesicherten REST-Endpunkts, siehe Server-Cron-Einrichtung.
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 angezeigt werden (Marke, Modell, Jahr, Preis, Kilometerstand, Treibstoff, Getriebe, Farbe, Karosserietyp und andere).
- Car Market Hub → Mapping — Steuern Sie die benutzerfreundlichen Beschriftungen und die Sichtbarkeit jedes AutoScout24-Datenfelds auf Detailseiten. Die Standardwerte sind sinnvoll; passen Sie nur die Beschriftungen 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 fügen Sie die Shortcodes manuell ein.
Schritt 7 — Rechtliche, Datenschutz- und Einwilligungseinstellungen
ADP Car Market Hub verarbeitet Lead-Daten und optional Suchabo-Anmeldungen. 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 (Beschriftung und Pflichtstatus) und die Benachrichtigungsmeldungen. Der Einwilligungstext und die sichtbaren Felder müssen der Datenschutzerklärung der Garage entsprechen.
- Car Market Hub → Leads — Konfigurieren Sie auf dieser Registerkarte auch die Optionen für die Probefahrt-Buchung (verfügbare Wochentage, tägliches Zeitfenster, Slot-Dauer, Sperrtage). Car Market Hub → Search Alerts — Wenn die Suchabo-Funktion auf der Registerkarte Settings (oder im Einrichtungs-Assistenten) aktiviert ist, verwalten Sie Abonnements hier. Suchabos verwenden eine DSGVO-konforme Double-Opt-In-E-Mail-Bestätigung; die E-Mail-Vorlagen für Garagen- und Kundenbenachrichtigungen werden auf der Registerkarte Search Alerts bzw. auf der Registerkarte Leads konfiguriert.
- Website-weite Datenschutzerklärung — Die WordPress-Website muss über eine veröffentlichte Datenschutzerklärung verfügen, die die vom Plugin erfassten Daten abdeckt (Kontaktformulardaten, optionale Analyse-Ereignisse, optionale Suchabo-Anmeldungen).
Hintergrundinformationen finden Sie unter Lead-Daten und Einwilligung, Suchabos Double-Opt-In, Hinweise zur DSGVO / DSG und in der Datenspeicherungs-Übersicht.
Schritt 8 — Testimport
Führen Sie einen kleinen, kontrollierten Import durch, bevor Sie die automatische Zeitplanung aktivieren.
Zwei sichere Optionen:
- Trockenlauf (Dry run). Öffnen Sie Car Market Hub → Tools und verwenden Sie die Karte Dry Run. Dies ruft eine Vorschau der Inserate für die konfigurierten Seller IDs ab, ohne Fahrzeugbeiträ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 lösen Sie einen Import für ein oder zwei einzelne Fahrzeuge aus. Dies erstellt echte
as24ci_car-Beiträge und fügt Bilder an. Es ist somit der schnellste Weg, um den gesamten Importpfad durchgehend 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 Schritten mit einem Fortschrittsbalken und kann pausiert, fortgesetzt oder abgebrochen werden.
Überprüfen Sie anschliessend die Registerkarte Logs, um sicherzustellen, dass keine Warnungen oder Fehler aufgetreten sind.
Schritt 9 — Frontend-Validierung
Validieren Sie das Frontend nach dem Testimport mit echten Daten:
- Öffnen Sie die Archivseite Cars (oder die Seite, auf der das Fahrzeugarchiv eingebettet ist). Bestätigen Sie, 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, Probefahrt-Formular, Social Sharing).
- Senden Sie ein Test-Kontaktformular von der Einzelfahrzeugseite ab. Bestätigen Sie, dass der Lead unter Car Market Hub → Leads erscheint und die Empfänger-E-Mail zugestellt wird.
- Wenn Suchabos aktiviert sind, führen Sie eine Test-Anmeldung einschliesslich 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 geeignet ist.
Beheben Sie allfällige Probleme — Beschriftungen, fehlende Felder, Layout —, indem Sie die entsprechende Registerkarte anpassen (Mapping, Design & Styles, Layout Manager, Leads, Settings) und erneut validieren.
Schritt 10 — Kontrollen vor dem Livegang
Bereiten Sie die Website erst nach Abschluss der vorherigen Schritte auf den Livegang vor:
- Aktivieren Sie automatische Importe unter Car Market Hub → Import & Limits mit einem sinnvollen Intervall (für viele Garagen 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-Cronjob, der auf den token-gesicherten REST-Endpunkt des Plugins verweist, wie unter Server-Cron-Einrichtung beschrieben.
- Entscheiden Sie, ob Sie Full Sync aktivieren möchten, damit auf AutoScout24 entfernte Inserate 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 abschliessende Sicherheitskontrolle erneut durch.
- Gehen Sie die Checkliste für den Livegang durch, um alle verbleibenden übergreifenden Punkte (DNS, Caching, Sichtbarkeit für 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. 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 fügen Sie die Shortcodes aus der Registerkarte Shortcodes & Widgets manuell ein.
- 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 Beschriftungen 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-Beschriftung verschiebt keine bestehenden Taxonomie-Begriffe.
- Bildwarteschlange. 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 grossen Katalogen.
- Full Sync ist destruktiv. Full Sync löscht lokale Fahrzeugbeiträge (einschliesslich Bildern) für Inserate, die nicht mehr von der API zurückgegeben werden, dauerhaft. Behandeln Sie dies als 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 die Garage das Verhalten auf der Staging-Umgebung freigibt, replizieren Sie die Konfiguration auf der Produktion. Exportieren und importieren Sie nicht die gesamte WordPress-Datenbank zwischen Staging und Produktion, ausser 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äglicher Betrieb 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 Zugriffskontrolle und Berechtigungen.
- Protokollierung. Alle API-Aufrufe, Token-Anfragen, Importaktionen und Fehler werden in den Plugin-Protokolldateien in
wp-content/uploads/as24ci-logs/mit Rotation protokolliert. Die detaillierte Protokollierung fügt Einzelheiten 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 an. | Die Hosting-Umgebung erfüllt die Anforderungen des Plugins nicht (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 Felder erscheinen nach dem Speichern leer. | Das Formular wurde von der falschen Karte gesendet, die Seite ist im Browser-Cache 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 dem Verbindungstest und den API-Verbindungsfehlern. |
| 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 der Garage; bestätigen Sie dies über den Trockenlauf unter Werkzeuge. |
| 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; lösen Sie Bildwarteschlange jetzt ausführen aus. Siehe Bildimportfehler. |
| Cron-Importe starten nach dem Aktivieren des Zeitplans nicht automatisch. | WP-Cron ist deaktiviert oder wird vom Host 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 Postausgangskonfiguration der Website. Siehe E-Mail- und Lead-Fehler. |