WordPress-Plugin

Das Pellio-Plugin braucht WordPress 6.5 oder neuer und PHP 8.1 oder neuer. Es funktioniert eigenständig als Video-Player und lässt sich mit einem Pellio-Konto verbinden, um Hosting, Analysen und private Videos zu nutzen.

Ohne Konto: der Pellio-Player

Füge einen Block Pellio Video hinzu und füge einen YouTube- oder Vimeo-Link ein oder wähle ein Video aus der Mediathek. Es läuft im Pellio-Player in deinen Farben (Pellio → Settings → Player). Von YouTube oder Vimeo wird erst etwas geladen, wenn der Besucher auf Play drückt: Das Vorschaubild wird auf deiner Website gespeichert. Siehe YouTube-, Vimeo- und Mediathek-Videos.

Dein Pellio-Konto verbinden

1. Geh zu Pellio → Settings und klicke auf Connect to Pellio.
2. Melde dich an, falls nötig, prüf den Workspace und klicke auf Connect site.

Die Domain deiner Website wird zu den erlaubten Domains des Workspaces hinzugefügt, und die Website erscheint in Pellio unter Settings → General → Connected WordPress sites, wo du sie auch wieder trennen kannst. Änderst du später die Adresse deiner Website, wird die neue Domain automatisch hinzugefügt.

Pellio → Settings ist eine einzige Seite mit mehreren Abschnitten. Manche erscheinen nur, wenn sie relevant sind:

• Player: Farbe und Eckenradius, Embeds (siehe YouTube-, Vimeo- und Mediathek-Videos), Google Analytics, Viewer analytics (E-Mail-Adressen angemeldeter Nutzer an Pellio übermitteln) und Viewer watermark.
• Automations, wenn FluentCRM oder WP Fusion aktiv ist. Siehe Automationen und Analysen.
• Courses, wenn ein LMS aktiv ist: Nachweise, Fortschrittsberichte und für LearnDash, Tutor LMS und Sensei LMS die Regeln unter Lesson videos.
• Access: welche Rollen Pellio nutzen dürfen (siehe unten).
• Pellio account: die Verbindung, mit Disconnect.
• Status: prüft die Pellio-Verbindung, das Signieren von Einbettungen, die Serveruhr, die erlaubte Domain, die Content Security Policy, die REST-API sowie Caching- und Optimierungs-Plugins. Die Ergebnisse werden 10 Minuten lang zwischengespeichert; Run checks again aktualisiert sie. Dieselben Prüfungen erscheinen als ein Test unter Werkzeuge → Website-Zustand.

Das WordPress-Dashboard bekommt außerdem ein Widget Pellio: top videos (30 days).

Pellio-Videos hinzufügen

• Block-Editor: Füge einen Block Pellio Video hinzu und zieh Dateien hinein oder wähle aus deiner Bibliothek. Die Dateien werden direkt vom Browser zu Pellio hochgeladen, nicht über deinen Server, und große Uploads werden nach einer Unterbrechung fortgesetzt. Das Panel Playback des Blocks bietet Autoplay, Muted, Loop, Captions on by default und Start at (seconds). Die Blöcke Pellio Playlist und Pellio Lightbox zeigen mehrere Videos oder öffnen eines über der Seite, per Klick auf sein Vorschaubild oder einen Button.
• Klassischer Editor: Klicke über dem Editor auf Add Pellio video.
• Shortcode: [pellio id="VIDEO_ID"], optional mit title="", autoplay="1", muted="1", loop="1", captions="1", start="90" und visibility="logged-in" (oder visibility="members"). [pellio url="https://youtu.be/…"] spielt eine YouTube-, Vimeo- oder Datei-URL im Pellio-Player ab; autoplay und captions werden dabei ignoriert.
• Ein Pellio-Link: Füge einen Pellio-Freigabelink (pellio.io/v/…) in den Editor ein, und er wird zum signierten Pellio-Player – private Videos eingeschlossen.
• Page-Builder: ein Elementor-Widget, ein Bricks-Element und ein ACF-Feld. Siehe Page-Builder, SEO und Caching.

Seiten zeigen ein schlankes Vorschaubild, bis jemand auf Play drückt. Auf einer verbundenen Website enthalten Seiten mit einem bei Pellio gehosteten Video, das fertig und nicht privat ist, außerdem strukturierte VideoObject-Daten für Suchmaschinen.

Videos in WordPress verwalten

Pellio → Videos ist deine Pellio-Bibliothek in WordPress. Durchsuche sie, filtere nach Ordnern und klicke auf Upload videos oder zieh Dateien irgendwo auf die Seite. Öffne ein Video für:

• Details: Titel, Beschreibung, Who can watch (Public, Unlisted oder Private), Folder, Copy shortcode, Replace file und Move to Trash.
• Thumbnail: Upload an image, Reset to default oder Or use the frame at (m:ss) → Use this frame.
• Chapters und Captions (.vtt oder .srt).
• Analytics: Wiedergaben, Abspielrate, eindeutige Zuschauer und durchschnittlich angesehener Anteil für einen Zeitraum (Period) von 7, 30 oder 90 Tagen oder 12 Monaten, mit Zuschauerbindung, Where it was watched und Site members who watched.

Die Ansicht Trash listet gelöschte Videos 30 Tage lang auf, mit Restore.

Alle nutzen die Verbindung deiner Website, dein Team braucht also keine eigenen Pellio-Konten. Unter Pellio → Settings → Access wählst du die Rollen, die hochladen und einbetten dürfen (Can upload and embed, standardmäßig Administrator, Redakteur und Autor), und die, die die Bibliothek verwalten dürfen (Can manage the library, standardmäßig Administrator und Redakteur). Administratoren haben immer beide Rechte.

Wer zuschauen darf

Einbettungen von einer verbundenen Website werden für jeden Seitenaufruf signiert. Private und auf Domains beschränkte Videos laufen also auf deiner Website und sonst nirgends. Im Panel Access des Blocks beschränkst du ein Video auf angemeldete Nutzer oder auf Mitglieder ausgewählter Mitgliedschaften. Angemeldete Nutzer werden in deinen Analysen als Zuschauer erfasst. Ist Viewer analytics unter Pellio → Settings eingeschaltet, werden auch ihre E-Mail-Adressen übermittelt – sie erscheinen dann namentlich in den Analysen und überspringen E-Mail-Formulare.

Einbettungen migrieren

Pellio → Migration besteht aus zwei Teilen.

1. Vimeo-, Wistia- und YouTube-Einbettungen ersetzen. Scan this site durchsucht alle Beitragstypen und benutzerdefinierten Felder nach rohen iframes, Wistia-Einbettungen, -Shortcodes und reinen Links, Presto-Player-Blöcken, Media-Hub-Einträgen und [presto_player]-Shortcodes sowie Videofeldern von LifterLMS und Sensei. Es zeigt, welche Videos schon in deiner Pellio-Bibliothek sind: Importiere deine Vimeo- oder Wistia-Bibliothek also zuerst in Pellio (siehe Videos importieren). Preview changes zeigt, was sich ändern würde, und Replace embeds führt es aus. Jeder Durchlauf wird gesichert und unter Previous runs aufgeführt, mit Undo.
2. Mediathek-Videos zu Pellio verschieben. Move videos to Pellio lädt die Videodateien aus deiner Mediathek zu Pellio hoch. Setz den Haken bei Also replace Video blocks and shortcodes that use them, um auch diese Einbettungen umzustellen (gesichert und rückgängig zu machen).

YouTube-Einbettungen werden bei der Migration nicht ersetzt: Pellio kann nicht von YouTube importieren, dafür müssten die Originaldateien hochgeladen werden. Um sie stattdessen im Pellio-Player abzuspielen, schalte Use the Pellio player for YouTube and Vimeo embeds unter Pellio → Settings ein. YouTube-, Vimeo- und Mediathek-Videos von Presto Player wechseln sofort in den Pellio-Player; seine Bunny.net-Videos, sobald sie importiert sind.

WP-CLI

wp pellio status                        # connection and migration summary
wp pellio scan [--format=table|json]    # embeds found, and which are in Pellio
wp pellio migrate --dry-run             # what would change
wp pellio migrate                       # replace embeds (backed up)
wp pellio rollback [run-id]             # undo a run; without an id, the latest
wp pellio offload [--limit=<n>] [--replace]   # move Media Library videos to Pellio
wp pellio evidence COURSE_ID > evidence.csv   # a course’s watch evidence

Die Run-IDs findest du unter Previous runs auf der Seite Pellio → Migration.

Für Entwickler

• pellio_capability filtert die Berechtigung, die zum Hochladen und Einbetten bzw. zum Verwalten der Bibliothek nötig ist.
• pellio_embed_atts filtert die Attribute einer Einbettung (Video, Autoplay, Start und so weiter), bevor sie ausgegeben wird.
• pellio_video( $id, $atts ) gibt das Player-HTML für Templates zurück.

Deinstallieren

Beim Löschen des Plugins werden seine Einstellungen, Caches und geplanten Aufgaben entfernt. Außerdem entfernt es, was es in WordPress über Lernende gespeichert hat: verifizierte Wiedergaben, Bestätigungen, Kursabschluss-Markierungen und Automationsdatensätze. Nach einer Neuinstallation sind die Spalten Watch verified, Attested und Signed as der Nachweis-CSV für frühere Lernende leer; das Lernprotokoll in Pellio behält alles. Beiträge behalten ihre Pellio-Blöcke und -Shortcodes, und die Migrationssicherungen bleiben erhalten, damit sich eine Migration auch nach einer Neuinstallation rückgängig machen lässt.