Toda imagem e todo arquivo que o cliente envia vão para a biblioteca de mídia, um lugar só para o site inteiro. Uma imagem enviada uma vez serve qualquer campo — a capa de um post, uma galeria, o logo nas opções, uma imagem dentro do texto — sem novo upload. Os campos guardam uma referência ao arquivo, não uma cópia, e todo campo de imagem abre a mesma biblioteca, com a área de upload: o cliente escolhe um arquivo que já existe ou envia um novo dali mesmo.
O que a biblioteca aceita
| Tipo | Formatos e tamanho máximo |
|---|---|
| Imagens | JPG, PNG, GIF, WebP e SVG — 25 MB |
| Documentos | PDF, Word (DOCX), Excel (XLSX), PowerPoint (PPTX) — 25 MB |
| Áudio | MP3, M4A, OGG, WAV — 50 MB |
| Vídeo | MP4, WebM, MOV — 200 MB |
| Compactados | ZIP — 100 MB |
Bom saber na hora de enviar
A hospedagem pode ter um limite de upload menor que esses; quando tem, a área de upload avisa. O Velk confere o que o arquivo é de verdade, não o nome dele: um arquivo renomeado para .jpg não passa.
Os nomes são limpos no upload: Fachada Clínica 2.JPG vira fachada-clinica-2.jpg, e um nome que já existe ganha -1, -2 no fim. O nome vira parte do endereço do arquivo, então um nome descritivo antes de enviar vale mais que IMG_4031.
Cada imagem tem o texto alternativo (alt) no painel de detalhes da biblioteca: a descrição curta que o leitor de tela lê em voz alta e que aparece quando a imagem não carrega. Ele fica gravado com a imagem, e o tema usa esse texto em todo lugar onde ela aparece. Num site multi-idioma, o painel tem um alt por idioma.
Peça à IA
Os cases precisam de capa e galeria. Gera dois tamanhos da capa: um para os cards da listagem, 720×420 recortado, e um largo para o topo do case, com 1440 de largura. As fotos da galeria precisam de um tamanho para a grade. Usa o texto alternativo de cada imagem, o da biblioteca.
O Velk chama esses tamanhos de variações. Dizer onde cada tamanho aparece deixa a IA declarar no campo certo.
Tamanhos de imagem (variações)
Uma foto saída da câmera é muito maior que qualquer espaço de uma página. Cada campo image ou gallery pode declarar os próprios tamanhos, as variações — um tamanho de card, um de banner —, e o template pede o que precisa. O Velk gera as variações quando o conteúdo é salvo, nunca com o visitante esperando. Se faltar um tamanho para alguma imagem, o site mostra a original em vez de uma imagem quebrada.
- Caber (
contain): a imagem inteira cabe na caixa. - Ocupar (
cover): a imagem cobre a caixa; um dos lados pode passar dela. - Recortar (
crop): ocupa a caixa e corta as bordas na largura e na altura exatas.
Nenhuma variação aumenta uma imagem além da original. Toda foto também ganha uma miniatura, que o painel usa.
Galerias e outros arquivos
Um campo gallery guarda várias imagens na ordem em que o cliente arrasta, com Adicionar imagens para escolher mais na biblioteca. Para o que não é imagem — um cardápio em PDF, uma tabela de preços, um vídeo, um episódio de podcast — existe o campo file: ele aceita qualquer arquivo da biblioteca e pode ser limitado a alguns tipos, como só documentos.
Arquivo que o visitante manda por formulário é outra coisa: nunca entra na biblioteca, fica privado e só se baixa pela tela do formulário no painel.
Perguntas
Por que a foto do iPhone não sobe?
Foto salva em HEIC não está entre os formatos aceitos. Exporte como JPG e envie de novo.
Declarei um tamanho novo e as imagens antigas não têm.
Os tamanhos nascem quando o conteúdo é salvo. Para o que foi enviado antes, a IA roda o media:variants. Se mesmo assim não aparecerem, pode faltar no PHP do servidor a extensão de imagem (GD) — a IA consegue conferir.
A biblioteca é a mesma em todos os idiomas?
É: uma biblioteca só para o site. Só o texto alternativo muda por idioma.