libarr es una solución ERP y CRM de código abierto utilizada por empresas para gestionar eficazmente sus actividades administrativas, contables y comerciales. Uno de los mayores beneficios de Dolibarr es su modularidad, que permite agregar funcionalidades según las necesidades específicas del negocio.

Ya sea para la gestión de facturas, inventarios, proyectos o recursos humanos, la instalación y configuración de módulos permite personalizar Dolibarr y optimizar los procesos empresariales.

En este artículo, explicaremos paso a paso cómo instalar y configurar un módulo en Dolibarr, incluyendo los diferentes métodos de instalación, configuraciones esenciales y mejores prácticas para garantizar un funcionamiento óptimo.

1. ¿Dónde encontrar módulos para Dolibarr?

Dolibarr ofrece varias fuentes para descargar módulos:

• Módulos nativos: Algunos módulos ya están incluidos en Dolibarr y solo necesitan activarse.
• Dolistore: El marketplace oficial de Dolibarr ofrece una gran variedad de módulos gratuitos y de pago para añadir nuevas funcionalidades.
• Marketplaces alternativos: Algunos desarrolladores ofrecen módulos en plataformas como GitHub, GitLab, DolibarrStore y Dolimarketplace.
• Desarrollo personalizado: Las empresas con necesidades específicas pueden desarrollar e instalar su propio módulo.

Antes de instalar un módulo, siempre verifique su compatibilidad con la versión de Dolibarr que está utilizando.

2. Métodos de instalación de un módulo en Dolibarr

Existen tres métodos principales para instalar un módulo en Dolibarr:

2.1 Instalación desde la interfaz de Dolibarr

Si el módulo proviene de Dolistore o una fuente oficial, puede instalarlo directamente desde la interfaz de Dolibarr:

1. Acceda a Dolibarr como administrador.
2. Vaya a "Inicio" → "Configuración" → "Módulos/Aplicaciones".
3. Haga clic en "Añadir un módulo externo".
4. Cargue el archivo ZIP del módulo.
5. Haga clic en "Subir", y Dolibarr instalará el módulo automáticamente.

Una vez instalado, el módulo aparecerá en la lista de módulos disponibles.

2.2 Instalación manual vía FTP o SSH

Si obtuvo un módulo de una fuente externa (como GitHub o un desarrollador independiente), deberá instalarlo manualmente:

1. Descargue el archivo ZIP del módulo.
2. Extraiga el archivo en su computadora.
3. Suba la carpeta del módulo al siguiente directorio de Dolibarr:
   bash

   htdocs/custom/
4. Asegúrese de que los permisos de los archivos estén correctamente configurados:
   bash

   chmod -R 755 htdocs/custom/mymodule
5. Acceda a Dolibarr, navegue hasta "Módulos/Aplicaciones", y el módulo debería aparecer en la lista.

2.3 Instalación a través de Git

Para instalar un módulo directamente desde un repositorio Git (útil para actualizaciones automáticas), siga estos pasos:

1. Conéctese a su servidor mediante SSH.
2. Vaya al directorio htdocs/custom/:
   bash

   cd /var/www/html/dolibarr/htdocs/custom/
3. Clone el módulo desde GitHub o GitLab:
   bash

   git clone https://github.com/nombreproyecto/mymodule.git
4. Configure los permisos de los archivos:
   bash

   chmod -R 755 mymodule
5. El módulo aparecerá automáticamente en Dolibarr en "Módulos/Aplicaciones".

3. Activación de un módulo en Dolibarr

Después de instalar un módulo, debe activarlo:

1. Vaya a "Inicio" → "Configuración" → "Módulos/Aplicaciones".
2. Encuentre el módulo instalado en la lista.
3. Haga clic en "Activar".
4. Si es necesario, siga las instrucciones adicionales de configuración del módulo.

Algunos módulos requieren la ejecución de un script SQL para crear tablas en la base de datos. Dolibarr notificará si esto es necesario.

4. Configurar un módulo después de la instalación

Cada módulo puede incluir configuraciones específicas que deben ajustarse según las necesidades del usuario:

1. Acceder a la configuración del módulo

   • Después de la activación, haga clic en "Configurar" junto al módulo.
   • Ajuste los parámetros de acuerdo con sus requerimientos empresariales.

2. Administrar permisos de usuario

   • Vaya a "Inicio" → "Usuarios y Grupos".
   • Asigne los permisos de acceso a los usuarios que necesiten utilizar el módulo.

3. Probar el módulo

   • Realice pruebas funcionales para asegurarse de que todo funcione correctamente.
   • Revise los registros de errores en Dolibarr en caso de problemas:
     bash

     tail -f htdocs/documents/dolibarr.log

5. Actualizar o desinstalar un módulo

5.1 Actualizar un módulo

Si hay una nueva versión disponible, siga estos pasos:

• Desde la interfaz de Dolibarr: Descargue la nueva versión e instale el módulo nuevamente.
• Desde FTP/Git: Reemplace los archivos existentes en htdocs/custom/ y verifique si es necesario actualizar la base de datos.

Antes de actualizar, se recomienda realizar una copia de seguridad completa de Dolibarr.

5.2 Desinstalar un módulo

Si ya no necesita un módulo, puede desinstalarlo:

1. Desactive el módulo en "Módulos/Aplicaciones".
2. Elimine su carpeta de htdocs/custom/.
3. Si es necesario, elimine las tablas relacionadas en la base de datos (con precaución).

6. Mejores prácticas para la instalación de módulos en Dolibarr

• Verifique siempre la compatibilidad del módulo con su versión de Dolibarr.
• Pruebe el módulo en un entorno de prueba antes de implementarlo en producción.
• Realice una copia de seguridad completa antes de instalar o actualizar un módulo.
• No modifique los archivos del núcleo de Dolibarr, para evitar problemas con futuras actualizaciones.
• Utilice módulos de fuentes confiables, como Dolistore, GitHub, DolibarrStore o Dolimarketplace.

Conclusión

La instalación y configuración de un módulo en Dolibarr permite ampliar las funcionalidades del ERP y personalizar el sistema según sus necesidades empresariales. Con esta guía, podrá descargar, instalar, activar y configurar módulos de forma sencilla y segura.

Ya sea para gestión comercial, facturación, inventario o gestión de proyectos, los módulos de Dolibarr ofrecen personalización avanzada y mejoran la eficiencia operativa de su empresa.

¿Ha instalado un módulo en Dolibarr antes? ¡Comparta su experiencia en los comentarios!