Themaselectors
Elke selector die de app gebruikt om elementen in je thema te vinden, en de twee manieren om er een te wijzigen.
De app vindt je productformulier, prijs, variantkiezer en winkelwagenregels via CSS-selectors. Hij levert een afgestemde set voor elk ondersteund thema en een brede standaardset voor de rest. Daarom werkt hij op de meeste thema’s zonder hulp.
Een sterk aangepast thema kan toch iets plaatsen waar de standaardselectors niet bij kunnen. Er zijn twee manieren om dat op te lossen, en de eerste is bijna altijd de betere.
1. Voeg het eigen attribuut van de app toe
Bijna elke selector begint met een data-gpo-…-attribuut dat er puur als haak voor jou is. Zet dat attribuut op het element in je thema en de app vindt het. Je hoeft geen selector te onderhouden en een thema-update kan niets hernoemen.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Het attribuut voor elke selector staat in de tabellen hieronder.
2. Overschrijf de selector
Gebruik dit als je de markup niet kunt bewerken — een sectie die je niet beheert, of een app die het formulier rendert. Stel het in voordat het script van de app draait, in theme.liquid boven </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>Je waarden worden over die van de app heen samengevoegd. Je overschrijft dus alleen de sleutels die je noemt.
product
Gebruikt op productpagina’s, en elders in secties met een uitgelicht product.
| Sleutel | Attribuuthaak | Wat de app ermee doet |
|---|---|---|
form | data-gpo-product-form | Het productformulier. Dit is het anker voor al het andere — de opties worden erin gerenderd en bij verzenden gecontroleerd. Accepteert een array, op volgorde geprobeerd |
addToCartButton | data-gpo-product-atc | De knop Toevoegen aan winkelwagen. Gebruikt om de widget erboven te plaatsen en om het verzenden te blokkeren als de validatie mislukt |
paymentButton | — | De knop voor versneld betalen. Verborgen bij producten met opties, omdat hij het formulier zou overslaan |
quantity | — | Het aantalveld. Gelezen zodat add-on-hoeveelheden de hoeveelheid van het hoofdproduct kunnen volgen |
unitPrice | data-gpo-product-unit-price | De getoonde prijs. Herschreven terwijl de klant opties met een prijs kiest |
compareAtPrice | data-gpo-product-compare-at-price | De vergelijkingsprijs, samen met de prijs bijgewerkt |
variantSelector | data-gpo-product-variant-selector | Het verborgen invoerveld met de id van de gekozen variant. Gelezen om te weten welke variant is geselecteerd |
variantActivator | data-gpo-product-variant-activator | De bedieningselementen waarop de klant klikt om van variant te wisselen. In de gaten gehouden zodat variantvoorwaarden kunnen reageren |
variantWrapper | data-gpo-product-variant-wrapper | Het blok met de variantkiezers. Gebruikt om de widget ten opzichte daarvan te plaatsen |
imageContainer | data-gpo-product-image-container | Het gebied van de hoofdafbeelding. Hier tekent de Personalisator zijn livevoorbeeld |
image | data-gpo-product-image | De hoofdafbeelding van het product zelf |
images | data-gpo-product-images | De galerijafbeeldingen, voor de instelling Toepassen op van het voorbeeld |
imageButton | data-gpo-product-image-button | De miniaturen of pijlen van de galerij, in de gaten gehouden zodat het voorbeeld de getoonde afbeelding volgt |
sticky.atcButton | data-gpo-sticky-atc | De knop Toevoegen aan winkelwagen in een sticky balk, zodat die net als de echte knop valideert |
sticky.variantActivator | data-gpo-sticky-variant-activator | Het variantbedieningselement in een sticky balk |
collection
Gebruikt voor snelweergave-pop-ups op collectiepagina’s.
| Sleutel | Attribuuthaak | Wat de app ermee doet |
|---|---|---|
wrapper | data-gpo-collection-wrapper | De collectiesectie, het gebied dat de app in de gaten houdt |
item | data-gpo-collection-item | Eén productkaart daarbinnen |
productLink | data-gpo-collection-productLink | De link naar het product, gelezen om te weten welk product een kaart is |
quickViewActivator | data-gpo-collection-qvActivator | Het bedieningselement dat de snelweergave opent, in de gaten gehouden zodat de app weet dat hij moet renderen |
quickViewProductForm | data-gpo-collection-qvForm | Het productformulier in de snelweergave, waar de opties komen |
cart
Gebruikt op de winkelwagenpagina en in de winkelwagenlade, om opties te bewerken en om add-onregels aan hun hoofdartikel gekoppeld te houden.
| Sleutel | Attribuuthaak | Wat de app ermee doet |
|---|---|---|
form | data-gpo-cart-form | Het winkelwagenformulier. Accepteert een array, op volgorde geprobeerd |
page | zie hieronder | Hoe een artikelregel op de winkelwagenpagina wordt gelezen. Accepteert een array van vormen, op volgorde geprobeerd |
drawer | zie hieronder | Hetzelfde voor de winkelwagenlade |
page en drawer bevatten elk een lineItem dat de onderdelen van één winkelwagenrij beschrijft:
| Onderdeel | Attribuuthaak (winkelwagenpagina) | Wat het is |
|---|---|---|
key | data-gpo-cart-item-key | De rij zelf, met de sleutel van de artikelregel |
image | data-gpo-cart-item-image | De miniatuur van de rij |
details | data-gpo-cart-item-details | Het blok met titel en eigenschappen, waar Opties bewerken wordt toegevoegd |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Het aantalbedieningselement, verborgen op add-onregels |
quantity.input | data-gpo-cart-item-qty | Het aantalveld |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | De min- en plusknoppen |
removeButton | data-gpo-cart-item-remove-button | De verwijderlink, verborgen op add-onregels |
De lade gebruikt dezelfde onderdelen met data-gpo-drawer-item-… in plaats van data-gpo-cart-item-….
Opmerkingen
- Sleutels die een array accepteren, worden op volgorde geprobeerd en de eerste match wint. Je kunt de jouwe dus vóór de standaardwaarden zetten in plaats van ze te vervangen.
- Een selector overschrijven verandert alleen waar de app zoekt. Het verandert niet wat de opties verzamelen of hoe ze worden geprijsd.
- Een overschrijving geldt voor elke productpagina in de winkel. Richt je in de selector zelf op één product als je alleen dat wilt.
Was dit nuttig?
Bedankt voor je feedback! Vertel ons wat er ontbrak
Probleem melden