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, emrichtext_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 chamarichtext().
No painel
-
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ó.
-
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.
-
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.
-
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.