Download Center

[Chico Gois]

Download Center

Download Center é uma extensão para phpBB que adiciona uma área organizada para publicação, gerenciamento e distribuição de arquivos dentro do fórum.

A extensão foi pensada para comunidades que precisam disponibilizar extensões, estilos, pacotes, documentos, ferramentas ou qualquer outro tipo de arquivo com controle de versão, descrição estruturada e navegação simples para os usuários.

Principais funcionalidades

• Catálogo público de downloads
  Permite exibir os arquivos cadastrados em uma página pública organizada, com busca, filtros e ordenação.
• Categorias
  Os downloads podem ser separados por categorias, facilitando a navegação e a organização do conteúdo.
• Controle de versões
  Cada item pode possuir informações de versão, compatibilidade com phpBB, compatibilidade com PHP e changelog.
• Edição de itens existentes
  É possível atualizar as informações de um item já publicado sem precisar recriar o download do zero.
• Nova versão quando necessário
  Quando houver uma atualização real do pacote, o administrador ou usuário autorizado pode adicionar uma nova versão ao item existente.
• Suporte a BBCode
  Descrições, instruções e changelogs podem utilizar BBCode, incluindo formatação de texto, listas, links e cores.
• Upload ou link externo
  O download pode ser cadastrado com arquivo enviado diretamente ou com link externo, conforme a necessidade do fórum.
• Screenshots/imagens
  Permite associar imagens ao item, ajudando a apresentar melhor o conteúdo publicado.
• Área administrativa no ACP
  Inclui gerenciamento pelo painel administrativo do phpBB, permitindo configurar e administrar os downloads de forma integrada.
• Página pública integrada ao estilo do fórum
  A interface pública segue a aparência do phpBB, mantendo consistência visual com o restante da comunidade.
• Controle de permissões
  A extensão pode trabalhar com permissões para definir quem pode visualizar, enviar, editar ou administrar downloads.
• Meus envios
  Usuários autorizados podem acompanhar e gerenciar os próprios arquivos enviados.

Indicado para

• Fóruns que distribuem extensões phpBB
• Comunidades que compartilham estilos, traduções ou pacotes
• Projetos que precisam manter histórico de versões
• Áreas de suporte com arquivos organizados
• Fóruns que desejam substituir tópicos soltos por um catálogo estruturado

Resumo

Com o Download Center, o fórum passa a ter uma área própria para downloads, com organização por categorias, informações técnicas, controle de versões, edição de itens existentes, suporte a BBCode e integração com o painel administrativo do phpBB.

A proposta da extensão é facilitar a publicação e manutenção de arquivos, reduzindo a necessidade de criar novos tópicos ou repetir informações sempre que um item precisar ser atualizado.

[Chico Gois]

Mundo phpBB Download Center - Changelog

Version: 1.0.103

This release focuses on deeper integration with phpBB core infrastructure. The main goal of this update is to follow the principle:

Always use core infrastructure whenever possible.

Local file uploads are now handled through phpBB's native attachment system instead of relying primarily on custom upload validation and custom file storage logic.

Main changes

• phpBB attachment system integration
  Local uploads now use phpBB's native attachment infrastructure for validation, storage, quotas, file handling, and download counting.
• phpBB attachments are now the primary local upload path
  The extension now stores local download files as phpBB attachments and references them internally using attachment references.
• Core upload rules are now reused
  Allowed extensions, file size limits, quotas, and attachment validation now follow the phpBB attachment configuration instead of being duplicated inside the extension.
• Support forum is now required for local uploads
  Because local files are stored as phpBB attachments, a valid support forum must be selected before local files can be uploaded.
• Downloads can use phpBB's native attachment route
  When a download file is stored as a phpBB attachment, the public download link can use phpBB's native

  Código: Selecionar todos

  download/file.php

  route.
• Attachment download count integration
  Downloads backed by phpBB attachments now also increment the native phpBB attachment download counter.
• Support topic attachment linking
  When support topics are created or reused, attachment-backed download files are linked to the related topic/post where applicable.
• ACP upload settings simplified
  The custom "allowed extensions" and "maximum upload size" ACP fields were removed from the visible configuration because these rules are now inherited from phpBB's attachment settings.
• New ACP indicator for phpBB attachment storage
  The ACP now clearly shows that phpBB attachments are used for local uploads.
• Rules topic field improved
  The rules topic field now accepts a topic URL or a topic ID, making configuration easier for administrators.
• Short description now supports rich text editing
  The item short description field in the ACP was changed from a plain text input to a textarea with the BBCode toolbar.
• Category visibility enforcement improved
  Public item lists, item pages, screenshots, downloads, feeds, and statistics now respect disabled categories more consistently.
• ACP permissions improved
  ACP modules now allow access through the dedicated Download Center administrative permission where applicable, instead of depending only on the generic board administration permission.
• Notification type registration made more defensive
  The notification helper now checks for existing notification types before inserting them and handles duplicate registration scenarios more safely.
• New migrations added
  The update introduces migrations for the phpBB attachment-backed upload flow.
  
  New migration files:

  Código: Selecionar todos

  migrations/
  ├── v_1_0_101.php
  ├── v_1_0_102.php
  └── v_1_0_103.php

Technical details

• Added configuration key:

  Código: Selecionar todos

  mundophpbb_downloadcenter_use_phpbb_attachments

• Version updated to:

  Código: Selecionar todos

  1.0.103

• Local attachment-backed files are stored internally using attachment references.
• The extension now resolves phpBB attachment files from the native attachments table when serving or validating local downloads.
• Attachment-backed files use the real attachment filename when preparing the download response.
• The extension checks phpBB's configured upload path when resolving attachment-backed files.
• Deleting or replacing an attachment-backed local file now attempts to remove the related phpBB attachment reference.
• Diagnostics now require a valid support forum when phpBB attachment-backed uploads are active.
• Public download queries now also verify that the parent category is enabled.

Changed files

• Código: Selecionar todos

  composer.json

• Código: Selecionar todos

  acp/main_info.php

• Código: Selecionar todos

  acp/main_module.php

• Código: Selecionar todos

  adm/style/acp_downloadcenter.html

• Código: Selecionar todos

  controller/download_controller.php

• Código: Selecionar todos

  controller/main_controller.php

• Código: Selecionar todos

  service/notification_helper.php

• Código: Selecionar todos

  language/en/acp.php

• Código: Selecionar todos

  language/en/common.php

• Código: Selecionar todos

  language/pt_br/acp.php

• Código: Selecionar todos

  language/pt_br/common.php

• Código: Selecionar todos

  styles/all/template/downloadcenter_edit.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_index.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_item.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_mine.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_submit.html

• Código: Selecionar todos

  styles/all/theme/downloadcenter.css

• Código: Selecionar todos

  migrations/v_1_0_101.php

• Código: Selecionar todos

  migrations/v_1_0_102.php

• Código: Selecionar todos

  migrations/v_1_0_103.php

Important upgrade notes

• After this update, local uploads depend on phpBB's attachment configuration.
• Make sure attachments are enabled in phpBB.
• Make sure the desired file extensions are allowed in phpBB's attachment settings.
• Make sure the phpBB upload size limits are configured correctly.
• Select a valid support forum in the Download Center ACP settings before allowing local uploads.
• Clear the phpBB cache after replacing the extension files.
• Run the extension database update if phpBB asks for it.

Recommended update procedure

1. Go to the phpBB ACP.
2. Open Customise > Manage extensions.
3. Disable Mundo phpBB Download Center.
4. Do not delete the extension data.
5. Upload the new files to:

   Código: Selecionar todos

   ext/mundophpbb/downloadcenter/

6. Replace the old files with the new ones.
7. Clear the phpBB cache.
8. Enable the extension again.
9. Run the database update if requested.
10. Open the Download Center ACP settings.
11. Select or confirm a valid support forum.
12. Review phpBB's attachment settings, including allowed extensions, quotas, and maximum file size.
13. Save the Download Center settings.
14. Clear the phpBB cache again.

After updating, check

• Whether phpBB attachments are enabled globally.
• Whether the required file extensions are allowed in phpBB's attachment settings.
• Whether the selected support forum exists and is enabled.
• Whether local uploads work from both the ACP and the frontend submission form.
• Whether uploaded files appear as valid phpBB attachment-backed downloads.
• Whether download links work correctly.
• Whether disabled categories no longer expose items, files, screenshots, or feed/statistics entries.
• Whether ACP access works for administrators with the dedicated Download Center permission.

Developer note

This update intentionally moves upload handling closer to phpBB's own infrastructure. Instead of duplicating attachment validation, file size rules, extension checks, storage behavior, and download accounting inside the extension, the Download Center now delegates these responsibilities to phpBB wherever possible.

[Chico Gois]

Mundo phpBB Download Center - Changelog

Versão: 1.0.103

Esta versão foca em uma integração mais profunda com a infraestrutura nativa do phpBB. O objetivo principal desta atualização é seguir o princípio:

Você deve sempre usar a infraestrutura do núcleo quando possível.

Os uploads locais agora são tratados pelo sistema nativo de anexos do phpBB, em vez de depender principalmente de validações próprias de upload e lógica personalizada de armazenamento de arquivos.

Principais alterações

• Integração com o sistema de anexos do phpBB
  Os uploads locais agora usam a infraestrutura nativa de anexos do phpBB para validação, armazenamento, cotas, manipulação de arquivos e contagem de downloads.
• Anexos do phpBB agora são o caminho principal para uploads locais
  A extensão agora armazena arquivos locais de download como anexos do phpBB e os referencia internamente por meio de referências de anexo.
• Reutilização das regras nativas de upload
  Extensões permitidas, limites de tamanho de arquivo, cotas e validação de anexos agora seguem a configuração de anexos do phpBB, em vez de serem duplicados dentro da extensão.
• Fórum de suporte agora é obrigatório para uploads locais
  Como os arquivos locais são armazenados como anexos do phpBB, um fórum de suporte válido deve ser selecionado antes que arquivos locais possam ser enviados.
• Downloads podem usar a rota nativa de anexos do phpBB
  Quando um arquivo de download é armazenado como anexo do phpBB, o link público de download pode usar a rota nativa:

  Código: Selecionar todos

  download/file.php

• Integração com a contagem de downloads dos anexos
  Downloads baseados em anexos do phpBB agora também incrementam o contador nativo de downloads de anexos do phpBB.
• Vinculação de anexos aos tópicos de suporte
  Quando tópicos de suporte são criados ou reutilizados, os arquivos de download baseados em anexos são vinculados ao tópico/post relacionado quando aplicável.
• Configurações de upload no ACP simplificadas
  Os campos personalizados de “extensões permitidas” e “tamanho máximo de upload” foram removidos da configuração visível, pois essas regras agora são herdadas das configurações de anexos do phpBB.
• Novo indicador no ACP para armazenamento via anexos do phpBB
  O ACP agora mostra claramente que os anexos do phpBB são usados para uploads locais.
• Campo de tópico de regras melhorado
  O campo de tópico de regras agora aceita uma URL de tópico ou um ID de tópico, facilitando a configuração para administradores.
• Descrição curta agora suporta edição em texto rico
  O campo de descrição curta do item no ACP foi alterado de um input de texto simples para uma textarea com barra de BBCode.
• Aplicação melhorada da visibilidade das categorias
  Listas públicas de itens, páginas de item, capturas de tela, downloads, feeds e estatísticas agora respeitam categorias desativadas de forma mais consistente.
• Permissões do ACP melhoradas
  Os módulos ACP agora permitem acesso pela permissão administrativa dedicada do Download Center quando aplicável, em vez de depender apenas da permissão genérica de administração do fórum.
• Registro de tipos de notificação mais defensivo
  O helper de notificações agora verifica se os tipos de notificação já existem antes de inseri-los e trata cenários de registro duplicado com mais segurança.
• Novas migrations adicionadas
  A atualização introduz migrations para o fluxo de upload baseado em anexos do phpBB.
  
  Novos arquivos de migration:

  Código: Selecionar todos

  migrations/
  ├── v_1_0_101.php
  ├── v_1_0_102.php
  └── v_1_0_103.php

Detalhes técnicos

• Adicionada a chave de configuração:

  Código: Selecionar todos

  mundophpbb_downloadcenter_use_phpbb_attachments

• Versão atualizada para:

  Código: Selecionar todos

  1.0.103

• Arquivos locais baseados em anexos são armazenados internamente usando referências de anexo.
• A extensão agora resolve arquivos anexados do phpBB a partir da tabela nativa de anexos ao servir ou validar downloads locais.
• Arquivos baseados em anexos usam o nome real do anexo ao preparar a resposta de download.
• A extensão verifica o caminho de upload configurado no phpBB ao resolver arquivos baseados em anexos.
• Ao excluir ou substituir um arquivo local baseado em anexo, a extensão tenta remover a referência correspondente do anexo do phpBB.
• Os diagnósticos agora exigem um fórum de suporte válido quando uploads baseados em anexos do phpBB estão ativos.
• Consultas públicas de download agora também verificam se a categoria pai está ativada.

Arquivos alterados

• Código: Selecionar todos

  composer.json

• Código: Selecionar todos

  acp/main_info.php

• Código: Selecionar todos

  acp/main_module.php

• Código: Selecionar todos

  adm/style/acp_downloadcenter.html

• Código: Selecionar todos

  controller/download_controller.php

• Código: Selecionar todos

  controller/main_controller.php

• Código: Selecionar todos

  service/notification_helper.php

• Código: Selecionar todos

  language/en/acp.php

• Código: Selecionar todos

  language/en/common.php

• Código: Selecionar todos

  language/pt_br/acp.php

• Código: Selecionar todos

  language/pt_br/common.php

• Código: Selecionar todos

  styles/all/template/downloadcenter_edit.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_index.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_item.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_mine.html

• Código: Selecionar todos

  styles/all/template/downloadcenter_submit.html

• Código: Selecionar todos

  styles/all/theme/downloadcenter.css

• Código: Selecionar todos

  migrations/v_1_0_101.php

• Código: Selecionar todos

  migrations/v_1_0_102.php

• Código: Selecionar todos

  migrations/v_1_0_103.php

Observações importantes sobre a atualização

• Após esta atualização, os uploads locais dependem da configuração de anexos do phpBB.
• Certifique-se de que os anexos estejam ativados no phpBB.
• Certifique-se de que as extensões de arquivo desejadas estejam permitidas nas configurações de anexos do phpBB.
• Certifique-se de que os limites de upload do phpBB estejam configurados corretamente.
• Selecione um fórum de suporte válido nas configurações do Download Center antes de permitir uploads locais.
• Limpe o cache do phpBB após substituir os arquivos da extensão.
• Execute a atualização do banco de dados da extensão se o phpBB solicitar.

Procedimento recomendado de atualização

1. Acesse o ACP do phpBB.
2. Abra Personalizar > Gerenciar extensões.
3. Desative Mundo phpBB Download Center.
4. Não exclua os dados da extensão.
5. Envie os novos arquivos para:

   Código: Selecionar todos

   ext/mundophpbb/downloadcenter/

6. Substitua os arquivos antigos pelos novos.
7. Limpe o cache do phpBB.
8. Ative a extensão novamente.
9. Execute a atualização do banco de dados se for solicitado.
10. Abra as configurações do Download Center no ACP.
11. Selecione ou confirme um fórum de suporte válido.
12. Revise as configurações de anexos do phpBB, incluindo extensões permitidas, cotas e tamanho máximo de arquivo.
13. Salve as configurações do Download Center.
14. Limpe o cache do phpBB novamente.

Após atualizar, verifique

• Se os anexos estão ativados globalmente no phpBB.
• Se as extensões de arquivo necessárias estão permitidas nas configurações de anexos do phpBB.
• Se o fórum de suporte selecionado existe e está ativado.
• Se os uploads locais funcionam tanto pelo ACP quanto pelo formulário de envio no frontend.
• Se os arquivos enviados aparecem como downloads válidos baseados em anexos do phpBB.
• Se os links de download funcionam corretamente.
• Se categorias desativadas não expõem mais itens, arquivos, capturas de tela ou entradas de feeds/estatísticas.
• Se o acesso ao ACP funciona para administradores com a permissão dedicada do Download Center.

Nota para desenvolvedores

Esta atualização move intencionalmente o tratamento de uploads para mais perto da infraestrutura nativa do phpBB. Em vez de duplicar validação de anexos, regras de tamanho de arquivo, verificação de extensões, comportamento de armazenamento e contagem de downloads dentro da extensão, o Download Center agora delega essas responsabilidades ao phpBB sempre que possível.