Thème Comptoir — Épicerie fine et produits du terroir (complet)

Guide utilisateur — Thème Comptoir — Épicerie fine et produits du terroir (complet)

Module theme_comptoir, version 19.0.1.0.0, OPL-1. Il s'installe par-dessus le module gratuit theme_comptoir_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 Bitter, texte courant en Karla, deux palettes livrées (comptoir-vigne et comptoir-ocre) — 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 gère pas le stock au poids ni la vente en ligne du frais.
• Il ne se connecte à aucune caisse ni à aucun transporteur.
• Il ne fournit pas de photographies : toutes les images sont 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 Comptoir — Épicerie fine et produits du terroir (complet). Odoo installe automatiquement theme_comptoir_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_comptoir --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 Comptoir 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 L'épicerie (/epicerie) ;
• la page Paniers et coffrets (/paniers) ;
• la page Nos producteurs (/producteurs) ;
• 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_comptoir_hero, o_comptoir_cards, o_comptoir_features, o_comptoir_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.

L'épicerie (/epicerie)

Sections montées : o_comptoir_cards, o_comptoir_gallery, o_comptoir_stats.

Paniers et coffrets (/paniers)

Sections montées : o_comptoir_pricelist, o_comptoir_steps, o_comptoir_faq.

Nos producteurs (/producteurs)

Sections montées : o_comptoir_split, o_comptoir_testimonials, o_comptoir_contact.

Le menu

Le pied de page

Le thème remplace le <div id="footer"> de website.layout. 4 colonnes : la marque « Le Comptoir des Coteaux », puis « La maison », « Nous trouver », « Bon à savoir ».

La ligne de mention légale affiche : « © 2026 Le Comptoir des Coteaux — épicerie fictive 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 Comptoir. Les 4 premiers viennent du module gratuit, les 8 suivants de celui-ci.

1. Bandeau d'épicerie

édition gratuite — theme_comptoir_lite.s_comptoir_hero

• Surtitre : « Épicerie fine et cave — Bergerac »
• Titre (h1) : « Trente-sept producteurs, aucun à plus de quatre-vingts kilomètres »
• Chapeau : « Nous ne vendons rien dont nous ne puissions nommer la ferme. Le nom du producteur et la commune sont sur chaque étiquette, y compris sur les bocaux que nous préparons nous-mêmes. »
• Boutons et liens : « Voir l'épicerie » → /epicerie, « Paniers et coffrets » → /paniers.
• Mots-clés de recherche dans l'éditeur : bandeau, hero, accueil, epicerie, terroir, producteurs
• Fichier : theme_comptoir_lite/views/snippets/s_comptoir_hero.xml

2. Trois rayons de l'épicerie

édition gratuite — theme_comptoir_lite.s_comptoir_offres

• Surtitre : « Les rayons »
• Titre (h2) : « Trois rayons, coupés devant vous »
• Chapeau : « Prix au kilo, mode de conservation et durée avant ouverture. Nous ne préemballons que sur demande. »
• Structure : 3 éléments répétés (.o_comptoir_card), répartis sur 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Charcuterie de montagne », « Fromages fermiers au lait cru », « Conserves et bocaux de la maison ».
• Images : 3 au total, issues de /theme_comptoir_lite/static/src/img/co_p1.png, /theme_comptoir_lite/static/src/img/co_p2.png, /theme_comptoir_lite/static/src/img/co_p3.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 : rayons, charcuterie, fromages, conserves, prix au kilo
• Fichier : theme_comptoir_lite/views/snippets/s_comptoir_offres.xml

3. Quatre engagements d'épicier

édition gratuite — theme_comptoir_lite.s_comptoir_points

• Surtitre : « Comment nous travaillons »
• Titre (h2) : « Quatre règles que nous tenons depuis 2011 »
• Chapeau : « Elles sont affichées en boutique, et elles nous coûtent parfois une vente. »
• Structure : 4 éléments répétés (.o_comptoir_feature), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Quatre-vingts kilomètres au plus », « Coupe à la demande », « Consigne à cinquante centimes », « Frais expédié le lundi et le mardi ».
• Mots-clés de recherche dans l'éditeur : engagements, producteurs, consigne, expedition, coupe
• Fichier : theme_comptoir_lite/views/snippets/s_comptoir_points.xml

4. Appel aux paniers de fin d'année

édition gratuite — theme_comptoir_lite.s_comptoir_cta

• Surtitre : « Paniers et coffrets »
• Titre (h2) : « Les paniers de fin d'année se commandent avant le 10 décembre »
• Chapeau : « Quatre-vingts paniers, pas un de plus : c'est ce que l'atelier peut monter sans arrêter la boutique. Panier de 35 €, 55 € ou 85 €, composé avec vous, retrait ou expédition. »
• Boutons et liens : « Composer un panier » → /paniers, « Nous appeler » → /contactus.
• Mots-clés de recherche dans l'éditeur : appel, action, cta, paniers, coffrets, commande
• Fichier : theme_comptoir_lite/views/snippets/s_comptoir_cta.xml

5. Tarifs au poids et à la bouteille

édition complète — theme_comptoir.s_comptoir_tarifs

• Surtitre : « Tarifs 2026 »
• Titre (h2) : « Nos prix, au kilo et à la bouteille »
• Chapeau : « Relevés au 1er janvier. La charcuterie et le fromage suivent les prix d'achat : nous affichons la date du dernier changement en rayon. »
• Structure : 16 éléments répétés (.o_comptoir_pl_row), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Au poids », « À la bouteille », « Paniers composés », « Expédition et services ».
• Mots-clés de recherche dans l'éditeur : tarifs, prix, kilo, bouteille, paniers, expedition
• Fichier : theme_comptoir/views/snippets/s_comptoir_tarifs.xml

6. Rayons en images

édition complète — theme_comptoir.s_comptoir_galerie

• Surtitre : « La boutique »
• Titre (h2) : « Le comptoir, la cave, et l'atelier derrière »
• Chapeau : « Prises un mardi matin, avant la livraison des fromages. »
• Structure : 6 éléments répétés (.o_comptoir_gal_cell), répartis sur 0 colonnes de la grille Bootstrap.
• Images : 6 au total, issues de /theme_comptoir/static/src/img/co_gal_1.png, /theme_comptoir/static/src/img/co_gal_2.png, /theme_comptoir/static/src/img/co_gal_3.png, /theme_comptoir/static/src/img/co_gal_4.png, /theme_comptoir/static/src/img/co_gal_5.png, /theme_comptoir/static/src/img/co_gal_6.png. Illustration engendrée par programme et livrée dans le module — aucune photographie.
• Mots-clés de recherche dans l'éditeur : galerie, mosaique, rayons, cave, boutique, marche
• Fichier : theme_comptoir/views/snippets/s_comptoir_galerie.xml

7. Chiffres de l'approvisionnement

édition complète — theme_comptoir.s_comptoir_chiffres

• Surtitre : « La maison en bref »
• Titre (h2) : « Quatre chiffres qu'on peut vérifier »
• Chapeau : « La liste des fermes est affichée près de la caisse, avec la commune de chacune. »
• Structure : 4 éléments répétés (.o_comptoir_stat), répartis sur 4 colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : chiffres, producteurs, kilometres, consigne, expedition
• Fichier : theme_comptoir/views/snippets/s_comptoir_chiffres.xml

8. Trois retours de clients

édition complète — theme_comptoir.s_comptoir_avis

• Surtitre : « Retours »
• Titre (h2) : « Trois clients de cette année »
• Chapeau : « Recueillis en caisse et au marché, publiés sans retouche. »
• Structure : 3 éléments répétés (.o_comptoir_quote), répartis sur 3 colonnes de la grille Bootstrap.
• Images : 3 au total, issues de /theme_comptoir/static/src/img/co_av_1.png, /theme_comptoir/static/src/img/co_av_2.png, /theme_comptoir/static/src/img/co_av_3.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 : avis, temoignages, clients, retours, epicerie
• Fichier : theme_comptoir/views/snippets/s_comptoir_avis.xml

9. Déroulé d'une commande

édition complète — theme_comptoir.s_comptoir_etapes

• Surtitre : « Comment ça se passe »
• Titre (h2) : « Du choix des produits au retour des bocaux »
• Chapeau : « Quatre étapes, et la dernière compte autant que les autres. »
• Structure : 4 éléments répétés (.o_comptoir_step), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Commande », « Préparation », « Retrait ou colis », « Retour des bocaux ».
• Mots-clés de recherche dans l'éditeur : etapes, commande, preparation, retrait, consigne
• Fichier : theme_comptoir/views/snippets/s_comptoir_etapes.xml

10. Questions fréquentes

édition complète — theme_comptoir.s_comptoir_faq

• Surtitre : « Questions fréquentes »
• Titre (h2) : « Ce qu'on nous demande au téléphone »
• Chapeau : « Les réponses sont les mêmes en boutique et au marché du samedi. »
• Structure : 5 questions en accordéon, la première dépliée à l'ouverture de la page.
• Intitulés livrés : « Expédiez-vous du frais en été ? », « Où trouve-t-on la liste des allergènes ? », « Comment fonctionne la consigne ? », « Les fromages au lait cru posent-ils un problème ? », « Les chèques-cadeaux sont-ils remboursables ? ».
• Mots-clés de recherche dans l'éditeur : faq, questions, froid, allergenes, consigne, accordeon
• Fichier : theme_comptoir/views/snippets/s_comptoir_faq.xml

11. La maison en deux colonnes

édition complète — theme_comptoir.s_comptoir_apropos

• Surtitre : « Depuis 2011 »
• Titre (h2) : « Une épicerie qui refuse un bon produit s'il vient de trop loin »
• Structure : 2 colonnes de la grille Bootstrap.
• Boutons et liens : « Voir les paniers » → /paniers.
• Images : 1 au total, toutes la même, /theme_comptoir/static/src/img/comptoir_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 : maison, presentation, producteurs, histoire, deux colonnes
• Fichier : theme_comptoir/views/snippets/s_comptoir_apropos.xml

12. Coordonnées et horaires

édition complète — theme_comptoir.s_comptoir_contact

• Surtitre : « Nous trouver »
• Titre (h2) : « 8 place du Marché, sous les arcades »
• Structure : 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Ouverture ».
• Images : 1 au total, toutes la même, /theme_comptoir/static/src/img/co_contact.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, horaires, marche
• Fichier : theme_comptoir/views/snippets/s_comptoir_contact.xml

5. Les deux palettes

Le thème livre deux palettes complètes et en sélectionne une par défaut : comptoir-vigne. 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_comptoir_quote pose l'encre #2E2521 sur le fond #FFFDF8, soit 14.73: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 Bitter, texte courant en Karla, barre de navigation en Bitter et boutons en Karla. 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.0, h2 ×2.2, h3 ×1.62, 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_comptoir.pot et i18n/fr.po (148 chaînes pour l'édition complète, 45 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