Dokumentation · Erste Schritte
Erste Einrichtung
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 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 First Setup Wizard finden Sie unter Setup Wizard Reference.
First Setup Wizard
ADP Car Market Hub wird mit einem First Setup Wizard ausgeliefert, der einen Administrator in sieben prägnanten Schritten durch die häufigsten 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 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 ADP Car Market Hub, sind aber 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 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 die Dashboard- und Analytics-Seiten Daten zum Anzeigen haben) und Live-Einrichtung von ADP Car Market Hub (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 Base 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 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 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 Einrichtungsassistenten starten, oder
- Öffnen Sie Car Market Hub → Dashboard und verwenden Sie den Link Einrichtungsassistenten ausführen oben, oder
- Öffnen Sie Car Market Hub → Tools und verwenden Sie die Karte Einrichtungsassistent.
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 Ladevorgängen von Admin-Seiten nicht mehr.
- Der Assistent bleibt über das Dashboard und den Tab "Tools" 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-Einrichtung von ADP Car Market Hub; wählen Sie das Land der Garage, die Währung und die Admin-Sprache.
- Garagen-Profil – Name, Strasse, Postleitzahl, Ort, Land, Telefon, E-Mail, Website, Logo.
- AutoScout24 – Client ID, Client Secret, Seller ID und API Base 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 letzte 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 Reaktivieren 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 Reset- und Seed-Vorgang. 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 Einträge 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 Settings einen Bildschirm "Lizenz erforderlich" an, und Importe, Cron und die anderen Funktionen bleiben gesperrt.
- Sie haben die AutoScout24-API-Zugangsdaten, die für Ihr Konto erforderlich sind: API Base URL, Seller ID(s), Client ID und Client Secret. Diese stammen aus dem AutoScout24-Konto der Garage oder von dem Integrationspartner, der den API-Zugriff betreibt. Das Plugin stellt diese nicht zur Verfügung.
- Sie haben sich für geschäftliche Standardwerte 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 Produktion entspricht.
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 (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 begonnen 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 tiefere Überprüfung der Umgebung siehe Technische Systemanforderungen und API-, Netzwerk- und SSL-Anforderungen.
Schritt 3 — API-Zugangsdaten
Öffnen Sie Car Market Hub → Universal Import — 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 zu Universal Import 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 den 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-Store 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 carcuro (ein carcuro-Firmentoken) oder aus einem automatischen Feed, einem E-Mail-Posteingang oder einem einmaligen Datei-Upload stammt, verbinden Sie es stattdessen über dasselbe Universal Import-Akkordeon. Die Default currency wird separat unter General Settings auf Car Market Hub → Settings konfiguriert.
Eine vollständige Anleitung zu jedem Zugangsdatenfeld, woher es stammt und wie man sicher damit umgeht, finden Sie in der Einrichtung der API-Zugangsdaten und der Universal Import 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 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-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 Verbindungstest dokumentiert.
Schritt 5 — Importeinstellungen
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, Bildwarteschlangen-Umschalter).
Wählen Sie für die Ersteinrichtung konservative Werte:
- Lassen Sie die automatische Zeitplanung vorerst deaktiviert. Planen Sie diese erst nach einem erfolgreichen Testimport.
- Halten 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 Angebot, 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:
- Car Market Hub → Design & Styles — Farben, Schriftarten, Archiv- und Einzelfahrzeug-Layouts, Galerie-Layout, Lightbox, Zustands-Badges sowie Intro-/Fusszeilentext auf Archivseiten.
- Car Market Hub → Layout Manager — Aktivieren/Deaktivieren einzelner Filter, die im Fahrzeugarchiv erscheinen (Marke, Modell, Jahr, Preis, Kilometerstand, Kraftstoff, Getriebe, Farbe, Karosserietyp und andere).
- Car Market Hub → Mapping — Steuern Sie die lesbaren Beschriftungen und die Sichtbarkeit jedes einzelnen AutoScout24-Datenfelds auf Detailseiten. Die Standardeinstellungen 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. auf den 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 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 Probefahrtsbuchung (verfügbare Wochentage, tägliches Zeitfenster, Slot-Dauer, Sperrdaten). Car Market Hub → Search Alerts — wenn die Suchabo-Funktion auf der Registerkarte Settings (oder im Setup-Assistenten) 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-Daten und Einwilligung, Suchabos Double-Opt-In, DSGVO / DSGVO-Hinweise 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. Dadurch wird eine Vorschau der Angebote für die konfigurierten Seller ID(s) abgerufen, ohne dass Fahrzeugbeiträge geschrieben werden. Dies validiert, dass die Zugangsdaten tatsächliche Daten erreichen, ohne die Website zu verändern.
- Manueller Import über den Car Importer. Öffnen Sie Car Market Hub → Car Importer. Zeigen Sie eine Vorschau der von der API zurückgegebenen Angebote 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. Es ist somit der schnellste Weg, den gesamten Importpfad von Ende zu Ende 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 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, die Bilder geladen werden, die Filter wie konfiguriert funktionieren und sich die Seitennummerierung 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 Suchabos aktiviert sind, schliessen Sie eine Test-Anmeldung einschliesslich der Double-Opt-In-Bestätigungs-E-Mail ab.
- 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 eventuelle Probleme — Beschriftungen, 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 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). Auf Hosts, die WP-Cron drosseln, konfigurieren Sie 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 Verbindungstest 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 Universal Import 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 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 Fahrzeug-Beiträge (einschliesslich Bilder) dauerhaft, wenn diese von der API nicht mehr zurückgegeben werden. Behandeln 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 der Importe, Bearbeitung von Leads, Überprüfung der Logs) in den Täglichen Arbeitsabläufen 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. Die detaillierte Protokollierung (Verbose Logging) 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 & Help zeigt sofort nach der Aktivierung rote Badges. | 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-Provider, bevor Sie fortfahren. Siehe Technische Systemanforderungen. |
| Universal Import 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 gecacht 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. |