Salta ai contenuti
Installa l’app
Italiano

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.

ChiaveAttributo di aggancioCosa ne fa l'app
formdata-gpo-product-formIl 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
addToCartButtondata-gpo-product-atcIl 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
unitPricedata-gpo-product-unit-priceIl prezzo mostrato. Viene riscritto man mano che il cliente sceglie opzioni con prezzo
compareAtPricedata-gpo-product-compare-at-priceIl prezzo di confronto, aggiornato insieme al prezzo
variantSelectordata-gpo-product-variant-selectorIl campo nascosto che contiene l'ID della variante scelta. Viene letto per sapere quale variante è selezionata
variantActivatordata-gpo-product-variant-activatorI controlli su cui il cliente fa clic per cambiare variante. Vengono monitorati affinché le condizioni sulle varianti possano reagire
variantWrapperdata-gpo-product-variant-wrapperIl blocco che contiene i selettori delle varianti. Serve a posizionare il widget rispetto a essi
imageContainerdata-gpo-product-image-containerL'area dell'immagine principale. È qui che il Personalizzatore disegna l'anteprima dal vivo
imagedata-gpo-product-imageL'immagine principale del prodotto
imagesdata-gpo-product-imagesLe immagini della galleria, per l'impostazione Applica a dell'anteprima
imageButtondata-gpo-product-image-buttonLe miniature o le frecce della galleria, monitorate affinché l'anteprima segua l'immagine visualizzata
sticky.atcButtondata-gpo-sticky-atcIl pulsante Aggiungi al carrello in una barra fissa, affinché esegua la convalida come quello reale
sticky.variantActivatordata-gpo-sticky-variant-activatorIl controllo delle varianti in una barra fissa

collection

Usato per i popup di anteprima rapida nelle pagine delle collezioni.

ChiaveAttributo di aggancioCosa ne fa l'app
wrapperdata-gpo-collection-wrapperLa sezione della collezione, l'area che l'app monitora
itemdata-gpo-collection-itemUna scheda prodotto al suo interno
productLinkdata-gpo-collection-productLinkIl link al prodotto, letto per sapere a quale prodotto corrisponde una scheda
quickViewActivatordata-gpo-collection-qvActivatorIl controllo che apre l'anteprima rapida, monitorato affinché l'app sappia quando eseguire il rendering
quickViewProductFormdata-gpo-collection-qvFormIl 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.

ChiaveAttributo di aggancioCosa ne fa l'app
formdata-gpo-cart-formIl modulo del carrello. Accetta un array, provato in ordine
pagevedi sottoCome leggere un articolo nella pagina del carrello. Accetta un array di strutture, provate in ordine
drawervedi sottoLo stesso per il carrello laterale

page e drawer contengono ciascuno un lineItem che descrive le parti di una riga del carrello:

ParteAttributo di aggancio (pagina del carrello)Che cos'è
keydata-gpo-cart-item-keyLa riga stessa, che contiene la chiave dell'articolo
imagedata-gpo-cart-item-imageLa miniatura della riga
detailsdata-gpo-cart-item-detailsIl blocco con titolo e proprietà, dove viene aggiunto Modifica opzioni
quantity.wrapperdata-gpo-cart-item-qty-wrapperIl controllo della quantità, nascosto nelle righe degli add-on
quantity.inputdata-gpo-cart-item-qtyIl campo della quantità
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseI pulsanti meno e più
removeButtondata-gpo-cart-item-remove-buttonIl 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?

Segnala un problema