Die eigene PeerTube-Mediathek an Drupal anbinden

Wie man einen oEmbed-Provider als externe Video-Plattform erlaubt

Veröffentlichungsdatum

CMS Garden betreibt ein selbstgehostetes PeerTube als Mediathek für die eigenen Videos. Wir ziehen es vor, selbstgehostete Videos in unsere Beiträge einzubinden, um von Änderungen an den Nutzungsbedingungen Dritter unabhängig zu bleiben.

Drupals Standard-Medientyp "Externes Video" erlaubt nur Links zu YouTube und Vimeo. Deshalb verwenden wir das oEmbed-Modul, um das Standard-Bundle zu ersetzen und Videolinks aus unserem PeerTube zusätzlich zu erlauben.

Nachfolgend beschreiben wir die Konfiguration Schritt für Schritt.

Wir empfehlen dringend, diese Konfiguration im englischsprachigen Backend vorzunehmen. Möglicherweise ist es leichter, wenn ihr dazu unserer englischsprachigen Anleitung folgt und danach hier schaut, welche Übersetzungen ihr ggf. noch nachziehen wollt. Für das bessere Verständnis haben wir das Vorgehen übersetzt.

Eigenen Anbieter hinzufügen

Rufe diese URL in eurer OpenCulturas-Instanz auf: /admin/config/media/oembed-providers/custom-providers/ and klicke den Button "Add oEmbed provider"

Eingeben:

  • Name des Anbieters: PeerTube (Wichtig! Es funktioniert nur mit dem generischen Namen; "CMSG PeerTube" ginge nicht.)
  • Systemname (dieses Feld erscheint erst, wenn der Name eingetragen wird): [euer_eigenes_peertube] (Ungewöhnlich, aber ein individueller maschinenlesbarer Name funktioniert hier. Wir haben uns für "cmsg_peertube" entschieden, nur für den Fall, dass wir in Zukunft vielleicht eine weitere PeerTube-Instanz anbinden wollten.)
  • Anbieter-URL: https://tube.cms.garden
  • Endpunkt-Schema:

    https://tube.cms.garden/videos/watch/*

    https://tube.cms.garden/w/*

    (Beide mit Zeilenumbruch in das Textfeld setzen; die Pfade funktionieren für PeerTube, für andere oEmbed-Anbieter müsst ihr das selbst recherchieren)
  • Endpoint URL: https://tube.cms.garden/services/oembed (dto.)
  • Discovery: aktivieren, JSON

Speichern klicken.

Provider-Bucket

Rufe diese URL auf /admin/config/media/oembed-providers/buckets

"Remote video" bearbeiten und in der Liste zusätzlich "PeerTube" anhaken.

Ältere OpenCulturasVersionen

Falls ihr noch auf Version 1.2.x seid und diese Änderung benötigt, bevor ihr euch um das Update kümmern könnt, müsst ihr vorher noch den Provider-Bucket erstellen:

  • Bucket name: "Remote video"
  • Systemname: "video" (Wichtig: nur hiermit ersetzt ihr die Einstellungen für das Core-Bundle "Remote video")
  • Anhaken: "PeerTube", "Vimeo", "YouTube" (die letzten beiden aus Kompatibilitätsgründen, wenn ihr schon Videos auf eurer Plattform habt)

Den neuen Anbieter für Remote-Videos aktivieren

Rufe diese URL auf /admin/structure/media/manage/remote_video

und aktiviere (mindestens) die Checkbox "PeerTube" unter "Erlaubte Anbieter".

Cookie-Einstellungen aktualisieren

Stelle sicher, dass der Cookie-Service für externe Videos passende Formulierungen enthält. (Die Standardeinstellungen wissen ja nichts von dem neuen Anbieter): /admin/config/system/cookies/cookies-service/video/edit

OpenCulturas in Version 1.3.x oder höher verwendet folgende neutralere Formulierungen:

  • Label: Drittanbieter-Video
  • Service placeholder texts
    • Dieser Inhalt ist blockiert, weil keine Einwilligung für Cookies von Drittanbieter-Videos gegeben wurde.
    • Nur Video-Cookies akzeptieren

Das war's. Ihr solltet jetzt Embed-Links von eurem Peertube als "Externes Video" hinzufügen können.

Sollten Fragen offengeblieben sein oder wenn ihr uns mal zeigen wollt, wie ihr es einsetzt, kommt doch zu unserem nächsten OpenCulturas Dojo, wir würden uns freuen!

Autor:in

Stephan Luckow

Open-Source-Evangelist und Tenor