Site - Galeria de Vídeos

O que é

A página de Vídeos concentra todos os vídeos exibidos na galeria pública do site da agência. Cada registro guarda a URL original (YouTube ou Instagram), um título e descrição opcionais, e a plataforma é detectada automaticamente pela URL - o Viagilize gera o embed correto sem precisar copiar código.

O cadastro normalmente é feito junto com a montagem da vitrine, depois de subir os primeiros vídeos institucionais ou de depoimentos. Os vídeos com status Ativo aparecem na rota pública /videos do site e podem ser referenciados também pela seção de vídeos da Home (quando habilitada).

Como usar

1. Vá em Vitrine > Vídeos no sidebar (URL /admin/videos).
2. Clique em Novo Vídeo (botão azul no canto superior direito).
3. Preencha o formulário:
   • URL do Vídeo - cole a URL completa. Formatos aceitos:
     • YouTube: https://www.youtube.com/watch?v={id}, https://youtu.be/{id}, https://www.youtube.com/embed/{id}, https://www.youtube.com/shorts/{id}
     • Instagram: https://www.instagram.com/reel/{id}/, https://www.instagram.com/p/{id}/ A plataforma é detectada na hora e o ícone correspondente aparece dentro do campo.
   • Pré-visualização - assim que a URL é reconhecida, um player aparece logo abaixo para você confirmar se é o vídeo certo.
   • Título - opcional. Se vazio, a listagem mostra "Sem título".
   • Descrição - opcional, texto curto que pode ser usado na galeria do site.
   • Vídeo ativo - toggle no rodapé. Quando desligado, o vídeo continua salvo, mas some da galeria pública.
4. Confirme em Adicionar Vídeo (ou Salvar Alterações, quando estiver editando).

Ativar ou desativar sem editar

No card de cada vídeo da listagem, o ícone de olho alterna o status entre Ativo e Inativo sem abrir o formulário. Vídeos inativos aparecem com a tarja "Inativo" e ficam levemente esmaecidos.

Buscar um vídeo já cadastrado

O campo Buscar por título, descrição ou URL no topo da listagem filtra os cards pelos três campos ao mesmo tempo. Use Limpar para voltar à lista completa.

Como o vídeo aparece no site público

Os vídeos com status Ativo são listados em /videos no site público, ordenados do mais recente para o mais antigo (data de cadastro). A página pública usa paginação de 12 vídeos por página.

Casos especiais

URL fora do YouTube e Instagram

Se você colar uma URL que não seja YouTube nem Instagram, o sistema aceita e marca a plataforma como Outro. Nesse caso, o card mostra apenas o ícone genérico de câmera e o vídeo não tem embed automático na galeria - ele aparece como link "Ver vídeo".

O usuário pode pedir "Vimeo": hoje a galeria não gera embed para Vimeo. A URL é aceita como Outro, mas exibida só como link externo.

Sem ordenação manual

A galeria não tem reordenação por arrastar e soltar. A ordem na listagem do admin e no site público segue a data de cadastro (mais recente primeiro). Para "subir" um vídeo, edite e salve novamente - isso atualiza o created_at? Não: o created_at permanece original. Se precisar destacar um vídeo, exclua e recadastre.

Reel ou post do Instagram

O Viagilize aceita as três variantes (/p/, /reel/, /tv/) e gera a URL /embed automaticamente. O preview no formulário usa o iframe oficial do Instagram. Se o post for de uma conta privada, o embed não carrega no site público.

YouTube Shorts

URLs no formato youtube.com/shorts/{id} são reconhecidas como YouTube e o embed gerado usa o player padrão (horizontal), não o formato vertical do Shorts.

Erros comuns e como resolver

• "A URL do vídeo é obrigatória." - Causa: o campo URL foi enviado vazio. Solução: cole a URL completa do YouTube ou Instagram antes de salvar.
• "A URL do vídeo deve ser válida." - Causa: a string colada não tem formato de URL (faltou https://, tem espaço, etc.). Solução: copie novamente direto do botão Compartilhar do YouTube ou Instagram.
• Pré-visualização não aparece - Causa: a URL não foi reconhecida como YouTube ou Instagram (foi salva como "Outro"). Solução: confira se está copiando a URL completa, com o ID do vídeo, e não apenas o link do canal.
• Vídeo sumiu do site público - Causa: status definido como Inativo. Solução: na listagem, clique no ícone de olho do card para reativar.

Onde encontrar

• URL: /admin/videos
• Caminho no menu: Vitrine > Vídeos
• Permissão necessária: ver as configurações para visualizar, editar as configurações para criar, editar, ativar/desativar e excluir
• Módulo necessário: nenhum

Veja também

• Hero Slides (Carrossel) - para imagens em destaque no topo do site
• Depoimentos de Clientes - outro tipo de prova social na vitrine
• Seções da Home - habilita a seção de vídeos na página inicial