# DF Download Center: documentação

> Apresentação O DF Download Center associa os seus manuais, instruções, fichas técnicas e certificados CE diretamente aos seus produtos. Cada ficha de produto ganha um separador «Documentos e transferências» que…

- Página: <https://www.datafirefly.com/pt/documentation/dfdownloadcenter/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfdownloadcenter/index.md), [en](https://www.datafirefly.com/en/documentation/dfdownloadcenter/index.md), [es](https://www.datafirefly.com/es/documentation/dfdownloadcenter/index.md), [de](https://www.datafirefly.com/de/documentation/dfdownloadcenter/index.md), [it](https://www.datafirefly.com/it/documentation/dfdownloadcenter/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdownloadcenter/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdownloadcenter/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O DF Download Center associa os seus manuais, instruções, fichas técnicas e certificados CE diretamente aos seus produtos. Cada ficha de produto ganha um separador «Documentos e transferências» que lista os ficheiros agrupados por tipo. Em paralelo, uma página central indexável reúne todo o catálogo documental, com pesquisa, filtros por tipo e dados estruturados JSON-LD.

O módulo é compatível com PrestaShop 8.0 a 9.x, multiloja, disponível em cinco idiomas, e não depende nem do Composer nem de nenhum framework externo.

**Adaptação para Portugal:** os quatro tipos de documentos por defeito e as etiquetas do módulo são entregues em FR, EN, ES, DE e IT. Renomeie os tipos em português a partir do ecrã de configuração (por exemplo «Manuais e instruções», «Fichas técnicas», «Certificados CE», «Outros documentos») e traduza as restantes cadeias em **Internacional → Traduções**. Os documentos entregues em português são também uma resposta prática à exigência de informação na língua do consumidor prevista pelo Decreto-Lei n.º 24/2014 e pelo regulamento GPSR.

## Instalação

1. A partir do back-office, aceda a **Módulos** e depois a **Gestor de módulos**.
2. Clique em **Instalar um módulo** e envie o ficheiro `dfdownloadcenter-1.0.0.zip`.
3. Clique em **Instalar**.

A instalação cria as tabelas do módulo, quatro tipos de documentos por defeito, um separador de administração no menu **Catálogo**, e regista os hooks necessários.

**Após a instalação, esvazie a cache** a partir de Parâmetros avançados e depois Desempenho. A rota da página central é declarada pelo hook de encaminhamento e só fica ativa após a regeneração da cache.

### Permissões

A pasta `modules/dfdownloadcenter/uploads/` tem de estar acessível para escrita pelo servidor web. Contém um ficheiro htaccess que bloqueia qualquer acesso HTTP direto: os ficheiros só saem através do controlador de transferência.

## Configuração

Abra o módulo a partir de **Módulos** e depois **Gestor de módulos**, e clique em **Configurar**.

### Página central

- **Ativar a página central**: quando está desativada, a página devolve um 404 e a ligação a partir do separador de produto desaparece.
- **Slug do URL**: o segmento de URL da página, por exemplo `transferencias` ou `downloads`. Esvazie a cache após qualquer alteração.
- **Documentos por página**: 20 por defeito.
- **Meta title** e **Meta description**: configuráveis idioma a idioma, usados na tag title e na meta description da página.

### Tipos de documentos

Quatro tipos são instalados por defeito, traduzidos nos cinco idiomas do catálogo:

- Manuais e instruções
- Fichas técnicas
- Certificados CE
- Outros documentos

A partir do ecrã de configuração, pode criar, renomear e reordenar os tipos. A **posição** determina a ordem de apresentação dos grupos no separador de produto e na página central.

Um tipo usado por pelo menos um documento não pode ser eliminado. O módulo mostra o número de documentos em causa e pede-lhe que os reatribua a outro tipo previamente.

## Gerir os documentos

Os documentos são geridos a partir de **Catálogo** e depois **Centro de transferências**. A lista mostra para cada documento o seu título, o seu tipo, o nome do ficheiro, o seu tamanho, o número de transferências e o seu estado de ativação.

### Criar um documento

1. Clique em **Adicionar**.
2. Introduza o **título** em cada idioma. O título é obrigatório no idioma por defeito.
3. Acrescente uma **descrição** facultativa, igualmente por idioma. É apresentada por baixo do título no separador de produto e na página central.
4. Escolha o **tipo** do documento.
5. Selecione o **ficheiro** a colocar online.
6. Associe os **produtos relacionados** escrevendo o seu nome ou a sua referência no campo de pesquisa: as sugestões aparecem a partir de dois caracteres, e cada produto selecionado torna-se uma etiqueta removível num clique.
7. Defina a **posição** do documento dentro do seu tipo, e o seu estado **ativo**.
8. Guarde.

### Formatos e tamanho dos ficheiros

As extensões aceites são: PDF, DOC, DOCX, ODT, XLS, XLSX, ODS, CSV, TXT, RTF, ZIP, PNG, JPG, JPEG, WEBP, SVG, DWG, DXF, STEP e STP. O tamanho máximo por ficheiro é de 50 MB.

Se um ficheiro com menos de 50 MB for recusado, verifique as diretivas `upload_max_filesize` e `post_max_size` da sua configuração PHP: o módulo não pode receber um ficheiro que o PHP recusa a montante.

### Substituir um ficheiro

Abra o documento em edição e selecione um novo ficheiro. O ficheiro antigo é eliminado do servidor automaticamente uma vez a atualização bem-sucedida. O contador de transferências é conservado.

### Um documento, vários produtos

A associação documento-produtos é múltipla. Um certificado CE que cobre três referências associa-se às três numa única introdução, e aparece então no separador de cada uma. Inversamente, um produto pode ter tantos documentos quantos forem necessários.

Um documento sem nenhum produto associado continua válido: não aparece em nenhum separador de produto, mas continua visível na página central. É o uso a reter para uma carta de qualidade, um catálogo geral ou qualquer documento de empresa.

## O separador de produto

Na ficha de produto, o separador «Documentos e transferências» aparece ao lado da descrição, através do hook nativo de extra content do PrestaShop. Nenhum ficheiro de tema é substituído.

Os documentos são aí agrupados por tipo, pela ordem definida pela posição dos tipos. Cada linha mostra uma etiqueta de extensão colorida, o título, a descrição facultativa, o tamanho do ficheiro e um botão de transferência. Uma ligação para a página central fecha o separador quando esta está ativa.

Se um produto não tiver nenhum documento ativo associado, o separador não aparece de todo.

## A página central

A página central é servida no URL definido pelo slug, por exemplo `/pt/transferencias` em português, ou `/en/transferencias` nos outros idiomas consoante a configuração multilingue da sua loja.

### Pesquisa e filtros

O campo de pesquisa consulta simultaneamente o título do documento, a sua descrição, o nome do ficheiro de origem, bem como o nome e a referência dos produtos associados. Um cliente que escreva uma referência de produto encontra portanto o manual correspondente.

Os filtros por tipo são apresentados sob a forma de etiquetas, com o número de documentos ativos em cada uma. A paginação é configurável a partir das definições.

### SEO

A página é concebida para ser indexada:

- meta title e meta description configuráveis por idioma;
- diretiva robots em index follow;
- URL canónico limpo: só o número de página é conservado, os filtros e a pesquisa são excluídos para evitar a duplicação;
- caminho de navegação;
- bloco de dados estruturados JSON-LD de tipo ItemList, que descreve cada ficheiro como um DigitalDocument;
- ligações internas para os produtos em causa, por baixo de cada documento.

## Transferência e segurança

Os ficheiros nunca são acessíveis diretamente. São escritos sob um nome em hash na pasta `uploads/` do módulo, bloqueada por um ficheiro htaccess.

A transferência passa obrigatoriamente por um controlador front-office que, antes de servir o ficheiro:

- verifica que o documento existe e que está ativo;
- verifica que está associado à loja atual;
- incrementa o contador de transferências;
- devolve o ficheiro com o seu nome de origem.

Os PDF e as imagens abrem-se no navegador; os outros formatos acionam uma transferência. Qualquer pedido inválido é redirecionado para a página 404 da loja.

## Multiloja

Os documentos são associados às lojas nativamente, através da associação de tabela padrão do PrestaShop. Em contexto multiloja, um documento criado numa loja só aparece nessa loja, e o controlador de transferência recusa servir um ficheiro associado a outra loja.

As definições da página central (slug, meta, paginação) são também geridas por loja.

## Desinstalação

A desinstalação elimina as tabelas do módulo, as suas variáveis de configuração, o seu separador de administração, e apaga a totalidade dos ficheiros presentes na pasta `uploads/`.

Guarde os seus ficheiros antes de desinstalar o módulo: os documentos colocados online não são recuperáveis após a desinstalação.

## Resolução de problemas

### O URL da página central devolve um 404

Esvazie a cache a partir de Parâmetros avançados e depois Desempenho. As rotas declaradas pelo hook de encaminhamento são colocadas em cache pelo PrestaShop e só são consideradas após regeneração.

Verifique também que os URL amigáveis estão ativos em Parâmetros da loja e depois Tráfego e SEO, e que a página central está ativa na configuração do módulo.

### O separador não aparece na ficha de produto

Verifique que o produto tem pelo menos um documento **ativo** associado, e que o hook de extra content está registado para o módulo na página Posições do back-office. Num tema muito personalizado, certifique-se de que o modelo de ficha de produto mostra os blocos de extra content.

### A transferência devolve um 404

Três causas possíveis: o documento está desativado, não está associado à loja atual, ou o ficheiro físico está ausente da pasta `uploads/`. Reedite o documento e volte a colocar o ficheiro online.

### O upload falha sem mensagem clara

Verifique as permissões de escrita em `modules/dfdownloadcenter/uploads/`, e depois as diretivas PHP `upload_max_filesize`, `post_max_size` e `max_file_uploads`.

## Compatibilidade técnica

- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Hooks usados: displayProductExtraContent, moduleRoutes, displayHeader, actionObjectProductDeleteAfter
- Nenhum override do núcleo, nenhuma dependência Composer
- Interface de autocompletar em JavaScript nativo, sem jQuery
- Multiloja e multilingue: FR, EN, ES, DE, IT