Thème Volet — Chambres d'hôtes et gîte (complet)

Guide utilisateur — Thème Volet — Chambres d'hôtes et gîte (complet)

Module theme_volet, version 19.0.1.0.0, OPL-1. Il s'installe par-dessus le module gratuit theme_volet_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 Lora, texte courant en Mulish, deux palettes livrées (volet-persienne et volet-lin) — 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 calendrier de disponibilité ni le paiement des arrhes.
• Il ne se connecte à aucun moteur de réservation ni à aucun channel manager.
• 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 Volet — Chambres d'hôtes et gîte (complet). Odoo installe automatiquement theme_volet_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_volet --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 Volet 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 Les chambres (/les-chambres) ;
• la page La maison (/la-maison) ;
• la page Venir (/venir) ;
• 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_volet_hero, o_volet_cards, o_volet_lists, o_volet_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.

Les chambres (/les-chambres)

Sections montées : o_volet_cards, o_volet_pricelist, o_volet_lists.

La maison (/la-maison)

Sections montées : o_volet_split, o_volet_stats, o_volet_testimonials.

Venir (/venir)

Sections montées : o_volet_contact, o_volet_steps, o_volet_faq.

Le menu

Le pied de page

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

La ligne de mention légale affiche : « © 2026 Le Clos aux Volets — maison d'hôtes 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 Volet. Les 4 premiers viennent du module gratuit, les 8 suivants de celui-ci.

1. Bandeau de maison d'hôtes

édition gratuite — theme_volet_lite.s_volet_bandeau

• Surtitre : « Chambres d'hôtes et gîte — Le Clos aux Volets »
• Titre (h1) : « Cinq chambres, un gîte, et le petit-déjeuner à 8h30 en bas »
• Chapeau : « Une maison de 1834 tenue par deux personnes. Pas de réception, pas de télévision dans les chambres, pas de badge : une clé, et quelqu'un qui vous attend à l'arrivée. »
• Boutons et liens : « Voir les chambres » → /les-chambres, « Nous écrire » → /contactus.
• Mots-clés de recherche dans l'éditeur : bandeau, hero, accueil, chambres d hotes, gite, maison
• Fichier : theme_volet_lite/views/snippets/s_volet_bandeau.xml

2. Les chambres et le gîte

édition gratuite — theme_volet_lite.s_volet_chambres

• Surtitre : « Dormir »
• Titre (h2) : « Trois façons de loger ici »
• Chapeau : « Surface réelle, capacité, type de lit et prix par nuit hors taxe de séjour. Le détail des cinq chambres est sur la page dédiée. »
• Structure : 3 éléments répétés (.o_volet_card), répartis sur 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Chambre Le Tilleul », « Chambre familiale La Grange », « Le Gîte du Fournil ».
• Mots-clés de recherche dans l'éditeur : chambres, gite, surface, capacite, prix, hebergement
• Fichier : theme_volet_lite/views/snippets/s_volet_chambres.xml

3. Taxe de séjour, arrivée, départ, ce qui est compris

édition gratuite — theme_volet_lite.s_volet_sejour

• Surtitre : « Avant de réserver »
• Titre (h2) : « Les trois choses qu'on découvre d'habitude à l'arrivée »
• Chapeau : « La taxe de séjour, l'heure à laquelle on peut entrer, et ce que le prix comprend vraiment. Autant que ce soit écrit avant le paiement plutôt que sur le pas de la porte. »
• Structure : 3 éléments répétés (.o_volet_listcol), répartis sur 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Taxe de séjour », « Arrivée et départ », « Compris, et non compris ».
• Mots-clés de recherche dans l'éditeur : taxe de sejour, arrivee, depart, compris, inclus, sejour, horaires
• Fichier : theme_volet_lite/views/snippets/s_volet_sejour.xml

4. Appel à réservation

édition gratuite — theme_volet_lite.s_volet_reserver

• Surtitre : « Réserver »
• Titre (h2) : « En direct, la nuit est 15 % moins chère qu'ailleurs »
• Chapeau : « Ce n'est pas une promotion : c'est exactement la commission que prend la plateforme. Arrhes de trente pour cent, remboursées intégralement jusqu'à quatorze jours avant l'arrivée. Aucun frais de dossier, aucune empreinte de carte. »
• Boutons et liens : « Demander des dates » → /contactus, « Voir les tarifs » → /les-chambres.
• Mots-clés de recherche dans l'éditeur : reservation, appel, cta, arrhes, annulation, direct
• Fichier : theme_volet_lite/views/snippets/s_volet_reserver.xml

5. Tarifs par saison

édition complète — theme_volet.s_volet_tarifs

• Surtitre : « Tarifs 2026 »
• Titre (h2) : « Par nuit, par saison, taxe de séjour en plus »
• Chapeau : « Basse saison : de novembre à mars, hors vacances scolaires. Haute saison : juillet, août et les ponts de mai. Le reste est en moyenne saison. »
• Structure : 16 éléments répétés (.o_volet_pl_row), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Chambres, par nuit », « Le gîte du Fournil », « Suppléments », « Réductions ».
• Mots-clés de recherche dans l'éditeur : tarifs, prix, saison, chambres, gite, supplements, reductions
• Fichier : theme_volet/views/snippets/s_volet_tarifs.xml

6. Petit-déjeuner et table d'hôtes

édition complète — theme_volet.s_volet_table

• Surtitre : « À table »
• Titre (h2) : « Ce qui se passe en bas, et à quelle heure »
• Chapeau : « Une seule table, une seule heure. C'est le défaut de la maison d'hôtes et c'est aussi ce qui fait qu'on n'y mange pas seul. »
• Structure : 4 éléments répétés (.o_volet_feature), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « Petit-déjeuner à 8h30 », « Table d'hôtes à 19h30 », « Régimes et allergies », « En dehors de ces heures ».
• Mots-clés de recherche dans l'éditeur : petit dejeuner, table d hotes, repas, regimes, allergies, horaires
• Fichier : theme_volet/views/snippets/s_volet_table.xml

7. Le déroulé d'un séjour

édition complète — theme_volet.s_volet_etapes

• Surtitre : « Comment ça se passe »
• Titre (h2) : « De la demande de dates au départ »
• Structure : 4 éléments répétés (.o_volet_step), répartis sur 4 colonnes de la grille Bootstrap.
• Intitulés livrés : « La demande », « Les arrhes », « L'arrivée », « Le départ ».
• Mots-clés de recherche dans l'éditeur : etapes, sejour, reservation, arrivee, depart, deroule
• Fichier : theme_volet/views/snippets/s_volet_etapes.xml

8. La maison en chiffres

édition complète — theme_volet.s_volet_chiffres

• Surtitre : « En bref »
• Titre (h2) : « Quatre chiffres qui ne bougeront pas »
• Structure : 4 éléments répétés (.o_volet_stat), répartis sur 4 colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : chiffres, statistiques, maison, indicateurs
• Fichier : theme_volet/views/snippets/s_volet_chiffres.xml

9. Trois retours de séjour

édition complète — theme_volet.s_volet_avis

• Surtitre : « Retours »
• Titre (h2) : « Trois séjours de la saison dernière »
• Structure : 3 éléments répétés (.o_volet_quote), répartis sur 3 colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : avis, temoignages, sejour, retours, hotes
• Fichier : theme_volet/views/snippets/s_volet_avis.xml

10. La maison en deux colonnes

édition complète — theme_volet.s_volet_maison

• Surtitre : « La maison »
• Titre (h2) : « 1834, deux mille mètres carrés de jardin, et pas de télévision »
• Structure : 2 colonnes de la grille Bootstrap.
• Boutons et liens : « Voir les chambres » → /les-chambres.
• Images : 1 au total, toutes la même, /theme_volet_lite/static/src/img/volet_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, histoire, presentation, jardin, deux colonnes
• Fichier : theme_volet/views/snippets/s_volet_maison.xml

11. Questions fréquentes

édition complète — theme_volet.s_volet_faq

• Surtitre : « Questions fréquentes »
• Titre (h2) : « Ce qu'on nous demande avant de réserver »
• Structure : 6 questions en accordéon, la première dépliée à l'ouverture de la page.
• Intitulés livrés : « Acceptez-vous les animaux ? », « Le wifi fonctionne-t-il partout ? », « Peut-on venir avec des enfants ? », « Quelles sont les conditions d'annulation ? », « Une chambre est-elle accessible ? », « Peut-on arriver après 19h30 ? ».
• Mots-clés de recherche dans l'éditeur : faq, questions, reponses, animaux, enfants, wifi, annulation
• Fichier : theme_volet/views/snippets/s_volet_faq.xml

12. Accès et contact

édition complète — theme_volet.s_volet_acces

• Surtitre : « Venir »
• Titre (h2) : « Chemin des Volets, après le pont, la maison aux persiennes vertes »
• Structure : 3 colonnes de la grille Bootstrap.
• Intitulés livrés : « Accueil ».
• Images : 1 au total, toutes la même, /theme_volet_lite/static/src/img/volet_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, gare, stationnement, accueil
• Fichier : theme_volet/views/snippets/s_volet_acces.xml

5. Les deux palettes

Le thème livre deux palettes complètes et en sélectionne une par défaut : volet-persienne. 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_volet_quote pose l'encre #24312F sur le fond #FFFFFD, soit 13.48: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 Lora, texte courant en Mulish, barre de navigation en Lora et boutons en Mulish. 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_volet.pot et i18n/fr.po (191 chaînes pour l'édition complète, 55 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