Tainacan 1.1.0 – Refatoração das Atividades, Hierarquia de Termos do Item e Configurações de Blocos

Após uma boa espera estamos abrindo os trabalhos de 2026, lançando hoje a primeira grande versão pós 1.0.0, com mudanças técnicas importantes além de algumas novidades pedidas há bastante tempo pela comunidade. Vem com a gente!

Novidades

Refatoração do Registro de Atividades (Logs)

Uma das funcionalidades mais importantes do Tainacan é sua capacidade de guardar um registro de alterações de cada metadado de cada item, algo que os administradores podem acompanhar nas listas de Atividades.

Estes registros de atividades são internamente chamados de logs, e por mais úteis que sejam, são também nosso “maior calcanhar de Aquiles“. Isso porque em termos de implementação, estão sustentados em uma estratégia muito inadequada de banco de dados. Cada “log” do Tainacan hoje ocupa um espaço na mesma tabela onde o WordPress guarda nossos itens, coleções e posts, fazendo com que toda e qualquer mudança de valor de metadado gradualmente deixe consultas no site mais pesadas!

Isso foi discutido inúmeras vezes em nossa comunidade e nos levou a refatorar completamente a forma como estes registros são guardados por trás dos panos. É algo que desejávamos fazer há muitos anos e finalmente estamos tendo condições de trazer uma solução mais adequada.

Porém como toda grande mudança, a adoção desta nova forma de se guardar as Atividades será gradual. Por enquanto esta novidade só estará disponível para aqueles que conseguem ter acesso ao servidor para fazer alguns ajustes, que detalhamos a seguir:

define( 'TAINACAN_USE_DEPRECATED_LOGS', false);

wp tainacan logs migrate

wp tainacan logs purge-deprecated

Caso você não tenha acesso à estas configurações mais avançadas do servidor, não se preocupe! Em breve taremos uma forma segura desta operação ser feita via interface diretamente pelo seu painel administrativo.

Novo layout “linha do tempo” para as listas de atividades

Independentemente da migração ter sido feita, você já poderá tirar proveito de algumas melhorias de interface que trouxemos as Atividades.

Hoje as telas/modais que mostram a lista de registros de atividade tem uma carinha de tabela, não muito diferente de como as Coleções e Taxonomias são mostradas. Resolvemos adaptar este layout para entregar algo mais apropriado para este tipo de dado: uma linha do tempo:

A linha do tempo agrupa as atividades por dia, usa ícones para indicar o tipo de atividade, dá mais espaço para a descrição da atividade e oferece links direto para o objeto alterado (item, metadado, coleção, taxonomia). Além disso, no botão “Ver mudanças”, você pode ver algumas alterações em detalhe. Este modal já existia antes mas agora está levemente melhorado:

Acompanhe o histórico de alterações de um metadado

Agora, caso a migração tenha sido feita em seu site, um novo recurso estará disponível! Hoje o registro de Atividades pode ser acompanhado em três níveis:

1. No repositório como um todo, através do menu “Atividades” do repositório;
2. No contexto de uma coleção, através do menu “Atividades” do submenu da coleção atual;
3. No contexto de um único item, através do modal que se abre no rodapé da página do item.

Agora estamos acrescentando mais um nível na interface: a visão de alterações por valor de metadado do item. Na página do item dentro da interface Administrativa do Tainacan, você verá ícones ao lado do título do metadado indicando que existem alterações naquele item.

Ao clicar nele, o modal de atividades abre, mostrando a lista de valores que aquele metadado já teve, quem o deixou assim, e quando:

Hierarquia de Termos na Página do Item

Mudando de assunto… se você já gastou tempo configurando uma Taxonomia Hierárquica com carinho, certamente já se viu frustrado por ver que algo definido desta forma…

…apareça assim na página do item:

Pois é. Nós sabemos o que você esperava… e finalmente está aqui:

Mas afinal, por quê tanta demora?

Nós costumamos evitar criar opções de “apresentação/aparência/design” dentro do plugin. Na teoria isso deveria ser responsabilidade dos Temas.

Se você quer que suas Taxonomias sejam um botão, com ícones ao lado e cores diferentes pra cada termos bom… talvez seu tema devesse implementar isso.

Mas listas hierárquicas são mais complexas. Elas dizem respeito não apenas à apresentação mas à estrutura do código HTML que vai mostrar estes termos (aninhando listas dentro de listas), agrupando valores pelos termos pai.

Portanto criamos uma nova opção no formulário de edição de Metadados, “Formatação HTML” que permite definir que um metadado multivalorado tenha seus valores exibidos em “lista” ao invés do tradicional layout “em linha” com os famosos separadores “|“.

E “lista” aqui, na prática, quer dizer que o HTML deste valor será envolvido por tags <ul><li>. Isso torna o código mais semanticamente correto, inclusive para indexadores e leitores de tela. Também por uma questão de consistência semântica, mesmo com “Lista” habilitado o metadado não será exibido em lista caso só haja um valor.

Formatação em Lista para Metadados Multivalorados

Ao discutirmos a chegada dessa funcionalidade para os metadados de Taxonomia não pudemos deixar de fora a possibilidade de se aproveitar este recurso em qualquer outro tipo de metadado. Afinal, se um metadado possui vários valores, pode ser que faça sentido vê-lo em lista:

Isso é particularmente útil quando estamos falando de metadados mais complexos, cujo valor se apresenta quase que como um “bloco”. Por exemplo, se tratando do metadado composto, seus valores já são exibidos quase que como uma lista. Mas a forma como esta lista é apresentada, a representação da hierarquia de valores que existe ali, fica à cargo dos temas. Por exemplo, este é um metadado composto no Tainacan Interface:

A indentação ao lado, a linha vertical e o separador aparecendo como uma linha horizontal ao invés da barra em pé (“|“) são graças ao Tainacan Interface.

Então como este tipo de dado fica em um tema que por padrão, não oferece suporte ao Tainacan?

Vejamos no TwentyTwentyFive:

Bem ruim, não é mesmo? Por isso concordamos que valores dos metadados Compostos multivalorados devem, por padrão, serem exibidos como lista. Isso permitirá que os temas já exibam a hierarquia de informação de uma forma mais apropriada, visto que todo tema estiliza um pouco suas listas HTML:

É verdade que nem todo mundo gosta destas “bolinhas”. Elas podem ser customizadas via CSS, logo isso vai ficar à cargo de cada tema. Para o Tainacan Interface e o Blocksy com o plugin de integração, já estamos lançando versões que garantam que esta lista seja exibida com os ajustes feitos anteriormente (a linha ao lado, a indentação e o separador horizontal) e sem a bolinha.

Outro caso onde a exibição em lista pode ser prominente é na exibição de metadados de relacionamento quando habilitamos alguns campos na opção “Metadados do item relacionados exibidos“:

Esta opção transforma o valor do metadado em uma “mini ficha” do item relacionado, ao invés de um simples link. Aqui novamente os temas que já oferecem suporte ao Tainacan podem tratar disso. Mas outros ficam a desejar. Com a nova opção (que no caso do metadado de Relacionamento, deve ser ativada manualmente),

saímos disso:

para isso:

E aqui é claro, há melhorias que podem ser feitas (como apresentar a miniatura e o título juntos, com mais destaque). Novamente entraríamos em um debate de “território do plugin vs. território do tema”. Mas consideramos um avanço importante a apresentação das listas para os valores multivalorados de forma geral.

Área de configuração dos blocos do Tainacan

Tirando benefício da nossa mais nova tela de Configuração do Plugin, temos uma nova seção com alguns recursos relacionados aos Blocos Gutenberg do Tainacan:

Por hora o que esta seção vem oferecer é a possibilidade de se desabilitar os blocos. Com o passar dos anos fomos criando novos blocos mas nem todos são úteis para os usuários. Desabilitar um bloco permite reduzir a quantidade de recursos carregados pelo seu site especialmente no contexto do editor de páginas/posts. Isso também deixa mais fácil localizar os blocos que você deseja no painel de inserção de blocos, quando está editando páginas.

Esta possibilidade de “limpar” o adicionador de blocos é particularmente útil se você não faz uso de outra funcionalidade: as Variações de Bloco. Este recurso, lançado na versão 0.20, permite a rápida inserção de um bloco de “Loop de consulta” do WordPress pré-configurado para listar Coleções, Taxonomias ou Itens de uma coleção Tainacan.

O bloco Loop de Consulta do WordPress costuma ter opções interessantes de customização de layout e pode ser estendido por plugins ganhando funcionalidades como paginação sob demanda de scroll. É ele que é usado para se mostrar listas de itens em temas de Blocos (FSE). Porém definir que em meio a vários tipos de post você quer aquele da sua coleção pode ser cansativo e é isso que a Variação de Bloco deixa pronto para você.

No fim, é uma funcionalidade “de nicho”, que pode poluir o seu adicionador de blocos visto que ao pesquisar por “itens” você verá o nome de cada uma das suas coleções como opção de Variação de Bloco do Loop de Consulta. A variação acaba aparecendo antes mesmos dos blocos padrão do Tainacan!

Por isso estamos também oferecendo na tela de configurações estas opções dedicadas para se desabilitar as variações, caso você não faça uso delas.

Melhorias

Tainacan em Alemão 🇩🇪

O Tainacan agora está oficialmente traduzido para Alemão! Isso não é pouca coisa, os falantes de Alemão compõe cerca de 5.6% do usuários do WordPress contabilizados no wp.org. Agrademos imensamente ao usuário Ralf Hilgenstock, que está fazendo um trabalho incrível inclusive de tradução deste site e de revisão de diversas strings em Inglês. Se você é da Alemanha e deseja se juntar a ele no esforço de construir este braço da comunidade, comente neste tópico.

Cores de Links e Botões nos Blocos do Tainacan

Tirando proveito de um recurso disponível nas últimas versões do Gutenberg, hoje estamos trazendo mais uma opção de customização dos blocos do Tainacan. Ao acessar a aba “Estilos”, na seção “Cor”, blocos que possuam botões e links como o os Carrosséis terão opções para se definir a cor de fundo e texto. Antes apenas texto e fundo existiam, de modo que alterar a aparência dos botões ficava inteiramente à cargo do tema.

E falando no bloco de carrossel, você pode notar alguns ajustes de espaçamentos nele. Estivemos revisando as regras CSS dele para permitir o uso das setas internamente ao Carrossel, algo que temas como o Tainá já faziam por padrão. Isso também deverá melhorar um pouco a responsividade destes botões de navegação em telas mobile.

Mais ajustes de acessibilidade

Seguimos nosso trabalho de revisão de diversos componentes em busca de um melhor suporte para usuários que dependem de leitores de tela. Nesta versão trazemos alguns ajustes:

• Diversas correções na Galeria de Mídias (que exibe o documento e anexos). Dentre estas está a remoção de elementos de carrossel e de listas que não possuem mais do que um único item, melhorando a semântica do HTML e reduzindo anúncios equivocados para leitores de tela;
• Diversas melhorias em componentes Autocomplete e Taginput, com uso mais apropriado de roles list, listbox, aria-controls e aria-expanded;
• Restauro do foco do teclado para o filtro original quando aplicados modais de filtros;
• Restauro de foco para os botões originais quando um elemento era acionado a partir de um item de dropdown que era por sua vez acionado por um botão e em diversos outros modais pela interface;
• Mais melhorias de acessibilidade em ícones que estavam sendo anunciados pelos leitores de tela;

Outras melhorias

• Seguindo uma discussão no fórum da comunidade, decidimos adicionar maior feedback visual para hierarquia dos menus que estão dentro do contexto de uma coleção. Isso Se dá com uma fonte de peso menor, respiro à esquerda e uma linha acima do separador da coleção;
• Remoção de anexos quando os itens são permanentemente removidos – este novo comportamento padrão deve reduzir o espaço ocupado por arquivos indesejados;
• Gráficos dos Relatórios agora são gerados em uma escala 3 vezes maior quando exportados em .png;
• Melhor responsividade em alguns dos blocos da página de relatórios;
• Garante que todos os valores de filtros checkbox selecionados aparecerão na lista da barra lateral, mesmo que isso ultrapasse o limite de opções que são carregadas por padrão no filtro;
• Compatibilidade com alterações de estilo do Admin do WordPress na versão 7.0;
• Melhor exibição sobre a quantidade de itens selecionados afetados no modal de edição em massa.
• As datas em telas de Atividades e Relatórios agora respeitam as configurações “locale” do navegador;
• E muitos outros ajustes internos no código!

Correções de erros

• Correção de um erros de segurança no uso do parâmetro status da API REST;
• Correção de erros de segurança na construção de GeoQueries, os parâmetros de filtragem usados nos metadados de GeoCoordenadas.
• Corrige pastas não sendo renomeadas para a estrutura _x_ quando itens públicos eram enviados para a Lixeira;
• Correção de erro que impedia inicialização da Galeria de Mídia em temas de Blocos como o Tainá e o TwentyTwentyFive;
• Corrige erro onde a primeira tag de filtro estava sempre vindo desabilitada;
• Modifica a lógica de registro de alguns scripts para corrigir a tradução faltante em blocos Gutenberg;
• Correções de CSS para que a cor de fundo de dropdowns não seja sobrescrita em sistemas que usam tema escuro;
• Carrosséis desativados na Galeria de Mídias não mostraram mais setas em temas sem suporte;
• Vários ajustes no campo de entrada do metadado de GeoCoordenadas;
• Permite a exibição de listas dentro de containers Masonry (como o modo de visualização “Ficha”) sem quebrar o script de posicionamento dos itens;
• Correções na detecção do “modo template” em blocos Gutenberg;
• Corrige a exibição de Metadados Compostos em tags Dublin Core;
• Reduz a atualização de valores de metadado duplicada que acontecia em alguns cenários na edição do item;
• Correção de pequeno erro na construção do XML dos endpoints OAI-PHM;
• Status customizados do WordPress agora aprecem de forma mais nativa, com rótulos apropriados.
• Correção de erros que deixavam a lista de itens em branco ao acessar a tela pela primeira vez;
• Correção de erros na inserção e ordenação de filtros;

Para desenvolvedores

• Novas opções disable_main_carousel e disable_thumbs_carousel na função tainacan_get_the_media_component permitem desativar o uso de carrosséis na galeria de mídias.
  • Por conta desta possibilidade, recomendamos que se estilize as novas classes tainacan-media-items e tainacan-media-item ao invés das anteriormente onipresentes swiper-wrapper e swiper-slide. A classe swiper também passará a existir somente no caso do carrossel estar ativado. Prefira neste caso usar tainacan-media-component__swiper-main e tainacan-media-component__swiper-thumbs
• A classe tainacan-taxonomy-tree-level estará disponível nos elementos <ul> de listas hierárquicas de termos para customização por temas.
  • Caso ainda o não tenha feito, vale também estilizar as classes tainacan-relationship-group e tainacan-compound-group, que estão nos itens multivalorados de relacionamentos com metadados internos ativados e de compostos. Recomendamos utilizar estas classes ao invés de elementos HTML puros como <ul><li> data a dinamicidade das tags;
• Para além da tela de configurações, desenvolvedores também podem filtrar os blocos Gutenberg do Tainacan disponíveis usando o filtro tainacan-blocks-available-blocks;
• Permite o uso do procolo :geo em links para corrigir valores de metadado de geolocalização exibidos fora do mapa;
• Se você vinha usando o filtro tainacan-api-response-metadatum-meta, agora ele também funciona em metadados filhos de compostos;
• O bloco “Lista de Itens do Tainacan”, que foi depreciado anos atrás na versão 0.18 foi oficialmente removido do código. Atualmente usa-se o “Lista de Itens da Coleção Tainacan”;

Baixe agora!

A versão 1.1.0 do Tainacan já está disponível para download no repositório de plugins do WordPress, assim como os temas e plugin complementares: