Catálogo PDF para PrestaShop — Guía completa

Presentación

DFPDFCatalog publica tus catálogos PDF directamente en tu tienda PrestaShop. El módulo crea dos tipos de páginas en el front-office: una página vitrina que lista todos tus catálogos como banners clicables (/catalogues-pdf) y una página de visor por catálogo (/catalogue-pdf/{id}-{slug}) con un lector PDF integrado de nivel profesional: modo doble página tipo revista, miniaturas clicables, pantalla completa, zoom, enlaces clicables y texto seleccionable.

Instalación

1. Descarga el archivo ZIP del módulo desde tu cuenta DataFirefly.
2. En tu back-office de PrestaShop, ve a Módulos → Gestor de módulos → Subir un módulo.
3. Selecciona el archivo dfpdfcatalog.zip y confirma.
4. El módulo se instala automáticamente: tablas de base de datos, pestaña admin y rutas front se crean sin ninguna configuración manual.

Tras la instalación, aparece una nueva pestaña Catálogos PDF en el menú Catálogo del back-office.

Actualización desde una versión anterior

1. Sube la nueva versión mediante Módulos → Gestor de módulos → Subir un módulo (o reemplaza la carpeta /modules/dfpdfcatalog/ por FTP).
2. Vacía la caché de PrestaShop: Parámetros avanzados → Rendimiento → Vaciar caché.

La actualización conserva tus catálogos existentes: las tablas de base de datos y los archivos subidos (banners y PDF) no se tocan.

Añadir un catálogo

1. Ve a Catálogo → Catálogos PDF y haz clic en Añadir un catálogo.
2. Introduce el título (traducible por idioma) — también genera el slug de la URL y el meta title de la página.
3. Introduce la descripción (traducible) — se muestra en la página del visor y se usa como meta descripción.
4. Sube la imagen de banner — es la que aparece en la cuadrícula de la página vitrina.
5. Sube el archivo PDF.
6. Define la posición (orden de visualización en la cuadrícula) y el estado activo/inactivo.
7. En multi-tienda, marca las tiendas en las que debe aparecer el catálogo.
8. Guarda: el catálogo es inmediatamente visible en /catalogues-pdf.

Páginas front-office

Página vitrina

La página /catalogues-pdf muestra todos los catálogos activos de la tienda actual como una cuadrícula de banners, ordenados por posición. Cada banner enlaza al visor del catálogo. La página genera su propio meta title y meta descripción y se integra con las migas de pan nativas de PrestaShop.

Página del visor

Cada catálogo tiene su propia página en /catalogue-pdf/{id}-{slug}. El PDF se muestra en el visor integrado, con un botón de retorno a la vitrina y un botón de descarga directa. El PDF se sirve mediante un controlador PHP con la cabecera Content-Disposition inline, lo que fuerza la visualización en el navegador.

Usar el visor

El visor está construido sobre PDF.js (Mozilla) y ofrece los siguientes controles en su barra de herramientas:

• Miniaturas — muestra u oculta la barra lateral de miniaturas de páginas. Las miniaturas son clicables y se generan progresivamente al desplazarse (renderizado lazy), incluso en catálogos muy largos. La(s) página(s) activa(s) quedan resaltadas.
• Doble página — alterna entre la visualización página a página y el modo doble página tipo revista: portada sola, luego pares 2-3, 4-5, etc. Este modo se activa por defecto en pantallas de al menos 1024 px de ancho.
• Navegación — botones anterior/siguiente e indicador de página (por ejemplo «Página 4-5 / 24» en modo doble página). Las flechas izquierda/derecha del teclado también funcionan.
• Zoom — zoom +/- en pasos del 25 % y botón de ajuste automático al ancho.
• Pantalla completa — pasa el visor a pantalla completa mediante la API nativa del navegador. En iOS Safari se usa automáticamente un modo de pantalla completa simulado. La tecla Escape permite salir.

Los hipervínculos contenidos en el PDF siguen siendo clicables: los enlaces externos se abren en una nueva pestaña y los enlaces internos (índice, referencias) navegan directamente dentro del visor. Si el PDF contiene una capa de texto, el texto es seleccionable, copiable y la búsqueda Ctrl+F del navegador funciona sobre el contenido.

El renderizado usa la densidad de píxeles de la pantalla (HiDPI): las páginas se ven nítidas en pantallas Retina y 4K.

SEO y URLs

El módulo registra sus rutas mediante el hook moduleRoutes de PrestaShop:

• /catalogues-pdf — página vitrina con su propio meta title y meta descripción.
• /catalogue-pdf/{id}-{slug} — una URL limpia por catálogo, donde el slug se genera automáticamente a partir del título. El meta title usa el título del catálogo y la meta descripción usa su descripción.

No hay que crear ninguna página CMS: las rutas se registran automáticamente en la instalación.

Multilingüe y multi-tienda

Los títulos y descripciones se traducen campo a campo en el formulario de edición (selector de idioma estándar de PrestaShop). Cada idioma genera su propio slug y sus propios metas. En multi-tienda, la asociación catálogo/tienda se gestiona con casillas: cada tienda muestra solo los catálogos que tiene asignados.

Solución de problemas

El PDF no se muestra

• Verifica que el archivo PDF se subió correctamente (reedita el catálogo en el back-office).
• Vacía la caché de PrestaShop y recarga la página en navegación privada.
• Si aparece un mensaje de error en el visor, se ofrece un enlace de descarga directa del PDF como alternativa.

El texto no es seleccionable o Ctrl+F no encuentra nada

La selección de texto requiere que el PDF contenga una capa de texto. Los PDF escaneados o exportados como puro bitmap no la tienen: en ese caso solo es posible la visualización gráfica. Pasa el documento por una herramienta OCR si necesitas el texto.

Los enlaces del PDF no son clicables

Los enlaces deben ser verdaderas anotaciones de enlace en el PDF (creadas por la herramienta de exportación: InDesign, Word, LibreOffice…). Un texto que parece una URL pero sin anotación no será clicable.

Las páginas aparecen estiradas o borrosas

Este problema de la versión 1.0.0 está corregido desde la versión 1.0.1 (renderizado HiDPI y neutralización de los resets CSS de los temas). Actualiza el módulo y vacía la caché de PrestaShop.

Historial de versiones

• 1.0.4 (2026-05-11) — Modo pantalla completa (API nativa + fallback iOS Safari); corrección del fit-width de la portada en modo doble página; resaltado de botones activos.
• 1.0.3 (2026-05-11) — Modo doble página tipo revista (portada sola, luego 2-3, 4-5…); auto-activación en pantallas anchas; cancelación limpia de renders obsoletos en navegaciones rápidas.
• 1.0.2 (2026-05-11) — Barra lateral de miniaturas clicables con renderizado lazy; capa de texto (selección + Ctrl+F); botón de miniaturas.
• 1.0.1 (2026-05-11) — Renderizado HiDPI nítido en Retina/4K; enlaces del PDF clicables (capa de anotaciones); corrección del estiramiento vertical de páginas.
• 1.0.0 (2026-05-08) — Primera versión: página vitrina, visor integrado, URLs SEO, multilingüe, multi-tienda.