Temaselektorer
Alle de selektorer, appen bruger til at finde elementer i dit tema, og de to måder at ændre en på.
Appen finder din produktformular, pris, variantvælger og kurvlinjer via CSS-selektorer. Den leveres med et finjusteret sæt til hvert understøttet tema og et bredt standardsæt til resten, og derfor virker den i de fleste temaer uden hjælp.
Et kraftigt tilpasset tema kan stadig placere noget, hvor standardselektorerne ikke når hen. Der er to måder at løse det på, og den første er næsten altid den bedste.
1. Tilføj appens egen attribut
Næsten alle selektorer begynder med en data-gpo-…-attribut, der udelukkende findes som et ankerpunkt til dig. Sæt attributten på elementet i dit tema, så finder appen det – uden en selektor, du skal vedligeholde, og uden noget, en temaopdatering kan omdøbe.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Attributten til hver selektor står i tabellerne nedenfor.
2. Tilsidesæt selektoren
Brug dette, når du ikke kan redigere markuppen – en sektion, du ikke har kontrol over, eller en app, der gengiver formularen. Angiv det, før appens script kører, i theme.liquid over </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>Dine værdier flettes oven på appens, så du tilsidesætter kun de nøgler, du angiver.
product
Bruges på produktsider og i sektioner med udvalgte produkter andre steder.
| Nøgle | Attribut-ankerpunkt | Hvad appen bruger den til |
|---|---|---|
form | data-gpo-product-form | Produktformularen. Den er ankeret for alt andet – optionerne gengives i den og valideres ved indsendelse. Tager et array, som afprøves i rækkefølge |
addToCartButton | data-gpo-product-atc | Knappen Læg i kurv. Bruges til at placere widgetten over den og til at blokere indsendelsen, når valideringen fejler |
paymentButton | — | Knappen til accelereret betaling. Skjules på produkter med optioner, fordi den ville springe formularen over |
quantity | — | Antalsfeltet. Læses, så antallet af tilføjelser kan følge hovedproduktets antal |
unitPrice | data-gpo-product-unit-price | Den viste pris. Omskrives, efterhånden som kunden vælger optioner med pris |
compareAtPrice | data-gpo-product-compare-at-price | Sammenligningsprisen, som opdateres sammen med den |
variantSelector | data-gpo-product-variant-selector | Det skjulte inputfelt, der indeholder id’et på den valgte variant. Læses for at vide, hvilken variant der er valgt |
variantActivator | data-gpo-product-variant-activator | De kontroller, kunden klikker på for at skifte variant. Overvåges, så variantbetingelser kan reagere |
variantWrapper | data-gpo-product-variant-wrapper | Blokken, der indeholder variantvælgerne. Bruges til at placere widgetten i forhold til dem |
imageContainer | data-gpo-product-image-container | Hovedbilledområdet. Det er her, Personaliseringen tegner sin liveforhåndsvisning |
image | data-gpo-product-image | Selve hovedproduktbilledet |
images | data-gpo-product-images | Galleribillederne, til forhåndsvisningens indstilling Anvend på |
imageButton | data-gpo-product-image-button | Galleriets miniaturer eller pile, som overvåges, så forhåndsvisningen følger det viste billede |
sticky.atcButton | data-gpo-sticky-atc | Knappen Læg i kurv i en fastgjort bjælke, så den validerer ligesom den rigtige |
sticky.variantActivator | data-gpo-sticky-variant-activator | Variantkontrollen i en fastgjort bjælke |
collection
Bruges til hurtigvisnings-pop op-vinduer på kollektionssider.
| Nøgle | Attribut-ankerpunkt | Hvad appen bruger den til |
|---|---|---|
wrapper | data-gpo-collection-wrapper | Kollektionssektionen, det område appen overvåger |
item | data-gpo-collection-item | Et enkelt produktkort i den |
productLink | data-gpo-collection-productLink | Linket til produktet, som læses for at vide, hvilket produkt et kort viser |
quickViewActivator | data-gpo-collection-qvActivator | Kontrollen, der åbner hurtigvisningen, og som overvåges, så appen ved, hvornår den skal gengive |
quickViewProductForm | data-gpo-collection-qvForm | Produktformularen i hurtigvisningen, hvor optionerne placeres |
cart
Bruges på kurvsiden og i kurvskuffen til at redigere optioner og til at holde tilføjelseslinjer knyttet til deres overordnede vare.
| Nøgle | Attribut-ankerpunkt | Hvad appen bruger den til |
|---|---|---|
form | data-gpo-cart-form | Kurvformularen. Tager et array, som afprøves i rækkefølge |
page | se nedenfor | Hvordan en varelinje på kurvsiden læses. Tager et array af strukturer, som afprøves i rækkefølge |
drawer | se nedenfor | Det samme for kurvskuffen |
page og drawer indeholder hver en lineItem, der beskriver delene af én kurvrække:
| Del | Attribut-ankerpunkt (kurvside) | Hvad det er |
|---|---|---|
key | data-gpo-cart-item-key | Selve rækken, som bærer varelinjens nøgle |
image | data-gpo-cart-item-image | Rækkens miniature |
details | data-gpo-cart-item-details | Blokken med titel og egenskaber, hvor Rediger optioner tilføjes |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Antalskontrollen, som skjules på tilføjelseslinjer |
quantity.input | data-gpo-cart-item-qty | Antalsfeltet |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Minus- og plusknapperne |
removeButton | data-gpo-cart-item-remove-button | Fjern-linket, som skjules på tilføjelseslinjer |
Skuffen bruger de samme dele med data-gpo-drawer-item-… i stedet for data-gpo-cart-item-….
Bemærkninger
- Nøgler, der tager et array, afprøves i rækkefølge, og det første match vinder, så du kan tilføje dine egne foran standardværdierne i stedet for at erstatte dem.
- Tilsidesættelse af en selektor ændrer kun, hvor appen kigger. Det ændrer ikke, hvad optionerne indsamler, eller hvordan de prissættes.
- En tilsidesættelse gælder for alle produktsider i butikken. Hvis det kun skal gælde ét produkt, så målret det i selve selektoren.
Var dette nyttigt?
Tak for din feedback! Fortæl os, hvad der manglede
Rapportér et problem