You can configure the client (the JS part) with custom data attributes, preferably in the script tag which embeds the JS:
<script data-isso="/prefix/"
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-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-vote-levels=""
src="/prefix/js/embed.js"></script>
Furthermore you can override the automatic title detection inside the embed tag, e.g.:
<section id="isso-thread" data-title="Foo!"></section>
data-isso¶
Isso usually detects the REST API automatically, but when you serve the JS script on a different location, this may fail. Use data-isso to override the API location:
<script data-isso="/isso" src="/path/to/embed.min.js"></script>
data-isso-css¶
Set to false prevents Isso from automatically appending the stylesheet. Defaults to true.
<script src="..." data-isso-css="false"></script>
data-isso-lang¶
Override useragent's preferred language. Isso has been translated in over 12 languages. The language is configured by its ISO 639-1 (two letter) code.
You find a list of all supported languages on GitHub.
data-isso-reply-to-self¶
Set to true when spam guard is configured with reply-to-self = true.
data-isso-require-author¶
Set to true when spam guard is configured with require-author = true.
data-isso-require-email¶
Set to true when spam guard is configured with require-email = true.
data-isso-max-comments-top and data-isso-max-comments-nested¶
Number of top level (or nested) comments to show by default. If some comments are not shown, an "X Hidden" link is shown.
Set to "inf" to show all, or "0" to hide all.
data-isso-reveal-on-click¶
Number of comments to reveal on clicking the "X Hidden" link.
data-isso-avatar¶
Enable or disable avatar generation.
data-isso-avatar-bg¶
Set avatar background color. Any valid CSS color will do.
data-isso-avatar-fg¶
Set avatar foreground color. Up to 8 colors are possible. The default color scheme is based in this color palette. Multiple colors must be separated by space. If you use less than eight colors and not a multiple of 2, the color distribution is not even.
data-isso-vote¶
Enable or disable voting feature on the client side.
data-isso-vote-levels¶
List of vote levels used to customize comment appearance based on score. Provide a comma-separated values (eg. "0,5,10,25,100") or a JSON array (eg. "[-5,5,15]").
For example, the value "-5,5" will cause each isso-comment to be given one of these 3 classes:
- isso-vote-level-0 for scores lower than -5
- isso-vote-level-1 for scores between -5 and 4
- isso-vote-level-2 for scores of 5 and greater
These classes can then be used to customize the appearance of comments (eg. put a star on popular comments)
data-isso-id¶
Set a custom thread id, defaults to current URI. This attribute needs to be used with the data-title attribute in order to work. If you use a comment counter, add this attribute to the link tag, too.
<section data-title="Yay!" data-isso-id="test.abc" id="isso-thread"></section>