Dolibarr, el sistema ERP y CRM de código abierto, es ampliamente utilizado por pequeñas y medianas empresas por su modularidad, flexibilidad y facilidad de uso. Sin embargo, como ocurre con cualquier software, las actualizaciones —aunque esenciales para la seguridad, las nuevas funciones y el rendimiento— pueden ocasionalmente provocar errores inesperados. Uno de los problemas más comunes tras actualizar Dolibarr es que el logotipo de la empresa no se visualiza correctamente o desaparece de la interfaz o de los documentos generados como facturas y presupuestos.

Este artículo ofrece una guía completa y práctica para identificar, diagnosticar y resolver problemas con la visualización del logotipo de la empresa después de una actualización de Dolibarr. Ya sea que hayas actualizado de la versión 16 a la 17, de la 18 a la 19 o a una versión más reciente, los pasos descritos aquí te ayudarán a restaurar la imagen de marca de tu empresa dentro de Dolibarr.

Comprender la naturaleza del problema

Después de una actualización, es posible que observes lo siguiente:

• El logotipo ya no se muestra en la esquina superior izquierda de la interfaz.

• El logotipo no aparece en documentos PDF (facturas, pedidos, presupuestos).

• El logotipo aparece dañado (imagen no encontrada o ruta inválida).

• Varios logotipos se muestran de forma incorrecta o superpuestos.

• Diferentes módulos muestran versiones distintas del logotipo.

Estos problemas pueden deberse a cambios en la estructura de carpetas, variables de configuración, permisos o en la lógica de renderizado de las plantillas.

Aspectos clave a comprobar

1. Configuración del sistema

2. Temas y plantillas

3. Sistema de archivos y carpeta de carga

4. Permisos de archivos y accesos

5. Compatibilidad con la versión de PHP

6. Caché del navegador y visualización

Vamos a revisar cada uno de ellos en detalle.

1. Configuración: verificar la ruta y el formato del logotipo

Ir a:

Inicio > Configuración > Empresa/Organización

En la sección "Logotipo y marca de agua":

• Asegúrate de que la ruta al archivo del logotipo sea correcta.

• Si has subido un nuevo logotipo, comprueba que aparece en la lista.

• Formatos compatibles: JPG, PNG, GIF – se recomienda PNG con fondo transparente.

Errores comunes:

• Tras la actualización, la ruta puede restablecerse a un valor predeterminado.

• El nombre del archivo puede contener caracteres especiales que Dolibarr no interpreta bien.

2. Problemas con temas y plantillas

El logotipo en la interfaz se muestra mediante CSS y lógica de plantilla.

Ir a:

Inicio > Configuración > Pantalla

Si el logotipo no aparece:

• Prueba un tema estándar (por ejemplo, "eldy" o "amarok").

• Verifica las plantillas en /htdocs/theme.

• En temas personalizados, asegúrate de que las etiquetas {logo} funcionen correctamente.

Para los PDFs:

• Ir a:

Módulos > Plantillas PDF

• Abrir el módulo correspondiente (facturas, pedidos, etc.)

• Verificar la ruta del logotipo en la configuración del módulo

3. Sistema de archivos y carpeta de carga

Los logotipos se almacenan en:

/htdocs/viewimage.php?modulepart=mycompany&file=logos/archivo_logo.ext

Verifica:

• Que la carpeta documents/mycompany/logos/ exista.

• Que el archivo del logotipo esté presente.

• Que el archivo no esté dañado (pruébalo directamente en el navegador).

Revisar también en conf.php:

$conf->mycompany->dir_output = '/var/www/html/documents/mycompany';

4. Permisos de archivos y carpetas

Permisos incorrectos pueden impedir que Dolibarr acceda al logotipo.

Verifica:

chmod -R 755 /var/www/html/documents/mycompany
chown -R www-data:www-data /var/www/html/documents/mycompany

Usa el usuario adecuado según tu sistema (www-data o apache).

5. Compatibilidad con PHP

Funciones como imagecreatefrompng() requieren librerías gráficas de PHP.

Después de la actualización:

• Asegúrate de que GD esté activado: php -m | grep gd

• Si falta: sudo apt install php-gd

• Reinicia Apache o PHP-FPM

Revisar registros:

/var/log/apache2/error.log
/var/log/php-fpm.log

6. Borrar caché del navegador y actualizar

A veces el problema está en el navegador:

• Borrar la caché del navegador

• Borrar caché de CDN o proxy

• Salir y volver a iniciar sesión en Dolibarr

Pasos para asignar el logotipo correctamente

1. Ir a:

Inicio > Configuración > Empresa/Organización

2. Desplazarse a la sección del logotipo

3. Subir un archivo PNG limpio (máx. 300px de ancho)

4. Asignar el logotipo

5. Guardar los cambios

6. Generar un PDF (por ejemplo, factura) y comprobar si el logotipo aparece

Si no aparece:

• Abrir la configuración del módulo PDF

• Restablecer o reasignar la ruta del logotipo

• Guardar y probar de nuevo

Entornos MultiCompany

Si utilizas el módulo MultiCompany:

• Cada empresa tiene su propio logotipo

• Cambia al contexto de cada empresa

• Repite el proceso de configuración

Ruta de ejemplo:

/documents/mycompany/ID_empresa/logos/logo.png

Rutas personalizadas en plantillas

Para usuarios avanzados:

• En plantillas PDF o HTML: usar dol_buildpath() o $conf->mycompany->dir_output

• Evita rutas absolutas que puedan romperse tras una actualización

Corrección automatizada desde la línea de comandos

Asignar logotipo vía SQL:

UPDATE llx_const SET value='logos/logo.png' WHERE name='MAIN_INFO_SOCIETE_LOGO';

• Luego borrar la caché o reiniciar servicios web

Mantenimiento de plantillas tras actualización

Las actualizaciones pueden modificar plantillas:

• Reaplicar configuraciones del logotipo

• Hacer copia de seguridad de /core/modules/facture/doc/

Usa control de versiones si trabajas con plantillas personalizadas.

Buenas prácticas para logotipos en Dolibarr

1. Usar nombres de archivo consistentes (sin espacios ni caracteres especiales)

2. Usar PNG optimizados (<150 KB)

3. Estructura de carpetas ordenada: logos/logo.png, logos/logo_small.png

4. Documentar rutas en entornos MultiCompany

5. Incluir archivo README en /documents/mycompany

Conclusión: conserva la identidad visual de tu empresa

La correcta visualización del logotipo es clave para la imagen y la credibilidad de tu empresa. Las actualizaciones de Dolibarr pueden afectar este aspecto por cambios en temas, configuración o plantillas. Sin embargo, con un enfoque ordenado, estos problemas son fáciles de resolver.

Al entender cómo Dolibarr gestiona, llama y muestra los logotipos, podrás identificar rápidamente los errores y restaurar tu identidad visual en todos los módulos y documentos.

Tanto si gestionas una sola empresa como si trabajas con MultiCompany, esta guía garantiza que tu logotipo siga siendo visible, coherente y profesional, incluso tras una gran actualización.