跳到主要内容

按扩展类型控制 PDF 显示

当多个 PDF 链接到同一资源，且您的模板同时拥有两种主题应用扩展（嵌入式和按钮式）时，您可以控制哪些 PDF 显示在哪种扩展中。

多 PDF 带来的挑战​

当您将多个 PDF 链接到同一资源（例如产品），并在模板中同时添加了 PDF 嵌入式查看器 和 PDF 按钮 扩展时：

默认行为： 所有已链接的 PDF 同时显示在两种扩展中

您可能希望的效果： 不同的 PDF 显示在不同的扩展中

示例场景：

  • 产品手册 → 仅在产品描述下方的嵌入式查看器中显示
  • 保修信息 → 仅在页面底部的按钮扩展中显示

何时会出现此选项​

控制扩展显示的复选框仅在以下情况下出现：

  1. 您已将多个 PDF 链接到同一资源
  2. 模板中已同时添加两种主题应用扩展（嵌入式 和 按钮式）

您将在 PDF 详情页面的 发布 区块中看到此选项。

使用扩展控制复选框​

在 发布 区块中，您将看到：

已发布的扩展：
☑ pdf_embedded（已启用）
☑ pdf_button（已启用）

若要在特定扩展中隐藏某个 PDF：

  • 取消勾选该扩展类型的复选框
  • 该 PDF 将从该扩展的模板数组中移除
  • 该 PDF 将不再显示在该扩展中

示例：

已发布的扩展：
☑ pdf_embedded（已启用）  ← PDF 在嵌入式查看器中显示
☐ pdf_button（已禁用）   ← PDF 在按钮扩展中隐藏

使用场景​

场景一：主要内容与补充内容​

包含 2 个 PDF 的产品：

  • 使用手册（主要内容）→ 仅在嵌入式查看器中显示
  • 保修卡（补充内容）→ 仅在按钮扩展中显示

设置步骤：

  1. 将两个 PDF 链接到该产品
  2. 在产品模板中添加两种扩展
  3. 使用手册：☑ 嵌入式，☐ 按钮
  4. 保修卡：☐ 嵌入式，☑ 按钮

场景二：快速参考与详细文档​

包含 3 个 PDF 的产品系列：

  • 快速购买指南 → 嵌入式查看器
  • 完整目录 → 按钮扩展
  • 尺码表 → 按钮扩展

设置步骤：

  1. 将所有 PDF 链接到该产品系列
  2. 在产品系列模板中添加两种扩展
  3. 快速指南：☑ 嵌入式，☐ 按钮
  4. 完整目录：☐ 嵌入式，☑ 按钮
  5. 尺码表：☐ 嵌入式，☑ 按钮

场景三：在两种扩展中显示所有 PDF​

包含多个手册的产品：

  • 所有 PDF 在查看器和按钮中均可访问

设置步骤：

  1. 链接所有 PDF
  2. 添加两种扩展
  3. 保持所有复选框勾选（默认状态）

模板文件追踪​

对于每个 PDF，应用会追踪以下信息：

文章模板示例：

article.articleTemp2 - 1 个扩展
  已发布的扩展：
    pdf_button

blog.blogTemp2 - 2 个扩展
  已发布的扩展：
    ☑ pdf_embedded（已启用）
    ☐ pdf_button（已禁用）

这表示：

  • 文章模板只有按钮扩展
  • 博客模板有两种扩展，但此 PDF 仅在嵌入式查看器中显示

管理多个模板​

如果同一资源类型使用了不同的模板文件，您将看到每个模板单独列出，各自拥有独立的扩展控制：

文章页面 - 已发布

  article.articleTemp1 - 1 个扩展
    ☑ pdf_button

  article.articleTemp2 - 1 个扩展
    ☑ pdf_button

对于同一个 PDF，每个模板可以有不同的扩展配置。

最佳实践​

从简单开始​

先为每个模板添加一种主题应用扩展。只有在需要区分 PDF 显示时，才添加第二种扩展。

提前规划 PDF 层级​

在添加两种扩展之前，先决定哪些 PDF 是主要内容（嵌入式），哪些是补充内容（按钮式）。

保持一致的规律​

如果您在多个模板中同时使用两种扩展，保持类似的 PDF 分配规则，便于管理。

从顾客视角测试体验​

以顾客身份浏览您的页面，确保正确的 PDF 显示在正确的位置。

故障排查​

复选框未出现：

  • 模板中只添加了一种扩展类型
  • 同时添加两种扩展后即可看到复选框

PDF 显示在错误的扩展中：

  • 检查发布区块中的复选框设置
  • 确认您查看的是正确的模板文件

PDF 在任何位置都不显示：

  • 至少需要勾选一个复选框
  • 确认 PDF 已链接到该资源
  • 检查 PDF 状态是否为已激活

更改未在店面显示：

  • 刷新页面（可能需要几秒钟）
  • 清除浏览器缓存
  • 确认已在应用中保存更改

下一步​