よくある質問

よくあるご質問（FAQ）ページを表示するセクションです。質問と回答は faq_entry メタオブジェクトに登録します。テーマエディタには質問を入力する欄はありません。管理画面の「コンテンツ → メタオブジェクト」で登録・公開した質問が、自動で表示されます。一度に表示できるのは最大50件です。

Hellostore AI Staff を導入しているストアでは、AIチャットのFAQ回答も同じデータから返ります。画面に表示されていない（下書きの）質問にAIが勝手に答えることはありません（Hellostore AI Staff 連携）。

分類: Hellostore オリジナル

主な機能

自動表示 — 公開済みの faq_entry を表示（最大50件）。表示/非表示の個別設定は不要で、メタオブジェクトを「公開」にするか「下書き」のままにするかだけで決まります
検索ボックス — 質問・回答テキストからの絞り込み（お客様のブラウザ内で動作します）
カテゴリー絞り込み — 質問の category フィールドから、カテゴリーごとに絞り込むボタンを自動で作ります
検索用データを出す — Google などの検索エンジンに、このページの質問と回答を伝えます
お問い合わせ欄 — 「お問い合わせ欄」ブロックで、質問リストの下にお問い合わせページへのボタンを表示できます

使い方

faq_entry メタオブジェクトの定義を作成します（最初に1回だけ。手順は下の「メタオブジェクトの定義を作る」）
Shopify 管理画面の「コンテンツ → メタオブジェクト」で作った定義を開き、エントリーを追加 から質問を1件ずつ登録します。ステータスを 有効（公開） にして保存します
管理画面でページを作成し、テンプレートに page.faq を選びます（FAQ 用テンプレートが同梱されており、パンくずリスト・ページ本文・FAQ セクションが最初から並びます）
お問い合わせ欄を出すときは、「お問い合わせ欄」ブロックを追加し、お問い合わせページのリンク先を入力します

メタオブジェクトの定義を作る

メタオブジェクトは、Shopify の管理画面で自分で作れる「独自のデータの入れ物」です。FAQ セクションは、決まった名前（faq_entry）の入れ物から質問を読み取ります。名前やキーが1文字でも違うと表示されません。定義はテーマに含まれないため、店ごとに最初に1回だけ作ります。

管理画面の左下の設定を開き、カスタムデータ を開きます
メタオブジェクト の欄で 定義を追加 を押します
名前に「よくあるご質問」など分かりやすい名前を入れます。その下の タイプ（システムが使う名前）を faq_entry に書き換えます
フィールドを追加 で、下の表のフィールドを1つずつ追加します。フィールドの名前を入れたあと、キーが表の「キー」と同じになっているか確かめ、違えば書き換えます
定義の設定で、スイッチを確認します
- 公開ステータス（エントリーごとに「下書き / 有効」を切り替える機能）— 必ずオンにします。オフのままだと、下書きの区別が無く、登録したエントリーがすべて表示されます
- 翻訳（Translation）— 複数の言語で店を運営するときはオンにします。オフのままだと翻訳アプリ（Translate & Adapt）にも翻訳APIにも質問が表示されず、翻訳を作成できません。エラーも出ないため気づきにくいので注意してください
- ストアフロントからのアクセス — 必ずオンにします
保存します

操作名は Shopify の画面に合わせてください。

メタオブジェクトのフィールド

faq_entry に必要なフィールドは次のとおりです。

キー	型（管理画面での選択肢）	必須	用途
`question`	1行のテキスト	必須	質問文。空の質問は表示・件数から除外されます
`answer`	リッチテキスト	必須	回答本文
`category`	1行のテキスト	任意	カテゴリー名。空なら見出し無しの末尾グループに表示されます
`sort_order`	整数	任意	表示順。小数ではなく整数を選びます
`source`	1行のテキスト	任意	出典メモ（管理用）。ストアフロントには出力されません

カテゴリーの運用

カテゴリーの絞り込みボタンとグループ見出しは、質問の category から自動生成されます。表記ゆれでボタンが増えるのを防ぐため、以下の正規ラベルで運用することをおすすめします。

ラベル	想定内容
注文・決済について	注文手順・決済方法・キャンセル・変更
配送について	送料・お届け日数・追跡・ギフトラッピング
商品・在庫について	サイズ・素材・在庫状況・再入荷
返品・交換について	返品ポリシー・交換手順
アカウント・会員について	ログイン・会員特典

カテゴリー未設定の質問は、見出し無しの末尾グループに表示されます。

表示順（sort_order）

sort_order は 10刻みで一意にする（10, 20, 30, …）のがおすすめです。同じ値の並び順は保証されないため、一意にしておくと表示順が常に確定します。途中に挿入するときは中間値（15 など）ではなく、以降を繰り下げて10刻みを保ってください。

設定

質問の取得元: 公開済みメタオブジェクトか手入力の質問ブロックを選びます。既定は公開済みメタオブジェクトです。手入力の質問ブロックでは、メタオブジェクトを使いません。
アンカー ID: # なしで入力します（例: faq）。/#faq で、このセクションへ移動します。質問が1件もないときは移動先も出ません。sg-faq や sgfaq- で始まる名前は別の名前に変わるため使わないでください。
リード文: 質問リストの上に表示します。空欄なら表示されません。
検索ボックスを表示: 既定はオンです。JavaScript が無効な環境では表示されません。
カテゴリーの絞り込みを表示: 既定はオンです。カテゴリーが2種類以上あるときだけ表示されます。
最初の質問を開いた状態にする: 既定はオフです。ページ表示時に最初の質問だけ回答を開きます。
検索用データを出す: 既定はオンです。Google などの検索エンジンに、このページの質問と回答を伝えます。
配色: セクション本体の配色です。既定は scheme-1 です。
上: セクション上部の余白です。0〜100px、4px刻み、既定は36pxです。
下: セクション下部の余白です。0〜100px、4px刻み、既定は36pxです。

ブロック

手入力の質問

「質問の取得元」を 手入力の質問ブロック にしたときに使います。メタオブジェクトを作らずに、このセクションの中で質問を管理できます。質問が空欄のブロックは表示しません。

質問: 「質問の取得元」が「手入力の質問ブロック」のときだけ表示されます。
回答: 回答の本文です（リッチテキスト）。
カテゴリー: 同じカテゴリーの質問をまとめて表示します。カテゴリー見出しが不要な場合は空欄にします。

お問い合わせ欄

質問リストの下にお問い合わせページへのボタンを表示します。1つだけ追加できます。

お問い合わせページのリンク先: 通常は /pages/contact などのページを指定します。空欄の間は表示されません。
チャットへの案内を表示: 既定はオンです。リンク先を入力したときだけ表示されます。「チャットで質問する」ボタンと案内文を出し、AIチャットがストアで使えるときだけ表示されます。
お問い合わせ欄の配色: 既定は scheme-3 です。リンク先を入力したときだけ表示されます。質問リストと別の配色にできます。

トラブルシューティング

FAQ が1件も表示されない

次の点を確認してください。

faq_entry メタオブジェクトの定義が作成されているか（タイプ名が faq_entry と完全に同じか）
定義の「ストアフロントからのアクセス」がオンになっているか
質問が公開されているか（すべて下書きのままになっていないか）
question フィールドに質問文が入っているか

カテゴリーの絞り込みボタンが出ない

カテゴリーが2種類以上あるか確認してください。すべての質問が同じカテゴリーの場合は、絞り込みボタンは表示されません。

表示順が入れ替わる

sort_order に重複する値がないか確認してください。同じ値の並び順は保証されません。