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.

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

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots