Einstieg
Kunde öffnet die Widerrufsseite über Shortcode, Button, Block, Widget, Elementor oder Mein-Konto.
WooCommerce Plugin · Funktionsreferenz
Diese Dokumentation beschreibt fachlich und technisch, was das Plugin für Shopbetreiber und Kunden leisten kann. Sie ist bewusst wie eine API-/Code-Dokumentation aufgebaut: Module, Zweck, Verhalten, Eingaben, Ausgaben, typische Einsätze und Abgrenzungen.
Stand geprüft: Abgeglichen mit der Lite-Version 1.0.13 und der Pro-Version 1.0.3. Technisch registrierte Shortcodes: [wmwiderrufsmanager_formular] und [wmwiderrufsmanager_button]. Technisch registrierte Gutenberg-Blöcke: widerrufsmanager/revocation-form und widerrufsmanager/revocation-button.
Kunde öffnet die Widerrufsseite über Shortcode, Button, Block, Widget, Elementor oder Mein-Konto.
In Lite werden Bestellnummer und Rechnungs-E-Mail geprüft. In PRO kann die Verifizierung optional um Bestelldatum, Nachname/Firma oder PLZ erweitert werden.
Widerrufbare Positionen werden angezeigt. Teilmengen und Teilwiderrufe sind möglich. In Pro können optional Widerrufsgründe je Position ergänzt werden.
Der Widerruf wird gespeichert, historisiert und per E-Mail bestätigt.
Admin entscheidet im Backend je Position oder gesamt.
Status, Historie, E-Mails, optional PDF, Export, Datenschutz und Erstattungshilfe bilden die Nachvollziehbarkeit.
revocation_request
Ein Widerrufsfall. Enthält Bestellbezug, Kundendaten, Status, Widerrufsart, Nachricht, Adminnotiz, Zeitpunkte, Anonymisierungsstatus, optionale abweichende Benachrichtigungs-E-Mail und die Positionen als strukturierte Daten.
order
WooCommerce-Bestellung. Dient als Quelle für Bestellnummer, Rechnungs-E-Mail, Status, Bestelldatum, Artikel, Mengen, Rechnungsname/Firma, PLZ und Kundendaten.
item
Einzelne Bestellposition mit Produktname, SKU, Produkt-ID, Varianten-ID, Bestellpositions-ID, Kaufmenge, beantragter Menge, optionaler Widerrufsgrund-Gruppe, optionalem Widerrufsgrund/Notiz und späterer Entscheidung.
history_event
Interner Nachweis für Vorgänge wie Einreichung, Statuswechsel, Entscheidungen, E-Mail-Versand, Anonymisierung oder Löschung.
WMWRM_Admin::render_dashboard_page()admin.php?page=wmwrm-dashboardDas Dashboard ist die kompakte Startseite des Plugins. Es bündelt Einrichtung, Status, Shortcodes, Support-Hinweise und den schnellen Einstieg in die wichtigsten Arbeitsbereiche. Seit Lite 1.0.13 wurde der Bereich optisch modernisiert und um einen Tutorial-Einstieg ergänzt.
Die Startseite ist vor allem für Einrichtung, Support und tägliche Orientierung gedacht. Shopbetreiber sehen schnell, ob der Pflichtprozess eingerichtet ist, wo Shortcodes kopiert werden können, ob offene Widerrufe vorliegen und wo passende Video-Tutorials verfügbar sind.
| Einrichtung | Führt zu Einstellungen, Pflicht-Check und Einbindung von Formular oder Button. |
|---|---|
| Tutorials | Verlinkt auf die offizielle YouTube-Playlist mit Hilfen zur Einrichtung und Nutzung des Widerrufsmanagers. |
| Alltag | Verlinkt auf offene Widerrufe, Widerrufsübersicht und Erweiterungsseite. |
| Support | Bietet FAQ- und Support-Einstiege, ohne die eigentliche Prozessdokumentation mit Lizenz- oder Kaufdetails zu vermischen. |
Zusätzlich zur Plugin-Startseite registriert Lite 1.0.13 ein kompaktes WordPress-Dashboard-Widget mit dem Titel „WM Widerrufsmanager“. Es zeigt die wichtigsten Widerrufs-KPIs direkt auf der WordPress-Startseite.
| KPI-Karten | Gesamt, Offen, Genehmigt und Abgelehnt. Die komplette jeweilige Karte ist klickbar und führt direkt zur gefilterten Widerrufsübersicht. |
|---|---|
| Lite-Anzeige | Wenn PRO nicht aktiv ist, erscheint ein dezenter Hinweis auf Statistiken und Exporte in WM Widerrufsmanager PRO. |
| PRO aktiv | Wenn PRO 1.0.3 aktiv ist, wird der Teaser durch eine echte PRO-Statistik-Zusammenfassung mit Monatswert, Top-Produkt, Top-Grund sowie Aktionen zu Statistik und Export ersetzt. |
Der Admin-Footer wurde in Lite 1.0.13 ebenfalls angepasst: Der Bewertungshinweis ist dezenter kursiv gesetzt und hebt „WM Widerrufsmanager“ typografisch hervor.
[wmwiderrufsmanager_formular]widerrufsmanager/revocation-formWMWRM_Shortcode::render()Das Formular ist der zentrale Eingangskanal für Widerrufe. Es ersetzt unstrukturierte E-Mail-Anfragen durch einen kontrollierten Ablauf mit Bestellprüfung, Positionsauswahl und sauber gespeicherten Daten.
| Eingaben | Bestellnummer, Rechnungs-E-Mail, ausgewählte Artikelmengen, optionale Nachricht/Widerrufsangabe, Bestätigung des Vorgangs. In PRO können Bestelldatum, Rechnungsnachname/Firma, Rechnungs-PLZ und eine abweichende Benachrichtigungs-E-Mail ergänzt werden. Die eingegebene Bestellnummer kann je nach Mapping-Quelle als WooCommerce-Bestell-ID, automatisch erkannte Bestellnummer oder Custom-Bestellnummer aus Meta-Keys interpretiert werden. |
|---|---|
| Prüfungen | Bestellung vorhanden, Bestellnummer korrekt zugeordnet, Verifizierungsdaten passen zur Bestellung, Bestellstatus erlaubt, Frist ist gültig, widerrufbare Restmengen vorhanden, kein blockierender offener oder bereits genehmigter Widerruf. PRO kann zusätzlich einen signierten Verifizierungstoken zwischen Lookup und finalem Absenden verwenden. |
| Ausgabe | Neuer Widerrufsdatensatz im Status pending, Historieneintrag, optionale Kunden- und Admin-E-Mail. |
| Einsatz | Eigene Widerrufsseite, Footer-Link, Hilfe-/Servicebereich, rechtlich relevante Self-Service-Seite. |
[wmwiderrufsmanager_button]widerrufsmanager/revocation-buttonWMWRM_Button_WidgetDer Widerrufsbutton ist ein flexibler Einstieg zur konfigurierten Widerrufsseite. Er kann dort platziert werden, wo Kunden später den Widerruf starten sollen.
Für klassische Seiten, Theme Templates, Builder-Inhalte oder manuelle Einbindung.
Für die native WordPress-Blockbearbeitung. Reduziert Fehler bei der Shortcode-Eingabe.
Für Sidebar, Footer oder andere Widget-Bereiche, sofern das Theme sie anbietet.
| Zweck | Schneller, einheitlicher Einstieg zum Widerrufsformular. |
|---|---|
| Konfiguration | Button-Text, Zielseite und Designwerte werden aus den Plugin-Einstellungen übernommen. |
| Nutzen | Der Shopbetreiber muss nicht an jeder Stelle manuell die korrekte URL pflegen. |
| Attribut | Zweck |
|---|---|
text | Überschreibt den Buttontext für diese konkrete Einbindung. |
class | Ergänzt eine eigene CSS-Klasse für Theme- oder Builder-Anpassungen. |
background | Setzt optional eine individuelle Hintergrundfarbe für den Button. |
text_color | Setzt optional eine individuelle Textfarbe für den Button. |
WMWRM_Order_Validator::validate_lookup()WMWRM_Order_Validator::is_revocation_allowed()WMWRM_Order_Validator::get_revocable_items()Die Bestellprüfung ist der fachliche Gatekeeper des Plugins. Sie entscheidet, ob eine Bestellung für einen Widerruf geöffnet werden darf und welche Positionen auswählbar sind.
Dadurch werden falsche Anfragen, abgelaufene Bestellungen, nicht passende Verifizierungsdaten und doppelte Widerrufe früh abgefangen. Admins müssen weniger manuell nacharbeiten. Die PRO-Verifizierung ist besonders hilfreich für Shops mit lokalen, manuellen oder offline erfassten Bestellungen.
WMWRM_AdminWMWRM_Database::update_decision()WMWRM_Database::append_history()Der Adminbereich ist die Arbeitsoberfläche für eingegangene Widerrufe. Dort werden Anfragen gefiltert, geöffnet, geprüft, entschieden und dokumentiert.
Liste der Widerrufe mit Status, Bestellnummer, Kundendaten, Eingangsdatum und Aktionen.
Zeigt Bestellung, Kundendaten, Nachricht, Positionen, Mengen, Historie und Entscheidungsmöglichkeiten.
Admin kann Positionen vollständig genehmigen, ablehnen oder teilweise genehmigen, je nachdem welche Mengen akzeptiert werden.
Interner oder kundenseitiger Entscheidungstext, der für Nachweis und E-Mail-Kommunikation genutzt werden kann.
Nach finaler Entscheidung wird der Widerruf auf bestätigt, teilweise bestätigt oder abgelehnt gesetzt.
Relevante Aktionen werden nachvollziehbar gespeichert.
Einreichung und spätere Entscheidung können zusätzlich als Bestellnotiz an der WooCommerce-Bestellung dokumentiert werden.
WMWRM_Email::send_customer_received()WMWRM_Email::send_admin_received()WMWRM_Email::send_customer_decision()Die Basis-E-Mails informieren Kunden und Admins über Eingang und Entscheidung eines Widerrufs. Sie enthalten Bestellbezug, Kundendaten, Status und Positionsinformationen.
| Auslöser | Zweck | |
|---|---|---|
| Kunden-Eingangsbestätigung | Nach Absenden des Formulars | Bestätigt dem Kunden, dass der Widerruf eingegangen ist. |
| Admin-Benachrichtigung | Nach Absenden des Formulars | Informiert den Shopbetreiber über eine neue Anfrage. |
| Kunden-Entscheidungsmail | Nach Admin-Entscheidung | Teilt dem Kunden Genehmigung, Teilgenehmigung oder Ablehnung mit. |
Pro erweitert diesen Bereich um visuelle Templates, Logo, Farben, eigene HTML-Inhalte, Testmails, CC/BCC und Reply-To.
WMWRM_Settingswmwrm_settingsDie Einstellungen steuern den gesamten Basisprozess: Formular, Zielseite, Button, Widerrufsfrist, E-Mail-Verhalten, Texte und Datenschutz. Sie sind damit die zentrale Konfigurationsseite der Lite-Version.
| Option-Key | wmwrm_settings |
|---|---|
| Fristbasis | completed_paid_created, created, paid oder completed. |
| Aufbewahrungsaktion | none, anonymize oder delete. |
| Abgrenzung zu Pro | Lite enthält die Basissteuerung. Pro ergänzt optionale Widerrufsgründe, erweiterte E-Mail-Templates, PDF-Nachweise, Datenschutz-Automatisierung und weitere Module. |
WMWRM_Pro::render_extensions_page()admin.php?page=wmwrm-extensionsDie Erweiterungsseite ist die zentrale Übersicht für Kernfunktionen und optionale Pro-Module. Sie zeigt, welche Funktionen dauerhaft zum Lite-Kern gehören und welche Pro-Funktionen bei aktiver Lizenz gezielt genutzt werden können.
| Statusanzeige | Aktive Pro-Module werden visuell hervorgehoben. Deaktivierte Module bleiben erkennbar, laufen aber nicht als aktive Zusatzfunktion mit. |
|---|---|
| Bulk-Aktionen | Pro-Module können gesammelt aktiviert oder deaktiviert werden, sofern die Pro-Version verfügbar ist. |
| Interner Nutzen | Die Seite dient als Modul-Landkarte für Admins und Support: Man sieht schnell, welche Funktionen vorhanden, aktiv und konfigurierbar sind. |
WMWRM_Check::get_results()Der Pflicht-Check prüft, ob das Plugin grundsätzlich korrekt eingerichtet ist. Er ist eine interne Setup-Hilfe für Shopbetreiber und Support und eignet sich besonders vor dem Go-Live oder nach Änderungen an Seiten, Shortcodes, Blöcken und E-Mail-Einstellungen.
| Check starten | Führt die technische Prüfung erneut aus und aktualisiert die Status der einzelnen Prüfpunkte. |
|---|---|
| Einbindung konfigurieren | Führt Admins zur relevanten Konfiguration, wenn Formularseite, Button oder Pflichtangaben fehlen. |
| Support-Nutzen | Der Pflicht-Check hilft, typische Einrichtungsfehler sichtbar zu machen, bevor Kunden den Widerrufsprozess nutzen. |
WMWRM_PrivacyWMWRM_Database::anonymize_request()WMWRM_Database::delete_request()Die Basis-Datenschutzfunktionen integrieren Widerrufsdatensätze in WordPress-Datenschutzwerkzeuge und ermöglichen Anonymisierung, Löschung und Export personenbezogener Daten.
| Export | Widerrufsdaten können bei Datenschutzanfragen über den WordPress-Exporter berücksichtigt werden. |
|---|---|
| Löschung/Anonymisierung | Personenbezogene Felder wie Name und E-Mail können anonymisiert oder Datensätze gelöscht werden. |
| Historie | Datenschutzaktionen können im Widerrufsverlauf nachvollziehbar werden. |
| Automatik | Lite enthält Basis-Cleanup. Pro ergänzt statusabhängige Regeln, Simulation und Audit-Log. |
WMWRM_Order_ColumnDie zusätzliche Spalte in der WooCommerce-Bestellübersicht zeigt, ob zu einer Bestellung ein Widerruf existiert und in welchem Status er sich befindet. Sie unterstützt klassische Bestelllisten und HPOS-Ansichten.
WMWRM_Pro::available_modules() / product_ruleswmwrm_is_product_revocablewmwrm_revocation_form_itemsDieses Modul legt fest, welche Produkte nicht widerrufbar sind. Regeln können direkt am Produkt, an Produktkategorien oder an Produktschlagwörtern gepflegt werden.
Nützlich bei Produkten, die aus fachlichen oder rechtlichen Gründen nicht normal widerrufbar sein sollen, z. B. individuelle Anfertigungen, versiegelte Ware, digitale Inhalte oder bestimmte Warengruppen. Die konkrete rechtliche Bewertung bleibt Aufgabe des Shopbetreibers bzw. der Rechtsberatung.
| Produktregel | Direkt im WooCommerce-Produktdatenbereich „Widerruf“. |
|---|---|
| Kategorieregel | In Produktkategorien. Gilt für Produkte dieser Kategorie. |
| Tag-Regel | In Produktschlagwörtern. Gilt für Produkte mit diesem Schlagwort. |
| Frontend-Auswirkung | Betroffene Positionen können mit Hinweis/Ausschlussgrund angezeigt, aber nicht auswählbar gemacht werden. |
| Priorität | Direkte Produktregel ist die spezifischste Regel; Kategorie-/Tag-Regeln dienen als geerbte Regeln. |
WWR_Pro_Withdrawal_Reasons::MODULE_KEY / withdrawal_reasonsadmin.php?page=wmwrm-withdrawal-reasonswwr_pro_withdrawal_reason_groupsDieses Modul ergänzt das Widerrufsformular um freiwillige Widerrufsgründe je Position. Gründe werden in Grundgruppen organisiert und können global oder gezielt für Produkte, Produktkategorien und Produktschlagwörter zugewiesen werden. Zusätzlich enthält der Bereich einen eigenen Statistik-Tab für Top-Produkte, Top-Gründe, Grundgruppen, Trends und gezielte CSV-Exporte.
Die Gründe helfen, Widerrufe fachlich besser einzuordnen: Support, Qualitätssicherung, Produktanalyse und interne Entscheidungen erhalten strukturierte Zusatzinformationen. Die Angabe bleibt freiwillig und darf den eigentlichen Widerrufsprozess nicht blockieren.
| Frontend | Je widerrufbarer Position kann ein optionales Auswahlfeld mit Grundgruppe, Gründen und optionaler Freitextnotiz angezeigt werden. |
|---|---|
| Vererbung | Direkte Produktzuweisung ist am spezifischsten. Danach folgen Kategorie-/Tag-Zuweisungen und anschließend die globale Standard-Gruppe. |
| Speicherung | Gespeichert werden Grundgruppen-ID/-Name, Grund-ID/-Label sowie eine optionale Notiz je Widerrufsposition. |
| Ausgaben | Die Informationen können in Admin-Ansicht, E-Mail-Templates, PDF-Nachweisen, CSV-Export, Grundauswertung und Widerrufsgründe-Statistik genutzt werden. |
| Produktspezifisch nicht anzeigen | Ist für ein Produkt „Für dieses Produkt nicht anzeigen“ gewählt, wird dort trotz global aktiver Funktion keine Grundauswahl im Frontend angezeigt. |
| Abgrenzung | Widerrufsgründe sind Analyse- und Prozessdaten. Sie ersetzen keine rechtliche Bewertung und sind unabhängig vom Widerrufsrecht freiwillig zu behandeln. |
Der Tab „Statistik“ wertet die freiwillig ausgewählten Gründe direkt im Kontext der Widerrufsgründe aus. Dadurch müssen Shopbetreiber nicht in einen separaten Reporting-Bereich wechseln, wenn sie schnell prüfen möchten, welche Produkte und Gründe besonders häufig auftreten.
Der Export im Statistik-Tab berücksichtigt die aktuell gesetzten Filter. Über ein Export-Modal kann ausgewählt werden, welche Auswertung als CSV erzeugt werden soll.
| Exporttyp | Inhalt |
|---|---|
| Gesamtbericht | Übersicht mit Kennzahlen, Top-Gründen, Top-Produkten, Grundgruppen, Matrix und Trend. |
| Top-Widerrufsgründe | Nur die häufigsten Gründe mit Gruppe, Widerrufen, Positionen und Menge. |
| Top-Produkte | Produkte mit der höchsten Widerrufsmenge und häufigstem Grund. |
| Produkt-Grund-Auswertung | Ideal für ein bestimmtes Produkt: Produktdaten und dazugehörige Grundkombinationen. |
| Grundgruppen | Auswertung, welche Grundgruppen am häufigsten verwendet werden. |
| Monatlicher Trend | Monatliche Entwicklung der Widerrufe und ausgewählten Gründe. |
| Rohdaten / Detail-Export | Einzelne Widerrufspositionen mit Produkt, SKU, Grund, Menge, Status und Datum. |
Die Statistik zeigt nur strukturierte Gründe, die tatsächlich von Kunden ausgewählt oder als Grundnotiz erfasst wurden. Wenn die globale Funktion deaktiviert ist, bleiben die Konfigurationen sichtbar, werden aber im Formular nicht abgefragt.
WMWRM_Pro::available_modules() / email_templateswmwrm_email_wp_mail_argsDas Pro-Template-Modul ersetzt die einfachen Basis-Mails durch konfigurierbare, responsive HTML-Mails. Es ist für einheitliche Kommunikation und bessere Nachvollziehbarkeit gedacht.
Die Templates arbeiten mit definierten Platzhaltern, damit Bestell-, Kunden- und Widerrufsdaten sicher in Betreff, Inhalt, Button oder HTML-Modus eingesetzt werden können.
| Platzhalter | Bedeutung |
|---|---|
{shop_name} | Name des Shops. |
{customer_name} | Name des Kunden. |
{customer_email} | E-Mail-Adresse des Kunden. |
{order_number} | Bestellnummer der WooCommerce-Bestellung. |
{request_id} | Interne Widerrufs-ID. |
{items_table} | HTML-Tabelle der betroffenen Positionen. |
{admin_note} | Admin-Hinweis oder Entscheidungstext. |
{admin_link} | Direkter Backend-Link zum Widerruf. |
{original_message} | Ursprüngliche Kundenangabe bzw. Widerrufserklärung. |
| Bereich | Beschreibung |
|---|---|
| Eingangsmail Kunde | Bestätigung, dass der Widerruf eingereicht wurde. |
| Eingangsmail Admin | Interne Benachrichtigung über neue Widerrufe. |
| Entscheidungsmail Kunde | Mitteilung über Genehmigung, Teilgenehmigung oder Ablehnung. |
| Zusätzliche PDF-Anhänge | Je Mailtyp können feste PDF-Dateien aus der WordPress-Mediathek aktiviert und mitgesendet werden, z. B. Checklisten, Hinweise oder Rücksendeinformationen. |
| Testmail | Kann mit Dummy-Daten oder vorhandenen Widerrufen versendet werden und berücksichtigt die aktuell gespeicherten Template-Anhänge. |
Zusätzliche PDF-Anhänge im Template-Modul sind statische Mediathek-Dateien. Sie unterscheiden sich von automatisch erzeugten Widerrufs-Nachweisen. Große Anhänge sollten bewusst eingesetzt werden, da sie Zustellbarkeit, Versanddauer und Mailserver-Limits beeinflussen können.
WMWRM_Pro::available_modules() / advanced_settingswmwrm_email_wp_mail_argsDieses Modul erweitert die E-Mail-Zustellung um mehrere Empfänger und Antwortadressen. Es ist für interne Teams sinnvoll, wenn Widerrufe nicht nur an eine einzelne Admin-Adresse gehen sollen.
WMWRM_Pro::available_modules() / pdf_documentswmwrm_admin_detail_proofswmwrm_email_attachmentsDas PDF-Modul erzeugt Nachweisdokumente zum Widerruf. Es unterstützt Eingangsnachweise und Entscheidungsnachweise und kann diese fallbezogenen PDFs optional an E-Mails anhängen.
Abgrenzung: PDF-Nachweise werden automatisch aus dem jeweiligen Widerrufsfall erzeugt. Zusätzliche PDF-Anhänge aus dem E-Mail-Template-Modul sind dagegen feste Mediathek-Dateien, z. B. Checklisten, Retourenhinweise oder allgemeine Kundeninformationen.
| Eingangs-PDF | Dokumentiert, dass ein Widerruf eingereicht wurde, inklusive Bestellung, Kunde, Zeitpunkt und Positionen. |
|---|---|
| Entscheidungs-PDF | Dokumentiert die spätere Entscheidung mit Status, Positionen, Mengen und Admin-Hinweis. |
| Download | In der Admin-Detailansicht können Nachweise erzeugt und heruntergeladen werden. |
| E-Mail-Anhang | PDFs können an Kunden-Eingangsbestätigung, Kunden-Entscheidung und Admin-Benachrichtigung angehängt werden. |
| Speicherort | PDFs werden im Upload-Bereich unter einem Widerrufsmanager-Pfad pro Request abgelegt. |
| Konfiguration | Dokumenttitel, Footertext, optionale Kundenmessage, Historie im PDF und Test-/Vorschau-Erzeugung über vorhandene Widerrufe können gesteuert werden. |
Das Modul ist kein Ersatz für rechtliche Beratung, aber ein technischer Nachweisgenerator für interne Ablage und Kundenkommunikation.
WMWRM_Pro::available_modules() / export_analyticsadmin.php?page=wmwrm-export-analyticsCSVDieses Modul ist die interne Reporting- und Datenexport-Zentrale. Es hilft dabei, Widerrufe nach Zeitraum, Status, Datenschutzstatus, Bestellung, Kunde, Produkt, Widerrufsart und optionalem Widerrufsgrund auszuwerten oder als CSV weiterzuverarbeiten. Ergänzend dazu besitzt der Bereich „Widerrufsgründe“ einen eigenen Statistik-Tab für grundbezogene Schnellanalysen und fokussierte Grund-/Produkt-Exporte.
| KPI | Bedeutung |
|---|---|
| Gesamt | Anzahl der Widerrufe im aktuellen Filterkontext. |
| Offen | Widerrufe, die noch nicht final geprüft wurden. |
| Bestätigt | Vollständig akzeptierte Widerrufe. |
| Teilweise bestätigt | Widerrufe, bei denen nur einzelne Positionen oder Mengen akzeptiert wurden. |
| Abgelehnt | Nicht akzeptierte Widerrufe. |
| Personenbezogen / anonymisiert | Datenschutzstatus der Datensätze. |
| Produkt-Auswertung | Top-Produkte nach beantragter Menge, genehmigter Menge, abgelehnter Menge und Anzahl betroffener Widerrufe. |
PRO 1.0.3 stellt die wichtigsten Analytics-Daten auch dem Lite-Dashboard-Widget zur Verfügung. Dadurch sieht der Admin direkt auf der WordPress-Dashboard-Startseite eine kompakte PRO-Statistik, ohne zuerst den vollständigen Export- und Analytics-Bereich öffnen zu müssen.
| Monatswert | Zeigt die Anzahl der Widerrufe im aktuellen Monat. |
|---|---|
| Top-Produkt | Zeigt das meistbetroffene Produkt im aktuellen Monatskontext. |
| Top-Grund | Zeigt den häufigsten optionalen Widerrufsgrund, sofern Gründe genutzt und ausgewertet werden können. |
| Aktionen | Direkte Buttons führen zur vollständigen Statistikansicht und zum Export-Bereich. |
Eine Zeile pro Widerruf. Geeignet für Falllisten, interne Übersichten, Statusauswertungen und Datenschutzkontrolle.
Eine Zeile pro Widerrufsposition. Geeignet für Produktanalysen, SKU-Auswertung, Mengenprüfung und Retouren-/Qualitätsauswertung.
WMWRM_Pro::available_modules() / privacy_automationwmwrm_daily_privacy_cleanupDie DSGVO-Automatisierung erweitert die Basis-Datenschutzfunktionen um statusabhängige Aufbewahrungsregeln, Simulation, manuelle Ausführung, optionalen täglichen WP-Cron und Audit-Log.
| Offene Widerrufe | Eigene Aufbewahrungsfrist in Monaten für noch nicht entschiedene Fälle. |
|---|---|
| Entschiedene Widerrufe | Eigene Frist für bestätigte und teilweise bestätigte Fälle. |
| Abgelehnte Widerrufe | Eigene Frist für abgelehnte Fälle. |
| Aktion nach Frist | Anonymisieren oder löschen, je nach Konfiguration. |
| Vorschau | Zeigt vor der Ausführung, wie viele Datensätze betroffen wären. |
| Manuelle Ausführung | Kann gezielt mit Bestätigungscheckbox gestartet werden. |
| Audit-Log | Dokumentiert Datenschutzläufe und betroffene Datensätze begrenzt. |
WMWRM_Pro::available_modules() / my_accountURL-Start: wmwrm_account_startDas Mein-Konto-Modul integriert den Widerrufsprozess direkt in WooCommerce „Mein Konto“. Kunden können dort widerrufsfähige Bestellungen sehen und bisherige Widerrufe nachvollziehen.
Dieses Modul reduziert Supportfragen, weil Kunden nicht mehr suchen müssen, wo sie einen Widerruf starten oder den Status früherer Widerrufe sehen.
WMWRM_Pro::available_modules() / elementor_widgetselementor button widgetelementor form widgetDie Elementor-Integration stellt eigene Widgets bereit, damit der Widerrufsprozess direkt im Elementor-Editor platziert und gestaltet werden kann. Das ist für Shops sinnvoll, die ihre Service- und Rechteseiten mit Elementor bauen.
Platziert einen Widerrufsbutton innerhalb eines Elementor-Layouts. Der Button kann als Call-to-Action in Servicebereichen, Footer-Sektionen, Hilfe-Seiten oder Bestellhinweisen verwendet werden.
Bindet das Widerrufsformular als Elementor-Element ein. Damit kann die Widerrufsseite ohne Shortcode direkt im visuellen Builder aufgebaut werden.
| Was ist Elementor? | Ein visueller Page Builder für WordPress. Widgets sind dort Bausteine, die per Drag-and-drop in Seiten eingefügt werden. |
|---|---|
| Nutzen des Moduls | Shopbetreiber müssen keine Shortcodes manuell einsetzen und können Formular/Button direkt im Builder verwalten. |
| Fallback | Wenn Elementor nicht genutzt wird, bleiben Shortcode, Block und WordPress-Widget verfügbar. |
WMWRM_Pro::available_modules() / refund_helperwmwrm_admin_detail_refundDie Erstattungshilfe unterstützt Admins nach einer bestätigten oder teilweise bestätigten Widerrufsentscheidung. Sie zeigt die betroffenen Positionen und führt zur WooCommerce-Erstattungsmaske.
Das Modul führt nicht automatisch blind eine Zahlungserstattung aus. Es dient als strukturierte Vorbereitung und Navigation zur WooCommerce-Erstattung.
WMWRM_Pro::available_modules() / security_pluswmwrm_lookup_security_checkSicherheit Plus schützt den öffentlichen Bestell-Lookup vor zu vielen Prüfversuchen und erweitert die öffentliche Bestellprüfung um flexible Verifizierungsmethoden. Zusätzlich enthält das Modul ein Bestellnummern-Mapping für Shops, die WooCommerce-Bestellungen mit individuellen, fortlaufenden oder von Drittanbieter-Plugins erzeugten Bestellnummern anzeigen.
| Rate-Limit | Begrenzt die Anzahl der Bestellprüfungen innerhalb eines Zeitfensters und blockiert zu viele Lookup-Anfragen zeitlich begrenzt. |
|---|---|
| Flexible Verifizierung | Bestellnummer bleibt Pflicht; zusätzlich können E-Mail-Adresse, Bestelldatum, Rechnungsnachname/Firma oder Rechnungs-PLZ abgefragt werden. |
| Verifizierungsmodi | Unterstützt u. a. Bestellnummer + E-Mail, Bestellnummer + Bestelldatum, Bestellnummer + Nachname/Firma, Kombinationen mit PLZ sowie strengere Mehrfachprüfungen. |
| Abweichende Benachrichtigungs-E-Mail | Optionales Formularfeld für eine andere Empfängeradresse für Bestätigungen und spätere Status-Updates. |
| Verifizierungstoken | Signiert den erfolgreichen Lookup, damit die finale Einreichung nicht einfach mit manipulierten Bestelldaten wiederholt werden kann. |
| Frontend-Meldung | Eigener Hinweistext für den Kunden, z. B. „Zu viele Prüfversuche…“. |
| Protokoll | Zeigt blockierte Lookup-Anfragen mit Zeitpunkt, Typ, maskierten Daten und Grund. Das Sicherheits-Log kann im Adminbereich geleert werden. |
| Oberfläche | Die Seite ist in Tabs gegliedert: Rate-Limit, Verifizierung, Bestellnummern-Mapping und Protokoll. Eine kompakte Konfigurationsübersicht zeigt die wichtigsten aktiven Einstellungen. |
Das Mapping legt fest, wie die im öffentlichen Formular eingegebene Bestellnummer einer WooCommerce-Bestellung zugeordnet wird. Das ist besonders wichtig, wenn Kunden nicht die interne WooCommerce-Bestell-ID sehen, sondern eine von einem Custom-Order-Number-Plugin erzeugte Nummer.
| Automatische Erkennung | Standardmodus. Das Plugin prüft performant die WooCommerce-Bestell-ID und bekannte Bestellnummern-Meta-Keys, ohne bei jedem Formularaufruf alle Bestellungen breit zu durchsuchen. |
|---|---|
| WooCommerce-Bestell-ID | Verwendet ausschließlich die interne technische WooCommerce-Bestell-ID. Geeignet, wenn Kunden genau diese Nummer in E-Mails und im Konto sehen. |
| Custom-Bestellnummer über Meta-Key | Verwendet nur die konfigurierten Meta-Keys. Das Eingabefeld für aktive Custom-Meta-Keys wird nur in diesem Modus angezeigt. |
| Aktive Meta-Keys | Ein Meta-Key pro Zeile. Nur diese Keys werden bei der Custom-Meta-Key-Quelle abgefragt, damit die öffentliche Prüfung schnell bleibt. |
| Meta-Keys inspizieren | Der Button scannt aktuelle WooCommerce-Bestellungen nach wahrscheinlichen Custom-Bestellnummern-Feldern. Gefundene Keys werden als Auswahl angezeigt und können direkt zur aktiven Liste hinzugefügt werden. |
| Mapping testen | Admins können eine Bestellnummer genau so eingeben, wie ein Kunde sie verwenden würde. Der Test zeigt, ob und über welche Quelle eine passende WooCommerce-Bestellung gefunden wird. |
| Entry Point | Edition | Zweck |
|---|---|---|
[wmwiderrufsmanager_formular] | Lite | Vollständiges Widerrufsformular. |
[wmwiderrufsmanager_button] | Lite | Button zur konfigurierten Widerrufsseite. |
| Gutenberg Formular-Block | Lite | Formular ohne manuelle Shortcode-Eingabe platzieren. |
| Gutenberg Button-Block | Lite | Button ohne manuelle Shortcode-Eingabe platzieren. |
| WordPress Button-Widget | Lite | Button in Sidebar/Footer/Widget-Bereich. |
| Elementor Button Widget | Pro | Button im Elementor Builder. |
| Elementor Formular Widget | Pro | Formular im Elementor Builder. |
| WooCommerce Mein-Konto-Integration | Pro | Kundenkonto-Übersicht für Widerruf starten und bestehende Widerrufe. |
| Status Key | Label | Bedeutung |
|---|---|---|
pending | Offen / In Prüfung | Widerruf wurde eingereicht, aber noch nicht final entschieden. |
approved | Bestätigt | Widerruf wurde vollständig akzeptiert. |
partially_approved | Teilweise bestätigt | Nur einzelne Positionen oder Mengen wurden akzeptiert. |
rejected | Abgelehnt | Widerruf wurde nicht akzeptiert. |
Die Exportfunktion unterscheidet zwischen Standard-CSV, Detail-CSV und den spezialisierten Statistik-Exports aus dem Bereich „Widerrufsgründe“. Die Standard-CSV ist fallbezogen, die Detail-CSV ist positionsbezogen; Statistik-Exports sind je nach Auswahl auf Gründe, Produkte, Grundgruppen, Trend oder Rohdaten fokussiert.
Widerrufs-ID, Eingangsdatum, Aktualisierung, Entscheidungsdatum, Status, Bestellnummer, Bestell-ID, Kunde, E-Mail, Widerrufsart, Datenschutzstatus, Nachricht, Adminnotiz, Anzahl Positionen, Produktnamen, SKUs, beantragte/genehmigte/abgelehnte Gesamtmengen, optionale Widerrufsgründe, Grundgruppen, Grundnotizen, Positionsentscheidungen und Positionsdetails.
Eine Zeile pro Position mit Widerrufs-ID, Bestellung, Kunde, Produktname, SKU, Produkt-ID, Varianten-ID, Bestellpositions-ID, beantragter Menge, genehmigter Menge, abgelehnter Menge, optionaler Grundgruppe, optionalem Widerrufsgrund, optionaler Grundnotiz, Positionsentscheidung und Positionsnotiz.
Je nach Exporttyp Zeitraum, Statusfilter, Widerrufsart, Produkt/SKU-Filter, Grundfilter, KPI-Werte, Grundgruppe, Grundlabel, Produktname, SKU, Produkt-ID, Widerrufe, Positionen, Menge, Anteil, Monat und Detailpositionen.
load_plugin_textdomain()languages/*.potlanguages/*-de_DE.polanguages/*-de_DE.moLite und Pro sind für einen mehrsprachigen Betrieb vorbereitet. Die Quelltexte im Plugin sollen künftig standardmäßig englische Originaltexte verwenden. Deutsche Texte werden über WordPress-Sprachdateien ausgeliefert. Dadurch können rechtlich relevante Begriffe kontrolliert in der deutschen Übersetzung gepflegt und später weitere Sprachen ergänzt werden.
.po- und .mo-Dateien bereitgestellt.wm-widerrufsmanager; ein separates Pro-Paket kann eigene Übersetzungsdateien ergänzen.Die Trennung aus englischem Code-Fallback und deutscher Übersetzung macht das Plugin international nutzbar, ohne deutsche Rechtsbegriffe hart im Code zu verankern. Gleichzeitig können Begriffe wie Widerruf, Widerrufserklärung, Eingangsbestätigung, Teilwiderruf, Widerrufsausschluss oder Widerrufsgrund zentral geprüft und konsistent übersetzt werden.
| Bereich | Lite | Pro |
|---|---|---|
| Text-Domain | wm-widerrufsmanager | abhängig vom Pro-Paket |
| Sprachordner | languages/ | languages/ |
| POT-Vorlage | wm-widerrufsmanager.pot | abhängig vom Pro-Paket |
| Deutsche Übersetzung | wm-widerrufsmanager-de_DE.po/.mo | abhängig vom Pro-Paket |
| Block-/JS-Übersetzungen | wm-widerrufsmanager-de_DE-wmwrm-blocks.json | bei Bedarf über eigene JS-Sprachdateien |
__(), esc_html__(), esc_attr__() oder _n().esc_html__(), Attribute mit esc_attr__().| Schritt | Beschreibung |
|---|---|
| 1. Quelltext ändern | Neue UI-, E-Mail-, Admin- oder Frontend-Texte als englische i18n-Strings einbauen. |
| 2. POT aktualisieren | Aus dem Plugin-Code eine neue .pot-Datei erzeugen. |
| 3. PO pflegen | Deutsche Begriffe in der de_DE.po fachlich und rechtlich sauber übersetzen. |
| 4. MO kompilieren | Aus der .po eine binäre .mo erzeugen, damit WordPress die Übersetzung laden kann. |
| 5. Installation prüfen | Backend-Sprache, Frontend, E-Mails, Historie, PDF, Export und JavaScript-/Block-Texte testen. |
Wichtig für Go-Live: Die deutsche Übersetzung ist nicht nur eine technische Sprachdatei, sondern auch die zentrale Stelle für rechtlich sensible Begriffe. Änderungen an Widerrufsbegriffen, E-Mail-Texten, Ausschlussgründen, Widerrufsgründen oder Nachweisformulierungen sollten daher bewusst geprüft werden.
Lite enthält die Standardprüfung für normale WooCommerce-Bestellungen. PRO erweitert diesen Bereich um zusätzliche Schutz-, Verifizierungs- und Mapping-Funktionen für Shops mit individuellen Bestellnummern oder erhöhtem Sicherheitsbedarf.
| Funktionsbereich | Lite | Pro | Interner Nutzen |
|---|---|---|---|
| Widerrufsformular | Ja | Ja | Strukturierte Annahme von Widerrufen über Bestellprüfung, Formularlogik und Positionsauswahl. |
| Widerrufsbutton | Ja | Ja | Zentraler Einstieg zur Widerrufsseite über Shortcode, Block oder Widget. |
| WordPress-Dashboard-Widget | Ja | Erweitert | Lite 1.0.13 zeigt Gesamt, Offen, Genehmigt und Abgelehnt. PRO 1.0.3 ergänzt Monatsstatistik, Top-Produkt, Top-Grund und direkte Statistik-/Export-Aktionen. |
| Moderner Schnellstart mit Tutorial-Link | Ja | Ja | Einrichtungsstatus, wichtige Schritte und YouTube-Tutorials werden direkt im Dashboard zusammengeführt. |
| Gutenberg-Blöcke | Ja | Ja | Einbindung im Blockeditor ohne manuelle Shortcode-Kenntnis. |
| Bestell- und Fristprüfung | Ja | Ja | Verhindert unpassende, doppelte oder außerhalb der Frist liegende Widerrufsanfragen. |
| Standard-Bestellprüfung per Bestellnummer und E-Mail | Ja | Ja | Lite enthält die grundlegende WooCommerce-Bestellprüfung mit Abgleich der Rechnungs-E-Mail. |
| Flexible Verifizierungsmethoden | Nein | Ja | PRO kann zusätzliche Prüfwerte wie Bestelldatum, Rechnungsnachname/Firma oder Rechnungs-PLZ verwenden. |
| Sicherheit Plus / Rate-Limit | Nein | Ja | Begrenzt öffentliche Lookup-Versuche und reduziert Missbrauch, automatisierte Abfragen und unnötige Supportfälle. |
| Protokoll blockierter Lookup-Anfragen | Nein | Ja | Geblockte Prüfversuche werden nachvollziehbarer, damit Admins und Support schneller reagieren können. |
| Custom-Bestellnummern-Mapping | Basis-Erkennung | Erweitert | Hilft Shops mit fortlaufenden oder individuellen Bestellnummern, die Kundeneingabe korrekt der WooCommerce-Bestellung zuzuordnen. |
| Meta-Key-Inspektion für Custom-Order-Number-Plugins | Nein | Ja | Relevante Bestell-Meta-Keys können gesucht, geprüft und für das Mapping aktiviert werden. |
| Mapping-Test für Bestellnummern | Nein | Ja | Admins können testen, ob eine sichtbare Bestellnummer korrekt zur internen WooCommerce-Bestellung führt. |
| Teilmengen und Teilwiderrufe | Ja | Ja | Saubere Abbildung mehrteiliger Bestellungen, Varianten und einzelner Positionsmengen. |
| Admin-Verwaltung | Ja | Ja | Interne Prüfung, Statusentscheidung, Notizen, Historie und Nachvollziehbarkeit im Backend. |
| Positionsentscheidung | Ja | Ja | Genehmigung oder Ablehnung je Position und Menge statt nur pauschalem Gesamtstatus. |
| Basis-E-Mails | Ja | Ja | Automatische Eingangs- und Entscheidungsinformationen für Kunden und Shopbetreiber. |
| Produkt-/Kategorie-/Tag-Ausschlüsse | Nein | Ja | Widerrufsausschlüsse zentral und nachvollziehbar auf Produkt-, Kategorie- oder Schlagwortebene pflegen. |
| Optionale Widerrufsgründe | Nein | Ja | Freiwillige Grundauswahl je Widerrufsposition mit eigenen Grundgruppen, Produktsichtbarkeit, Statistik-Tab und CSV-Export. |
| E-Mail-Template-Builder | Nein | Ja | Professionellere Mails mit Layout, Logo, Farben, Platzhaltern, Testversand und HTML-Modus. |
| Zusätzliche PDF-Anhänge je E-Mail-Template | Nein | Ja | Statische PDF-Dateien wie Checklisten, Rücksendehinweise oder Kundeninformationen passend zum jeweiligen Mailtyp mitsenden. |
| Mehrere E-Mail-Empfänger / CC / BCC / Reply-To | Nein | Ja | Bessere interne Routing-, Support- und Buchhaltungsprozesse bei Widerrufen. |
| PDF-Nachweise | Nein | Ja | Download- und E-Mail-Nachweise für Einreichung, Entscheidung und interne Dokumentation. |
| Auswertung & Export | Nein | Ja | CSV-Export, Detailauswertungen, Kennzahlen, globale Analytics und spezialisierte Grund-/Produkt-Statistiken. |
| DSGVO-Automatisierung mit Statusgruppen | Basis | Erweitert | Statusabhängige Aufbewahrung, Simulation, Audit-Log und optionale Cron-Automatisierung. |
| Mein-Konto-Integration | Nein | Ja | Kunden können Widerrufe im WooCommerce-Konto starten und bisherige Widerrufe mit Status, Umfang und Positionen einsehen. |
| Elementor Widgets | Nein | Ja | Designerfreundliche Platzierung von Button, Formular oder Widerrufsbereichen direkt im Elementor-Layout. |
| Erstattungshilfe | Nein | Ja | Interne Unterstützung bei Beträgen, Positionen und nachvollziehbarer Vorbereitung von Rückzahlungen. |