Przejdź do głównej zawartości
Zainstaluj aplikację
Polski

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.

KluczAtrybut zaczepieniaCo robi z nim aplikacja
formdata-gpo-product-formFormularz produktu. To punkt odniesienia dla wszystkiego innego — opcje są w nim renderowane i sprawdzane przy wysyłce. Przyjmuje tablicę, sprawdzaną po kolei
addToCartButtondata-gpo-product-atcPrzycisk 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
unitPricedata-gpo-product-unit-priceWyświetlana cena. Aktualizowana, gdy klient wybiera płatne opcje
compareAtPricedata-gpo-product-compare-at-priceCena przed obniżką, aktualizowana razem z nią
variantSelectordata-gpo-product-variant-selectorUkryte pole z identyfikatorem wybranego wariantu. Odczytywane, aby wiedzieć, który wariant jest wybrany
variantActivatordata-gpo-product-variant-activatorElementy, które klient klika, aby zmienić wariant. Obserwowane, aby warunki dotyczące wariantów mogły reagować
variantWrapperdata-gpo-product-variant-wrapperBlok z selektorami wariantów. Służy do umieszczenia widżetu względem nich
imageContainerdata-gpo-product-image-containerObszar głównego obrazu. Tu Personalizator rysuje podgląd na żywo
imagedata-gpo-product-imageSam główny obraz produktu
imagesdata-gpo-product-imagesObrazy galerii, dla ustawienia podglądu Zastosuj do
imageButtondata-gpo-product-image-buttonMiniatury lub strzałki galerii, obserwowane, aby podgląd podążał za wyświetlanym obrazem
sticky.atcButtondata-gpo-sticky-atcPrzycisk dodawania do koszyka w przyklejonym pasku, aby przeprowadzał walidację jak właściwy przycisk
sticky.variantActivatordata-gpo-sticky-variant-activatorElement wyboru wariantu w przyklejonym pasku

collection

Używane w oknach szybkiego podglądu na stronach kolekcji.

KluczAtrybut zaczepieniaCo robi z nim aplikacja
wrapperdata-gpo-collection-wrapperSekcja kolekcji, czyli obszar obserwowany przez aplikację
itemdata-gpo-collection-itemJedna karta produktu w tej sekcji
productLinkdata-gpo-collection-productLinkLink do produktu, odczytywany, aby wiedzieć, jakiego produktu dotyczy karta
quickViewActivatordata-gpo-collection-qvActivatorElement otwierający szybki podgląd, obserwowany, aby aplikacja wiedziała, kiedy renderować
quickViewProductFormdata-gpo-collection-qvFormFormularz 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.

KluczAtrybut zaczepieniaCo robi z nim aplikacja
formdata-gpo-cart-formFormularz koszyka. Przyjmuje tablicę, sprawdzaną po kolei
pagezobacz niżejJak odczytać pozycję na stronie koszyka. Przyjmuje tablicę struktur, sprawdzanych po kolei
drawerzobacz niżejTo 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
keydata-gpo-cart-item-keySam wiersz z kluczem pozycji
imagedata-gpo-cart-item-imageMiniatura wiersza
detailsdata-gpo-cart-item-detailsBlok z tytułem i właściwościami, do którego dodawany jest przycisk Edytuj opcje
quantity.wrapperdata-gpo-cart-item-qty-wrapperElement ilości, ukrywany w pozycjach dodatków
quantity.inputdata-gpo-cart-item-qtyPole ilości
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increasePrzyciski minus i plus
removeButtondata-gpo-cart-item-remove-buttonLink 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?

Zgłoś problem