custom-header

Custom Header

Das Custom-Header-Modul ermöglicht die Erstellung eines vollwertigen Headers mit Navigationsbuttons und frei definierbarem HTML – komplett über das Admin-Dashboard, ohne Theme-Anpassungen. Den Header, den du gerade auf weinify.de siehst, wurde mit diesem Modul gebaut.

Allgemein

Buttons & Drag and Drop

Buttons werden über den Platzhalter –buttons– an einer beliebigen Stelle im Header-Inhalt eingefügt. Die Reihenfolge lässt sich per Drag & Drop anpassen. Buttons können Sub-Buttons enthalten, die beim Hover ein Dropdown-Menü öffnen. Pro Button lässt sich außerdem die Sichtbarkeit festlegen: immer, nur für eingeloggte oder nur für ausgeloggte Besucher.

Login-Navigation per Platzhalter

Zusätzlich zu –buttons– gibt es den Platzhalter –auth–, der an dieser Stelle die Login/Profil-Navigation des Benutzerverwaltung-Moduls einfügt (identisch zum Shortcode weinhold_auth_nav). Nur im Header verfügbar, nicht im Footer.

Pro Site, kein Shortcode

Jede Subsite konfiguriert ihren eigenen Header unabhängig. Inhalt, Buttons und Styling sind vollständig voneinander getrennt – dkj.weinify.de kann einen völlig anderen Header haben als weinify.de. Der Header wird automatisch in jede Seite der jeweiligen Subsite eingebunden, sobald er im Dashboard konfiguriert und aktiviert wurde. Kein Shortcode nötig.

Social-Vorschau

Unter den Header-Einstellungen gibt es einen eigenen Abschnitt „Social-Vorschau“. Er legt fest, welches Bild, welchen Titel und welche Beschreibung Discord, WhatsApp, Signal & Co. anzeigen, wenn ein Link zur Subsite geteilt wird (Open Graph und Twitter Card im Seitenkopf). Das Bild wird aus der Mediathek gewählt, empfohlen sind 1200 × 630 Pixel. Unterseiten verwenden ihren eigenen Titel, ein gesetztes Beitragsbild und einen bewusst geschriebenen Auszug. Ohne eigene Angaben greifen Titel, Untertitel und Website-Icon der Subsite. Optional wird die Beschreibung zusätzlich als Meta-Beschreibung für Suchmaschinen ausgegeben.

Dateien

modules/custom_header.php – Modul-Datei (Init, Admin-Seite, Cleanup) und die komplette Social-Vorschau (nur Header). Die Header-Ausgabe selbst delegiert sie an das gemeinsam mit Custom Footer genutzte includes/weinhold_custom_layout_helpers.php.

Für Entwickler

Gemeinsamer Unterbau mit Custom Footer

Header und Footer sind keine zwei getrennten Implementierungen, sondern dieselbe Logik in includes/weinhold_custom_layout_helpers.php, parametrisiert über $layout (‚header‘ oder ‚footer‘). weinhold_custom_layout_get_config($layout) liefert dazu Hook-Name (wp_head bzw. wp_footer), HTML-Tag, ob der –auth—Platzhalter unterstützt wird (nur Header) und die Öffnungsrichtung der Sub-Button-Menüs.

Speicherung (Optionen pro Site)

Option	Inhalt
weinhold_custom_header_enabled	Ob der Header aktiv ausgegeben wird
weinhold_custom_header_html	Der HTML-Inhalt mit den Platzhaltern –buttons– / –auth–
weinhold_custom_header_links	Array der Buttons (Beschriftung, Ziel-URL, übergeordneter Button für Sub-Buttons, Sichtbarkeit)
weinhold_custom_header_social_settings	Social-Vorschau: enabled, image_id, title, description, prefer_featured, output_description

Beim Footer entsprechend mit dem Präfix weinhold_custom_footer_* (ohne Social-Vorschau).

Wichtige Funktionen

Funktion	Beschreibung
weinhold_custom_layout_init($layout)	Hängt den Render-Callback an wp_head bzw. wp_footer, baut das Button-HTML inkl. Sub-Buttons zusammen
weinhold_custom_layout_resolve_link_url($value)	Löst Spezial-Tokens in Button-Zielen auf (z. B. Links auf Auth-Seiten)
weinhold_custom_layout_sanitize_html($html)	Bereinigt gespeichertes HTML über eine eigene, erweiterte Erlaubnisliste (weinhold_custom_layout_allowed_html())
weinhold_custom_layout_get_button_visibility_class($link)	Übersetzt die Sichtbarkeitseinstellung eines Buttons in die CSS-Klasse weinhold-show-on-login bzw. weinhold-show-on-logout
weinhold_custom_header_render_social_preview()	Gibt die Open-Graph- und Twitter-Card-Angaben an wp_head (Priorität 5) aus
weinhold_custom_header_social_get_meta($settings)	Ermittelt Titel, Beschreibung, URL und Typ der aktuellen Seite
weinhold_custom_header_social_get_image($settings)	Wählt Beitragsbild, Standardbild oder Website-Icon samt Größe

Die Sichtbarkeitsklassen greifen auf dieselbe CSS-Logik zurück, die auch die Shortcodes weinhold_show_on_login/weinhold_show_on_logout des Benutzerverwaltung-Moduls nutzen (weinhold_user_management_render_visibility_css()).

Besonderheiten

Wird auf Auth-Seiten (Login, Registrierung, Profil, Passwort-vergessen) automatisch unterdrückt – weinhold_user_management_is_auth_page() prüft das vor jeder Ausgabe, damit der eigene Header/Footer die dortigen Formulare nicht stört.

Rückwärtskompatibel gespeicherte Buttons: ältere Buttons ohne das neue visibility-Feld werden über das frühere boolesche Feld login_only interpretiert, statt beim Update verloren zu gehen.

Freies HTML ohne Whitelisting von Grund auf – erlaubt sind bewusst mehr Tags/Attribute als WordPress‘ Standard-Editor zulässt (eigene erweiterte Erlaubnisliste), damit auch komplexere Layout-Strukturen im Header/Footer möglich sind.

Die Social-Vorschau hat einen eigenen Schalter (standardmäßig aus) und wirkt unabhängig davon, ob der Header angezeigt wird, auch auf Auth-Seiten. Ist ein SEO-Plugin aktiv (Yoast, Rank Math, AIOSEO, SEOPress, The SEO Framework), gibt sie nichts aus, damit keine doppelten Angaben entstehen. Die Beschreibung von Unterseiten stammt nur aus einem gesetzten Auszug, nie aus dem gekürzten Inhalt, weil der Shortcodes oder geschützte Texte enthalten kann.

Versionshistorie

Version	Datum	Änderung
1.0.1	28.10.2026	Social-Vorschau (Open Graph, Twitter Card) mit Bild aus der Mediathek, Titel und Beschreibung.
1.0.0	22.09.2026	Einführung der Versionierung.

Custom Header

The Custom Header module enables building a full header with navigation buttons and freely definable HTML — entirely through the admin dashboard, without theme modifications. The header you currently see on weinify.de was built with this module.

General

Buttons & Drag and Drop

Buttons are inserted via the –buttons– placeholder at any position in the header content. Order can be adjusted via drag & drop. Buttons can contain sub-buttons that open a dropdown menu on hover. Each button can also have its own visibility: always, only for logged-in visitors, or only for logged-out visitors.

Login Navigation via Placeholder

In addition to –buttons–, there’s the –auth– placeholder, which inserts the User Management module’s login/profile navigation at that spot (identical to the weinhold_auth_nav shortcode). Available only in the header, not the footer.

Per Site, No Shortcode

Each subsite configures its own header independently. Content, buttons and styling are completely separate — dkj.weinify.de can have a completely different header than weinify.de. The header is automatically embedded into every page of the respective subsite once configured and enabled in the dashboard. No shortcode needed.

Social Preview

Below the header settings there is a separate „Social preview“ section. It defines which image, title and description Discord, WhatsApp, Signal & co. show when a link to the subsite is shared (Open Graph and Twitter Card in the page head). The image is picked from the media library, 1200 × 630 pixels are recommended. Subpages use their own title, a set featured image and a deliberately written excerpt. Without custom values, the subsite’s title, tagline and site icon are used. Optionally, the description is also output as a meta description for search engines.

Files

modules/custom_header.php – module file (init, admin page, cleanup) and the complete social preview (header only). The header output itself is delegated to includes/weinhold_custom_layout_helpers.php, shared with Custom Footer.

For Developers

Shared Foundation with Custom Footer

Header and footer aren’t two separate implementations but the same logic in includes/weinhold_custom_layout_helpers.php, parameterized via $layout (‚header‘ or ‚footer‘). weinhold_custom_layout_get_config($layout) provides the hook name (wp_head or wp_footer), the HTML tag, whether the –auth– placeholder is supported (header only), and which direction sub-button menus open.

Storage (Per-Site Options)

Option	Content
weinhold_custom_header_enabled	Whether the header is actively output
weinhold_custom_header_html	The HTML content with the –buttons– / –auth– placeholders
weinhold_custom_header_links	Array of buttons (label, target URL, parent button for sub-buttons, visibility)
weinhold_custom_header_social_settings	Social preview: enabled, image_id, title, description, prefer_featured, output_description

For the footer, the same with the weinhold_custom_footer_* prefix (without social preview).

Key Functions

Function	Description
weinhold_custom_layout_init($layout)	Hooks the render callback into wp_head or wp_footer, assembles the button HTML including sub-buttons
weinhold_custom_layout_resolve_link_url($value)	Resolves special tokens in button targets (e.g. links to auth pages)
weinhold_custom_layout_sanitize_html($html)	Cleans stored HTML using its own extended allowlist (weinhold_custom_layout_allowed_html())
weinhold_custom_layout_get_button_visibility_class($link)	Translates a button’s visibility setting into the weinhold-show-on-login or weinhold-show-on-logout CSS class
weinhold_custom_header_render_social_preview()	Outputs the Open Graph and Twitter Card tags on wp_head (priority 5)
weinhold_custom_header_social_get_meta($settings)	Determines title, description, URL and type of the current page
weinhold_custom_header_social_get_image($settings)	Picks featured image, default image or site icon including its size

The visibility classes rely on the same CSS logic used by the User Management module’s weinhold_show_on_login/weinhold_show_on_logout shortcodes (weinhold_user_management_render_visibility_css()).

Special Cases

Automatically suppressed on auth pages (login, registration, profile, lost password) — weinhold_user_management_is_auth_page() checks this before every output, so the custom header/footer doesn’t interfere with the forms there.

Backwards-compatible stored buttons: older buttons without the newer visibility field are interpreted via the earlier boolean login_only field instead of being lost on update.

Free-form HTML without whitelisting from scratch — deliberately allows more tags/attributes than WordPress‘ standard editor (its own extended allowlist), so more complex layout structures are possible in the header/footer.

The social preview has its own switch (off by default) and works independently of whether the header is shown, including on auth pages. If an SEO plugin is active (Yoast, Rank Math, AIOSEO, SEOPress, The SEO Framework), it outputs nothing to avoid duplicate tags. The description of subpages only comes from a set excerpt, never from shortened content, since that may contain shortcodes or protected text.

Version History

Version	Date	Change
1.0.1	28.10.2026	Social preview (Open Graph, Twitter Card) with image from the media library, title and description.
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

Schlagwort: 🏠

custom-header

Custom Header

Buttons & Drag and Drop

Login-Navigation per Platzhalter

Pro Site, kein Shortcode

Social-Vorschau

Gemeinsamer Unterbau mit Custom Footer

Speicherung (Optionen pro Site)

Wichtige Funktionen

Custom Header

Buttons & Drag and Drop

Login Navigation via Placeholder

Per Site, No Shortcode

Social Preview

Shared Foundation with Custom Footer

Storage (Per-Site Options)

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