アプリは、商品フォーム、価格、バリエーションの選択欄、カートの行をCSSセレクターで見つけます。対応テーマごとに調整されたセレクターと、それ以外のテーマ向けの汎用的なデフォルトのセレクターが用意されているため、ほとんどのテーマでは何もしなくても動作します。
ただし、大幅にカスタマイズされたテーマでは、デフォルトのセレクターでは見つからない場所に要素が置かれていることがあります。これを解決する方法は2つあり、ほとんどの場合は1つ目の方法が適しています。
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 | その中の1つの商品カード |
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 にはそれぞれ、カートの1行を構成する要素を記述する 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-… を使い、同じ要素で構成されます。
注意事項
- 配列を指定できるキーは順番に試され、最初に一致したものが使われます。そのため、デフォルトを置き換えるのではなく、その前に独自のセレクターを追加できます。
- セレクターを上書きしても、変わるのはアプリが要素を探す場所だけです。オプションが収集する内容や価格の計算方法は変わりません。
- 上書きはストアのすべての商品ページに適用されます。特定の商品だけを対象にする場合は、セレクター自体でその商品を指定してください。
このページは役に立ちましたか?
フィードバックありがとうございます。 足りなかった情報を教える
問題を報告