Excel Topics

[Chico Gois]

Excel Topics 0.2.0-RC4

Exiba planilhas Excel diretamente nos tópicos do phpBB

Versão: 0.2.0-RC4
Compatibilidade: phpBB 3.3.17
PHP: 8.2 ou superior
Vendor: mundophpbb

Sobre a extensão

O Excel Topics permite anexar arquivos .xlsx ao primeiro post de um tópico e exibir automaticamente o conteúdo da planilha como uma tabela responsiva.

Quando o arquivo Excel é substituído por uma versão atualizada, a tabela exibida no tópico também é atualizada.

A extensão utiliza o sistema nativo de anexos do phpBB e não modifica arquivos do núcleo.

Principais recursos

• Exibição automática de arquivos XLSX anexados ao primeiro post.
• Leitura da aba ativa salva no Excel.
• Fallback para a primeira aba visível.
• Detecção de Tabelas estruturadas do Excel.
• Exibição apenas do intervalo definido pela Tabela do Excel.
• Preservação de títulos e informações úteis acima da tabela.
• Tabela responsiva com rolagem horizontal em dispositivos móveis.
• Exibição da data de atualização, quantidade de linhas e colunas.
• Organização dos arquivos em files/exceltopics/.
• Download seguro através do sistema de anexos do phpBB.
• Exclusão correta dos arquivos ao remover anexos, posts ou tópicos.
• Restauração segura dos anexos ao desativar a extensão.
• Cache de resultados e falhas de leitura.
• Limites de segurança para linhas, colunas, células e HTML gerado.
• Logs administrativos para falhas de leitura e armazenamento.

Novo atalho para ativar o suporte XLSX

A versão 0.2.0-RC4 adiciona uma página de diagnóstico no Painel de Controle Administrativo.

Após instalar e ativar a extensão, acesse:

Código: Selecionar todos

ACP
└── Postagem
└── Excel Topics
└── Suporte XLSX

Nesta página será possível verificar:

• se os anexos estão ativados globalmente;
• se a extensão xlsx está cadastrada;
• se o grupo de extensões está ativo;
• qual grupo está associado ao formato XLSX;
• qual é o limite atual de tamanho dos anexos.

Caso o formato XLSX ainda não esteja configurado, será exibido o botão:

Ativar suporte XLSX

Ao utilizar esse botão, a extensão:

• cria ou ativa o grupo Excel Topics;
• adiciona corretamente a extensão xlsx;
• configura o download interno seguro;
• define o limite inicial de 5 MiB;
• habilita o formato nos fóruns;
• mantém o formato desativado em mensagens privadas;
• limpa o cache de extensões de anexos;
• registra a alteração no log administrativo.

Importante: a extensão correta é xlsx, e não xlxs.

Como utilizar

1. Crie um novo tópico ou edite o primeiro post de um tópico existente.
2. Anexe um arquivo no formato .xlsx.
3. Publique ou salve a mensagem.
4. Abra o tópico.
5. A planilha será exibida automaticamente abaixo do conteúdo do primeiro post.

Para atualizar a tabela:

1. Edite o primeiro post.
2. Remova o XLSX antigo.
3. Anexe a nova versão do arquivo.
4. Salve a mensagem.

A tabela será atualizada automaticamente.

Comportamento das planilhas

Quando existir uma Tabela estruturada do Excel na aba selecionada, a extensão exibirá somente o intervalo definido por essa tabela.

Exemplo:

Código: Selecionar todos

Aba: Projeto 1
Tabela: Projeto1
Intervalo: B7:E16

Informações úteis localizadas acima da tabela, como títulos, responsáveis e prazos, também poderão ser exibidas.

Caso não exista uma Tabela estruturada, a extensão continuará utilizando o intervalo preenchido da planilha.

Limites atuais

Código: Selecionar todos

Formato aceito:          XLSX
Arquivos exibidos:       XLSX mais recente do primeiro post
Tamanho para renderizar: até 5 MiB
Máximo de linhas:        1.000
Máximo de colunas:       50
Caracteres por célula:   4.096

Recursos não incluídos

Esta extensão foi mantida propositalmente enxuta.

Não estão incluídos:

• edição das células diretamente no phpBB;
• reprodução completa de cores, bordas e fontes do Excel;
• gráficos incorporados;
• macros;
• Google Sheets;
• sincronização externa;
• fórmulas recalculadas pelo servidor;
• editor visual de planilhas;
• múltiplas planilhas independentes por tópico.

A edição direta das planilhas dentro do phpBB permanece fora do escopo atual.

Atualização a partir da RC3

1. Mantenha a extensão ativa.
2. Substitua os arquivos em:

Código: Selecionar todos

ext/mundophpbb/exceltopics/

1. Limpe o cache do phpBB.
2. Desative e ative novamente a extensão para instalar o novo módulo do ACP.
3. Não utilize a opção Excluir dados.
4. Limpe novamente o cache.
5. Acesse:

Código: Selecionar todos

ACP → Postagem → Excel Topics → Suporte XLSX

Instalação limpa

Extraia os arquivos para:

Código: Selecionar todos

ext/mundophpbb/exceltopics/

O arquivo principal deverá estar em:

Código: Selecionar todos

ext/mundophpbb/exceltopics/composer.json

Depois, acesse:

Código: Selecionar todos

ACP → Personalizar → Gerenciar extensões

Ative a extensão Excel Topics e, em seguida, configure o suporte XLSX em:

Código: Selecionar todos

ACP → Postagem → Excel Topics → Suporte XLSX

Requisitos do servidor

• PHP 8.2 ou superior.
• Extensão PHP ZipArchive.
• Extensão PHP XMLReader.
• Extensão PHP SimpleXML.

Em servidores Debian ou Ubuntu, normalmente são utilizados os pacotes:

Código: Selecionar todos

php-zip
php-xml

Observações

A versão 0.2.0-RC4 é uma versão candidata à versão estável.

Ela já foi testada com:

• upload e substituição de arquivos XLSX;
• Tabelas estruturadas do Excel;
• abas ativas;
• armazenamento em subpasta;
• download autenticado;
• exclusão de anexos e tópicos;
• ativação e desativação da extensão;
• logs administrativos;
• ativação automática do suporte XLSX pelo ACP.

Recomenda-se sempre realizar backup do banco de dados e da pasta files/ antes de atualizar extensões.

Desenvolvido por Mundo phpBB