Ga naar inhoud
App installeren
Nederlands

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.

SleutelAttribuuthaakWat de app ermee doet
formdata-gpo-product-formHet productformulier. Dit is het anker voor al het andere — de opties worden erin gerenderd en bij verzenden gecontroleerd. Accepteert een array, op volgorde geprobeerd
addToCartButtondata-gpo-product-atcDe 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
unitPricedata-gpo-product-unit-priceDe getoonde prijs. Herschreven terwijl de klant opties met een prijs kiest
compareAtPricedata-gpo-product-compare-at-priceDe vergelijkingsprijs, samen met de prijs bijgewerkt
variantSelectordata-gpo-product-variant-selectorHet verborgen invoerveld met de id van de gekozen variant. Gelezen om te weten welke variant is geselecteerd
variantActivatordata-gpo-product-variant-activatorDe bedieningselementen waarop de klant klikt om van variant te wisselen. In de gaten gehouden zodat variantvoorwaarden kunnen reageren
variantWrapperdata-gpo-product-variant-wrapperHet blok met de variantkiezers. Gebruikt om de widget ten opzichte daarvan te plaatsen
imageContainerdata-gpo-product-image-containerHet gebied van de hoofdafbeelding. Hier tekent de Personalisator zijn livevoorbeeld
imagedata-gpo-product-imageDe hoofdafbeelding van het product zelf
imagesdata-gpo-product-imagesDe galerijafbeeldingen, voor de instelling Toepassen op van het voorbeeld
imageButtondata-gpo-product-image-buttonDe miniaturen of pijlen van de galerij, in de gaten gehouden zodat het voorbeeld de getoonde afbeelding volgt
sticky.atcButtondata-gpo-sticky-atcDe knop Toevoegen aan winkelwagen in een sticky balk, zodat die net als de echte knop valideert
sticky.variantActivatordata-gpo-sticky-variant-activatorHet variantbedieningselement in een sticky balk

collection

Gebruikt voor snelweergave-pop-ups op collectiepagina’s.

SleutelAttribuuthaakWat de app ermee doet
wrapperdata-gpo-collection-wrapperDe collectiesectie, het gebied dat de app in de gaten houdt
itemdata-gpo-collection-itemEén productkaart daarbinnen
productLinkdata-gpo-collection-productLinkDe link naar het product, gelezen om te weten welk product een kaart is
quickViewActivatordata-gpo-collection-qvActivatorHet bedieningselement dat de snelweergave opent, in de gaten gehouden zodat de app weet dat hij moet renderen
quickViewProductFormdata-gpo-collection-qvFormHet 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.

SleutelAttribuuthaakWat de app ermee doet
formdata-gpo-cart-formHet winkelwagenformulier. Accepteert een array, op volgorde geprobeerd
pagezie hieronderHoe een artikelregel op de winkelwagenpagina wordt gelezen. Accepteert een array van vormen, op volgorde geprobeerd
drawerzie hieronderHetzelfde voor de winkelwagenlade

page en drawer bevatten elk een lineItem dat de onderdelen van één winkelwagenrij beschrijft:

OnderdeelAttribuuthaak (winkelwagenpagina)Wat het is
keydata-gpo-cart-item-keyDe rij zelf, met de sleutel van de artikelregel
imagedata-gpo-cart-item-imageDe miniatuur van de rij
detailsdata-gpo-cart-item-detailsHet blok met titel en eigenschappen, waar Opties bewerken wordt toegevoegd
quantity.wrapperdata-gpo-cart-item-qty-wrapperHet aantalbedieningselement, verborgen op add-onregels
quantity.inputdata-gpo-cart-item-qtyHet aantalveld
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseDe min- en plusknoppen
removeButtondata-gpo-cart-item-remove-buttonDe 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?

Probleem melden