Wunschliste

Das Wunschlisten-Modul ermöglicht gemeinsame Wunschlisten für Mitglieder einer Webseite. Der clevere Trick: Andere Nutzer können Wünsche als „gekauft“ markieren – der Listenbesitzer sieht das aber erst nach einem selbst festgelegten Datum.

Allgemein

Wünsche verwalten

Jeder Wunsch besteht aus Name, optionalem Link und Menge. Die Verwaltung der eigenen Liste (Titel, Kurzbeschreibung, ausführliche Beschreibung, Reihenfolge der Wünsche, Verbergen-Datum) erfolgt direkt im Frontend, solange die Liste noch verborgen ist.

Verdeckte Kaufmarkierung

Sobald ein anderer Nutzer einen Wunsch als „gekauft“ markiert, sieht der Listenbesitzer bis zum eingestellten Datum ausschließlich „Bis Datum verborgen“ – unabhängig vom tatsächlichen Status. Erst nach Ablauf der Frist wird sichtbar, was gekauft wurde und von wem. Hat ein anderer Nutzer einen Wunsch bereits markiert, können weitere Nutzer ihn nicht zusätzlich markieren oder entmarkieren – nur wer selbst markiert hat, kann die Markierung wieder rückgängig machen.

Zugriff

Sichtbar sind nur Wunschlisten von Mitgliedern der jeweiligen Website (bei Multisite: Mitgliedschaft auf der konkreten Subsite, Netzwerk-Administratoren sehen immer alles).

Shortcodes

Shortcode	Beschreibung
weinhold_wishlist	Rendert die Wunschlisten-Übersicht. Eingeloggte Nutzer sehen ihre eigene Liste und können die Listen anderer Mitglieder einsehen

Dateien

modules/wishlist.php – einzige Datei des Moduls: Datenbank, Datum-/Zeitzonen-Hilfsfunktionen, Frontend-Formularverarbeitung, Listen- und Detailansicht, Shortcode, Cleanup.

Für Entwickler

Datenbank

Tabelle	Spalten	(Auswahl)
weinhold_wishlists	owner_user_id, title, caption, description, reveal_at_gmt
weinhold_wishlist_items	wishlist_id, name, item_url, quantity, sort_order, purchased_by, purchased_at_gmt

Beide Tabellen nutzen das site-lokale wpdb prefix, keine eigene site_id-Trennung auf Item-Ebene (die liegt nur auf der Listen-Tabelle).

Zeitzonen-Handling

reveal_at_gmt wird konsequent in UTC gespeichert. weinhold_wishlist_parse_local_datetime() wandelt die lokale Eingabe aus dem datetime-local-Formularfeld in UTC um, weinhold_wishlist_get_datetime_input_value() den umgekehrten Weg fürs erneute Befüllen des Formulars, weinhold_wishlist_format_local_datetime() für die reine Anzeige in der Zeitzone der Website.

Wichtige Funktionen

Funktion	Beschreibung
weinhold_wishlist_user_has_access($user_id,$site_id)	Prüft Mitgliedschaft auf der Site (Multisite: is_user_member_of_blog, Super-Admins immer erlaubt)
weinhold_wishlist_get_lists_for_site($site_id,$mode)	Listet Listen einer Site, Modus open oder revealed (nach reveal_at_gmt gefiltert)
weinhold_wishlist_render_detail($list,$user_id,$site_id)	Rendert eine einzelne Liste inkl. der komletten Sichtbarkeitslogik für Kaufstatus

Besonderheiten

Die Verbergung ist konsequent serverseitig: Der Kaufstatus wird dem Besitzer schlicht nie ausgeliefert, solange reveal_at_gmt in der Zukunft liegt – nicht nur per CSS versteckt, sondern gar nicht erst unterscheidbar von „nicht gekauft“ gerendert.

Kein Prioritäts- oder Bildfeld je Wunsch: Anders als man vom Namen „Wunschliste“ erwarten könnte, unterstützt das Datenmodell aktuell nur Name, Link und Menge pro Eintrag – keine Prioritätsstufen, keine Bilder.

Formulare werden auf der wp-Action verarbeitet (weinhold_wishlist_handle_frontend_actions(), vor dem Template-Rendering), das im Framework übliche Muster für Frontend-POST-Verarbeitung.

Versionshistorie

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

Wishlist

The Wishlist module enables shared wishlists for members of a website. The clever trick: other users can mark wishes as „purchased“ — but the list owner only sees this after a date they set themselves.

General

Managing Wishes

Every wish consists of a name, an optional link, and a quantity. Managing your own list (title, short caption, longer description, order of wishes, reveal date) happens directly in the frontend, as long as the list is still hidden.

Hidden Purchase Marking

Once another user marks a wish as „purchased“, the list owner only ever sees „Hidden until date“ until the set date is reached — regardless of the actual status. Only once the deadline passes does it become visible what was purchased and by whom. If another user has already marked a wish, further users can’t mark or unmark it — only the person who marked it can undo their own marking.

Access

Only wishlists of members of the respective website are visible (on Multisite: membership on that specific subsite; network administrators always see everything).

Shortcodes

Shortcode	Description
weinhold_wishlist	Renders the wishlist overview. Logged-in users see their own list and can view other members‘ lists

Files

modules/wishlist.php – the module’s only file: database, date/timezone helpers, frontend form processing, list and detail views, shortcode, cleanup.

For Developers

Database

Table	Columns	(selection)
weinhold_wishlists	owner_user_id, title, caption, description, reveal_at_gmt
weinhold_wishlist_items	wishlist_id, name, item_url, quantity, sort_order, purchased_by, purchased_at_gmt

Both tables use the site-local wpdb prefix; there’s no separate site_id column at the item level (only the list table has one).

Timezone Handling

reveal_at_gmt is consistently stored in UTC. weinhold_wishlist_parse_local_datetime() converts the local input from the datetime-local form field into UTC, weinhold_wishlist_get_datetime_input_value() does the reverse for re-populating the form, and weinhold_wishlist_format_local_datetime() is purely for display in the site’s timezone.

Key Functions

Function	Description
weinhold_wishlist_user_has_access($user_id,$site_id)	Checks site membership (Multisite: is_user_member_of_blog, super admins always allowed)
weinhold_wishlist_get_lists_for_site($site_id,$mode)	Lists a site’s wishlists, mode open or revealed (filtered by reveal_at_gmt)
weinhold_wishlist_render_detail($list,$user_id,$site_id)	Renders a single list including the full purchase-status visibility logic

Special Cases

Hiding is consistently server-side: the purchase status is simply never delivered to the owner while reveal_at_gmt is in the future — not just hidden via CSS, but rendered in a way that’s indistinguishable from „not purchased“ in the first place.

No priority or image field per wish: contrary to what the name „wishlist“ might suggest, the current data model only supports name, link, and quantity per entry — no priority levels, no images.

Forms are processed on the wp action (weinhold_wishlist_handle_frontend_actions(), before template rendering), the framework’s standard pattern for frontend POST processing.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

wunschliste