Time Line Tainacan

Plugin WordPress para criar linhas do tempo responsivas com os itens e metadados nativos do Tainacan.

As timelines consultam o acervo pela API REST do próprio WordPress. Alterações feitas nos itens do Tainacan aparecem na próxima abertura da página, sem exportação ou sincronização manual.

Recursos

• Bloco Gutenberg para uma coleção ou para todo o repositório.
• Data inicial obrigatória e data final opcional.
• Campos opcionais de resumo, grupo, categoria e local.
• Busca textual e filtro por grupo.
• Layout horizontal responsivo e layout vertical em telas pequenas.
• Navegação por ano, setas e teclado.
• Miniaturas e links para os itens originais no acervo.
• Limite configurável de até 10.000 eventos.
• Paginação em lotes de 1.000 eventos para limites acima de 1.000.
• Shortcodes em português e inglês.

Requisitos

• WordPress 6.5 ou superior.
• PHP 7.4 ou superior.
• Plugin Tainacan ativo.
• Um metadado Tainacan do tipo Data preenchido nos itens.

Instalação

O procedimento completo está em docs/INSTALACAO.md.

Resumo:

1. Baixe o arquivo ZIP da versão desejada na página de releases.
2. No WordPress, acesse Plugins > Adicionar plugin > Enviar plugin.
3. Selecione o ZIP, instale e ative Time Line Tainacan.
4. Confirme que o Tainacan também está ativo.

Criar uma timeline

1. Acesse Páginas > Adicionar nova.
2. Insira o bloco Time Line Tainacan.
3. Escolha uma coleção ou ative Usar todo o repositório.
4. Selecione o metadado Data inicial.
5. Configure os campos opcionais e as opções de exibição.
6. Publique a página.

O WordPress também disponibiliza o tutorial em WP Admin > Time Line Tainacan.

Shortcodes

Coleção específica:

[tainacan_linha_do_tempo colecao="123" data_inicio="456"]

Todo o repositório:

[tainacan_linha_do_tempo repositorio="true" data_inicio="456"]

Exemplo completo:

[tainacan_linha_do_tempo colecao="123" data_inicio="456" data_fim="457" resumo="458" grupo="459" local="460" limite="300" ordem="asc" imagens="true" busca="true" filtro_grupos="true" cor="#1f656d"]

Os números são os IDs da coleção e dos metadados no Tainacan. O bloco Gutenberg é a forma recomendada porque apresenta as opções sem exigir IDs.

Paginação

Até 1.000 eventos, a timeline é carregada em uma única página. Para limites entre 1.001 e 10.000, o plugin mostra um aviso no editor e consulta lotes de até 1.000 registros. Nesse modo, busca e filtros atuam sobre a página atualmente carregada.

Solução de problemas

Nenhum evento com data foi encontrado

Verifique se:

• o metadado selecionado é do tipo Data;
• os itens publicados possuem esse metadado preenchido;
• o metadado pertence à coleção selecionada;
• no modo de repositório, o metadado está disponível nas coleções desejadas;
• o visitante possui permissão para ler os itens.

Alterações do acervo não aparecem

O plugin não mantém cache próprio. Limpe caches de página, CDN ou proxy e exclua de cache a rota:

/wp-json/gesta-tainacan-timeline/v1/

Desenvolvimento

Os arquivos distribuíveis ficam na raiz do repositório. Não há etapa de build. Depois de alterar PHP ou JavaScript, valide:

find . -name '*.php' -print0 | xargs -0 -n1 php -l
node --check assets/js/timeline.js
node --check assets/js/block-editor.js

Licença

GPL-3.0-or-later. Consulte LICENSE.

Autor

Emiliano Calado