Client Configuration

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>