EasyOdt2Pdf

EasyOdt2Pdf para Dolibarr - Conversion ODT a PDF universal

EasyOdt2Pdf resuelve un problema recurrente en Dolibarr: la conversion nativa de plantillas ODT a PDF exige LibreOffice instalado en el servidor, lo que es imposible en hosting compartido y forzaria a tus clientes a contratar un VPS. Este modulo ofrece cinco backends enchufables que cubren todos los escenarios y elige automaticamente el mejor disponible.

Los 5 backends de conversion

BackendComo funcionaFidelidadRequisitos
PHP nativo (mPDF)Conversion 100 % en PHP sin binarios externos~80 %PHP 7.4+ (funciona en cualquier hosting compartido)
LibreOffice localsoffice --headless con instalador guiado100 %VPS o servidor dedicado con permisos de instalacion
unoconv localWrapper Python sobre LibreOffice100 %Linux con sudo + LibreOffice
Dolibarr nativoReutiliza la conversion interna Odf::exportAsAttachedPDF~90 %Dolibarr con MAIN_ODT_AS_PDF configurada
Gotenberg remotoHTTP POST a microservicio (LibreOffice headless en Docker)100 %Solo extension curl de PHP. Endpoint publico gratuito disponible en EasySoft (ver mas abajo).
El backend Gotenberg remoto es el unico que requiere conexion saliente. EasySoft Tech S.L. publica un endpoint gratuito en https://odt2pdf.microservices.easysoft.es sin necesidad de registro ni API key. Tambien puedes alojar tu propio Gotenberg en localhost con el docker-compose.yml incluido.

Casos de uso

• Facturas, presupuestos y albaranes generados como ODT que deben entregarse al cliente en PDF.
• Hosting compartido donde no se puede instalar LibreOffice ni ejecutar binarios.
• Multiples instalaciones Dolibarr compartiendo una infraestructura central de conversion.
• Migracion progresiva desde la conversion nativa de Dolibarr a un microservicio mas estable.
• Iteraciones futuras: firma digital PAdES, marcas de agua, cifrado - todo en PHP puro.

Caracteristicas

• Cinco backends de conversion: PHP nativo (mPDF), LibreOffice local, unoconv, Dolibarr nativo y Gotenberg remoto.
• Seleccion automatica con cadena de fallback configurable.
• Override por tipo de documento (facturas a Gotenberg, presupuestos a PHP, etc.).
• Instalador interactivo con deteccion del SO y guia paso a paso.
• Comprobacion exhaustiva del entorno: las 9 funciones PHP de ejecucion probadas individualmente.
• Auditoria inmutable de cada conversion.
• Diseno preparado para marca de agua, firma PAdES y cifrado.

Como funciona

1. Instala el modulo en custom/easyodt2pdf/ y activalo.
2. En la pestana Estado el modulo escanea automaticamente tu servidor y muestra que backends estan disponibles.
3. Configura el modo en la pestana Configuracion: auto, o un backend forzado, o un override por tipo de documento.
4. Cada vez que Dolibarr genere un ODT (factura, presupuesto, albaran...), el modulo lo convertira automaticamente a PDF.
5. La pestana Log guarda el rastro inmutable de cada conversion.

Que incluye el modulo

• Descriptor de modulo Dolibarr con permisos granulares (read, setup, install, convert, postprocess).
• Tabla de auditoria llx_easyodt2pdf_log.
• Pagina de admin con 5 pestanas nativas y 4 sub-vistas funcionales.
• 8 ficheros de idioma (es, en, fr, de, it, pt, ca, gl).
• Compose Docker para levantar Gotenberg en local durante el desarrollo.
• Workflow GitHub Actions para releases automaticos.

Compatibilidad y requisitos

• Dolibarr V16+ (compatible hasta V22+)
• PHP 7.4 - 8.3+
• MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• Navegador moderno con soporte ES6 y JavaScript
• Para backends locales: LibreOffice o unoconv instalables (el modulo guia la instalacion).
• Para Gotenberg remoto: solo extension curl activa.