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 グリーティングバーが表示されないのですか？
可能性が高い順:
- B2B カスタマーとしてサインインしていない。 バーは
customer.b2b?が true であり、かつcustomer.current_companyが設定されている場合にのみ表示されます。 - Storefront mode が B2C-only に設定されている。 Theme settings ▸ B2B ▸ Storefront mode を開いて、Hybrid (auto) または B2B-only に変更してください。
- Shopify 管理画面でネイティブ B2B が有効化されていない。 Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B に移動してください。
- バイヤーの会社が削除または失効した。
customer.current_companyがセッション途中で nil になった場合、Vertex は防御的にバーをスキップします。
なぜ営業担当者ピルがヘッダーに表示されないのですか？
担当者ピルは、3 つすべて の条件が満たされた場合にのみ表示されます:
- バイヤーが B2B としてサインインしている (
customer.b2b? == true) - バイヤー の会社に
vertex.rep_nameメタフィールドが設定されている - Storefront mode が B2C-only ではない
Customers ▸ Companies ▸ [会社名] ▸ Metafields で、vertex.rep_name が投入されていることを確認してください。
なぜ数量別価格段階が PDP に表示されないのですか？
Vertex は Shopify ネイティブの quantity_price_breaks から数量段階を読み取ります。PDP の数量テーブルは以下の場合にのみ描画されます:
- バイヤーが会社にサインインしている
- その会社が B2B カタログに割り当てられている
- カタログの価格リストにその商品が数量ベースの価格段階で含まれている
テーブルが空の場合は、B2B ▸ Catalogs ▸ [カタログ名] ▸ Price list の価格リストを再確認してください。
なぜ B2B バイヤーがログインしているのに「ログインして価格を確認」と表示されるのですか？
Theme settings ▸ B2B ▸ Hide prices until customer logs in トグルがオンになっています。この機能は ゲストのみ に対して価格を非表示にします。サインインしたカスタマー (B2C または B2B) には常に価格が表示されるはずです。表示されない場合は、設定をオフに切り替えて保存してください。
なぜ B2B でサインインしているのにストアフロントが「B2C」のように感じますか？
いずれかの理由:
- Storefront mode が B2C-only に設定されている。 Hybrid または B2B-only に変更してください。
- カスタマーレコードが会社にリンクされていない。 Customers ▸ [カスタマー名] を開いて、Companies タブで会社に紐付けられていることを確認してください。
カスタマイズ
ブランドカラーを変更するにはどうすればいいですか？
- Theme settings ▸ Colors を開きます
- ワンクリック再カラーリングのために Starter color palette を選択するか、Custom を選択して各カラーを個別にオーバーライドします
カスタムフォントを追加するにはどうすればいいですか？
Theme settings ▸ Typography のフォントピッカーは、Shopify のフォントライブラリを使用します。それ以外のフォントを使用するには、theme.liquid に <link> を追加し、--font-body / --font-heading CSS カスタムプロパティを更新してください。
ロゴを追加するにはどうす ればいいですか？
- テーマエディターを開き、セクションパネルで Header をクリックします
- Logo image をクリックしてファイルをアップロードします
- 推奨高さ: 約 40 px、SVG を推奨
アナウンスバーのテキストをカスタマイズするにはどうすればいいですか？
- テーマエディターで Header group ▸ Announcement bar を開きます
- Text フィールドを編集します
- バーには localStorage を尊重する組み込みの閉じるための × があります
セカンダリナビゲーション (Special offers / Guides / Services / FAQ) を追加 / 編集するにはどうすればいいですか？
- Online Store ▸ Navigation に移動します
- ハンドル
secondary-menuで新しいメニューを作成します (Vertex によって自動検出されます) - リンクを追加します — デスクトップヘッダーに右寄せで表示されます
4 つのデモストアフロント (Vertex / Throttle / OfficeIT / Inkline) を切り替えるにはどうすればいいですか？
2 つの方法:
- 永続的な再カラーリング — Theme settings ▸ Colors ▸ Starter color palette — 4 つのプリセットから 1 つを選択
- 一時的なプレビュー — ストアフロントの任意の URL に
?view=throttle(またはofficeit/printsupply) を追加
→ 詳細は デモプリセットガイド を参照してください。
パフォーマンス
Vertex ストアフロントの Lighthouse スコアはどのくらいですか？
ショーケースデモで計測:
- モバイル Performance: 65〜100 (ページタイプ依存)
- デスクトップ Performance: すべてのページで 90+
- アクセシビリティ: 92〜95
- Best Practices: 95+
- SEO: 100
Lighthouse Performance をさらに改善するにはどうすればいいですか？
- ヒーロー画像を最適化する。 WebP を複数幅で使用し、スライドあたり 300 KB 未満を目指す。
- ヒーローを 1 スライドに制限する。 マルチスライドヒーローローテーターは LCP に影響します。デフォルトは 1 スライドで同梱されています。
- 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 ファイルは、汎用スタイルシートよりも高い特異性を持ちます。次のいずれかでオーバーライドを追加してください:
- Theme settings ▸ Colors ▸ Custom (推奨 — ほとんどは CSS 変数で駆動されます)
- 既存 のルールの後の
assets/vertex.css内のカスタム CSS !importantを持つ新しいassets/custom-overrides.css(最終手段)
それでも困っている場合は
- セクションセットアップガイド — 特定のセクション設定の問題について
- 機能ガイド — B2B、メタフィールド、Markets、プリセット、カスタマーアカウント、RFQ について
- サポート → — Theme Store サポートポータルからチケットを発行