Plugin para WordPress

O plugin Pellio exige WordPress 6.5 ou superior e PHP 8.1 ou superior. Ele funciona sozinho como player de vídeo e se conecta a uma conta Pellio para hospedagem, análises e vídeos privados.

Sem conta: o player Pellio

Adicione um bloco Pellio Video e cole um link do YouTube ou do Vimeo, ou escolha um vídeo da Biblioteca de mídia. Ele é reproduzido no player Pellio, com as suas cores (Pellio → Settings → Player). Nada é carregado do YouTube ou do Vimeo até o visitante apertar play: a miniatura fica salva no seu site. Veja Vídeos do YouTube, do Vimeo e da Biblioteca de mídia.

Conecte sua conta Pellio

1. Acesse Pellio → Settings e clique em Connect to Pellio.
2. Entre na sua conta se for solicitado, confira o workspace e clique em Connect site.

O domínio do seu site é adicionado aos domínios permitidos do workspace, e o site aparece no Pellio em Settings → General → Connected WordPress sites, onde você pode desconectá-lo. Se você mudar o endereço do site depois, o novo domínio é adicionado automaticamente.

Pellio → Settings é uma única página, dividida em seções. Algumas só aparecem quando se aplicam:

• Player: cor e arredondamento dos cantos, Embeds (veja Vídeos do YouTube, do Vimeo e da Biblioteca de mídia), Google Analytics, Viewer analytics (compartilha com o Pellio o e-mail dos usuários logados) e Viewer watermark (marca d’água do espectador).
• Automations, quando o FluentCRM ou o WP Fusion está ativo. Veja Automações e análises.
• Courses, quando há um LMS ativo: comprovantes de visualização, relatórios de progresso e, para LearnDash, Tutor LMS e Sensei LMS, as regras de Lesson videos.
• Access: quais funções podem usar o Pellio (veja abaixo).
• Pellio account: a conexão, com Disconnect.
• Status: verifica a conexão com o Pellio, a assinatura das incorporações, o relógio do servidor, o domínio permitido, a Content Security Policy, a REST API e os plugins de cache e otimização. Os resultados ficam guardados por 10 minutos; Run checks again atualiza tudo. As mesmas verificações aparecem como um teste em Ferramentas → Saúde do site.

O painel do WordPress também ganha um widget Pellio: top videos (30 days).

Como adicionar vídeos do Pellio

• Editor de blocos: adicione um bloco Pellio Video e solte arquivos nele ou escolha da sua biblioteca. Os arquivos vão direto do navegador para o Pellio, sem passar pelo seu servidor, e uploads grandes continuam de onde pararam se forem interrompidos. O painel Playback do bloco tem Autoplay, Muted, Loop, Captions on by default e Start at (seconds). Os blocos Pellio Playlist e Pellio Lightbox mostram vários vídeos ou abrem um deles sobre a página a partir da miniatura ou de um botão.
• Editor clássico: clique em Add Pellio video acima do editor.
• Shortcode: [pellio id="VIDEO_ID"], com os opcionais title="", autoplay="1", muted="1", loop="1", captions="1", start="90" e visibility="logged-in" (ou visibility="members"). [pellio url="https://youtu.be/…"] reproduz uma URL do YouTube, do Vimeo ou de um arquivo no player Pellio; ele ignora autoplay e captions.
• Um link do Pellio: cole um link de compartilhamento do Pellio (pellio.io/v/…) no editor e ele vira o player Pellio assinado, inclusive para vídeos privados.
• Construtores de páginas: um widget para Elementor, um elemento para Bricks e um campo ACF. Veja Construtores de páginas, SEO e cache.

As páginas mostram uma miniatura leve até alguém apertar play. Em um site conectado, páginas com um vídeo hospedado no Pellio que esteja pronto e não seja Private também levam dados estruturados VideoObject para os mecanismos de busca.

Como gerenciar vídeos no WordPress

Pellio → Videos é a sua biblioteca do Pellio dentro do WordPress. Pesquise, filtre por pasta e clique em Upload videos ou solte arquivos em qualquer lugar da página. Abra um vídeo para ver:

• Details: título, descrição, Who can watch (Public, Unlisted ou Private), Folder, Copy shortcode, Replace file e Move to Trash.
• Thumbnail: Upload an image, Reset to default ou Or use the frame at (m:ss) → Use this frame.
• Chapters e Captions (.vtt ou .srt).
• Analytics: reproduções, taxa de reprodução, espectadores únicos e média assistida em um Period de 7, 30 ou 90 dias ou 12 meses, com retenção de audiência, Where it was watched e Site members who watched.

A visualização Trash lista os vídeos na lixeira, com Restore, por 30 dias.

Todo mundo usa a conexão do seu site, então sua equipe não precisa ter contas próprias no Pellio. Em Pellio → Settings → Access, escolha as funções que Can upload and embed (por padrão Administrador, Editor e Autor) e as que Can manage the library (por padrão Administrador e Editor). Administradores sempre têm as duas permissões.

Quem pode assistir

As incorporações de um site conectado são assinadas a cada visualização de página, então vídeos Private e com restrição de domínio são reproduzidos no seu site e em nenhum outro lugar. No painel Access do bloco, limite um vídeo a usuários logados ou a membros de planos específicos. Usuários logados ficam registrados como espectadores nas suas análises. Com Viewer analytics ativado em Pellio → Settings, o e-mail deles também é compartilhado, então eles aparecem pelo nome nas análises e não precisam preencher formulários de e-mail.

Como migrar incorporações

Pellio → Migration tem duas partes.

1. Substituir incorporações do Vimeo, Wistia e YouTube. Scan this site procura em todos os tipos de post e campos personalizados por iframes, incorporações do Wistia, shortcodes e links soltos, blocos do Presto Player, itens do Media Hub e shortcodes [presto_player], além dos campos de vídeo do LifterLMS e do Sensei. Ele mostra quais vídeos já estão na sua biblioteca do Pellio: importe sua biblioteca do Vimeo ou do Wistia no Pellio primeiro (veja Importar vídeos). Preview changes mostra o que mudaria, e Replace embeds faz a troca. Cada execução tem backup e aparece em Previous runs, com Undo.
2. Mover vídeos da Biblioteca de mídia para o Pellio. Move videos to Pellio envia os arquivos de vídeo da sua Biblioteca de mídia para o Pellio. Marque Also replace Video blocks and shortcodes that use them para trocar essas incorporações também (com backup, e dá para desfazer).

A migração não substitui incorporações do YouTube: o Pellio não consegue importar do YouTube, então seria preciso enviar os arquivos originais. Para reproduzi-las no player Pellio, ative Use the Pellio player for YouTube and Vimeo embeds em Pellio → Settings. Os vídeos do YouTube, do Vimeo e da Biblioteca de mídia do Presto Player passam para o player Pellio na hora; os vídeos Bunny.net dele passam assim que forem importados.

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

Os ids das execuções aparecem em Previous runs, em Pellio → Migration.

Para desenvolvedores

• pellio_capability filtra a capability necessária para enviar e incorporar, ou para gerenciar a biblioteca.
• pellio_embed_atts filtra os atributos de uma incorporação (vídeo, autoplay, início etc.) antes de ela ser renderizada.
• pellio_video( $id, $atts ) retorna o HTML do player para usar em templates.

Como desinstalar

Excluir o plugin remove as configurações, os caches e as tarefas agendadas dele. Também remove o que ele guardou sobre os alunos no WordPress: visualizações verificadas, atestados, marcações de conclusão de curso e registros de automação. Depois de reinstalar, as colunas Watch verified, Attested e Signed as do CSV de comprovantes de visualização ficam vazias para os alunos anteriores; o registro de alunos do próprio Pellio guarda tudo. Os posts mantêm os blocos e shortcodes do Pellio, e os backups de migração continuam lá, para que uma reinstalação ainda consiga desfazer uma migração.