콘텐츠로 이동
앱 설치
한국어

JavaScript API

스토어 객체, 재정의할 수 있는 테마 선택자, 앱이 발생시키는 이벤트입니다.

이 페이지는 테마를 작업하는 개발자를 위한 것입니다. 앱을 일반적으로 사용할 때는 여기의 내용이 필요하지 않습니다. 테마가 독특하게 동작해서 앱 자체 설정으로는 처리할 수 없는 경우를 위해 존재합니다.

아래의 모든 내용은 스토어에서 실행되며 앱 임베드가 활성화되어 있어야 합니다. 앱 임베드가 없으면 이 객체와 이벤트는 존재하지 않습니다.

window.GPOConfigs

앱의 스토어 객체입니다. 앱 자체 스크립트가 실행되기 전에 앱 임베드가 생성하며, 그래서 아래의 재정의가 가능합니다.

속성담고 있는 내용
theme앱이 테마에서 요소를 찾는 데 사용하는 선택자입니다. 테마 선택자를 참조하세요
page.typeShopify 페이지 유형입니다. product, cart, index, collection 등이 있습니다
product현재 제품을 Shopify 제품 JSON 형식으로 담고, 제품이 속한 컬렉션 ID가 담긴 product.collections를 추가로 포함합니다. 제품 페이지가 아니면 false입니다
cart현재 카트를 Shopify 카트 JSON 형식으로 담습니다
customer로그인한 고객의 id, name, email, tags이며, 그렇지 않으면 false입니다. 고객 규칙은 이 태그와 일치하는지 확인합니다
curCountryCode방문자의 국가를 두 글자 코드로 나타냅니다. 국가 규칙은 이 값과 일치하는지 확인합니다
money_format앱이 가격 형식을 지정할 때 사용하는 통화 형식으로, 추가 옵션 가격 설정을 따릅니다
initialize()앱을 다시 실행합니다. 앱 다시 실행을 참조하세요

이 섹션의 나머지 내용

앱 다시 실행

GPOConfigs.initialize()는 앱을 처음부터 다시 실행합니다. 페이지가 로드된 후 무언가가 제품 양식을 교체할 때 사용하세요. 예를 들어 페이지 빌더가 섹션을 바꾸거나, 테마가 이형 상품 변경 시 제품을 다시 렌더링하는 경우입니다.

window.GPOConfigs && window.GPOConfigs.initialize();

새 마크업이 DOM에 들어간 후에 호출하세요. 그 전에 호출하면 안 됩니다. 아무것도 바뀌지 않았는데 호출하면 옵션을 불필요하게 다시 렌더링하므로, 타이머 대신 테마 자체의 “섹션 교체” 신호에서 호출하세요.

참고

  • 이 모든 내용은 게시된 테마에서 앱 임베드가 활성화되어 있어야 합니다. 앱 임베드 활성화를 참조하세요.
  • GPOConfigs는 앱 임베드가 실행되는 모든 페이지에 존재하지만, 제품 페이지가 아닌 곳에서는 product가 false입니다.
  • 선택자를 재정의해도 옵션이 수집하는 내용은 바뀌지 않으며, 앱이 테마에서 요소를 찾는 위치만 바뀝니다.
  • 테마를 사용하는 모든 스토어에 같은 재정의가 필요하다면, 스토어마다 반복하지 말고 저희에게 보내 주세요. 지원팀에 문의를 참조하세요.

도움이 되었나요?

문제 신고