Dolibarr est une puissante solution ERP et CRM open source utilisée par des entreprises de toutes tailles pour gérer leurs opérations telles que la facturation, les stocks, les RH, etc. Comme pour tout outil professionnel, l'image de marque et l'identité visuelle sont essentielles. L'une des premières étapes pour personnaliser Dolibarr est de personnaliser son apparence, notamment son logo et ses couleurs. Ce guide complet vous guide pas à pas tout au long du processus, afin que votre instance Dolibarr reflète l'image de marque de votre entreprise.

Table des matières

  1. Introduction à Dolibarr

  2. Pourquoi personnaliser Dolibarr ?

  3. Comprendre la structure des fichiers de Dolibarr

  4. Préparation de vos ressources personnalisées

  5. Changer le logo

    • Logo de la page de connexion

    • Logo de navigation supérieur

    • Logos de documents PDF

  6. Personnalisation du jeu de couleurs

    • Fichiers et thèmes CSS

    • Modification des fichiers de thème

    • Utiliser du CSS personnalisé

  7. Création et application d'un thème personnalisé

  8. Conseils pour conserver les personnalisations lors des mises à jour

  9. Retour à l'apparence par défaut

  10. Réflexions finales et meilleures pratiques

1. Introduction à Dolibarr

Dolibarr ERP/CRM est une suite logicielle modulaire permettant aux entreprises de gérer un large éventail d'activités. Développée en PHP, elle utilise MySQL ou PostgreSQL pour la gestion de bases de données. Son caractère open source lui confère une grande flexibilité et une grande personnalisation. Les utilisateurs peuvent l'adapter à leurs besoins opérationnels spécifiques sans les contraintes de licence des logiciels propriétaires.

Dolibarr peut être installé sur site ou hébergé sur un serveur cloud, ce qui le rend accessible à un large public. Il est plébiscité par les PME, les indépendants et les ONG à la recherche d'une solution de gestion d'entreprise tout-en-un.

2. Pourquoi personnaliser Dolibarr ?

La cohérence de la marque est essentielle pour la communication interne et externe. Une installation Dolibarr personnalisée permet :

  • Améliorez l'expérience utilisateur en alignant l'interface avec l'image de marque de l'entreprise

  • Améliorer le professionnalisme lors des interactions avec les clients (par exemple, lors de l'envoi de factures PDF)

  • Facilitez la navigation et l'utilisation interne de votre instance

La personnalisation ne se limite pas à l'esthétique : elle est aussi une question de convivialité et d'identité. En personnalisant l'apparence de Dolibarr, vous l'intégrez davantage à l'écosystème de votre entreprise.

3. Comprendre la structure des fichiers de Dolibarr

Avant d'effectuer des modifications, il est essentiel de comprendre la structure de Dolibarr. Savoir où trouver certains fichiers vous fera gagner du temps et évitera des erreurs inutiles.

L'installation typique de Dolibarr comprend les répertoires suivants :

  • /htdocs - Le répertoire principal accessible sur le Web

  • /htdocs/theme - Contient tous les fichiers liés au thème

  • /htdocs/includes - Fichiers de configuration de base des maisons

  • /documents - Stocke les documents et logos téléchargés

Dans /htdocs/theme, chaque sous-dossier correspond à un thème (par exemple, eldy, md, bureau2crea). Chaque dossier de thème comprend des fichiers CSS, des images et du JavaScript spécifiques à ce thème.

4. Préparation de vos ressources personnalisées

Avant de vous lancer dans les modifications, rassemblez vos ressources personnalisées :

  • Fichiers de logos:De préférence au format PNG avec des arrière-plans transparents

  • Codes couleurs: Codes hexadécimaux des couleurs primaires et secondaires de votre marque

  • Backup: Sauvegardez toujours les fichiers de thème d'origine avant toute modification

Le fait de les avoir prêts garantit un processus de personnalisation plus fluide.

5. Changer le logo

Dolibarr utilise différents logos pour différentes parties de l'application. Vous devrez remplacer ou référencer votre nouveau logo à plusieurs endroits.

Logo de la page de connexion

Le logo de la page de connexion est souvent situé dans le chemin suivant :

/htdocs/theme/eldy/img/logo_login.png

Pour le changer:

  1. Renommez votre logo personnalisé en logo_login.png.

  2. Remplacer le fichier d'origine dans le img répertoire.

  3. Videz le cache de votre navigateur ou redémarrez le serveur Web pour voir les modifications.

Logo de navigation supérieur

Le logo en haut à gauche dans l'en-tête de l'application se trouve ici :

/htdocs/theme/eldy/img/logo_setup.png

Étapes pour changer :

  1. Renommez votre nouveau logo en logo_setup.png.

  2. Remplacez le fichier dans le même img répertoire.

  3. Vous pouvez également ajuster sa taille via CSS si elle ne s'adapte pas correctement.

Logos de documents PDF

Les factures, devis et autres documents PDF générés par Dolibarr utilisent également des logos. Ceux-ci sont généralement stockés dans le répertoire des documents ou spécifiés par un tiers ou une entreprise.

Pour définir un logo personnalisé :

  1. Cliquez sur Accueil > Configuration > Entreprise/Organisation.

  2. Téléchargez votre logo dans la section intitulée « Logo utilisé sur les documents ».

  3. Enregistrez les paramètres et testez en générant une facture PDF.

Chaque tiers peut également avoir son propre logo défini individuellement, utile pour les opérations multisites ou multimarques.

6. Personnalisation du jeu de couleurs

Les thèmes Dolibarr sont créés en CSS. Le thème par défaut s'appelle eldy, mais d’autres existent et peuvent être clonés ou modifiés.

Fichiers et thèmes CSS

Les fichiers CSS du thème se trouvent dans :

/htdocs/theme/eldy/style.css.php

Il s'agit d'un fichier PHP dynamique qui génère du CSS. Sa modification directe permet de modifier les couleurs globalement.

Les références de couleurs courantes dans le fichier incluent :

--colorbackbody: #f4f4f4;
--colorbackhmenu1: #333;
--colortexttitle: #222;

Modification des fichiers de thème

Pour modifier les couleurs :

  1. Ouvert style.css.php dans un éditeur de code.

  2. Recherchez la variable CSS que vous souhaitez modifier (par exemple, --colorbackbody).

  3. Remplacez la valeur par la couleur de votre marque.

  4. Enregistrez et actualisez votre instance Dolibarr.

Testez toujours d’abord dans un environnement de développement.

Utiliser du CSS personnalisé

Au lieu de modifier le thème par défaut, vous pouvez créer un fichier CSS personnalisé :

  1. Copiez le dossier de thème existant et renommez-le (par exemple, mytheme).

  2. modifier style.css.php et tous les éléments d'image qu'ils contiennent.

  3. Cliquez sur Accueil > Configuration > Affichage > Thème et sélectionnez votre thème personnalisé.

Il s’agit d’une approche plus sûre car elle évite d’écraser les modifications lors des mises à jour.

7. Création et application d'un thème personnalisé

Pour créer un thème entièrement personnalisé :

  1. Dupliquer un dossier de thème existant:

cp -r /htdocs/theme/eldy /htdocs/theme/mytheme

  1. Modifier style.css.php dans le nouveau dossier pour correspondre à votre palette de couleurs.

  2. Remplacer les ressources d'image (comme des logos) dans votre répertoire de thèmes personnalisés.

  3. Mettre à jour la sélection de thème dans les paramètres de Dolibarr.

Cette approche permet un contrôle total sur l'interface utilisateur et garantit la compatibilité avec les futures mises à jour (à condition que Dolibarr ne révise pas la gestion des thèmes).

8. Conseils pour conserver les personnalisations lors des mises à jour

Dolibarr est activement maintenu, et les mises à jour peuvent écraser les fichiers principaux. Pour éviter de perdre vos personnalisations :

  • Utiliser un dossier de thème personnalisé: Ne modifiez jamais directement le thème par défaut.

  • Documentez vos modifications:Conservez un journal des modifications des fichiers modifiés et des ressources remplacées.

  • Automatisez les sauvegardes: Des sauvegardes régulières vous aident à revenir en arrière si les mises à jour cassent quelque chose.

  • Tester les mises à jour dans un environnement de test: Ne mettez jamais à jour votre installation en direct sans tester.

Suivre ces pratiques vous fera économiser des heures de travail.

9. Retour à l'apparence par défaut

Si quelque chose ne va pas ou si vous souhaitez simplement revenir en arrière :

  1. Restaurer les fichiers de logo d'origine à partir d'une sauvegarde.

  2. Revenez au thème par défaut sous Affichage > Thème.

  3. Supprimez ou renommez votre dossier de thème personnalisé pour éviter les conflits.

10. Réflexions finales et meilleures pratiques

Personnaliser Dolibarr peut améliorer l'expérience utilisateur et renforcer l'image de marque de votre entreprise. Cependant, il est important de le faire systématiquement :

  • Planifiez vos changements à l’avance.

  • Utiliser des environnements de développement et de préparation.

  • Conservez des sauvegardes et de la documentation.

  • Tenez-vous-en à des thèmes personnalisés pour minimiser les perturbations lors des mises à niveau.

Que vous changiez un logo ou remaniiez l'interface utilisateur, la personnalisation permet à Dolibarr de s'intégrer naturellement à vos opérations commerciales. Grâce aux étapes de ce guide, vous pouvez prendre le contrôle de l'apparence de votre instance en toute confiance.