Client Configuration

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] 部分中的适当设置时,该链接才有效。