Utilitários do Editor de Blocos
Como é comum em temas modernos do WordPress, este tema faz algumas configurações que viabilizam o uso de recursos do editor de blocos (Gutenberg) com adaptações à cenários que podem ser comuns no dia a dia de quem for criar páginas ou posts no VisiteMuseus.
Usando a recente API de "Block Bindings" do WordPress, este arquivo registra uma forma de se puxar dinamicamente a informação do total de itens de uma coleção a partir de um bloco qualquer como o bloco de parágrafo. Este recurso é usado nas páginas da edição do evento:
Os dados aqui são puxados dinamicamente. Até a versão 6.6 do WordPress, ainda não há uma forma de se configurar isso visualmente no Editor de Blocos, embora ele indique a presença da "amarração":
Para se editar ou criar algo assim, é preciso usar a opção do Editor de Código, disponível no canto superior direito do editor:
<!-- wp:paragraph {"align":"center","metadata":{"bindings":{"content":{"source":"cne/collection-total-items","args":{"collectionId":"15"}}}},"style":{"typography":{"fontStyle":"normal","fontWeight":"700"}},"fontSize":"x-large"} -->
<p class="has-text-align-center has-x-large-font-size" style="font-style:normal;font-weight:700"></p>
<!-- /wp:paragraph -->No código acima, o argumento "collectionId" guarda o ID 15, que trás qual a coleção que se está lendo o total de itens. A contagem só é vista na versão publicada da página.
Filtros de Blocos são usados para se alterar os valores padrão de um bloco. Aqui alteramos alguns dos valores padrão do bloco tainacan/faceted-search que é o responsável por exibir a lista de itens facetada do Tainacan. Como no VisiteMuseus é utilizado uma configuração de filtros horizontais, muitos ajustes no bloco precisam ser feitos até que se chegue ao layout encontrado nas páginas que listam os itens. Com este filtro, a maioria destes ajustes já vem definido quando o usuário insere o bloco. Outra pré-definição importante é a configuração do modo de visualização disponível como o modo "Cartão do VisiteMuseus".
Estilos de bloco são maneiras de se pré-definir algumas classes em blocos com um simples clique de botão. Isso permite que via CSS possam ser definidos ajustes que talvez ainda não existam como opção visual nos blocos. Neste arquivo serão definidos estilos de bloco sempre que forem necessários. Atualmente, um estilo relevante usado em alguns cenários é o que força um parágrafo a não ter quebra de linha, evitando em alguns cenários a quebra de layout:
