Partie 2 : Installation Addon Odoo

Ateliers Pro AP1 - Odoo Partie 2

Partie 2 : Installation et sélection d'un addon Odoo

Pour résoudre le problème de séparation Nom/Prénom, j'ai dû analyser et installer un addon Odoo.

Analyse comparative des addons disponibles

Le TP proposait 5 addons à évaluer. J'ai analysé chacun pour choisir le plus adapté.

Addon Version Odoo Fonctionnalité Adapté ?
Contacts full name
(kw_signup_full_name)		 16.0 Gestion nom complet lors de l'inscription utilisateur Non (hors contexte)
Partner Name Hide Parent 15.0 Cache le nom du contact parent dans l'affichage Non (version incompatible)
Partner first name and last name
(partner_firstname)		 16.0 Sépare le champ Nom en Prénom + Nom de famille OUI - Parfait !
TGL Partner Advance Search 12.0 Recherche avancée de contacts Non (version obsolète)
Contacts full name
(kw_partner_full_name)		 16.0 Gestion automatique du nom complet Partiellement (pas de séparation)
Addon choisi : Partner firstname (partner_firstname)

Justification du choix :
  • Compatible Odoo 16.0 : fonctionne avec notre version
  • Sépare Prénom / Nom : ajoute 2 champs distincts
  • Génération automatique du nom complet : concatène Prénom + Nom
  • Addon simple et léger : pas de dépendances complexes
  • Bien documenté : documentation claire sur Odoo Apps
  • Activement maintenu : dernière mise à jour récente
  • Très bien noté : excellentes évaluations utilisateurs

Image suggérée : Screenshot page addon Partner firstname sur Odoo Apps

Source : Partner firstname sur Odoo Apps

Le dossier /opt sous Linux

Qu'est-ce que le dossier /opt ?

Le dossier /opt (pour "optional") est un répertoire standard du système de fichiers Linux défini par le FHS (Filesystem Hierarchy Standard).

Rôle et utilisation :
  • Logiciels optionnels : applications non fournies par les dépôts officiels
  • Applications tierces : logiciels propriétaires ou personnalisés
  • Packages autonomes : applications qui s'installent en un seul bloc
  • Séparation système/applications : évite de mélanger avec /usr

Structure typique :
Chaque application a son propre sous-dossier : /opt/nom_application/
Exemple : /opt/odoo/, /opt/google/chrome/, etc.

Dans notre cas :
Les addons personnalisés Odoo seront installés dans /opt/odoo/addons/ pour les distinguer des addons officiels dans /usr/lib/python3/dist-packages/odoo/addons/

Référence :
Linux Foundation - Filesystem Hierarchy Standard v3.0
https://refspecs.linuxfoundation.org/FHS_3.0/fhs/index.html

Installation de l'addon Partner firstname

J'ai installé l'addon manuellement en suivant la procédure Odoo.

Méthode d'installation manuelle

  1. Téléchargement de l'addon
    Téléchargement du module depuis Odoo Apps (fichier ZIP)
  2. Transfert sur le serveur
    # Transfert du fichier ZIP depuis mon PC vers la VM
    scp partner_firstname.zip user@100.115.29.182:~/
  3. Création du dossier addons personnalisés
    # Connexion SSH à la VM
    ssh user@100.115.29.182

    # Création du dossier /opt/odoo/addons
    sudo mkdir -p /opt/odoo/addons

    # Attribution des droits à l'utilisateur odoo
    sudo chown -R odoo:odoo /opt/odoo
  4. Extraction et copie de l'addon
    # Extraction du ZIP
    unzip partner_firstname.zip -d ~/

    # Copie vers /opt/odoo/addons/
    sudo cp -r ~/partner_firstname /opt/odoo/addons/

    # Vérification
    ls -la /opt/odoo/addons/
  5. Configuration du chemin des addons
    # Édition du fichier de configuration Odoo
    sudo nano /etc/odoo/odoo.conf

    # Ajout/modification de la ligne addons_path
    addons_path = /usr/lib/python3/dist-packages/odoo/addons,/opt/odoo/addons
  6. Redémarrage d'Odoo
    # Redémarrage du service pour prendre en compte le nouvel addon
    sudo systemctl restart odoo

    # Vérification du statut
    sudo systemctl status odoo
  7. Activation du mode développeur dans Odoo
    Dans l'interface web : Paramètres → Activer le mode développeur
  8. Mise à jour de la liste des applications
    Apps → Menu ⋮ → Mettre à jour la liste des applications
  9. Recherche et installation de l'addon
    Recherche "Partner firstname" → Clic sur Installer

Image suggérée : Screenshot terminal avec installation addon

Source : Capture terminal Linux avec commandes ci-dessus

Addon installé avec succès !
L'addon Partner firstname est maintenant actif dans Odoo.

Vérification du bon fonctionnement

Après installation, j'ai vérifié que les champs Prénom et Nom apparaissent bien.

Nouveaux champs dans les fiches contacts

Champs ajoutés par l'addon

  • Prénom : nouveau champ pour le prénom uniquement
  • Nom de famille : nouveau champ pour le nom uniquement
  • Nom (calculé) : généré automatiquement = Prénom + Nom

Image suggérée : Screenshot fiche contact avec Prénom/Nom séparés

Source : Capture d'écran Odoo montrant les 2 champs

Test d'import du CSV exemple

J'ai re-testé l'import du fichier clients_particuliers_exemple.csv :

  1. Menu Vente → Clients → Favoris → Importer
  2. Sélection du fichier CSV
  3. Mapping des colonnes :
    • CSV "Prénom" → Odoo "Prénom"
    • CSV "Nom" → Odoo "Nom de famille"
    • CSV "Email" → Odoo "Email"
    • etc.
  4. Validation de l'import
  5. Les 10 clients ont été importés correctement !
Problème résolu !
L'addon Partner firstname permet maintenant d'importer les fichiers CSV avec colonnes Prénom et Nom séparées.
Partie 1 : Création VM Partie 3 : Tests CSV