Hospedagem com 20% de desconto comprando pelo link
v3.9Novo nesta versão

Blocos no texto

Desde a v3.9.0 o editor de texto aceita blocos desenhados pelo tema — números em destaque, depoimento, chamada para ação — inseridos entre dois parágrafos e preenchidos num formulário curto.

Um post é quase todo parágrafo, mas de vez em quando pede algo com formato próprio: três números grandes de um case, o depoimento de um cliente com foto, uma caixa chamando para agendar uma conversa. Desde a v3.9.0 o editor de texto (o campo richtext) aceita blocos para isso. Você decide quais blocos existem, a IA declara no tema, e quem escreve insere os blocos entre os parágrafos pelo botão Bloco.

Quem escreve preenche dados, não layout: a aparência vem do tema, então o depoimento deste ano sai igual ao do ano passado. Uma página montada por blocos (o campo flexible) é outra coisa: lá a página inteira é uma pilha de seções; aqui os blocos ficam dentro de um texto corrido.

Peça à IA

No texto dos posts do blog, quero três blocos que quem escreve possa inserir entre os parágrafos: - Números em destaque: até quatro, cada um com o número e um rótulo curto - Depoimento: o texto, o nome da pessoa, a empresa dela e uma foto - Chamada: um título, o texto do botão e o link do botão Só o conteúdo dos posts aceita os blocos; os textos das páginas ficam como estão. Deixa os blocos com o visual do resto do site e roda o schema:validate no fim.

Nomear os campos de cada bloco é desenhar o formulário que quem escreve vai preencher. Dizer quais textos aceitam blocos deixa os outros editores como estão.

Outro exemplo

Nas páginas de tratamento da clínica, deixa a descrição aceitar dois blocos: “Antes e depois” (duas fotos e uma legenda) e “Perguntas” (uma lista de perguntas, cada uma com a resposta). O resto não muda.

Um bloco aceita qualquer tipo de campo: imagem, lista de linhas, link.

O que a IA faz

  • Declara cada bloco uma vez no site.json, em richtext_blocks: o nome dele no painel, os campos e o arquivo que o desenha.
  • Lista os blocos em cada campo de texto que os aceita. Um campo não aceita bloco nenhum até listar algum.
  • Escreve um template pequeno por bloco em theme/partials/richtext/, com o CSS dele. No site, o bloco herda o estilo do texto em volta.
  • Faz o tema imprimir o texto por richtext(), uma função que troca cada bloco pelo template dele. Sem ela os blocos não aparecem — e nada quebra.
  • Roda o schema:validate, a conferência da estrutura, que checa a declaração, se o arquivo de cada bloco existe e se o tema chama richtext().
O que a IA roda
$ ./bin/velk schema:validate ✓ site.json is valid. # confere os blocos, os arquivos deles e a chamada a richtext() $ ./bin/velk serve ✓ Velk serving on http://localhost:8080
Depois, abra um post no painel, insira cada bloco e veja o post no site.

No painel

  1. Clique em Bloco

    Os textos que aceitam blocos ganham o botão Bloco na barra de ferramentas. Ele abre uma janela que começa pela escolha do bloco — desde a v3.9.1, mesmo quando o campo aceita um só.

  2. Preencha o formulário

    A janela mostra os campos do bloco: um número, uma foto da biblioteca de mídia, uma lista de linhas. Salvar bloco põe um cartão no texto, onde estava o cursor.

  3. Mova ou altere

    O cartão mostra o nome do bloco e um resumo de uma linha, não o visual do site. Arraste para outro ponto, clique em Editar (ou dê dois cliques) para mudar, ou selecione e apague.

  4. Confira no site

    Abra o post no site: cada cartão vira o bloco desenhado pelo tema.

Onde um bloco pode ficar

Um bloco mora entre parágrafos, nunca dentro de lista, citação ou tabela: inserido numa lista, ele divide a lista em duas; numa tabela ou na legenda de uma imagem, o cartão entra logo depois dela.

Se um campo deixa de aceitar um bloco, ou o bloco sai do site.json, os cartões que já estão nos textos ficam, marcados como Bloco indisponível, e dá para mover e apagar; o editor nunca some com eles por conta própria. No site, um bloco que continua declarado em richtext_blocks segue aparecendo; um que saiu de lá não mostra nada.

O botão de citação

Desde a v3.9.0 a barra também tem o botão Citação. Ele transforma o parágrafo atual numa citação e, clicado de novo, volta a parágrafo; digitar > no começo da linha, ou Ctrl/Cmd+Shift+B, faz o mesmo. O editor grava uma citação simples. A aparência no site — um fio do lado, letra maior — é trabalho do tema, então peça para a IA estilizar uma vez, para todos os textos.

Perguntas

A IA consegue escrever um post com blocos para mim?

Consegue. Num site no ar ela usa os comandos de conteúdo, que recusam um bloco mal formado, dizendo o campo e o bloco, em vez de gravar quebrado.

E num site em mais de um idioma?

O texto de cada idioma tem os próprios blocos: insira em cada aba de idioma onde quiser que eles apareçam.

Um bloco pode mostrar um vídeo?

Pode. Se a política de segurança do site limita quais outros sites podem aparecer dentro das páginas, o site do vídeo precisa estar nessa lista.