Hospedagem com 20% de desconto comprando pelo link

Mídia e imagens

Toda imagem e todo arquivo passam por uma biblioteca de mídia só: envie uma vez e use em qualquer campo, com texto alternativo por idioma e os tamanhos de cada lugar do site, gerados pelo Velk.

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

TipoFormatos e tamanho máximo
ImagensJPG, PNG, GIF, WebP e SVG — 25 MB
DocumentosPDF, Word (DOCX), Excel (XLSX), PowerPoint (PPTX) — 25 MB
ÁudioMP3, M4A, OGG, WAV — 50 MB
VídeoMP4, WebM, MOV — 200 MB
CompactadosZIP — 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.

O que a IA roda
# tamanho declarado agora não chega sozinho nas imagens já enviadas $ ./bin/velk media:variants # gera os tamanhos que faltam em todas as imagens, inclusive dentro de listas e blocos $ ./bin/velk media:variants --regen # refaz os arquivos depois que um tamanho mudou de medida
Num site no ar, peça depois de publicar o tema: a IA consegue rodar o comando no servidor.

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.