Thème Animalerie — Boutique en ligne (pro)

Guide utilisateur — Thème Animalerie — Boutique en ligne (pro)

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

À qui s'adresse ce thème

À une animalerie qui vend en ligne — croquettes, litières, accessoires, soins — et dont les clients hésitent entre trois paniers avant d'en choisir un. C'est le seul thème de la série qui s'appuie sur la boutique d'Odoo : le module gratuit dépend de website_sale.

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 onze blocs manipulables dans l'éditeur de site Odoo 19 (trois venant de l'édition gratuite, huit de celle-ci), trois pages, deux entrées de menu, deux palettes complètes et un habillage typographique.

Il ne fait pas :

• Il ne gère ni le stock, ni les commandes, ni les paiements : c'est website_sale, le module de boutique d'Odoo, qui le fait. Le thème l'habille.
• Le comparateur de produits et le guide de tailles sont du contenu éditable, pas une comparaison calculée sur votre catalogue.
• L'abonnement affiché est une mise en page : il n'ouvre aucun abonnement réel et ne déclenche aucune facturation récurrente.
• 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 40 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_animalerie et installez Thème Animalerie — Boutique en ligne (pro). Odoo installe theme_animalerie_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_animalerie --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_animalerie_lite dépend de website, website_sale ; theme_animalerie dépend de theme_animalerie_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 Animalerie — Boutique en ligne (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 Boutique (/notre-boutique) ;
• la page Catégorie enrichie (/categorie-chiens) ;
• les deux 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, 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.

Boutique (/notre-boutique)

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.

Catégorie enrichie (/categorie-chiens)

Sections montées, dans cet ordre : o_cc, o_cc, o_cc, o_cc, 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.

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 :

• Animalerie — En-tête centré — theme_animalerie.template_header_anim_centered
• Animalerie — En-tête avec bandeau de réassurance — theme_animalerie.template_header_anim_topbar
• Animalerie — En-tête minimal — theme_animalerie.template_header_anim_minimal

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

• Animalerie — Pied de page étendu — theme_animalerie.template_footer_anim_expanded
• Animalerie — Pied de page compact — theme_animalerie.template_footer_anim_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/anim_footer_option_plugin.js, static/src/builder/anim_layout_options.xml.

4. Les onze blocs, un par un

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

1. Accueil boutique

édition gratuite — theme_animalerie_lite.s_anim_accueil

• Surtitre : « Trèfle & Museau »
• Titre (h1) : « De quoi bien nourrir, bien coucher et bien occuper vos animaux »
• Chapeau : « Une sélection courte et assumée : quatre-vingts références, toutes testées, aucune n'est là pour remplir le rayon. »
• Structure : trois éléments répétés (.o_anim_product_body), répartis sur deux colonnes de la grille Bootstrap.
• Intitulés livrés : « Chiens », « Chats », « Petits animaux ».
• Boutons et liens : « Voir la boutique » → /shop, « Nos conseils » → #, « Chiens Alimentation, couchage, promenade. » → /shop, « Chats Griffoirs, fontaines, pâtées sans additifs. » → /shop, « Petits animaux Habitats, foin, accessoires silencieux. » → /shop.
• Images : quatre au total, quatre 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 : accueil, boutique, hero, categories, animalerie, vitrine
• Fichier : theme_animalerie_lite/views/snippets/s_anim_accueil.xml

2. Grille de produits

édition gratuite — theme_animalerie_lite.s_anim_produits

• Surtitre : « Sélection »
• Titre (h2) : « Ce qui part le plus vite »
• Structure : quatre éléments répétés (.o_anim_product_body), répartis sur quatre colonnes de la grille Bootstrap.
• Intitulés livrés : « Gamelle inclinée en grès », « Griffoir vertical en sisal », « Cage à barreaux pour rongeur », « Croquettes sans céréales, poulet ».
• Boutons et liens : « Toute la boutique » → /shop.
• Images : quatre au total, quatre 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 : produits, grille, cartes, selection, prix, boutique
• Fichier : theme_animalerie_lite/views/snippets/s_anim_produits.xml

3. Bandeau de réassurance

édition gratuite — theme_animalerie_lite.s_anim_reassurance

• Titre : ce bloc n'en porte pas — c'est un bandeau sans titre de section.
• Structure : quatre éléments répétés (.o_anim_trust), répartis sur quatre colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : reassurance, livraison, retours, paiement, confiance, garanties
• Fichier : theme_animalerie_lite/views/snippets/s_anim_reassurance.xml

4. Sélecteur par animal

édition complète — theme_animalerie.s_anim_selecteur

• Surtitre : « Pour qui ? »
• Titre (h2) : « Commencez par choisir votre animal »
• Structure : neuf éléments répétés (.o_anim_product_body), répartis sur trois colonnes de la grille Bootstrap.
• Intitulés livrés : « Alimentation », « Couchage », « Promenade », « Alimentation », « Griffoirs », « Hydratation », « Habitats », « Foin et litière », « Activité ».
• Boutons et liens : « Alimentation Croquettes, pâtées et friandises. » → /shop, « Couchage Paniers, coussins et housses lavables. » → /shop, « Promenade Laisses, harnais et gamelles de voyage. » → /shop, « Alimentation Pâtées sans additifs et croquettes. » → /shop, « Griffoirs Sisal, carton et arbres à chat. » → /shop, « Hydratation Fontaines silencieuses et filtres. » → /shop, « Habitats Cages, enclos et accessoires de fixation. » → /shop, « Foin et litière Première coupe, tamisée et compressée. » → /shop, « Activité Roues silencieuses, tunnels et cachettes. » → /shop.
• Images : douze au total, douze 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 : selecteur, animal, chien, chat, rongeur, filtre, onglets
• Fichier : theme_animalerie/views/snippets/s_anim_selecteur.xml

5. Comparateur de produits

édition complète — theme_animalerie.s_anim_comparateur

• Surtitre : « Comparer »
• Titre (h2) : « Trois paniers, trois usages »
• Structure : une seule colonne, pleine largeur.
• Mots-clés de recherche dans l'éditeur : comparateur, tableau, caracteristiques, choisir, comparaison
• Fichier : theme_animalerie/views/snippets/s_anim_comparateur.xml

6. Avis clients

édition complète — theme_animalerie.s_anim_avis

• Surtitre : « Avis »
• Titre (h2) : « Ce qu'en disent les clients »
• Structure : cinq éléments répétés (.o_anim_bar), répartis sur deux colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : avis, notes, etoiles, temoignages, confiance
• Fichier : theme_animalerie/views/snippets/s_anim_avis.xml

7. Guide de tailles

édition complète — theme_animalerie.s_anim_tailles

• Surtitre : « Guide de tailles »
• Titre (h2) : « Mesurer avant de commander »
• Structure : deux colonnes de la grille Bootstrap.
• Mots-clés de recherche dans l'éditeur : tailles, guide, mesures, tableau, correspondance
• Fichier : theme_animalerie/views/snippets/s_anim_tailles.xml

8. Abonnement

édition complète — theme_animalerie.s_anim_abonnement

• Surtitre : « Abonnement »
• Titre (h2) : « La litière et les croquettes arrivent toutes seules »
• Structure : trois éléments répétés (.o_anim_plan), répartis sur trois colonnes de la grille Bootstrap.
• Intitulés livrés : « Tous les deux mois », « Tous les mois », « Toutes les deux semaines ».
• Boutons et liens : « Choisir » → #, « Choisir » → #, « Choisir » → #.
• Mots-clés de recherche dans l'éditeur : abonnement, livraison recurrente, formules, fidelite, remise
• Fichier : theme_animalerie/views/snippets/s_anim_abonnement.xml

9. Blocs conseils

édition complète — theme_animalerie.s_anim_conseils

• Surtitre : « Conseils »
• Titre (h2) : « Trois choses qu'on nous demande souvent »
• Structure : trois éléments répétés (.o_anim_advice), répartis sur trois colonnes de la grille Bootstrap.
• Intitulés livrés : « Changer de croquettes sans troubles digestifs », « Où installer un griffoir pour qu'il serve », « Le bon rythme de nettoyage d'une cage ».
• Boutons et liens : « Tous les conseils » → #.
• 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 : conseils, guides, articles, aide, faq
• Fichier : theme_animalerie/views/snippets/s_anim_conseils.xml

10. Promotions

édition complète — theme_animalerie.s_anim_promotions

• Titre (h2) : « Semaine du couchage »
• Structure : deux éléments répétés (.o_anim_product_body), répartis sur deux colonnes de la grille Bootstrap.
• Intitulés livrés : « Panier matelassé », « Arbre à chat compact ».
• Boutons et liens : « Voir les couchages » → /shop.
• 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 : promotions, remise, soldes, offre, prix barre
• Fichier : theme_animalerie/views/snippets/s_anim_promotions.xml

11. Bascule mode sombre

édition complète — theme_animalerie.s_anim_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_animalerie/views/snippets/s_anim_mode_sombre.xml

5. Les deux palettes

Le thème livre deux palettes complètes et en sélectionne une par défaut : animalerie-nature. 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 Nunito, 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 ×2.9, h2 ×2.1, h3 ×1.55, h4 ×1.25.

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_animalerie_lite/i18n/theme_animalerie_lite.pot et theme_animalerie_lite/i18n/fr.po, theme_animalerie/i18n/theme_animalerie.pot et theme_animalerie/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_animalerie sans désinstaller theme_animalerie_lite laisse un site cohérent : les trois 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é.