Temaväljare
Alla väljare som appen använder för att hitta saker i ditt tema, och de två sätten att ändra en.
Appen hittar ditt produktformulär, pris, variantväljare och varukorgsrader med CSS-väljare. Den levereras med en finjusterad uppsättning för varje tema som stöds och en bred standarduppsättning för resten, och därför fungerar den i de flesta teman utan hjälp.
Ett kraftigt anpassat tema kan ändå placera något där standardväljarna inte når. Det finns två sätt att lösa det, och det första är nästan alltid det bästa.
1. Lägg till appens eget attribut
Nästan varje väljare börjar med ett data-gpo-…-attribut som bara finns som en krok för dig. Lägg attributet på elementet i ditt tema så hittar appen det, utan någon väljare att underhålla och utan något som en temauppdatering kan byta namn på.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Attributet för varje väljare finns i tabellerna nedan.
2. Åsidosätt väljaren
Använd det här när du inte kan redigera koden – en sektion du inte styr över, eller en app som renderar formuläret. Ställ in det innan appens skript körs, i theme.liquid ovanför </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>Dina värden slås ihop ovanpå appens, så du åsidosätter bara de nycklar du anger.
product
Används på produktsidor och i sektioner med utvalda produkter på andra sidor.
| Nyckel | Attributkrok | Vad appen gör med den |
|---|---|---|
form | data-gpo-product-form | Produktformuläret. Det är ankaret för allt annat – alternativen renderas i det och valideras när det skickas. Tar en array, som prövas i ordning |
addToCartButton | data-gpo-product-atc | Knappen Lägg i varukorgen. Används för att placera widgeten ovanför den och för att blockera skickandet när valideringen misslyckas |
paymentButton | — | Knappen för snabbbetalning. Döljs på produkter med alternativ, eftersom den skulle hoppa över formuläret |
quantity | — | Antalsfältet. Läses så att tilläggens antal kan följa huvudproduktens antal |
unitPrice | data-gpo-product-unit-price | Det visade priset. Skrivs om när kunden väljer alternativ med pris |
compareAtPrice | data-gpo-product-compare-at-price | Jämförelsepriset, som uppdateras samtidigt |
variantSelector | data-gpo-product-variant-selector | Det dolda fältet med id:t för den valda varianten. Läses för att veta vilken variant som är vald |
variantActivator | data-gpo-product-variant-activator | Kontrollerna kunden klickar på för att byta variant. Bevakas så att variantvillkor kan reagera |
variantWrapper | data-gpo-product-variant-wrapper | Blocket som innehåller variantväljarna. Används för att placera widgeten i förhållande till dem |
imageContainer | data-gpo-product-image-container | Huvudbildens område. Där Anpassaren ritar sin livepreview |
image | data-gpo-product-image | Själva huvudbilden för produkten |
images | data-gpo-product-images | Galleribilderna, för förhandsvisningens inställning Använd på |
imageButton | data-gpo-product-image-button | Galleriets miniatyrer eller pilar, som bevakas så att förhandsvisningen följer bilden som visas |
sticky.atcButton | data-gpo-sticky-atc | Knappen Lägg i varukorgen i en fast rad, så att den validerar som den riktiga |
sticky.variantActivator | data-gpo-sticky-variant-activator | Variantkontrollen i en fast rad |
collection
Används för snabbvisningspopups på kollektionssidor.
| Nyckel | Attributkrok | Vad appen gör med den |
|---|---|---|
wrapper | data-gpo-collection-wrapper | Kollektionssektionen, området som appen bevakar |
item | data-gpo-collection-item | Ett produktkort i den |
productLink | data-gpo-collection-productLink | Länken till produkten, som läses för att veta vilken produkt ett kort gäller |
quickViewActivator | data-gpo-collection-qvActivator | Kontrollen som öppnar snabbvisningen, som bevakas så att appen vet när den ska rendera |
quickViewProductForm | data-gpo-collection-qvForm | Produktformuläret i snabbvisningen, där alternativen hamnar |
cart
Används på varukorgssidan och i varukorgslådan, för att redigera alternativ och för att hålla tilläggsrader kopplade till sin överordnade artikel.
| Nyckel | Attributkrok | Vad appen gör med den |
|---|---|---|
form | data-gpo-cart-form | Varukorgsformuläret. Tar en array, som prövas i ordning |
page | se nedan | Hur en radartikel läses på varukorgssidan. Tar en array av strukturer, som prövas i ordning |
drawer | se nedan | Samma sak för varukorgslådan |
page och drawer innehåller var sin lineItem som beskriver delarna i en varukorgsrad:
| Del | Attributkrok (varukorgssida) | Vad det är |
|---|---|---|
key | data-gpo-cart-item-key | Själva raden, som bär radartikelns nyckel |
image | data-gpo-cart-item-image | Radens miniatyrbild |
details | data-gpo-cart-item-details | Blocket med titel och egenskaper, där Redigera alternativ läggs till |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Antalskontrollen, som döljs på tilläggsrader |
quantity.input | data-gpo-cart-item-qty | Antalsfältet |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Minus- och plusknapparna |
removeButton | data-gpo-cart-item-remove-button | Länken för att ta bort, som döljs på tilläggsrader |
Lådan använder samma delar med data-gpo-drawer-item-… i stället för data-gpo-cart-item-….
Att tänka på
- Nycklar som tar en array prövas i ordning och den första träffen vinner, så du kan lägga till dina egna före standardvärdena i stället för att ersätta dem.
- Att åsidosätta en väljare ändrar bara var appen letar. Det ändrar inte vad alternativen samlar in eller hur de prissätts.
- En åsidosättning gäller för varje produktsida i butiken. För en enskild produkt riktar du dig mot den i själva väljaren.
Was this helpful?
Thanks for your feedback! Tell us what was missing
Report an issue