Plugin de WordPress

El plugin de Pellio necesita WordPress 6.5 o posterior y PHP 8.1 o posterior. Funciona por sí solo como reproductor de vídeo y se conecta a una cuenta de Pellio para el alojamiento, las analíticas y los vídeos privados.

Sin cuenta: el reproductor de Pellio

Añade un bloque Pellio Video y pega un enlace de YouTube o Vimeo, o elige un vídeo de la biblioteca de medios. Se reproduce en el reproductor de Pellio, con tus colores (Pellio → Settings → Player). No se carga nada de YouTube ni de Vimeo hasta que el visitante pulsa play: la miniatura se guarda en tu web. Consulta Vídeos de YouTube, Vimeo y la biblioteca de medios.

Conecta tu cuenta de Pellio

1. Ve a Pellio → Settings y haz clic en Connect to Pellio.
2. Inicia sesión si te lo pide, comprueba el espacio de trabajo y haz clic en Connect site.

El dominio de tu web se añade a los dominios permitidos del espacio de trabajo, y la web aparece en Pellio en Settings → General → Connected WordPress sites, desde donde puedes desconectarla. Si más adelante cambias la dirección de tu web, el nuevo dominio se añade automáticamente.

Pellio → Settings es una sola página dividida en secciones. Algunas solo aparecen cuando son necesarias:

• Player: color y radio de las esquinas, Embeds (consulta Vídeos de YouTube, Vimeo y la biblioteca de medios), Google Analytics, Viewer analytics (comparte con Pellio el email de los usuarios con la sesión iniciada) y Viewer watermark (marca de agua con los datos del espectador).
• Automations, si FluentCRM o WP Fusion están activos. Consulta Automatizaciones y analíticas.
• Courses, si hay un LMS activo: pruebas de visualización, informes de progreso y, para LearnDash, Tutor LMS y Sensei LMS, las reglas de Lesson videos.
• Access: qué roles pueden usar Pellio (más abajo te lo explicamos).
• Pellio account: la conexión, con Disconnect.
• Status: comprueba la conexión con Pellio, la firma de las inserciones, el reloj del servidor, el dominio permitido, la Content Security Policy, la API REST y los plugins de caché y optimización. Los resultados se guardan durante 10 minutos; Run checks again los actualiza. Las mismas comprobaciones aparecen como una sola prueba en Herramientas → Salud del sitio.

El escritorio de WordPress también incluye el widget Pellio: top videos (30 days), con tus vídeos más vistos.

Añadir vídeos de Pellio

• Editor de bloques: añade un bloque Pellio Video y suelta archivos en él o elige uno de tu biblioteca. Los archivos se suben directamente del navegador a Pellio, sin pasar por tu servidor, y las subidas grandes se reanudan si se interrumpen. El panel Playback del bloque tiene Autoplay, Muted, Loop, Captions on by default y Start at (seconds). Los bloques Pellio Playlist y Pellio Lightbox muestran varios vídeos o abren uno sobre la página desde su miniatura o un botón.
• Editor clásico: haz clic en Add Pellio video, encima del editor.
• Shortcode: [pellio id="VIDEO_ID"], con los atributos opcionales title="", autoplay="1", muted="1", loop="1", captions="1", start="90" y visibility="logged-in" (o visibility="members"). [pellio url="https://youtu.be/…"] reproduce una URL de YouTube, de Vimeo o de un archivo en el reproductor de Pellio; ignora autoplay y captions.
• Un enlace de Pellio: pega un enlace para compartir de Pellio (pellio.io/v/…) en el editor y se convierte en el reproductor firmado de Pellio, también con vídeos privados.
• Constructores de páginas: un widget de Elementor, un elemento de Bricks y un campo de ACF. Consulta Constructores de páginas, SEO y caché.

Las páginas muestran una miniatura ligera hasta que alguien pulsa play. En una web conectada, las páginas con un vídeo alojado en Pellio que esté listo y no sea privado también incluyen datos estructurados VideoObject para los buscadores.

Gestionar vídeos desde WordPress

Pellio → Videos es tu biblioteca de Pellio dentro de WordPress. Busca en ella, filtra por carpeta y haz clic en Upload videos o suelta archivos en cualquier parte de la página. Abre un vídeo para ver:

• Details: título, descripción, Who can watch (Public, Unlisted o Private), Folder, Copy shortcode, Replace file y Move to Trash.
• Thumbnail: Upload an image, Reset to default u Or use the frame at (m:ss) → Use this frame.
• Chapters y Captions (.vtt o .srt).
• Analytics: reproducciones, tasa de reproducción, espectadores únicos y porcentaje medio visto en un Period de 7, 30 o 90 días o de 12 meses, con la retención de la audiencia, Where it was watched (dónde se vio) y Site members who watched (qué miembros de la web lo vieron).

La vista Trash muestra los vídeos enviados a la papelera durante 30 días, con la opción Restore.

Todo el mundo usa la conexión de tu web, así que tu equipo no necesita cuentas propias de Pellio. En Pellio → Settings → Access, elige qué roles Can upload and embed (pueden subir e insertar; por defecto, Administrador, Editor y Autor) y qué roles Can manage the library (pueden gestionar la biblioteca; por defecto, Administrador y Editor). Los administradores siempre tienen ambos permisos.

Quién puede verlo

Las inserciones de una web conectada se firman en cada visita a la página, así que los vídeos privados y los que tienen restricción de dominios se reproducen en tu web y en ningún otro sitio. En el panel Access del bloque, puedes limitar un vídeo a los usuarios con la sesión iniciada o a los miembros de determinados planes. Los usuarios con la sesión iniciada quedan registrados como espectadores en tus analíticas. Si activas Viewer analytics en Pellio → Settings, también se comparte su email, de modo que aparecen con nombre en las analíticas y no tienen que rellenar los formularios de email.

Migrar inserciones

Pellio → Migration tiene dos partes.

1. Sustituir las inserciones de Vimeo, Wistia y YouTube. Scan this site revisa todos los tipos de contenido y campos personalizados en busca de iframes, inserciones de Wistia, shortcodes y enlaces sueltos, bloques de Presto Player, elementos de Media Hub y shortcodes [presto_player], y campos de vídeo de LifterLMS y Sensei. Te muestra qué vídeos ya están en tu biblioteca de Pellio: primero importa tu biblioteca de Vimeo o Wistia en Pellio (consulta Importar vídeos). Preview changes muestra lo que cambiaría y Replace embeds lo aplica. Cada ejecución se guarda con una copia de seguridad y aparece en Previous runs, con la opción Undo.
2. Pasar a Pellio los vídeos de la biblioteca de medios. Move videos to Pellio sube a Pellio los archivos de vídeo de tu biblioteca de medios. Marca Also replace Video blocks and shortcodes that use them para cambiar también esas inserciones (con copia de seguridad, y se puede deshacer).

La migración no sustituye las inserciones de YouTube: Pellio no puede importar desde YouTube, así que habría que subir sus archivos originales. Si prefieres reproducirlos en el reproductor de Pellio, activa Use the Pellio player for YouTube and Vimeo embeds en Pellio → Settings. Los vídeos de YouTube, Vimeo y la biblioteca de medios de Presto Player pasan al reproductor de Pellio al momento; sus vídeos de Bunny.net, en cuanto se importan.

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

Los ids de cada ejecución aparecen en Previous runs, en Pellio → Migration.

Para desarrolladores

• pellio_capability filtra la capacidad necesaria para subir e insertar vídeos o para gestionar la biblioteca.
• pellio_embed_atts filtra los atributos de una inserción (vídeo, reproducción automática, inicio, etc.) antes de renderizarla.
• pellio_video( $id, $atts ) devuelve el HTML del reproductor para usarlo en plantillas.

Desinstalar

Al borrar el plugin se eliminan sus ajustes, cachés y tareas programadas. También se elimina lo que guardaba sobre los alumnos en WordPress: visualizaciones verificadas, declaraciones, marcas de curso completado y registros de automatizaciones. Si lo vuelves a instalar, las columnas Watch verified, Attested y Signed as del CSV de pruebas de visualización quedan vacías para los alumnos anteriores; el registro de alumnos de Pellio lo conserva todo. Las entradas mantienen sus bloques y shortcodes de Pellio, y las copias de seguridad de la migración se conservan, así que tras reinstalar aún puedes deshacer una migración.