コンテンツにスキップ
アプリをインストール
日本語

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訪問者の国(2文字のコード)。国ルールはこの値で照合します
money_formatアプリが価格の表示に使う通貨フォーマット。アドオン価格設定に従います
initialize()アプリを再実行します。アプリを再実行するをご覧ください

このセクションのその他のページ

アプリを再実行する

GPOConfigs.initialize() は、アプリを最初から再実行します。ページの読み込み後に商品フォームが置き換えられる場合に使います。たとえば、ページビルダーがセクションを差し替える場合や、バリエーションの変更時に商品を再レンダリングするテーマなどです。

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

新しいマークアップがDOMに追加される前ではなく、追加された後に呼び出してください。何も変わっていないときに呼び出すと、オプションが不必要に再レンダリングされるため、タイマーではなく、テーマ自体の「セクションが置き換えられた」というシグナルをきっかけに実行してください。

注意事項

  • これらはすべて、公開中のテーマでアプリ埋め込みが有効になっている必要があります。アプリ埋め込みを有効にするをご覧ください。
  • GPOConfigs はアプリ埋め込みが動作するすべてのページに存在しますが、商品ページ以外では product は false です。
  • セレクターを上書きしても、オプションが収集する内容は変わりません。変わるのは、アプリがテーマ内で要素を見つける場所だけです。
  • 同じテーマを使うすべてのストアで同じ上書きが必要な場合は、ストアごとに繰り返さず、私たちにお送りください。サポートに問い合わせるをご覧ください。

このページは役に立ちましたか?

問題を報告