Selettori del tema
Tutti i selettori che l'app usa per trovare gli elementi nel tuo tema e i due modi per modificarne uno.
L’app trova il modulo del prodotto, il prezzo, il selettore delle varianti e le righe del carrello tramite selettori CSS. Include un set ottimizzato per ogni tema supportato e un ampio set predefinito per tutti gli altri, ed è per questo che funziona sulla maggior parte dei temi senza alcun intervento.
Un tema molto personalizzato può comunque collocare un elemento dove i selettori predefiniti non arrivano. Ci sono due modi per risolvere il problema, e il primo è quasi sempre il migliore.
1. Aggiungi l’attributo dell’app
Quasi tutti i selettori iniziano con un attributo data-gpo-… che esiste solo come aggancio per te. Aggiungi quell’attributo all’elemento nel tuo tema e l’app lo trova, senza selettori da mantenere e senza nulla che un aggiornamento del tema possa rinominare.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>L’attributo per ciascun selettore è indicato nelle tabelle seguenti.
2. Sovrascrivi il selettore
Usa questo metodo quando non puoi modificare il markup: una sezione che non controlli o un’app che esegue il rendering del modulo. Impostalo prima che venga eseguito lo script dell’app, in theme.liquid sopra </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>I tuoi valori vengono uniti a quelli dell’app, quindi sovrascrivi solo le chiavi che indichi.
product
Usato nelle pagine dei prodotti e nelle sezioni con prodotto in evidenza in altre pagine.
| Chiave | Attributo di aggancio | Cosa ne fa l'app |
|---|---|---|
form | data-gpo-product-form | Il modulo del prodotto. È il punto di riferimento per tutto il resto: le opzioni vengono renderizzate al suo interno e convalidate all'invio. Accetta un array, provato in ordine |
addToCartButton | data-gpo-product-atc | Il pulsante Aggiungi al carrello. Serve a posizionare il widget sopra di esso e a bloccare l'invio quando la convalida non va a buon fine |
paymentButton | — | Il pulsante di pagamento accelerato. Viene nascosto sui prodotti con opzioni, perché salterebbe il modulo |
quantity | — | Il campo della quantità. Viene letto affinché le quantità degli add-on possano seguire la quantità del prodotto principale |
unitPrice | data-gpo-product-unit-price | Il prezzo mostrato. Viene riscritto man mano che il cliente sceglie opzioni con prezzo |
compareAtPrice | data-gpo-product-compare-at-price | Il prezzo di confronto, aggiornato insieme al prezzo |
variantSelector | data-gpo-product-variant-selector | Il campo nascosto che contiene l'ID della variante scelta. Viene letto per sapere quale variante è selezionata |
variantActivator | data-gpo-product-variant-activator | I controlli su cui il cliente fa clic per cambiare variante. Vengono monitorati affinché le condizioni sulle varianti possano reagire |
variantWrapper | data-gpo-product-variant-wrapper | Il blocco che contiene i selettori delle varianti. Serve a posizionare il widget rispetto a essi |
imageContainer | data-gpo-product-image-container | L'area dell'immagine principale. È qui che il Personalizzatore disegna l'anteprima dal vivo |
image | data-gpo-product-image | L'immagine principale del prodotto |
images | data-gpo-product-images | Le immagini della galleria, per l'impostazione Applica a dell'anteprima |
imageButton | data-gpo-product-image-button | Le miniature o le frecce della galleria, monitorate affinché l'anteprima segua l'immagine visualizzata |
sticky.atcButton | data-gpo-sticky-atc | Il pulsante Aggiungi al carrello in una barra fissa, affinché esegua la convalida come quello reale |
sticky.variantActivator | data-gpo-sticky-variant-activator | Il controllo delle varianti in una barra fissa |
collection
Usato per i popup di anteprima rapida nelle pagine delle collezioni.
| Chiave | Attributo di aggancio | Cosa ne fa l'app |
|---|---|---|
wrapper | data-gpo-collection-wrapper | La sezione della collezione, l'area che l'app monitora |
item | data-gpo-collection-item | Una scheda prodotto al suo interno |
productLink | data-gpo-collection-productLink | Il link al prodotto, letto per sapere a quale prodotto corrisponde una scheda |
quickViewActivator | data-gpo-collection-qvActivator | Il controllo che apre l'anteprima rapida, monitorato affinché l'app sappia quando eseguire il rendering |
quickViewProductForm | data-gpo-collection-qvForm | Il modulo del prodotto all'interno dell'anteprima rapida, dove vengono inserite le opzioni |
cart
Usato nella pagina del carrello e nel carrello laterale, per modificare le opzioni e per mantenere le righe degli add-on legate al loro articolo principale.
| Chiave | Attributo di aggancio | Cosa ne fa l'app |
|---|---|---|
form | data-gpo-cart-form | Il modulo del carrello. Accetta un array, provato in ordine |
page | vedi sotto | Come leggere un articolo nella pagina del carrello. Accetta un array di strutture, provate in ordine |
drawer | vedi sotto | Lo stesso per il carrello laterale |
page e drawer contengono ciascuno un lineItem che descrive le parti di una riga del carrello:
| Parte | Attributo di aggancio (pagina del carrello) | Che cos'è |
|---|---|---|
key | data-gpo-cart-item-key | La riga stessa, che contiene la chiave dell'articolo |
image | data-gpo-cart-item-image | La miniatura della riga |
details | data-gpo-cart-item-details | Il blocco con titolo e proprietà, dove viene aggiunto Modifica opzioni |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Il controllo della quantità, nascosto nelle righe degli add-on |
quantity.input | data-gpo-cart-item-qty | Il campo della quantità |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | I pulsanti meno e più |
removeButton | data-gpo-cart-item-remove-button | Il link di rimozione, nascosto nelle righe degli add-on |
Il carrello laterale usa le stesse parti con data-gpo-drawer-item-… invece di data-gpo-cart-item-….
Note
- Le chiavi che accettano un array vengono provate in ordine e vince la prima corrispondenza, quindi puoi aggiungere le tue davanti a quelle predefinite invece di sostituirle.
- Sovrascrivere un selettore modifica solo dove l’app cerca. Non modifica ciò che le opzioni raccolgono né come vengono calcolati i prezzi.
- Una sovrascrittura si applica a ogni pagina del prodotto del negozio. Per un singolo prodotto, indicalo nel selettore stesso.
Questa pagina ti è stata utile?
Grazie per il feedback! Dicci cosa mancava
Segnala un problema