メインコンテンツまでスキップ

FAQ & トラブルシューティング

最もよく寄せられる質問への迅速な回答。

インストール & セットアップ​

Vertex には Shopify Plus または Advanced プランが必要ですか？​

いいえ。 Vertex はすべての Shopify プランにインストールできます。ただし、ネイティブ B2B 機能 (会社、B2B カタログ、NET 条件、免税、複数拠点) には、Shopify Plus または Advanced + B2B アドオンが必要です。それらがなくても、Vertex は洗練された B2C 工業用品テーマとして動作します — すべての B2B 機能はグレースフルに縮退します。

コンパニオンアプリは必要ですか？​

いいえ。 Vertex は Shopify のネイティブ B2B 機能をエンドツーエンドで使用します。見積管理アプリ、卸売価格アプリ、マルチカレンシーアプリ、比較アプリは不要です。

フルインストールにはどのくらい時間がかかりますか？​

  • 基本インストール (テーマのみ): 5 分
  • フル B2B インストール (テーマ + ネイティブ B2B + 会社 + カタログ + メタフィールド): 初回 45〜60 分。後続の会社追加は 1 件あたり 5 分。

開発ストアで先に Vertex を試せますか？​

はい。 任意の開発ストアに Vertex をインストールし、ライブストアフロントに影響を与えずにカスタマイズできます。準備が整ったら公開してください。

B2B 要素の表示​

なぜコバルトブルーの B2B グリーティングバーが表示されないのですか？​

可能性が高い順:

  1. B2B カスタマーとしてサインインしていない。 バーは customer.b2b? が true であり、かつ customer.current_company が設定されている場合にのみ表示されます。
  2. Storefront mode が B2C-only に設定されている。 Theme settings ▸ B2B ▸ Storefront mode を開いて、Hybrid (auto) または B2B-only に変更してください。
  3. Shopify 管理画面でネイティブ B2B が有効化されていない。 Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B に移動してください。
  4. バイヤーの会社が削除または失効した。 customer.current_company がセッション途中で nil になった場合、Vertex は防御的にバーをスキップします。

なぜ営業担当者ピルがヘッダーに表示されないのですか？​

担当者ピルは、3 つすべて の条件が満たされた場合にのみ表示されます:

  1. バイヤーが B2B としてサインインしている (customer.b2b? == true)
  2. バイヤーの会社に vertex.rep_name メタフィールドが設定されている
  3. Storefront mode が B2C-only ではない

Customers ▸ Companies ▸ [会社名] ▸ Metafields で、vertex.rep_name が投入されていることを確認してください。

なぜ数量別価格段階が PDP に表示されないのですか？​

Vertex は Shopify ネイティブの quantity_price_breaks から数量段階を読み取ります。PDP の数量テーブルは以下の場合にのみ描画されます:

  1. バイヤーが会社にサインインしている
  2. その会社が B2B カタログに割り当てられている
  3. カタログの価格リストにその商品が数量ベースの価格段階で含まれている

テーブルが空の場合は、B2B ▸ Catalogs ▸ [カタログ名] ▸ Price list の価格リストを再確認してください。

なぜ B2B バイヤーがログインしているのに「ログインして価格を確認」と表示されるのですか？​

Theme settings ▸ B2B ▸ Hide prices until customer logs in トグルがオンになっています。この機能は ゲストのみ に対して価格を非表示にします。サインインしたカスタマー (B2C または B2B) には常に価格が表示されるはずです。表示されない場合は、設定をオフに切り替えて保存してください。

なぜ B2B でサインインしているのにストアフロントが「B2C」のように感じますか？​

いずれかの理由:

  1. Storefront mode が B2C-only に設定されている。 Hybrid または B2B-only に変更してください。
  2. カスタマーレコードが会社にリンクされていない。 Customers ▸ [カスタマー名] を開いて、Companies タブで会社に紐付けられていることを確認してください。

カスタマイズ​

ブランドカラーを変更するにはどうすればいいですか？​

  1. Theme settings ▸ Colors を開きます
  2. ワンクリック再カラーリングのために Starter color palette を選択するか、Custom を選択して各カラーを個別にオーバーライドします

カスタムフォントを追加するにはどうすればいいですか？​

Theme settings ▸ Typography のフォントピッカーは、Shopify のフォントライブラリを使用します。それ以外のフォントを使用するには、theme.liquid に <link> を追加し、--font-body / --font-heading CSS カスタムプロパティを更新してください。

ロゴを追加するにはどうすればいいですか？​

  1. テーマエディターを開き、セクションパネルで Header をクリックします
  2. Logo image をクリックしてファイルをアップロードします
  3. 推奨高さ: 約 40 px、SVG を推奨

アナウンスバーのテキストをカスタマイズするにはどうすればいいですか？​

  1. テーマエディターで Header group ▸ Announcement bar を開きます
  2. Text フィールドを編集します
  3. バーには localStorage を尊重する組み込みの閉じるための × があります

セカンダリナビゲーション (Special offers / Guides / Services / FAQ) を追加 / 編集するにはどうすればいいですか？​

  1. Online Store ▸ Navigation に移動します
  2. ハンドル secondary-menu で新しいメニューを作成します (Vertex によって自動検出されます)
  3. リンクを追加します — デスクトップヘッダーに右寄せで表示されます

Vertex を自動車部品 / オフィス & IT / 印刷の構成のように見せるにはどうすればいいですか？​

それぞれの見た目は、テーマエディターの 1 つの設定から作ります:

カラーパレット — Theme settings ▸ Colors ▸ Starter color palette を開き、パレットを選択します: Custom(デフォルト — コバルトブルーの産業的な見た目)、Signal red(自動車部品)、Office blue(オフィス & IT)、または Inkline teal(印刷消耗品)

→ 詳細は Vertex でできること を参照してください。

パフォーマンス​

Vertex ストアフロントの Lighthouse スコアはどのくらいですか？​

ショーケースデモで計測:

  • モバイル Performance: 65〜100 (ページタイプ依存)
  • デスクトップ Performance: すべてのページで 90+
  • アクセシビリティ: 92〜95
  • Best Practices: 95+
  • SEO: 100

Lighthouse Performance をさらに改善するにはどうすればいいですか？​

  1. ヒーロー画像を最適化する。 WebP を複数幅で使用し、スライドあたり 300 KB 未満を目指す。
  2. ヒーローを 1 スライドに制限する。 マルチスライドヒーローローテーターは LCP に影響します。デフォルトは 1 スライドで同梱されています。
  3. Shopify アプリ埋め込みを制限する。 各サードパーティアプリは JS を挿入し、すべてが TBT に追加されます。

なぜモバイル Performance がデスクトップ Performance より低いのですか？​

Shopify テーマの標準 — モバイルは Lighthouse でスロットルされています (CPU が遅い + ネットワークが遅い)。実際の iPhone 14 / Galaxy S22 ユーザーは、Lighthouse の数値よりもはるかに優れたスコアを得られます。

アクセシビリティ & 国際化​

Vertex は WCAG 2.1 AA に準拠していますか？​

はい。 キーボードナビゲーション、可視フォーカス、4.5:1 のコントラスト下限、モバイルでの 24 px タッチターゲット、適切な ARIA ロール、スキップトゥコンテンツリンク、ラベル付きフォーム入力。

Vertex はどの言語に対応していますか？​

5 言語: 英語 (デフォルト)、フランス語、イタリア語、ドイツ語、スペイン語。UI 文字列とスキーマラベルの両方が翻訳されています。

Vertex は RTL 言語に対応していますか？​

はい — 完全対応。アラビア語、ヘブライ語、ペルシア語、ウルドゥー語、イディッシュ語、クルド語、ディベヒ語、パシュトー語では <html dir> が自動で反転します。CSS は論理プロパティを使用しているので、レイアウトがクリーンにミラーリングされます。

他の言語を追加できますか？​

はい。 locales/en.default.json をターゲット言語に翻訳し、locales/{code}.json として保存してください。スキーマラベルは locales/en.default.schema.json にあるので、エディター UI もローカライズするには locales/{code}.schema.json に翻訳してください。

メタフィールド & 商品データ​

Vertex はどのメタフィールドを使用しますか？​

vertex 名前空間内:

  • vertex.mpn (商品) — メーカー部品番号、予測検索でインデックス化
  • vertex.ships_from (商品) — 商品ごとの発送元都市
  • vertex.price_history (商品) — {date, price} エントリの JSON リスト
  • vertex.datasheet、vertex.msds、vertex.brochure、vertex.tech_sheet、vertex.install_guide、vertex.warranty (商品) — PDF のファイルピッカー
  • vertex.rep_name、vertex.rep_email、vertex.rep_phone (会社) — 会社ごとの営業担当者
  • vertex.payment_terms (会社) — NET 条件バッジラベルのオーバーライド

加えて、技術仕様テーブル用の vertex.tech_specs (商品) — label / value / 任意の unit を持つ「spec」エントリのリスト (メタオブジェクトではありません)。

→ 完全リファレンス: メタフィールドセットアップガイド。

メタフィールドが欠落している場合はどうなりますか？​

対応する PDP ブロックは自動的に非表示になります。Vertex は欠落しているメタフィールドに対して防御的です — 空の値が壊れた UI を描画することはありません。

価格 & ライセンス​

Vertex の価格はいくらですか？​

$399 USD のシングルストアライセンス。すべての v1.x リリースへの無料アップデートを含みます。

1 つの Vertex ライセンスを複数のストアで使用できますか？​

いいえ — 標準の Theme Store ライセンスはシングルストアです。マルチストアライセンスについては、Theme Store サポートポータルからチケットを発行してください。

Vertex はアップデートを受けますか？​

はい。 v1.x リリースには、バグ修正、パフォーマンス改善、新規セクションが含まれます。変更履歴 を参照してください。

一般的なエラーと修正​

「カスタマイズ版で Theme Check が 18 件の警告を表示する」​

おそらく Liquid テンプレートを編集し、未使用の変数やハードコードされたルートを導入したことが原因です。ローカルで shopify theme check を実行して詳細を確認してください。Vertex 自体は Theme Check 違反 0 件 で出荷されています。

「カスタム CSS がオーバーライドされる」​

Vertex のセクション単位の CSS ファイルは、汎用スタイルシートよりも高い特異性を持ちます。次のいずれかでオーバーライドを追加してください:

  1. Theme settings ▸ Colors ▸ Custom (推奨 — ほとんどは CSS 変数で駆動されます)
  2. 既存のルールの後の assets/vertex.css 内のカスタム CSS
  3. !important を持つ新しい assets/custom-overrides.css (最終手段)

それでも困っている場合は​