Conteúdo
Após uma recheada versão 0.19 e um discreta atualização com correções (0.19.1), está na hora de trazermos mais uma versão do ciclo 19 (que como prometemos antes, será o último antes da 1.0). E o grande foco deste ciclo está nos metadados, por isso hoje temos mais novidades para quem acabou de começar a organizar suas informações com as seções de metadados!
Novidades
Blocos de Seções e de Metadados
A família de blocos Gutenberg do Tainacan acaba de ganhar 6 novos blocos! Para conhecer eles, basta ir em qualquer post ou página do seu site e pesquisar pelo bloco Seções de Metadados. Escolha um item que deseja mostrar e…
Usando de uma hierarquia de blocos, é carregado, para o item que você selecionou:
- A lista de seções de metadados dele
- Para cada seção, um bloco individual de seção
- Para cada bloco de seção, um bloco de título, de descrição e de lista de metadados
- Para cada bloco de lista de metadados, um bloco individual de metadado
- Para cada bloco de seção, um bloco de título, de descrição e de lista de metadados
- Para cada seção, um bloco individual de seção
Usando desta hierarquia, você terá flexibilidade para inserir apenas as informações que lhe interessa, seja um conjunto inteiro de metadados, seja um único metadado por vez. Todos estes blocos vem também com diversas opções de personalização como cores e tipografia, espaçamentos e alinhamentos, etc.
A maneira como os blocos se relacionam também lhe dá flexibilidade para re-ordenar e remover alguns campos. Porém, com grandes poderes, vêm grandes responsabilidades!
É importante saber que re-ordenar ou remover um dos blocos filhos aqui não irá refletir em como estas informações estão organizadas no Tainacan em si, isso valhe apenas para esta camada de apresentação dos blocos.
Se por outro lado, você quer garantir que este bloco reflita todas as mudanças feitas no lado administrativo (como a mudança de ordem dos metadados e adição de novos), temos uma opção nos blocos superiores que permite bloquear essa flexibilização, “Sincronizar dinamicamente com o Tainacan”:
Por outro lado, se sua intenção é apenas mostrar alguns metadados, fica fácil reorganizá-los para montar uma tabela ou colunas, por exemplo, e ainda assim garantir que os valores dos metadados em si, estarão atualizados.
Melhorias
Refatoração da busca textual para melhor performance
Temos constantemente buscado melhorar o desempenho da busca do Tainacan, seja em termos de comportamento esperado seja em termos de velocidade. Nesta versão, trazemos uma série de ajustes que devem melhorar a performance da busca textual. Além disso, estamos introduzindo um novo comportamento padrão que deve ajudar você a encontrar mais objetivamente o que procura. É o seguinte:
Se em versões anteriores fosse feita uma busca textual por cesta de palha na busca geral, internamente seriam buscados pelos termos “cesta” OU “de” OU “palha” em todos os metadados de todos os itens da coleção. Isso pode parecer interessante, mas trazia resultados difíceis de serem interpretados, onde por exemplo um item poderia ter o termo “palhaço” no metadado título e “cesta” no metadado descrição. Isto poderia ser tratado envolvendo os termos da busca por aspas (“cesta de palha”), mas muita gente nunca soube dessa opção… por isso mudamos de estratégia.
Agora, uma busca por cesta de palha vai buscar por esta frase completa. Embora continue buscando em todos os metadados, as palavras deverão estar juntas e nesta ordem. No máximo, podem resultar em situações como “cesta de palhas”. Deste modo, a busca te ajuda a encontrar o que você precisa de maneira mais concreta.
E se você preferir o modo anterior, ainda é possível passar parâmetros para API (sentence=true
) que usem a estratégia antiga. Estamos já desenvolvendo uma interface visual para que isso possa ser alcançado por usuários comuns. De qualquer modo, buscas mais complexas também podem ser feitas com a busca avançada ou com filtros.
Compatibilidade maior de temas com a página do item
O suporte de temas às páginas do Tainacan sempre foi uma questão muito importante para nossa equipe. Se você é um dos usuários que não quer ficar com o Tainacan Interface ou o Blocksy (ambos os quais nós oferecemos um suporte com os novos recursos lançados), provavelmente já topou com a documentação de suporte aos temas. Nela, comentamos que há dois “templates” – modelos – de página, que um tema precisa implementar para dizermos que ele dá o suporte ao Tainacan:
- As páginas que listam itens do Tainacan (seja repositório, coleção ou termo) , que por padrão tem cara de uma lista de posts do WordPress;
- As páginas de um item do Tainacan em si, que também ficam com aparência de post, sem mostrar anexos e seções.
Para o primeiro caso, introduzimos o bloco de Busca Facetada e em breve teremos mais opções que facilitam seu uso. Para o segundo, porém, a alternativa sempre foi botar a mão em código. Agora, felizmente temos uma compatibilidade maior com qualquer tema para as páginas de item. Independente de qual tema você estiver usando, a página do item irá mostrar:
- O Documento principal, incluindo sua galeria de zoom;
- As seções de metadados públicas, de maneira linear em uma coluna;
- Um carrossel de anexos, também com uma galeria de zoom.
Isto é um grande avanço frente ao antigo padrão, que exibia o documento cru, independente do seu formato e a lista de anexos sem rótulo de seção algum:
E muito, muito mais!
- Compatibilidade do Bloco de Galeria do Item e dos novos blocos de Metadados com a edição de templates/modelos de páginas em temas de Edição Completa do Site (FSE).
- Ordena blocos que tem seleção manual por ordem de seleção ao invés de data de criação;
- Esconde a seção de metadados se não houver nenhum valor de metadado na página do item;
- Compatibilidade com o CSS de modals no WordPress 6.1.
Correções de Erros
- Corrige o erro onde alguns metadados nível repositório não eram exibidos dentro das seções;
- Corrige erro dos itens relacionados a este não mostrarem a miniatura corretamente;
- Corrige erro dos itens relacionados a este não mostrarem o link correto em sites com subdiretório;
- Evita que um item seja relacionado duas vezes em um mesmo metadado;
- Corrige erro relacionado aos status na busca nível repositório;
- Evita warnings the
wp.hooks
não declarado para versões anteriores do WordPress; - Pequenas correções na busca geral e avançada;
- Várias correções de tradução.
Para Desenvolvedores
- Renomeamos o endpoint /
metadatasection
para /metadata-sections
. - O novo endpoint /
item/<id_item>/metadatasection/<id_metasection>
permite obter os metadados de um item pré-filtrados por seção.
Baixe Já!
A versão 0.19.2 do Tainacan já está disponível. Você pode baixá-la ou atualizar diretamente pelo seu painel WordPress: