From 58f8df4754be918f62d78061fac699adfa8a4c7b Mon Sep 17 00:00:00 2001 From: Michael Date: Mon, 22 Dec 2025 12:01:52 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/README.md b/README.md index 401b95a..f2833d1 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,65 @@ Erst bei Bestehen des Checks wird die Anmeldung an Listmonk weitergegeben, wo an Alle relevanten Einstellungen und Variablen können direkt im Code angepasst werden. Es sind keine externen Dienste oder APIs erforderlich. +## Benutzung + +Im Ordner **`n8n-workflow`** befindet sich der Newsletter-Antispam-Workflow als JSON-Datei zum direkten Import in **n8n**. +Vor oder nach dem Import müssen die **Domain- und URL-Variablen** an die eigene Umgebung angepasst werden. + +Im **Code Node** des Workflows erfolgt ein lokaler Antispam-Check, der jede Anmeldung vor der Weiterleitung an Listmonk prüft. + +### Durchgeführte Prüfungen + +- Herkunft des Requests (Origin / Referer) +- Optionales Shared Secret +- Honeypot-Felder +- Zeit- und Bot-Speed-Check +- User-Agent-Plausibilität +- E-Mail Pflichtfeld & Formatprüfung +- Domain-Blacklist +- Consent- / Checkbox-Pflicht +- Prüfung auf gefüllte Kommentar- / Textfelder +- Name-Spam-Erkennung +- Bad-Word-Blacklist +- Wortlängen- und Zeichen-Plausibilität + +Alle Prüfungen können je nach Bedarf angepasst oder erweitert werden. + +## Formulare & Frontend + +Im Ordner **`codes`** befinden sich: + +- Das Newsletter-Anmeldeformular + (inkl. **Listmonk-Listen-UUID**) +- Die notwendigen **Domain-Variablen** für den n8n-Webhook +- Passendes **JavaScript** und **CSS-Styling**, wie es produktiv auf Donau2Space.de eingesetzt wird + +## Statusseiten (WordPress) + +Für die Rückmeldungen werden in WordPress zwei Seiten angelegt, z. B.: + +- **Newsletter Danke** +- **Newsletter Fehler** + +Diese werden mit folgenden Shortcodes ausgestattet: + +- `[d2s_newsletter_danke]` +- `[d2s_newsletter_error]` + +Weitere Konfiguration ist nicht erforderlich. + +## Ablauf + +1. Nutzer füllt das Newsletter-Anmeldeformular aus +2. Die Checkbox (Datenschutz / Newsletter abonnieren) muss aktiv sein +3. Die Anmeldung wird an den **n8n-Workflow** gesendet +4. Der lokale Antispam-Check prüft die Daten +5. Bei Erfolg: + - Weiterleitung auf die **Newsletter-Danke-Seite** + - Übergabe der Anmeldung an **Listmonk** + - Versand der **Double-Opt-In-E-Mail** +6. Nach Bestätigung ist der Nutzer regulär im Listmonk-Newsletter angemeldet + ## Demo Produktiv im Einsatz auf: