DF Download Center: documentação
Instalação, configuração e utilização do centro de transferências de produto: separador na ficha de produto, página central indexável, tipos de documentos, segurança dos ficheiros.
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
- A partir do back-office, aceda a Módulos e depois a Gestor de módulos.
- Clique em Instalar um módulo e envie o ficheiro
dfdownloadcenter-1.0.0.zip. - 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
transferenciasoudownloads. 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
- Clique em Adicionar.
- Introduza o título em cada idioma. O título é obrigatório no idioma por defeito.
- Acrescente uma descrição facultativa, igualmente por idioma. É apresentada por baixo do título no separador de produto e na página central.
- Escolha o tipo do documento.
- Selecione o ficheiro a colocar online.
- 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.
- Defina a posição do documento dentro do seu tipo, e o seu estado ativo.
- 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