Extension WordPress

L’extension Pellio nécessite WordPress 6.5 ou plus récent et PHP 8.1 ou plus récent. Elle fonctionne seule comme lecteur vidéo, et se connecte à un compte Pellio pour l’hébergement, les statistiques et les vidéos privées.

Sans compte : le lecteur Pellio

Ajoutez un bloc Pellio Video et collez un lien YouTube ou Vimeo, ou choisissez une vidéo dans la médiathèque. Elle est lue dans le lecteur Pellio, à vos couleurs (Pellio → Settings → Player). Rien n’est chargé depuis YouTube ou Vimeo tant que le visiteur n’a pas appuyé sur lecture : la miniature est enregistrée sur votre site. Voir Vidéos YouTube, Vimeo et de la médiathèque.

Connecter votre compte Pellio

1. Allez dans Pellio → Settings et cliquez sur Connect to Pellio.
2. Connectez-vous si nécessaire, vérifiez l’espace de travail et cliquez sur Connect site.

Le domaine de votre site est ajouté aux domaines autorisés de l’espace de travail, et le site apparaît dans Pellio sous Settings → General → Connected WordPress sites, où vous pouvez le déconnecter. Si l’adresse de votre site change plus tard, le nouveau domaine est ajouté automatiquement.

Pellio → Settings tient sur une seule page, divisée en sections. Certaines n’apparaissent que lorsqu’elles sont utiles :

• Player : couleur et arrondi des angles, Embeds (voir Vidéos YouTube, Vimeo et de la médiathèque), Google Analytics, Viewer analytics (transmettre à Pellio l’adresse e-mail des utilisateurs connectés) et Viewer watermark (filigrane spectateur).
• Automations, quand FluentCRM ou WP Fusion est actif. Voir Automatisations et statistiques.
• Courses, quand un LMS est actif : preuves de visionnage, rapports de progression et, pour LearnDash, Tutor LMS et Sensei LMS, les règles Lesson videos.
• Access : les rôles qui peuvent utiliser Pellio (voir plus bas).
• Pellio account : la connexion, avec Disconnect.
• Status : vérifie la connexion à Pellio, la signature des intégrations, l’horloge du serveur, le domaine autorisé, la Content Security Policy, l’API REST, ainsi que les extensions de cache et d’optimisation. Les résultats sont conservés 10 minutes ; Run checks again les actualise. Les mêmes vérifications apparaissent sous forme d’un test dans Outils → Santé du site.

Le tableau de bord WordPress reçoit aussi un widget Pellio: top videos (30 days).

Ajouter des vidéos Pellio

• Éditeur de blocs : ajoutez un bloc Pellio Video, puis déposez-y des fichiers ou choisissez dans votre bibliothèque. Les fichiers partent directement du navigateur vers Pellio, sans passer par votre serveur, et les gros envois reprennent s’ils sont interrompus. Le panneau Playback du bloc propose Autoplay, Muted, Loop, Captions on by default et Start at (seconds). Les blocs Pellio Playlist et Pellio Lightbox affichent plusieurs vidéos, ou en ouvrent une par-dessus la page depuis sa miniature ou un bouton.
• Éditeur classique : cliquez sur Add Pellio video au-dessus de l’éditeur.
• Shortcode : [pellio id="VIDEO_ID"], avec en option title="", autoplay="1", muted="1", loop="1", captions="1", start="90" et visibility="logged-in" (ou visibility="members"). [pellio url="https://youtu.be/…"] lit une URL YouTube, Vimeo ou de fichier dans le lecteur Pellio ; il ignore autoplay et captions.
• Un lien Pellio : collez un lien de partage Pellio (pellio.io/v/…) dans l’éditeur et il devient le lecteur Pellio signé, vidéos privées comprises.
• Constructeurs de pages : un widget Elementor, un élément Bricks et un champ ACF. Voir Constructeurs de pages, SEO et cache.

Les pages affichent une miniature légère jusqu’à ce que quelqu’un appuie sur lecture. Sur un site connecté, les pages contenant une vidéo hébergée par Pellio, prête et non privée, incluent aussi des données structurées VideoObject pour les moteurs de recherche.

Gérer les vidéos dans WordPress

Pellio → Videos est votre bibliothèque Pellio dans WordPress. Faites une recherche, filtrez par dossier, et cliquez sur Upload videos ou déposez des fichiers n’importe où sur la page. Ouvrez une vidéo pour accéder à :

• Details : titre, description, Who can watch (Public, Unlisted ou Private), Folder, Copy shortcode, Replace file et Move to Trash.
• Thumbnail : Upload an image, Reset to default, ou Or use the frame at (m:ss) → Use this frame.
• Chapters et Captions (.vtt ou .srt).
• Analytics : lectures, taux de lecture, spectateurs uniques et part moyenne regardée sur une période (Period) de 7, 30 ou 90 jours ou de 12 mois, avec la rétention de l’audience, Where it was watched (où elle a été regardée) et Site members who watched (membres du site qui l’ont regardée).

La vue Trash liste les vidéos mises à la corbeille pendant 30 jours, avec Restore.

Tout le monde utilise la connexion de votre site : votre équipe n’a donc pas besoin de son propre compte Pellio. Dans Pellio → Settings → Access, choisissez les rôles qui peuvent importer et intégrer (Can upload and embed ; par défaut Administrateur, Éditeur et Auteur) et ceux qui peuvent gérer la bibliothèque (Can manage the library ; par défaut Administrateur et Éditeur). Les administrateurs ont toujours les deux droits.

Qui peut regarder

Les intégrations d’un site connecté sont signées à chaque affichage de page : les vidéos privées et celles restreintes à certains domaines sont donc lues sur votre site et nulle part ailleurs. Dans le panneau Access du bloc, réservez une vidéo aux utilisateurs connectés ou aux membres de certaines formules d’adhésion. Les utilisateurs connectés sont enregistrés comme spectateurs dans vos statistiques. Avec Viewer analytics activé dans Pellio → Settings, leur adresse e-mail est aussi transmise : ils sont alors identifiés par leur nom dans les statistiques et n’ont pas à remplir les formulaires d’e-mail.

Migrer les intégrations

Pellio → Migration comporte deux parties.

1. Remplacer les intégrations Vimeo, Wistia et YouTube. Scan this site parcourt tous les types de contenu et champs personnalisés à la recherche d’iframes, d’intégrations Wistia, de shortcodes et de liens bruts, de blocs Presto Player, d’éléments Media Hub et de shortcodes [presto_player], ainsi que des champs vidéo LifterLMS et Sensei. Il indique quelles vidéos se trouvent déjà dans votre bibliothèque Pellio : importez d’abord votre bibliothèque Vimeo ou Wistia dans Pellio (voir Importer des vidéos). Preview changes montre ce qui changerait, et Replace embeds applique les changements. Chaque opération est sauvegardée et listée sous Previous runs, avec Undo pour l’annuler.
2. Transférer les vidéos de la médiathèque vers Pellio. Move videos to Pellio envoie les fichiers vidéo de votre médiathèque vers Pellio. Cochez Also replace Video blocks and shortcodes that use them pour remplacer aussi les intégrations correspondantes (avec sauvegarde, et réversible).

Les intégrations YouTube ne sont pas remplacées par la migration : Pellio ne peut pas importer depuis YouTube, il faudrait donc mettre en ligne leurs fichiers d’origine. Pour les lire plutôt dans le lecteur Pellio, activez Use the Pellio player for YouTube and Vimeo embeds dans Pellio → Settings. Les vidéos YouTube, Vimeo et de la médiathèque de Presto Player passent immédiatement au lecteur Pellio ; ses vidéos Bunny.net basculent une fois importées.

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

Les identifiants d’opération sont listés sous Previous runs, dans Pellio → Migration.

Pour les développeurs

• pellio_capability filtre la capacité requise pour importer et intégrer, ou pour gérer la bibliothèque.
• pellio_embed_atts filtre les attributs d’une intégration (vidéo, lecture automatique, début, etc.) avant son affichage.
• pellio_video( $id, $atts ) renvoie le HTML du lecteur pour vos modèles.

Désinstallation

Supprimer l’extension efface ses réglages, ses caches et ses tâches planifiées. Elle efface aussi ce qu’elle a stocké sur les apprenants dans WordPress : visionnages vérifiés, attestations, indicateurs d’achèvement des cours et données d’automatisation. Après une réinstallation, les colonnes Watch verified, Attested et Signed as du CSV de preuves de visionnage sont vides pour les apprenants précédents ; le journal des apprenants de Pellio, lui, conserve tout. Les articles gardent leurs blocs et shortcodes Pellio, et les sauvegardes de migration sont conservées pour qu’une réinstallation puisse encore annuler une migration.