拡張タイプごとにPDF表示を制御する
同じリソースに複数のPDFがリンクされていて、テンプレートに Theme App Extension（埋め込み・ボタン）の両方が追加されている場合、どのPDFをどの拡張に表示するかを制御できます。
複数PDFで起きやすいこと
同じリソース（例: 商品）に複数のPDFをリンクし、テンプレートに PDF Embedded Viewer と PDF Button の両方の拡張を追加している場合:
デフォルトの挙動: リンクされたPDFが、両方の拡張にすべて表示されます
やりたいこと: 拡張ごとに表示するPDFを分けたい
例:
- 商品マニュアル → 商品説明の下に、埋め込みビューアだけで表示
- 保証情報 → ページ末尾に、ボタン拡張だけで表示
この設定が表示される条件
拡張表示を制御するチェックボックスは、次の条件を満たすときだけ表示されます:
- 同じリソースに複数のPDFをリンクしている
- テンプレートに Theme App Extension が両方（埋め込み AND ボタン）追加されている
この設定は、PDF詳細ページの Publish セクションに表示されます。
拡張制御チェックボックスの使い方
Publish セクションに次のように表示されます:
Published extensions:
☑ pdf_embedded (enabled)
☑ pdf_button (enabled)
特定の拡張からPDFを非表示にするには:
- 対象の拡張タイプのチェックを外します
- その拡張のテンプレート配列からPDFが外れます
- その拡張ではPDFが表示されなくなります
例:
Published extensions:
☑ pdf_embedded (enabled) ← PDF が埋め込みビューアに表示されます
☐ pdf_button (disabled) ← PDF をボタン拡張では非表示にします
例（ユースケース）
シナリオ1: 主要コンテンツと補足コンテンツを分ける
商品にPDFが2つある場合:
- 取扱説明書（主要）→ 埋め込みビューアのみ
- 保証書（補足）→ ボタン拡張のみ
設定手順:
- 両方のPDFを商品にリンクします
- 商品テンプレートに両方の拡張を追加します
- 取扱説明書: ☑ embedded, ☐ button
- 保証書: ☐ embedded, ☑ button
シナリオ2: さっと見る資料と詳細資料を分ける
コレクションにPDFが3つある場合:
- 簡易購入ガイド → 埋め込みビューア
- 完全版カタログ → ボタン拡張
- サイズ表 → ボタン拡張
設定手順:
- すべてのPDFをコレクションにリンクします
- コレクションテンプレートに両方の拡張を追加します
- 簡易ガイド: ☑ embedded, ☐ button
- 完全版カタログ: ☐ embedded, ☑ button
- サイズ表: ☐ embedded, ☑ button
シナリオ3: 両方の拡張にすべて表示する
複数のマニュアルがある商品:
- すべてのPDFを、埋め込みビューアとボタンの両方に表示する
設定手順:
- すべてのPDFをリンクします
- 両方の拡張を追加します
- チェックをすべてオンにします（デフォルト）
テンプレートファイルの追跡表示
PDFごとに、アプリはテンプレート単位で次を追跡します:
記事テン プレートの例:
article.articleTemp2 - 1 extension
Published extensions:
pdf_button
blog.blogTemp2 - 2 extensions
Published extensions:
☑ pdf_embedded (enabled)
☐ pdf_button (disabled)
この例から分かること:
- 記事テンプレートにはボタン拡張のみが追加されている
- ブログテンプレートには両方の拡張があるが、このPDFは埋め込みビューアにのみ表示される
複数テンプレートの管理
同じリソースタイプでも、異なるテンプレートファイルを 使っている場合は、テンプレートごとに別々に表示され、それぞれに拡張制御が付きます:
Article Pages - Published
article.articleTemp1 - 1 extension
☑ pdf_button
article.articleTemp2 - 1 extension
☑ pdf_button
同じPDFでも、テンプレートごとに拡張の有効/無効を別々に設定できます。
ベストプラクティス
シンプルに始める
テ ンプレートごとに Theme App Extension は1つから始めましょう。PDFの整理を分ける必要が出てきた場合にだけ、2つ目を追加します。
PDFの優先度を決める
両方の拡張を追加する前に、どれが主要（埋め込み）で、どれが補足（ボタン）か決めておきましょう。
パターンを統一する
複数テンプレートで両方の拡張を使う場合、同じルールで割り当てると管理が楽になります。
お客様目線で確認する
お客様としてページを見て、正しいPDFが正しい場所に出ているか確認しましょう。
トラブルシューティング
チェックボックスが表示されない:
- テンプレートに拡張が1種類しか追加されていません
- 両方の拡張を追加すると表示されます
PDFが意図しない拡張に表示される:
- Publish セクションのチェックボックス設定を確認してください
- 正しいテンプレートファイルを見ているか確認してください
PDFがどこにも表示されない:
- 少なくとも1つはチェックが必要です
- PDFがリソースにリンクされているか確認してください
- PDFステータスが Active か確認してください
ストアに変更が反映されない:
- ページを再読み込みしてください（数秒かかる場合があります）
- ブラウザキャッシュを削除してください
- アプリ側で変更が保存されているか確認してください