Einstellungsarchitektur

Übersicht

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):

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

Website-Einstellungen (pro Website)

Festgelegt 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“ → „Barrierefreiheit“; Integratoren können sie außerdem in config/sites/<id>/settings.yaml oder als Konstanten in TypoScript auslesen.

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

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

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 (Hilfe-Dialog, Hinweise zum Ziehen und Größenanpassen in Gebärdensprache) werden in jedem Fall weiterhin gesprochen, da sie das einzige Feedback für die Aktion sind, die sie ausgelöst hat.

Einstellungen für die Datenschutzebene (tx_mpcvidply_privacy_settings)

Websiteweite Einstellungen für Datenschutz-Ebenen 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 (keine Umschaltmöglichkeit).
• Die Transkriptanzeige wird pro Mediendatensatz gesteuert (tx_mpcvidply_media.enable_transcript). Die Transkript-Benutzeroberfläche ist verfügbar, wenn mindestens ein ausgewähltes Element diese aktiviert.

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 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 Bildschirmleseprogramme meldet
• Ob Besuchern standardmäßig die Wiederaufnahme der Wiedergabe angeboten wird

Einstellungen für die Datenschutzebene (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 in allen Titeln einheitlich sein sollen:

• Verhalten der Benutzeroberfläche (Steuerelemente, 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 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 für jeden einzelnen Eintrag
• Wartbarkeit – Klare Unterscheidung zwischen siteweiten, globalen und lokalen Einstellungen
• Wiederverwendbarkeit – Medienelemente funktionieren in verschiedenen Kontexten

Zukünftige Überlegungen

Mögliche Verbesserungen:

• Standardbeschriftung pro Element (für mehrsprachige Inhalte)
• Überschreibungen für „Loop“ und „Stummschaltung“ pro Element (einiges vom Verhalten von Playlist-Titeln ist bereits vorhanden, um die Sichtbarkeit von Geschwindigkeit und Hilfe zu gewährleisten)
• Vorlagen-Überschreibungen für benutzerdefinierte Anwendungsfälle

Die aktuelle Architektur ist solide und entspricht den Best Practices von TYPO3.