Configuring the frontend

Introduction

Commento’s frontend configuration allows you to modify the appearance of the embedded comments box. For example, you can specifying a custom CSS stylesheet to override Commento’s default appearance to match the look and feel of your website. In this page, we document how to embed Commento in your website and the exhaustive list of frontend settings you can configure.

You can configure additional frontend settings by adding data attributes to the <script> tag. For example, to specify custom CSS styling, you can add the data-css-override and data-auto-init attributes as follows:

  1. <script defer
  2. src="http://commento.example.com/js/commento.js"
  3. data-css-override="http://example.com/my-custom-styling.css"
  4. data-auto-init="true">
  5. </script>
  6. <div id="commento"></div>

Configuration settings

Optional

data-css-override

An URL to a CSS file with overriding styles. Defaults to no override and uses Commento’s default theme.

data-css-override=”http://example.com/my-custom-styling.css


Optional

data-auto-init

Commento automatically initialises itself when the page is loaded. If you prefer to load Commento dynamically (for example, after the user clicks a button), you can disable this. You will be required to call window.commento.main() when you want to load Commento. By default, this is true.

true, false


Optional

data-id-root

By default, Commento looks for a <div> with id="commento". If you want to load Commento in a different element, you can set this attribute to the ID of that element.

data-id-root=”different-element”


Optional

data-no-fonts

By default, Commento uses the Source Sans Pro font to present a good design out-of-the-box. If you’d like to disable this so that Commento never loads the font files, you can set this to true. By default, this is true.

true, false


Optional

data-hide-deleted

By default, deleted comments with undeleted replies are shown with a “[deleted]“ tag. If you’d like to disable this, setting this to true will hide deleted comments even if there are legitimate replies underneath. Deleted comments without any undeleted comments underneath are hidden irrespective of the value of this function. By default, this is false.

true, false


Optional

data-page-id

By default, Commento will use the browser URL to determine which page’s comments should be served. If you changed the URL of a page or if you’d like to use a dynamically set custom ID for each page, use this option. Note that the value need not be a URL path; whatever you set as the value here will be used to uniquely identify your page.

data-page-id=”/path/to/older/post.html”