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 den jeweiligen 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, Suchabo).
• 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 Endpoints.

Übersicht

Alle Aktionen werden über die standardmässigen 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. Ü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 Berechtigungsübersicht.

Ö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, die von den kaskadierenden Marken-/Modell-Dropdowns im Suchfilter verwendet wird.

• Methode: GET.
• Nonce: as24ci_get_models (Parametername nonce).
• Parameter: make (String).
• Antwort: { "success": true, "data": { "models": [...], "cached": bool } }.
• Caching: Die Ergebnisse werden in Transients gespeichert, die mit dem normalisierten Markenwert für 10 Minuten indiziert sind. 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", ...] } }. Für ungültige Daten, blockierte Tage, falsche Wochentage oder in der Vergangenheit liegende Daten wird ein leeres Array zurückgegeben.

as24ci_search_agent_subscribe

Erstellt ein Suchabo, 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.

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:

Content Studio

Registriert durch AS24CI\Content_Studio_Admin_Worker (includes/class-as24ci-content-studio-admin-worker.php). Beide sind nur für angemeldete Benutzer, geschützt durch manage_as24_imports (Plugin::CAP_MANAGE) und einen dedizierten Nonce.

Verbindungsseite

Registriert durch AS24CI\Admin_Tab_Universal_Import (includes/admin/class-as24ci-admin-tab-universal-import.php:30). Nur für angemeldete Benutzer, geschützt durch manage_as24_imports.

Mitbewerber-Beobachter (entfernt)

Die Funktion "Mitbewerber-Beobachter" wurde entfernt. Es gibt keine aktive AJAX-Aktion zum Aktualisieren 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 die Warteschlange eingereihten Skripte des Plugins erhalten die korrekten Nonces bereits über wp_localize_script() / wp_add_inline_script(). Wenn Sie eine Aktion aus einer benutzerdefinierten 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 durch check_ajax_referer() behandelt 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 und Scheduler und Bild-Importer und Warteschlange.
• Der Modelllisten-Cache wird von angemeldeten und anonymen Besuchern gemeinsam genutzt; eine einzige Bereinigung zum Importzeitpunkt hält beide Zielgruppen konsistent.
• Frontend-Aktionen vermeiden bewusst die Verwendung von Benutzerberechtigungen, damit anonyme Besucher den Suchfilter und die Probefahrtbuchung nutzen können. Die Authentifizierung basiert auf dem aktionsspezifischen Nonce.

Fehlerbehebung

• -1 oder 0 Antwort-Body – klassische WordPress AJAX-Fehlermodi. Überprüfen Sie den Netzwerk-Tab des Browsers auf den Antwortcode: -1 bedeutet in der Regel ein ungültiges Nonce, 0 bedeutet in der Regel einen nicht registrierten Aktionsnamen (Gross-/Kleinschreibung beachten).
• Permission denied. (HTTP 403) – dem aktuellen Benutzer fehlt die erforderliche Berechtigung. Überprüfen Sie, ob 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 Parameter für die Marke ist leer / kein bekannter Taxonomie-Begriff.
• No seller IDs configured. vom Batch-Assistenten – öffnen Sie den API-Tab und fügen Sie mindestens eine Seller ID hinzu, bevor Sie den Vorgang erneut ausführen.
• Veraltete Modellliste nach einem Import – rufen Sie Ajax::clear_models_cache() auf (der Importer macht 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 AI Assistant
• Lead-Speicherung und -Verarbeitung
• Analytics-Tracking