Un module Odoo personnalisé est un simple dossier de fichiers, mais son organisation obéit à des règles précises que l'on peut apprendre en quelques minutes. Voici la structure à respecter, un exemple minimal et la marche à suivre pour l'installer sans risque.
Un module Odoo personnalisé est un dossier de fichiers qui ajoute ou modifie des fonctions de votre Odoo sans toucher au cœur du logiciel. Vous n'avez pas besoin d'être développeur pour comprendre comment il est construit, et cela aide beaucoup à dialoguer avec un prestataire, ou avec une IA, quand vous commandez une évolution.
Précision utile : les noms de menus, de champs et certaines balises varient selon la version d'Odoo. Les exemples ci-dessous sont des bases à vérifier dans la documentation officielle de votre version.
Pourquoi un module Odoo personnalisé plutôt que des réglages ?
Odoo permet déjà beaucoup de choses sans écrire de code : ajouter un champ, créer une vue, définir une action automatisée. Ces réglages suffisent souvent. Un module devient pertinent dans plusieurs cas :
- vous voulez regrouper plusieurs modifications dans un ensemble cohérent, installable et désinstallable d'un bloc ;
- vous devez reproduire la même configuration sur plusieurs bases (test, production, filiale) ;
- vous avez besoin d'une règle métier qui dépasse ce que l'interface permet ;
- vous voulez conserver une trace claire de ce qui a été ajouté, plutôt que des réglages dispersés.
Un point d'attention : selon votre hébergement, l'ajout de modules personnalisés n'est pas toujours possible. À notre connaissance, une instance Odoo Online standard n'accepte pas de code Python personnalisé, alors qu'une installation sur votre propre serveur ou sur Odoo.sh le permet. Vérifiez ce point auprès de votre éditeur ou de votre hébergeur avant de commencer.
La structure d'un module, dossier par dossier
Un module est un dossier posé dans un emplacement que votre serveur Odoo sait lire (on l'appelle le « chemin des addons », c'est-à-dire la liste des dossiers où Odoo cherche les modules). Voici une organisation classique, avec un module fictif nommé `suivi_visites` :
``` suivi_visites/ ├── __init__.py ├── __manifest__.py ├── models/ │ ├── __init__.py │ └── visite.py ├── views/ │ └── visite_views.xml ├── security/ │ └── ir.model.access.csv ├── data/ └── static/ ```
Chaque élément a un rôle précis :
- `__manifest__.py` : la carte d'identité du module (nom, description, dépendances, liste des fichiers à charger). Sans lui, Odoo ignore le dossier.
- `__init__.py` : indique à Python quels sous-dossiers contiennent du code. Il peut être presque vide, mais il doit exister.
- `models/` : les modèles, c'est-à-dire la description des « objets » manipulés (une visite, un devis, un contrat) et de leurs champs.
- `views/` : les fichiers XML qui décrivent l'affichage (formulaires, listes), les actions et les menus.
- `security/` : les droits d'accès, qui précisent qui peut lire, modifier, créer ou supprimer.
- `data/` : les données livrées avec le module (valeurs par défaut, modèles d'e-mails).
- `static/` : images, icône, styles.
Le manifeste ressemble à ceci :
```python { 'name': 'Suivi des visites', 'version': '1.0', 'summary': 'Enregistrer les visites clients', 'depends': ['base'], 'data': [ 'security/ir.model.access.csv', 'views/visite_views.xml', ], 'license': 'LGPL-3', 'installable': True, } ```
La ligne `depends` liste les modules dont le vôtre a besoin. Si vous vous appuyez sur les contacts ou les ventes, il faudra les déclarer ici (par exemple `contacts` ou `sale`). La convention de numérotation de `version` dépend de la version d'Odoo : consultez la documentation officielle.
Un exemple minimal pour comprendre le principe
Dans `models/visite.py`, vous décrivez l'objet et ses champs :
```python from odoo import models, fields
class SuiviVisite(models.Model): _name = 'suivi.visite' _description = 'Visite client'
name = fields.Char(string='Objet', required=True) date = fields.Date(string='Date') note = fields.Text(string='Compte rendu') ```
Sans ligne supplémentaire, Odoo créera la table correspondante dans la base de données à l'installation. Le fichier `models/__init__.py` doit contenir `from . import visite`, et le `__init__.py` à la racine `from . import models`.
Le fichier `security/ir.model.access.csv` donne ensuite les droits. Sans lui, le module s'installe, mais les utilisateurs ordinaires ne voient rien :
``` id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink access_suivi_visite_user,suivi.visite user,model_suivi_visite,base.group_user,1,1,1,0 ```
Le `model_suivi_visite` correspond au nom du modèle dont les points sont remplacés par des tirets bas. Ici, les utilisateurs internes peuvent lire, modifier et créer, mais pas supprimer.
Enfin, `views/visite_views.xml` contient la vue (liste, formulaire), l'action qui les ouvre et l'entrée de menu. C'est le fichier où les différences entre versions se voient le plus : la balise de la vue en liste, par exemple, a changé de nom au fil des versions. Partez toujours d'un exemple tiré de la documentation de votre version.
Installer le module sans se tromper
L'installation suit toujours la même logique. Faites-la d'abord sur une base de test, jamais directement sur votre base de production.
- Copiez le dossier du module dans un répertoire listé dans le chemin des addons de votre serveur.
- Redémarrez le service Odoo pour qu'il relise la liste des dossiers (selon votre hébergement, cette étape se fait chez l'hébergeur).
- Activez le mode développeur dans les paramètres, ce qui fait apparaître des options supplémentaires.
- Dans l'application Apps, utilisez l'option de mise à jour de la liste des applications. Son libellé exact varie selon la version.
- Recherchez votre module par son nom. Pensez à retirer le filtre « Applications » si le module n'est pas déclaré comme application.
- Cliquez sur Installer, puis testez : ouvrez le menu, créez un enregistrement, vérifiez les droits avec un utilisateur ordinaire.
Quand vous modifiez ensuite le module, il faut en général redémarrer le service et mettre à jour le module (bouton dans la fiche du module, ou option de mise à jour en ligne de commande) pour que les changements de vues ou de modèles soient pris en compte.
Les erreurs fréquentes et comment les éviter
Quelques pièges reviennent souvent chez les débutants :
- Le module n'apparaît pas dans la liste : le dossier n'est pas dans le bon chemin, le fichier `__manifest__.py` est absent ou mal écrit, ou le service n'a pas été redémarré.
- Erreur à l'installation : un fichier cité dans `data` n'existe pas, ou son nom comporte une faute. L'ordre compte aussi : les droits d'accès doivent être chargés avant, ou avec, les vues.
- Le menu est invisible : les droits d'accès sont absents ou l'utilisateur n'appartient pas au bon groupe.
- Un changement n'apparaît pas : le module n'a pas été mis à jour après modification.
- Dépendance oubliée : le module utilise un champ ou un modèle d'une autre application qui n'est pas déclarée dans `depends`.
Pour limiter les risques, gardez une base de test, nommez clairement vos champs, et ne supprimez jamais un module installé en production sans avoir vérifié ce qui en dépend. Une désinstallation peut effacer les données qu'il avait créées.
Ce que vous pouvez faire dès aujourd'hui
Sans écrire une ligne de code, vous pouvez déjà préparer le terrain :
- notez en une phrase le besoin (par exemple : « enregistrer chaque visite client avec une date et un compte rendu ») ;
- listez les champs nécessaires, et qui doit pouvoir les voir ou les modifier ;
- vérifiez votre type d'hébergement et la version d'Odoo utilisée ;
- dupliquez votre base pour disposer d'un environnement de test.
Ces quelques éléments suffisent à cadrer un module et évitent la plupart des allers-retours.
Comment CARONNA Odoo vous évite d'écrire tout cela
Si cette structure vous semble lourde pour un besoin simple, c'est normal. Chez CARONNA Odoo, vous connectez votre Odoo, vous décrivez votre besoin en français, et l'IA s'occupe du reste. Elle paramètre la base (champs, vues, actions automatisées, droits, imports, rapports), développe si nécessaire des connecteurs en Python hébergés sur PythonAnywhere, et livre des modules sous forme de fichiers que vous installez selon la procédure décrite plus haut. Si vous êtes perdu devant un écran, l'extension Chrome lui permet de voir ce que vous voyez pour vous guider.
Les garde-fous sont prévus pour des équipes non techniques : un mode test ou production au choix, un accord explicite demandé avant toute action irréversible, et un journal complet de ce qui a été fait, avec possibilité d'annuler. L'IA est incluse dans l'abonnement.
Pour mesurer ce que cela peut changer chez vous, consultez la section sur le gain. Pour voir une démonstration de la démarche, rendez-vous sur la page de démo. Et si vous préférez passer directement à l'essai, ouvrez l'application et décrivez votre premier besoin.
Que vous construisiez votre module vous-même ou que vous le délégiez, retenez l'essentiel : un manifeste, des modèles, des vues, des droits, un test avant la production. Avec ces repères, vous saurez toujours ce qui est livré et ce que vous installez.
Votre intégrateur Odoo, disponible tout de suite
Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. IA incluse, dès 149 € par mois.