Cómo integrar un módulo personalizado en Dolibarr
   03/06/2025 00:00:00     Dolibarr    0 Comentarios
Cómo integrar un módulo personalizado en Dolibarr

Dolibarr es una solución ERP y CRM de código abierto conocida por su flexibilidad y modularidad. Gracias a su arquitectura, los usuarios pueden agregar funcionalidades específicas desarrollando módulos personalizados. Ya sea para satisfacer necesidades comerciales específicas, automatizar tareas o mejorar la experiencia del usuario, la integración de un módulo personalizado en Dolibarr es una solución ideal.

En este artículo, veremos paso a paso cómo integrar un módulo personalizado en Dolibarr, desde su diseño hasta su instalación, desarrollo y configuración.

1. ¿Por qué crear un módulo personalizado para Dolibarr?

Dolibarr ofrece una amplia gama de módulos predeterminados y extensiones disponibles en Dolistore. Sin embargo, a veces estas soluciones no cubren completamente las necesidades específicas de una empresa. Algunas razones para crear un módulo personalizado incluyen:

  • Automatizar procesos internos específicos de tu negocio.
  • Añadir nuevas funcionalidades no disponibles en Dolibarr o en los módulos existentes.
  • Modificar o mejorar la interfaz de usuario para optimizar la experiencia.
  • Crear conectores con otras aplicaciones utilizadas en la empresa.
  • Personalizar informes y paneles de control para un seguimiento más preciso.

2. Requisitos previos antes de integrar un módulo personalizado

Antes de comenzar la integración, asegúrate de que tu entorno de Dolibarr esté listo para aceptar un nuevo módulo.

2.1 Verificar la versión de Dolibarr

Cada módulo debe ser compatible con la versión instalada de Dolibarr. Para verificar la versión:

  1. Inicia sesión en Dolibarr como administrador.
  2. Ve a Inicio → Configuración → Información del sistema.

Asegúrate de que tu módulo sea compatible con esta versión.

2.2 Activar el modo desarrollador

Dolibarr ofrece un modo desarrollador que permite visualizar errores y facilitar la depuración:

  1. Ve a Configuración → Varios.
  2. Agrega la siguiente línea en el archivo conf/conf.php:
    php
    $dolibarr_main_prod = 0;

2.3 Acceder al directorio de módulos

Todos los módulos de Dolibarr se almacenan en el siguiente directorio:

bash
htdocs/custom/

Se recomienda crear tus propios módulos en este directorio para evitar sobrescribir archivos nativos al actualizar Dolibarr.

3. Desarrollar un módulo personalizado para Dolibarr

Un módulo de Dolibarr está compuesto principalmente por archivos PHP y estructuras específicas.

3.1 Crear la estructura del módulo

Un módulo en Dolibarr sigue la siguiente estructura:

bash
htdocs/custom/mimodulo/ │── core/ │ ├── modules/ │── class/ │── admin/ │── script/ │── mimodulo.php │── README.md │── modulebuilder.json

Explicación de los directorios:

  • core/modules/: Contiene los archivos de configuración del módulo.
  • class/: Define las clases PHP utilizadas por el módulo.
  • admin/: Interfaz de administración del módulo.
  • script/: Scripts adicionales para instalación o actualización.

3.2 Crear el archivo de configuración del módulo

El archivo principal del módulo (mimodulo.php) permite que Dolibarr reconozca el módulo:

php
class modMimodulo extends DolibarrModules { function __construct($db) { global $langs; $this->db = $db; $this->numero = 500000; $this->family = "custom"; $this->name = "Mimodulo"; $this->description = "Un módulo personalizado para Dolibarr"; $this->version = "1.0"; $this->rights_class = 'mimodulo'; } }

3.3 Añadir una tabla SQL para almacenar datos

Si el módulo necesita almacenar información específica, se debe crear una tabla SQL:

sql
CREATE TABLE llx_mimodulo ( rowid INT AUTO_INCREMENT PRIMARY KEY, label VARCHAR(255) NOT NULL, date_creation TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB;

El script SQL se puede colocar en script/install.sql y ejecutar al activar el módulo.

4. Instalar y activar el módulo en Dolibarr

Una vez desarrollado el módulo, debe integrarse en Dolibarr.

4.1 Copiar el módulo en Dolibarr

Coloca la carpeta del módulo en:

bash
htdocs/custom/

4.2 Activar el módulo desde la administración

  1. Ve a Configuración → Módulos/Aplicaciones.
  2. Busca tu módulo en la lista.
  3. Haz clic en Activar.
  4. Si es necesario, ejecuta los scripts SQL asociados.

5. Probar y depurar el módulo

5.1 Verificar los registros de errores

Si el módulo no funciona correctamente, consulta los registros de errores de Dolibarr en:

bash
htdocs/documents/dolibarr.log

5.2 Activar el modo de depuración de PHP

Añade la siguiente línea en conf/conf.php para mostrar errores:

php
ini_set('display_errors', 1); error_reporting(E_ALL);

5.3 Realizar pruebas de usuario

  • Verificar si los permisos funcionan correctamente.
  • Probar la interfaz y los formularios del módulo.
  • Asegurar la compatibilidad con otros módulos activos.

6. Distribuir y mantener el módulo

Si deseas compartir tu módulo con la comunidad, puedes:

  • Publicarlo en Dolistore (el marketplace de módulos de Dolibarr).
  • Compartir el código en GitHub/GitLab para actualizaciones colaborativas.
  • Asegurar la compatibilidad con nuevas versiones de Dolibarr, realizando pruebas y actualizaciones periódicas.

Conclusión

La integración de un módulo personalizado en Dolibarr permite adaptar el ERP a necesidades específicas y agregar funcionalidades a medida. Siguiendo estos pasos – desde la creación del módulo, su configuración, instalación y pruebas – podrás mejorar Dolibarr sin modificar su núcleo.

Con conocimientos básicos de desarrollo en PHP y una buena gestión de actualizaciones, puedes optimizar la gestión de tu empresa integrando funciones diseñadas específicamente para tus necesidades.

¿Alguna vez has integrado un módulo personalizado en Dolibarr? ¡Comparte tu experiencia en los comentarios!

Comentarios

Inicia sesión o regístrate para publicar comentarios