カタログを確認して同期

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

期待される結果

現在の手動実行はShopifyのカタログを検出し、確認可能な要約を表示し、WordPressの商品投稿、コレクションのターム、商品タグのタームを作成または更新します。定期的な自動処理があるとは主張しません。

商品、コレクション、タグを検出し、要約を確認したうえで、現行の手動同期を実行します。

開始前の準備

• テスト済みのShopify接続と、復元可能なWordPressデータベースのスナップショット。
• ShopiPressの商品投稿とタクソノミーを作成または更新する権限。
• 商品、コレクション、タグ、バリエーション、在庫状況の値が既知である小規模な検証用データ。
• 同期した内容のうち、確認後にどれを公開してよいかの判断。

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

対象範囲と現在の制限

カタログ全体の手動同期は「部分的」に分類されます。定期ジョブ、Webhook、キュー、再開可能な実行、多言語カタログ同期、メディアの複製、metafieldやACFのマッピングはありません。

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

手順

1. 検出を開始し、WordPressのレコードを書き込む前に情報源の要約を待つ。
2. 検出された件数と代表的なレコードを、Shopify側の情報源と照合する。
3. 確認用の要約に矛盾がないことを確かめてから、手動同期を開始する。
4. WordPressで作成・更新された商品投稿、コレクションのターム、商品タグのタームを点検する。
5. 二度目の管理された同期を実行し、更新が冪等であること、文書化されたソフト削除または復元の挙動を確認する。

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

結果の確認

• 代表的な商品が、Shopifyでの同一性、ハンドル、バリエーション、価格、在庫状況のデータを保っている。
• コレクションと商品タグが、意図したWordPressのタクソノミーに割り当てられている。
• 再実行が、カタログを黙って重複させるのではなく、既存のレコードを更新している。

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

よくある誤り

• 検出が不完全: 書き込む前に中止し、Storefrontの権限またはページネーションを調べる。
• 同期後に件数が食い違う: 再実行の前に、確認用の要約、WordPressのステータス、情報源のレコードを照合する。
• 削除または復元のあとに商品が見当たらない: レコードが失われたと結論づける前に、ソフト削除の状態を確認し、該当するキャッシュを無効化する。

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

トラブルシューティング

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

セキュリティとデータ

同期が書き込むのはカタログの内容であり、顧客や注文のデータではありません。証跡は架空または管理下のカタログレコードで記録し、ログとスクリーンショットからトークンを取り除いてください。

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

SEOへの影響

新しい商品URLとタクソノミーURLは、アーカイブやサイトマップに入る可能性があります。canonicalの情報源、アーカイブの方針、レンダリングされたrobots、スキーマ、内部リンクの挙動を確認するまでは、非公開またはnoindexのままにしてください。

記録すべき証跡

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

関連ガイド

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

バージョンと製品の状態

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