跳到主要内容

主题设置

将 PDF Connect 主题应用扩展添加到您的 Shopify 主题，让顾客可以在店面看到 PDF。

为什么主题设置很重要​

仅仅链接 PDF 并将其设为已激活是不够的。您必须在主题中添加主题应用扩展，PDF 才能在您的商店中显示。

可以这样理解：

  • 链接 = 将 PDF 与页面/资源关联
  • 主题应用扩展 = 在主题编辑器中让顾客看到 PDF。每个模板只需操作一次。

两者都是在店面显示 PDF 的必要条件。

这只是 PDF 设置中的一个配置步骤！

发布已链接 PDF 的两种方式​

1. 直接从 PDF 详情页面发布（推荐）​

添加主题应用扩展最快捷的方式：

  1. 在 PDF 详情页面打开 发布 区块
  2. 如果主题应用扩展尚未添加到主题模板，您将看到 发布 提示
  3. 点击 发布 并选择显示样式（嵌入式查看器或按钮）
  4. 将在新标签页或新窗口中打开您的主题编辑器，扩展已自动添加
  5. 根据需要调整扩展设置，然后在主题编辑器中点击 保存

2. 通过主题编辑器手动添加主题应用扩展​

适合需要更精细控制扩展位置的情况：

  1. 前往 在线商店 > 主题
  2. 在活动主题上点击 自定义
  3. 导航到已链接 PDF 的页面（例如产品页面）
  4. 点击 添加区块 或 添加板块（取决于您的主题）
  5. 在应用部分找到 PDF Connect
  6. 添加 PDF 嵌入式查看器 或 PDF 按钮
  7. 点击 保存

或查看自定义显示选项 →

手动 URL 区块（无需链接）​

对于产品模板，您还可以添加手动区块，直接从主题设置读取 PDF URL。

适合在不希望逐一链接每个产品时，在整个模板上共享 PDF。

手动区块操作流程​

  1. 在应用中打开任意 PDF 的详情页面
  2. 使用下拉操作 将 PDF 区块添加到产品模板（手动 URL）
  3. 选择一个产品模板和一种手动区块类型
  4. 继续打开主题编辑器，粘贴一个或多个 URL
  5. 保存主题更改

手动区块详情：手动 URL 区块 →

在哪里找到 PDF Connect 主题应用扩展​

PDF Connect 主题应用扩展显示在主题编辑器的 应用 部分。请查找：

  • PDF 嵌入式查看器 — 直接在页面中内嵌显示 PDF
  • PDF 按钮 — 显示可点击的按钮，在覆盖层中打开 PDF
  • PDF 嵌入式手动 — 根据手动 URL 设置内嵌显示
  • PDF 按钮手动 — 根据手动 URL 设置以按钮弹窗/列表显示

链接区块适用于所有支持的页面类型。 手动区块目前仅适用于产品模板。

支持的页面类型​

可将 PDF Connect 扩展添加到以下页面模板：

  • 产品页面 — 产品模板编辑器
  • 产品系列页面 — 产品系列模板编辑器
  • 页面 — 页面模板编辑器
  • 博客 — 博客模板编辑器
  • 文章 — 博客文章模板编辑器
  • 首页 — 主页模板编辑器
  • 搜索页面 — 搜索模板编辑器

设置扩展位置​

控制 PDF 的显示位置：

产品页面：

  • 加入购物车按钮上方
  • 独立标签页中
  • 产品描述下方
  • 侧边栏中

产品系列页面：

  • 产品网格上方
  • 系列描述下方
  • 侧边栏中

其他页面：

  • 主内容上方
  • 主内容下方
  • 专属区块中

位置取决于您的主题的板块结构。

一个扩展显示所有已链接的 PDF​

每种页面类型只需添加一个主题应用扩展：

  • 在产品模板中添加 PDF 按钮 扩展
  • 扩展会自动显示每个产品的 PDF
  • 仅显示链接到该具体产品的 PDF
  • 无需为每个产品单独添加扩展
  • 如需排除某个 PDF，请参见按扩展类型控制 PDF 显示 →

同样适用于产品系列、页面和其他资源。

手动区块的行为有所不同：

  • 它们不读取已链接的 PDF
  • 它们只渲染在该区块设置中输入的 URL
  • 它们适用于添加了该区块的整个模板

主题应用扩展设置​

自定义扩展在页面上的显示方式（非 PDF 查看器功能）：

嵌入式查看器扩展：

  • 显示标题（开关）
  • 标题文字
  • 查看器高度（视口百分比，仅桌面端）
  • 显示容器边框

PDF 按钮扩展：

  • 显示标题（开关）
  • 标题文字
  • 按钮文字及文字来源（通用、PDF 名称或描述）
  • 按钮对齐方式（左、居中、右）
  • 按钮文字对齐
  • 多 PDF 布局（纵向或横向）
  • 显示 PDF 图标
  • 显示容器边框
  • 按钮背景色
  • 按钮文字颜色
  • 按钮悬停背景色
  • PDF 查看器弹窗大小（60%、70%、80%、90%）

链接区块： PDF 查看器功能（缩放、下载、工具栏、导航等）在每个 PDF 的应用页面中配置。查看器配置 →

手动区块： 查看器功能在主题编辑器的区块设置中配置。手动区块查看器选项 →

混合显示样式​

您可以在不同页面类型上使用不同的显示样式：

  • 产品页面使用嵌入式查看器
  • 产品系列页面使用按钮显示
  • 首页使用嵌入式

如果您的主题支持多个扩展，也可以在同一页面上混合使用。

不支持主题应用扩展的主题​

较旧或高度自定义的主题可能不支持主题应用扩展：

  1. 检查您的主题是否兼容主题应用扩展
  2. 如需要，更新到更新版本的主题
  3. 联系主题开发者获取支持
  4. 考虑切换到兼容在线商店 2.0 的主题

大多数现代 Shopify 主题（在线商店 2.0）均支持主题应用扩展。

发布前预览​

在正式上线前测试您的设置：

  1. 在主题编辑器中添加扩展
  2. 使用预览功能查看 PDF 显示效果
  3. 试用两种显示样式
  4. 在移动端预览中检查
  5. 根据需要进行调整
  6. 满意后点击 保存

移除扩展​

若要从某种页面类型中移除 PDF 显示：

  1. 前往主题编辑器
  2. 导航到该页面类型
  3. 找到 PDF Connect 扩展
  4. 点击扩展设置
  5. 选择 删除区块
  6. 点击 保存

这将隐藏 PDF 显示，但不会取消链接。

显示问题故障排查​

PDF 未显示：

  • 确认扩展已添加到正确的页面类型
  • 检查 PDF 状态是否为已激活
  • 确认 PDF 已链接到该资源
  • 刷新页面

手动区块无内容：

  • 确保在手动设置中输入了至少一个有效 URL
  • 确认区块已添加到当前激活的产品模板
  • 保存主题并强制刷新

在应用部分找不到扩展：

  • 主题可能不支持主题应用扩展
  • 尝试更新主题
  • 检查主题兼容性（需要在线商店 2.0）

显示了错误的 PDF：

  • 确认您正在查看正确的资源
  • 在 PDF 库中检查链接
  • 检查模板过滤设置（如已使用）

查看完整故障排查指南 →

下一步​