Dokumentation · Frontend-Handbuch

Suchaufträge im Frontend

Dieses Dokument behandelt die Suchagenten-Funktion (Smart Stock Alerts) des ADP Car Market Hub WordPress Plugins: wie Besucher Benachrichtigungen abonnieren, wie die Double-Opt-In-Bestätigung funktioniert und wie das Abbestellen abläuft.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die Suchauftragsfunktion zum ersten Mal einrichten, einem Besucher helfen zu verstehen, wie er seine Benachrichtigungen abonniert und verwaltet, oder wenn Sie Probleme mit Abonnements und Benachrichtigungen beheben möchten.

Übersicht

Die Suchagenten-Funktion ermöglicht es Besuchern, eine Reihe von Suchkriterien zu speichern und eine E-Mail-Benachrichtigung zu erhalten, sobald ein neues Fahrzeug, das diesen Kriterien entspricht, in das System importiert wird. Die Funktion nutzt einen DSGVO-konformen Double-Opt-In-Workflow: Der Besucher muss auf einen Bestätigungslink in seiner E-Mail klicken, bevor die Benachrichtigungen aktiviert werden.

Besucher können das Abonnement jederzeit kündigen, indem sie auf den Abmeldelink klicken, der in jeder Benachrichtigungs-E-Mail enthalten ist. Es ist kein Konto oder Login erforderlich.

Voraussetzungen oder Vorbedingungen

Die Suchagenten-Funktion muss in den Plugin-Einstellungen aktiviert sein (sie ist standardmäßig aktiviert, gesteuert durch FEATURE_SEARCH_AGENT).
Die WordPress-Website muss in der Lage sein, E-Mails zu versenden. Wenn auf Ihrem Hosting kein transaktionaler E-Mail-Versand konfiguriert ist, sollten Sie die Verwendung eines SMTP-Plugins in Betracht ziehen. Ohne funktionierenden E-Mail-Versand können keine Bestätigungs- und Benachrichtigungs-E-Mails gesendet werden.
Das Anmeldeformular für den Suchagenten muss auf der Archivseite sichtbar sein. Das Plugin rendert das Formular als Teil des Archiv-Templates, wenn die Funktion aktiviert ist.

Schritt-für-Schritt-Anleitung

Besucher: Suchaufträge abonnieren

Öffnen Sie die Fahrzeug-Archivseite.
Suchen Sie das Suchagent-Formular unter oder neben den Suchfiltern.
Füllen Sie mindestens ein Suchkriterium aus (z. B. Marke, Modell, Preisspanne oder maximale Kilometerleistung).
Geben Sie eine E-Mail-Adresse in das Abonnement-Feld ein.
Senden Sie das Formular ab.
Eine Erfolgsmeldung erscheint: „Fast geschafft! Bitte überprüfen Sie Ihren Posteingang und bestätigen Sie Ihre E-Mail-Adresse.“
Öffnen Sie die Bestätigungs-E-Mail und klicken Sie auf den Bestätigungslink.
Eine Bestätigungsmeldung wird auf der Website angezeigt. Das Abonnement ist nun aktiv.

Ab diesem Zeitpunkt erhält der Besucher eine E-Mail-Benachrichtigung, sobald ein neues Fahrzeug importiert wird, das den gespeicherten Kriterien entspricht.

Besucher: Suchaufträge abbestellen

Öffnen Sie eine beliebige Benachrichtigungs-E-Mail, die Sie vom Suchauftrags-System erhalten haben.
Klicken Sie auf den Link Abbestellen (unsubscribe) am Ende der E-Mail.
Eine Bestätigungsseite wird angezeigt. Das Abonnement wird sofort deaktiviert.

Die Abmeldung ist vonseiten des Besuchers unumkehrbar; der Besucher müsste sich erneut anmelden, um zukünftige Benachrichtigungen zu erhalten.

Konfigurationsreferenz

Suchagenten-Kriterien

Das Abonnement-Formular erfasst die folgenden Kriterien. Der Besucher muss mindestens eines angeben, damit das Abonnement akzeptiert wird:

Kriterium	Beschreibung
`make`	Fahrzeugmarke
`model`	Fahrzeugmodell
`body_type`	Karosserieform
`drive_type`	Antriebsart
`condition`	Zustand: Neu oder Gebraucht
`color`	Außenfarbe
`min_price`	Mindestpreis
`max_price`	Maximalpreis
`mileage_max`	Maximale Kilometerleistung
`status`	Statusfilter (Neu, Gebraucht oder Alle)

Alle Kriterien verwenden eine UND-Logik: Ein Fahrzeug muss jedem angegebenen Kriterium entsprechen, um eine Benachrichtigung auszulösen. Ein leeres Kriterium wird ignoriert.

Abonnement-Status

Jedes Abonnement wird in der benutzerdefinierten Tabelle {prefix}as24ci_search_agents des Plugins gespeichert und hat einen der folgenden Statuswerte:

Status	Bedeutung
`pending`	Double-Opt-In-E-Mail gesendet; Besucher hat noch nicht bestätigt
`active`	Bestätigt; Benachrichtigungen werden für passende Fahrzeuge gesendet
`inactive`	Vom Besucher abbestellt
`paused`	Von einem Administrator im Plugin-Admin manuell pausiert

E-Mail-Templates

Das Plugin versendet automatisch zwei Arten von E-Mails:

Bestätigungs-E-Mail (wird beim Abonnieren gesendet):

Betreff: „Bitte bestätigen Sie Ihren Suchagenten“
Enthält die gespeicherten Kriterien des Besuchers und den Bestätigungslink.

Treffer-Benachrichtigungs-E-Mail (wird gesendet, wenn ein neues passendes Fahrzeug importiert wird):

Betreff: „Neuer Treffer für Ihre Suche: [Fahrzeugtitel]“
Enthält den Fahrzeugtitel, einen Link zur Fahrzeug-Detailseite, die gespeicherten Kriterien und einen Abmeldelink.

Beide E-Mails werden als Klartext unter Verwendung der konfigurierten E-Mail-Adresse der Website als Absender gesendet. Der E-Mail-Inhalt ist derzeit nicht über die Admin-Oberfläche konfigurierbar; Anpassungen erfordern Eingriffe auf Code-Ebene über WordPress-Filter.

Funktions-Schalter

Einstellung	Optionsschlüssel	Standard	Beschreibung
Suchagent aktivieren	`as24ci_feature_search_agent`	Ein	Hauptschalter für die Suchauftragsfunktion

Betriebliche Hinweise

Das Plugin sendet nur Benachrichtigungen für neu importierte Fahrzeuge. Fahrzeuge, die sich bereits im System befanden, als ein Besucher das Abonnement abgeschlossen hat, lösen keine Benachrichtigung aus. Fahrzeuge, die aktualisiert (erneut importiert) werden, lösen ebenfalls keine Benachrichtigungen aus.
Das Abonnement-Formular enthält ein Honeypot-Feld, um Spam-Einsendungen durch Bots zu reduzieren. Wenn das versteckte Feld ausgefüllt ist, wird die Einsendung stillschweigend akzeptiert, aber es wird kein Abonnement erstellt.
Abonnements werden in einer dedizierten benutzerdefinierten Datenbanktabelle gespeichert. Die Tabelle wird automatisch bei der Plugin-Aktivierung erstellt und bei Bedarf beim Laden des Plugins aktualisiert.
Der für Bestätigungs- und Abmeldelinks verwendete Token ist eine kryptografisch sichere 64-Zeichen-Hex-Zeichenfolge. Der Token ist in den Bestätigungs- und Abmelde-URLs als GET-Parameter eingebettet.
Bestätigungslinks haben das Format: /?as24ci_sa_action=confirm&token=[token]
Abmeldelinks haben das Format: /?as24ci_sa_action=unsubscribe&token=[token]
Nach einer erfolgreichen Bestätigung wird der Besucher mit ?as24ci_sa_msg=confirmed auf die Startseite weitergeleitet.
Nach dem Abbestellen wird der Besucher mit ?as24ci_sa_msg=unsubscribed auf die Startseite weitergeleitet.
Administratoren können Abonnements im Plugin-Admin-Bereich einsehen, bearbeiten, pausieren und löschen.

Fehlerbehebung

Das Suchagenten-Formular erscheint nicht auf der Archivseite.

Überprüfen Sie, ob die Suchagenten-Funktion in den Plugin-Einstellungen aktiviert ist.
Stellen Sie sicher, dass der Shortcode [as24ci_archive] oder das native CPT-Archiv verwendet wird. Das Suchagenten-Formular ist Teil des Archiv-Templates.
Wenn das Formular gerendert wird, aber nicht sichtbar ist, prüfen Sie, ob CSS-Overrides des Themes oder Layout-Manager-Konfigurationen das Widget ausblenden.

Der Besucher hat keine Bestätigungs-E-Mail erhalten.

Überprüfen Sie, ob WordPress E-Mails senden kann. Verwenden Sie ein Plugin wie WP Mail SMTP, um den E-Mail-Versand zu testen.
Überprüfen Sie den Spam-Ordner; Bestätigungs-E-Mails von WordPress können manchmal als Spam eingestuft werden.
Bestätigen Sie, dass die E-Mail-Adresse des Besuchers gültig ist und korrekt eingegeben wurde.

Der Bestätigungslink funktioniert nicht.

Stellen Sie sicher, dass der Link in einem Browser geöffnet und nicht von einem E-Mail-Client abgeschnitten wird.
Überprüfen Sie, ob die Permalink-Einstellungen der Website die Verarbeitung von Query-Parametern zulassen.
Wenn der Link mehr als einmal angeklickt wurde, aktualisiert der zweite Klick den Status nicht (die Zeile wird nur einmal von pending auf active aktualisiert).

Benachrichtigungs-E-Mails werden beim Importieren von Fahrzeugen nicht versendet.

Überprüfen Sie, ob mindestens ein Abonnement den Status active hat.
Bestätigen Sie, dass die importierten Fahrzeuge neu waren (keine Aktualisierungen bestehender Fahrzeuge). Das Plugin sendet keine Benachrichtigungen für neu importierte oder aktualisierte Fahrzeuge.
Überprüfen Sie, ob das Fahrzeug den Kriterien des Abonnenten entspricht: Alle Kriterien verwenden eine UND-Logik, sodass ein Fahrzeug mit jedem angegebenen Feld übereinstimmen muss.