Dokumentation · Admin-Referenz
Suchabos-Referenz
Dieses Dokument ist eine Referenz für den Bildschirm Suchabos des ADP Car Market Hub-Plugins (Car Market Hub → Search Alerts). Es erklärt das Modell der Suchprofile, wie die Tabelle funktioniert und wie Sie Abonnements erstellen, bearbeiten, pausieren und löschen.
Wann Sie dieses Dokument verwenden sollten
Verwenden Sie diese Referenz, wenn Sie automatisierte E-Mail-Benachrichtigungen verwalten möchten, die Abonnenten informieren, sobald neue Fahrzeuge ihren gespeicherten Suchkriterien entsprechen, oder wenn Sie eine Liste von Suchabos importieren/exportieren möchten.
Übersicht
Ein Suchabo (auch als Suchprofil bezeichnet) ist eine gespeicherte Kombination aus:
- Einer Empfänger-E-Mail-Adresse.
- Einem Satz von Filterkriterien (Marke, Modell, Karosserieform, Kraftstoffart, Zustand, Farbe, Preisspanne, maximale Kilometerleistung).
- Einer Benachrichtigungshäufigkeit (Sofort, Täglich, Wöchentlich).
- Einem Status (Aktiv, Ausstehende Bestätigung, Pausiert, Abgemeldet).
Wenn neue Fahrzeuge den Kriterien eines aktiven Suchabos entsprechen, sendet das Plugin eine E-Mail an den Abonnenten gemäss der gewählten Häufigkeit. Der Bildschirm listet jedes konfigurierte Suchabo mit Massenaktionen, Such-/Statusfiltern, CSV-Export und einem modalen Erstellungs-/Bearbeitungsformular auf.
Anforderungen oder Voraussetzungen
- Berechtigung zur Verwaltung des Plugins.
- Funktionierender E-Mail-Versand über WordPress. Das Plugin verwendet den Standard-WordPress-E-Mail-Versand; konfigurieren Sie SMTP separat, falls Ihre Website keine E-Mails senden kann.
- Importierte Fahrzeuge, mit denen die Suchabos abgeglichen werden können.
Schritt-für-Schritt-Anleitung
Ein Suchprofil erstellen
- Öffnen Sie Car Market Hub → Search Alerts.
- Klicken Sie im Header auf Create Alert Profile.
- Füllen Sie im Modal Folgendes aus: - Alert Name (optional, wird als benutzerfreundlicher Name in der Tabelle verwendet). - Recipient Email (erforderlich). - Notification Frequency (Sofort / Täglich / Wöchentlich). - Status — Sie können den Status des Suchabos hier direkt festlegen (standardmässig auf Active).
- Fügen Sie beliebige Werte für die Filter Kriterien hinzu. Lassen Sie ein Feld leer, um alle Werte für dieses Kriterium zuzulassen.
- Klicken Sie auf Create Alert Profile. Das neue Suchabo erscheint in der Tabelle mit dem von Ihnen ausgewählten Status (standardmässig Aktiv).
Ein bestehendes Suchabo bearbeiten
- Klicken Sie in der Tabelle auf die Aktion Edit in der entsprechenden Zeile.
- Das Modal öffnet sich vorausgefüllt mit den aktuellen Werten des Suchabos; ändern Sie die gewünschten Einstellungen — einschliesslich des Status — und klicken Sie auf Save Changes.
Pausieren, aktivieren oder löschen
- Um ein einzelnes Suchabo zu pausieren oder wieder zu aktivieren, klicken Sie auf das Symbol Pause / Activate in der Zeile.
- Um ein einzelnes Suchabo zu löschen, klicken Sie auf das Symbol Delete (Papierkorb) und bestätigen Sie den Vorgang.
- Um mehrere Suchabos gleichzeitig zu bearbeiten, markieren Sie die Zeilen, wählen Sie im Dropdown-Menü für Massenaktionen Activate selected, Pause selected oder Delete selected und klicken Sie auf Apply.
Suchen, filtern und exportieren
- Verwenden Sie das Suchfeld, um nach Name des Suchabos, E-Mail-Adresse oder Kriterien zu filtern.
- Verwenden Sie den Statusfilter, um die Ansicht auf Active, Pending Confirmation, Paused oder Unsubscribed einzuschränken.
- Klicken Sie auf Export CSV, um alle Suchabos herunterzuladen, die der aktuellen Suche und dem Filter entsprechen.
- Klicken Sie auf Clear, um die Suche und den Statusfilter zurückzusetzen.
- Verwenden Sie die Anzahl pro Seite, um zu ändern, wie viele Suchabos gleichzeitig angezeigt werden. Der gewählte Wert wird als benutzerspezifische Einstellung gespeichert, sodass er für Ihr Konto bei zukünftigen Besuchen erhalten bleibt.
Zeilen ohne expliziten Alert Name zeigen einen abgeleiteten Namen mit dem Tag auto-generated name an, sodass Sie auf einen Blick sehen, welchen Suchabos nie ein benutzerdefinierter Name zugewiesen wurde. Zeilen ohne Filterkriterien zeigen das Label All vehicles an, was bedeutet, dass das Suchabo auf den gesamten Fahrzeugbestand angewendet wird.
Konfigurationsreferenz
Suchprofil
| Feld | Hinweise |
|---|---|
| Alert Name | Optionaler, benutzerfreundlicher Name. Wird in der Tabelle und in E-Mails angezeigt. Wenn das Feld leer gelassen wird, zeigt die Tabelle einen abgeleiteten Namen mit dem Tag auto-generated name an. |
| Recipient Email | Erforderlich. Wird als E-Mail-Adresse validiert. |
| Notification Frequency | Immediate, Daily oder Weekly. Standardmässig Daily. |
| Status | Active, Pending Confirmation, Paused, Unsubscribed. Direkt im Erstellungs-/Bearbeitungs-Modal editierbar und wird auch durch Aktionen des Abonnenten oder Admins geändert (z. B. Abmeldung, Pausieren). Standardmässig Active für neue Suchabos. |
Filterkriterien-Felder (Modal)
| Feld | Hinweise |
|---|---|
| Make | Freitext (z. B. BMW). Leer = alle Marken zulassen. |
| Model | Freitext (z. B. 3 Series). Leer = alle Modelle zulassen. |
| Body Type | Freitext (z. B. Sedan). Leer = alle Karosserieformen zulassen. |
| Fuel Type | Freitext (z. B. Diesel). Leer = alle Kraftstoffarten zulassen. |
| Condition | Freitext (z. B. used). Leer = alle Zustände zulassen. |
| Color | Freitext (z. B. Black). Leer = alle Farben zulassen. |
| Price From (€) | Optionaler Mindestpreis, in ganzen Einheiten (Schritt 500). |
| Price To (€) | Optionaler Maximalpreis, in ganzen Einheiten (Schritt 500). Leer = kein Maximum. |
| Max Mileage (km) | Optionale maximale Kilometerleistung, in ganzen Einheiten (Schritt 5000). Leer = kein Maximum. |
Statuswerte
| Wert | Bedeutung |
|---|---|
| Active | Das Suchabo ist aktiviert und sendet E-Mails gemäss seiner Häufigkeit. |
| Pending Confirmation | Der Abonnent wurde um Bestätigung gebeten und hat dies noch nicht getan. |
| Paused | Das Suchabo wurde vorübergehend von einem Admin oder vom Abonnenten deaktiviert. |
| Unsubscribed | Der Abonnent hat sich abgemeldet; es werden keine weiteren E-Mails gesendet. |
Tabellen-Toolbar
| Element | Verhalten |
|---|---|
| Search | Durchsucht Name, E-Mail-Adresse und Kriterien. |
| Status filter | Leer = alle Statuswerte. |
| Bulk actions | Activate selected, Pause selected, Delete selected. |
| Per page | Erlaubte Werte: 5, 10, 25, 50, 100. Standardwert ist 25. Wird als benutzerspezifische Einstellung gespeichert. |
| Export CSV | Exportiert Suchabos, die der aktuellen Suche und dem Filter entsprechen. |
Betriebliche Hinweise
- Die Benachrichtigungshäufigkeit beeinflusst nur, wann E-Mails gesendet werden; sie ändert nichts daran, welche Fahrzeuge den Kriterien entsprechen.
- Suchabos im Status Pending Confirmation oder Unsubscribed senden niemals E-Mails, bis sie auf Active gesetzt werden.
- Abonnenten können sich in der Regel über einen Link in der Benachrichtigungs-E-Mail abmelden; dadurch wird das Suchabo in den Status Unsubscribed versetzt. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version, bevor Sie live gehen.
- Die Suchabo-Matching-Engine berücksichtigt nur veröffentlichte Fahrzeuge im Bestand. Ausgeblendete, unveröffentlichte oder gelöschte Fahrzeuge werden nicht als Treffer gewertet.
- Das Löschen ist dauerhaft und kann nicht rückgängig gemacht werden — der Bestätigungsdialog weist explizit darauf hin. Verwenden Sie Pause, wenn Sie ein Suchabo nur vorübergehend aussetzen möchten.
- Alle Admin-Aktionen auf Suchabos werden über das Standard-Logging-System des Plugins protokolliert; Details finden Sie in der Logs-Referenz.
Fehlerbehebung
- Abonnenten erhalten keine E-Mails. Vergewissern Sie sich, dass der Status des Suchabos auf Active steht, dass WordPress E-Mails senden kann und dass die Empfängeradresse korrekt ist. Stellen Sie bei Sofort-Benachrichtigungen zudem sicher, dass kürzlich tatsächlich neue Fahrzeuge importiert wurden.
- Ein Suchabo liefert nie Treffer. Filterkriterien werden mit UND verknüpft. Versuchen Sie, Felder nacheinander zu entfernen, um das Kriterium zu finden, das alle Ergebnisse ausschliesst.
- Ein Abonnent beschwert sich über zu viele E-Mails. Senken Sie die Häufigkeit von Sofort auf Täglich oder Wöchentlich, oder pausieren Sie das Suchabo, bis die Kriterien präzisiert wurden.
- Massenaktion bewirkt nichts. Wählen Sie mindestens eine Zeile aus, bevor Sie auf Apply klicken; andernfalls warnt Sie der Bildschirm.
- Beim CSV-Export fehlen Suchabos. Der Export berücksichtigt die aktuelle Suche und den Statusfilter — setzen Sie diese zurück, um alle Daten zu exportieren.
- Löschbestätigung wird übersprungen oder schlägt stillschweigend fehl. Stellen Sie sicher, dass JavaScript in Ihrem Browser aktiviert ist. Die destruktive Aktion erfordert die Bestätigung des Modals/Dialogs.