向 Shopify 网站添加评论
FastComments 可在 Shopify 应用商店 获取。安装该应用后，可从 Shopify 主题编辑器将 FastComments 区块拖放到任何博客文章、产品页面或自定义页面上。无需编辑代码。
当您安装该应用时，Shopify 会为您的 FastComments 帐户进行配置，连接您的商店域名，并自动设置计费。您无需单独在 fastcomments.com 注册。
本指南中的页面介绍了应用提供的每个 FastComments 区块、Shopify 客户的单点登录（SSO）如何工作，以及在切换之前如何导入现有的 Shopify 评论。
安装 FastComments 应用 
从 Shopify 应用商店安装
- 打开 FastComments 在 Shopify 应用商店的列表页。
- 点击 添加应用 并在安装流程中选择您想要的方案。
- 安装完成后，Shopify 会在安装完成后将您重定向回 Shopify 内的 FastComments 管理页面。
安装就是这么简单。无需将任何内容粘贴到您的主题文件中。
为您设置了什么
安装会自动完成您本来需要手动执行的所有操作：
- 为您的商店创建一个 FastComments 租户并将其链接到您的商店域名。
- 将您的商店 URL 添加到该租户的授权域名中，这样评论就可以在没有域名错误的情况下加载。
- 写入一个
fastcomments.tenant_idshop metafield，以便每个区块都知道要针对哪个租户进行渲染。 - 默认启用针对您的 Shopify 客户的单点登录。
- 计费通过 Shopify 托管定价运行。费用会显示在您常规的 Shopify 账单中。可在 Shopify 管理后台的 设置 > 应用与销售渠道 > FastComments 中升级、降级或取消。
如果您的商店在安装该应用之前已经是 FastComments 的客户，安装会重用现有租户而不是创建新的租户。
嵌入式管理面板
当您从 Shopify 管理后台打开 FastComments 应用时，您会进入一个包含一键式图块的仪表板，这些图块可以直接进入完整的 FastComments 后端：
- Dashboard：账户设置、使用情况和订阅详情。
- Moderation Queue：在整个商店中批准、拒绝和回复评论。
- Customize：调整小部件颜色、字体、审核规则和配置。
- Ratings & Reviews Helper：如果您想使用 Reviews Summary 区块，可设置星级评分和评论问题。
每个图块都会使用一次性登录链接打开 FastComments，因此您无需单独登录。
下一步：将区块添加到您的商店
打开您的 Shopify 主题编辑器（在线商店 > 主题 > 自定义），打开您想添加评论或评价的模板，然后点击 添加区块。FastComments 区块会显示在 应用 下。本指南的其余部分将介绍每一个区块。
为博客文章和产品添加评论
The FastComments 区块是主要的评论小部件。将其添加到博客文章模板、产品模板或任何其他您希望有讨论线程或实时聊天的页面。
添加该区块
- 打开 Shopify 主题编辑器（在线商店 > 主题 > 自定义）。
- 选择您希望显示评论的模板：博客文章、产品或任何其他页面或区块模板。
- 在您希望显示评论的区块中，点击 添加区块。
- 在 应用 下选择 FastComments。
- 点击 保存。
区块会立即出现。无需输入租户 ID；当您安装应用时，商店的租户会自动连接。
设置
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | 覆盖该区块要渲染的 FastComments 租户。留空以使用商店自动配置的租户。在 fastcomments.com/auth/my-account/api-secret 找到手动租户 ID。 | (空白) |
| SSO | 在发表评论前，自动将访客以其 Shopify 客户账户身份登录。参见 自动登录 Shopify 客户。 | 开启 |
| Commenting Style | 嵌套式 用于嵌套回复和投票，或 实时流 用于实时聊天消息流。 | 嵌套式 |
| Custom URL ID | 覆盖自动检测到的页面标识符。当您希望两个 URL 共享同一评论线程时使用此项。 | (自动检测) |
页面标识符如何选择
每个评论线程由一个 URL ID 键控。该区块会自动选择一个：
- 博客文章模板：
shopify-article-{article.id}，在 slug 和标题更改时仍保持稳定。 - 产品模板：
shopify-product-{product.id}，在 slug 和标题更改时仍保持稳定。 - 其他模板： 请求路径。
如果您设置了 自定义 URL ID，则使用该值。针对多个区块使用相同的自定义 URL ID（例如在产品页面的本地化变体上）可以共享同一评论线程。
嵌套式 与 实时流
嵌套式 是默认设置。访客相互回复、投票，并且审核工具按预期工作。最适合博客文章和产品评论。
实时流 省去嵌套结构，实时显示新评论，就像聊天消息流。最适合产品发布、在线活动和社区页面。
同一页面上的多个区块
该区块可以在同一模板上多次添加。例如，在产品页面顶部显示一个评论摘要，在底部放置一个 FastComments 区块。区块共享 URL ID，因此摘要会反映下方的评论。
提示
- 如果区块在主题编辑器预览中找不到租户，会以黄色通知隐藏自身。如果该提示出现在您的实时商店，请重新安装 FastComments 应用。
- 对于产品页面，FastComments 区块同时可作为您的产品评论小部件。将其与 FastComments - Reviews Summary 配合使用，可在页面顶部显示星级评分摘要。
添加评论计数徽章
The FastComments - Comment Count block 渲染单个页面的小型评论计数。将其用于博客文章列表、产品卡片或任何链接到带有评论的页面的模板，以便访客在点击进入之前即可看到每个主题的活跃程度。
添加区块
- 打开 Shopify 主题编辑器。
- 打开要显示计数的模板。例如，Blog 模板（文章列表）或产品列表部分。
- 在呈现每个项目的部分中点击 Add block。
- 在 Apps 下，选择 FastComments - Comment Count。
- 点击 Save。
设置
| 设置 | 功能 | 默认值 |
|---|---|---|
| 租户 ID（可选） | 覆盖计数读取的 FastComments 租户。留空以使用商店自动配置的租户。 | (空白) |
| 自定义 URL ID | 覆盖计数查找的页面标识符。当计数位于与其跟踪的 FastComments 区块不同的页面时使用此项。 | (自动检测) |
计数如何匹配评论主题
Comment Count block 使用与 FastComments 区块相同的自动检测逻辑：
- 博客文章模板：
shopify-article-{article.id} - 产品模板：
shopify-product-{product.id} - 其他模板：请求路径
如果您在页面上的 FastComments 区块上设置了 Custom URL ID，请在 Comment Count block 上设置相同的 Custom URL ID，以便它们指向相同的主题。
提示
- 页面上每个项目的计数会在一次请求中获取，因此在长列表的每个项目中添加该区块不会产生额外的往返成本。
- 在列表中，每篇文章或每个产品使用一个 Comment Count block 是预期的用法；该区块可根据需要多次添加。
添加最新评论信息流
The FastComments - Recent Comments 区块显示商店内最新的评论。将其用于侧边栏、页脚或主页部分以展示最新活动。
添加此区块
- 打开 Shopify 主题编辑器。
- 打开要放置评论源的模板。侧边栏、主页或博客索引页都很适合。
- 在应包含该区块的部分中点击 Add block。
- 在 Apps 下选择 FastComments - Recent Comments。
- 点击 Save。
设置
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | 覆盖该评论源读取的 FastComments 租户。留空以使用商店自动配置的租户。 | (空白) |
| Number of comments | 要显示的最新评论数量。范围 1 到 50。 | 5 |
提示
- 每条评论都链接到其发布的页面，因此该区块也可作为“当前人们正在讨论什么”的导航提示。
- 此评论源覆盖整个商店。若要显示单个页面的最新评论，请在该页面使用 FastComments 区块。
添加最近讨论信息流
The FastComments - Recent Discussions 区块列出您商店中最近评论活动最多的页面，每页一项。当您希望访客发现活跃的讨论线程而不是单条评论时使用它。
添加区块
- 打开 Shopify 主题编辑器。
- 打开您想放置提要的模板，例如侧边栏、页脚、博客索引或主页区段。
- 在应包含该区块的区段中点击 添加区块。
- 在 应用 下，选择 FastComments - Recent Discussions。
- 点击 保存。
设置
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | 覆盖提要读取的 FastComments 租户。留空以使用商店自动配置的租户。 | (空白) |
| Number of comments | 要显示的最近讨论数量。范围 1 到 50。 | 20 |
最近讨论 vs 最近评论
两个区块都从相同的数据中获取，但展示的是不同的视图：
- 最近评论：按时间平铺显示最新的单条评论。适合用于“刚刚说了什么”。
- 最近讨论：每页一项，按最近活动排序。适合用于“哪些线程正在活跃”。
您可以在同一商店同时使用两者。例如，在博客侧边栏使用 最近评论，在主页使用 最近讨论。
添加热门页面列表
The FastComments - Top Pages block 列出 您 商店 中 总体 评论 活动 最 多 的 页面。 使用 它 来 展示 您 讨论 最 多 的 帖子 或 产品。
Add the block
- 打开 Shopify 主题编辑器。
- 打开 您 想 在 其中 添加 列表 的 模板，例如 侧边栏、页脚 或 博客 索引 区域。
- 在 应 放置 它 的 区段 点击 Add block。
- 在 Apps 下 选择 FastComments - Top Pages。
- 点击 Save。
设置
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | 覆盖 列表 所读取 的 FastComments 租户。 留空以使用商店自动配置的租户。 | (空) |
Top Pages vs Recent Discussions
- Top Pages 按 总互动量 排名，因此 同一篇文章 往往 会 在 顶部 停留 一段时间。 适合 用作 “热门文章” 侧边栏。
- Recent Discussions 按 最近 活动 排序，因此 列表 变化 频繁。 适合 用作 “当前最热” 面板。
添加评价摘要
The FastComments - 评论摘要 区块显示页面的聚合星级评分和评论细分。将其与产品模板上的 FastComments 区块配对以获得标准的评论布局：顶部摘要，下面是评论表单和评论列表。
前提条件：设置 评分与评论
评论摘要区块会显示您为商店配置的评分问题。请先进行以下设置：
- 在 Shopify 管理后台打开 FastComments 应用。
- 点击 评分与评论助手 磁贴（或直接打开 评分与评论助手）。
- 添加您希望每位评论者回答的问题（总体星级评分、“尺码如何”等）。
如果未配置问题，摘要区块将没有可聚合的数据。
添加区块
- 打开 Shopify 主题编辑器。
- 打开 Product 模板（或您希望放置摘要的页面模板）。
- 在页面区段顶部靠近 FastComments 区块上方点击 添加区块。
- 在 应用 下，选择 FastComments - 评论摘要。
- 如果尚未添加，请在同一页面稍下方添加一个 FastComments 区块，以便访客可以留下评论。
- 点击 保存。
设置
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | 覆盖摘要读取的 FastComments 租户。留空以使用商店自动配置的租户。 | (blank) |
| Custom URL ID | 覆盖摘要用于聚合的页面标识符。当摘要位于与其所反映的 FastComments 区块不同的页面上时使用此项。 | (auto-detected) |
摘要如何与评论匹配
评论摘要区块使用与 FastComments 区块相同的自动检测逻辑：
- 产品模板：
shopify-product-{product.id} - 博客文章模板：
shopify-article-{article.id} - 其他模板：请求路径
对于普通的产品页面，摘要和评论线程会自动共享 URL ID，无需任何配置。
提示
- 摘要为只读。要收集评论，您需要在同一页面上放置一个 FastComments 区块。
- 如果在收集评论后在 评分与评论助手 中更改评分问题，摘要会根据新的问题集重新计算。
自动登录 Shopify 客户
The FastComments 区块支持单点登录，这样您的 Shopify 客户可以以自己的身份发表评论，而无需创建单独的 FastComments 帐户。
工作原理
当已登录您商店的访客打开包含 FastComments 区块的页面时：
- 该区块检测到 Shopify 的
customer对象。 - 它通过签名的应用代理请求将客户的姓名和电子邮件发送到 FastComments。
- FastComments 创建或匹配一个以
shopify-{customerId}为键的用户，因此相同的客户在不同会话和重新安装后始终映射到相同的 FastComments 用户。 - 访客的姓名会显示在他们的评论中。他们不会被再次提示登录。
如果访客未登录商店，区块将回退为匿名评论（或 FastComments 的登录流程，取决于您的小部件配置）。
关闭 SSO
对于每个 FastComments 区块，SSO 默认处于开启状态。要在特定区块上将其关闭：
- 打开 Shopify 主题编辑器。
- 打开包含该区块的模板并单击该区块以选中它。
- 取消选中 SSO。
- 点击 保存。
如果您希望评论者为对话选择不同的身份，请关闭 SSO。例如，内部社区页面上工作人员以不同的显示名发表评论的情况。
FastComments 所接收的内容
为每个客户发送的 SSO 有效载荷包含：
- 一个由 Shopify 客户 ID 派生的用户 ID（
shopify-{customerId}）。 - 客户的电子邮件（用于识别用户；不会公开显示）。
- 客户的显示名称（用于作为他们的评论作者名称）。
不会发送订单历史、支付或地址数据。该有效载荷在服务器端签名；客户的浏览器永远看不到凭证。
登录和登出链接
当 SSO 开启时，评论小部件的登录和登出链接指向标准的 Shopify 客户帐户路由 /account/login 和 /account/logout。无需任何配置。对于启用了客户帐户的任何商店，这些链接都能正常工作。
导入现有评论
如果您在 Shopify 博客文章上已有评论并希望保留它们，请在禁用 Shopify 原生评论之前将它们导入 FastComments。
导入必须在 Shopify 原生评论仍处于启用且可见时运行。一旦您禁用它们，FastComments 将无法再读取它们。
如何开始导入
- 确保 FastComments 应用已安装在您的商店中。
- 暂时保持 Shopify 原生评论 启用。
- 提交支持工单 并告知我们要导入哪些博客。
导入将在一天内完成。
一旦您现有的评论被导入到 FastComments，把 FastComments 模块添加到您的博客文章模板中，并移除或禁用 Shopify 原生评论。参见 为博客文章和产品添加评论。
如果您不需要保留现有评论，可以跳过此页面。
自定义
颜色、字体、审核规则、允许的 HTML 以及匿名评论均可配置，以匹配您商店的品牌风格。
在您的 Shopify 管理后台打开 FastComments 应用并点击 自定义 磁贴以打开小部件自定义屏幕。它使用一次性登录链接，因此无需单独登录。
有关完整的自定义选项列表，请参阅 自定义与配置指南。
域名错误
如果您是通过 Shopify 应用商店安装 FastComments，您的商店域名会自动添加到租户的授权域名中，您不应该看到域名错误。本页面适用于您通过手动安装路径安装的情况，或当您的店面使用在应用安装时未在 Shopify 注册的自定义域名时。
您可能会遇到如下所示的授权错误：
这意味着 FastComments 未将小部件加载所在的域识别为您租户的授权域名。
要修复此问题，请将该域添加到您的 FastComments 帐户： 配置域名.
手动安装（高级）
如果您无法安装 Shopify 应用商店 应用，仍然可以通过编辑主题来添加 FastComments。当您想连接您已有的 FastComments 租户，或在应用不可用的 Shopify 商店前端进行嵌入时，此路径很有用。
基于应用的安装是大多数商店的受支持方式。只有在应用不合适时才采用此方法。
步骤 1：禁用 Shopify 的原生评论
在 Shopify 管理后台，转到 博客文章 > 管理博客，打开每个博客，并在右侧面板中将 Comments are disabled 设置为已禁用。保存。
这将阻止 Shopify 的内置评论与 FastComments 一起显示。
步骤 2：打开博客主题模板
在 Shopify 管理后台：
- 转到 在线商店 > 主题。
- 在当前主题下，点击 操作 > 编辑代码。
- 在左侧的文件浏览器中，打开 Sections 并点击
main-article.liquid。
这是 Shopify 用于渲染单个博客文章的模板。
步骤 3：粘贴 FastComments 代码片段
滚动到 main-article.liquid 的大约第 100 行，就在文章主体的 </div> 关闭标签之后。粘贴以下片段：
Replace "demo" with your own Tenant ID from fastcomments.com/auth/my-account/api-secret. Click Save.
步骤 4：授权您的商店域名
在您的在线商店打开一篇博客文章。如果您看到的是授权错误而不是评论小部件，说明 FastComments 需要知道您的商店被允许使用此租户。参见 域名错误。
将 FastComments 添加到其他页面
相同的片段适用于任何 Liquid 模板，包括产品页面、自定义页面以及主页。将其粘贴到希望显示评论的位置，并在每页需要稳定标识符时调整 urlId（例如，在产品模板上使用 urlId: "{{ product.id }}"）。