Client Configuration - Isso中文文档

Client Configuration¶

您可以使用自定义数据属性来配置客户端（JS部分），最好在嵌入JS的脚本标签中：

<script data-isso="/prefix/"
        data-isso-id="thread-id"
        data-isso-css="true"
        data-isso-lang="ru"
        data-isso-reply-to-self="false"
        data-isso-require-author="false"
        data-isso-require-email="false"
        data-isso-reply-notifications="false"
        data-isso-max-comments-top="10"
        data-isso-max-comments-nested="5"
        data-isso-reveal-on-click="5"
        data-isso-avatar="true"
        data-isso-avatar-bg="#f0f0f0"
        data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
        data-isso-vote="true"
        data-isso-vote-levels=""
        data-isso-feed="false"
        src="/prefix/js/embed.js"></script>

此外，您可以覆盖embed标签内部的自动标题检测以及主题帖ID，例如：

<section id="isso-thread" data-title="Foo!" data-isso-id="/path/to/resource"></section>

此外，您可以通过添加 data-isso- 属性来覆盖任何语言的任何翻译字符串，该属性等于附加了 -text-[lang] 的翻译键（在 here 找到）。因此，例如，如果要覆盖 postbox-notification 消息的英文翻译，可以添加：

data-isso-postbox-notification-text-en="Select to be notified of replies to your comment"

data-isso¶

Isso通常会自动检测REST API，但是当您在其他位置提供JS脚本时，这可能会失败。使用 data-isso 覆盖API位置：

<script data-isso="/isso" src="/path/to/embed.min.js"></script>

data-isso-css¶

设置为 false 可防止Isso自动附加样式表。默认为 true 。

<script src="..." data-isso-css="false"></script>

data-isso-lang¶

覆盖用户代理的首选语言。 Isso已被翻译成12多种语言。该语言由 ISO 639-1（两个字母）代码配置。

您可以在 GitHub 上找到所有受支持语言的列表。

data-isso-reply-to-self¶

当垃圾邮件防护配置为 reply-to-self = true 时，设置为 true 。

data-isso-require-author¶

当垃圾邮件防护配置为 require-author = true 时，设置为 true 。

data-isso-require-email¶

当垃圾邮件防护配置为 require-email = true 时，设置为 true 。

data-isso-reply-notifications¶

当回复通知配置为 reply-notifications = true 时，设置为 true 。

data-isso-max-comments-top and data-isso-max-comments-nested¶

默认显示的顶级（或嵌套）评论数。如果未显示某些评论，则会显示 “X Hidden” 链接。

设置为 “inf” 以显示全部，或设置为 “0” 以隐藏所有。

data-isso-reveal-on-click¶

单击 “X Hidden” 链接后要显示的评论数。

data-isso-avatar¶

启用或禁用头像生成。

data-isso-avatar-bg¶

设置头像背景颜色。任何有效的CSS颜色都可以。

data-isso-avatar-fg¶

设置头像前景色。最多可以有8种颜色。默认配色方案基于此调色板。多种颜色必须用空格隔开。如果使用的颜色少于八种，而不是2的倍数，则颜色分布不均匀。

data-isso-gravatar¶

使用gravatar头像而不是生成svg头像。要使用此功能，必须将 “data-isso-avatar” 设置为 false 。否则，将显示gravatar和avatar的svg头像（显示双头像）。另外，还请在服务器配置中将选项 “gravatar” 设置为 true 。

data-isso-vote¶

在客户端启用或禁用投票功能。

data-isso-vote-levels¶

用于根据评分自定义评论外观的投票区间。提供逗号分隔的值（例如 “0,5,10,25,100” ）或JSON数组（例如 “[-5,5,15]” ）。

例如，值 “-5,5” 将使每个 isso评论被赋予以下3个等级之一：

评分低于-5时，isso-vote-level-0
评分介于-5和4之间时，isso-vote-level-1
评分5分及以上时，isso-vote-level-2

然后，可以使用这些等级自定义评论的外观（例如，在热门评论上加星号）

data-isso-feed¶

启用或禁用向评论feed中添加链接。仅当在服务器端也启用了 [rss] 部分中的适当设置时，该链接才有效。