自定义与配置
自定义与配置
背景
在这里，您将找到有关评论小部件所支持的每个功能和设置的深入文档。
本档将涵盖核心概念，并深入探讨每个功能领域，包含操作指南和常见陷阱。
将提供代码示例，并突出显示相关行。必要时还会提供配置页面的截图。
代码示例将使用我们的纯 JavaScript 库，但配置选项在所有版本的评论小部件（React、Vue 等）中使用完全相同的名称。
本指南中概述的大多数配置和功能无需编写任何代码。
识别您的账户 
您可能会注意到，评论小部件可以使用 Tenant ID 为 "demo"，例如：
Run 
这仅用于试用和玩转评论小部件。在生产环境中，您应传入您的 Tenant ID，如下所示：
Run 您可以在评论小部件的 账户代码片段 中找到已应用的 Tenant ID。
还可以在 API 凭证页面 找到您的 Tenant ID 并管理您的 API 密钥。
从此之后，如果您已登录 FastComments，代码示例将使用您的真实 Tenant ID（如果您在 https://fastcomments.com 上已登录）。
评论如何关联到页面和文章
在渲染评论线程或留下评论时，FastComments 需要知道这些评论属于哪个页面、文章或产品。
为此，我们使用一种称为 “URL ID” 的标识。它可以是标识符（如字符串或数字），也可以是一个 URL。
默认情况下，如果未指定 urlId，它将使用页面的 URL。我们会获取当前页面的 URL，并清除其中的常见营销参数或跟踪标识符。
在第三方集成（如 WordPress）的情况下，我们的插件通常会使用代表当前查看信息的标识符作为 URL ID，例如文章/页面的 ID。
Run 本文档中我们经常会提到 小部件自定义 UI。
该 UI 可用于在无需编写代码的情况下对评论小部件进行多种更改。
创建自定义规则时，我们通常希望它适用于站点的所有页面。然而，在某些情况下，我们希望对特定页面的评论小部件进行自定义，例如应用自定义样式，或将该页面的评论设为匿名。您也可以例如让某些页面的实时评论立即显示，而在其他页面则通过通知按钮隐藏。
这全部可以通过此页面上的 URL ID 输入字段实现，示例如下：
此字段的值应与传入评论小部件的 urlId 参数匹配。如果希望自定义规则对 urlId 不敏感，请将此字段留空或输入 *。
自 2023 年起，widget 自定义中的 URL ID 字段也支持模式！例如，您可以使用 */blog/* 为博客添加特定样式，使用 */store/* 为商店添加特定样式，且仍使用同一域名。
注意事项
- 如果您的页面包含哈希参数（如 example.com#page-1），默认情况下它们会成为 URL ID 的一部分。
- 在迁移期间，例如从 WordPress 迁移到 Gatsby，您可能需要在初始迁移后迁移 URL ID 评论值。为此，请联系我们。
在不同页面渲染相同的评论
由于 urlId 参数允许我们定义评论所绑定的页面或 id，我们只需在这些页面上将 urlId 设置为相同的值。
Run 自定义样式
FastComments 旨在实现高度自定义。出于安全考虑，评论小部件本身运行在 iframe 中，因此要应用自定义样式，需要遵循以下两种方法之一。
第一种，也是我们首选且最简便的方法，是使用小部件自定义页面。
在小部件自定义页面，查看 “显示高级选项” 部分，其中有一个标记为 “自定义 CSS” 的区域：
此方法有以下优势：
- 输入的 CSS 在发送给用户之前会被压缩，编辑 UI 中的格式保持一致。
- 您可以获得小部件自定义 UI 的全部好处，例如可以为不同站点轻松定制评论小部件。
- 当我们对评论小部件进行更改时，您的自定义样式将作为我们发布流程的一部分进行测试。
第二种方法是通过小部件配置中的 customCSS 参数指定，如下所示：
Run 然而，这种方式有 限制：
- 由于请求头的大小限制，传递的自定义 CSS 有上限，超过后我们的服务器会拒绝请求。
- 您必须在自己的基础设施和构建系统中管理自定义 CSS。这有时也可能是一个优势。
- 在此使用场景下，网络上会 两次 发送自定义 CSS：一次发送到我们的服务器，随后再返回到 iframe 内容中。不过对于大多数负载大小，这几乎感觉不到。
- 常见的优化是对 CSS 进行压缩以减小网络传输大小，但使用此方法时您需要自行处理。
- 当我们进行更改时，您的自定义 CSS 将不会被测试。
外部 CSS 文件
您可以使用 @import 让小部件加载外部文件！
建议将 @import 放在自定义规则中。这样，如果我们需要对评论小部件进行更改，就可以使用自动化工具验证您的设置。例如，您可以在“小部件自定义 UI” 中创建一条自定义规则，点击 高级，并在 自定义 CSS 中输入：
@import url(https://example.com/styles.css);在代码中 - 不推荐
您也可以通过 customCSS 属性加载外部 CSS 文件：
Run 但请记住，如果这样做，您的 CSS 将无法由我们进行测试。
用户资料模态框样式
用户资料模态框也可以使用自定义 CSS 进行样式化。不过，为确保自定义样式能够应用于用户资料，所有 CSS 选择器必须以 .user-profile 为前缀。没有此前缀，自定义样式将被忽略。
例如：
Run 向后兼容性
在 FastComments，我们知道客户会自定义评论小部件。这本就是设计初衷——我们最不希望的是我们的产品导致您产品的设计不一致。
由于这是我们产品的重要组成部分，我们拥有一条构建流水线，能够在每次发布时对评论小部件的每位客户的更改进行审查。
如果我们发现小问题，会更新您的账户以确保发布顺利进行。如果出现重大破坏性更改，这将使我们能够暂停发布。
自定义字体
FastComments 设计用于可定制，我们小部件使用的字体也不例外。
默认情况下，FastComments 使用 system font stack，以便在各种设备上尽可能呈现良好外观。
要定义您自己的字体，请参阅 自定义 CSS 文档。
在那里您会找到定义自定义 CSS 的方法，从而允许您设置所需的字体。
如何定义字体
要覆盖字体，我们建议使用 .fast-comments, textarea 选择器来定义您的 CSS。例如：
Run 移除品牌标识
对于 Pro 或 Enterprise 账户的客户，允许使用白标。只需 联系我们，我们将很乐意提供帮助。
如果您只是想从评论小部件中移除我们的徽标，这在 Flex 和 Pro 计划中会自动启用。
这些计划也为从我们平台发送的电子邮件提供相同的功能。
支持深色背景（暗模式）
默认情况下，FastComments 评论组件会在大多数网站上自动检测深色模式。
检测到深色模式时，FastComments 会将黑色文字/白色背景切换为黑色背景/白色文字。图像也会随之改变。
在页面加载时，组件会尝试判断评论组件背后页面背景的明暗程度。这意味着 页面可能是白色背景，但如果你将评论组件放在一个黑色背景的容器内，深色模式仍然应该 会自动启用以确保评论可读。
不过，依赖于“亮度”判断的检测机制可能不会在你期望的时候启用深色模式。要强制启用它，请将 hasDarkBackground 标志设置为 true，如下所示：
Run 切换暗模式
对于允许在初始页面加载后切换深色模式的网站，这会稍微复杂一些。
首先，评论小部件库的所有当前版本（React、Vue）在它们各自的代码仓库中都有切换深色模式的示例。
对于 VanillaJS 小部件，我们需要做更多工作。首先，FastCommentsUI 返回一个包含函数 "destroy" 和 "update" 的对象。
我们可以在每次想要更新评论小部件配置时简单地调用 update 函数，如下所示。下面是使用 VanillaJS 小部件切换深色模式的完整可运行示例。
Run 覆盖文本
使用 FastComments，评论小部件中的所有文本均可自定义。
您可以覆盖单个文本，例如提交按钮，或覆盖整个评论小部件中的所有文本。
默认情况下，评论小部件中的文本会根据用户的语言环境进行翻译。不过，如果我们确信用户群使用相同的地区/语言，例如：
Run 所有可自定义的翻译可在此处的“高级选项”标签下找到。
然而，还有一种更简便的方法，即通过小部件自定义 UI。在那里，我们可以直接找到 EN_US 语言环境下评论小部件中显示的文本，并指定替换内容。
所有翻译覆盖目前会影响所有语言环境。
这仅涉及小部件自身的文本。若要翻译访客撰写的评论，请参阅Comment Translation。
更改默认头像
当用户首次使用 FastComments 发表评论时，我们会尝试从 https://gravatar.com/ 获取他们的头像。
但是，如果未找到头像，或用户从未在其账户中设置头像，我们将显示一个静态的默认头像图像。
要指定您自己的静态头像图像，可以使用 defaultAvatarSrc 设置。
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面中，查看 “默认头像” 部分。
请注意，为特定用户（例如使用 SSO）定义头像的内容在其单独的章节中说明。
禁用头像
头像可以完全从评论小部件中移除，即使用户已经设置了自己的头像。
Run 这可以在小部件自定义页面上无需代码进行设置：
禁用所有默认样式
对于更大的自定义样式项目，可能希望从零开始，不使用任何默认样式。
通过将 noStyles 参数设置为 true 可以移除所有默认样式，如下所示：
Run 这可以在小部件自定义页面的高级选项下，无需编写代码即可进行自定义：
从评论链接到页面
发送通知邮件，或在像审核页面这样的用户界面中呈现评论时，能够将链接 从评论指向其所在页面会很有帮助。
如果 URL ID 不总是一个 ID，那么我们必须在别处存储 URL。这就是 "url" 属性的用途，定义如下。
Run 一个常见用例是将评论线程绑定到一个标识符（例如文章），然后链接回特定页面，例如：
Run URL 不会去除常见的营销参数。默认情况下，当前页面的 URL 即为随评论存储的 URL。
默认折叠回复
默认情况下，顶层评论的回复会显示。
可以将其配置为用户必须点击顶层评论上的“Show Replies”才能查看子评论。
Run 这可以在小部件自定义页面上无需代码进行自定义：
此设置不会影响最初加载的顶层评论数量。如果您有一个顶层评论以及 29 条子评论，启用此设置后，您将：
- 看到该顶层评论。
- 在该评论下看到“Show Replies (29)”。
如果您希望在使用此选项的同时显示所有顶层评论，请将起始页设为 -1设置为。
启用所见即所得编辑器
默认情况下，FastComments 的格式化功能是通过在文本周围添加可见的锚标签，如 <b></b> 来实现的。点击工具栏
或使用快捷键会为您完成此操作。然而，某些社区可能希望使用不带锚标签的格式化。这称为启用
WYSIWYG（所见即所得）编辑器。该编辑器看起来与默认编辑器完全相同，只是加载了一些
额外的代码，使用户能够在不使用可见锚标签的情况下加粗、下划线等其文本。
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面，查看“启用高级格式化”选项。
禁用工具栏
默认情况下，FastComments 在撰写评论时会显示工具栏，以提供装饰文本和上传图片的快捷方式。
此工具栏可以通过代码或自定义 UI 来禁用。
Run 这也可以在不使用代码的情况下完成。在小部件自定义页面中，查看 “Disable The Reply Toolbar” 选项。
禁用屏蔽
默认情况下，FastComments 允许用户阻止其他用户。阻止用户会导致其评论被屏蔽，阻止用户之间的通知等。
可能需要禁用此功能。可以这样做：
Run 这也可以在不编写代码的情况下完成，通过小部件自定义 UI 同时实现正确的服务器端验证：
确定要渲染的页面
在获取和渲染评论时，评论组件需要知道从哪一页开始。默认情况下，它从 第一页开始，只渲染该页。
如果需要，可以将要渲染的确切页码作为设置 startingPage 传递给评论组件。
Run 请注意，页码从零开始，因此上例渲染的是第二页。
在不重新加载页面的情况下切换评论线程
我们已经讲过 urlId 是评论所绑定的页面或文章的 id。
另外，回顾一下，如果未定义，urlId 将默认为当前页面的 URL。
对于 SPA（Single-Page-Applications，单页应用），当评论所绑定的页面或内容在不重新加载页面的情况下动态改变时，该怎么办？
Angular、React、Vue 等
使用我们的库（例如 Angular 和 React），只需更新传递给组件的 urlId 属性即可使评论组件刷新。例如，你可以在 React 应用中看到实际效果，这里。
VanillaJS
如果使用 VanillaJS 库，情况会稍微复杂一些，因为没有像 Angular 或 React 这样的框架来处理数据绑定或状态传播。
当你实例化 VanillaJS 小部件时，它会返回一些可用于更新小部件的函数。
下面是一个实际的示例，我们在其中更改页面哈希并更新评论小部件：
Run 绝对日期（禁用人性化时间戳）
默认情况下，使用本地化的相对日期。例如，在最近留下的评论旁边，你可能会看到“11 分钟前”。
可能需要或希望使用绝对日期，在这种情况下，你需要将此参数设置为 true。
Run 这可以在无需代码的情况下进行自定义，前往小部件自定义页面的“高级选项”。:
同时显示绝对和相对日期
默认情况下，使用本地化的相对日期。例如，在最近留下的评论旁边，你可能会看到“11 分钟前”。
可能需要或希望保留此相对日期格式，同时在旁边显示完整日期，在这种情况下，你需要将此参数设置为 true。
Run 这可以在无需代码的情况下进行自定义，位于小部件自定义页面的“高级选项”下。你需要先启用绝对日期才能在 UI 中看到此选项。
添加页眉文字
一些文本，例如标题或消息，可以渲染在评论计数下方但登录状态文本上方。
我们称之为标题，默认情况下它是隐藏的。
Run 这可以在无需代码的情况下进行自定义，位于小部件自定义页面的高级选项下：
将链接渲染为文本
默认情况下，FastComments 会将链接渲染为如下形式： https://exmaple.com - 其中链接 URL 会变成可点击的 HTML 锚点标签。
某些站点可能希望禁用此功能，例如以防止诈骗者。我们通过将 Comment HTML Rendering Option 设置为 Links as Text 来实现此功能。
此设置可在无需编写代码的情况下进行自定义，可在小部件自定义页面上针对整个域或单个页面进行设置：
使用按钮切换评论显示
默认情况下，FastComments 会同时渲染评论输入框和评论线程。为了节省垂直空间， 它还会隐藏所有其他必填字段，直到用户与小部件交互。
然而，评论小部件可以隐藏在按钮后面，例如：
按钮会根据当前是否显示评论而使用不同的翻译文本。如果评论被隐藏，它使用 translations.SHOW_COMMENTS_BUTTON_TEXT。如果
评论已显示，它使用 translations.HIDE_COMMENTS_BUTTON_TEXT。这些翻译文本可以包含 [count]，该占位符将在本地化计数时被替换。
Run 这旨在取代 hideCommentsUnderCountTextFormat 配置。
计数会随评论线程实时更新。如果没有评论，按钮将不会显示。
可以通过创建自定义规则并启用“Click to Show Comments”来在无需代码的情况下启用此功能：
自定义评论计数文字
在评论小部件顶部显示的评论计数可以自定义。
这可以替换为任意字符串，且值 [count] 将被替换为计数值，并为用户本地化。
Run 这可以在无需代码的情况下，通过小部件自定义页面进行自定义：
![小部件自定义页面上的评论计数字段，其中 [count] 将被替换为实时总数](/images/b949308d5121619af7a4e61c61d2cf1c.png)
禁用图片重定向
默认情况下，FastComments 允许用户上传图片。 当用户点击该图片时，FastComments 默认会， 在新标签页中打开该图片以全尺寸显示。将此标志设为 true 会禁用此行为：
Run 如果您不打算自己捕获图片点击事件（参见 onImageClicked），我们建议同时使用一些样式来去除图片看起来可点击的效果。
禁用自动标签创建
当用户输入标签（形式为 #someexampletag），FastComments 会自动创建该 HashTag 并在他们的评论中高亮显示。
在某些情况下，可能需要禁用此功能，或通过 API 控制可以使用的标签。
为此，只需在小部件自定义 UI 中启用 Disable Automatic #hashtag Creation。
禁用通知铃
默认情况下，FastComments 会在评论区域的右上角显示一个通知铃。
该铃会变红并显示用户拥有的通知数量。一些示例通知包括：
- 用户回复了您。
- 用户在您参与的线程中回复。
- 用户给您的评论点了赞。
- 用户回复了您订阅的页面。
通知铃还提供了订阅整个页面的机制。
但是，我们可以完全禁用通知铃：
Run 这也可以在不写代码的情况下完成。在小部件自定义页面，查看“禁用通知铃”部分。
禁用个人资料
默认情况下，FastComments 会在您点击用户头像时显示该用户的个人资料。
但是，我们可以禁用此功能：
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面，查看“禁用个人资料”部分。
禁用个人资料评论
默认情况下，FastComments 会在用户个人资料上显示一个“个人资料评论”标签页，允许访客在某人的个人资料上留下评论。
但是，我们可以禁用此标签页：
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面中，查看“禁用个人资料评论”部分。
禁用个人资料私信
默认情况下，FastComments 会在用户个人资料上显示一个“直接消息”标签，允许访客向用户发送直接消息。
但是，我们可以禁用此标签：
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面中，查看“禁用直接消息”部分。
禁用成功信息
默认情况下，FastComments 在评论后会显示成功消息。可以按以下方式禁用它：
Run 这也可以在不使用代码的情况下完成。在小部件自定义页面：
更改 GIF 内容评级
默认情况下，FastComments 评论小部件会将 gif rating 设置为 pg。
可用的选项有 g、pg、pg-13 和 r。
可以在代码中或通过 UI 设置。代码中可以这样做：
Run 在 UI 中，只要未选中 Disable Image Uploads?，您可以在 Gif Picker Rating 下找到它。
图片内容审核
默认情况下，FastComments 评论小部件的图像内容审核已关闭 off。
可用的选项有 off、low、medium 和 high。
在小部件自定义 UI 中，只要未勾选 Disable Image Uploads?，您可以在 Image Content Moderation Level 下找到此设置。
更改投票样式
默认情况下，FastComments 会将投票选项渲染为向上和向下的箭头，允许用户对评论进行赞成或反对投票。
但是，可以更改投票工具栏的样式。当前的选项是默认的上下按钮，或使用心形投票机制。
我们使用 voteStyle 标志如下：
Run 我们强烈建议您在不使用代码的情况下完成此操作，因为它还会启用服务器端验证。在小部件自定义页面，参见 “Vote Style” 部分。
投票也可以被禁用，请参见样式选项上方的 Disable Voting。
禁用删除
默认情况下，FastComments 允许用户删除他们的评论。
但是，可以阻止此操作。
在小部件自定义页面，查看 "Disable Deleting" 选项。
- 这仅影响普通评论者，而不影响版主或管理员，后者仍然可以删除。
- 当传递
contextUserId时，这也会影响 API 集成。
禁用编辑
默认情况下，FastComments 允许用户编辑他们的评论。
但是，可以阻止此操作。
在小部件自定义页面，查看 “禁用编辑” 选项。
- 这仅影响普通评论者，而不影响版主或管理员，后者仍然可以编辑。
- 当传递
contextUserId时，这也会影响 API 集成。
高亮新评论
FastComments 提供多种方式来突出显示新评论。
首先且最重要的是，默认情况下，会触发应用内通知的评论（回复、同一线程中的回复，或你订阅的页面
上的评论），会自动突出显示，用户头像会略微发光。颜色可以通过 CSS
使用 is-unread 类进行自定义。
在过去 24 小时内发布的评论会应用 24hr 类，可用于样式化。
最后，任何在用户会话中出现的新实时评论会通过动画高亮显示数秒。这是通过
is-live CSS 类实现的，也可以自定义。
页面大小
默认情况下，FastComments 的页面大小为 30。这包括线程中的回复。
页面大小可以在 Widget Configuration UI 中自定义，范围从 10 到 200。
请注意，修改页面大小需要重新计算您账户中的所有评论线程。这可能需要几分钟。
由于页面在服务器端计算，无法在客户端小部件中进行配置。
下面显示了示例配置：
页面大小可以通过创建不同的自定义规则全局、按域或按页面进行自定义。
这将影响您通过我们的平台显示评论时使用的所有客户端、集成和框架。
电子邮件模板
FastComments 发送给您的客户的电子邮件可以自定义。模板、逻辑、 和翻译都可以更改。文本可以按语言/区域定制，样式 甚至可以按域名更改。 在此了解有关自定义电子邮件模板的更多信息。
用户名格式
默认情况下，FastComments 会显示用户输入的名称，或通过 SSO 传递给我们的名称。
然而，可能需要以不同的方式掩码或显示用户的名称。例如，如果用户的名称是 Allen Rex，您可能只想显示 “Allen R.”。
这可以在 Widget Customization UI 中无需编写代码完成，位于名为 Commenter Name Format 的设置下：
可用的格式有：
- Capitalize（将示例用户显示为 Example User）
- Last Initial（将 Example User 显示为 Example U.）
- All Initials（将 Example User 显示为 E. U.）
- 显示 “Anonymous”
更改此设置的效果是即时的。用户仍会在评论区域顶部看到自己的完整用户名，但他们的评论将显示修改后的用户名。
用户名在服务器端被掩码，以保护用户。
禁用图片上传
默认情况下，FastComments 允许上传图片。可以通过将 noImageUploads 标志设置为 true 来禁用此功能。
Run 可以在小部件自定义页面上无需代码进行自定义：
允许媒体嵌入
默认情况下，FastComments 不允许在评论中使用 iframe。当您启用媒体嵌入时，评论者可以粘贴来自受信任提供商（如 YouTube、Vimeo、SoundCloud 和 Spotify）的嵌入代码（<iframe> 代码片段），它将在评论中内联渲染。
出于安全考虑，这不是客户端小部件配置标志，而是服务器端设置，在每条评论保存时进行验证，因此无法从页面上打开。仅允许指向内置受信任提供商列表的 iframe。任何其他 iframe 都会被移除。
这可以在小部件自定义页面上无需代码完成：
添加您自己的提供商
如果您想允许来自未列入内置受信任列表的提供商的嵌入，请在同一页面的 "Additional Embed Domains" 字段中添加其主机名。这些主机名将在内置提供商之外被允许。匹配是精确的，因此请包含完整的主机名（例如，player.example.com）。未列出的任何内容都将被阻止。
普通评论框和 WYSIWYG 编辑器都支持粘贴嵌入。在 WYSIWYG 编辑器中，嵌入会作为可移除的块插入。
启用搜索框
默认情况下，评论小部件中不显示搜索框。
但是，我们可以通过将 enableSearch 标志设置为 true 来打开它：
Run 这也可以不使用代码完成。在小部件自定义页面，查看“Enable Search Box”选项。
启用剧透
我们可以通过将 enableSpoilers 标志设置为 true 来启用剧透支持：
Run 这也可以在不编写代码的情况下完成。在小部件自定义页面中，请参阅“Enable Spoilers”选项。
当文本被选中并点击此时可见的 SPOILER 按钮后，文本将被遮蔽，直到用户将鼠标悬停在上面。在深色模式下我们采用相同的处理方式，但使用更适合深色模式的不同颜色。
这也与所见即所得（WYSIWYG）编辑器兼容。
启用评论浏览计数
默认情况下，FastComments 不会跟踪谁查看了每条评论，也不会提供任何相关统计。
但是，我们可以启用此功能，系统随后将在每位用户滚动到评论时开始进行跟踪。
当发生这种情况时，每条评论旁边的眼睛图标旁的计数会递增。计数会实时更新，并根据用户的语言环境进行缩写。
我们可以通过将 enableViewCounts 标志设置为 true 来启用此功能：
Run 这可以在无需代码的情况下，通过小部件自定义页面进行设置：
我们会跟踪查看评论的用户 ID*，保留一周时间，这样如果您在一周内再次查看该评论，计数不会递增。若在一周后再次查看，计数将再次递增。
- *注意：也可以是匿名会话 ID，或用户的 IP（哈希值）。
立即显示实时评论
默认情况下，实时评论已启用。这意味着如果有任何评论被添加、删除、编辑或置顶，所有正在查看该评论线程的用户都会同时看到这些更改。
然而，默认情况下，这些新评论会出现在一个动态显示的按钮下，按钮文本类似于“显示 2 条新评论”。
如果新评论是直接回复页面的，按钮会显示在评论线程的顶部。如果它们是对特定评论的回复，按钮则会显示在该评论下方。
这样做是为了防止页面大小不断变化，避免用户在尝试抓取滚动条时产生挫败感。
对于某些使用场景，例如实时竞标或在线活动，这并不是期望的行为——您可能希望评论小部件更像一个“聊天”框，新评论能够“立即显示”。
因此，启用此功能的标志名称为：showLiveRightAway。
我们可以按如下方式打开它：
Run 这可以在小部件自定义页面上无需代码进行自定义：
禁用实时评论
默认情况下，FastComments 将启用实时评论。
这意味着评论线程的每个观看者都应看到相同的内容。
例如，如果添加了一条评论，该评论应显示。如果评论被编辑或删除， 则这些评论会对线程的所有观看者进行相应的编辑或删除。投票以及所有的审核操作也是如此。
但是，我们可以禁用此功能：
Run 这也可以在不使用代码的情况下完成。在小部件自定义页面，查看“禁用实时评论”部分。
新实时评论显示在底部
默认情况下，实时发布的新评论会出现在评论列表的顶部。
启用此选项后，实时发布的新评论将改为添加到列表底部。这会影响用户在查看评论线程时实时发布的评论的显示位置。
Run 启用此设置后：
- 其他用户实时发布的新评论将出现在评论列表的底部
- 用户将在实时中看到新评论出现在现有评论之下
- 这只影响实时评论更新 - 不影响初始页面加载
- 当用户跟随讨论时，这有助于保持阅读流畅性
请注意，此设置仅影响实时到达的新评论的放置位置。它不会影响页面加载时的初始排序顺序。
启用无限滚动
默认情况下，FastComments 小部件会按垂直方向调整大小以适应所有可见评论。分页通过当前页面末尾的 "View Next" 按钮实现，因为我们发现这种交互对大多数用户来说是最为舒适的。
但是，在某些情况下更偏好使用无限滚动。例如，我们在 Stream Chat 产品中使用此功能。
我们可以通过将 enableInfiniteScrolling 标志设置为 true 来隐藏 "View Next" 按钮并切换到无限滚动：
Run 这还需要添加自定义 CSS。为 .comments 选择器添加自定义 CSS 以启用滚动，例如：
Run 下面是一个完整的工作示例：
Run 在上例中我们使用了 customCSS 属性，但出于性能原因，建议改为使用 Widget Configuration UI。 查看自定义 CSS 文档。
更改默认排序方向
默认情况下，FastComments 会按“最相关”排序方向对评论进行排序。
“最相关”排序会考虑评论留下的时间以及投票数量来进行排序。
用户随后可以在评论小部件 UI 中将排序方向更改为“最旧”或“最新”。
但是，我们可以将默认值更改为这三种之一。例如，如果您想先显示最旧的评论：
Run 我们将 defaultSortDirection 的值设置为 “OF”，以将方向设为 “OF”。
对于“最新优先”排序方向，我们可以这样做：
Run defaultSortDirection 的有效值包括：
- MR: “最近”
- NF: “最新优先”
- OF: “最旧优先”
这也可以在不编写代码的情况下完成。在小部件自定义页面中，查看“默认排序方向”部分。
请注意，每个页面针对每种排序方向的评论都是预先计算好的，因此所有排序方向的性能相同。
一次渲染所有评论 - 禁用分页
要禁用分页，并一次性渲染所有评论，请将 startingPage 设置为 -1。
Run 将回复框移动到评论之后
默认情况下，评论输入区域位于评论线程的前面。但是，通过将此配置参数设置为 true，我们可以将其移动到后面。
Run 这可以在小部件自定义页面上无需代码进行自定义：
限制评论长度
评论输入字段允许输入的最大字符数可以通过 maxCommentCharacterLength 参数进行限制。
默认值为 2000。
类似图片 URL 的内容不计入字符长度的计算。
Run 这可以在小部件自定义页面上无需代码进行设置：
禁用多行评论
默认情况下，FastComments 会允许用户输入任意行数的评论，直至默认字符限制。
然而，可能需要限制用户只能输入单行文本。示例用例包括在线竞标或实时聊天，FastComments 可用于这些场景。
我们按如下方式启用 useSingleLineCommentInput 标志：
Run 这也可以不通过代码实现。在小部件自定义页面，查看 “Enable Single-Line Comment Input” 部分。
请注意，每个页面的每个排序方向的评论都是预先计算的，因此所有排序方向的性能相同。
限制每用户的评论数量
默认情况下，每个用户在同一分钟内最多可以提交 5 comments。
这通过用户 ID、匿名用户 ID 和 IP 地址（已哈希）进行跟踪。
这可以在小部件自定义页面上无需代码进行自定义：
注意，如果您使用评论创建 API，可能需要在请求中向我们的后端传递用户的原始 ip 地址，以便对每个用户进行速率限制，已应用
于每个用户，而不是对您的账户全局限制。
阻止新的顶级评论
将 noNewRootComments 设置为 true 会导致小部件隐藏顶层回复区域，但仍允许用户回复
子评论。你可以例如在页面加载时有条件地设置此项，只允许某些用户留下顶级评论。
Run 最大回复深度
默认情况下，FastComments 允许无限层级的回复嵌套，形成用户可以无限回复回复的线程结构。
maxReplyDepth 选项允许您限制回复线程的最大深度。当达到最大深度时，用户将不再能在该层级的评论上看到回复按钮。
Run 将 maxReplyDepth 设置为 2 时：
- 用户可以在顶层发表评论（深度 0）
- 用户可以回复顶层评论（深度 1）
- 用户可以回复这些回复（深度 2）
- 超过深度 2 后不允许再回复
设置为 1 则只允许回复顶层评论，形成更扁平的讨论结构。
将 maxReplyDepth 设置为 0 将禁用所有回复，只允许顶层评论。如果未指定，回复可以无限嵌套。
要求接受服务条款
FastComments 允许您要求首次评论者在提交评论前接受您的服务条款。
启用后：
- 匿名用户每次评论时都会看到服务条款复选框
- 已认证用户仅在其首次评论时，或当您更新服务条款时才会看到该复选框
配置
导航到小部件自定义页面并启用“要求接受服务条款”复选框。启用后，您将看到以下选项：
- 服务条款文本模式：默认情况下，复选框显示“我同意服务条款和隐私政策”，并附带两个文档的链接。选择“按语言区域自定义文本”可为每种语言提供您自己的文本。
- 服务条款最后更新日期：当您更新服务条款时，请设置此日期。在此日期之前接受的用户将被要求重新接受。
工作原理
- 服务条款接受时间戳按用户和按评论存储
- 当用户接受服务条款时，该日期会记录在其用户资料中（按租户）
- 如果您设置的“最后更新”日期晚于用户的接受日期，他们将需要重新接受
- 对于无法追踪的匿名用户，每次提交评论时都会显示该复选框
在未发送评论离开前警告
默认情况下，如果用户输入评论后在提交前刷新页面、关闭标签页或离开页面，草稿会悄悄丢失。
将 warnOnUnsavedComment 设置为 true 时，只要任何评论框或正在编辑的内容仍包含文本，浏览器在离开页面前会要求用户确认。评论提交后文本会被清除，因此不会显示提示。
Run 提示使用浏览器自身的对话框。现代浏览器显示自己的文字并忽略自定义文本，因此无法自定义该消息。
此选项按需加载一个小扩展，对于未启用该功能的站点，不会向小部件添加任何内容。
启用投票
投票让评论者可以在评论中附加一个包含 2 到 10 个选项的问题。页面上的所有人都可以在原位投票并实时看到结果更新。
投票默认是关闭的。请在小部件自定义设置中勾选 Enable Polls，以在评论工具栏中添加投票按钮。随后会出现另外两个设置：
- Who Can Create Polls：仅管理员/版主（默认），或所有人。
- Allow Anonymous Poll Votes：未勾选时（默认），仅已登录用户可以投票。
请参阅 投票指南 了解创建、投票、隐私以及投票通知的工作方式。
单点登录（SSO）概述
SSO，即单点登录（single-sign-on），是一套约定，用于让您或您的用户无需再创建另一个账户即可使用 FastComments。
假设您不允许匿名评论，那么使用 FastComments 评论需要一个账户。我们让这个注册过程非常简单——用户只需在评论时留下他们的电子邮件即可。 不过，我们也理解，即使是这一点额外的阻力，有些网站也希望避免。
我们可以通过让整个网站只有一个登录流程来减少这种阻力。
如何获得该功能？
目前所有账户类型都可以使用 SSO。但是，SSO 用户数量上限取决于您的套餐。与其他功能一样，Pro 及更高版本的计划提供直接的开发支持。
让我们先比较各个选项，然后深入了解每一项。
用户和评论迁移
当从支持 SSO 的平台（如 Disqus）迁移时，您已经拥有用户及其评论。
评论会作为迁移的一部分被导入，可以通过 API、我们的导入 UI 或客户支持来完成。如果导入 UI 支持您要迁移的平台，则首选导入 UI，因为它包含错误处理、头像和媒体提取与上传，以及批处理任务监控系统。
用户本身会在首次查看评论线程时自动添加。或者，也可以通过 API 预先添加，但这样做并没有太多优势。
如果评论已导入，而 SSO 用户未通过 API 手动添加，那么当用户首次查看任何评论线程并创建账户时，评论会自动迁移到该用户的账户。之后他们将能够管理、编辑和删除自己最初撰写的评论。
自动迁移通过电子邮件或用户名完成。某些平台在导出时不提供电子邮件，例如 Disqus，因此在这种情况下我们会退而使用用户名。
- 只要您传入匹配的用户名，并在 SSO 载荷中提供电子邮件，我们就会将电子邮件添加到各个评论对象中，以便通知和提及功能正常工作。
如果您希望一次性导入评论和用户，可以在通过 API 导入用户后，与支持团队协作，将评论迁移到用户各自的账户。
因此，总结一下迁移最简单的路径：
- 导入评论。
- 如果使用
Manage Data -> Imports中的导入 UI，头像和其他媒体会自动迁移。
- 如果使用
- 设置 Secure SSO 或 Simple SSO。
- 让迁移在用户首次登录时按用户自动进行。
- 如果用户的评论少于 5 万条，这通常只会给页面加载时间增加不到一秒。
WordPress 用户
如果您使用我们的 WordPress 插件，那么无需编写任何代码！只需前往插件的管理页面，点击 SSO Settings，然后点击 Enable。
这将带您进入一个单击式向导，它会创建您的 API 密钥，将其发送到您的 WordPress 安装并开启 SSO。我们已将此整合为一次按钮点击。
请注意，如果您是首次安装该插件，则需要先完成设置流程，才能看到带有 SSO Settings 按钮的管理页面。
WordPress SSO - 版主
请注意，目前若要在版主使用 FastComments WordPress 插件评论时在其旁边显示"Moderator"徽章， 他们还必须在 FastComments 控制面板中被添加为版主，并且其电子邮件已通过验证。
自定义集成
对于自定义集成，有两种选项。
选项一 - Secure SSO
使用 Secure SSO，FastComments 可以确认评论、投票和阅读评论的用户是您网站上的真实用户。
只要您创建有效的载荷，用户将始终拥有无缝的评论体验。
使用 Secure SSO 时，SSO 载荷是在服务器端使用 HMAC 身份验证创建的，然后传递给客户端上的小部件。
使用 Secure SSO 时，用户的账户与 FastComments 的其他用户群完全隔离。这意味着如果我们有两个合作伙伴 Company A 和 Company B，每一方都可以拥有一个用户名为"Bob"的 SSO 用户。
要求
- 具备一些后端开发的基础知识。
- 具备一些处理私密 API 密钥的基础知识。
- 具备一些 API 开发或服务器端渲染的基础知识。
优点
- 安全。
- 无缝的评论体验。
缺点
- 需要后端开发。
更新用户数据
使用 Secure SSO 时，每次您传递 sso 用户载荷，我们都会用最新信息更新该用户。例如，如果
用户的用户名是 X，而您在 SSO 载荷中传递 Y，则其用户名将变为 Y。
如果您想通过这种方式移除某个值，请将其设置为 null（而不是 undefined）。
Secure SSO API
我们还提供了一个用于与 SSO 用户交互的 API。请参阅文档。
请注意，使用 Secure SSO 时，用户会在页面加载时自动在后台创建。您无需批量导入用户。
选项二 - Simple SSO
Secure SSO 的替代方案是直接将用户信息传递给评论小部件。
使用 Simple SSO 时不需要提供电子邮件，但如果不提供，其评论将显示为"Unverified"。
注意！ 自 2022 年初起，使用 Simple SSO 的用户名不再需要在整个 FastComments.com 上唯一。
理想情况下，只有在无法使用后端的平台上开发时，才应选择 Simple SSO。
要求
- 具备一些客户端开发的基础知识。
- 至少需要知道用户的电子邮件。
优点
- 简单。
- 所有活动仍会得到验证。
- 用户无需输入用户名或电子邮件。
缺点
- 安全性低于 Secure SSO，因为客户端载荷可能被伪造为任意用户。
Simple SSO API
通过 Simple SSO 流程自动创建的用户以 SSOUser 对象的形式存储。可以通过 SSOUser API 访问和管理它们。请参阅文档。
自定义集成 - 安全单点登录（SSO）
FastComments Secure SSO 使用 HMAC-SHA256 加密作为实现 SSO 的机制。首先我们将介绍整体架构、提供示例以及详细步骤。
也有一些关于从其他具有类似 SSO 机制的提供商迁移以及差异的文档。
流程如下所示：
由于 Secure SSO 涉及全栈开发，完整可运行的 Java/Spring、NodeJS/Express 和 原生 PHP 的示例代码当前位于 GitHub 上。
尽管我们在 NodeJS 示例中使用 ExpressJS，在 Java 示例中使用 Spring，但在这些运行时中实现 FastComments SSO 并不需要任何框架/库 —— 原生的加密包就可以工作。
使用 FastComments SSO 不需要编写任何新的 API 端点。只需使用您的密钥对用户信息进行加密并将负载传递给评论小组件即可。
获取您的 API Secret Key
您的 API Secret 可以从 此页面 获取。您也可以通过转到“我的账户”，点击 API/SSO 磁贴，然后点击“Get API Secret Key”来找到此页面。
评论小组件参数
评论小组件的高级 API 文档可以在 此处 找到。
下面我们详细说明这些参数的含义。
评论小组件接收一个配置对象 —— 如果您正在使用 FastComments，您已经传递了该对象以传递您的客户 ID（称为 tenantId）。
要启用 SSO，请传入一个新的 "sso" 对象，该对象必须具有以下参数。其值应在服务器端生成。
- userDataJSONBase64: 用户的数据，JSON 格式，然后进行 Base64 编码。
- verificationHash: 由 UNIX_TIME_MILLIS + userDataJSONBase64 创建的 HMAC-SHA256 哈希。
- timestamp: 纪元时间戳，单位为 毫秒。不得为将来时间，且不能早于两天之前。
- loginURL: 评论小组件可用于让用户登录的 URL。
- logoutURL: 评论小组件可用于让用户登出的 URL。
- loginCallback: 如果提供此项而不是 login URL，评论小组件在点击登录按钮时会调用的函数。
- logoutCallback: 如果提供此项而不是 logout URL，评论小组件在点击登出按钮时会调用的函数。
用户对象
版主和管理员
对于管理员和版主，在 SSOUser 对象中传递相应的 isAdmin 或 isModerator 标志。
通知
要启用或禁用通知，请将 optedInNotifications 的值分别设置为 true 或 false。当用户第一次在 SSO 有效负载中加载页面时，其通知设置将被更新。
此外，如果您希望用户接收有关他们订阅页面活动的电子邮件通知（而不仅仅是应用内通知），请将 optedInSubscriptionNotifications 设置为 true。
VIP 用户 & 特殊标签
您可以使用可选的 "displayLabel" 字段在用户名称旁显示特殊标签。
未认证用户
要表示未认证用户，只需不填充 userDataJSONBase64、verificationHash 或 timestamp。提供一个 loginURL 即可。
这些用户将无法发表评论，而是会看到一个登录提示（消息、链接或按钮，取决于配置）。
序列化和哈希用户数据的直接示例
更多示例详见 此处（js）、此处（java） 和 此处（php）。
我们理解任何集成都可能是复杂且令人头疼的过程。如有疑问，请随时联系您的客户代表或使用 支持页面。
自定义集成 - 简单单点登录（SSO）
使用 Simple SSO，我们可以向评论小部件提供用户信息，这样用户就不必输入用户名或电子邮件即可发表评论。
我们可以按如下方式配置 Simple SSO：
Run 用户将被登录，并在后台创建一个 SSO 用户。如果从 API 获取，用户的 createdFromSimpleSSO 将被设置为 true。
注意事项：
- 电子邮件是 Simple SSO 的唯一标识符。
- 提供电子邮件并非必需，但默认情况下他们的评论会显示为 “未验证”。如果未提供电子邮件，用户将无法完成完整的身份验证。
- 新 自 2022 年 1 月起：用户名不必在整个 fastcomments.com 上唯一。
- Simple SSO 可以在提供电子邮件且用户最初不是由 Secure SSO 创建的情况下自动创建和更新 SSO 用户。如果 Simple SSO 负载中指定的用户是由 Secure SSO 或 API 创建的，则该用户保持不变，访客将获得一个单独的用户。
- 您可以使用
badgeConfig属性为用户指定徽章。badgeIds数组包含要关联到用户的全局徽章 ID。pageBadgeIds数组包含针对当前页面 (urlId) 的徽章 ID——这些徽章仅在分配它们的页面上显示。如果override设置为true，它将替换已有的显示徽章（全局和页面范围的徽章分别被覆盖）；如果为false，则会在已有徽章上追加。
Simple SSO 设置
Simple SSO 始终可用。两个设置控制 FastComments 对其的信任程度。您可以在 自定义规则 中搜索 SSO 找到它们。默认情况下这两个设置均关闭，并且它们在 “需要 SSO 才能查看评论” 是否开启的情况下都适用。
在添加这些设置时已经使用 Simple SSO 的账户已将两者都打开，因此对它们没有影响。
只有最匹配页面的自定义规则会生效，所以如果您有多个规则，需要在每个规则上都设置这些选项。若您其他规则已打开这些选项，新规则默认也会打开。
通过 Simple SSO 自动验证评论
开启此选项后，来自 Simple SSO 用户的评论会立即被验证。
关闭此选项后，来自 Simple SSO 用户的评论会显示为 “未验证”，直到用户点击我们发送到 Simple SSO 负载中电子邮件地址的链接。如果您只自动批准已验证的评论，它们也会等待该链接。如果负载中没有电子邮件，评论将保持未验证。
此设置仅影响评论。来自 Simple SSO 用户的投票始终会立即计入。
允许 Simple SSO 管理员
开启此选项后，Simple SSO 用户可以成为您账户的管理员或版主：
- 拥有管理员或版主权限的 Simple SSO 用户会保留这些权限。
- 与您某位管理员或版主的电子邮件相同的 Simple SSO 用户会获得相同的权限。
关闭此选项后，Simple SSO 不会授予这些权限。若 Simple SSO 负载中指定的用户拥有这些权限，则会创建一个没有权限的单独用户，原始用户保持不变。
Simple SSO 负载未签名，因此开启此选项后，任何知道管理员电子邮件或用户 ID 的人都可以冒充他们。如果这对您的站点很重要，请关闭此选项并使用 Secure SSO 为管理员提供身份验证。
由 Secure SSO 或 API 创建的用户无法被 Simple SSO 访问，无论此选项是否开启。
自定义集成 - 从 Disqus SSO 迁移
Disqus 与 FastComments Secure SSO 之间最大的区别是 Disqus 使用 SHA1 进行加密，而我们使用 SHA256。
这意味着从 Disqus 迁移很容易 - 将所使用的哈希算法从 SHA1 改为 SHA256 并更新传递给 UI 的属性名称。
自定义集成 - 从 Commento SSO 迁移
Commento 使用一种截然不同的 SSO 方法 - 他们要求你有一个端点，他们会调用该端点来验证用户。FastComments 则相反 - 只需使用你的密钥对用户的信息进行编码和哈希并传递即可。
使用单点登录保护评论线程
FastComments SSO (此处详情) 为您的用户提供了一种无需登录其他平台即可发表评论的方式。
然而，仅此并不能保护您的评论线程，因为默认情况下评论数据是公开可用的信息——任何能够查看页面的人都可以查看评论。
通过更改设置，我们可以限制评论的获取，除非是管理员或有效的 SSO 用户。
无代码设置
当 SSO 设置完成后，我们可以通过创建自定义规则来阻止查看和交互我们的评论线程。
操作时，搜索 SSO，您将看到此选项：
启用后保存自定义规则。
仅保护特定域名或页面
若只想保护特定域名或页面，只需相应配置自定义规则即可。
在自定义 UI 顶部，我们会看到两个输入框，Domain（域名）和 URL ID（页面标识）。
要仅保护特定域名，请在 “domain” 字段中输入相应的域名。
要保护特定页面，请在 “URL ID” 字段中输入页面的 URL。如果您使用 FastComments 的自定义集成，也可以在此处输入一种 ID 类型而非 URL。
安全级别
在要求 SSO 时，您需要决定是使用 Simple SSO 还是 Secure SSO。若选择 Simple SSO，则两者均被允许；若选择 Secure SSO，则内容必须使用使用您 API 密钥哈希的 Secure SSO 负载来获取，才能被查看。
当您选择 “需要 SSO 才能查看评论” 时，安全级别选项会出现，并且仅在该选项开启时生效。
通过 Simple SSO 自动验证评论并允许 Simple SSO 管理员 的设置是独立的，无论此选项是否开启，都将生效。
超出阅读的保护
启用此选项后，页面或域名将只能在用户通过 SSO 登录后才能进行评论。
注意事项
在您集成 SSO 之前已创建的评论的用户，将无法看到这些评论，除非他们通过您的 SSO 集成登录。
允许匿名评论
防止匿名评论过期
禁用电子邮件输入
当用户发表评论且未登录时，系统会要求他们提供电子邮箱。
这将为该用户创建一个“未验证会话”，我们会要求他们通过电子邮件验证该会话。
对于某些网站或应用程序，在评论或投票时不要求用户提供电子邮箱是更理想的做法。
启用匿名评论后，电子邮箱输入字段将变为可选。不过，我们也可以将其完全禁用。首先启用匿名评论，然后禁用电子邮箱输入字段的选项就会出现。
启用此选项后，在我们所有的评论产品中都不会显示电子邮箱字段。
请注意，在此配置下，除非用户创建账户并登录 https://fastcomments.com，否则所有评论都将处于未验证状态。
您可以考虑禁用未验证标签。
禁用未验证标签
默认情况下，FastComments 会为留下的评论显示“未验证评论”标签，针对已留下评论的用户 其浏览器会话未验证。了解更多关于未验证评论的内容，请点击此处。
Run 此外，您可以在自定义 UI 中使用此功能，而无需编写代码：
允许匿名投票
当用户尝试对评论进行投票且未登录时，系统会要求他们提供用户名和电子邮件。
我们可以取消此要求，允许任何人对评论投票而无需留下任何信息。
设置默认用户名
当用户发表评论或投票且未登录时，系统会要求他们提供电子邮件和用户名。
在匿名评论的情况下，有时希望定义一个默认用户名以降低评论时的阻力。这可以在自定义 UI 中完成。必须先启用匿名评论。
共享默认用户名
默认用户名是共享的显示名称，而非身份标识。保留默认用户名并输入电子邮件的访客会获得自己的账户，默认用户名会显示为他们的公开名称。任意数量的访客都可以使用相同的默认用户名，因此“Anonymous”永远不会被报告为已被占用。
访客自行输入的用户名仍需唯一。
如果您希望每位访客获得一个独特的名称而无需自行思考，请参阅自动生成用户名。
自动生成用户名
当用户发表评论或投票且未登录时，系统会要求他们提供电子邮件和用户名。
对于某些站点来说，要求访客自行想出唯一的用户名是一道障碍，尤其在移动端。FastComments 可以为每位新访客生成一个中性用户名，并预填到用户名字段中，例如 BraveOtter4172。
访客可以保持原样，或替换为自己选择的名称。
可以在自定义 UI 中的 Generate Usernames Automatically 设置下启用此功能：
工作方式
回调
所有评论小部件的库（目前包括 Angular、React、Vue）都支持回调。
回调在配置对象中指定，对每个库的签名相同。
支持的回调包括：
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
可以在TypeScript 定义中找到确切的签名。
以下是使用所有回调的示例：
Run 手动定义用户地区设置
默认情况下，FastComments 会根据用户的系统和浏览器所确定的语言区域（locale）来渲染评论组件。
当用户发表评论或登录时，我们会更新其上次使用的语言区域，并将其用于发送电子邮件等。
这会影响评论组件为用户呈现的翻译内容。语言区域由用户的语言和地区组成，因此配置 locale 通常会改变向用户显示文本所使用的语言。
通过 UI 配置
可以通过组件自定义 UI 来定义此项。请参阅 "Locale / Language" 选项：
通过代码配置
可以通过代码覆盖为所需的语言区域。
Run 支持的语言和语言区域代码
SSO 说明
如果你使用 SSO，可能需要在用户对象中传入用户的语言区域，以便为其正确地本地化电子邮件及其他内容。
限制允许的语言
默认情况下，FastComments 不限制用于评论的语言。
可能需要限制社区使用的语言。
可以在小部件自定义页面上无需编写代码进行配置：
系统会解析评论并确定其语言，然后与允许的语言列表进行匹配。
如果评论使用了不被允许的语言，则会显示本地化的错误信息。
评论翻译
默认情况下，FastComments 会将小部件自身的界面（按钮、标签、错误信息）翻译成观看者的语言，但评论会保持原样显示。
评论翻译功能会对评论本身进行翻译，使得使用多种语言的社区能够阅读每条评论的对应语言版本。
有两种模式：
- 自动：用非小部件语言撰写的评论会显示翻译后的内容。评论下方会出现“已从西班牙语翻译”行，并带有 显示原文 链接，可在翻译文本和未翻译文本之间切换。
- 手动：每条评论都会出现 翻译 链接。点击后会将该评论翻译成观看者的语言，随后同样提供 显示原文 切换。已经是观看者语言的评论则会显示相应提示。
目标语言为小部件的语言：如果在同一自定义规则中设置了 Locale / Language（语言/地区）选项，则使用该设置；否则使用访客的浏览器语言。访客无需任何操作，无需账户、扩展或额外软件，无论是在嵌入式小部件还是独立评论页面中都能正常工作。
此功能在每个 自定义规则 中单独开启，因此可以应用于整个站点、单个域名或单个页面。默认情况下为关闭状态。
翻译是服务器端设置。仅在小部件的 JavaScript 配置中传入 commentTranslation 并不能启用该功能；必须在规则中开启。
每条评论在每种目标语言下最多翻译一次，翻译结果会与评论一起存储，因此一条被千名西班牙语使用者阅读的评论只会翻译一次。如果作者或版主编辑了评论，已存储的翻译将被丢弃，评论将在下次查看时重新翻译。翻译后的文本会经过与原始评论相同的清理和链接规则。过长的评论或无法检测语言的评论将保持未翻译状态。
使用量按 LLM 令牌计费，费率与 AI 代理 相同，并显示在账单详情的相同位置。
页面标题
当前页面标题会与指定的 urlId 关联，并保存以供审核工具使用。
默认情况下，此标题从 document.title 获取。
如果需要，您可以按如下方式指定自定义页面标题：
Run 阻止新回复并禁用投票
通过将 readonly 标志设为 true，可以锁定评论，从而不允许留下新评论或投票。
评论也将无法被编辑或删除。
Run 这可以在无需代码的情况下，通过小部件自定义页面为整个域或单个页面进行设置：
Update!
自 2022 年 11 月起，管理员和版主可以通过回复区域上方的三点菜单实时锁定或解锁线程。
这将阻止新评论，同时仍然允许投票，并允许用户在需要时删除自己的评论，而 readonly 则不允许这些操作。
这对应于 Page API 中的 isClosed 字段。
限制链接域名
默认情况下，FastComments 允许链接到任何外部站点。
这可以限制为仅允许的站点或域名列表。尝试发布链接到未在定义列表中的站点或域名时，将向用户显示错误。
此验证仅适用于评论小部件和 API。导入不受影响。
此操作无需代码，在小部件自定义页面完成：
评论计数及统计所有嵌套回复
评论小部件顶部显示的评论计数可以显示所有“顶级”评论，意思是那些 直接回复页面或文章本身的回复，或者它可以是所有嵌套评论的计数。
默认情况下，这是 true - 它是后者的计数 - 所有评论。在旧版本的评论小部件中，默认值是 false。
我们可以通过将 countAll 标志设置为 true 来更改行为，使其成为所有嵌套评论的计数。
Run 如果我们希望计数仅反映顶级评论，我们将该标志设置为 false。
Run 目前无法在不修改代码的情况下进行自定义。
启用评论者链接
默认情况下，FastComments 只会要求用户提供评论内容、用户名和电子邮件。
然而，在某些情况下，您可能希望用户留下指向其个人博客或网站的链接。
我们可以通过将 enableCommenterLinks 标志设置为 true，来启用显示一个额外的输入字段，以填写用户的网站 URL：
Run 当提供该 URL 时，用户的账户将被更新，且其过去和未来所有评论中的用户名都将链接到该 URL。
这可以在小部件自定义页面上无需编写代码进行自定义：
审核组
一个由 审核组 页面生成的 id 列表。
当指定后，使用该配置留下的评论将包含相同的一组 moderationGroupIds。
如果某个 Moderator 定义了一个或多个 审核组，他们将
只会在与其分组相关联的 Moderate Comments 页面中看到评论。
Run 提及组 ID
用于 @mentions 自动完成 的 ID 列表。当你希望在用户没有交集群组时防止标记他们时非常有用。
当指定后，输入 @ 字符后，自动完成中只会提供属于其他群组的用户。
Run 第三方 Cookie 绕过
对于身份验证，FastComments 依赖浏览器中启用第三方 Cookie。若未启用，用户必须始终留下电子邮件才能发表评论（除非隐藏了电子邮件输入字段），并且他们的评论默认会显示为未验证。
为了解决此问题，您可以启用第三方 Cookie 绕过。
启用此设置后，会出现一个小弹窗，显示用户正在登录的消息。该弹窗会在用户与评论小部件交互时出现，例如当他们留下评论时。
我们可以通过在代码中将 enableThirdPartyCookieBypass 标志设为 true 来实现：
Run 我们也可以通过小部件自定义 UI 设置此项，位于 Enable Third-Party Cookie Popup 下：
删除带有回复的评论
默认情况下，用户可以删除自己的评论。同时，删除他们的评论会自动删除线程中所有子评论和临时评论。此行为也实时生效。
您可以通过以下方式限制此行为：
- 相反，将已删除的评论匿名化（将名称和文本设置为
[deleted]或自定义值）。 - 当有回复时，不允许删除评论。会显示可自定义的错误信息。
- 仅允许管理员和版主在评论有回复时删除。
可以在小部件自定义 UI 的 Comment Thread Deletion 部分进行配置。
在顶部栏显示徽章
默认情况下，FastComments 只会在评论线程中的评论上显示用户徽章。
然而，我们可以通过在小部件自定义页面中启用此功能，将用户徽章显示在评论表单上方的姓名旁边：
这将在顶部栏区域将用户的徽章与其姓名并排显示，使他们在撰写评论时的成就和状态更加突出。
请注意，必须在小部件自定义 UI 中启用此功能才能生效。您可以在代码配置中可选地将 showBadgesInTopBar 标志设置为 false，以在服务器级别已开启时仍选择性地禁用它：
Run 显示在线用户列表
默认情况下，FastComments 不会在页面上显示用户列表。
您可以在评论小部件旁边渲染当前正在查看页面的用户列表。该列表会实时更新，随着用户加入和离开，并显示他们的姓名、头像和在线指示器。
有三种布局选项：
1- 顶部：在评论上方渲染的水平行重叠头像。2- 左侧：在小部件左侧渲染的带有姓名和在线点的侧边栏。3- 右侧：在小部件右侧渲染的相同侧边栏。
设置 usersListLocation 标志以启用此功能：
Run 默认情况下，列表仅显示当前在线的用户。若要同时包括过去在页面上发表评论但当前未在观看的用户，请将 usersListIncludeOffline 设置为 true：
Run 过去的评论者渲染时不带绿色在线点，以便清楚地显示当前在场的用户。
拥有私人资料的用户会显示通用头像和“私人资料”标签，以便在不泄露身份的情况下保持计数准确。
这也可以在无需代码的情况下进行配置。在小部件自定义页面，查看“用户列表位置”选项。当位置设置为除“关闭”之外的任何值时，会在其下方出现“包括过去的评论者”复选框。
过去 500 名实时用户，列表最多延迟 30 秒。