Thème Voyage — Carnet de voyage et tourisme (pro)

Guide utilisateur — Thème Voyage — Carnet de voyage et tourisme (pro)

Module theme_voyage, version 19.0.1.0.0, OPL-1, 99 €. Il s'installe par-dessus le module gratuit theme_voyage_lite, dont il dépend.

À qui s'adresse ce thème

À une agence de voyage, un tour-opérateur ou un organisateur de séjours qui détaille un itinéraire étape par étape et ouvre un calendrier de départs.

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

Ce qu'il fait, et ce qu'il ne fait pas

Il fait : poser douze blocs manipulables dans l'éditeur de site Odoo 19 (quatre venant de l'édition gratuite, huit de celle-ci), quatre pages, trois entrées de menu, deux palettes complètes et un habillage typographique.

Il ne fait pas :

• Il ne vend aucun séjour : la demande de devis est un lien vers la page de contact d'Odoo, pas un moteur de réservation.
• Le calendrier de départs et les places restantes sont du contenu éditable : aucun stock n'est décrémenté.
• Il ne se connecte à aucun système de distribution ni à aucun assureur.
• Il ne contient aucun code Python : les deux modules se réduisent à des vues, du SCSS, des images et un __init__.py vide. Rien ne tourne côté serveur.
• Il ne fournit aucune photographie : les 37 images des deux modules sont engendrées par programme.
• Il ne copie aucun fichier de police : les polices sont chargées par Odoo depuis Google Fonts via $o-theme-font-configs.
• Il ne modifie aucun module du cœur d'Odoo : tout passe par l'héritage de vues.

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

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), retirez le filtre Applications, cherchez theme_voyage et installez Thème Voyage — Carnet de voyage et tourisme (pro). Odoo installe theme_voyage_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_voyage --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é tant que le thème n'est pas appliqué.

Dépendances déclarées : theme_voyage_lite dépend de website ; theme_voyage dépend de theme_voyage_lite.

2. Appliquer le thème au site

Site web → Configuration → Paramètres → Thème, ou directement Site web → Éditer → Thème. Choisissez Thème Voyage — Carnet de voyage et tourisme (pro) 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 Voyage (/nos-voyages) ;
• la page Destination (/destination-vantour) ;
• la page Itinéraire (/itineraire-cretes-de-vantour) ;
• les trois entrées de menu correspondantes ;
• l'habillage d'en-tête et de 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 d'abord sur une copie.

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

La page d'accueil (/)

Sections montées, dans cet ordre : o_cc, o_cc.

Elles sont posées dans un oe_structure : chacune se déplace, se duplique et se supprime dans l'éditeur comme n'importe quel bloc Odoo.

Voyage (/nos-voyages)

Sections montées, dans cet ordre : o_cc, o_cc, o_cc.

Elles sont posées dans un oe_structure : chacune se déplace, se duplique et se supprime dans l'éditeur comme n'importe quel bloc Odoo.

Destination (/destination-vantour)

Sections montées, dans cet ordre : o_cc, o_cc, o_cc, o_cc.

Elles sont posées dans un oe_structure : chacune se déplace, se duplique et se supprime dans l'éditeur comme n'importe quel bloc Odoo.

Itinéraire (/itineraire-cretes-de-vantour)

Sections montées, dans cet ordre : o_cc, o_cc, o_cc.

Elles sont posées dans un oe_structure : chacune se déplace, se duplique et se supprime dans l'éditeur comme n'importe quel bloc Odoo.

Le menu

Pour renommer ou réordonner une entrée : Site web → Site → Menus.

Le pied de page

Le thème ne remplace pas le pied de page par défaut : il ajoute des dispositions que vous choisissez dans l'éditeur (voir ci-dessous).

Dispositions d'en-tête et de pied de page sélectionnables

Le thème ajoute trois dispositions d'en-tête à la liste native du panneau Éditer → En-tête :

• Voyage — En-tête centré — theme_voyage.template_header_voyage_centered
• Voyage — En-tête avec bandeau d'information — theme_voyage.template_header_voyage_topbar
• Voyage — En-tête minimal — theme_voyage.template_header_voyage_minimal

Et deux dispositions de pied de page dans Éditer → Pied de page :

• Voyage — Pied de page étendu — theme_voyage.template_footer_voyage_expanded
• Voyage — Pied de page compact — theme_voyage.template_footer_voyage_compact

Ces vues sont livrées inactives (active="False") : Odoo les active quand vous choisissez la disposition dans l'éditeur. Elles sont déclarées au constructeur de site par static/src/builder/voyage_footer_option_plugin.js, static/src/builder/voyage_layout_options.xml.

4. Les douze blocs, un par un

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

1. Bandeau d'accueil

édition gratuite — theme_voyage_lite.s_voyage_hero

• Surtitre : « Itinéraires accompagnés »
• Titre (h1) : « Prenez le temps long, du col de Vantour aux rives de la Sèvre »
• Chapeau : « Douze itinéraires conçus à pied, en train et à vélo, entre quatre et seize jours, avec des hébergements choisis un par un. »
• Structure : une seule colonne, pleine largeur.
• Boutons et liens : « Voir les itinéraires » → #, « Demander un devis » → #.
• Mots-clés de recherche dans l'éditeur : bandeau, hero, accueil, couverture, plein ecran, voyage
• Fichier : theme_voyage_lite/views/snippets/s_voyage_hero.xml

2. Grille de destinations

édition gratuite — theme_voyage_lite.s_voyage_destinations

• Surtitre : « Destinations »
• Titre (h2) : « Six régions, six manières de ralentir »
• Structure : six éléments répétés (.o_voyage_card), répartis sur six colonnes de la grille Bootstrap.
• Intitulés livrés : « Les crêtes de Vantour », « La boucle des marais », « Le littoral des cabanes », « Traversée des hauts plateaux », « Vignes et villages hauts », « D'une gare à l'autre, en train lent ».
• Images : six au total, six fichiers distincts. 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 : destinations, cartes, grille, sejours, catalogue
• Fichier : theme_voyage_lite/views/snippets/s_voyage_destinations.xml

3. Récit deux colonnes

édition gratuite — theme_voyage_lite.s_voyage_recit

• Surtitre : « Carnet de route »
• Titre (h2) : « Le quatrième jour, on cesse de compter les kilomètres »
• Structure : deux colonnes de la grille Bootstrap.
• Boutons et liens : « Lire le carnet complet » → #.
• Images : une seule, /theme_voyage_lite/static/src/img/voyage_recit.png. Illustration engendrée par programme et livrée dans le module — aucune photographie. Son attribut alt est vide : elle est décorative et les lecteurs d'écran l' ignorent.
• Mots-clés de recherche dans l'éditeur : recit, carnet, texte image, deux colonnes, histoire
• Fichier : theme_voyage_lite/views/snippets/s_voyage_recit.xml

4. Appel à l'action

édition gratuite — theme_voyage_lite.s_voyage_appel

• Surtitre : « Parlons-en »
• Titre (h2) : « Un projet, une date, un niveau : on construit le reste »
• Structure : une seule colonne, pleine largeur.
• Boutons et liens : « Demander un devis » → /contactus.
• Mots-clés de recherche dans l'éditeur : appel, action, cta, devis, contact, conversion
• Fichier : theme_voyage_lite/views/snippets/s_voyage_appel.xml

5. Carte d'itinéraire

édition complète — theme_voyage.s_voyage_itineraire

• Surtitre : « Itinéraire »
• Titre (h2) : « Les crêtes de Vantour, jour après jour »
• Structure : sept éléments répétés (.o_voyage_step), répartis sur deux colonnes de la grille Bootstrap.
• Intitulés livrés : « De la gare au hameau des Granges », « La traversée du plateau », « Journée libre au refuge du Col », « Les balcons de la vallée », « Vers le versant nord », « La longue descente », « Retour à la gare ».
• Images : une seule, /theme_voyage/static/src/img/voyage_carte.png. Illustration engendrée par programme et livrée dans le module — aucune photographie. Son attribut alt est vide : elle est décorative et les lecteurs d'écran l' ignorent.
• Mots-clés de recherche dans l'éditeur : itineraire, etapes, jours, parcours, programme, roadbook
• Fichier : theme_voyage/views/snippets/s_voyage_itineraire.xml

6. Galerie mosaïque

édition complète — theme_voyage.s_voyage_galerie

• Surtitre : « Galerie »
• Titre (h2) : « Sept jours en images »
• Structure : cinq éléments répétés (.o_voyage_tile).
• Images : cinq au total, cinq fichiers distincts. Illustration engendrée par programme et livrée dans le module — aucune photographie.
• Mots-clés de recherche dans l'éditeur : galerie, photos, mosaique, lightbox, images, album
• Fichier : theme_voyage/views/snippets/s_voyage_galerie.xml

7. Fiche destination

édition complète — theme_voyage.s_voyage_fiche

• Surtitre : « En bref »
• Titre (h2) : « Les crêtes de Vantour »
• Structure : quatre éléments répétés (.o_voyage_fact).
• Mots-clés de recherche dans l'éditeur : fiche, duree, budget, saison, difficulte, resume
• Fichier : theme_voyage/views/snippets/s_voyage_fiche.xml

8. Témoignages

édition complète — theme_voyage.s_voyage_temoignages

• Surtitre : « Ils y sont allés »
• Titre (h2) : « Trois retours, sans retouche »
• Structure : trois éléments répétés (.o_voyage_quote), répartis sur trois colonnes de la grille Bootstrap.
• Images : trois au total, trois fichiers distincts. 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 : temoignages, avis, clients, citations, retours
• Fichier : theme_voyage/views/snippets/s_voyage_temoignages.xml

9. Calendrier de départs

édition complète — theme_voyage.s_voyage_departs

• Surtitre : « Départs »
• Titre (h2) : « Prochaines dates garanties »
• Structure : quatre éléments répétés (.o_voyage_status).
• Boutons et liens : « Réserver » → #, « Réserver » → #, « Liste d'attente » → #, « Réserver » → #.
• Mots-clés de recherche dans l'éditeur : departs, dates, calendrier, disponibilites, places, tarifs
• Fichier : theme_voyage/views/snippets/s_voyage_departs.xml

10. Demande de devis

édition complète — theme_voyage.s_voyage_devis

• Surtitre : « Sur mesure »
• Titre (h2) : « Dites-nous ce que vous cherchez »
• Structure : deux colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : devis, formulaire, contact, demande, sur mesure
• Fichier : theme_voyage/views/snippets/s_voyage_devis.xml

11. Carnet de bord

édition complète — theme_voyage.s_voyage_carnet

• Surtitre : « Carnet de bord »
• Titre (h2) : « Ce qu'on a noté le soir »
• Structure : quatre éléments répétés (.o_voyage_log_item).
• Images : deux au total, deux fichiers distincts. 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 : carnet, journal, chronologie, recit, jours
• Fichier : theme_voyage/views/snippets/s_voyage_carnet.xml

12. Bascule mode sombre

édition complète — theme_voyage.s_voyage_mode_sombre

• Titre : ce bloc n'en porte pas — c'est un bandeau sans titre de section.
• Structure : une seule colonne, pleine largeur.
• Mots-clés de recherche dans l'éditeur : mode sombre, dark mode, contraste, theme, bascule, nuit
• Fichier : theme_voyage/views/snippets/s_voyage_mode_sombre.xml

5. Les deux palettes

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

Dans la convention d'Odoo : couleur 1 est la couleur primaire (boutons, liens), couleur 2 la secondaire, couleur 3 le fond alterné, couleur 4 le fond de page, couleur 5 le fond sombre du pied de page.

Contrastes mesurés (rapport WCAG, calculé sur les valeurs livrées) :

Le texte courant du thème est la couleur 5 sur la couleur 4 : c'est la colonne de droite qui compte pour la lisibilité du corps de texte. La couleur 1 sert aux boutons et aux liens — sur un bouton plein, c'est un fond, pas un texte, et le seuil applicable n'est pas le même.

Typographie. Titres en Poppins, texte courant en Inter, barre de navigation en Poppins, boutons en Poppins. 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, h2 ×2.2, h3 ×1.6, h4 ×1.3.

Les palettes sont déclarées dans le module gratuit, et le module payant redéclare le SCSS du gratuit dans son propre assets. 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 automatiquement des feuilles de style 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 surtitres, 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é : reposer le même bloc ailleurs le redonne dans son état d'origine.

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

Pour remplacer une image : sélectionnez-la, puis Remplacer l'image. Cela passe par la bibliothèque de médias d'Odoo, qui gère les tailles. Format utile : 1200 × 800 pour les visuels de contenu, 1200 × 630 pour les fonds de bandeau.

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.

7. Les traductions

Le thème est écrit en français. Les deux modules livrent leur fichier de traduction : theme_voyage_lite/i18n/theme_voyage_lite.pot et theme_voyage_lite/i18n/fr.po, theme_voyage/i18n/theme_voyage.pot et theme_voyage/i18n/fr.po. 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.

Le fr.po déclare Language: fr et reprend chaque msgid à l'identique en msgstr : les thèmes étant écrits en français, la langue source et la langue cible sont la même.

8. 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 lors de l'application, 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 theme_voyage sans désinstaller theme_voyage_lite laisse un site cohérent : les quatre blocs de base et la direction artistique restent.

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

Contenu de démonstration entièrement fictif. Aucune photographie tierce, aucune marque tierce, aucun thème existant copié ou adapté.