Navigation et produits
Trouver un produit, choisir sa variante et comprendre sa disponibilité avant l’achat.
Accès
- Accueil : racine de la boutique.
- Catalogue : menu Produits.
- Fiche produit :
/{lang}/product/{slug}. - Catégorie : filtre du catalogue ou
/{lang}/c/{slug}. - Recherche : champ du header.
Une fiche ouverte par identifiant, SPU exact ou slug d’une autre langue redirige vers son slug localisé canonique et conserve la variante demandée. Un ancien slug n’est pas mémorisé : après un changement, mettez à jour les liens déjà diffusés.
Accueil et annonce
L’accueil peut présenter le visuel du thème, les éléments de réassurance, les produits mis en avant et jusqu’à six catégories racines publiées.
Les produits mis en avant portent le tag HOME. S’il est absent, renommé, non publié ou sans produit
vendable, la section utilise des produits génériques publiés et vendables.
L’annonce textuelle configurée dans Bannières apparaît au-dessus du header sur toutes les pages
localisées. Elle est distincte du visuel d’accueil, du tag HOME et de l’image BANNER d’une
catégorie. Voir Bannières.
Rechercher et filtrer
La recherche rapide du header propose quelques produits pendant la saisie. Le catalogue recherche dans les noms, descriptions, codes, tags, caractéristiques, options et attributs, puis peut combiner :
- catégorie et sous-catégories publiées ;
- fourchette de prix ;
- note minimale ;
- tri par date, prix, nom ou note.
Si la recherche avancée est indisponible, un repli conserve la recherche textuelle et les principaux filtres, sans tolérance aux fautes ni score de pertinence. Le tri de pertinence revient alors au plus récent.
Le catalogue n’affiche qu’un produit publié possédant au moins une variante publiée et vendable. Les prix, promotions et devises sont calculés au moment de la lecture, jamais repris d’un index périmé.
Cartes produit
Une carte présente l’image principale, le nom, la note, le prix effectif, la promotion éventuelle, les premiers tags, la disponibilité utile et le cœur des favoris.
Avec une seule variante vendable, elle montre son prix exact. Avec plusieurs variantes, elle montre l’agrégat choisi par le marchand. Les notes peuvent regrouper toutes les variantes publiées, alors que les prix et le nombre de variantes ne retiennent que celles qui sont vendables.
Fiche produit
La fiche rassemble :
- la galerie du produit et, en priorité, les médias de la variante sélectionnée ;
- les tags publiés du produit et de cette variante, sans doublon ;
- le prix exact de la variante, ses promotions et son état de stock ;
- les caractéristiques effectives et les options ;
- les avis, informations de livraison et produits similaires.
Une variante publiée en rupture reste visible mais désactivée. Une fiche dont toutes les variantes sont en rupture reste accessible par son URL directe, même si elle disparaît des catalogues, recommandations et sitemap.
Choisir une variante
Au chargement, ModuShop sélectionne la variante par défaut si elle est vendable, sinon la première vendable. Si aucune ne l’est, la première variante publiée reste affichée mais ne peut pas être achetée.
Selon la configuration du produit :
- une matrice propose les valeurs de chaque axe ; une valeur grisée ne mène à aucune combinaison publique encore compatible avec le choix courant ;
- une grille présente les variantes hors matrice sous forme de cartes ;
- un produit mixte affiche les deux, et le dernier choix détermine la variante active.
Tous les variants publiés restent visibles. La rupture désactive le choix ; la précommande reste
sélectionnable avec son délai lorsqu’il existe. Un lien ?variant={uuid} n’est appliqué que si la
variante appartient au produit et est publiée.
Une sélection complète met à jour prix, galerie, tags, caractéristiques, options et stock. Si son chargement échoue, l’achat reste bloqué avec une action Réessayer : une autre variante n’est jamais substituée silencieusement.
Caractéristiques et options
Une caractéristique de variante remplace celle du produit portant la même identité ; les autres restent héritées. Les valeurs non publiées ne sont pas montrées. Voir Caractéristiques.
Les options produit et variante sont affichées séparément et peuvent modifier le prix. Changer de variante conserve les choix produit, mais retire les choix propres à l’ancienne variante. Le serveur revalide toujours les options et leurs montants lors de l’ajout au panier.
Ajouter, partager ou garder en favori
Choisissez la quantité et les options, puis utilisez Ajouter au panier ou Précommander. En rupture sans précommande, le bouton reste désactivé.
Le cœur de la fiche mémorise la variante. Le bouton de partage reprend l’URL courante et sa variante. Voir Panier et Favoris.
Catégories
Le catalogue charge l’arbre publié et inclut le sous-arbre de la catégorie choisie. Une catégorie
n’est publique que si tous ses parents le sont. Sa page dédiée présente son nom, sa description et
ses produits ; son image BANNER est utilisée sur les surfaces qui la prévoient.
Une page catégorie ouverte par code, mauvaise casse ou slug d’une autre langue redirige vers son slug localisé. Ses champs SEO dédiés alimentent les métadonnées, avec le nom et la description en repli ; canonical, alternates de langue et sitemap utilisent les mêmes routes.
Résoudre un problème
| Symptôme | Action |
|---|---|
| Produit absent du catalogue | Vérifier produit publié, variante publiée et vendabilité. |
| Variante visible mais impossible à choisir | Elle est en rupture ou incompatible avec la sélection de matrice. |
| Ancienne URL en 404 | Ouvrir le nouveau slug et mettre à jour les liens externes. |
| Recherche moins tolérante | Le moteur avancé peut être indisponible ; préciser les termes ou utiliser les filtres. |
| Prix ou livraison changés après choix de devise | Revérifier le panier avant le checkout. |