Übersicht
| Ebene | Wo konfiguriert | Gültigkeitsbereich |
|---|---|---|
| Erweiterungskonfiguration | Admin → Einstellungen → Erweiterungskonfiguration → VidPly | Gesamte TYPO3-Installation |
| Einstellungen für die Datenschutzebene | Modul „Liste“ → Einstellungen für die Datenschutzebene | Site-weite Einwilligungserklärung für externe Dienste |
| Player (Inhaltselement) | Seitenmodul → VidPly Player CE | Eine Player-Instanz auf einer Seite |
| Mediendatensatz | Listenmodul → VidPly Media | Wiederverwendbares Element (beliebiger Player/beliebige Listenansicht) |
Siehe auch „Integrations.md“ für mp-core-Website-Einstellungen, die sich auf die JSON-LD-Ausgabe auswirken.
Aktuelle Architektur
Erweiterungskonfiguration (global)
Konfiguriert unter „Admin“ → „Einstellungen“ → „Erweiterungskonfiguration“ → „mpc_vidply“ (ext_conf_template.txt):
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
allowedVideoDomains | Zeichenkette | (leer) | Whitelist für externe Video-URLs (durch Komma oder Zeilenumbruch getrennt; Platzhalter werden unterstützt) |
allowedAudioDomains | Zeichenkette | (leer) | Whitelist für externe Audio-URLs |
playIcon | Zeichenkette | (leer) | Benutzerdefiniertes Bild für die Wiedergabetaste: EXT:… Pfad, site-relativer Pfad oder HTTPS-URL |
allowedPlayIconDomains | Zeichenkette | (leer) | Whitelist für externe URLs von Wiedergabesymbolen (erforderlich bei Verwendung von HTTPS-Symbolen) |
playPosition | Auswahl | center | Position des Wiedergabe-Overlays: Mitte, Ecken |
useCssIcons | bool | 0 | CSS-basierte Symbole für die Steuerleiste verwenden (ermöglicht die Anpassung des Designs über CSS-Variablen) |
theme | Auswahl | dark | Player-Oberfläche: dark oder light |
themeSyncEnabled | bool | 0 | Player-Design mit dem Hell-/Dunkel-Modus der Seite synchronisieren (Body-Klasse + benutzerdefinierte Ereignisse) |
Diese Einstellungen gelten für jeden Frontend-Player, sofern sie nicht in Fluid/TypoScript überschrieben werden.
Einstellungen für die Datenschutzebene (tx_mpcvidply_privacy_settings)
Website-weite Einstellungen für Datenschutz-Layer externer Dienste:
| Einstellung | Typ | Beschreibung |
|---|---|---|
| Überschrift | Zeichenkette | Optionale Überschrift über dem Datenschutztext |
| Einleitungstext | Text | Text vor dem Link zur Datenschutzerklärung |
| Abschlusstext | Text | Text nach dem Link zur Datenschutzerklärung |
| Link zur Datenschutzerklärung | Zeichenkette | URL zur Seite mit der Datenschutzerklärung |
| Linktext | Zeichenkette | Text für den Link zur Datenschutzerklärung |
| Schaltflächenbeschriftung | Zeichenkette | Barrierefreie Beschriftung für die Wiedergabetaste |
Verfügbar für YouTube, Vimeo und SoundCloud. Unterstützt mehrsprachige Inhalte über sys_language_uid. Leere Felder greifen auf die Übersetzungen aus den Sprachdateien zurück.
Player-Einstellungen (tt_content)
Globale Einstellungen, die für die gesamte Player-Instanz gelten:
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| Optionen | Bitmaske | 328 | Player-Funktionen (siehe unten) |
| Lautstärke | Float | 0,8 | Anfangslautstärke (0–1) |
| Wiedergabegeschwindigkeit | Float | 1,0 | Anfangsgeschwindigkeit (0,25–2x) |
| Sprache | Zeichenkette | Auto | UI-Sprache |
Spieleroptionen (Bitmaske)
| Bit | Wert | Option | Standard |
|---|---|---|---|
| 0 | 1 | Autoplay | Aus |
| 1 | 2 | Wiederholen | Aus |
| 2 | 4 | Stummgeschaltet | Aus |
| 3 | 8 | Bedienelemente | Ein |
| 4 | 16 | Bildunterschriften Standard | Aus |
| 5 | 64 | Tastatur | Ein |
| 6 | 256 | Automatischer Zeilenvorschub | Ein |
Standard: 8 + 64 + 256 = 328
Hinweise:
- Die anpassbare Größe ist immer aktiviert (kein Umschaltknopf).
- Die Transkriptanzeige wird pro Mediendatensatz gesteuert (
tx_mpcvidply_media.enable_transcript). Die Transkript-Benutzeroberfläche ist verfügbar, wenn mindestens ein ausgewähltes Element dies zulässt.
Einstellungen für Medienelemente (tx_mpcvidply_media)
Einstellungen pro Element, die für jeden Mediendatensatz spezifisch sind:
| Einstellung | Beschreibung |
|---|---|
| Medientyp | Video, Audio, YouTube, Vimeo, SoundCloud |
| Mediendatei/URL | Quelldatei oder URL |
| Titel | Titel des Tracks |
| Slug | URL-Slug für die Weiterleitung zu den Details in der Listenansicht (wird automatisch aus dem Titel generiert) |
| Interpret | Name des Urhebers/Interpreten |
| Beschreibung | Kurztext (Listenkarten, Player) |
| Ausführliche Beschreibung | RTE-Text für die Detailseite |
| Dauer | Länge in Sekunden |
| Poster | Miniaturbild |
| Kategorien | TYPO3-Kategorien (Listenansicht-Chips + kategorienbasierte Zeilen) |
| Untertitel | WebVTT-/SRT-Untertiteldateien |
| Kapitel | WebVTT-/SRT-Kapitel-Dateien |
| Transkript aktivieren | Transkript-Flag pro Spur |
| Audiodeskription | Beschriebenes Video (MP4/WebM-Wechsel) oder VTT-Sprache über audio_description_mode |
| Audiodeskriptionsmodus | auto | swap | vtt_speech — Übertragungsweg für gesprochene Audiodeskription |
| Gebärdensprache | Video mit Gebärdensprache-Einblendung |
| Geschwindigkeitsregler ausblenden | Wiedergabegeschwindigkeitssteuerung für dieses Element ausblenden (pro Titel in Wiedergabelisten) |
| Hilfe zu Tastaturkürzeln ausblenden | Hilfe-Schaltfläche für dieses Element ausblenden (pro Titel in Wiedergabelisten) |
| Download zulassen | Download-Schaltfläche anzeigen (verwendet progressive Quelle, sofern verfügbar) |
| Schwebenden Player aktivieren | Benutzerdefiniertes, verschiebbares PiP-Fenster (nur bei Playern mit einem Titel) |
Bewährte Vorgehensweisen
Erweiterungskonfiguration (installationsweit)
Verwenden Sie diese Einstellungen für Branding und Sicherheitsstandards, die nicht pro Seite variieren sollten:
- Zulässige externe Mediendomänen
- Standard-Thema (dunkel/hell) und Synchronisierung des Seitenthemas
- Benutzerdefiniertes Wiedergabesymbol für Datenschutz-Overlay und Player
- CSS-Symbolmodus für die Integration in das Design-System
Einstellungen für die Datenschutz-Ebene (siteweit)
Verwenden Sie diese für Einstellungen, die für alle externen Dienste einheitlich sein sollen:
- Texte der Datenschutzerklärung
- Links zu Richtlinien
- Schaltflächenbeschriftungen
- Mehrsprachige Übersetzungen
Player-Ebene (global)
Verwendung für Einstellungen, die für alle Titel einheitlich sein sollen:
- Verhalten der Benutzeroberfläche (Bedienelemente, Tastatur)
- Ausgangszustand (Lautstärke, Geschwindigkeit)
- Verhalten der Wiedergabeliste (automatischer Weiterlauf)
Medienebene (pro Element)
Verwenden Sie diese Option für Einstellungen, die spezifisch für den jeweiligen Inhalt sind:
- Quelldateien/URLs und Slug
- Metadaten (Titel, Interpret, Beschreibungen, Kategorien)
- Barrierefreiheitsfunktionen (Untertitel, Kapitel, AD, Gebärdensprache)
- Visuelle Elemente (Poster)
- Einstellungsschalter pro Element (Download, schwebender Player, Geschwindigkeit/Hilfe ausblenden)
Begründung
Diese Trennung bietet:
- Konsistenz – Einheitliche Benutzererfahrung hinsichtlich des Datenschutzes bei allen externen Diensten
- Zentralisierung – Datenschutztexte werden an einem Ort verwaltet
- Mehrsprachigkeit – Datenschutzeinstellungen können für jede Sprache übersetzt werden
- Flexibilität – Individuelle Anpassung der Inhalte pro Element
- Wartbarkeit – Klare Unterscheidung zwischen siteweiten, globalen und lokalen Einstellungen
- Wiederverwendbarkeit – Medienelemente funktionieren in verschiedenen Kontexten
Zukünftige Überlegungen
Mögliche Verbesserungen:
- Standard-Beschriftung pro Element (für mehrsprachige Inhalte)
- Überschreibungen für „Loop“ und „Stummschaltung“ pro Element (einige Funktionen für Playlist-Titel sind bereits vorhanden, um die Geschwindigkeit und die Sichtbarkeit der Hilfe zu verbessern)
- Vorlagen-Überschreibungen für benutzerdefinierte Anwendungsfälle
Die aktuelle Architektur ist solide und entspricht den TYPO3-Best-Practices.