discord-notifications

Discord-Benachrichtigungen

Das Discord-Benachrichtigungs-Modul verbindet das Weinhold Framework mit Discord. Neue Inhalte – ob Blogbeiträge, Highlights, Kalendertermine oder andere Modul-Events – können automatisch als Rich Embed in Discord-Kanälen erscheinen.

Allgemein

Post-Type-Webhooks

Für jeden WordPress-Post-Type (Beiträge, Seiten, eigene Post-Types) kann ein separater Webhook konfiguriert werden. Sobald ein Beitrag des jeweiligen Typs erstmalig veröffentlicht wird (nicht bei jedem erneuten Speichern eines bereits veröffentlichten Beitrags), sendet das Modul automatisch eine Benachrichtigung – optional mit Präfix-Text und Erwähnung bestimmter Discord-Rollen.

Modul-Integrationen

Andere Framework-Module registrieren sich als Modul-Integration und erhalten so einen eigenen Webhook-Slot mit individueller Nachrichtenvorlage. Aktuell integriert: Highlights, Kalender, LoL Comp Generator und weitere. Die Konfiguration erfolgt unter Weinhold → Discord-Benachrichtigungen → Modul-Integrationen.

Nachrichtenvorlagen

Jede Integration hat eine eigene Vorlage mit Platzhaltern wie {author}, {caption}, {url}, {date}. Discord-Embeds enthalten automatisch Author-Icon, Farbe, Bild (bei Medien), Timestamp und Footer.

Manuelles Senden & Testen

Über das Dashboard können auch manuell Nachrichten an konfigurierte Webhooks gesendet werden – praktisch für Ankündigungen. Ein eigener Testbereich erlaubt, einen Webhook vorab zu prüfen, ohne einen echten Beitrag veröffentlichen zu müssen.

Dateien

modules/discord_notifications.php – einzige Datei des Moduls: Einstellungen, Post-Type-Webhook-Logik, zentrale Modul-Event-Funktion, Webhook-Versand, Admin-Oberfläche (Post-Types, Modul-Integrationen, manueller Versand, Testbereich).

Für Entwickler

Ein Modul anbinden

Zwei Schritte, siehe auch docs/CLAUDE.md im Repo für ein vollständiges Beispiel: Erstens im eigenen Modul beim Filter weinhold_discord_module_integrations einen Eintrag mit label und description registrieren – das Modul erscheint danach automatisch unter Modul-Integrationen mit Feldern für Webhook-URL, Aktivierung und Nachrichtenvorlage. Zweitens beim eigentlichen Ereignis weinhold_discord_fire_module_event($module_id, $context) aufrufen, mit Kontext-Feldern wie author, avatar_url, caption, media_url, media_type, link_url, page_url, date_gmt, date_local (alle optional). Module dürfen Discord-Nachrichten ausschließlich über diese eine Funktion senden, kein eigenes wp_remote_post() im aufrufenden Modul.

Verfügbare Platzhalter (Modul-Vorlagen)

Platzhalter	Wert
{author}	Anzeigename des Nutzers
{caption}	Freitext / Hauptinhalt
{link}	Externer Link (leer wenn nicht übergeben)
{media_url}	URL zur Mediendatei
{date}	Lokal formatiertes Datum
{url}	URL zur Website-Seite
{site}	WordPress-Seitenname

Wichtige Funktionen

Funktion	Beschreibung
weinhold_discord_fire_module_event($module_id,$context)	Zentraler Einstiegspunkt für Modul-Events, prüft selbst Aktivierung und Webhook-Konfiguration
weinhold_discord_get_module_webhook($module_id)	Liefert die Webhook-Konfiguration einer Modul-Integration
weinhold_discord_resolve_module_template($template,$context)	Ersetzt Platzhalter in einer Modul-Nachrichtenvorlage
weinhold_discord_send_to_webhook($url,$content,$blocking,$allowed_mentions)	Roher Versand an einen Discord-Webhook

Besonderheiten

transition_post_status feuert nur beim ERSTEN Übergang zu publish (alter Status war nicht bereits publish) – erneutes Speichern eines schon veröffentlichten Beitrags löst keine zweite Benachrichtigung aus. Revisionen und Autosaves werden zusätzlich explizit ausgeschlossen.

Rollen-Erwähnungen bei Post-Type-Webhooks werden serverseitig als echte Discord-Mention-Syntax zusammengebaut (Rollen-ID eingebettet), zusammen mit einer passenden allowed_mentions-Angabe im Request – ohne diese würde Discord die Erwähnung als reinen Text anzeigen statt als Ping.

Zwei komplett unabhängige Versandwege existieren nebeneinander: Post-Type-Webhooks senden reinen Text (content-Feld), Modul-Integrationen senden immer als vollwertiges Discord-Embed – beide teilen sich aber dieselbe zentrale weinhold_discord_send_to_webhook()-Funktion für den eigentlichen HTTP-Request.

Versionshistorie

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

Discord Notifications

The Discord Notifications module connects the Weinhold Framework with Discord. New content — whether blog posts, highlights, calendar events, or other module events — can automatically appear as rich embeds in Discord channels.

General

Post-Type Webhooks

A separate webhook can be configured for each WordPress post type (posts, pages, custom post types). As soon as a post of that type is first published (not on every subsequent save of an already-published post), the module automatically sends a notification — optionally with prefix text and a mention of specific Discord roles.

Module Integrations

Other framework modules register as a module integration and receive their own webhook slot with an individual message template. Currently integrated: Highlights, Calendar, LoL Comp Generator, and more. Configuration is under Weinhold → Discord Notifications → Module Integrations.

Message Templates

Each integration has its own template with placeholders like {author}, {caption}, {url}, {date}. Discord embeds automatically include the author icon, color, image (for media), timestamp, and footer.

Manual Sending & Testing

Messages can also be sent manually to configured webhooks via the dashboard — useful for announcements. A dedicated test section lets you verify a webhook beforehand without publishing a real post.

Files

modules/discord_notifications.php – the module’s only file: settings, post-type webhook logic, central module event function, webhook sending, admin UI (post types, module integrations, manual send, test section).

For Developers

Hooking Up a Module

Two steps, see docs/CLAUDE.md in the repo for a full example: first, in your own module, register an entry with label and description on the weinhold_discord_module_integrations filter — the module then automatically appears under Module Integrations with fields for webhook URL, activation, and message template. Second, call weinhold_discord_fire_module_event($module_id, $context) at the actual event, with context fields like author, avatar_url, caption, media_url, media_type, link_url, page_url, date_gmt, date_local (all optional). Modules must send Discord messages exclusively through this one function — no dedicated wp_remote_post() in the calling module.

Available Placeholders (Module Templates)

Placeholder	Value
{author}	Display name of the user
{caption}	Free text / main content
{link}	External link (empty if not passed)
{media_url}	URL to the media file
{date}	Locally formatted date
{url}	URL to the website page
{site}	WordPress site name

Key Functions

Function	Description
weinhold_discord_fire_module_event($module_id,$context)	Central entry point for module events, checks activation and webhook config itself
weinhold_discord_get_module_webhook($module_id)	Returns a module integration’s webhook configuration
weinhold_discord_resolve_module_template($template,$context)	Replaces placeholders in a module message template
weinhold_discord_send_to_webhook($url,$content,$blocking,$allowed_mentions)	Raw send to a Discord webhook

Special Cases

transition_post_status only fires on the FIRST transition to publish (the old status wasn’t already publish) — re-saving an already-published post doesn’t trigger a second notification. Revisions and autosaves are also explicitly excluded.

Role mentions on post-type webhooks are assembled server-side as real Discord mention syntax (role ID embedded), together with a matching allowed_mentions field in the request — without it, Discord would display the mention as plain text instead of pinging the role.

Two completely independent sending paths exist side by side: post-type webhooks send plain text (the content field), module integrations always send as a full Discord embed — but both share the same central weinhold_discord_send_to_webhook() function for the actual HTTP request.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

10. Juni 2026

Highlights – Der Activity Feed im Weinhold Framework

Highlights

Das Highlights-Modul ist der Discord-ähnliche Activity Feed des Weinhold Frameworks. Mitglieder können Bilder, Videos und Links mit einer kurzen Caption posten – und die Community sieht es sofort im Feed.

Allgemein

Feed & Medien-Upload

Neue Posts erscheinen oben, ältere können per „Mehr laden“ nachgeladen werden (AJAX, kein Seitenreload). Bilder und Videos werden direkt beim Posten hochgeladen und in einem eigenen Verzeichnis (uploads/weinhold-highlights/) abgelegt – getrennt von der WordPress-Mediathek. Die maximale Dateigröße und Posts pro Ladevorgang sind im Dashboard konfigurierbar.

Discord-Integration

Jeder neue Highlights-Post kann automatisch eine Discord-Benachrichtigung auslösen – über das Discord-Benachrichtigungs-Modul. Webhook-URL, Aktivierungsstatus und Nachrichtenvorlage werden zentral unter Weinhold → Discord-Benachrichtigungen → Modul-Integrationen → Highlights konfiguriert.

Berechtigungen

Über das Benutzerverwaltungs-Modul lässt sich steuern, wer den Feed sehen (view) und wer neue Posts erstellen (edit) darf. Eigene Posts lassen sich zusätzlich vom Ersteller selbst löschen.

Admin-Werkzeuge

Die Admin-Seite bietet neben den Einstellungen zwei Aufräum-Funktionen: eine Medien-Verwaltung mit Vorschau aller Posts mit Datei und Lösch-Button, sowie einen Scan des Upload-Ordners auf verwaiste Dateien (Dateien ohne zugehörigen Datenbankeintrag).

Shortcodes

Shortcode	Beschreibung
weinhold_highlights	Rendert den vollständigen Highlights-Feed auf einer WordPress-Seite

Dateien

modules/highlights.php – einzige Datei des Moduls: Datenbank, Datei-Upload, Frontend-Formular-Verarbeitung, AJAX (Nachladen, Löschen), Shortcode-Rendering, Admin-Oberfläche inkl. Datei-Aufräumung.

Für Entwickler

Datenbank

Spalte	Typ	Bedeutung
site_id	bigint	Welche Site im Netzwerk
user_id	bigint	Ersteller des Posts
caption	text	Freitext des Posts
media_url,media_type	varchar	Hochgeladene Datei (URL) und Typ (image/video), beide optional
link_url	varchar	Optionaler externer Link statt/zusätzlich zu Medien
created_at	datetime	Erstellungszeitpunkt

Einstellungen (Option weinhold_highlights_settings): max_filesize in MB (Standard 20), per_page (Standard 15).

Wichtige Funktionen

Funktion	Beschreibung
weinhold_highlights_delete_post_and_file($id,$url)	Post und zugehörige Datei in einem Aufruf löschen
weinhold_highlights_delete_file_by_path($path)	Datei über Pfad löschen, mit Sicherheitsprüfung gegen das Upload-Basisverzeichnis
weinhold_highlights_get_orphaned_files()	Verwaiste Dateien im Highlights-Ordner finden (Dateien ohne DB-Eintrag)
weinhold_highlights_scan_upload_dir()	Alle Dateien im Highlights-Ordner auflisten
weinhold_highlights_current_user_can_view()/_can_post()/_can_delete($post_user_id)	Berechtigungsprüfungen, delete zusätzlich mit Eigentümer-Check

Upload-Verzeichnis

Eigenes Unterverzeichnis uploads/weinhold-highlights/ (bei Multisite-Subsites entsprechend unter uploads/sites/{id}/) über einen temporären upload_dir-Filter, der nur während des Highlights-Uploads aktiv ist. Hochgeladene Dateien werden NICHT in der WordPress-Mediathek registriert (kein wp_insert_attachment) – daher der eigene Scan für verwaiste Dateien, da WordPress-Bordmittel sie nicht kennen.

Besonderheiten

Formulare werden auf der wp-Action verarbeitet (weinhold_highlights_handle_frontend_actions(), vor dem Template-Rendering), nicht per admin-post.php – Standardmuster für Frontend-POST-Verarbeitung im Framework.

Discord-Versand läuft ausschließlich über die zentrale Funktion weinhold_discord_fire_module_event(‚highlights‘, $context) – kein eigener wp_remote_post() im Modul. Ist das Discord-Modul nicht aktiv, passiert einfach nichts (kein Fehler).

Da hochgeladene Medien nicht in der Mediathek landen, gibt es keine automatische WordPress-Aufräumung beim Löschen eines Posts über die üblichen Attachment-Hooks – weinhold_highlights_delete_post_and_file() übernimmt Datei- und Datenbanklöschung deshalb explizit gemeinsam.

Versionshistorie

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

Highlights

The Highlights module is the Discord-like activity feed of the Weinhold Framework. Members can post images, videos, and links with a short caption — and the community sees it immediately in the feed.

General

Feed & Media Upload

New posts appear at the top, older ones can be loaded via „Load more“ (AJAX, no page reload). Images and videos are uploaded directly when posting and stored in a dedicated directory (uploads/weinhold-highlights/) — separate from the WordPress media library. Maximum file size and posts per load are configurable in the dashboard.

Discord Integration

Each new highlights post can automatically trigger a Discord notification — via the Discord Notifications module. Webhook URL, activation status, and message template are configured centrally under Weinhold → Discord Notifications → Module Integrations → Highlights.

Permissions

Via the User Management module, it can be controlled who can view the feed (view) and who can create new posts (edit). Authors can additionally delete their own posts.

Admin Tools

Besides settings, the admin page offers two cleanup features: a media management view with a preview of every post that has a file and a delete button, plus a scan of the upload folder for orphaned files (files with no matching database entry).

Shortcodes

Shortcode	Description
weinhold_highlights	Renders the complete highlights feed on a WordPress page

Files

modules/highlights.php – the module’s only file: database, file upload, frontend form processing, AJAX (load more, delete), shortcode rendering, admin UI including file cleanup.

For Developers

Database

Column	Type	Meaning
site_id	bigint	Which site in the network
user_id	bigint	The post’s author
caption	text	Free text of the post
media_url,media_type	varchar	Uploaded file (URL) and type (image/video), both optional
link_url	varchar	Optional external link instead of/in addition to media
created_at	datetime	Creation timestamp

Settings (option weinhold_highlights_settings): max_filesize in MB (default 20), per_page (default 15).

Key Functions

Function	Description
weinhold_highlights_delete_post_and_file($id,$url)	Deletes a post and its associated file in one call
weinhold_highlights_delete_file_by_path($path)	Deletes a file by path, with a safety check against the upload base directory
weinhold_highlights_get_orphaned_files()	Finds orphaned files in the Highlights folder (files with no DB entry)
weinhold_highlights_scan_upload_dir()	Lists every file in the Highlights folder
weinhold_highlights_current_user_can_view()/_can_post()/_can_delete($post_user_id)	Permission checks; delete additionally checks ownership

Upload Directory

Its own subdirectory uploads/weinhold-highlights/ (on Multisite subsites, accordingly under uploads/sites/{id}/) via a temporary upload_dir filter active only during a Highlights upload. Uploaded files are NOT registered in the WordPress media library (no wp_insert_attachment) — hence the dedicated orphaned-file scan, since WordPress‘ own tools don’t know about them.

Special Cases

Forms are processed on the wp action (weinhold_highlights_handle_frontend_actions(), before template rendering), not via admin-post.php — the standard pattern for frontend POST processing across the framework.

Discord sending goes exclusively through the central function weinhold_discord_fire_module_event(‚highlights‘, $context) — no dedicated wp_remote_post() in the module. If the Discord module isn’t active, nothing happens (no error).

Since uploaded media never lands in the media library, there’s no automatic WordPress cleanup when deleting a post via the usual attachment hooks — weinhold_highlights_delete_post_and_file() therefore explicitly handles file and database deletion together.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

10. Juni 2026

Autor: Benne

discord-notifications

Discord-Benachrichtigungen

Post-Type-Webhooks

Modul-Integrationen

Nachrichtenvorlagen

Manuelles Senden & Testen

Ein Modul anbinden

Verfügbare Platzhalter (Modul-Vorlagen)

Wichtige Funktionen

Discord Notifications

Post-Type Webhooks

Module Integrations

Message Templates

Manual Sending & Testing

Hooking Up a Module

Available Placeholders (Module Templates)

Key Functions

Highlights – Der Activity Feed im Weinhold Framework

Highlights

Feed & Medien-Upload

Discord-Integration

Berechtigungen

Admin-Werkzeuge

Datenbank

Wichtige Funktionen

Upload-Verzeichnis

Highlights

Feed & Media Upload

Discord Integration

Permissions

Admin Tools

Database

Key Functions

Upload Directory