接続と表示を診断

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

期待される結果

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

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

開始前の準備

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

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

このガイドで扱う内容

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

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

手順

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

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

結果の確認

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

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

よくある問題

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

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

トラブルシューティング

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

セキュリティとデータ

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

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

検索への影響

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

サポートに伝える情報

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

関連ガイド

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

バージョンと提供状況

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