Dokumentation · Frontend-Handbuch

Suchabos im Frontend

Dieses Dokument beschreibt die Suchagent-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 die Abmeldung abläuft.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die Suchabo-Funktion zum ersten Mal einrichten, einem Besucher helfen möchten, seine Abos zu verstehen und zu verwalten, oder wenn Sie Probleme bei der Anmeldung und Benachrichtigung beheben müssen.

Übersicht

Die Suchagent-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 sich jederzeit abmelden, indem sie auf den Abmeldelink klicken, der in jeder Benachrichtigungs-E-Mail enthalten ist. Es ist kein Konto oder Login erforderlich.

Anforderungen oder Voraussetzungen

Die Suchagent-Funktion muss in den Plugin-Einstellungen aktiviert sein (sie ist standardmässig aktiviert, gesteuert durch FEATURE_SEARCH_AGENT).
Die WordPress Website muss in der Lage sein, E-Mails zu versenden. Wenn auf Ihrem Hosting keine Transaktions-E-Mails konfiguriert sind, sollten Sie ein SMTP-Plugin verwenden. 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: Suchabos 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: Abos abbestellen

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

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

Konfigurations-Referenz

Suchagent-Kriterien

Das Anmeldeformular 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 Occasion
`color`	Aussenfarbe
`min_price`	Mindestpreis
`max_price`	Maximalpreis
`mileage_max`	Maximale Kilometerleistung
`status`	Statusfilter (Neu, Occasion oder Alle)

Alle Kriterien verwenden eine UND-Verknüpfung: 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 Status:

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 bei der Anmeldung 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 Fahrzeugtreffer: [Fahrzeugtitel]"
Enthält den Fahrzeugtitel, einen Link zur Fahrzeug-Detailseite, die gespeicherten Kriterien und einen Abmeldelink.

Beide E-Mails werden als Klartext gesendet, wobei die konfigurierte E-Mail-Adresse der Website als Absender verwendet wird. 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	Option-Key	Standard	Beschreibung
Suchagent aktivieren	`as24ci_feature_search_agent`	Ein	Hauptschalter für die Suchabo-Funktion

Betriebliche Hinweise

Das Plugin sendet nur Benachrichtigungen für neu importierte Fahrzeuge. Fahrzeuge, die sich bereits im System befanden, als ein Besucher das Abonnement abschloss, lösen keine Benachrichtigung aus. Fahrzeuge, die aktualisiert (neu importiert) werden, lösen ebenfalls keine Benachrichtigungen aus.
Das Anmeldeformular enthält ein Honeypot-Feld, um Bot-Einsendungen 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.
Das für Bestätigungs- und Abmeldelinks verwendete Token ist eine kryptografisch sichere 64-Zeichen-Hex-Zeichenfolge. Das 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 erfolgreicher Bestätigung wird der Besucher mit ?as24ci_sa_msg=confirmed auf die Startseite weitergeleitet.
Nach der Abmeldung wird der Besucher mit ?as24ci_sa_msg=unsubscribed auf die Startseite weitergeleitet.
Administratoren können Abonnements im Plugin-Admin-Bereich anzeigen, bearbeiten, pausieren und löschen.

Fehlerbehebung

Das Suchformular erscheint nicht auf der Archivseite.

Überprüfen Sie, ob die Suchagent-Funktion in den Plugin-Einstellungen aktiviert ist.
Stellen Sie sicher, dass der Shortcode [as24ci_archive] oder das native CPT-Archiv verwendet wird. Das Suchagent-Formular ist Teil des Archiv-Templates.
Wenn das Formular gerendert wird, aber nicht sichtbar ist, prüfen Sie, ob CSS-Overrides des Themes oder die Konfiguration des Layout Managers 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).

Es werden keine Benachrichtigungs-E-Mails gesendet, wenn Fahrzeuge importiert werden.

Ü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-Verknüpfung, sodass ein Fahrzeug jedem angegebenen Feld entsprechen muss.