Selektory motivu
Všechny selektory, pomocí kterých aplikace hledá prvky ve vašem motivu, a dva způsoby, jak je změnit.
Aplikace hledá formulář produktu, cenu, výběr variant a řádky košíku pomocí selektorů CSS. Pro každý podporovaný motiv obsahuje vyladěnou sadu a pro ostatní širokou výchozí sadu, a proto na většině motivů funguje bez jakékoli pomoci.
Silně upravený motiv přesto může umístit něco tam, kam výchozí selektory nedosáhnou. Existují dva způsoby, jak to napravit, a první je téměř vždy lepší.
1. Přidejte vlastní atribut aplikace
Téměř každý selektor začíná atributem data-gpo-…, který existuje čistě jako háček pro vás. Přidejte tento atribut k prvku ve vašem motivu a aplikace ho najde — bez selektoru, který byste museli udržovat, a bez čehokoli, co by aktualizace motivu mohla přejmenovat.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Atribut pro každý selektor najdete v tabulkách níže.
2. Přepište selektor
Tento způsob použijte, když nemůžete upravit kód — sekci, kterou nemáte pod kontrolou, nebo aplikaci, která formulář vykresluje. Nastavte ho ještě před spuštěním skriptu aplikace, v theme.liquid nad </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>Vaše hodnoty se sloučí s hodnotami aplikace, takže přepíšete jen klíče, které uvedete.
product
Používá se na stránkách produktů a v sekcích s doporučeným produktem jinde.
| Klíč | Atribut | Co s ním aplikace dělá |
|---|---|---|
form | data-gpo-product-form | Formulář produktu. Je výchozím bodem pro vše ostatní — možnosti se do něj vykreslují a při odeslání se ověřují. Přijímá pole, zkoušené postupně |
addToCartButton | data-gpo-product-atc | Tlačítko pro přidání do košíku. Slouží k umístění widgetu nad něj a k zablokování odeslání, když ověření selže |
paymentButton | — | Tlačítko zrychlené platby. U produktů s možnostmi je skryté, protože by formulář přeskočilo |
quantity | — | Pole množství. Čte se, aby se množství doplňků mohlo řídit množstvím hlavního produktu |
unitPrice | data-gpo-product-unit-price | Zobrazená cena. Přepisuje se, jak zákazník vybírá zpoplatněné možnosti |
compareAtPrice | data-gpo-product-compare-at-price | Srovnávací cena, aktualizovaná spolu s ní |
variantSelector | data-gpo-product-variant-selector | Skryté pole s ID vybrané varianty. Čte se, aby aplikace věděla, která varianta je vybraná |
variantActivator | data-gpo-product-variant-activator | Ovládací prvky, na které zákazník kliká při změně varianty. Sledují se, aby mohly reagovat podmínky na varianty |
variantWrapper | data-gpo-product-variant-wrapper | Blok obsahující výběr variant. Slouží k umístění widgetu vůči nim |
imageContainer | data-gpo-product-image-container | Oblast hlavního obrázku. Zde Personalizátor vykresluje živý náhled |
image | data-gpo-product-image | Samotný hlavní obrázek produktu |
images | data-gpo-product-images | Obrázky galerie pro nastavení náhledu Použít na |
imageButton | data-gpo-product-image-button | Miniatury nebo šipky galerie; sledují se, aby náhled sledoval zobrazený obrázek |
sticky.atcButton | data-gpo-sticky-atc | Tlačítko pro přidání do košíku v přichyceném panelu, aby ověřovalo stejně jako to skutečné |
sticky.variantActivator | data-gpo-sticky-variant-activator | Ovládací prvek varianty v přichyceném panelu |
collection
Používá se pro vyskakovací okna rychlého náhledu na stránkách kolekcí.
| Klíč | Atribut | Co s ním aplikace dělá |
|---|---|---|
wrapper | data-gpo-collection-wrapper | Sekce kolekce, oblast, kterou aplikace sleduje |
item | data-gpo-collection-item | Jedna karta produktu v ní |
productLink | data-gpo-collection-productLink | Odkaz na produkt; čte se, aby aplikace věděla, o jaký produkt na kartě jde |
quickViewActivator | data-gpo-collection-qvActivator | Ovládací prvek, který otevírá rychlý náhled; sleduje se, aby aplikace věděla, kdy vykreslovat |
quickViewProductForm | data-gpo-collection-qvForm | Formulář produktu uvnitř rychlého náhledu, kam se vkládají možnosti |
cart
Používá se na stránce košíku a ve vysouvacím košíku pro úpravy možností a pro udržení vazby řádků doplňků na jejich nadřazenou položku.
| Klíč | Atribut | Co s ním aplikace dělá |
|---|---|---|
form | data-gpo-cart-form | Formulář košíku. Přijímá pole, zkoušené postupně |
page | viz níže | Jak číst položku na stránce košíku. Přijímá pole struktur, zkoušených postupně |
drawer | viz níže | Totéž pro vysouvací košík |
page i drawer obsahují lineItem, který popisuje části jednoho řádku košíku:
| Část | Atribut (stránka košíku) | Co to je |
|---|---|---|
key | data-gpo-cart-item-key | Samotný řádek nesoucí klíč položky |
image | data-gpo-cart-item-image | Miniatura řádku |
details | data-gpo-cart-item-details | Blok s názvem a vlastnostmi, kam se přidává Upravit možnosti |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Ovládací prvek množství, skrytý u řádků doplňků |
quantity.input | data-gpo-cart-item-qty | Pole množství |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Tlačítka minus a plus |
removeButton | data-gpo-cart-item-remove-button | Odkaz pro odebrání, skrytý u řádků doplňků |
Vysouvací košík používá stejné části s data-gpo-drawer-item-… místo data-gpo-cart-item-….
Poznámky
- Klíče, které přijímají pole, se zkoušejí postupně a vyhrává první shoda, takže své selektory můžete přidat před výchozí, místo abyste je nahrazovali.
- Přepsání selektoru mění jen to, kde aplikace hledá. Nemění, co možnosti shromažďují ani jak se oceňují.
- Přepsání platí pro každou stránku produktu v obchodě. Pro jeden produkt ho zacilte přímo v selektoru.
Pomohla vám tato stránka?
Děkujeme za zpětnou vazbu! Napište nám, co chybělo
Nahlásit problém