Familien-Bestellungen

Das Familien-Bestellungen-Modul vereinfacht wiederkehrende Sammelbestellungen innerhalb einer Gruppe – ob Familie, Freundeskreis oder Community. Jedes Mitglied trägt seine Menge pro Position ein, ein Koordinator behält die Gesamtübersicht.

Allgemein

Eine Bestellung erstellen

Ein Koordinator legt eine Sammelbestellung mit Titel, Beschreibung, optionalem Shop-Link, einer Liste von Positionen und einer Einsendefrist an. Ausgewählte Mitglieder werden per E-Mail über die neue Bestellung informiert.

Mengen eintragen

Solange eine Bestellung offen ist, tragen Mitglieder ihre gewünschte Menge pro Position direkt im Frontend ein – mehrfach anpassbar, bis die Frist erreicht ist.

Fristen & automatische E-Mails

Ein stündlicher Hintergrundjob prüft alle offenen Bestellungen: Läuft die Frist in weniger als sieben Tagen ab, wird einmalig eine Erinnerungsmail verschickt (an die ursprünglich benachrichtigten Mitglieder UND alle, die bereits eine Menge eingetragen haben). Ist die Frist erreicht, schließt das Modul die Bestellung automatisch und verschickt eine Abschluss-Zusammenfassung.

Koordinator-Übersicht & Export

Der Koordinator sieht eine Gesamtübersicht aller Positionen mit Mengen pro Nutzer und kann die Bestellung als CSV exportieren.

Shortcodes

Shortcode	Beschreibung
weinhold_family_orders	Rendert die Bestellübersicht: offene und abgeschlossene Bestellungen, Erstell-Formular, Detail-/Mengen-Ansicht

Dateien

modules/family_orders.php – einzige Datei des Moduls: Datenbank, Cron-Job, Frontend-Formularverarbeitung, drei E-Mail-Versandfunktionen, CSV-Export, Shortcode, Admin-Seite, Cleanup.

Für Entwickler

Datenbank

Tabelle	Spalten	(Auswahl)
weinhold_family_orders	title, description, shop_url, status	(open/closed), deadline_gmt, notify_user_ids, launch_mail_sent, reminder_mail_sent, closed_mail_sent
weinhold_family_order_items	order_id, name, item_url, sort_order
weinhold_family_order_entries	order_id, item_id, user_id, quantity	(unique je Kombination aus allen dreien)

Cron-Job

weinhold_family_orders_cron_tick läuft stündlich (registriert 15 Minuten nach der Modul-Aktivierung, WP-Cron-Standardintervall hourly). weinhold_family_orders_run_cron_tick() schließt Bestellungen mit abgelaufener Frist automatisch und löst dabei die Abschluss-Mail aus, verschickt außerdem für Bestellungen mit Frist innerhalb der nächsten sieben Tage einmalig die Erinnerungsmail (Flags launch_mail_sent/reminder_mail_sent/closed_mail_sent verhindern Mehrfachversand).

Drei E-Mail-Funktionen

Funktion	Wann	Empfänger
weinhold_family_orders_send_launch_mail($order_id)	Bei	Erstellung Konfigurierte notify_user_ids
weinhold_family_orders_send_reminder_mail($order)	Frist	in unter 7 Tagen notify_user_ids PLUS alle, die bereits eine Menge eingetragen haben
weinhold_family_orders_send_closed_summary_mail($order_id)	Frist	erreicht notify_user_ids

Besonderheiten

Die Erinnerungsmail geht NICHT nur an Mitglieder ohne Eintrag, sondern zusätzlich an alle, die bereits eine Menge eingetragen haben – vermutlich damit auch Teilnehmer, die schon mitgemacht haben, ihre Mengen vor Fristende noch anpassen können.

Alle drei E-Mail-Funktionen nutzen direktes wp_mail() statt des zentralen Template-Systems des E-Mail-Versand-Moduls – anders als z. B. Gerätesicherheit oder Security Manager, die ihre Benachrichtigungen über weinhold_send_module_mail() mit anpassbaren Vorlagen versenden.

Eigenes Tabellenpräfix wpdb prefix statt des sonst im Framework üblichen wpdb base_prefix – wie beim Bastard-des-Monats-Modul ist dieses Modul bewusst nicht Multisite-übergreifend gedacht.

Versionshistorie

Version	Datum	Änderung
1.0.0	22.09.2026	Einführung der Versionierung.

Family Orders

The Family Orders module simplifies recurring group orders within a group — whether family, friends, or a community. Each member enters their quantity per item, and a coordinator keeps the overall overview.

General

Creating an Order

A coordinator creates a group order with a title, description, optional shop link, a list of items, and a submission deadline. Selected members are notified by email about the new order.

Entering Quantities

As long as an order is open, members enter their desired quantity per item directly in the frontend — adjustable repeatedly until the deadline is reached.

Deadlines & Automatic Emails

An hourly background job checks all open orders: if the deadline is less than seven days away, a one-time reminder email is sent (to the originally notified members AND everyone who has already entered a quantity). Once the deadline is reached, the module automatically closes the order and sends a closing summary.

Coordinator Overview & Export

The coordinator sees an overall overview of all items with quantities per user and can export the order as CSV.

Shortcodes

Shortcode	Description
weinhold_family_orders	Renders the order overview: open and closed orders, creation form, detail/quantity view

Files

modules/family_orders.php – the module’s only file: database, cron job, frontend form processing, three email-sending functions, CSV export, shortcode, admin page, cleanup.

For Developers

Database

Table	Columns	(selection)
weinhold_family_orders	title, description, shop_url, status	(open/closed), deadline_gmt, notify_user_ids, launch_mail_sent, reminder_mail_sent, closed_mail_sent
weinhold_family_order_items	order_id, name, item_url, sort_order
weinhold_family_order_entries	order_id, item_id, user_id, quantity	(unique per combination of all three)

Cron Job

weinhold_family_orders_cron_tick runs hourly (scheduled 15 minutes after module activation, WP-Cron’s standard hourly interval). weinhold_family_orders_run_cron_tick() automatically closes orders past their deadline, triggering the closing email, and also sends the one-time reminder email for orders with a deadline within the next seven days (the launch_mail_sent/reminder_mail_sent/closed_mail_sent flags prevent duplicate sends).

Three Email Functions

Function	When	Recipients
weinhold_family_orders_send_launch_mail($order_id)	On	creation Configured notify_user_ids
weinhold_family_orders_send_reminder_mail($order)	Deadline	under 7 days away notify_user_ids PLUS everyone who has already entered a quantity
weinhold_family_orders_send_closed_summary_mail($order_id)	Deadline	reached notify_user_ids

Special Cases

The reminder email does NOT go only to members without an entry, but additionally to everyone who has already entered a quantity — presumably so participants who already joined in can still adjust their quantities before the deadline.

All three email functions use direct wp_mail() instead of the Email Delivery module’s central template system — unlike, for example, Device Security or Security Manager, which send their notifications via weinhold_send_module_mail() with customizable templates.

Uses its own wpdb prefix instead of the wpdb base_prefix otherwise standard across the framework — like the Bastard of the Month module, this module is deliberately not meant to span the whole Multisite network.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

familien-bestellungen