AJAX-Aktionen

Dieses Dokument listet die AJAX-Endpunkte auf, die vom ADP Car Market Hub-Plugin über admin-ajax.php registriert wurden, einschliesslich des erwarteten Nonce, der WordPress-Berechtigung, die jeden Handler schützt, und einer kurzen Beschreibung der Parameter und der Antwort.

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 einen Test 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 Endpoints.

Übersicht

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

Das Plugin folgt dem Standardmuster:

1. Auslesen des Query-/POST-Parameters action.
2. Überprüfen des Request-Nonce mit check_ajax_referer( '<action>', 'nonce' ).
3. Überprüfen der Benutzerberechtigung (nur bei Admin-Aktionen).
4. Bereinigen der Eingaben.
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 Security And Capabilities für die vollständige Berechtigungszuordnung.

Öffentliche (Frontend-) AJAX-Aktionen

Diese Aktionen sind sowohl mit wp_ajax_ als auch mit wp_ajax_nopriv_ registriert, damit 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 Probefahrt-Zeitfenster für ein bestimmtes 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", ...] } }. Ein leeres Array wird bei ungültigen Daten, blockierten Tagen, falschen Wochentagen oder vergangenen Daten 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-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 Queue-Trigger

Batch-Import-Assistent

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

Lead-Management

Analytics

AI Assistant

Eine separate, Nicht-AJAX-Admin-Aktion (?as24ci_action=manual_ai_generate) stellt einen manuellen Einmal-Generierungs-Workflow bereit, der durch einen beitragsspezifischen 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-Beobachtung (entfernt)

Die Funktion zur Mitbewerber-Beobachtung wurde entfernt. Es gibt keine aktive AJAX-Aktion mehr zur Aktualisierung von Mitbewerberpreisen; der Marktpreisvergleich wird über das Market Hub / die Hub-API bereitgestellt.

Aufrufen einer AJAX-Aktion

Es gelten die standardmässigen 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 der Warteschlange eingereihten Skripte des Plugins erhalten bereits die korrekten Nonces über wp_localize_script() / wp_add_inline_script(). Wenn Sie eine Aktion aus einer eigenen Integration aufrufen, generieren Sie den Nonce serverseitig und übergeben Sie ihn an Ihr Skript.

Betriebliche Hinweise

• 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ässigen WordPress-Nonce-Fehlermeldung.
• Lang laufende Admin-Handler (Importe, Warteschlangenverarbeitung) sind so konzipiert, dass sie schnell antworten; schwerere Arbeiten laufen über den Scheduler und die Warteschlange. Siehe Cron Events And Scheduler und Image Importer And Queue.
• 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 Probefahrt-Buchung nutzen können. Die Authentifizierung basiert auf dem aktionsspezifischen Nonce.

Fehlerbehebung

• Antwort-Body ist -1 oder 0 — klassische WordPress-AJAX-Fehlermodi. Prü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 (Gross-/Kleinschreibung beachten).
• Permission denied. (HTTP 403) — dem aktuellen Benutzer fehlt die erforderliche Berechtigung. Stellen Sie sicher, dass der Benutzer über die Berechtigung manage_as24_imports oder eine Rolle verfügt, 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 Seller-ID hinzu, bevor Sie den Vorgang erneut starten.
• 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 Endpoints
• Security And Capabilities
• Cron Events And Scheduler
• Image Importer And Queue
• AI Assistant Technical Notes
• Lead Storage And Processing
• Analytics Tracking