Dokumentation · Fehlerbehebung
Fehlerbehebung FAQ
Dieses Dokument beantwortet die am häufigsten gestellten Fragen zur Fehlerbehebung für das ADP Car Market Hub-Plugin. Für detaillierte Schritt-für-Schritt-Anleitungen folgen Sie bitte den Links zu den entsprechenden Dokumenten zur Fehlerbehebung.
Allgemein
Das Plugin-Menü fehlt nach der Aktivierung im WordPress-Adminbereich.
Der Plugin-Adminbereich ist nur für WordPress-Benutzer mit der Berechtigung manage_as24_imports zugänglich, die während der Aktivierung der Rolle administrator zugewiesen wird. Melden Sie sich als ein WordPress-Administrator an. Wenn das Menü weiterhin fehlt, deaktivieren Sie das Plugin und aktivieren Sie es erneut, um die Zuweisung der Berechtigungen erneut auszuführen. Siehe Berechtigungsfehler.
Ich kann den Plugin-Adminbereich sehen, aber alle Schaltflächen geben "Zugriff verweigert" zurück.
Alle AJAX-Aktionen und Formularübermittlungen des Plugins überprüfen die Berechtigung manage_as24_imports. Wenn Ihrem Benutzerkonto erst nach der Aktivierung des Plugins der Administrator-Status zugewiesen wurde, wurde die Berechtigung möglicherweise nicht vergeben. Deaktivieren Sie das Plugin und aktivieren Sie es erneut, oder bitten Sie einen Super-Administrator, Ihre Rolle zu überprüfen. Siehe Berechtigungsfehler.
Wie kann ich überprüfen, was das Plugin gerade tut?
Öffnen Sie den Tab Protokolle im Plugin-Adminbereich. Das Protokoll zeichnet alle Importläufe, Fehler, Bilddownloads und Systemereignisse auf. Für einen herunterladbaren Diagnose-Export (JSON oder ZIP) verwenden Sie den Tab System & Hilfe. Siehe Cron-Fehler und Importfehler.
Lizenzierung
Eine Funktion zeigt "für diese Lizenz nicht aktiv" an oder ein ganzer Tab wird durch einen Sperrbildschirm ersetzt.
Mehrere Funktionen (unter anderem Market Insights, der KI-Assistent und das Content Studio) werden durch Ihre ADP Car Market Hub-Plugin-Lizenz gesteuert. Wenn die Lizenz eine Funktion nicht enthält, zeigt diese Funktion einen freundlichen Hinweis "in dieser Lizenz nicht enthalten" an und ihre Aktionen werden nicht ausgeführt. Wenn die Lizenz selbst nicht betriebsbereit ist (z. B. abgelaufen oder nicht verifiziert), werden betriebliche Aktionen wie Importe pausiert und die betroffenen Admin-Bereiche zeigen einen Lizenz-Sperrbildschirm an. Bestehende Fahrzeugseiten und -daten werden in keinem der beiden Fälle gelöscht. Kontaktieren Sie den Support von ADP Car Market Hub, um eine Funktion zu aktivieren oder eine abgelaufene oder ausgesetzte Lizenz wiederherzustellen. Siehe Probleme mit Market Insights.
Importe wurden gestoppt und das Protokoll erwähnt die Lizenz.
Wenn die Lizenz abgelaufen oder ausgesetzt ist oder nicht über den Kulanzzeitraum hinaus verifiziert werden kann, werden betriebliche Aktionen wie Importe und die tägliche Preisanalyse pausiert (sie schalten auf "sicher gesperrt"). Es werden dadurch keine Beiträge, Meta-Daten oder Medien gelöscht. Stellen Sie die Lizenz wieder her oder erneuern Sie sie, um den normalen Betrieb wieder aufzunehmen.
Einrichtungsassistent
Der Einrichtungshinweis "Willkommen bei ADP Car Market Hub" erscheint nicht.
Der Hinweis wird nur angezeigt, wenn ein Zeitstempel der Erstaktivierung aufgezeichnet wurde, der Assistent noch nicht abgeschlossen oder übersprungen wurde und der aktuelle Benutzer über die Verwaltungsberechtigung des Plugins verfügt. Plugin-Upgrades, die keine frische Aktivierung auslösen, zeigen den Hinweis auf bestehenden Installationen nicht an. Sie können den Assistenten jederzeit manuell über Car Market Hub → Tools → Setup Wizard oder über den Link Einrichtungsassistenten ausführen auf dem Dashboard öffnen. Siehe Referenz für den Einrichtungsassistenten.
Ich habe den Assistenten übersprungen. Wie öffne ich ihn wieder?
Öffnen Sie Car Market Hub → Tools und klicken Sie auf die Karte Einrichtungsassistent, oder verwenden Sie den Link Einrichtungsassistenten ausführen oben auf Car Market Hub → Dashboard. Der Assistent bleibt unter wp-admin/admin.php?page=as24ci-setup-wizard erreichbar, auch nachdem er übersprungen oder abgeschlossen wurde.
Der Assistent hat meine Seiten nicht erstellt.
Entweder wurde in Schritt 4 die Option Überspringen für diese Seite ausgewählt, eine bereits existierende Seite mit demselben Titel wurde wiederverwendet (der Assistent vermeidet Duplikate durch Titel-Abgleich) oder die entsprechende Option (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) zeigte bereits auf eine veröffentlichte Seite. Öffnen Sie die WordPress Pages-Liste, um dies zu überprüfen. Der Assistent löscht niemals bestehende Seiten.
Das Feld "Client Secret" ist leer, wenn ich Schritt 3 erneut öffne.
Dies ist beabsichtigt. Das gespeicherte Client Secret wird niemals im Admin-HTML gerendert, weder im Assistenten noch im Einstellungen-Tab. Wenn Sie das Formular mit leerem Feld absenden, bleibt das vorhandene gespeicherte Secret erhalten. Das Absenden eines nicht leeren Werts ersetzt es.
Analytics ist nach einer Live-Einrichtung nicht aktiviert.
Im Live-Modus ist das Analytics-Häkchen standardmäßig deaktiviert und muss explizit aktiviert werden. Öffnen Sie den Assistenten erneut und aktivieren Sie das Analytics-Häkchen in Schritt 5, oder aktivieren Sie Analytics im Tab "Analytics". Prüfen Sie vorher die Cookie-Einwilligung und die Datenschutzanforderungen. Siehe Analytics-Aufbewahrung.
Demo-Daten wurden nicht installiert.
Demo-Daten werden nur installiert, wenn in Schritt 1 Demo-Einrichtung ausgewählt ist und der Assistent in Schritt 6 mit Demo-Daten installieren und fertigstellen abgeschlossen wird. Eine Live-Einrichtung installiert keine Demo-Daten. Demo-Daten können auch jederzeit über die Karte Demo-Daten auf Car Market Hub → Tools installiert werden.
Die Seiten für Vergleich oder Favoriten sind nach einer Demo-Installation leer.
Vergleich und Favoriten sind clientseitige Funktionen, die aus dem localStorage des Besucher-Browsers lesen. Der Demo-Installer stellt ein Fallback bereit, das den localStorage beim ersten Laden der Seite befüllt. Öffnen Sie die Seiten "Fahrzeuge", "Vergleich" oder "Favoriten" einmal in derselben Browsersitzung, um das Befüllen auszulösen.
Überschreibt der Assistent meine vorhandenen Einstellungen, wenn ich ihn erneut ausführe?
Nein. Der Assistent schreibt nur Optionen, deren Formularfelder der Administrator tatsächlich absendet. Das erneute Ausführen führt niemals dazu, dass eine Einstellung gelöscht wird, die nicht im abgesendeten Formular enthalten war. Das Client Secret bleibt erhalten, wenn das Feld leer gelassen wird. Die Aktivierung und Reaktivierung des Plugins sind ebenfalls zerstörungsfrei.
API und Verbindung
Der Verbindungstest schlägt mit "Fehlende API-Zugangsdaten" fehl.
Die API-Basis-URL, die Client ID oder das Client Secret ist leer oder fehlerhaft. Öffnen Sie den Tab Einstellungen des Plugins, stellen Sie sicher, dass alle drei Felder ausgefüllt sind, und speichern Sie. Siehe API-Verbindungsfehler.
Das Access Token läuft ständig ab und Importe schlagen fehl.
Das Plugin zwischenspeichert das Access Token im Transient as24ci_access_token. Wenn der Token-Endpunkt einen sehr kurzen expires_in-Wert zurückgibt, läuft das Token möglicherweise ab, bevor der Import abgeschlossen ist. Löschen Sie das Transient über WP-CLI (wp transient delete as24ci_access_token) und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren API-Anbieter, um die Gültigkeitsdauer des Tokens zu bestätigen. Siehe API-Verbindungsfehler.
Der Import gibt null Fahrzeuge zurück, obwohl mein AutoScout24-Konto Angebote enthält.
Die häufigsten Ursachen sind: Die Seller ID ist falsch, die Angebote sind auf AutoScout24 nicht aktiv oder live, oder die API-Zugangsdaten haben keinen Zugriff auf die konfigurierte Seller ID. Überprüfen Sie alle vier Einstellungen (Basis-URL, Client ID, Client Secret, Seller ID) und kontrollieren Sie das Plugin-Protokoll auf spezifische Fehlermeldungen. Siehe API-Verbindungsfehler und Importfehler.
Importieren
Fahrzeuge werden als Entwürfe importiert, anstatt automatisch veröffentlicht zu werden.
Der Standard-Beitragsstatus ist konfigurierbar. Öffnen Sie den Tab Importer oder Einstellungen des Plugins und überprüfen Sie die Einstellung Standard-Beitragsstatus. Ändern Sie sie von draft auf publish, wenn Fahrzeuge sofort nach dem Import auf der Website erscheinen sollen. Beachten Sie, dass der Import als draft die konservative Standardeinstellung bei Neuinstallationen ist. Siehe Importfehler.
Einige Fahrzeugfelder sind nach dem Import leer.
Der Import ordnet die Felder der API-Antwort mithilfe der Feld-Mapping-Konfiguration des Plugins dem WordPress-Post-Meta zu. Wenn ein Feld leer ist, enthält entweder das AutoScout24-Angebot keinen Wert für dieses Feld oder das Feld-Mapping wurde geändert. Überprüfen Sie den Tab Feld-Mapping im Plugin-Adminbereich und stellen Sie sicher, dass die entsprechenden Felder korrekt zugeordnet sind. Siehe Importfehler.
Der automatische Import läuft nicht.
Automatische Importe erfordern, dass die Option Automatischer Import aktiviert ist und WP-Cron funktioniert. Öffnen Sie den Tab Import & Limits → Automatisierung, um zu bestätigen, dass der automatische Import aktiviert und ein Zeitplan konfiguriert ist. Überprüfen Sie dann den Tab System & Hilfe, um sicherzustellen, dass das Event as24ci_scheduled_import geplant ist. Wenn DISABLE_WP_CRON in wp-config.php auf true gesetzt ist, wird WP-Cron nicht ausgeführt und es muss ein externer Cron-Trigger konfiguriert werden. Siehe Cron-Fehler.
Bilder
Fahrzeuge werden importiert, haben aber keine Bilder.
Der Bildimport wird durch die Option Bilder importieren in den Importer-Einstellungen gesteuert. Stellen Sie sicher, dass diese aktiviert ist. Wenn sie aktiviert ist, aber immer noch Bilder fehlen, öffnen Sie das Plugin-Protokoll und suchen Sie nach Image download failed oder media_handle_sideload failed, um den spezifischen Fehler zu identifizieren. Häufige Ursachen sind unzureichender Speicherplatz, fehlende Schreibrechte auf wp-content/uploads und PHP-Memory-Limits. Siehe Bildimport-Fehler.
Einige Bilder fehlen, während andere erfolgreich importiert wurden.
Das Plugin verarbeitet Bilder über eine Hintergrund-Warteschlange (den Image Queue Worker). Bilder, die im Hauptimportlauf nicht heruntergeladen werden konnten, werden asynchron erneut versucht. Überprüfen Sie den Tab System & Hilfe auf die Größe der Bildwarteschlange und die letzte Ausführungszeit. Sie können die Warteschlange auch manuell über die Schaltfläche Bildwarteschlange ausführen starten. Siehe Bildimport-Fehler.
Konvertierte WebP-Bilder werden nicht generiert.
Die WebP-Konvertierung erfordert entweder die GD-Erweiterung mit imagewebp-Unterstützung oder die Imagick-Erweiterung. Stellen Sie sicher, dass eine dieser Erweiterungen auf Ihrem Server verfügbar ist (überprüfen Sie dies unter Werkzeuge → Website-Zustand → Info → Server in WordPress). Die WebP-Konvertierung ist standardmäßig deaktiviert. Aktivieren Sie sie in den Importer-Einstellungen, wenn Ihr Server dies unterstützt. Siehe Bildimport-Fehler.
Frontend-Anzeige
Die Fahrzeug-Archivseite zeigt einen 404-Fehler.
Die häufigste Ursache ist, dass die WordPress-Permalink-Struktur neu generiert werden muss. Gehen Sie zu Einstellungen → Permalinks und klicken Sie auf Änderungen speichern, ohne Änderungen vorzunehmen. Dadurch werden die Rewrite-Regeln neu generiert. Siehe Probleme mit der Frontend-Anzeige.
Die Fahrzeug-Übersichtsseite zeigt keine Fahrzeuge an, obwohl Fahrzeuge importiert wurden.
Fahrzeuge müssen den Status publish haben, um im Archiv zu erscheinen. Überprüfen Sie, ob sich Fahrzeuge im Entwurfsstatus befinden, und veröffentlichen Sie diese. Stellen Sie außerdem sicher, dass kein aktiver Filter oder Suchbegriff die Ergebnisse ausblendet und dass kein Caching-Plugin eine veraltete Seite ausliefert. Siehe Probleme mit der Frontend-Anzeige.
Die Fahrzeug-Archiv- oder Detailseiten sehen fehlerhaft oder ungestaltet aus.
Das Plugin lädt sein CSS und JavaScript nur auf Seiten, auf denen ein Fahrzeug-Shortcode in post_content vorhanden ist, oder auf Standard-CPT-Archiv- und Einzel-Templates. Wenn Ihr Theme einen Page Builder oder ein benutzerdefiniertes Template verwendet, das post_content nicht direkt rendert, werden die Assets möglicherweise nicht geladen. Fügen Sie den Shortcode [as24ci_archive] direkt in das Inhaltsfeld der Seite ein. Siehe Probleme mit der Frontend-Anzeige und Shortcode-Probleme.
Shortcodes
Ein Shortcode wird als reiner Text auf der Seite angezeigt.
Die Shortcode-Verarbeitung ist in einigen Kontexten deaktiviert (z. B. in Page Buildern, Widget-Bereichen oder benutzerdefinierten Template-Dateien, die do_shortcode nicht aufrufen). Stellen Sie sicher, dass der Shortcode im standardmäßigen WordPress-Inhaltsfeld einer Seite oder eines Beitrags platziert ist und nicht in einem Widget, benutzerdefinierten Feld oder PHP-Template. Siehe Shortcode-Probleme.
Der Shortcode [as24ci_archive] gibt nichts aus.
Wenn sich der Shortcode an der richtigen Position befindet, aber nichts ausgibt, ist die wahrscheinlichste Ursache, dass keine veröffentlichten Fahrzeuge existieren. Überprüfen Sie, ob Fahrzeuge importiert und veröffentlicht wurden. Stellen Sie außerdem sicher, dass die Attributwerte des Shortcodes gültig sind – beispielsweise muss per_page eine positive Ganzzahl sein. Siehe Shortcode-Probleme.
E-Mail und Leads
Es kommt keine E-Mail an, wenn ein Besucher ein Anfrageformular absendet.
Das Plugin versendet Benachrichtigungs-E-Mails über wp_mail(). Wenn keine E-Mail ankommt, prüfen Sie, ob Ihre WordPress-Website korrekt für den E-Mail-Versand konfiguriert ist. Viele Hosting-Umgebungen erfordern ein SMTP-Plugin, um E-Mails zuverlässig zu versenden. Überprüfen Sie auch, ob die in den Plugin-Einstellungen konfigurierte Empfängeradresse korrekt ist und nicht durch einen Spam-Ordner gefiltert wird. Siehe E-Mail- und Lead-Fehler.
Der Lead wird im Leads-Admin-Bereich gespeichert, aber es wird keine E-Mail-Benachrichtigung gesendet.
Lead-Daten werden unabhängig vom E-Mail-Versand im Custom Post Type as24ci_lead gespeichert. Der E-Mail-Versand ist ein separater Prozess. Überprüfen Sie die Konfiguration der Empfängeradresse (globale Überschreibungseinstellung → Verkäuferprofil-E-Mail → E-Mail des Beitragsautors → WordPress-Admin-E-Mail-Fallback) und testen Sie den Versand mit einem einfachen SMTP-Plugin. Siehe E-Mail- und Lead-Fehler.
Das Kontaktformular gibt einen Validierungsfehler zurück, obwohl alle Felder ausgefüllt zu sein scheinen.
Das Formular validiert Name, E-Mail-Adresse, Nachricht und die Checkbox zur Einwilligung serverseitig. Ein Honeypot-Spamschutz-Feld muss ebenfalls leer sein. Wenn der Fehler weiterhin besteht, hat möglicherweise eine automatische Ausfüllfunktion des Browsers das Honeypot-Feld ausgefüllt, oder ein JavaScript-Konflikt stört das Formular. Versuchen Sie, das Formular in einem privaten Browserfenster ohne aktive Erweiterungen abzusenden. Siehe E-Mail- und Lead-Fehler.
Market Insights
Alle Fahrzeuge zeigen no_data in der Spalte Market Score.
Der Status no_data wird zurückgegeben, wenn für ein Fahrzeug kein Preis hinterlegt ist (_as24ci_price ist leer oder Null). Überprüfen Sie, ob die Fahrzeuge mit einem Preis importiert wurden. Wenn dies der Fall war, führen Sie den Import erneut aus oder stoßen Sie die Preisanalyse manuell an, indem Sie das Plugin deaktivieren und wieder aktivieren. Siehe Probleme mit Market Insights.
Die Standzeit (Days on Lot) zeigt 0 oder eine unerwartet hohe Zahl.
Ein Wert von 0 kann bedeuten, dass das Fahrzeug heute veröffentlicht wurde oder eine geplante Veröffentlichung in der Zukunft hat. Sehr große Werte weisen auf ein fehlerhaftes Veröffentlichungsdatum hin (zum Beispiel aus einem Datensatz mit Null-Datum importiert). Überprüfen Sie das Veröffentlichungsdatum des Fahrzeugs in der Beitragsliste. Siehe Probleme mit Market Insights.
PDF-Datenblatt
Die Datenblatt-URL (?as24ci_pdf=123) gibt einen 404-Fehler zurück.
Entweder ist die PDF-Datenblatt-Funktion nicht aktiviert, die Beitrags-ID ist falsch oder das Fahrzeug befindet sich nicht im Status publish. Aktivieren Sie die Funktion in den Plugin-Einstellungen, setzen Sie die Permalinks zurück und bestätigen Sie, dass das Fahrzeug veröffentlicht ist. Siehe Probleme mit dem PDF-Datenblatt.
Das Datenblatt zeigt keine Bilder.
Bestätigen Sie, dass Bilder für das Fahrzeug importiert wurden und dass die Option Galerie anzeigen in den Einstellungen des PDF-Managers aktiviert ist. Das Datenblatt zeigt maximal 5 Bilder. Siehe Probleme mit dem PDF-Datenblatt.