schachbulle / contao-twitch-bundle
Inhaltselement zum Einbinden von Twitch-Streams. Noch in der Entwicklungsphase.
Package info
github.com/Samson1964/contao-twitch-bundle
Type:contao-bundle
pkg:composer/schachbulle/contao-twitch-bundle
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ^4.13 || ^5.0
Requires (Dev)
- contao/manager-plugin: ^2.0
Suggests
None
Provides
None
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
Replaces
None
README
Stellt für Contao ein Inhaltselement bereit, das über den offiziellen Twitch-Player entweder eine Aufzeichnung oder einen Live-Kanal einbindet.
Voraussetzungen
- PHP 7.4 oder neuer (geprüft bis 8.4)
- Contao 4.13 oder Contao 5
Installation
composer require schachbulle/contao-twitch-bundle
Alternativ über den Contao Manager, dort nach schachbulle/contao-twitch-bundle
suchen.
Verwendung
Im Backend unter Artikel ein Inhaltselement der Gruppe Medien mit dem Typ Twitch anlegen.
Twitch-ID
Das Feld nimmt zweierlei entgegen und unterscheidet selbst:
| Eingabe | Bedeutung | Beispiel |
|---|---|---|
| nur Ziffern | Kennung einer Aufzeichnung | 88536246 |
| alles andere | Name eines Kanals, zeigt die Live-Übertragung | schachbulle |
Player-Optionen
| Option | Wirkung |
|---|---|
| Automatisch abspielen | Der Player startet ohne Zutun |
| Stummgeschaltet starten | Der Ton ist zu Beginn abgeschaltet |
| Den Vollbild-Schalter ausblenden | Der Player bietet kein Vollbild an |
Weitere Felder
- Player-Größe — Breite und Höhe in Pixeln; ohne Angabe 400 × 300.
- Startzeit — Sekunden ab Videobeginn. Twitch wertet den Wert nur bei Aufzeichnungen aus, bei Live-Kanälen wird er übergangen.
- Seitenverhältnis — setzt zusätzlich die Contao-Klassen
responsiveundratio-…auf den Container, etwaratio-169bei 16:9.
Der Container trägt immer die CSS-Klasse twitch.
Hinweise
- Twitch verweigert die Einbettung, wenn die im Player gemeldete
parent-Domain nicht zu der Adresse passt, unter der die Seite ausgeliefert wird. Das Bundle nimmt den Wert aus der laufenden Anfrage; hinter einem Proxy muss Contao deshalb korrekt fürtrusted_proxieseingerichtet sein. - Das Einbettungsskript
https://player.twitch.tv/js/embed/v1.jswird vom Inhaltselement selbst angemeldet und von Contao im<head>ausgegeben. - Ein eigenes Template lässt sich über das Feld Template am Element wählen;
als Vorlage dient
ce_twitch.html5. - Die Kernfelder Stoppzeit, Bildunterschrift und Vorschaubild stehen zwar in der Eingabemaske, werden vom Element aber noch nicht ausgewertet.
Lizenz
LGPL-3.0-or-later, siehe LICENSE.