AJAX-Aktionen

Dieses Dokument listet die AJAX-Endpunkte auf, die vom ADP Car Market Hub-Plugin über admin-ajax.php registriert werden, einschließlich des erwarteten Nonce, der WordPress-Berechtigung, die den jeweiligen Handler schützt, und einer kurzen Beschreibung der Parameter und Antworten.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie Folgendes tun müssen:

• Verstehen, wie das Frontend ohne vollständiges Neuladen der Seite mit dem Plugin interagiert (Modellliste, Probefahrt-Verfügbarkeit, Suchauftrags-Abonnement).
• Nachverfolgen, welche Admin-Schaltfläche welchen Hintergrundjob auslöst.
• Eine Integration oder Tests für eine bestimmte AJAX-Aktion durchführen.
• Das Sicherheitsmodell (Berechtigung + Nonce) eines Admin-AJAX-Handlers überprüfen.

Für HTTP-REST-Endpunkte siehe REST-API-Endpunkte.

Übersicht

Alle Aktionen werden über die standardmäßigen Hooks wp_ajax_<action> (für angemeldete Benutzer) und, falls zutreffend, wp_ajax_nopriv_<action> (für anonyme Besucher) von WordPress registriert und über wp-admin/admin-ajax.php bereitgestellt.

Das Plugin folgt dem Standardmuster:

1. Auslesen des Query-/POST-Parameters action.
2. Verifizieren des Request-Nonce mit check_ajax_referer( '<action>', 'nonce' ).
3. Verifizieren der Benutzerberechtigung (nur bei Admin-Aktionen).
4. Bereinigen der Eingaben (Sanitisation).
5. Rückgabe von JSON über wp_send_json_success() oder wp_send_json_error().

Die Berechtigung, die für fast alle reinen Admin-Handler verwendet wird, ist manage_as24_imports (die Konstante Plugin::CAP_MANAGE). Siehe Sicherheit und Berechtigungen für die vollständige Berechtigungsübersicht.

Öffentliche (Frontend-) AJAX-Aktionen

Diese Aktionen sind sowohl mit wp_ajax_ als auch mit wp_ajax_nopriv_ registriert, sodass anonyme Besucher sie aufrufen können.

as24ci_get_models

Gibt die Liste der Fahrzeugmodelle für eine bestimmte Marke zurück. Dies wird für die kaskadierenden Marken-/Modell-Dropdowns im Suchfilter verwendet.

• Methode: GET.
• Nonce: as24ci_get_models (Parametername nonce).
• Parameter: make (String).
• Antwort: { "success": true, "data": { "models": [...], "cached": bool } }.
• Caching: Die Ergebnisse werden in Transients, die nach dem normalisierten Markenwert benannt sind, für 10 Minuten zwischengespeichert. Der Cache wird nach Abschluss von Importen automatisch geleert.

as24ci_get_test_drive_slots

Gibt die verfügbaren Zeitfenster für Probefahrten an einem bestimmten Kalenderdatum zurück.

• Methode: GET.
• Nonce: as24ci_test_drive_slots (Parametername nonce).
• Parameter: date im Format Y-m-d.
• Antwort: { "success": true, "data": { "slots": ["09:00", "09:30", ...] } }. Bei ungültigen Daten, blockierten Tagen, falschen Wochentagen oder in der Vergangenheit liegenden Daten wird ein leeres Array zurückgegeben.

as24ci_search_agent_subscribe

Erstellt ein Suchauftrags-Abonnement, damit der Besucher E-Mail-Benachrichtigungen erhält, wenn passende Fahrzeuge importiert werden.

• Methode: POST.
• Nonce: as24ci_search_agent (Parametername nonce).
• Parameter: email plus die gespeicherten Suchfelder criteria.
• Antwort: JSON-Erfolgs-/Fehler-Umschlag (Envelope).

Admin-AJAX-Aktionen

Alle Admin-Aktionen erfordern die Berechtigung manage_as24_imports, sofern nicht anders angegeben. Aufrufe ohne diese Berechtigung geben HTTP 403 mit wp_send_json_error() zurück. Aufrufe ohne gültigen Nonce werden von check_ajax_referer() abgewiesen.

Import- und Warteschlangen-Auslöser

Batch-Import-Assistent

Der Batch-Assistent ermöglicht es Administratoren, eine Reihe von Inserats-IDs in kleinen Schritten zu importieren, um Timeouts zu vermeiden.

Lead-Verwaltung

Analysen

KI-Assistent

Eine separate Non-AJAX-Admin-Aktion (?as24ci_action=manual_ai_generate) stellt einen manuellen Einmal-Generierungs-Workflow bereit, der durch einen beitragsbezogenen Nonce (as24ci_manual_ai_generate_<post_id>) und die Berechtigung edit_post für diesen spezifischen Beitrag geschützt ist.

Support-Tab

Der Admin-Tab Hilfe & Support stellt drei AJAX-Aktionen bereit, die jeweils durch manage_as24_imports und einen dedizierten Nonce geschützt sind:

Mitbewerber-Beobachter (entfernt)

Die Funktion „Mitbewerber-Beobachter“ wurde entfernt. Es gibt keine aktive AJAX-Aktion mehr zum Aktualisieren von Mitbewerberpreisen; der Marktpreisvergleich wird über das Market Hub / Hub-API bereitgestellt.

Aufrufen einer AJAX-Aktion

Es gelten die standardmäßigen WordPress-Konventionen. Vom Frontend aus:

POST /wp-admin/admin-ajax.php
Content-Type: application/x-www-form-urlencoded

action=as24ci_get_models&nonce=<wp_create_nonce('as24ci_get_models')>&make=Audi

Die in die Warteschlange eingereihten Skripte des Plugins erhalten bereits die korrekten Nonces über wp_localize_script() / wp_add_inline_script(). Wenn Sie eine Aktion aus einer benutzerdefinierten Integration heraus aufrufen, generieren Sie den Nonce serverseitig und übergeben Sie ihn an Ihr Skript.

Betriebshinweise

• Alle nicht-öffentlichen Aktionen geben HTTP 403 mit { "success": false, "data": { "message": "Permission denied." } } zurück, wenn die Berechtigungsprüfung fehlschlägt.
• Nonce-Fehler werden von check_ajax_referer() verarbeitet und führen zu einem 403 mit der standardmäßigen WordPress-Nonce-Fehlerantwort.
• Zeitintensive Admin-Handler (Importe, Warteschlangenverarbeitung) sind so konzipiert, dass sie schnell antworten; schwerere Arbeiten laufen über den Scheduler und die Warteschlange. Siehe Cron-Events und Scheduler und Bild-Importer und Warteschlange.
• Der Modelllisten-Cache wird von angemeldeten und anonymen Besuchern gemeinsam genutzt; eine einzige Leerung zum Importzeitpunkt hält die Daten für beide Zielgruppen konsistent.
• Frontend-Aktionen verzichten bewusst auf Benutzerberechtigungen, damit anonyme Besucher den Suchfilter und die Probefahrtbuchung nutzen können. Die Authentifizierung basiert auf dem aktionsspezifischen Nonce.

Fehlerbehebung

• Antwort-Body ist -1 oder 0 – klassische WordPress-AJAX-Fehlermodi. Überprüfen Sie den Netzwerk-Tab des Browsers auf den Antwortcode: -1 bedeutet in der Regel ein ungültiger Nonce, 0 bedeutet in der Regel ein nicht registrierter Aktionsname (Groß-/Kleinschreibung beachten).
• Permission denied. (HTTP 403) – dem aktuellen Benutzer fehlt die erforderliche Berechtigung. Stellen Sie sicher, dass der Benutzer die Berechtigung manage_as24_imports oder eine Rolle besitzt, die diese enthält.
• Leere Modellliste beim Aufruf von as24ci_get_models – entweder wurden keine Modelle für die angegebene Marke importiert oder der Marken-Parameter ist leer / kein bekannter Taxonomie-Begriff.
• No seller IDs configured. aus dem Batch-Assistenten – öffnen Sie den API-Tab und fügen Sie mindestens eine Händler-ID hinzu, bevor Sie den Vorgang erneut ausführen.
• Veraltete Modellliste nach einem Import – rufen Sie Ajax::clear_models_cache() auf (der Importer tut dies bereits bei jedem erfolgreichen Durchlauf); überprüfen Sie den Transient-Speicher, falls Ihr Object-Cache-Plugin Transients überschreibt.

Verwandte Dokumente

• REST-API-Endpunkte
• Sicherheit und Berechtigungen
• Cron-Events und Scheduler
• Bild-Importer und Warteschlange
• Technische Hinweise zum KI-Assistenten
• Lead-Speicherung und -Verarbeitung
• Analyse-Tracking