É com grande entusiasmo que anunciamos a liberação do ABCD 3.3.0. Esta versão representa um marco importante no ciclo de vida do software, focando pesadamente em três pilares: Segurança, Autonomia Administrativa e Experiência do Usuário (UX).
Muitas destas melhorias nasceram da necessidade real da comunidade de operadores que precisam de ferramentas mais ágeis para manutenção, backup e diagnóstico, sem depender excessivamente de acesso direto ao servidor (shell/terminal).
Abaixo, detalhamos as principais novidades desta versão.
🛠 Novas Ferramentas Administrativas
A versão 3.3.0 introduz um conjunto de utilitários que transformam a maneira como o administrador interage com o sistema.
1. Gerenciador de Backups Integrado

Atendendo a pedidos antigos, agora é possível realizar backups diretamente pela interface web. O novo Gerenciador de Backups (admin_backup.php) elimina a necessidade de scripts complexos via linha de comando para a maioria das tarefas rotineiras.
- Três modalidades de backup:
- Apenas Bases: Rápido, salva apenas os dados bibliográficos.
- Bases + Mídia: Backup completo incluindo a pasta
collection(imagens, PDFs, etc.). - Base Específica: Selecione apenas uma base para gerar o backup.
- Armazenamento Seguro: Os arquivos são gerados na pasta
bases/wrk/backups, separados dos arquivos ISO, evitando confusão. - Portabilidade: O sistema detecta automaticamente o Sistema Operacional e adiciona prefixos (
Win_ouLin_) aos arquivos, facilitando a identificação da origem. - Download e Limpeza: Baixe o arquivo
.zipgerado para sua máquina local e exclua do servidor com um clique.- Nota Técnica: Esta funcionalidade requer a extensão
php-zipinstalada no servidor.
- Nota Técnica: Esta funcionalidade requer a extensão
2. Conversor de Bases Windows/Linux (Crunchmf)

A migração de bases entre servidores Windows e Linux sempre foi um ponto de atenção devido à compatibilidade dos arquivos binários (.mst e .xrf). O novo utilitário Export/Import (db_convert_crunchmf.php) utiliza a ferramenta crunchmf do CISIS para automatizar essa conversão:
- Converta uma base para o sistema operacional oposto com um clique.
- O sistema gera, compacta e disponibiliza o download da base convertida.
- Faça o upload de uma base convertida e o sistema se encarrega de restaurá-la, mantendo um backup da versão anterior automaticamente.
3. Visualizador de Logs de Erro

Diagnosticar problemas em hospedagens compartilhadas (como cPanel) ou servidores restritos ficou mais fácil. O novo visualizador permite ler o log de erros do PHP diretamente pelo ABCD.
- Visualização em tempo real (lê o arquivo do final para o início).
- Para ativar, basta adicionar um pequeno bloco de código ao seu
config.phpdefinindo o caminho do log para a pastabases/log/.
🔒 Segurança e Infraestrutura
Hardening do show_image.php

O script responsável pela exibição de imagens e documentos digitais foi reescrito com foco total em segurança e robustez:
- Verificação de Login: Agora verifica estritamente se o usuário está logado (
permiso) antes de exibir arquivos restritos. - Prevenção de Path Traversal: Implementação de
realpathe verificações para garantir que usuários maliciosos não acessem arquivos fora dos diretórios permitidos. - Mensagens de Erro: Melhor tratamento de erros (ex: arquivo não encontrado ou permissão negada) para facilitar o debug, sem expor dados sensíveis.
Portabilidade de Bases (PR #598)
Foi implementada a variável coringa %path_database%. Isso permite que caminhos de imagens e documentos sejam relativos, facilitando muito a vida de quem precisa mover o ABCD de uma pasta para outra ou migrar de servidor, sem quebrar os links das imagens.
🎨 Interface e Usabilidade (UI/UX)
A navegação e a aparência receberam ajustes finos para tornar o uso diário mais fluido.

- Navegação Otimizada:
- O botão de acesso ao OPAC foi movido para o topo, ganhando destaque.
- Botões de Módulos (Catalogação, Circulação, Aquisição) agora são persistentes, permitindo troca rápida de contexto.
- O seletor de idiomas foi movido para o rodapé, limpando a interface principal.
- Personalização: Novas opções no editor
abcd.defpermitem ocultar botões e o seletor de bases. Ideal para instituições que trabalham com uma única base de dados e querem uma interface mais limpa. - Entrada de Dados (Data Entry):
- Correção no comportamento do “acordeão” (sinais de
+e-). - Ajustes de alinhamento e largura nos formulários de catalogação (PR #598).
- Correção no comportamento do “acordeão” (sinais de
- Visualizador de Imagens: Agora conta com um botão nativo para visualização em Tela Cheia.
🌐 Melhorias no OPAC
O catálogo público também recebeu atenção especial:
- Modelo CEPAL: O banco de dados modelo CEPAL agora é totalmente funcional no OPAC, com um novo template (
opac.pft) baseado em Bootstrap. - Compatibilidade PHP 8+ : Correções de funções obsoletas e inclusão de polyfills (como
str_contains) garantem que o OPAC rode liso em servidores modernos e antigos. - Correção de Logs: Eliminadas mensagens de erro relacionadas a permissões de escrita de log no OPAC.
Como Atualizar?
Para aproveitar todas essas funcionalidades, recomendamos a atualização imediata.
- Lembrete: Para o funcionamento do Gerenciador de Backups, certifique-se de que a extensão
zipestá habilitada no seu PHP. - Logs: Para utilizar o visualizador de logs, verifique as instruções de configuração do
config.phpna documentação ou no PR #603.
Agradecimentos: Esta versão é fruto de intensa colaboração da comunidade. Agradecemos a todos que testaram, reportaram bugs e enviaram sugestões.
Equipe de Desenvolvimento ABCD
