Analyse

Das Analyse-Modul bietet einen dedizierten Bereich für Match-Analysen mit Video- und Texteinträgen. Eingeloggte Nutzer können Analysen erstellen, bearbeiten, als Favorit markieren und kommentieren.

Allgemein

Video- & Text-Einträge

Jede Analyse hat einen Titel und wahlweise einen Video-Link oder einen ausführlichen Textinhalt. Video-Links werden automatisch eingebettet: unterstützt werden YouTube (inkl. Shorts), Twitch-VODs und Twitch-Clips. Für YouTube wird zusätzlich automatisch ein Vorschaubild aus dem Video gezogen.

Favoriten & Kommentare

Einträge lassen sich als Favorit markieren und in der Übersicht danach filtern. Die Kommentarfunktion erlaubt den direkten Austausch zu einzelnen Einträgen. Kombiniert mit dem Reactions-Modul lassen sich Kommentare zusätzlich mit Likes/Dislikes bewerten.

Berechtigungen

Über das Benutzerverwaltungs-Modul lässt sich genau steuern, wer Analysen lesen (view) und wer sie erstellen oder bearbeiten (edit) darf – unabhängig pro Subsite. Beide Berechtigungen setzen zusätzlich einen eingeloggten Nutzer voraus, auch für reines Lesen gibt es keinen Gastzugang.

Shortcodes

Shortcode	Beschreibung
weinhold_analyse	Rendert den vollständigen Analyse-Bereich mit Übersicht, Such- und Favoriten-Filter sowie Detail-/Bearbeiten-Ansichten

Dateien

modules/analyse.php – einzige Datei des Moduls: Datenbank, Einbettungs-Erkennung, Frontend-Formularverarbeitung, Übersichts-/Detail-/Bearbeiten-Ansichten, Shortcode, Admin-Seite, Cleanup.

Für Entwickler

Datenbank

Tabelle	Spalten	(Auswahl)
weinhold_analyse_entries	creator_user_id, caption, description, video_url, content_type, site_id
weinhold_analyse_comments	entry_id, user_id, comment_text
weinhold_analyse_favorites	entry_id, user_id	(Unique je Kombination)

Versionierte Migration: DB-Version 1 zu 2 fügt nachträglich die Spalte content_type sowie die komplette Favoriten-Tabelle hinzu (weinhold_analyse_maybe_install() prüft den gespeicherten Versionsstand und wendet nur die fehlenden Schritte an).

Video-Einbettung erkennen

weinhold_analyse_get_embed_url($url) erkennt per regulärem Ausdruck YouTube-Videos (inkl. Shorts), Twitch-VODs und Twitch-Clips und baut daraus die passende iframe-Embed-URL, inklusive korrektem parent-Parameter für Twitch (aus der aktuellen Domain abgeleitet). weinhold_analyse_get_thumbnail_url($url) liefert zusätzlich ein Vorschaubild, aktuell nur für YouTube implementiert.

Wichtige Funktionen

Funktion	Beschreibung
weinhold_analyse_get_entries($site_id,$search,$offset,$per_page,$only_favorites,$user_id)	Gefilterte, paginierte Liste der Einträge
weinhold_analyse_is_favorited($entry_id,$user_id)	Ob ein Nutzer einen Eintrag favorisiert hat
weinhold_analyse_current_user_can()/_can_edit()	Berechtigungsprüfungen, beide verlangen zusätzlich einen eingeloggten Nutzer

Besonderheiten

Twitch-Embeds benötigen zwingend den korrekten parent-Parameter (die eigene Domain) – ohne ihn verweigert Twitch die Einbettung im iframe. Das Modul leitet ihn automatisch aus home_url() ab, keine manuelle Konfiguration nötig.

Rich-Text-Editor wird gezielt erzwungen: An zwei Stellen im Bearbeiten-Formular wird der Filter user_can_richedit kurzzeitig mit hoher Priorität auf wahr gesetzt, damit der volle WordPress-Editor auch für Nutzer ohne die sonst dafür nötige Berechtigung zur Verfügung steht.

Content-Type als einfaches Integer-Flag: content_type unterscheidet Video- von Text-Einträgen als tinyint statt als beschreibender String – bei Erweiterung um weitere Inhaltstypen wäre eine Umstellung auf lesbare Werte sinnvoll.

Versionshistorie

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

Analysis

The Analysis module provides a dedicated area for match analyses with video and text entries. Logged-in users can create, edit, favorite, and comment on analyses.

General

Video & Text Entries

Every analysis has a title and either a video link or a longer text body. Video links are embedded automatically: YouTube (including Shorts), Twitch VODs, and Twitch clips are supported. For YouTube, a thumbnail is also pulled from the video automatically.

Favorites & Comments

Entries can be marked as favorites and filtered by that in the overview. The comment feature allows direct discussion on individual entries. Combined with the Reactions module, comments can additionally be rated with likes/dislikes.

Permissions

Via the User Management module, it can be precisely controlled who can read analyses (view) and who can create or edit them (edit) — independently per subsite. Both permissions additionally require a logged-in user; there’s no guest access even for plain reading.

Shortcodes

Shortcode	Description
weinhold_analyse	Renders the complete analysis area with overview, search and favorites filter, plus detail/edit views

Files

modules/analyse.php – the module’s only file: database, embed detection, frontend form processing, overview/detail/edit views, shortcode, admin page, cleanup.

For Developers

Database

Table	Columns	(selection)
weinhold_analyse_entries	creator_user_id, caption, description, video_url, content_type, site_id
weinhold_analyse_comments	entry_id, user_id, comment_text
weinhold_analyse_favorites	entry_id, user_id	(unique per combination)

Versioned migration: DB version 1 to 2 retroactively adds the content_type column plus the entire favorites table (weinhold_analyse_maybe_install() checks the stored version and only applies the missing steps).

Detecting Video Embeds

weinhold_analyse_get_embed_url($url) uses a regular expression to recognize YouTube videos (including Shorts), Twitch VODs, and Twitch clips, building the matching iframe embed URL, including the correct parent parameter for Twitch (derived from the current domain). weinhold_analyse_get_thumbnail_url($url) additionally provides a thumbnail, currently only implemented for YouTube.

Key Functions

Function	Description
weinhold_analyse_get_entries($site_id,$search,$offset,$per_page,$only_favorites,$user_id)	Filtered, paginated list of entries
weinhold_analyse_is_favorited($entry_id,$user_id)	Whether a user has favorited an entry
weinhold_analyse_current_user_can()/_can_edit()	Permission checks, both additionally require a logged-in user

Special Cases

Twitch embeds strictly require the correct parent parameter (your own domain) — without it, Twitch refuses the iframe embed. The module derives it automatically from home_url(), no manual configuration needed.

The rich text editor is deliberately forced: at two points in the edit form, the user_can_richedit filter is briefly set to true at high priority, so the full WordPress editor is available even to users without the permission normally required for it.

Content type as a plain integer flag: content_type distinguishes video from text entries as a tinyint rather than a descriptive string — if more content types are added later, switching to readable values would make sense.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

analyse