DF Download Center — Documentación
Instalación, configuración y uso del centro de descargas de producto: pestaña en la ficha, página central indexable, tipos de documentos, seguridad de los archivos.
Presentación
DF Download Center asocia sus manuales, instrucciones, fichas técnicas y certificados CE directamente a sus productos. Cada ficha de producto gana una pestaña «Documentos y descargas» que lista los archivos agrupados por tipo. En paralelo, una página central indexable reúne todo el catálogo documental, con búsqueda, filtros por tipo y datos estructurados JSON-LD.
El módulo es compatible con PrestaShop 8.0 a 9.x, multitienda, disponible en cinco idiomas, y no depende ni de Composer ni de ningún framework externo.
Instalación
- Desde el back office, vaya a Módulos y luego Gestor de módulos.
- Haga clic en Subir un módulo y suelte el archivo
dfdownloadcenter-1.0.0.zip. - Haga clic en Instalar.
La instalación crea las tablas del módulo, cuatro tipos de documentos por defecto, una pestaña de administración bajo el menú Catálogo y registra los hooks necesarios.
Tras la instalación, vacíe la caché desde Parámetros avanzados y luego Rendimiento. La ruta de la página central se declara mediante el hook de enrutamiento y solo se activa tras regenerar la caché.
Permisos
La carpeta modules/dfdownloadcenter/uploads/ debe tener permisos de escritura para el servidor web. Contiene un archivo htaccess que bloquea todo acceso HTTP directo: los archivos solo salen a través del controlador de descarga.
Configuración
Abra el módulo desde Módulos y luego Gestor de módulos, y haga clic en Configurar.
Página central
- Activar la página central — cuando está desactivada, la página devuelve un 404 y el enlace desde la pestaña de producto desaparece.
- Slug de la URL — el segmento de URL de la página, por ejemplo
descargasodownloads. Vacíe la caché tras cualquier modificación. - Documentos por página — 20 por defecto.
- Meta título y Meta descripción — configurables idioma por idioma, se usan en la etiqueta title y en la meta descripción de la página.
Tipos de documentos
Cuatro tipos se instalan por defecto, traducidos a los cinco idiomas del catálogo:
- Manuales e instrucciones
- Fichas técnicas
- Certificados CE
- Otros documentos
Desde la pantalla de configuración puede crear, renombrar y reordenar los tipos. La posición determina el orden de visualización de los grupos en la pestaña de producto y en la página central.
Un tipo utilizado por al menos un documento no puede eliminarse. El módulo muestra el número de documentos afectados y le pide reasignarlos previamente a otro tipo.
Gestionar los documentos
Los documentos se gestionan desde Catálogo y luego Centro de descargas. La lista muestra para cada documento su título, tipo, nombre de archivo, tamaño, número de descargas y estado de activación.
Crear un documento
- Haga clic en Añadir.
- Introduzca el título en cada idioma. El título es obligatorio en el idioma por defecto.
- Añada una descripción opcional, también por idioma. Se muestra bajo el título en la pestaña de producto y en la página central.
- Elija el tipo del documento.
- Seleccione el archivo que desea subir.
- Asocie los productos relacionados escribiendo su nombre o referencia en el campo de búsqueda: las sugerencias aparecen tras dos caracteres, y cada producto seleccionado se convierte en una etiqueta que puede eliminar con un clic.
- Defina la posición del documento dentro de su tipo y su estado activo.
- Guarde.
Formatos y tamaño de archivo
Las extensiones aceptadas son: PDF, DOC, DOCX, ODT, XLS, XLSX, ODS, CSV, TXT, RTF, ZIP, PNG, JPG, JPEG, WEBP, SVG, DWG, DXF, STEP y STP. El tamaño máximo por archivo es de 50 MB.
Si un archivo de menos de 50 MB es rechazado, compruebe las directivas upload_max_filesize y post_max_size de su configuración PHP: el módulo no puede recibir un archivo que PHP rechaza previamente.
Reemplazar un archivo
Abra el documento en edición y seleccione un nuevo archivo. El archivo anterior se elimina del servidor automáticamente una vez que la actualización tiene éxito. El contador de descargas se conserva.
Un documento, varios productos
La asociación documento-productos es múltiple. Un certificado CE que cubre tres referencias se asocia a las tres de una sola vez, y aparece entonces en la pestaña de cada una. A la inversa, un producto puede tener tantos documentos como sea necesario.
Un documento sin ningún producto asociado sigue siendo válido: no aparece en ninguna pestaña de producto, pero sigue visible en la página central. Es el uso indicado para una carta de calidad, un catálogo general o cualquier documento corporativo.
La pestaña de producto
En la ficha de producto, la pestaña «Documentos y descargas» aparece junto a la descripción, mediante el hook nativo de contenido adicional de PrestaShop. No se sobrescribe ningún archivo del tema.
Los documentos se agrupan por tipo, en el orden definido por la posición de los tipos. Cada línea muestra una etiqueta de extensión en color, el título, la descripción opcional, el tamaño del archivo y un botón de descarga. Un enlace a la página central cierra la pestaña cuando esta está activada.
Si un producto no tiene ningún documento activo asociado, la pestaña no aparece en absoluto.
La página central
La página central se sirve en la URL definida por el slug, por ejemplo /descargas, o /fr/descargas en otros idiomas según la configuración multilingüe de su tienda.
Búsqueda y filtros
El campo de búsqueda consulta simultáneamente el título del documento, su descripción, el nombre del archivo original, así como el nombre y la referencia de los productos asociados. Un cliente que escribe una referencia de producto encuentra por tanto el manual correspondiente.
Los filtros por tipo se muestran en forma de píldoras, cada una con el número de documentos activos. La paginación es configurable desde los ajustes.
SEO
La página está diseñada para ser indexada:
- meta título y meta descripción configurables por idioma;
- directiva robots en index follow;
- URL canónica limpia — solo se conserva el número de página, los filtros y la búsqueda se excluyen para evitar la duplicación;
- migas de pan;
- bloque de datos estructurados JSON-LD de tipo ItemList, que describe cada archivo como un DigitalDocument;
- enlaces internos hacia los productos afectados, bajo cada documento.
Descarga y seguridad
Los archivos nunca son accesibles directamente. Se escriben con un nombre cifrado en la carpeta uploads/ del módulo, bloqueada por un archivo htaccess.
La descarga pasa obligatoriamente por un controlador que, antes de servir el archivo:
- verifica que el documento existe y está activo;
- verifica que está asociado a la tienda actual;
- incrementa el contador de descargas;
- devuelve el archivo con su nombre original.
Los PDF y las imágenes se abren en el navegador; los demás formatos activan una descarga. Toda petición inválida se redirige a la página 404 de la tienda.
Multitienda
Los documentos se asocian a las tiendas de forma nativa, mediante la asociación de tablas estándar de PrestaShop. En contexto multitienda, un documento creado en una tienda solo aparece en ella, y el controlador de descarga se niega a servir un archivo asociado a otra tienda.
Los ajustes de la página central — slug, meta, paginación — también se gestionan por tienda.
Desinstalación
La desinstalación elimina las tablas del módulo, sus variables de configuración, su pestaña de administración, y borra la totalidad de los archivos presentes en la carpeta uploads/.
Haga una copia de seguridad de sus archivos antes de desinstalar el módulo: los documentos subidos no son recuperables tras la desinstalación.
Resolución de problemas
La URL de la página central devuelve un 404
Vacíe la caché desde Parámetros avanzados y luego Rendimiento. Las rutas declaradas mediante el hook de enrutamiento se almacenan en caché en PrestaShop y solo se tienen en cuenta tras la regeneración.
Compruebe también que las URL amigables están activadas en Parámetros de la tienda y luego Tráfico y SEO, y que la página central está activada en la configuración del módulo.
La pestaña no aparece en la ficha de producto
Compruebe que el producto tiene al menos un documento activo asociado, y que el hook de contenido adicional está correctamente registrado para el módulo en la página Posiciones del back office. En un tema muy personalizado, asegúrese de que la plantilla de la ficha de producto muestra los bloques de contenido adicional.
La descarga devuelve un 404
Tres causas posibles: el documento está desactivado, no está asociado a la tienda actual, o el archivo físico falta en la carpeta uploads/. Vuelva a editar el documento y suba el archivo de nuevo.
La subida falla sin mensaje claro
Compruebe los permisos de escritura en modules/dfdownloadcenter/uploads/, y luego las directivas PHP upload_max_filesize, post_max_size y max_file_uploads.
Compatibilidad técnica
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Hooks utilizados: displayProductExtraContent, moduleRoutes, displayHeader, actionObjectProductDeleteAfter
- Sin sobrescribir el núcleo, sin dependencia de Composer
- Interfaz de autocompletado en JavaScript nativo, sin jQuery
- Multitienda y multiidioma: ES, FR, EN, DE, IT