Jour 1 · Sommaire

Créer, voir, puis expliquer un premier module

Vous allez installer un module minimal, lui ajouter une client action interactive, puis comprendre comment ses données et son boilerplate entrent dans Odoo.

Sommaire du jour

Section 1

Créer un premier module

Vous allez créer un premier « Hello World » avec Odoo : le module Hello Odoo. Ce point de départ vérifie que votre environnement fonctionne avant de construire son interface.

Avant de commencer

Cette formation suppose qu'Odoo 19 Community fonctionne déjà, avec une base d'exercice et un dossier d'addons personnalisés configuré. Sinon, suivez d'abord Installation d'Odoo et premier Hello World.

Le résultat attendu

Le module Hello Odoo est installé et visible dans la liste des applications. Il n'a pas encore d'écran ni d'entrée dans le sélecteur d'applications : c'est volontaire. La section 2 lui ajoutera une véritable client action interactive.

  1. Préparer le terrain — confirmer les prérequis et repérer le dossier réservé à vos addons.
  2. Créer le squelette — demander à Odoo de préparer les dossiers et fichiers du module.
  3. Écrire le manifeste — réduire le manifeste à une déclaration minimale, lisible et valide.
  4. Installer le module — le trouver dans Apps, l'installer et interpréter ce qui apparaît.
Section 2

Construire une client action

Le module minimal est installé. Vous allez maintenant le pousser un cran plus loin : une entrée dans le sélecteur d'applications ouvrira un composant Owl, et son bouton utilisera un service du client web Odoo.

Le résultat attendu

Vous ouvrez Hello Odoo depuis le sélecteur d'applications, cliquez sur Well, hello Odoo et recevez la notification Welcome to Odoo. Surtout, vous savez suivre chacun des bindings qui rendent ce trajet possible.

  1. Préparer l'extension — lire l'architecture complète et créer le dossier de l'écran.
  2. Programmer le composant — relier un bouton au service de notification avec JavaScript et Owl.
  3. Construire l'interface — créer le template, l'action, le menu et compléter le manifeste.
  4. Mettre à niveau et vérifier — parcourir le trajet complet, puis provoquer quelques pannes utiles.
Section 3

Amorcer la base et lire le boilerplate

Vous allez fournir au module quelques données initiales, puis lire les exemples commentés du scaffold pour comprendre leurs dépendances avant de les utiliser.

À savoir

Cette section distingue l'amorçage de la base et la lecture du boilerplate généré. Les exemples de boilerplate restent commentés tant que leurs modèles, contrôleurs et droits ne sont pas construits.

Le résultat attendu

Vous savez charger des données initiales sans les confondre avec des données de démonstration, puis expliquer les bindings attendus par views.xml et templates.xml avant de les activer.

  1. Comprendre l'amorçage — distinguer données initiales, données de démonstration et données saisies par les utilisateurs.
  2. Écrire les données XML — décrire deux tags Contacts dans un fichier XML du module.
  3. Déclarer le fichier — ajouter la dépendance et le fichier de données au manifeste.
  4. Charger et vérifier — mettre le module à niveau et retrouver les records dans Odoo.
  5. Lire views.xml — suivre la chaîne menu, action, model, view et fields dans le boilerplate commenté.
  6. Lire templates.xml — relier un template QWeb au contrôleur, au model et au contexte de sécurité qu'il attend.
  7. Ajouter un stylesheet et lire demo/ — appliquer un style au composant existant, puis décider quand les records de démonstration deviendront utilisables.