接続と表示を診断

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

期待される結果

不具合の報告書が、正確な候補版、影響を受けたシステム、再現手順、期待される挙動と観測された挙動、そして資格情報や顧客データを漏らさない安全な証跡を示します。

認証情報やテンプレートを変える前に、Shopifyへのアクセス、WordPressのHTTP、同期データ、テーマの描画を切り分けます。

開始前の準備

• インストール済みバージョン、エディション、パッケージの出所。
• 管理下のデータを用いた、再現可能なテストページまたはカタログレコード。
• ブラウザー、WordPress、PHP、有効なビルダーまたはSEOプラグインのバージョン。
• 破壊的な診断や同期の反復を行う前のデータベースバックアップ。

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

対象範囲と現在の制限

サポートフォームは、エッジ側の制御が設定されるまで意図的に閉じたままです。報告書はローカルで用意できますが、未設定のフォームがそれを送信したかのように受け取られる表現をサイトに置いてはいけません。

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

手順

1. 不具合を、接続、検出、同期、WordPressのデータ、描画、購買、SEO、ライフサイクルのいずれかに分類する。
2. 可能な限り、商品一件、コレクション一件、ショートコード一つ、ブロック一つ、URL一つにまで絞り込む。
3. 正確な手順を記録し、期待される挙動を、提供済み・部分的・未提供のいずれの機能状態と照合する。
4. トークン、非公開のままにすべきドメイン、個人データを取り除いたうえで、レンダリングされたページと該当するShopiPressの画面を取得する。
5. 検証のあとに環境を復元し、クリーンな状態でも不具合が続くかを確認する。

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

結果の確認

• 別の管理者が、欠けた手順を推測せずに報告書から不具合を再現できる。
• 報告書が、Shopifyの情報源、ShopiPressの伝達、WordPressの表示という各層を区別している。
• 添付物のいずれにも、トークン、顧客の記録、注文の詳細、非公開URLが含まれていない。

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

よくある誤り

• 断続的な挙動: 操作を何度も繰り返すのではなく、時刻と状態変化の順序を記録する。
• ビルダーのプレビューだけが失敗する: フロントエンドのレンダラーで検証し、エディター固有の問題かどうかを見極める。
• SEOの出力が想定と異なる: キャッシュを削除する前に、最終的なHTMLと有効な連携の一覧を保存する。

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

トラブルシューティング

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

セキュリティとデータ

共有する前に証跡を無害化してください。トークン、顧客情報、注文の識別子、ストアの非公開ドメインを管理下のプレースホルダーに置き換え、問題の再現に必要な構造は保ったままにします。

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

SEOへの影響

SEOの不具合では、正確な応答ステータス、canonical、robots、必要に応じてhreflang、サイトマップへの掲載、構造化データ、内部リンクを含めてください。スクリーンショットだけでは不十分です。

記録すべき証跡

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

関連ガイド

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

バージョンと製品の状態

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