Thème Cave — Caviste, bar à vin (complet)

Guide utilisateur — Thème Cave — Caviste, bar à vin (complet)

Module theme_cave, version 19.0.1.0.0, OPL-1. Il s'installe par-dessus le module gratuit theme_cave_lite, dont il dépend.

Avant de commencer : ce que ce thème fait, et ce qu'il ne fait pas

Il fait : habiller un site Odoo 19 — titres en Cormorant Garamond, texte courant en Jost, deux palettes livrées (cave-lie et cave-ardoise) — et poser 12 blocs manipulables dans l'éditeur de site, une page d'accueil, 3 pages supplémentaires, leurs entrées de menu et un pied de page complet.

Il ne fait pas :

• Il ne vend pas en ligne : aucun panier, aucun stock, aucun paiement.
• Il ne gère pas les inscriptions aux dégustations ni les listes d'attente.
• Il ne fournit pas de photographies : les images sont des illustrations générées par programme.
• Il ne modifie aucun module du cœur d'Odoo : tout passe par l'héritage de vues.

C'est un thème de site. Il ne touche ni à la comptabilité, ni aux stocks, ni à aucune application de gestion : tout ce qu'il modifie est le rendu du site web.

1. Installer

Les deux modules doivent être présents dans un dossier de votre addons_path. Mettez ensuite la liste des applications à jour (Applications → Mettre à jour la liste des applications), puis installez Thème Cave — Caviste, bar à vin (complet). Odoo installe automatiquement theme_cave_lite d'abord : c'est une dépendance déclarée, vous n'avez pas à l'installer à la main.

En ligne de commande, sur une base neuve :

odoo-bin -c odoo.conf -d ma_base -i theme_cave --stop-after-init

L'installation ne crée rien dans votre site : dans un module de thème, les vues et les pages sont stockées comme theme.ir.ui.view et theme.website.page, des modèles d'attente. Rien n'est copié dans le site tant que le thème n'est pas appliqué.

2. Appliquer le thème au site

Site web → Configuration → Paramètres → Thème, ou directement Site web → Éditer → Thème. Choisissez Thème Cave et validez.

À ce moment-là, et à ce moment-là seulement, Odoo copie dans votre site :

• la page d'accueil du thème (elle remplace le contenu de /) ;
• la page La cave (/la-cave) ;
• la page Dégustations (/degustations) ;
• la page Nous trouver (/nous-trouver) ;
• les 3 entrées de menu correspondantes ;
• le pied de page du thème.

Appliquer un thème sur un site qui a déjà du contenu écrase la page d'accueil existante. Sur un site en production, faites-le sur une copie d'abord.

3. Ce que vous avez sur le site après application

La page d'accueil (/)

4 sections, dans cet ordre : o_cave_hero, o_cave_cards, o_cave_hours_sec, o_cave_cta.

Ce sont les 4 blocs de l'édition gratuite. Ils sont posés dans un oe_structure : chacun se déplace, se duplique et se supprime dans l'éditeur comme n'importe quel bloc Odoo.

La cave (/la-cave)

Sections montées : o_cave_cards, o_cave_pricelist, o_cave_split.

Dégustations (/degustations)

Sections montées : o_cave_agenda, o_cave_features, o_cave_faq.

Nous trouver (/nous-trouver)

Sections montées : o_cave_contact, o_cave_hours_sec, o_cave_testimonials.

Le menu

Le pied de page

Le thème remplace le <div id="footer"> de website.layout. 4 colonnes : la marque « La Cave de l'Ancre », puis « La cave », « Nous joindre », « Bon à savoir ».

La ligne de mention légale affiche : « © 2026 La Cave de l'Ancre — caviste fictif de démonstration »

Le pied de page est dans un oe_structure : il s'édite depuis l'éditeur de site, comme le reste.

4. Les 12 blocs, un par un

Dans l'éditeur de site (Éditer → Blocs), ils sont réunis sous le groupe Cave. Les 4 premiers viennent du module gratuit, les 8 suivants de celui-ci.

1. Bandeau de caviste

édition gratuite — theme_cave_lite.s_cave_bandeau

• Surtitre : « Caviste et bar à vin — La Cave de l'Ancre »
• Titre (h1) : « Quatre cents références, et quelqu'un pour vous en déconseiller la plupart »
• Chapeau : « On achète au domaine, jamais en centrale. La cave est à 13 °C et 72 % d'hygrométrie. Le soir, onze vins sont ouverts au verre. L'abus d'alcool est dangereux pour la santé, à consommer avec modération. »
• Boutons et liens : « La sélection du moment » → /la-cave, « Les dégustations » → /degustations.
• Mots-clés de recherche dans l'éditeur : bandeau, hero, accueil, caviste, vin, cave
• Fichier : theme_cave_lite/views/snippets/s_cave_bandeau.xml

2. La sélection du moment

édition gratuite — theme_cave_lite.s_cave_selection

• Surtitre : « En ce moment »
• Titre (h2) : « Trois bouteilles, et ce qu'on en pense vraiment »
• Chapeau : « Appellation, millésime, cépage, potentiel de garde et prix. Ce qui manque dans quatre-vingt-dix pour cent des rayons. »
• Structure : 3 éléments répétés (.o_cave_card), répartis sur 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Chinon 2021 — Domaine des Roches Closes », « Côtes du Jura 2022 — Savagnin ouillé », « Madiran 2019 — Vieilles vignes ».
• Mots-clés de recherche dans l'éditeur : selection, vins, appellation, millesime, garde, bouteilles
• Fichier : theme_cave_lite/views/snippets/s_cave_selection.xml

3. Horaires de la cave et du bar

édition gratuite — theme_cave_lite.s_cave_horaires

• Surtitre : « Horaires »
• Titre (h2) : « La cave ferme à 20h, le bar continue jusqu'à minuit le week-end »
• Structure : 9 éléments répétés (.o_cave_hrow), répartis sur 2 colonnes de la grille Bootstrap.
• Intitulés livrés : « Mardi au jeudi », « Vendredi et samedi », « Samedi matin », « Dimanche et lundi », « Fermeture hebdomadaire et vendanges ».
• Mots-clés de recherche dans l'éditeur : horaires, ouverture, bar, degustation, samedi, fermeture
• Fichier : theme_cave_lite/views/snippets/s_cave_horaires.xml

4. Appel à la dégustation du samedi

édition gratuite — theme_cave_lite.s_cave_visite

• Surtitre : « Le samedi »
• Titre (h2) : « De 11h à 13h, on ouvre trois bouteilles et on ne vend rien de force »
• Chapeau : « Trois vins au comptoir, sans inscription, sans achat obligatoire. On explique ce qu'il y a dans le verre, on dit à quel plat ça va, et on dit aussi quand ça ne vous plaira pas. L'abus d'alcool est dangereux pour la santé. »
• Boutons et liens : « Voir les dégustations » → /degustations, « Nous trouver » → /nous-trouver.
• Mots-clés de recherche dans l'éditeur : degustation, samedi, appel, cta, gratuit, conseil
• Fichier : theme_cave_lite/views/snippets/s_cave_visite.xml

5. Dégustations à venir

édition complète — theme_cave.s_cave_degustations

• Surtitre : « Agenda »
• Titre (h2) : « Ce qui est prévu d'ici la fin de l'année »
• Chapeau : « Les places sont limitées par le nombre de verres, pas par une politique commerciale. Inscription au comptoir ou par téléphone. »
• Structure : 4 éléments répétés (.o_cave_agenda_item), répartis sur 0 colonnes de la grille Bootstrap.
• Intitulés livrés : « Le vigneron des Roches Closes au comptoir », « Sept blancs du Jura, à l'aveugle », « Accords fromages du marché », « Vins de garde : quoi acheter pour dans dix ans ».
• Mots-clés de recherche dans l'éditeur : degustations, agenda, dates, atelier, inscription, vigneron
• Fichier : theme_cave/views/snippets/s_cave_degustations.xml

6. Les prix, par gamme

édition complète — theme_cave.s_cave_tarifs

• Surtitre : « Prix »
• Titre (h2) : « Ce que coûtent une bouteille, un verre et un service »
• Chapeau : « Prix TTC. Au bar, la même bouteille est facturée au prix cave majoré d'un droit de bouchon de 7 € : vous pouvez donc acheter en rayon et boire sur place. »
• Structure : 16 éléments répétés (.o_cave_pl_row), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Bouteilles de la semaine », « Au verre, au bar », « À grignoter », « Services ».
• Mots-clés de recherche dans l'éditeur : prix, tarifs, gammes, verre, bouteille, consigne, services
• Fichier : theme_cave/views/snippets/s_cave_tarifs.xml

7. Nos vignerons, et pourquoi eux

édition complète — theme_cave.s_cave_vignerons

• Surtitre : « Achat »
• Titre (h2) : « Comment une bouteille entre dans ce rayon »
• Chapeau : « Quatre-vingts domaines, visités au moins une fois. Voici ce qu'on regarde, et ce qui fait qu'un vin ne rentre pas, même s'il se vendrait. »
• Structure : 3 éléments répétés (.o_cave_listcol), répartis sur 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Ce qu'on regarde », « Ce qui ne rentre pas », « Ce qu'on vous dira ».
• Mots-clés de recherche dans l'éditeur : vignerons, domaines, achat, selection, criteres
• Fichier : theme_cave/views/snippets/s_cave_vignerons.xml

8. Le bar à vin en quatre points

édition complète — theme_cave.s_cave_bar

• Surtitre : « Le bar »
• Titre (h2) : « Quatre choses à savoir avant de pousser la porte le vendredi soir »
• Chapeau : « Le bar occupe l'arrière de la cave. Dix-neuf places en tout : ça se remplit à 19h30 le vendredi, et ça ne se réserve pas. »
• Structure : 4 éléments répétés (.o_cave_feature), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Onze vins ouverts », « Dix-neuf places, sans réservation », « Pas de cuisine chaude », « Dernier service à 23h15 ».
• Mots-clés de recherche dans l'éditeur : bar, comptoir, verres, planches, service, points
• Fichier : theme_cave/views/snippets/s_cave_bar.xml

9. Trois retours de clients

édition complète — theme_cave.s_cave_avis

• Surtitre : « Retours »
• Titre (h2) : « Trois clients du quartier »
• Structure : 3 éléments répétés (.o_cave_quote), répartis sur 3 colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : avis, temoignages, clients, retours, cave
• Fichier : theme_cave/views/snippets/s_cave_avis.xml

10. La cave en deux colonnes

édition complète — theme_cave.s_cave_cave_lieu

• Surtitre : « Le lieu »
• Titre (h2) : « Treize degrés, 72 % d'hygrométrie, et trois mille deux cents bouteilles »
• Structure : 2 colonnes de la grille Bootstrap.
• Boutons et liens : « Voir la sélection » → /la-cave.
• Images : 1 au total, toutes la même, /theme_cave_lite/static/src/img/cave_illustration.png. Illustration engendrée par programme et livrée dans le module — aucune photographie. Leur attribut alt est vide : elles sont décoratives et les lecteurs d'écran les ignorent.
• Mots-clés de recherche dans l'éditeur : cave, lieu, temperature, stock, presentation, deux colonnes
• Fichier : theme_cave/views/snippets/s_cave_cave_lieu.xml

11. Questions fréquentes

édition complète — theme_cave.s_cave_faq

• Surtitre : « Questions fréquentes »
• Titre (h2) : « Ce qu'on nous demande au comptoir »
• Structure : 6 questions en accordéon, la première dépliée à l'ouverture de la page.
• Intitulés livrés : « Reprenez-vous une bouteille bouchonnée ? », « Comment garder des bouteilles quand on n'a pas de cave ? », « Livrez-vous ? », « Faites-vous des cartes cadeaux ? », « Peut-on venir avec ses propres verres ou sa bouteille ? », « Vendez-vous aux mineurs ? ».
• Mots-clés de recherche dans l'éditeur : faq, questions, reponses, conservation, reprise, livraison
• Fichier : theme_cave/views/snippets/s_cave_faq.xml

12. Accès et contact

édition complète — theme_cave.s_cave_acces

• Surtitre : « Nous trouver »
• Titre (h2) : « Quai de l'Ancre, la porte bleue entre le tabac et le fleuriste »
• Structure : 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Cave et bar ».
• Images : 1 au total, toutes la même, /theme_cave_lite/static/src/img/cave_illustration.png. Illustration engendrée par programme et livrée dans le module — aucune photographie. Leur attribut alt est vide : elles sont décoratives et les lecteurs d'écran les ignorent.
• Mots-clés de recherche dans l'éditeur : contact, acces, adresse, telephone, stationnement, accessibilite
• Fichier : theme_cave/views/snippets/s_cave_acces.xml

5. Les deux palettes

Le thème livre deux palettes complètes et en sélectionne une par défaut : cave-lie. On bascule de l'une à l'autre dans Éditer → Thème → Couleurs, sans toucher au contenu.

Contrastes mesurés (WCAG 2.1, seuil AA pour du texte courant : 4,5:1). Les rapports ci-dessous sont calculés sur les couleurs réellement livrées, et l'encre du bloc témoignages a été relevée en plus dans le bundle web.assets_frontend réellement servi par le serveur.

Relevé dans le bundle servi : la carte de témoignage .o_cave_quote pose l'encre #241A20 sur le fond #FFFCFD, soit 16.56:1. La carte fixe sa couleur de texte explicitement ; sans cela elle hériterait de l'encre de la combinaison o_cc3 qui l'entoure et sortirait blanc sur blanc.

Typographie. Titres en Cormorant Garamond, texte courant en Jost, barre de navigation en Cormorant Garamond et boutons en Jost. Les polices sont chargées par Odoo depuis Google Fonts via $o-theme-font-configs : aucun fichier de police n'est copié dans le module. Échelle des titres : h1 ×3.1, h2 ×2.25, h3 ×1.6, h4 ×1.28.

Les deux palettes sont déclarées dans le module gratuit, et redéclarées à l'identique par le module payant. C'est nécessaire : en Odoo 19, website/models/ir_asset.py::_get_active_addons_list écarte tous les modules de thème sauf celui appliqué au site, donc un thème payant n'hérite pas du SCSS de son thème gratuit.

6. Modifier les textes

Tout le contenu livré est du balisage éditable, pas des enregistrements de base de données. Il n'y a donc aucun formulaire de configuration : on édite dans le site.

1. Site web, puis le bouton Éditer en haut à droite.
2. Cliquez dans un texte et tapez. Les titres, les chapeaux, les intitulés de cartes, les prix et les lignes de tableau s'éditent tous en place.
3. Enregistrer. La modification porte sur la page où vous êtes, pas sur le bloc livré : ajouter le même bloc ailleurs le redonne dans son état d'origine.

Pour ajouter ou retirer un élément (une carte, une ligne de tarif, un retour de client), sélectionnez la colonne qui le contient et dupliquez-la ou supprimez-la : ce sont des colonnes Bootstrap ordinaires.

Les numéros de téléphone et les adresses courriel sont écrits en dur dans les liens (tel:, mailto:) : le texte visible et la cible du lien sont deux champs distincts dans l'éditeur. Changez les deux.

Le contenu de démonstration est entièrement fictif — raison sociale, adresse, téléphones, tarifs. Il est là pour montrer la mise en page, pas pour être publié tel quel.

7. Les traductions

Le thème est écrit en français. Les modules livrent i18n/theme_cave.pot et i18n/fr.po (208 chaînes pour l'édition complète, 52 pour l'édition gratuite) : tous les textes des vues sont exportés comme termes traduisibles, de sorte qu'un site multilingue peut les traduire dans Paramètres → Traductions sans toucher au code.

8. Le rendu sur téléphone, mesuré

Toutes les sections sont bâties sur la grille Bootstrap d'Odoo : les colonnes se replient seules. Les chiffres ci-dessous ont été relevés sur le thème réellement installé, dans un navigateur, page par page.

Un débordement de 0 px signifie qu'aucune page ne défile latéralement sur un téléphone. Les captures de la fiche du module sont ces relevés-là, pas des maquettes.

9. Revenir en arrière

Site web → Configuration → Paramètres → Thème, choisissez un autre thème : Odoo retire les vues du thème courant et pose celles du nouveau. Les pages créées par le thème, elles, restent : ce sont devenues des pages de votre site. Supprimez-les dans Site web → Contenu → Pages si vous n'en voulez plus.

Désinstaller le module payant sans désinstaller le gratuit laisse un site cohérent : les 4 blocs de base et la direction artistique restent.

Éditeur : DYONYSOS — dyonysos.fr — support : welcome@dyonysos.fr