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 Live-Gehen, bevor das Frontend auf einer echten Fahrzeugseite überprüft wurde.

Dieses Dokument beschreibt 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 operative Schritt des Assistenten (und jeder andere Plugin-Admin-Tab ausser 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-Bereitstellungen von AutoScout24, aber sie sind nicht obligatorisch – 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 überspringen und die anderen Admin-Tabs zeigen einen Bildschirm "Lizenz erforderlich" an.
  • Lässt den Admin zwischen Demo-Einrichtung (installiert Demo-Fahrzeuge, wendet Demo-Standardwerte an und aktiviert Analytics, damit das Dashboard und die Analytics-Seiten Daten zum Anzeigen haben) und Live-Einrichtung von AutoScout24 (speichert echte Zugangsdaten und ausgewählte Seiten, ohne Demo-Daten zu installieren) wählen.
  • Erfasst das Garagen-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.
  • Aktiviert oder deaktiviert die gängigsten Standardfunktionen (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 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 Admin kann WordPress weiter durchsuchen 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 Verwaltungsberechtigung 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 CMH Center → Dashboard und verwenden Sie den Link Einrichtungs-Assistenten ausführen ganz oben, oder
  • Öffnen Sie CMH Center → 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 erscheint bei nachfolgenden Aufrufen von Admin-Seiten nicht mehr.
  • Der Assistent bleibt über das Dashboard und den Tab "Tools" erreichbar, sodass er jederzeit wieder aufgenommen werden kann.

Schritte des Assistenten

  1. Lizenz – Geben Sie Ihren Lizenzschlüssel ein und aktivieren Sie ihn. 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.
  2. Modus – Wählen Sie Demo-Einrichtung oder Live-Einrichtung von AutoScout24; wählen Sie das Land der Garage, die Währung und die Admin-Sprache.
  3. Garagen-Profil – Name, Strasse, Postleitzahl, Ort, Land, Telefon, E-Mail, Website, Logo.
  4. AutoScout24 – Client ID, Client Secret, Seller ID und API-Basis-URL. Das Feld "Client Secret" wird absichtlich leer dargestellt (siehe Einrichtung der API-Zugangsdaten).
  5. Seiten – Wählen Sie für jede öffentliche Seite (Fahrzeuge, Fahrzeuge vergleichen, Favoriten) Automatisch erstellen, Bestehende Seite verwenden oder Überspringen.
  6. Funktionen – Aktivieren oder deaktivieren Sie die oben aufgeführten Standardfunktionen.
  7. Fertigstellen – Überprüfen Sie die Zusammenfassung und bestätigen Sie. Im Demo-Modus löst der abschliessende Schritt auch den bestehenden Demo-Daten-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 bestehende Optionswerte.
  • Das Deaktivieren und erneute Aktivieren des Plugins öffnet den Assistenten nicht automatisch wieder und überschreibt keine Einstellungen.
  • Der Assistent ändert nur Einstellungen, deren Formularfelder der Admin tatsächlich absendet.
  • Die Demo-Einrichtung ist der einzige Weg, der Demo-Daten 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 Informationen 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 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-Adminbereich.
  • Die Website erfüllt alle Anforderungen auf der Checkliste vor der Installation.
  • Sie haben Ihren ADP Car Market Hub-Lizenzschlüssel bereit. Die Lizenz ist erforderlich, um die Premium-Bereiche des Plugins freizuschalten: Bis sie aktiviert ist, zeigt jeder Admin-Tab ausser Settings einen "Lizenz erforderlich"-Bildschirm an, und Importe, Cron sowie die anderen Funktionen bleiben gesperrt.
  • Sie haben die AutoScout24-API-Zugangsdaten, die für Ihr Konto erforderlich sind: API-Basis-URL, Seller ID(s), Client ID und Client Secret. Diese stammen aus dem AutoScout24-Konto der Garage oder vom Integrationspartner, der den API-Zugang betreibt. Das Plugin stellt diese nicht zur Verfügung.
  • Sie haben sich für geschäftliche Standardeinstellungen entschieden, die die Konfiguration beeinflussen: Standardwährung, welcher rechtliche/Einwilligungstext die Garage auf Kontaktformularen wünscht und welche Funktionen (Probefahrtbuchung, Suchaufträge, AI Assistant, Analytics) beim Start aktiviert sein sollen.
  • Ein Backup der WordPress-Website ist vorhanden, und idealerweise wird die Konfiguration auf einer Staging-Umgebung durchgeführt, die der Live-Umgebung entspricht.

Empfohlene Reihenfolge für die Einrichtung

Die folgenden zehn Schritte stellen die empfohlene Reihenfolge dar. Jeder Schritt baut auf dem vorherigen auf. Überspringen Sie keine Schritte – aktivieren Sie beispielsweise keine automatischen Importe, bevor der Verbindungstest erfolgreich war.

  1. Lizenzaktivierung
  2. Systembereitschaft
  3. API-Zugangsdaten
  4. Verbindungstest
  5. Import-Einstellungen
  6. Layout- und Frontend-Einstellungen
  7. Rechtliche, Datenschutz- und Einwilligungseinstellungen
  8. Testimport
  9. Frontend-Validierung
  10. Go-Live-Checkliste

Schritt-für-Schritt-Anleitung

Schritt 1 — Lizenzaktivierung

Öffnen Sie CMH Center → 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 jedoch Ihre importierten Fahrzeuge, Seiten und Medien bei). Wenn Sie mit dem First Setup Wizard 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 CMH Center → 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 der Berechtigungen für das Uploads-Verzeichnis oder das Beheben eines nicht funktionierenden WP-Cron.

Für eine tiefere Überprüfung der Umgebung siehe Technische Systemanforderungen und API-, Netzwerk- und SSL-Anforderungen.

Schritt 3 — API-Zugangsdaten

Öffnen Sie CMH Center → Connections — die zentrale Anlaufstelle für alle Datenquellen — und klicken Sie auf die Zeile AutoScout24, um sie auszuklappen. (In früheren Versionen befand sich diese Verbindung unter Settings; sie wurde nach Connections verschoben. Settings enthält jetzt nur noch eine schlanke Hinweiskarte Data sources & API connections mit einer Schaltfläche Manage data sources, die diese Seite öffnet.) Füllen Sie die AutoScout24-Felder 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, wenn Sie mehrere Verkäuferkonten betreiben.
  • Client ID und Client Secret — die für Ihren API-Zugriff ausgestellten Zugangsdaten. Das Client Secret wird über den Secret-Speicher des Plugins verschlüsselt im Ruhezustand (encrypted at rest) gespeichert.

Speichern Sie die Quelle. Die Status-Pille wechselt zu Connected und ein Link Open Car Importer erscheint.

Wenn Ihr Inventar aus einer anderen Live-Quelle wie mobile.de oder carcuro (ein carcuro-Firmen-Token) oder aus einem automatischen Feed, einem E-Mail-Posteingang oder einem einmaligen Datei-Upload stammt, verbinden Sie es stattdessen über dasselbe Connections-Akkordeon. Die Default currency wird separat unter General Settings auf CMH Center → Settings konfiguriert.

Eine vollständige Anleitung zu jedem Zugangsdaten-Feld, woher es stammt und wie man sicher damit umgeht, finden Sie unter Einrichtung der API-Zugangsdaten und in der Connections Reference. Hintergrundinformationen zur Erlangung des API-Zugriffs 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 CMH Center → 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-Listings-API für die erste konfigurierte Seller ID erreichen kann.

Fahren Sie nicht mit den Importeinstellungen fort, bis der Verbindungstest erfolgreich war. Das vollständige Verfahren, einschliesslich der Interpretation des Ergebnisses und der Reaktion auf häufige Fehler, ist unter Connection Test dokumentiert.

Schritt 5 — Importeinstellungen

Sobald die Verbindung funktioniert, konfigurieren Sie, wie Fahrzeuge importiert werden. Die relevanten Einstellungen befinden sich an zwei Stellen:

  • CMH Center → Import & Limits → Import Defaults — Bildoptionen (ob Bilder importiert werden sollen, maximale Bilder pro Fahrzeug, optionale WebP-Konvertierung und Qualität) sowie der Standard-Beitragsstatus und Beitragsautor für neu erstellte Fahrzeuge. Bei Neuinstallationen ist der Standard-Beitragsstatus Publish.
  • CMH Center → 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, Bildwarteschlangen-Umschalter).
  • CMH Center → Settings — die Option Default pages, die beim Speichern die Seiten Cars, Compare Cars und Favorites erstellen kann.

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 dauerhaft für jedes Listing, das nicht von der API zurückgegeben wird.

Für externen (Server-Level) Cron, einschliesslich 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:

  • CMH Center → Design & Styles — Farben, Schriftarten, Archiv- und Einzelfahrzeug-Layouts, Galerie-Layout, Lightbox, Zustands-Badges sowie Intro-/Fusszeilentexte auf Archivseiten.
  • CMH Center → Layout Manager — Aktivieren/Deaktivieren einzelner Filter, die im Fahrzeugarchiv erscheinen (Marke, Modell, Jahr, Preis, Kilometerstand, Kraftstoff, Getriebe, Farbe, Karosserietyp und andere).
  • CMH Center → 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.
  • CMH Center → 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 — Rechts-, Datenschutz- und Einwilligungseinstellungen

ADP Car Market Hub verarbeitet Lead-Daten und optional Suchabo-Anmeldungen. Konfigurieren Sie die entsprechenden Einstellungen, bevor Sie live gehen:

  • CMH Center → 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 der Garage entsprechen.
  • CMH Center → Leads — Konfigurieren Sie auf dieser Registerkarte auch die Optionen für die Probefahrt-Buchung (verfügbare Wochentage, tägliches Zeitfenster, Slot-Dauer, Sperrtage). CMH Center → Search Alerts — Wenn die Suchabo-Funktion auf der Registerkarte Settings (oder im Setup Wizard) aktiviert ist, verwalten Sie die 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 eine veröffentlichte Datenschutzerklärung enthalten, die die vom Plugin erfassten Daten abdeckt (Kontaktformulardaten, optionale Analytics-Ereignisse, optionale Suchabo-Anmeldungen).

Hintergrundinformationen finden Sie unter Lead Data and Consent, Search Alerts Double Opt-In, GDPR / DSGVO Notes und in der 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 CMH Center → Tools und verwenden Sie die Karte Dry Run. Dies ruft eine Vorschau der Angebote für die konfigurierten Seller ID(s) 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 CMH Center → Car Importer. Zeigen Sie die von der API zurückgegebenen Angebote in der Vorschau an und starten Sie einen Import für ein oder zwei einzelne Fahrzeuge. Dies erstellt echte as24ci_car-Beiträge und fügt Bilder an. Dies ist 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 CMH Center → Import & Limits durch. 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 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, Probefahrt-Formular, Social Sharing).
  • Senden Sie ein Test-Kontaktformular von der Einzelfahrzeugseite ab. Vergewissern Sie sich, dass der Lead unter CMH Center → 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 alle 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 das Go-Live vor:

  • Aktivieren Sie automatische Importe unter CMH Center → Import & Limits mit einem sinnvollen Intervall (für viele Garagen ist ein stündlicher Zeitplan angemessen; kleinere Kataloge können einen täglichen Zeitplan verwenden). 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 Setup beschrieben.
  • Entscheiden Sie, ob Sie Full Sync aktivieren möchten, damit Angebote, die auf AutoScout24 entfernt wurden, auch von der Website entfernt werden. Aktivieren Sie dies erst, nachdem Sie überprüft haben, dass alle erwarteten Fahrzeuge konsistent im Import erscheinen.
  • Führen Sie den Connection Test als abschliessende Sicherheitsprüfung erneut durch.
  • Gehen Sie die Go-Live-Checkliste durch, um alle verbleibenden übergreifenden Punkte (DNS, Caching, Sichtbarkeit in Suchmaschinen, Monitoring) zu erfassen. ---

Konfigurationshinweise

  • Einstellungsseite speichert nur sichtbare Karten. Die Einstellungsseite gruppiert Optionen in Karten (Allgemeine Einstellungen, Datenquellen & API-Verbindungen, Standardseiten & Shortcodes usw.), die jeweils über eine eigene Schaltfläche Speichern verfügen. Speichern Sie die bearbeitete Karte, bevor Sie die Seite verlassen. Die API-Zugangsdaten befinden sich nicht mehr auf dieser Seite; sie werden unter Connections eingegeben.
  • Standardseiten. Wenn die Option Standardseiten 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 dem Tab Shortcodes & Widgets.
  • Standardwährung. Die Standardwährung wirkt sich nur auf neue oder aktualisierte Importe aus, für die die API keinen Währungswert zurückgibt. Bestehende Beiträge behalten ihre gespeicherte Währung.
  • Mapping vs. Taxonomien. Der Tab Mapping steuert ausschliesslich die Beschriftungen und die Sichtbarkeit von Feldern in Detailtabellen. Er ändert nicht die zugrunde liegenden WordPress-Taxonomien, in denen die importierten Attributwerte gespeichert sind. Das Umbenennen eines Mapping-Labels 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 Fahrzeug-Beiträge (einschliesslich Bilder) dauerhaft, wenn diese von der API nicht mehr 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 die Garage das Verhalten auf der Staging-Umgebung 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 Logs) in Tägliche Arbeitsabläufe und im Benutzerhandbuch behandelt.
  • Berechtigungen und Delegation. Die Ersteinrichtung erfordert einen vollwertigen WordPress-Administrator. Für den laufenden Betrieb stellt das Plugin eine delegierte Berechtigung und Rolle bereit, sodass tägliche Benutzer keine vollen WordPress-Administrationsrechte benötigen. Siehe Zugriffssteuerung und Berechtigungen.
  • Protokollierung (Logging). Alle API-Aufrufe, Token-Anfragen, Importaktionen und Fehler werden in den Plugin-Logdateien in wp-content/uploads/as24ci-logs/ mit Rotation protokolliert. Das detaillierte Logging (Verbose) fügt Details pro Fahrzeug und Bild hinzu und sollte nur vorübergehend zur Fehlerbehebung aktiviert werden.

Fehlerbehebung

SymptomWahrscheinliche UrsacheWas zu prüfen ist
System & Help zeigt sofort nach der Aktivierung rote Badges an.Die Hosting-Umgebung erfüllt die Anforderungen des Plugins nicht (fehlende PHP-Erweiterung, nicht beschreibbares Upload-Verzeichnis, fehlerhafter WP-Cron).Beheben Sie jeden roten Badge mit Ihrem Hosting-Anbieter, bevor Sie fortfahren. Siehe Technische Systemanforderungen.
Connections speichert die Zugangsdaten nicht, oder die Felder erscheinen nach dem Speichern leer.Das Formular wurde aus der falschen Quellzeile gesendet, die Seite ist im Browser-Cache oder ein Sicherheits-Plugin blockiert die Anfrage.Speichern Sie die korrekte Quellzeile. Laden Sie die Seite neu. Deaktivieren Sie vorübergehend andere Plugins, die POST-Anfragen filtern.
Verbindungstest schlägt fehl.Falsche API-Basis-URL, falsche Zugangsdaten, blockiertes ausgehendes HTTPS, SSL-/Firewall-Probleme.Folgen Sie dem Verbindungstest und den API-Verbindungsfehlern.
Testimport importiert null Fahrzeuge.Die konfigurierte Seller ID hat keine Angebote, die Zugangsdaten authentifizieren sich für ein anderes Konto oder die API hat ein leeres Ergebnis zurückgegeben.Überprüfen Sie die Seller ID mit dem AutoScout24-Konto der Garage; bestätigen Sie dies über den Dry Run in den Tools.
Fahrzeugseiten werden ohne Bilder gerendert, oder Bilder erscheinen erst später.Die Bildwarteschlange ist aktiviert (erwartetes Verhalten) und der Hintergrund-Worker hat die Warteschlange noch nicht verarbeitet, oder PHP-Timeouts unterbrechen die Downloads.Nutzen Sie den Status der Bildwarteschlange in System & Help; stossen Sie Bildwarteschlange jetzt ausführen an. Siehe Bildimport-Fehler.
Cron-Importe laufen nach dem Aktivieren des Zeitplans nicht automatisch ab.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.

Zugehörige Dokumente