Kalender

Das Kalender-Modul bringt einen netzwerkweiten Terminplaner ins Weinhold Framework. Termine werden zentral gespeichert und können von eingeloggten Nutzern erstellt, bearbeitet und geteilt werden – optional auch öffentlich für alle Besucher. Auf weinify.de/kalender ist das Modul live im Einsatz.

Allgemein

Sichtbarkeit von Terminen

Beim Erstellen wählt man zwischen drei Stufen: Netzwerk (alle eingeloggten Nutzer können den Termin sehen), Privat (nur Ersteller und eingeladene Nutzer haben Zugriff) und Öffentlich (jeder kann den Termin sehen, auch ohne Login – erfordert eine eigene, separat vergebene Berechtigung). Jeder Termin kann außerdem einen optionalen externen Link tragen.

E-Mail-Erinnerungen

Pro Termin kann eine E-Mail-Erinnerung aktiviert werden. In den persönlichen Einstellungen legt jeder Nutzer fest, wie viele Tage vorher die Erinnerung gesendet werden soll (0 = am selben Tag, -1 = deaktiviert). Der Versand läuft täglich automatisch per Cronjob, wahlweise über WP-Cron oder einen externen Server-Cron (Einstellung pro Modul, wie im gesamten Framework üblich).

Farbkodierung & Herkunft

Jeder Nutzer kann pro Webseite eine eigene Farbe für die Terminanzeige konfigurieren. Bei der Termin-Erstellung wird außerdem die Herkunft (welche Subsite) zugeordnet – so behalten Mitglieder mehrerer Sites den Überblick.

Navigation

Ein Kalender-Link wird automatisch in die Navigation des Benutzerverwaltung-Moduls (weinhold_auth_nav) eingehängt.

Shortcodes

Shortcode	Beschreibung
weinhold_calendar	Persönlicher Kalender (nur eingeloggte Nutzer): zeigt alle Termine netzwerkweit, die der Nutzer sehen darf. Beim Aktivieren des Moduls wird automatisch eine Seite unter /kalender mit diesem Shortcode erstellt
weinhold_public_calendar	Öffentlicher Kalender der aktuellen Webseite: nicht eingeloggte Besucher sehen nur öffentliche Termine, eingeloggte Nutzer alle Termine dieser Webseite

Dateien

modules/calendar.php – einzige Datei des Moduls: Datenbank inkl. versionierter Migrationen, Termin-/Farbverwaltung, Erinnerungs-Cronjob, Frontend-Formularverarbeitung, beide Shortcodes, Admin-Seite, Cleanup.

Für Entwickler

Datenbank

Tabelle	Spalten	(Auswahl)
weinhold_calendar_events	site_id, creator_user_id, caption, description, event_link, visibility	(0 Netzwerk/1 Privat/2 Öffentlich), event_dt_gmt
weinhold_calendar_event_users	event_id, user_id, wants_reminder, reminder_sent_at_gmt
weinhold_calendar_user_settings	user_id, reminder_days
weinhold_calendar_site_colors	user_id, site_id, color

Versionierte Migration bis DB-Version 3: v2 auf v3 benennt is_private in visibility um (aus bool wird dreiwertig), fügt event_link hinzu und wants_reminder in der Teilnehmer-Tabelle.

Eigene Berechtigung für öffentliche Termine

Über den Filter weinhold_registered_capabilities registriert das Modul die zusätzliche Capability weinhold_calendar_create_public_event – eine eigene, feinere Berechtigung oberhalb der normalen Modul-Edit-Rechte, weil ein öffentlicher Termin auch ohne Login sichtbar ist und damit sensibler ist als ein normaler Netzwerk-Termin.

E-Mail-Template & Cron

Registriert das Template calendar_reminder beim E-Mail-Versand-Modul (Platzhalter display_name, count, when, events) und nutzt es über weinhold_send_module_mail() für den täglichen Erinnerungsversand. Der tägliche Cron-Job wird ausschließlich auf der Hauptsite eingerichtet (Modul-Scope: network) und respektiert den zentralen Cron-Modus-Schalter (weinhold_cron_mode_is_extern(‚calendar‘)) – bei externem Cron übernimmt WP-Cron das Scheduling nicht selbst.

Besonderheiten

Trotz Modul-Scope network sind Termine site_id-getaggt und Farben pro Nutzer UND Site konfigurierbar – „netzwerkweit“ bedeutet hier, dass ein Nutzer die Termine ALLER Sites in einem gemeinsamen persönlichen Kalender sieht, nicht dass es nur einen einzigen, undifferenzierten Termin-Pool ohne Site-Bezug gibt.

Die Migration von is_private (boolesch) zu visibility (dreiwertig) zeigt, dass „Öffentlich“ nachträglich als dritte Sichtbarkeitsstufe hinzugefügt wurde – ältere, per Datenbank-Upgrade migrierte Installationen haben dieselbe Spalte nur unter neuem Namen und mit erweitertem Wertebereich.

Die Berechtigung für öffentliche Termine läuft über eine eigene Capability statt über das generische Modul-Edit-Recht – wer Termine bearbeiten darf, darf noch lange keine öffentlichen, nicht-login-pflichtigen Termine erstellen.

Versionshistorie

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

Calendar

The Calendar module brings a network-wide event planner to the Weinhold Framework. Events are stored centrally and can be created, managed, and shared by logged-in users — optionally also publicly. The module is live at weinify.de/kalender.

General

Event Visibility

Three visibility levels are available when creating an event: Network (all logged-in users can see the event), Private (only the creator and invited users have access), and Public (everyone can see the event, even without login — requires its own, separately granted permission). Every event can also carry an optional external link.

Email Reminders

An email reminder can be activated per event. In personal settings, each user sets how many days in advance the reminder should be sent (0 = same day, -1 = disabled). Sending runs automatically daily via a cron job, either via WP-Cron or an external server cron (a per-module setting, as is standard across the framework).

Color Coding & Origin

Each user can configure a custom color per website for the event display. When creating an event, the origin (which subsite) is also assigned — helping members of multiple sites keep track.

Navigation

A calendar link is automatically inserted into the User Management module’s navigation (weinhold_auth_nav).

Shortcodes

Shortcode	Description
weinhold_calendar	Personal calendar (logged-in users only): shows all network-wide events the user has access to. When the module is activated, a page at /kalender with this shortcode is created automatically
weinhold_public_calendar	Public calendar of the current website: logged-out visitors only see public events, logged-in users see all events of this website

Files

modules/calendar.php – the module’s only file: database including versioned migrations, event/color management, reminder cron job, frontend form processing, both shortcodes, admin page, cleanup.

For Developers

Database

Table	Columns	(selection)
weinhold_calendar_events	site_id, creator_user_id, caption, description, event_link, visibility	(0 network/1 private/2 public), event_dt_gmt
weinhold_calendar_event_users	event_id, user_id, wants_reminder, reminder_sent_at_gmt
weinhold_calendar_user_settings	user_id, reminder_days
weinhold_calendar_site_colors	user_id, site_id, color

Versioned migration up to DB version 3: v2 to v3 renames is_private to visibility (boolean becomes three-valued), adds event_link, and adds wants_reminder to the participants table.

Dedicated Capability for Public Events

Via the weinhold_registered_capabilities filter, the module registers the additional capability weinhold_calendar_create_public_event — a separate, finer-grained permission above the normal module edit right, since a public event is visible even without login and is therefore more sensitive than a regular network event.

Email Template & Cron

Registers the calendar_reminder template with the Email Delivery module (placeholders display_name, count, when, events) and uses it via weinhold_send_module_mail() for the daily reminder send. The daily cron job is set up exclusively on the main site (module scope: network) and respects the central cron mode switch (weinhold_cron_mode_is_extern(‚calendar‘)) — with external cron enabled, WP-Cron doesn’t handle the scheduling itself.

Special Cases

Despite the module scope being network, events are tagged with site_id and colors are configurable per user AND per site — „network-wide“ here means a user sees events from ALL sites in one shared personal calendar, not that there’s a single, undifferentiated event pool with no site association.

The migration from is_private (boolean) to visibility (three-valued) shows that „Public“ was added later as a third visibility level — older installations migrated via the database upgrade have the same column, just under a new name and with an expanded value range.

Permission for public events runs through a dedicated capability rather than the generic module edit right — being allowed to edit events doesn’t automatically mean being allowed to create public events that don’t require login.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

kalender

Kalender

Sichtbarkeit von Terminen

E-Mail-Erinnerungen

Farbkodierung & Herkunft

Navigation

Datenbank

Eigene Berechtigung für öffentliche Termine

E-Mail-Template & Cron

Calendar

Event Visibility

Email Reminders

Color Coding & Origin

Navigation

Database

Dedicated Capability for Public Events

Email Template & Cron

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots