앱은 CSS 선택자로 제품 양식, 가격, 이형 상품 선택기, 카트 품목을 찾습니다. 지원되는 테마마다 맞춤 조정된 선택자 세트를, 나머지 테마에는 폭넓은 기본 세트를 제공합니다. 그래서 대부분의 테마에서 별도 도움 없이 작동합니다.
그래도 많이 수정된 테마는 기본값이 닿지 않는 곳에 요소를 둘 수 있습니다. 이를 해결하는 방법은 두 가지이며, 거의 항상 첫 번째 방법이 더 좋습니다.
1. 앱 자체 속성 추가
거의 모든 선택자는 data-gpo-… 속성으로 시작합니다. 이 속성은 오직 연결 지점으로 쓰기 위해 존재합니다. 테마의 요소에 이 속성을 넣으면 앱이 그 요소를 찾습니다. 유지 관리할 선택자가 없고, 테마 업데이트로 이름이 바뀔 일도 없습니다.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>각 선택자에 해당하는 속성은 아래 표에 있습니다.
2. 선택자 재정의
직접 제어할 수 없는 섹션이나 앱이 렌더링하는 양식처럼 마크업을 편집할 수 없을 때 사용하세요. 앱 스크립트가 실행되기 전에 theme.liquid의 </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>입력한 값은 앱의 값 위에 병합되므로, 지정한 키만 재정의됩니다.
product
제품 페이지와 다른 페이지의 추천 제품 섹션에서 사용됩니다.
| 키 | 속성 연결 지점 | 앱이 하는 일 |
|---|---|---|
form | data-gpo-product-form | 제품 양식입니다. 다른 모든 요소의 기준점으로, 옵션이 이 안에 렌더링되고 제출 시 검증됩니다. 배열을 받으며 순서대로 시도합니다 |
addToCartButton | data-gpo-product-atc | 카트에 추가 버튼입니다. 위젯을 그 위에 배치하고, 검증에 실패하면 제출을 차단하는 데 사용됩니다 |
paymentButton | — | 빠른 결제 버튼입니다. 양식을 건너뛰게 되므로 옵션이 있는 제품에서는 숨겨집니다 |
quantity | — | 수량 입력란입니다. 추가 옵션 수량이 기본 제품 수량을 따를 수 있도록 읽습니다 |
unitPrice | data-gpo-product-unit-price | 표시 가격입니다. 고객이 가격이 있는 옵션을 고르면 다시 쓰입니다 |
compareAtPrice | data-gpo-product-compare-at-price | 비교 가격으로, 표시 가격과 함께 업데이트됩니다 |
variantSelector | data-gpo-product-variant-selector | 선택된 이형 상품 ID를 담은 숨김 입력란입니다. 어떤 이형 상품이 선택되었는지 알기 위해 읽습니다 |
variantActivator | data-gpo-product-variant-activator | 고객이 이형 상품을 바꾸려고 클릭하는 컨트롤입니다. 이형 상품 조건이 반응할 수 있도록 감시합니다 |
variantWrapper | data-gpo-product-variant-wrapper | 이형 상품 선택기를 담은 블록입니다. 위젯을 이 블록 기준으로 배치하는 데 사용됩니다 |
imageContainer | data-gpo-product-image-container | 기본 이미지 영역입니다. 개인화 도구가 실시간 미리 보기를 그리는 곳입니다 |
image | data-gpo-product-image | 기본 제품 이미지 자체입니다 |
images | data-gpo-product-images | 갤러리 이미지로, 미리 보기의 적용 대상 설정에 사용됩니다 |
imageButton | data-gpo-product-image-button | 갤러리 썸네일 또는 화살표입니다. 미리 보기가 표시 중인 이미지를 따라가도록 감시합니다 |
sticky.atcButton | data-gpo-sticky-atc | 고정 바의 카트에 추가 버튼으로, 실제 버튼처럼 검증하도록 합니다 |
sticky.variantActivator | data-gpo-sticky-variant-activator | 고정 바의 이형 상품 컨트롤입니다 |
collection
컬렉션 페이지의 빠른 보기 팝업에서 사용됩니다.
| 키 | 속성 연결 지점 | 앱이 하는 일 |
|---|---|---|
wrapper | data-gpo-collection-wrapper | 컬렉션 섹션으로, 앱이 감시하는 영역입니다 |
item | data-gpo-collection-item | 그 안의 제품 카드 하나입니다 |
productLink | data-gpo-collection-productLink | 제품 링크입니다. 카드가 어떤 제품인지 알기 위해 읽습니다 |
quickViewActivator | data-gpo-collection-qvActivator | 빠른 보기를 여는 컨트롤입니다. 앱이 렌더링 시점을 알 수 있도록 감시합니다 |
quickViewProductForm | data-gpo-collection-qvForm | 빠른 보기 안의 제품 양식으로, 옵션이 들어가는 곳입니다 |
cart
카트 페이지와 카트 서랍에서 옵션을 편집하고 추가 옵션 품목을 상위 상품과 연결된 상태로 유지하는 데 사용됩니다.
| 키 | 속성 연결 지점 | 앱이 하는 일 |
|---|---|---|
form | data-gpo-cart-form | 카트 양식입니다. 배열을 받으며 순서대로 시도합니다 |
page | 아래 참조 | 카트 페이지에서 품목을 읽는 방법입니다. 구조의 배열을 받으며 순서대로 시도합니다 |
drawer | 아래 참조 | 카트 서랍에서 같은 역할을 합니다 |
page와 drawer에는 각각 카트 행 하나의 구성 요소를 설명하는 lineItem이 있습니다.
| 구성 요소 | 속성 연결 지점 (카트 페이지) | 설명 |
|---|---|---|
key | data-gpo-cart-item-key | 품목 키를 담은 행 자체입니다 |
image | data-gpo-cart-item-image | 행의 썸네일입니다 |
details | data-gpo-cart-item-details | 제목과 속성 블록으로, 옵션 편집이 추가되는 곳입니다 |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | 수량 컨트롤로, 추가 옵션 품목에서는 숨겨집니다 |
quantity.input | data-gpo-cart-item-qty | 수량 필드입니다 |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | 빼기 및 더하기 버튼입니다 |
removeButton | data-gpo-cart-item-remove-button | 제거 링크로, 추가 옵션 품목에서는 숨겨집니다 |
카트 서랍은 data-gpo-cart-item-… 대신 data-gpo-drawer-item-…으로 같은 구성 요소를 사용합니다.
참고
- 배열을 받는 키는 순서대로 시도하고 처음 일치하는 항목이 사용됩니다. 따라서 기본값을 대체하지 않고 그 앞에 직접 추가할 수 있습니다.
- 선택자를 재정의하면 앱이 찾는 위치만 바뀝니다. 옵션이 수집하는 내용이나 가격 책정 방식은 바뀌지 않습니다.
- 재정의는 스토어의 모든 제품 페이지에 적용됩니다. 특정 제품 하나에만 적용하려면 선택자 자체에서 그 제품을 지정하세요.
도움이 되었나요?
의견을 보내 주셔서 감사합니다! 부족한 내용을 알려 주세요
문제 신고