Dans un module website écrit pour Odoo 17, 18 ou 19, deux réflexes reviennent partout : lire request.website dans un modèle, ou appeler self.env['website'].get_current_website() quand on ne sait pas d'où vient l'appel. Ces deux réflexes ne fonctionnent plus en Odoo 20. Le site courant devient une simple valeur de contexte, lue par self.env.website, et le repli implicite sur « le premier site trouvé » a disparu. Pour un module qui tourne en cron, en import ou via l'API, la conséquence est silencieuse : le site devient un enregistrement vide.
D'où vient le changement
La modification est portée par la pull request odoo/odoo#252766, intitulée « [REF] website: replace request.website with context-based website_id », ouverte le 9 mars 2026 et intégrée le 5 juin 2026 par le robot de fusion d'Odoo1. Sa description pose le diagnostic : la dépendance à request.website et le repli implicite de get_current_website compliquent le comportement dans les crons, en ligne de commande et dans les appels RPC. Le changelog ORM officiel classe l'évolution sous Odoo Online 19.4, avec la mention « Removing request from the code of models and adding env.website »2. Elle fait donc partie de la version 20.0.
Le même chantier a déplacé le modèle website dans le module base. Le site par défaut change d'identifiant XML : website.default_website devient base.default_website, et la documentation développeur a été corrigée en ce sens par une pull request fusionnée le même jour3.
Ce que contient le code d'Odoo 20
Nous avons parcouru la branche 20.0 du dépôt odoo/odoo, au commit publié le 12 novembre 20264. Trois constats ressortent.
D'abord, l'environnement expose une propriété website, construite sur le même modèle que env.company. Sa définition tient en une ligne : elle renvoie self['website'].browse(self.context.get('website_id')), et sa docstring précise que le résultat peut être vide5. Contrairement à env.company, qui retombe sur la société principale de l'utilisateur, env.website n'a aucun repli.
Ensuite, la méthode get_current_website() n'existe plus sur le modèle website. Dans les modules que nous avons inspectés (le cœur, website, website_sale, portal, http_routing), le seul symbole restant à ce nom est une route JSON-RPC du contrôleur, qui renvoie la valeur host_id du contexte. En 19.0, la méthode du modèle suivait une cascade documentée : site forcé en session, site du contexte, site correspondant au domaine de la requête, puis « arbitrairement le premier site trouvé en base » si fallback=True, ce qui était la valeur par défaut6.
Enfin, le routage HTTP injecte le site dans le contexte. ir.http appelle request.update_context(website_id=...) après avoir résolu le domaine, et la couche RPC propage website_id et host_id d'un enregistrement à l'autre7. Un commentaire « TODO: remove this crap » accompagne d'ailleurs cette propagation, ce qui laisse penser que le mécanisme n'est pas figé.
| Usage en Odoo 19 | Équivalent en Odoo 20 | Comportement hors requête web |
|---|---|---|
request.website dans un modèle | self.env.website | Enregistrement vide |
env['website'].get_current_website() | self.env.website | Méthode absente, AttributeError |
get_current_website(fallback=True) | Choix explicite d'un site | À coder vous-même |
ref('website.default_website') | ref('base.default_website') | Identifiant à renommer |
Les cas qui cassent chez nos clients
Le premier cas visible est l'AttributeError. Tout appel à get_current_website() resté dans un module spécifique échoue au premier passage. Les tests le détectent immédiatement.
Le second cas est plus sournois. Un cron qui génère des liens de paiement, des URL de produits ou des courriels transactionnels lisait souvent request.website derrière un if request, ou profitait du repli vers le premier site. En Odoo 20, self.env.website renvoie un enregistrement vide dans ce contexte. Lire self.env.website.domain donne alors False, et le module construit une URL incomplète sans lever d'erreur. Sur une instance mono-site, personne ne s'en aperçoit avant qu'un client signale un lien cassé.
Le troisième cas concerne les intégrations. Un connecteur e-commerce qui appelle des méthodes de website_sale via l'API n'a pas de requête web derrière lui. Si le contexte transmis ne contient pas website_id, les règles de prix, la disponibilité ou la visibilité calculées « pour le site courant » s'appliquent à un site vide. Le code de website_sale en 20.0 montre d'ailleurs des lectures comme self.env.website.restricted_uom_ids ou self.env.website._get_product_available_qty(...), qui dépendent entièrement de ce contexte4.
Le quatrième cas touche les données XML. Les fichiers qui référencent website.default_website dans un ref ou un eval doivent passer à base.default_website. Le script de montée de version d'Odoo devrait traiter les données standard, mais vos propres fichiers XML et vos tests restent à votre charge. La pull request de migration associée, odoo/upgrade#10378, n'était pas prête au moment de la fusion selon le fil de discussion1.
La méthode de migration que nous appliquons
Nous commençons par un inventaire mécanique. Une recherche sur request.website, get_current_website et website.default_website dans les modules spécifiques donne la liste des points à traiter.
Nous classons ensuite chaque occurrence selon son contexte d'exécution. Dans un contrôleur déclaré avec website=True, le remplacement par self.env.website ou request.env.website suffit, puisque le routage a déjà injecté le site. Dans un cron, une action serveur ou un point d'entrée API, le site doit être choisi explicitement : un champ website_id sur l'enregistrement traité, un paramètre système, ou un with_context(website_id=...) posé à l'entrée du traitement.
Nous ajoutons enfin une garde explicite. Quand le code ne peut pas fonctionner sans site, il vaut mieux lever une erreur claire avec un ensure_one() sur self.env.website que produire une URL vide. Pour les tests, poser with_context(website_id=...) devient plus simple que de simuler une requête HTTP complète.
Notre lecture
Ce changement va dans le bon sens. Un modèle qui lit l'objet request dépend d'un état global que le cron, la ligne de commande et l'API ne possèdent pas, et le repli vers « le premier site trouvé » masquait des bugs réels sur les instances multi-sites. Le contexte explicite rend ces dépendances visibles, comme allowed_company_ids l'a fait pour les sociétés.
Le coût reste réel pour les PME et ETI qui ont un site marchand personnalisé. Les erreurs franches se corrigent vite. Les URL vides et les prix calculés sans site demandent un audit ciblé des traitements planifiés et des connecteurs, qu'il faut mener avant la bascule plutôt qu'après les premiers retours clients. Nous recommandons de traiter ce point dans le même lot que la réécriture des droits d'accès, car les deux chantiers touchent les mêmes modules.
Sources
- GitHub odoo/odoo, PR #252766 « [REF] website: replace request.website with context-based website_id » : https://github.com/odoo/odoo/pull/252766
- Documentation Odoo 20.0, Changelog ORM : https://www.odoo.com/documentation/20.0/developer/reference/backend/orm/changelog.html
- GitHub odoo/documentation, PR #17826 « change website.default_website XMLID to base.default_website » : https://github.com/odoo/documentation/pull/17826
- Code source Odoo 20.0, environments.py : https://github.com/odoo/odoo/blob/20.0/odoo/orm/environments.py
- Code source Odoo 20.0, website/models/ir_http.py : https://github.com/odoo/odoo/blob/20.0/addons/website/models/ir_http.py
- Code source Odoo 20.0, base/data/website.xml : https://github.com/odoo/odoo/blob/20.0/odoo/addons/base/data/website.xml
- Code source Odoo 19.0, website/models/website.py : https://github.com/odoo/odoo/blob/19.0/addons/website/models/website.py
Footnotes
-
Pull request odoo/odoo#252766, ouverte le 9 mars 2026, déploiement du commit
05955364enregistré le 5 juin 2026. ↩ ↩2 -
Changelog ORM d'Odoo 20.0, section « Odoo Online version 19.4 ». ↩
-
Pull request odoo/documentation#17826, fusionnée le 5 juin 2026. ↩
-
Inspection directe de la branche 20.0 de odoo/odoo, commit
53882d6daté du 12 novembre 2026. Les modules inspectés sont indiqués dans le texte. ↩ ↩2 -
Fichier
odoo/orm/environments.py, branche 20.0, propriétéEnvironment.website. ↩ -
Fichier
addons/website/models/website.py, branche 19.0, docstring deget_current_website. ↩ -
Fichiers
addons/website/models/ir_http.pyetodoo/service/model.py, branche 20.0. ↩