Hospedagem com 20% de desconto comprando pelo link

Campos

Os 18 tipos de campo que decidem o que o cliente edita — texto, imagem, listas, links, referências —, mais campos condicionais, linhas com nome, grupos, abas e conjuntos reaproveitáveis.

Campos são as caixas que o cliente preenche no painel. Toda página e todo tipo de conteúdo têm os campos que você descreve, e cada campo tem um tipo que decide o que o painel mostra: uma linha, um editor de texto, um seletor de imagem, uma lista de linhas. Só o título, o endereço e, nos tipos de conteúdo, a data de publicação vêm embutidos. O resto é campo que você nomeia.

Os 18 tipos de campo

TipoPara que serve
textUma linha: título, nome, texto de botão.
textareaUm parágrafo sem formatação: resumo, linha de apoio.
richtextConteúdo com formatação: negrito, títulos, listas, citações, links, imagens, código e tabelas simples.
imageUma imagem da biblioteca de mídia.
galleryVárias imagens, numa ordem que você arrasta.
fileQualquer arquivo da biblioteca de mídia — PDF, vídeo, áudio —, com a opção de limitar os tipos aceitos.
selectUma opção de uma lista fechada: Casa, Apartamento, Terreno.
booleanUma caixinha de sim ou não, boa para ligar e desligar uma seção.
numberUm número: quantidade, ano, minutos.
emailUm endereço de e-mail.
urlUm endereço da web.
dateUma data, escolhida num calendário.
repeaterLinhas com os mesmos campos: serviços, cada um com nome e resumo.
flexibleUma lista de blocos de tipos diferentes, cada linha com o próprio formato (veja Páginas por blocos).
linkEndereço, texto do link e “abrir em nova aba”, num campo só.
itemUma referência a outro conteúdo do site: o imóvel em destaque, o autor de um artigo.
groupUma caixa recolhível que organiza campos no painel.
tabsAbas que dividem um formulário comprido no painel.

Peça à IA

No tipo Imóvel da Casa Viva, uma imobiliária, acrescenta: código de referência (uma linha), tipo de imóvel (Casa, Apartamento ou Terreno), número de quartos, galeria de fotos, a planta em PDF, uma lista de diferenciais em que cada um é um nome curto, e o bairro. Código e tipo são obrigatórios. Me mostra os nomes e os rótulos dos campos antes de aplicar.

Dizer o que cada campo guarda — uma linha, uma escolha, um PDF, uma lista — basta para a IA escolher o tipo. Revisar os nomes antes de aplicar é a hora barata de mudar.

Rótulo e nome

Todo campo tem dois nomes. O rótulo é o que o cliente lê no painel (“Código de referência”); mude quando quiser. O nome é o interno, que o template lê (codigo_referencia); decida antes de existir conteúdo.

Renomear um campo depois dá trabalho de verdade: o que foi salvo com o nome antigo some do painel e é descartado na próxima vez que aquele item for salvo. Se não tiver jeito, diga isso e peça para a IA levar o conteúdo existente para o nome novo.

Ajuda, placeholder e obrigatório

Um campo pode ter uma linha de ajuda embaixo (“Tamanho recomendado: 1200 × 630”), um placeholder — um exemplo dentro da caixa vazia de uma linha — e ser obrigatório: o rótulo ganha um asterisco e, nos campos de uma linha, o painel não salva enquanto ele estiver vazio. Num site em vários idiomas, obrigatório vale só no idioma principal: desde a v3.7.4, as abas de tradução nunca travam o salvamento.

Campos que só aparecem quando fazem sentido

Com show_if, um campo só aparece quando outro tem certo valor: o link do vídeo aparece quando “Tem tour em vídeo” está marcado; o endereço do mapa, quando o tipo de seção é Mapa ou Como chegar. São dois operadores — equals para um valor, in para uma lista de valores.

  • Campo escondido deixa de ser obrigatório enquanto está escondido.
  • O que foi digitado nele é mantido: marcar e desmarcar não perde nada.
  • A condição olha os campos do lado; dentro de uma linha de lista, só os campos daquela linha.

Peça à IA

No modelo de página Oficina, acrescenta uma caixinha Oficina online. Marcada, mostra um campo para o link da transmissão; desmarcada, mostra o endereço do local. Cada um só é obrigatório enquanto estiver visível.

A IA escreve as condições com show_if, e o schema:validate confere se cada uma aponta para um campo que existe.

Listas, grupos e abas

Um repeater guarda linhas com os mesmos campos; o cliente acrescenta, remove e arrasta linhas. Peça um title_field para cada linha fechada mostrar um valor — o nome do serviço — em vez de Item 01, Item 02. Funciona com campos cujo valor é texto: text, textarea, number, email, url, select e link.

group junta campos relacionados numa caixa recolhível, fechada por padrão ou aberta se você pedir. tabs distribui um formulário comprido em abas, como Conteúdo, Contato e Configurações. Os dois só organizam o painel: pôr ou tirar depois não muda nada no que foi salvo.

O campo item aponta para outro conteúdo: o cliente busca entre os itens publicados de um tipo e escolhe um — o imóvel em destaque na home, por exemplo —, e o tema mostra o título, a imagem ou o preço daquele item. Para várias referências, como artigos relacionados, a IA põe um campo item dentro de um repeater. Se o item for excluído, o campo volta vazio.

O campo link guarda endereço, texto e “abrir em nova aba” numa caixa só. Aceita endereço interno e externo, link de e-mail e âncora (link para um ponto da página), e um link em branco nunca trava o salvamento — então peça um campo link, não três.

Peça à IA

Na home, deixa o cliente escolher o imóvel em destaque entre os publicados, mais um botão com texto e link próprios. Quando nenhum imóvel estiver escolhido, esconde essa seção.

A IA usa um campo item para o imóvel e um campo link para o botão, e o template pula a seção enquanto o campo estiver vazio.

Conjuntos de campos reaproveitáveis

Quando os mesmos campos se repetem em vários lugares — endereço, telefone e horário na Contato e em cada unidade de uma rede de clínicas —, a IA declara esses campos uma vez, como um grupo de campos (field_groups), e reaproveita. Uma mudança no conjunto chega a todos os lugares que usam. Não confunda com o tipo group, que só desenha uma caixa no painel.

O que a IA roda
# confere cada campo, condição e nome de linha $ ./bin/velk schema:validate ✓ site.json is valid. # mostra os campos de um tipo de conteúdo $ ./bin/velk item:schema property
O schema:validate pega o que quebraria o painel: uma condição apontando para um campo que não existe, um title_field de um tipo que não serve para nomear linha, duas abas com campos de mesmo nome.