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.

discord-notifications