QWeb eenvoudig uitgelegd, zonder jargon.

Wanneer een Odoo-ontwikkelaar je vertelt over QWeb, lijkt het alsof hij een spreuk oproept. De naam helpt niet. Q als wat? Web zoals je zou verwachten. In werkelijkheid is het waarschijnlijk het eenvoudigste en krachtigste van heel Odoo, op voorwaarde dat je één idee begrijpt: QWeb is HTML dat kan denken. Niet meer, niet minder. Hier is de volledige rondgang, zonder jargon.

QWeb is de sjabloonmotor van Odoo. Een sjabloon, is gewoon een bestand dat beschrijft hoe een pagina eruitziet, met gaten erin om veranderlijke gegevens in te voegen. Denk aan het Word-factuursjabloon van je boekhouder: de structuur is vast, maar de cijfers en namen veranderen per klant. Op het web is het hetzelfde: de productpagina van een winkel heeft altijd hetzelfde skelet, maar de titel, prijs en foto veranderen afhankelijk van het weergegeven product.

Concreet heeft een QWeb-bestand de extensie.xmlen lijkt op HTML. Als je kunt lezen

Alles in QWeb past in een handvol attributen. Als je die onthoudt, begrijp je 95% van de code die je tegenkomt. Hier zijn ze, in de volgorde waarin je ze echt tegenkomt.

Deze zes woorden, in feite, dat is alles. De rest —t-att, t-options, t-esc— zijn neven die je ooit zullen helpen, maar die niet essentieel zijn om een template te lezen. Als je de zes hierboven kent, begrijp je wat elke Odoo-pagina doet.

Een concreet voorbeeld, regel voor regel

Dit is hoe een mini QWeb-template eruitziet dat een productgrid toont. Lees het als HTML met annotaties erin.

Als je dit als een recept leest: „maak een sectie aan, maak voor elk product een kaartje met de naam en de prijs, en als het in de aanbieding is, laat dan het badge zien”. Dat is alles. Geen zwarte magie. Gewoon HTML die kan herhalen en voorwaarden kan stellen.

Voilà la fonctionnalité de QWeb qui justifie tout le reste : l'héritage. Tu peux prendre n'importe quel template livré par Odoo et le modifier sans le toucher. Tu écris un petit fichier à côté qui dit « dans le template d'origine, à tel endroit, ajoute ça, remplace ceci ». Et Odoo s'occupe d'assembler tout proprement à chaque affichage.

Pourquoi c'est révolutionnaire ? Parce que quand Odoo sort une nouvelle version, le template d'origine est mis à jour par l'éditeur, et ton petit fichier de surcharge survit. Tu n'as rien cassé. Tu n'as pas dupliqué le code. Tu as juste posé une couche de personnalisation par-dessus. C'est ce qui permet à WebNest de modifier en profondeur l'apparence d'un site Odoo sans rendre les futures montées de version douloureuses.

Il existait déjà des moteurs de templates très populaires côté Python : Jinja, Mako, Chameleon. Odoo aurait pu en prendre un. Pourquoi avoir développé QWeb maison ? Parce que la contrainte de départ était différente : les templates devaient être éditables par un non-développeur, depuis l'interface web d'Odoo. Pas dans un éditeur de code. Pas avec une syntaxe obscure de moteur Python.

Du coup, la décision a été simple : un template QWeb doit ressembler à du HTML pur. N'importe quel intégrateur, designer ou administrateur curieux peut l'ouvrir, comprendre ce qui se passe, et modifier un texte ou une classe CSS sans rien casser. Les attributs t- sont là pour la mécanique, mais ils ne polluent pas la lecture. C'est élégant.

Autre atout que peu de gens mesurent : QWeb sert autant pour les pages web que pour les rapports PDF et les emails transactionnels. La facture envoyée à ton client, l'email de bienvenue, la page d'accueil : tout passe par le même moteur. Une seule grammaire à apprendre, trois usages couverts. C'est rare.

Tout ce qui rend un site WebNest reconnaissable repose sur QWeb. Voici ce qu'on en fait, projet après projet, et pourquoi ça compte pour toi si on travaille ensemble.

• Des templates de page entièrement nouveaux qui remplacent les templates standards d'Odoo. La page produit de ton e-commerce, la fiche d'un événement, le détail d'une offre d'emploi : on en écrit une version qui te ressemble, et on la branche au moteur Odoo. Toutes tes données restent connectées.
• Des surcharges chirurgicales sur les pages qu'on ne veut pas refaire entièrement. Le panier, le checkout, le compte client : on garde la mécanique d'Odoo qui fonctionne, on change le habillage. Le client a la performance native et un visuel sur mesure.
• Des blocs réutilisables qu'on appelle avec t-call sur plusieurs pages. Le hero, la section témoignages, le footer : un seul fichier source, dix endroits qui l'utilisent. Tu changes une virgule au hero, ça se répercute partout.
• Des emails et factures aux mêmes codes graphiques que le site. Parce que QWeb les anime aussi, on peut harmoniser. Le client reçoit une facture qui n'a pas l'air d'avoir été générée par un autre logiciel que ton site.

Si tu ne dois retenir que trois choses de cet article, voilà lesquelles. D'abord, QWeb n'est pas un truc obscur réservé aux développeurs Odoo. C'est du HTML qui sait penser, avec six mots-clés à apprendre. Tu peux ouvrir n'importe quel template livré par Odoo et le lire comme un livre.

Ensuite, l'héritage est la vraie magie. C'est ce qui permet à une agence sérieuse de personnaliser ton site sans hypothéquer tes futures montées de version. Si on te propose un site Odoo qui duplique les templates au lieu de les surcharger, fuis : tu paieras la dette plus tard.

Enfin, QWeb est un avantage compétitif réel, pas une contrainte. Un moteur unique pour le site, les emails et les PDF, c'est rare et précieux. C'est aussi ce qui nous permet, chez WebNest, de livrer des sites radicalement sur mesure tout en restant 100% dans l'écosystème Odoo. Pas de couche externe, pas de hack. Juste du QWeb bien écrit.