Sélecteurs de thème
Tous les sélecteurs que l’app utilise pour trouver des éléments dans votre thème, et les deux façons d’en modifier un.
L’app trouve votre formulaire produit, votre prix, votre sélecteur de variantes et vos lignes de panier à l’aide de sélecteurs CSS. Elle intègre un jeu de sélecteurs optimisé pour chaque thème pris en charge et un jeu par défaut plus large pour les autres, ce qui explique qu’elle fonctionne sur la plupart des thèmes sans aucune aide.
Un thème très personnalisé peut néanmoins placer un élément hors de portée des sélecteurs par défaut. Il existe deux façons d’y remédier, et la première est presque toujours la meilleure.
1. Ajouter l’attribut propre à l’app
Presque tous les sélecteurs commencent par un attribut data-gpo-… qui existe uniquement pour vous servir de point d’accroche. Ajoutez cet attribut à l’élément dans votre thème et l’app le trouve, sans sélecteur à maintenir et sans rien qu’une mise à jour du thème puisse renommer.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>L’attribut correspondant à chaque sélecteur figure dans les tableaux ci-dessous.
2. Remplacer le sélecteur
Utilisez cette méthode lorsque vous ne pouvez pas modifier le balisage — une section que vous ne contrôlez pas, ou une app qui affiche le formulaire. Définissez-le avant l’exécution du script de l’app, dans theme.liquid au-dessus de </body> :
<script> window.GPOConfigs = window.GPOConfigs || {}; window.GPOConfigs.theme = window.GPOConfigs.theme || {}; window.GPOConfigs.theme.product = { ...(window.GPOConfigs.theme.product || {}), form: ['#my-product-form'], addToCartButton: '.my-atc-button' };</script>Vos valeurs sont fusionnées par-dessus celles de l’app : vous ne remplacez donc que les clés que vous indiquez.
product
Utilisé sur les pages produit, ainsi que dans les sections de produit en vedette ailleurs sur la boutique.
| Clé | Attribut d’accroche | Ce que l’app en fait |
|---|---|---|
form | data-gpo-product-form | Le formulaire produit. C’est le point d’ancrage de tout le reste — les options y sont affichées et validées à l’envoi. Accepte un tableau, essayé dans l’ordre |
addToCartButton | data-gpo-product-atc | Le bouton d’ajout au panier. Sert à placer le widget au-dessus, et à bloquer l’envoi en cas d’échec de la validation |
paymentButton | — | Le bouton de paiement accéléré. Masqué sur les produits comportant des options, car il contournerait le formulaire |
quantity | — | Le champ de quantité. Lu pour que la quantité des suppléments puisse suivre celle du produit principal |
unitPrice | data-gpo-product-unit-price | Le prix affiché. Réécrit à mesure que le client choisit des options payantes |
compareAtPrice | data-gpo-product-compare-at-price | Le prix barré, mis à jour en même temps |
variantSelector | data-gpo-product-variant-selector | Le champ masqué contenant l’identifiant de la variante choisie. Lu pour savoir quelle variante est sélectionnée |
variantActivator | data-gpo-product-variant-activator | Les commandes sur lesquelles le client clique pour changer de variante. Surveillées pour que les conditions sur les variantes puissent réagir |
variantWrapper | data-gpo-product-variant-wrapper | Le bloc contenant les sélecteurs de variantes. Sert à positionner le widget par rapport à eux |
imageContainer | data-gpo-product-image-container | La zone de l’image principale. C’est là que le personnaliseur dessine son aperçu en direct |
image | data-gpo-product-image | L’image principale du produit elle-même |
images | data-gpo-product-images | Les images de la galerie, pour le paramètre Appliquer à de l’aperçu |
imageButton | data-gpo-product-image-button | Les miniatures ou flèches de la galerie, surveillées pour que l’aperçu suive l’image affichée |
sticky.atcButton | data-gpo-sticky-atc | Le bouton d’ajout au panier d’une barre fixe, pour qu’il valide comme le vrai bouton |
sticky.variantActivator | data-gpo-sticky-variant-activator | La commande de variante d’une barre fixe |
collection
Utilisé pour les fenêtres d’aperçu rapide sur les pages de collection.
| Clé | Attribut d’accroche | Ce que l’app en fait |
|---|---|---|
wrapper | data-gpo-collection-wrapper | La section de collection, la zone que l’app surveille |
item | data-gpo-collection-item | Une fiche produit à l’intérieur |
productLink | data-gpo-collection-productLink | Le lien vers le produit, lu pour savoir à quel produit correspond une fiche |
quickViewActivator | data-gpo-collection-qvActivator | La commande qui ouvre l’aperçu rapide, surveillée pour que l’app sache quand effectuer le rendu |
quickViewProductForm | data-gpo-collection-qvForm | Le formulaire produit à l’intérieur de l’aperçu rapide, où s’affichent les options |
cart
Utilisé sur la page du panier et dans le panier latéral, pour modifier les options et pour garder les lignes de suppléments liées à leur article parent.
| Clé | Attribut d’accroche | Ce que l’app en fait |
|---|---|---|
form | data-gpo-cart-form | Le formulaire du panier. Accepte un tableau, essayé dans l’ordre |
page | voir ci-dessous | La façon de lire un article sur la page du panier. Accepte un tableau de structures, essayées dans l’ordre |
drawer | voir ci-dessous | La même chose pour le panier latéral |
page et drawer contiennent chacun un lineItem qui décrit les parties d’une ligne de panier :
| Partie | Attribut d’accroche (page du panier) | Description |
|---|---|---|
key | data-gpo-cart-item-key | La ligne elle-même, qui porte la clé de l’article |
image | data-gpo-cart-item-image | La miniature de la ligne |
details | data-gpo-cart-item-details | Le bloc du titre et des propriétés, où le bouton Modifier les options est ajouté |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | La commande de quantité, masquée sur les lignes de suppléments |
quantity.input | data-gpo-cart-item-qty | Le champ de quantité |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Les boutons moins et plus |
removeButton | data-gpo-cart-item-remove-button | Le lien de suppression, masqué sur les lignes de suppléments |
Le panier latéral utilise les mêmes parties avec data-gpo-drawer-item-… au lieu de data-gpo-cart-item-….
Remarques
- Les clés qui acceptent un tableau sont essayées dans l’ordre et la première correspondance l’emporte : vous pouvez donc ajouter les vôtres avant les valeurs par défaut plutôt que de les remplacer.
- Remplacer un sélecteur modifie uniquement l’endroit où l’app cherche. Cela ne change ni ce que les options recueillent ni leur tarification.
- Un remplacement s’applique à toutes les pages produit de la boutique. Pour un seul produit, ciblez-le dans le sélecteur lui-même.
Cette page vous a-t-elle aidé ?
Merci pour votre retour ! Dites-nous ce qui manquait
Signaler un problème