Shopifyを安全に接続

このガイドはFy2Press 1.0.0について説明しています。今後のバージョンでは画面が変わることがあるため、手順に進む前に「プラグイン」画面に表示されているバージョンを確認してください。

期待される結果

Shopifyストアが、ストアのアドレスと公開Storefront APIトークンで接続されています。接続テストは成功し、Fy2Pressでストアが「未接続」と表示されなくなっています。

ShopifyのHeadlessチャネルで公開Storefront APIトークンを作成し、ストアのアドレスと一緒に入力して接続をテストします。

開始前の準備

• そのストアのShopify管理画面で、販売チャネルを管理できる権限。
• Fy2Pressがインストール済みで、ホーム画面を開いていること。
• ストアのmyshopify.comアドレス（例：example-store.myshopify.com）。
• Shopifyへの外向きのHTTPS通信が許可されているWordPressのホスティング環境。

始める前に、元に戻す手段を用意してください。バックアップまたはステージング環境のコピー、比較に使うShopifyの商品、結果を表示するWordPressのページを決めておきます。まずは繰り返し試せる小さなテストから始めましょう。

このガイドで扱う内容

FREEで接続できるShopifyストアは1つです。入力欄には公開Storefront APIトークンを入力します。非公開トークンやAdmin APIトークンは代わりになりません。テストが成功すればカタログにアクセスできることは確認できますが、この時点ではまだ何も同期されていません。Shopify自身のチュートリアルはこのあとサーバー側のコード向けの非公開トークンへと進みますが、それはFy2Pressで使う値ではありません。

まず、それぞれの役割を確認しておきましょう。商品、在庫、注文、支払い、チェックアウトはShopifyが管理します。Fy2PressはカタログをWordPressに取り込んで表示します。WordPressにはサイトのページや記事などのコンテンツが置かれます。このガイドの手順で、注文、顧客、支払いがWordPressへ移ることはありません。

手順

1. Shopifyで、Headless販売チャネルがまだなければShopify App Storeからインストールし、開きます。
2. 「Create storefront」を選ぶか、WordPress用にすでに使っているストアフロントを開き、そのStorefront APIの設定を開きます。
3. 公開Storefront APIトークンをコピーします。ストアのオーナーと一緒に、Storefront APIの次の権限だけを有効にします。商品とコレクション(unauthenticated_read_product_listings)、商品タグ(unauthenticated_read_product_tags)、商品在庫(unauthenticated_read_product_inventory)、カートの読み取りと変更(unauthenticated_read_checkouts, unauthenticated_write_checkouts)。顧客、コンテンツ、メタオブジェクトの権限は無効のままにしてください。Fy2Pressは顧客や注文のデータを読み取りません。
4. WordPressで「Fy2Press」→「接続設定」を開きます。「ストアURL」には .myshopify.com の前の部分だけを入力し、トークンを「公開Storefront APIトークン」に貼り付けます。
5. 「接続テスト」を選び、意図したストアであることを確認してから、「設定を保存」を選びます。

ページを一般に公開する前に、結果を確認してください。成功メッセージが出るのは良い兆候ですが、公開ページとShopifyでの購入の流れも一致している必要があります。

結果の確認

• テスト後、「接続ステータス」に「未接続」と表示されなくなっています。
• ホーム画面で、Shopifyへの接続を求められなくなっています。
• トークンは「表示」を選ばない限り設定画面で隠されたままで、公開ページに表示されることはありません。

結果は、訪問者が実際に目にする場所で確認してください。Fy2Pressの画面だけでなく公開されているWordPressのページを開き、代表的な商品を、価格、在庫状況、バリエーション、コレクションも含めてShopifyと比べます。小さな変更を一度だけ繰り返し、動作が安定していることを確かめてください。

よくある問題

• 「Unauthorized」（認可エラー）：トークンが公開Storefrontトークンではないか、別のストアのものか、取り消されています。
• 「Store not found」（ストアが見つからない）：https://、パス、独自ドメインを付けずに、myshopify.comのサブドメインだけを入力してください。
• ネットワークエラー：WordPressからShopifyへ外向きのHTTPS通信ができるかを、ホスティング会社に確認してください。伝えるのはエラーメッセージだけにし、トークンは決して送らないでください。

想定外のことが起きたら、大きな操作をいったん止め、商品1件とページ1つで試し直してください。設定を変更したりキャッシュを削除したりする前に、エラーメッセージを正確に控えておきます。

トラブルシューティング

1. プラグインのバージョンとエディション（FREEまたはPRO）を確認します。
2. テスト用の商品1件で、問題を再現します。
3. 問題の原因がShopify、Fy2Press、WordPressのテーマのどれにあるかを見極めます。
4. エディションのガイドを参照し、ご利用のエディションに含まれる機能と結果を比べます。
5. テスト環境を元に戻してもう一度試し、同じ結果が繰り返されるかを記録します。

セキュリティとデータ

公開トークンはストアフロントからの要求向けに設計されていますが、スクリーンショット、サポートへのメッセージ、共有ドキュメントには含めないでください。Fy2Pressには、非公開のStorefrontトークンやAdmin APIトークンを決して入力しないでください。

サポートを依頼するときは、プラグインのバージョン、WordPressとPHPのバージョン、使用しているテーマまたはページビルダー、ページのアドレス、実行した手順を控えておいてください。テスト用の商品を使い、スクリーンショットを共有する前に、トークン、顧客データ、注文の詳細、非公開のアドレスを取り除いてください。

検索への影響

ストアを接続しても、公開ページは作成されません。同期する前に「Google と SEO」で、商品のメインのアドレスをWordPressとShopifyのどちらに置くかを決めてください。

サポートに伝える情報

サポートを依頼するときは、プラグインのバージョン、WordPressとPHPのバージョン、使用しているテーマまたはページビルダー、ページのアドレス、実行した手順を控えておいてください。テスト用の商品を使い、スクリーンショットを共有する前に、トークン、顧客データ、注文の詳細、非公開のアドレスを取り除いてください。

関連ガイド

• インストール
• WordPressで公開する
• GoogleとSEO
• セキュリティとデータ

バージョンと提供状況

Fy2Press 1.0.0のドキュメントです。無料プラグインはWordPress.orgで入手できます。PROは、ライセンスと決済を担当するFreemiusを通じて別途販売しています。