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-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-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>
Furthermore you can override the automatic title detection inside the embed tag, as well as the thread ID, e.g.:
<section id="isso-thread" data-title="Foo!" data-isso-id="/path/to/resource"></section>
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>
Set to false prevents Isso from automatically appending the stylesheet. Defaults to true.
<script src="..." data-isso-css="false"></script>
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.
Set to true when spam guard is configured with reply-to-self = true.
Set to true when spam guard is configured with require-email = true.
Set to true when reply notifications is configured with reply-notifications = 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.
Number of comments to reveal on clicking the “X Hidden” link.
Enable or disable avatar generation.
Set avatar background color. Any valid CSS color will do.
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.
Uses gravatar images instead of generating svg images. You have to set “data-isso-avatar” to false when you want to use this. Otherwise both the gravatar and avatar svg image will show up. Please also set option “gravatar” to true in the server configuration…
Enable or disable voting feature on the client side.
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)
Enable or disable the addition of a link to the feed for the comment
thread. The link will only be valid if the appropriate setting, in
[rss] section, is also enabled server-side.