跳到主要内容

手动 URL 区块（产品模板）

手动 URL 区块让您无需在应用中提前链接 PDF，即可在产品模板上显示 PDF。

当您希望在整个产品模板（例如使用 product 或 product.custom 的所有产品）上显示相同的一个或多个 PDF URL 时，请使用此功能。

什么是手动区块​

PDF Connect 提供两种手动产品区块：

  • PDF 嵌入式手动 — 在页面上内嵌显示 PDF
  • PDF 按钮手动 — 显示可点击的按钮以打开 PDF

与链接区块不同，手动区块：

  • 不读取已链接的资源
  • 不读取 PDF 元字段
  • 不需要逐产品链接
  • 仅从 Shopify 主题编辑器的区块设置中渲染

如何添加手动区块​

从应用添加（推荐）​

  1. 在 PDF Connect 中打开某个 PDF 的详情页面
  2. 打开 链接/添加 下拉菜单
  3. 选择 将 PDF 区块添加到产品模板（手动 URL）
  4. 选择：
    • 产品模板（例如 product 或 product.custom）
    • 区块类型（pdf_embedded_manual 或 pdf_button_manual）
  5. 继续打开 Shopify 主题编辑器
  6. 将一个或多个 PDF URL 粘贴到区块设置中
  7. 保存主题

直接在 Shopify 主题编辑器中添加​

  1. 前往 在线商店 > 主题 > 自定义
  2. 打开产品模板
  3. 从 PDF Connect 添加一个应用区块
  4. 选择 PDF 嵌入式手动 或 PDF 按钮手动
  5. 填写 URL/设置并保存

手动区块中的查看器类型​

手动区块支持与链接区块相同的四种查看器类型：

  • 原生浏览器
  • 自定义查看器（PDF.js）
  • 翻页效果
  • 轻量查看器

对于手动区块，查看器行为在区块设置中配置（而非从每个 PDF 保存的应用配置中读取），并且一个区块级别的查看器配置适用于该区块内的所有 URL。

多个 URL 和标签​

  • 以换行分隔方式输入多个 PDF URL。
  • 在按钮手动区块中，标签为可选项，同样以换行分隔。
  • 如果标签数量少于 URL 数量，其余 URL 将回退使用文件名或默认文本。

链接区块与手动区块对比​

类型数据来源最适合
链接区块（pdf_embedded、pdf_button）应用链接 + 元字段按资源分配的 PDF，以及应用内每个 PDF 的查看器配置
手动区块（pdf_embedded_manual、pdf_button_manual）仅主题区块 schema 设置无需链接、模板内全局共享的 PDF

重要限制​

  • 当前版本的手动流程仅支持产品模板（应用早期阶段）。
  • 手动区块的作用范围为模板级别，而非资源级别。
  • 手动区块不会与应用 PDF 库中的 PDF 记录自动同步。

故障排查快速检查​

如果手动区块未显示内容：

  1. 确认已设置至少一个有效的 https:// PDF URL
  2. 确认区块已添加到当前激活的产品模板
  3. 保存主题更改并强制刷新店面
  4. 尝试将查看器类型切换为原生浏览器，以排查查看器特定问题

下一步​