Selektory motywu
Każdy selektor, którym aplikacja znajduje elementy w motywie, i dwa sposoby na jego zmianę.
Aplikacja znajduje formularz produktu, cenę, selektor wariantu i pozycje koszyka za pomocą selektorów CSS. Ma dopracowany zestaw dla każdego obsługiwanego motywu i szeroki zestaw domyślny dla pozostałych — dlatego działa w większości motywów bez żadnej pomocy.
Mocno zmodyfikowany motyw może jednak umieścić coś tam, gdzie domyślne selektory nie sięgają. Można to naprawić na dwa sposoby, a pierwszy jest niemal zawsze lepszy.
1. Dodaj własny atrybut aplikacji
Niemal każdy selektor zaczyna się od atrybutu data-gpo-…, który istnieje wyłącznie jako punkt zaczepienia dla Ciebie. Dodaj ten atrybut do elementu w motywie, a aplikacja go znajdzie — bez selektora do utrzymywania i bez niczego, co aktualizacja motywu mogłaby przemianować.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Atrybut dla każdego selektora znajdziesz w tabelach poniżej.
2. Nadpisz selektor
Użyj tego, gdy nie możesz edytować kodu HTML — sekcji, nad którą nie masz kontroli, albo aplikacji renderującej formularz. Ustaw go przed uruchomieniem skryptu aplikacji, w 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>Twoje wartości są nakładane na wartości aplikacji, więc nadpisujesz tylko klucze, które podasz.
product
Używane na stronach produktów oraz w sekcjach z wyróżnionym produktem w innych miejscach.
| Klucz | Atrybut zaczepienia | Co robi z nim aplikacja |
|---|---|---|
form | data-gpo-product-form | Formularz produktu. To punkt odniesienia dla wszystkiego innego — opcje są w nim renderowane i sprawdzane przy wysyłce. Przyjmuje tablicę, sprawdzaną po kolei |
addToCartButton | data-gpo-product-atc | Przycisk dodawania do koszyka. Służy do umieszczenia widżetu nad nim i do zablokowania wysyłki, gdy walidacja się nie powiedzie |
paymentButton | — | Przycisk przyspieszonej płatności. Ukrywany w produktach z opcjami, bo pomijałby formularz |
quantity | — | Pole ilości. Odczytywane, aby ilość dodatków mogła podążać za ilością produktu głównego |
unitPrice | data-gpo-product-unit-price | Wyświetlana cena. Aktualizowana, gdy klient wybiera płatne opcje |
compareAtPrice | data-gpo-product-compare-at-price | Cena przed obniżką, aktualizowana razem z nią |
variantSelector | data-gpo-product-variant-selector | Ukryte pole z identyfikatorem wybranego wariantu. Odczytywane, aby wiedzieć, który wariant jest wybrany |
variantActivator | data-gpo-product-variant-activator | Elementy, które klient klika, aby zmienić wariant. Obserwowane, aby warunki dotyczące wariantów mogły reagować |
variantWrapper | data-gpo-product-variant-wrapper | Blok z selektorami wariantów. Służy do umieszczenia widżetu względem nich |
imageContainer | data-gpo-product-image-container | Obszar głównego obrazu. Tu Personalizator rysuje podgląd na żywo |
image | data-gpo-product-image | Sam główny obraz produktu |
images | data-gpo-product-images | Obrazy galerii, dla ustawienia podglądu Zastosuj do |
imageButton | data-gpo-product-image-button | Miniatury lub strzałki galerii, obserwowane, aby podgląd podążał za wyświetlanym obrazem |
sticky.atcButton | data-gpo-sticky-atc | Przycisk dodawania do koszyka w przyklejonym pasku, aby przeprowadzał walidację jak właściwy przycisk |
sticky.variantActivator | data-gpo-sticky-variant-activator | Element wyboru wariantu w przyklejonym pasku |
collection
Używane w oknach szybkiego podglądu na stronach kolekcji.
| Klucz | Atrybut zaczepienia | Co robi z nim aplikacja |
|---|---|---|
wrapper | data-gpo-collection-wrapper | Sekcja kolekcji, czyli obszar obserwowany przez aplikację |
item | data-gpo-collection-item | Jedna karta produktu w tej sekcji |
productLink | data-gpo-collection-productLink | Link do produktu, odczytywany, aby wiedzieć, jakiego produktu dotyczy karta |
quickViewActivator | data-gpo-collection-qvActivator | Element otwierający szybki podgląd, obserwowany, aby aplikacja wiedziała, kiedy renderować |
quickViewProductForm | data-gpo-collection-qvForm | Formularz produktu w szybkim podglądzie, w którym umieszczane są opcje |
cart
Używane na stronie koszyka i w wysuwanym koszyku — do edycji opcji i do utrzymania powiązania pozycji dodatków z produktem nadrzędnym.
| Klucz | Atrybut zaczepienia | Co robi z nim aplikacja |
|---|---|---|
form | data-gpo-cart-form | Formularz koszyka. Przyjmuje tablicę, sprawdzaną po kolei |
page | zobacz niżej | Jak odczytać pozycję na stronie koszyka. Przyjmuje tablicę struktur, sprawdzanych po kolei |
drawer | zobacz niżej | To samo dla wysuwanego koszyka |
page i drawer zawierają lineItem, który opisuje części jednego wiersza koszyka:
| Część | Atrybut zaczepienia (strona koszyka) | Co to jest |
|---|---|---|
key | data-gpo-cart-item-key | Sam wiersz z kluczem pozycji |
image | data-gpo-cart-item-image | Miniatura wiersza |
details | data-gpo-cart-item-details | Blok z tytułem i właściwościami, do którego dodawany jest przycisk Edytuj opcje |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Element ilości, ukrywany w pozycjach dodatków |
quantity.input | data-gpo-cart-item-qty | Pole ilości |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Przyciski minus i plus |
removeButton | data-gpo-cart-item-remove-button | Link usuwania, ukrywany w pozycjach dodatków |
Wysuwany koszyk używa tych samych części z data-gpo-drawer-item-… zamiast data-gpo-cart-item-….
Uwagi
- Klucze przyjmujące tablicę są sprawdzane po kolei i wygrywa pierwsze dopasowanie, więc możesz dodać swoje przed domyślnymi, zamiast je zastępować.
- Nadpisanie selektora zmienia tylko to, gdzie aplikacja szuka. Nie zmienia tego, co zbierają opcje ani jak są wyceniane.
- Nadpisanie dotyczy każdej strony produktu w sklepie. Aby objąć jeden produkt, wskaż go w samym selektorze.
Czy to było pomocne?
Dziękujemy za opinię! Powiedz nam, czego zabrakło
Zgłoś problem