Einstellungsarchitektur

Übersicht

Siehe auch „Integrationen“ 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):

Diese Einstellungen gelten für jeden Frontend-Player, sofern sie nicht in Fluid/TypoScript überschrieben werden.

Website-Einstellungen (pro Website)

Deklariert durch den mpc/mpc-vidply Website-Set (Configuration/Sets/mpc-vidply/settings.definitions.yaml). Redakteure und Integratoren ändern sie unter „Site-Verwaltung“ → „Websites“ → Ihre Website → „Einstellungen“ → „VidPly Player“ (Ansagen für Screenreader befinden sich in der Unterkategorie „Barrierefreiheit“); Integratoren können sie außerdem in config/sites/<id>/settings.yaml in TypoScript als Konstanten schreiben oder auslesen.

# config/sites/<id>/settings.yaml
mpcVidply.screenReaderAnnouncements: false
mpcVidply.resumePlayback: true
mpcVidply.embedChrome: provider

# available as TypoScript constants
{$mpcVidply.screenReaderAnnouncements}
{$mpcVidply.resumePlayback}
{$mpcVidply.embedChrome}

Das Deaktivieren der Ansagen unterdrückt die Statusmeldungen, die der Player an Hilfstechnologien sendet (WCAG 4.1.3). Tun Sie dies nur, wenn etwas anderes auf der Seite bereits denselben Status ansagt – die eigenen Hinweise des Players (Hilfedialog, Hinweise zum Ziehen und Anpassen der Größe in Gebärdensprache) werden in jedem Fall weiterhin angesagt, da sie das einzige Feedback für die Aktion sind, die sie ausgelöst hat.

Steuerelemente für YouTube und Vimeo (mpcVidply.embedChrome)

Legt fest, wer den Player für YouTube und Vimeo anzeigt, nachdem der Besucher die Datenschutzerklärung akzeptiert hat. Das Datenschutz-Overlay selbst ist in beiden Modi identisch – vor der Einwilligung werden keine Daten von YouTube oder Vimeo angefordert.

SoundCloud ist davon nicht betroffen: Es verwendet immer sein eigenes Widget (siehe „PrivacyLayer“ → „SoundCloud in den Renderer-Modus umschalten“). Die eigenen Untertitel von YouTube werden in diesem vidply Modus; fügen Sie stattdessen WebVTT-Dateien zum Mediendatensatz hinzu.

Die Einstellung wird als embedChrome Option durch PlayerOptionsBuilder. vidply lädt den VidPly-Kern auch für einzelne YouTube- und Vimeo-Elemente (siehe „AssetLoading“); provider sorgt dafür, dass diese Seiten auf dem schlankeren Pfad „nur Privacy Layer“ verbleiben.

Einstellungen für die Datenschutzebene (tx_mpcvidply_privacy_settings)

Website-weite Einstellungen für Datenschutz-Layer externer Dienste:

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:

Spieleroptionen (Bitmaske)

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 ermöglicht.

Einstellungen für Medienelemente (tx_mpcvidply_media)

Einstellungen pro Element, die für jeden Mediendatensatz spezifisch sind:

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-Design (dunkel/hell) und Synchronisierung des Seitendesigns
• Benutzerdefiniertes Wiedergabesymbol für Datenschutz-Overlay und Player
• CSS-Symbolmodus für die Integration in das Design-System

Website-Einstellungen (pro Website)

Verwendung für Richtlinien, die sich zwischen den Websites einer Installation unterscheiden:

• Ob der Player seinen Status an Screenreader meldet
• Ob Besuchern standardmäßig die Wiederaufnahme der Wiedergabe angeboten wird
• Ob YouTube- und Vimeo-Videos im VidPly-Player oder im Player des jeweiligen Anbieters abgespielt werden

Einstellungen für die Datenschutzebene (websiteweit)

Verwenden Sie diese Einstellungen für Konfigurationen, 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 (Herunterladen, 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.