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.

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

Kommentare

Schreibe einen Kommentar

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots