Pre-order Manager — Vollständiger Leitfaden

Überblick

DataFirefly Pre-order Manager verwandelt jedes WooCommerce-Produkt (einfach oder variabel) in eine professionelle Vorbestellung. Der Kunde zahlt eine Anzahlung oder den vollen Betrag bei der Bestellung; zum Verfügbarkeitsdatum (ETA) wandelt das Plugin die Vorbestellung automatisch um: Vollzahlungen gehen in Bearbeitung, Anzahlungen erzeugen eine Restbestellung mit Zahlungslink. Automatische Erinnerungen, zukünftige Bestandsgrenze, anpassbares Badge und eine vollständige REST-API runden den Workflow ab.

Installation

1. Laden Sie die Datei dfpreorder.zip aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie in Ihrer WordPress-Administration zu Plugins → Installieren → Plugin hochladen.
3. Wählen Sie das ZIP aus, klicken Sie auf Jetzt installieren und aktivieren Sie das Plugin.
4. Ein neues Untermenü WooCommerce → Pré-commandes erscheint: Dies ist die Steuerzentrale des Plugins.

Globale Einstellungen

Öffnen Sie WooCommerce → Pré-commandes → Tab Einstellungen. Die Optionen sind in Blöcke gruppiert:

• Aktivierung — globaler Modulschalter und gemischte Warenkorb-Richtlinie (Mischen von Vorbestellungen und regulären Produkten im selben Warenkorb erlauben oder blockieren).
• Automatische Umwandlung — aktiviert die tägliche Umwandlung zum ETA, legt eine Karenzfrist (0 bis 90 Tage) nach dem ETA fest, sowie das Wiederauffüllen reservierter Einheiten bei Stornierung.
• Badge-Anzeige — Text, Hintergrundfarbe, Textfarbe und Platzierungen (Shop-Listen und/oder Produktseite).
• Beschriftungen — Text des In-den-Warenkorb-Buttons und Label vor dem ETA.
• Kunden-E-Mails — Aktivierung der Verfügbarkeits- und Restbetrag-E-Mails.
• Erinnerungen für unbezahlte Restbeträge — Aktivierung der Erinnerungen und kommagetrennte Tagesschwellen (Standard 7,14,30).
• Versandkosten — Option, die Versandkosten auf die Restbestellung zu übertragen (siehe eigener Abschnitt unten).

Ein Produkt als Vorbestellung konfigurieren

1. Öffnen Sie das Produkt im WooCommerce-Editor und finden Sie den Tab Pré-commande in den Produktdaten.
2. Aktivieren Sie Vorbestellung aktivieren.
3. Wählen Sie den Zahlungsmodus: „Vollzahlung“ (der Kunde zahlt alles bei der Bestellung) oder „Anzahlung“ (Prozent oder fester Betrag, der Restbetrag wird bei Verfügbarkeit abgerechnet).
4. Geben Sie das ETA-Datum ein (voraussichtliches Verfügbarkeitsdatum). Ein optionales Textfeld zeigt ein freies Label anstelle des Datums (z. B. „Verfügbar Anfang Juli“).
5. Legen Sie optional eine zukünftige Bestandsgrenze fest: die maximale Anzahl vorbestellbarer Einheiten. Der Zähler reservierter Einheiten wird neben dem Feld angezeigt.
6. Passen Sie bei Bedarf den Badge-Text für dieses Produkt und das automatische Umwandlungsverhalten an (globale Einstellung erben, Ja erzwingen, Nein erzwingen).
7. Speichern: Das Badge und der ETA-Hinweis erscheinen sofort auf der Produktseite.

Lebenszyklus einer Vorbestellung

Hier ist der vollständige Workflow, Schritt für Schritt:

1. Erstbestellung — der Kunde legt das Produkt in den Warenkorb. Im Anzahlungsmodus ist der angezeigte Preis in Warenkorb und Checkout der Anzahlungsbetrag, mit Hinweis auf den Restbetrag. Die Zahlung läuft über den üblichen Anbieter.
2. Registrierung — bei Zahlung geht die Bestellung in den Status wc-preorder, eine Zeile wird in der internen Tabelle des Plugins erstellt, und der Kunde erhält die Vorbestellungsbestätigung per E-Mail.
3. Warten — die Vorbestellung erscheint in WooCommerce → Pré-commandes → Tab Liste mit Status, ETA-Datum und Beträgen.
4. Umwandlung zum ETA — der tägliche Cron (03:00 Uhr Site-Zeit) erkennt fällige Vorbestellungen (ETA + optionale Karenzfrist):
   • Modus Vollzahlung: Die Bestellung geht in „In Bearbeitung“ und der Kunde erhält die Verfügbarkeits-E-Mail.
   • Modus Anzahlung: Eine Restbestellung wird automatisch erzeugt (Status „Zahlung ausstehend“) und der Kunde erhält die E-Mail „Restbetrag fällig“ mit direktem Zahlungsbutton.
5. Restbetragszahlung — der Kunde zahlt über den E-Mail-Link (native WooCommerce-Zahlungs-URL, durch order key gesichert, kein Login nötig) oder über Mein Konto. Bei Zahlung wird die Vorbestellung als abgeschlossen markiert und die Originalbestellung geht in „In Bearbeitung“, sobald alle Vorbestellungszeilen aufgelöst sind.

Verwaltung im Admin-Bereich

Der Tab Liste zeigt alle Vorbestellungen mit Statusfilter, Suche nach Bestell- oder Produkt-ID und Paginierung. Vier Status existieren: Ausstehend (blau), Restbetrag ausstehend (bernstein), Abgeschlossen (grün) und Storniert (grau). Jede Zeile hat zwei Aktionen:

• Umwandeln — erzwingt die sofortige Umwandlung ohne auf das ETA zu warten (nützlich, wenn der Bestand früher eintrifft).
• Stornieren — storniert die Vorbestellung, gibt reservierte Einheiten frei (wenn die Restock-Option aktiv ist) und setzt die Bestellung auf „Storniert“, wenn sie noch im Vorbestellungsstatus war.

Der Button „Umwandlung jetzt ausführen“ oben löst die tägliche Prüfung sofort aus, ohne auf den 03:00-Uhr-Cron zu warten.

Kundenseite: Mein Konto

Auf der Seite Mein Konto → Bestelldetails:

• Die Originalbestellung zeigt ein Panel „Restbetrag Ihrer Vorbestellung“ mit den verknüpften Restbestellungen, deren Betrag, Status und einem Button „Restbetrag bezahlen“ für noch unbezahlte.
• Die Restbestellung zeigt ihrerseits ein Panel „Ursprüngliche Vorbestellung“ mit Link zur Erstbestellung.

Kunden-E-Mails

Vier Transaktions-E-Mails werden mitgeliefert, jeweils in HTML- und Plain-Text-Version, bearbeitbar unter WooCommerce → Einstellungen → E-Mails:

• Vorbestellungsbestätigung — gesendet bei Registrierung der Vorbestellung, mit Anzahlungshinweis wo zutreffend.
• Vorbestellung verfügbar — gesendet bei Umwandlung im Vollzahlungsmodus.
• Restbetrag fällig — gesendet bei Erzeugung der Restbestellung, mit hervorgehobenem Betrag und direktem Zahlungsbutton.
• Restbetrag-Erinnerung — Erinnerungen zu den konfigurierten Schwellen, wenn der Restbetrag unbezahlt bleibt.

Automatische Erinnerungen

Wenn aktiviert, scannt der tägliche Cron noch unbezahlte Restbestellungen (Status ausstehend, wartend oder fehlgeschlagen) und sendet eine Erinnerung zu jeder konfigurierten Schwelle. Das Feld akzeptiert eine kommagetrennte Liste von Tagen — z. B. 7,14,30 für Erinnerungen 7, 14 und 30 Tage nach Erstellung der Restbestellung. Jede Schwelle wird pro Bestellung nur einmal ausgelöst; das Tracking wird in der Meta der Restbestellung gespeichert.

Versandkosten auf der Restbestellung

Standardmäßig enthält die Restbestellung keine Versandkosten (sie wurden mit der Originalbestellung beglichen). Wenn Ihre Anzahlung nur die Produktreservierung abdeckt und Sie den Versand beim Versenden abrechnen, aktivieren Sie die Option „Versandkosten auf den Restbetrag übertragen“: Die Versandzeilen der Originalbestellung werden auf die Restbestellung dupliziert, mit Methode und Steuern intakt.

Shortcodes

• [dfpo_badge product_id="123"] — zeigt das Vorbestellungs-Badge des angegebenen Produkts (oder des aktuellen Produkts, wenn weggelassen).
• [dfpo_eta product_id="123"] — zeigt das formatierte Verfügbarkeitsdatum mit seinem Label.
• [dfpo_remaining product_id="123"] — zeigt die Anzahl noch vorbestellbarer Einheiten, wenn eine Grenze gesetzt ist.

REST-API

Alle Routen liegen unter dem Namespace dfpo/v1 und erfordern die Fähigkeit manage_woocommerce (Authentifizierung per WooCommerce-API-Schlüssel oder Application Password):

• GET /wp-json/dfpo/v1/preorders — paginierte Liste (Parameter status, page, per_page).
• GET /wp-json/dfpo/v1/preorders/{id} — Detail einer Vorbestellung.
• POST /wp-json/dfpo/v1/preorders/{id}/convert — erzwingt die Umwandlung (boolescher Parameter force).
• POST /wp-json/dfpo/v1/preorders/{id}/cancel — storniert und gibt reservierten Bestand frei.
• POST /wp-json/dfpo/v1/run-conversion — löst die Umwandlungsprüfung sofort aus.

Entwickler-Hooks

• dfpo_preorder_registered (Action) — nach Erstellung einer Vorbestellungszeile.
• dfpo_preorder_converted_full (Action) — nach Umwandlung einer Vollzahlung.
• dfpo_preorder_converted_deposit (Action) — nach Erzeugung der Restbestellung.
• dfpo_preorder_balance_paid (Action) — nach Einzug des Restbetrags.
• dfpo_email_preorder_balance_reminder (Action) — beim Auslösen einer Erinnerung (ermöglicht das Anbinden von SMS oder anderen Kanälen).
• dfpo_badge_html (Filter) — zum Ändern des Badge-HTML.

Fehlerbehebung

• Die Umwandlung wird nicht ausgelöst — prüfen Sie, ob WP-Cron auf Ihrem Host funktioniert (manche Hoster deaktivieren ihn; nutzen Sie dann einen System-Cron, der wp-cron.php aufruft). Sie können jederzeit manuell aus dem Tab Liste umwandeln.
• Der Warenkorbpreis wirkt nach Produktbearbeitung falsch — leeren Sie den Testwarenkorb und die Caches (Objekt und Seite). Das Plugin liest den Originalpreis direkt aus der Datenbank, um Cache-Artefakte zu vermeiden.
• Die Restbetrag-E-Mail kommt nicht an — prüfen Sie, ob die E-Mail „Restbetrag fällig“ unter WooCommerce → Einstellungen → E-Mails aktiviert ist, und testen Sie die allgemeine Zustellbarkeit Ihrer Site (SMTP empfohlen).
• Das Badge wird nicht angezeigt — prüfen Sie den globalen Modulschalter, die Badge-Platzierungen in den Einstellungen, und ob Ihr Theme die Standard-WooCommerce-Hooks aufruft (woocommerce_single_product_summary, woocommerce_after_shop_loop_item_title).

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Das Löschen des Plugins über Plugins entfernt dauerhaft die internen Tabellen, Optionen und Produkt-Metadaten. WooCommerce-Bestellungen (Original und Restbetrag) werden niemals gelöscht.