Dolibarr, le système ERP et CRM open source, est largement utilisé par les petites et moyennes entreprises pour sa modularité, sa flexibilité et sa facilité d’utilisation. Cependant, comme tout logiciel, les mises à jour – bien qu’essentielles pour la sécurité, les nouvelles fonctionnalités et les performances – peuvent parfois introduire des dysfonctionnements inattendus. L’un des problèmes récurrents rencontrés par les utilisateurs après la mise à jour de Dolibarr est l'affichage incorrect ou l'absence du logo de l'entreprise dans l'interface ou sur les documents générés comme les factures et les devis.

Cet article propose un guide complet et pratique pour identifier, diagnostiquer et résoudre les problèmes d'affichage du logo de l’entreprise après une mise à jour de Dolibarr. Que vous soyez passé récemment de la version 16 à 17, de 18 à 19, ou à une version ultérieure, les étapes présentées ici vous aideront à rétablir votre image de marque dans Dolibarr.

Comprendre la nature du problème

Après une mise à jour, vous pourriez constater :

• Le logo ne s’affiche plus dans le coin supérieur gauche de l’interface.

• Le logo est absent des PDF (factures, commandes, devis).

• Le logo semble cassé (image introuvable ou chemin invalide).

• Plusieurs logos s’affichent mal ou se chevauchent.

• Différents modules affichent différentes versions du logo.

Ces problèmes peuvent être dus à des changements dans la structure des dossiers, des variables de configuration, des permissions, ou dans la logique de rendu des templates.

Principaux points à vérifier

1. Paramètres de configuration

2. Thèmes et modèles d’affichage

3. Système de fichiers et répertoire d’upload

4. Permissions utilisateurs et accès aux fichiers

5. Compatibilité de la version PHP

6. Cache et affichage navigateur

Examinons chaque point.

1. Paramètres de configuration : Vérifier le chemin et le format du logo

Accédez à :

Accueil > Configuration > Société/Organisation

Dans la section « Logo et filigrane » :

• Vérifiez que le chemin du fichier logo est correct.

• Si vous avez téléversé un nouveau logo, assurez-vous qu’il apparaît dans la liste.

• Vérifiez le format : JPG, PNG et GIF sont pris en charge. Utilisez de préférence un PNG avec fond transparent.

Problèmes fréquents :

• Le chemin du logo peut revenir à un paramètre par défaut après la mise à jour.

• Le nom du fichier logo contient parfois des caractères spéciaux que Dolibarr gère mal.

2. Problèmes de thèmes et de modèles

Le logo dans l’interface utilisateur est géré par le CSS et la logique de template du thème.

Accédez à :

Accueil > Configuration > Affichage

Vérifiez le thème sélectionné. Si le logo ne s’affiche pas :

• Essayez temporairement un thème par défaut (ex : "eldy" ou "amarok").

• Vérifiez les fichiers templates dans /htdocs/theme.

• Pour les thèmes personnalisés, assurez-vous que les balises {logo} ne sont pas rompues suite à des changements.

Pour les templates PDF :

• Allez dans :

Accueil > Modules > Templates PDF

• Ouvrez le module concerné (Factures, Commandes...)

• Vérifiez le chemin du logo dans la configuration du modèle

3. Système de fichiers et répertoire d’upload

Dolibarr stocke les logos dans :

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

Vérifiez :

• Que le dossier documents/mycompany/logos/ existe.

• Que votre fichier logo est bien présent dans ce répertoire.

• Que l’image n’est pas corrompue (testez en ouvrant le lien direct dans un navigateur).

Vérifiez également le chemin dans conf.php :

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

4. Permissions des fichiers et répertoires

Des permissions incorrectes peuvent empêcher Dolibarr d'accéder au logo.

Assurez-vous :

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

Utilisez l’utilisateur adapté à votre configuration (www-data ou apache).

5. Compatibilité PHP

Certaines fonctions (comme imagecreatefrompng()) nécessitent des bibliothèques graphiques PHP.

Après la mise à jour :

• Vérifiez que la bibliothèque GD est activée : php -m | grep gd

• Si elle manque : sudo apt install php-gd

• Redémarrez Apache ou PHP-FPM

Vérifiez les logs :

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

6. Vider les caches et rafraîchir le navigateur

Parfois, le problème vient du cache navigateur :

• Videz le cache de votre navigateur.

• Si vous utilisez un CDN ou un proxy, purgez le cache.

• Dolibarr stocke aussi certaines préférences en session – déconnectez-vous puis reconnectez-vous.

Procédure pas à pas pour réaffecter un logo

1. Allez dans :

Accueil > Configuration > Société/Organisation

2. Allez à la section du logo

3. Téléversez un fichier PNG propre et redimensionné (max 300px de large)

4. Affectez ce logo

5. Enregistrez

6. Allez dans un module qui utilise le logo (ex : Factures), générez un PDF

7. Vérifiez si le logo apparaît

Si non :

• Ouvrez la configuration du module PDF

• Réaffectez ou videz le champ du chemin du logo

• Enregistrez et essayez à nouveau

Cas des environnements multi-sociétés

Si vous utilisez le module MultiCompany :

• Chaque société a ses propres paramètres de logo

• Changez de contexte société

• Répétez la procédure de configuration du logo

Vérifiez les chemins :

/documents/mycompany/ID_societe/logos/logo.png

Assurez-vous que chaque société a son logo dans le bon dossier.

Logos personnalisés dans les templates

Pour les utilisateurs avancés :

• Dans les modèles PDF ou HTML personnalisés, utilisez dol_buildpath() ou $conf->mycompany->dir_output

• Évitez les chemins absolus qui peuvent casser après mise à jour

Correction automatisée via ligne de commande

Vous pouvez aussi corriger le logo via SQL :

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

• Puis videz les caches ou redémarrez les services

Maintenance des modèles après mise à jour

Chaque mise à jour peut modifier les modèles PDF :

• Réappliquez vos paramètres de logo

• Sauvegardez vos dossiers /core/modules/facture/doc/ ou /doc/

Utilisez un gestionnaire de versions pour vos modèles personnalisés.

Bonnes pratiques pour les logos dans Dolibarr

1. Gardez un nom de fichier cohérent (pas d'espaces ou caractères spéciaux)

2. Utilisez des fichiers PNG optimisés (moins de 150 Ko)

3. Structurez vos logos : logos/logo.png, logos/logo_small.png

4. Documentez les emplacements pour MultiCompany

5. Ajoutez un fichier README dans /documents/mycompany

Conclusion : Gardez votre identité visuelle intacte

L’affichage du logo est essentiel pour la crédibilité et l’image de votre entreprise. Les mises à jour de Dolibarr peuvent parfois perturber cet affichage à cause de changements dans les thèmes, les paramètres ou les modèles. Heureusement, ces problèmes peuvent presque toujours être résolus en suivant une approche structurée.

En comprenant comment Dolibarr stocke, appelle et affiche les logos, vous pourrez rapidement identifier l’origine des dysfonctionnements et restaurer votre image de marque dans tous les modules et documents.

Que vous gériez une seule société ou plusieurs entités, suivez les étapes de ce guide pour garantir que vos logos restent visibles, cohérents et professionnels – même après une mise à jour majeure.