Media Player

Das Media-Player-Modul bringt einen vollwertigen Audioplayer mit Playlisten-Verwaltung ins Weinhold Framework. Titel, Interpret, Cover-Bild, Download-Button, Favoriten und eigene Playlisten für eingeloggte Nutzer sind komplett integriert.

Allgemein

Playlisten verwalten

Im Dashboard unter Weinhold → Media Player werden Playlisten angelegt und Titel aus der WordPress-Mediathek hinzugefügt. Jeder Titel kann mit eigenen Metadaten (Titel, Interpret, Beschreibung, Cover-Bild) versehen werden, die die Mediathek-Angaben überschreiben. Playlisten und Titel lassen sich per Drag & Drop sortieren.

Für eingeloggte Nutzer: Favoriten & eigene Playlisten

Eingeloggte Besucher können Titel als Favorit markieren und eigene Playlisten aus dem vorhandenen Track-Angebot zusammenstellen – gespeichert pro Nutzer und pro Seite, auf der der Player eingebettet ist. Auch die zuletzt eingestellte Lautstärke wird pro Nutzer gemerkt. Der Player bietet dafür eigene Reiter: „Alle Tracks“, „Favoriten“ und „Meine Playlists“.

Gestaltung

Ein eigenes Custom-CSS-Feld im Dashboard erlaubt Anpassungen am Frontend-Design zusätzlich zur mitgelieferten Standardvorlage.

Shortcodes

Shortcode	Beschreibung
weinhold_media_player	Rendert den Player. Attribute: playlists (kommagetrennte Playlist-IDs, Standard alle), show_playlist_names (1/0), show_playlist_icons (1/0), collapsed (1/0, Liste initial eingeklappt starten)

Beispiel: nur bestimmte Playlisten und eingeklappt starten: playlists=“1,3,5″ collapsed=“1″.

Dateien

modules/media_player.php – einzige PHP-Datei des Moduls: Einstellungen, Track-Aufbereitung, AJAX-Handler für Favoriten/Lautstärke/eigene Playlisten, Shortcode-Rendering, Admin-Oberfläche, Cleanup. Frontend-Player-Logik in assets/weinhold_media_player_front.js, Admin-UI (Mediathek-Auswahl, Drag&Drop) in assets/weinhold_media_player_admin.js.

Für Entwickler

Datenhaltung

Playlisten/Tracks liegen als verschachteltes Array in der Option weinhold_media_player_settings (kein eigenes DB-Schema, Tracks referenzieren Anhänge der WordPress-Mediathek per media_id). Nutzerbezogene Daten (Favoriten, eigene Playlisten, Lautstärke) liegen als User-Meta, jeweils zusätzlich nach Blog-ID und – bei Favoriten/eigenen Playlisten – nach page_context getrennt (weinhold_media_player_get_page_context_key(): Beitrags-/Seiten-ID, sonst ein Hash der Request-URI).

AJAX-Endpunkte

Action	Zweck
weinhold_media_player_toggle_favorite	Track als Favorit markieren/entfernen
weinhold_media_player_save_volume	Lautstärke des Nutzers speichern
weinhold_media_player_save_user_playlists	Eigene Playlisten des Nutzers speichern (als JSON übergeben)

Alle drei erfordern einen eingeloggten Nutzer und einen Nonce, kein nopriv-Pendant.

Datenübergabe ans Frontend

Der komplette Player-Zustand (Tracks, Playlisten, eigene Playlisten, Favoriten, Lautstärke, Login-Status) wird als JSON im data-media-player-Attribut des Wrapper-Divs ausgegeben, nicht per wp_localize_script() – das Frontend-JS liest es direkt aus dem DOM.

Besonderheiten

Cover-Bild-Fallback: Ist für einen Track kein eigenes Cover hinterlegt, wird automatisch das Vorschaubild der Mediendatei selbst als Cover verwendet (falls vorhanden), bevor ganz auf ein Cover verzichtet wird.

Legacy-Migration bei Favoriten: Ältere Installationen speicherten Favoriten ohne page_context-Trennung. Beim ersten Zugriff auf eine noch nicht existierende page-context-spezifische Favoritenliste wird automatisch auf den alten, globalen Schlüssel zurückgegriffen und in den neuen migriert.

Cleanup entfernt Nutzer-Metadaten musterbasiert per SQL LIKE (z. B. alle weinhold_media_player_playlists_{blog_id}_*-Einträge über alle Nutzer hinweg), nicht nur die globalen Plugin-Einstellungen – wichtig, weil pro Nutzer und Seitenkontext eigene Meta-Keys entstehen, die sich nicht einzeln aufzählen lassen.

Versionshistorie

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

Media Player

The Media Player module brings a full-featured audio player with playlist management to the Weinhold Framework. Track title, artist, cover image, download button, favorites, and custom playlists for logged-in users are fully integrated.

General

Managing Playlists

Playlists are created and tracks are added from the WordPress media library in the dashboard under Weinhold → Media Player. Each track can have its own metadata (title, artist, description, cover image) that overrides the media library’s info. Playlists and tracks can be sorted via drag & drop.

For Logged-In Users: Favorites & Custom Playlists

Logged-in visitors can mark tracks as favorites and build their own playlists from the available tracks — saved per user and per page the player is embedded on. The last set volume is also remembered per user. The player provides dedicated tabs for this: „All Tracks“, „Favorites“, and „My Playlists“.

Styling

A dedicated custom CSS field in the dashboard allows adjustments to the frontend design in addition to the included default styling.

Shortcodes

Shortcode	Description
weinhold_media_player	Renders the player. Attributes: playlists (comma-separated playlist IDs, default all), show_playlist_names (1/0), show_playlist_icons (1/0), collapsed (1/0, start the list collapsed)

Example: only specific playlists, starting collapsed: playlists=“1,3,5″ collapsed=“1″.

Files

modules/media_player.php – the module’s only PHP file: settings, track preparation, AJAX handlers for favorites/volume/custom playlists, shortcode rendering, admin UI, cleanup. Frontend player logic lives in assets/weinhold_media_player_front.js, admin UI (media library picker, drag&drop) in assets/weinhold_media_player_admin.js.

For Developers

Data Storage

Playlists/tracks live as a nested array in the weinhold_media_player_settings option (no dedicated DB schema, tracks reference WordPress media library attachments via media_id). User-specific data (favorites, custom playlists, volume) live as user meta, additionally separated by blog ID and — for favorites/custom playlists — by page_context (weinhold_media_player_get_page_context_key(): post/page ID, otherwise a hash of the request URI).

AJAX Endpoints

Action	Purpose
weinhold_media_player_toggle_favorite	Mark/unmark a track as a favorite
weinhold_media_player_save_volume	Save the user’s volume
weinhold_media_player_save_user_playlists	Save the user’s custom playlists (passed as JSON)

All three require a logged-in user and a nonce, no nopriv counterpart.

Data Handoff to the Frontend

The complete player state (tracks, playlists, custom playlists, favorites, volume, login status) is output as JSON in the data-media-player attribute of the wrapper div, not via wp_localize_script() — the frontend JS reads it directly from the DOM.

Special Cases

Cover image fallback: if a track has no dedicated cover set, the media file’s own thumbnail is automatically used as the cover (if available), before falling back to no cover at all.

Legacy migration for favorites: older installations stored favorites without page_context separation. The first time a page-context-specific favorites list doesn’t exist yet, the module automatically falls back to the old global key and migrates it into the new one.

Cleanup removes user meta pattern-based via SQL LIKE (e.g. every weinhold_media_player_playlists_{blog_id}_* entry across all users), not just the global plugin settings — necessary because each user and page context creates its own meta keys that can’t be enumerated individually.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

media-player

Media Player

Playlisten verwalten

Für eingeloggte Nutzer: Favoriten & eigene Playlisten

Gestaltung

Datenhaltung

AJAX-Endpunkte

Datenübergabe ans Frontend

Media Player

Managing Playlists

For Logged-In Users: Favorites & Custom Playlists

Styling

Data Storage

AJAX Endpoints

Data Handoff to the Frontend

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots