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 den Links zu den entsprechenden Dokumenten zur Fehlerbehebung.
Allgemein
Das Plugin-Menü fehlt nach der Aktivierung im WordPress-Admin.
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 WordPress-Administrator an. Wenn das Menü immer noch 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 erteilt wurde, wurde die Berechtigung möglicherweise nicht zugewiesen. 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 Logs im Plugin-Adminbereich. Das Log protokolliert alle Importläufe, Fehler, Bilddownloads und Systemereignisse. 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 AI Assistant 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 gesperrte Lizenz wiederherzustellen. Siehe Probleme mit Market Insights.
Importe wurden gestoppt und das Log erwähnt die Lizenz.
Wenn die Lizenz abgelaufen oder gesperrt ist oder nicht innerhalb der Kulanzfrist verifiziert werden kann, werden betriebliche Aktionen wie Importe und die tägliche Preisanalyse pausiert (sie schliessen im Fehlerfall sicher ab: "fail closed"). Es werden dadurch keine Beiträge, Metadaten oder Medien gelöscht. Reaktivieren oder erneuern Sie die Lizenz, 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 erfasst wurde, der Assistent noch nicht abgeschlossen oder übersprungen wurde und der aktuelle Benutzer über die Verwaltungsberechtigung des Plugins verfügt. Plugin-Upgrades, die keine neue 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 zum 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 bestehende Seite mit demselben Titel wurde wiederverwendet (der Assistent bereinigt Duplikate anhand des Titels, um doppelte Erstellungen zu vermeiden) 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 so gewollt. Das gespeicherte Client Secret wird im Admin-HTML, weder im Assistenten noch im Settings-Tab, jemals wieder im Klartext ausgegeben. Wenn Sie das Formular absenden und das Feld leer lassen, bleibt das bestehende gespeicherte Secret erhalten. Das Absenden eines nicht leeren Werts ersetzt es.
Analytics ist nach einer Live-Einrichtung nicht aktiviert.
Im Live-Modus ist der Analytics-Schalter standardmässig deaktiviert und muss explizit aktiviert werden. Öffnen Sie den Assistenten erneut und aktivieren Sie den Analytics-Schalter in Schritt 5, oder aktivieren Sie Analytics im Tab Analytics. Überprüfen Sie vorher die Cookie-Einwilligung und die Datenschutzanforderungen. Siehe Analytics-Aufbewahrung.
Demodaten wurden nicht installiert.
Demodaten werden nur installiert, wenn in Schritt 1 Demo-Einrichtung ausgewählt ist und der Assistent in Schritt 6 mit Demodaten installieren und fertigstellen abgeschlossen wird. Die Live-Einrichtung installiert keine Demodaten. Demodaten können auch jederzeit über die Karte Demodaten auf Car Market Hub → Tools installiert werden.
Die Seiten "Vergleichen" oder "Favoriten" sind nach einer Demo-Installation leer.
Vergleichen und Favoriten sind clientseitige Funktionen, die aus dem localStorage des Browsers des Besuchers lesen. Der Demo-Installer stellt ein Fallback bereit, das den localStorage beim ersten Laden der Seite befüllt. Öffnen Sie die Seiten "Fahrzeuge", "Vergleichen" oder "Favoriten" einmal in derselben Browsersitzung, um das Befüllen auszulösen.
Überschreibt der Assistent meine bestehenden Einstellungen, wenn ich ihn erneut ausführe?
Nein. Der Assistent schreibt nur Optionen, deren Formularfelder der Admin tatsächlich absendet. Das erneute Ausführen bis zu einem bestimmten Punkt löscht niemals eine Einstellung, die nicht auf dem 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 ungültig. Öffnen Sie den Tab Einstellungen des Plugins, überprüfen Sie, ob 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 speichert 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 via 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 überprüfen. Siehe API-Verbindungsfehler.
Der Import gibt null Fahrzeuge zurück, obwohl mein AutoScout24-Konto Inserate enthält.
Die häufigsten Ursachen sind: Die Seller ID ist falsch, die Inserate 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 suchen Sie im Plugin-Log nach spezifischen 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 bei Neuinstallationen die konservative Standardeinstellung 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 den WordPress-Post-Metadaten zu. Wenn ein Feld leer ist, enthält entweder das AutoScout24-Inserat 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 Auto-Import aktiviert ist und WP-Cron funktioniert. Öffnen Sie den Tab Import & Limits → Automatisierung, um zu bestätigen, dass der Auto-Import aktiviert und ein Zeitplan konfiguriert ist. Überprüfen Sie anschliessend den Tab System & Hilfe, um sicherzustellen, dass das Ereignis 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 den Schalter Bilder importieren in den Importer-Einstellungen gesteuert. Stellen Sie sicher, dass dieser aktiviert ist. Wenn er aktiviert ist, aber immer noch Bilder fehlen, öffnen Sie das Plugin-Log 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össe der Bild-Warteschlange und die letzte Ausführungszeit. Sie können die Warteschlange auch manuell über die Schaltfläche Bild-Warteschlange 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ässig 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 die Fahrzeuge im Entwurfsstatus befinden, und veröffentlichen Sie sie. Stellen Sie ausserdem 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 ungestylt 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 ausgibt, 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 normaler 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ässigen WordPress-Inhalt-Feld einer Seite oder eines Beitrags platziert ist und nicht in einem Widget, einem benutzerdefinierten Feld oder einem 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 ausserdem 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 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 → E-Mail des Verkäuferprofils → 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 aus, obwohl alle Felder ausgefüllt zu sein scheinen.
Das Formular validiert Name, E-Mail-Adresse, Nachricht und die Checkbox für die Einwilligung serverseitig. Ein Honeypot-Spamschutzfeld muss zudem 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 lösen Sie die Preisanalyse manuell aus, 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 grosse 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 Datasheet
Die Datenblatt-URL (?as24ci_pdf=123) gibt einen 404-Fehler zurück.
Entweder ist die Funktion PDF Datasheet 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 (Flush Permalinks) 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.