Shopifyを安全に接続

このガイドは、ページ冒頭に示されたShopiPressのバージョンに適用されます。当該バージョンはFreemiusで正式に公開されています。手順を適用する前にインストール済みバージョンを確認してください。以降のバージョンでは画面、既定値、サービスの境界が変わる場合があります。

期待される結果

Shopifyストア一件が、myshopify.comのサブドメインとStorefront APIの公開トークンで接続されます。接続テストは、Admin APIの非公開資格情報を持ち込むことなく成功します。

ストアのサブドメインとStorefront APIの公開トークンを使い、接続をテストし、商取引の境界を保ちます。

開始前の準備

• 既存のShopifyストアと、公開Storefrontトークンを作成または取得する権限。
• 候補版の同一性が確認済みの、動作するShopiPressインストール。
• WordPressから、設定済みのmyshopify.com Storefrontエンドポイントへの外向きHTTPS通信。
• テストの記録に、顧客、注文、支払い、Admin APIの非公開資格情報を含めないこと。

復元ポイントを用意し、根拠となるShopifyのレコードと、結果を裏づけるWordPressのURLまたは管理画面を特定してください。テストは、あいまいなカタログ状態を生まずに繰り返せる程度に小さく保ちます。

対象範囲と現在の制限

この候補版はストア一件の接続に対応します。接続の成功はStorefrontへの到達性を確認するものであり、すべてのカタログレコードが同期できることや、バックグラウンドの自動処理が存在することを示すものではありません。

作業全体を通じて責任分担を明確に保ってください。Shopifyは引き続き商取引の情報源であり決済システムです。ShopiPressは提供された契約に従ってカタログを接続し、同期し、描画します。WordPressは公開の文脈を担います。WordPress側で成功した結果を、注文、顧客、支払い、在庫に関する権限の移転と解釈してはいけません。

手順

1. 入力欄が求めるストアのサブドメインだけを貼り付ける。パスやクエリを含む任意のURLは使わない。
2. 公開Storefrontトークンを入力する。テストが失敗しても、Admin APIのアクセストークンで代用しない。
3. 「接続をテスト」を選び、成功か失敗かの明示的な応答を待つ。
4. 接続テストが成功し、表示されたストアが意図したものであることを確認してから保存する。
5. カタログ検出に進み、その要約を確認し、最初の同期は手動のままにする。

管理操作と公開の間にある確認の手順を省略しないでください。制御側の成功応答は証跡の一層にすぎません。保存されたWordPressのレコード、レンダリングされたページ、Shopifyの購買経路が一致している必要があります。

結果の確認

• ホーム画面が「未接続」ではなく、接続済みのストアを表示している。
• カタログ検出が、レンダリングされたページやスクリーンショットにトークンを露出させずに情報源へ問い合わせできる。
• 購買操作が、WordPressの取引エンジンではなく、引き続きShopify経由で処理される。

結果はShopiPressの管理画面だけでなく、レンダリングされたWordPressページと権威あるShopify側の画面の両方で確認してください。価格、在庫状況、バリエーション、コレクションのデータを備えた代表的な商品を使用します。冪等性が問題になる場合は最小限の安全な操作を繰り返し、テストを広げる前に差異を必ず記録してください。

よくある誤り

• 認可エラーの応答: トークンが公開用で有効であり、意図したストアフロントに紐づいているかを再確認する。
• ストアが見つからない: myshopify.comのサブドメインを正規化し、プロトコル、スラッシュ、無関係なドメインを取り除く。
• ネットワークエラー: WordPressが外向きHTTPS通信を行えること、セキュリティ層がStorefrontエンドポイントを遮断していないことを確認する。

結果が想定と異なる場合は、広範な操作を止め、レコード一件、URL一つ、レンダラー一つにまで問題を絞り込んでください。診断を再現可能に保つため、設定変更やキャッシュ削除の前に失敗した応答を保存します。

トラブルシューティング

1. パッケージのバージョンとエディションを確認する。
2. 管理下のデータで、最小かつ安全な事例を再現する。
3. 失敗している手順の責任がShopify、ShopiPress、WordPressのどれにあるかを特定する。
4. 観測された結果を、提供済み、部分的、未提供のいずれの機能状態と照合する。
5. テスト環境を復元し、一度繰り返して、結果が安定しているかを記録する。

セキュリティとデータ

公開トークンであっても、ストアフロントへのアクセス範囲を定めるため慎重な取り扱いが必要です。チケット、スクリーンショット、ブラウザ録画、コミットされた設定に出力しないでください。ShopiPressの管理は信頼できる権限に限定します。

インストール済みバージョン、エディション、WordPressとPHPのバージョン、有効なビルダーまたはSEO連携、正確なURL、ビューポート、そして結果を生んだ操作の順序を記録してください。取得するのは管理下のカタログデータのみとします。成果物が検証環境を離れる前に、Storefrontトークン、顧客データ、注文情報、非公開ドメイン、環境の機密情報を伏せてください。

SEOへの影響

接続だけではcanonicalの方針は変わりません。同期した商品を公開する前に、ShopifyとWordPressのどちらを主たる商品面とするかを決め、設定画面のラベルではなくレンダリングされた応答で確認してください。

記録すべき証跡

インストール済みバージョン、エディション、WordPressとPHPのバージョン、有効なビルダーまたはSEO連携、正確なURL、ビューポート、そして結果を生んだ操作の順序を記録してください。取得するのは管理下のカタログデータのみとします。成果物が検証環境を離れる前に、Storefrontトークン、顧客データ、注文情報、非公開ドメイン、環境の機密情報を伏せてください。

関連ガイド

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

バージョンと製品の状態

ShopiPressはFreemiusで正式に公開されています。このガイドは文書化されたバージョンを説明します。購入およびダウンロードのリンクは、その遷移先が設定され次第、本サイトに追加されます。