CATAFLIP — Catálogo Digital para Dolibarr ERP CRM

Cataflip es un módulo open source que genera catálogos digitales interactivos a partir de los productos registrados en Dolibarr ERP. Produce dos salidas: un flipbook web con datos en tiempo real y un PDF editorial de alta calidad para impresión y envío.

---

Características

• Flipbook web interactivo — Catálogo con efecto de paso de página, accesible desde cualquier navegador sin necesidad de login. Los datos se cargan en tiempo real desde Dolibarr.
• Generación de PDF — PDF editorial de alta calidad generado desde el backend de Dolibarr, listo para imprimir o enviar por WhatsApp/email.
• Páginas híbridas — Combina páginas estáticas diseñadas por un profesional (portada, separadores, contraportada) con páginas de productos generadas automáticamente.
• Colores por categoría — Cada categoría de productos tiene su propio esquema de colores, configurado directamente desde los campos extra de Dolibarr.
• Membrete dinámico — Header y footer consistentes en cada página con logo, nombre de categoría y datos de contacto.
• Layouts configurables — Grillas de 4, 6 u 8 productos por página, y fichas detalladas con especificaciones técnicas.
• Sincronización automática — Si se agrega o desactiva un producto (tosell), el catálogo web se actualiza automáticamente.
• Responsive y touch — Compatible con dispositivos móviles, soporte de swipe y zoom.
• Control de permisos — Permisos granulares para ver el catálogo y para generar PDF.

Stack técnico

Componente	Tecnología
Flipbook web	StPageFlip (MIT)
Generación PDF	Chrome Headless + FPDI
Plantillas	PHP + HTML/CSS con diseño editorial
Datos	API REST de Dolibarr
Configuración	Extrafields en categorías de Dolibarr

Compatibilidad

Requisito	Versión
Dolibarr	14.0 o superior
PHP	8.1+
Node.js	18+ (para generación PDF)
Chrome/Chromium	Instalado en servidor (para generación PDF)

Nota: El flipbook web funciona sin Node.js ni Chrome. Estos solo son necesarios para la funcionalidad de generación de PDF.

Instalación

Requisitos previos

Tener Dolibarr ERP CRM instalado. Se puede descargar desde dolibarr.org.

Desde archivo ZIP

1. Descargar el archivo module_cataflip-x.x.x.zip desde Releases o desde DoliStore
2. En Dolibarr, ir a Inicio → Configuración → Módulos → Desplegar módulo externo
3. Subir el archivo ZIP

Si aparece un error indicando que no existe el directorio "custom", verificar en el archivo htdocs/conf/conf.php que las siguientes líneas estén descomentadas:

$dolibarr_main_url_root_alt = '/custom';
$dolibarr_main_document_root_alt = '/var/www/dolibarr/htdocs/custom';

Desde el repositorio Git

cd /var/www/dolibarr/htdocs/custom
git clone https://github.com/TU_USUARIO/cataflip.git cataflip

Dependencias para generación de PDF (opcional)

cd cataflip
composer install

Requiere Chrome/Chromium y Node.js 18+ instalados en el servidor.

Activación

1. Iniciar sesión en Dolibarr como superadministrador
2. Ir a Configuración → Módulos
3. Buscar "Cataflip" y activarlo
4. Ir a Configuración → Cataflip para establecer los parámetros iniciales

Configuración

Categorías de productos

Para que los productos aparezcan en el catálogo, deben cumplir dos condiciones:

• Estar marcados como en venta (tosell = 1)
• Pertenecer a una categoría con los extrafields configurados

Los campos extra disponibles en cada categoría son:

Campo	Descripción
cataflip_color	Color principal de la categoría (HEX)
cataflip_order	Orden de aparición en el catálogo
cataflip_image	Imagen del separador de sección
cataflip_layout	Layout de productos: grid-4, grid-6, grid-8, detail

Páginas estáticas

Desde Configuración → Cataflip se pueden subir las páginas diseñadas manualmente:

• Portada (imagen o PDF)
• Página "Quiénes somos" (imagen o PDF)
• Separadores de categoría (por categoría)
• Contraportada (imagen o PDF)

Uso

Catálogo web (público)

Una vez configurado, el catálogo está disponible en:

https://tu-dominio.com/custom/cataflip/public/catalog.php

Esta URL se puede compartir directamente con clientes. No requiere autenticación.

Generar PDF (backend)

Usuarios con el permiso cataflip->generate pueden generar el PDF desde:

Menú → Cataflip → Generar PDF

El PDF combina las páginas estáticas con las páginas de productos generadas dinámicamente.

Estructura del módulo

cataflip/
├── class/              # Clases PHP del módulo
├── core/
│   ├── modules/        # Descriptor del módulo
│   └── triggers/       # Triggers de Dolibarr
├── css/                # Estilos del catálogo
├── js/                 # StPageFlip y scripts
├── img/                # Recursos gráficos
├── langs/
│   ├── en_US/          # Traducciones inglés
│   └── es_ES/          # Traducciones español
├── lib/                # Funciones auxiliares
├── public/             # Página pública del catálogo
├── sql/                # Scripts SQL de instalación
├── tpl/                # Plantillas HTML del catálogo
│   ├── cover.tpl.php
│   ├── separator.tpl.php
│   ├── product_grid.tpl.php
│   ├── product_detail.tpl.php
│   └── back_cover.tpl.php
├── admin/              # Páginas de configuración
├── composer.json
└── README.md

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Hacer fork del repositorio
2. Crear una rama para tu feature (git checkout -b feature/nueva-funcionalidad)
3. Commit de los cambios (git commit -m 'feat: descripción del cambio')
4. Push a la rama (git push origin feature/nueva-funcionalidad)
5. Abrir un Pull Request

Hoja de ruta

• Prototipo visual del catálogo
• Estructura base del módulo Dolibarr
• Motor de plantillas HTML/CSS
• Integración con API REST de Dolibarr
• Flipbook web con StPageFlip
• Generación de PDF con Chrome Headless
• Publicación en GitHub y DoliStore
• Propuesta de integración al core de Dolibarr

Licencias

Código

GPLv3 o (a tu elección) cualquier versión posterior. Ver archivo COPYING para más información.

Documentación

Todos los textos y documentación están licenciados bajo GFDL.

---

Otros módulos externos disponibles en DoliStore.com.