Developers : JavaScript Embed


Introduction

DISQUS Comment System integrates with sites via a JavaScript embed. This page is for developers; if you would like to install DISQUS Comment System, please visit http://disqus.com/start

This documentation details the parameters being passed, or available to pass, client-side to Disqus. The parameters are JavaScript variables to be set before the DISQUS Comment System is included on the page document (embed.js). Inside the <HEAD> is a good place. For example, to set the parameter "disqus_awesome":

<script type="text/javascript">

</script>

Available Parameters

disqus_developer

Description: Enables developer mode, which allows testing to be done on local, protected, or otherwise inaccessible servers.

Usage: Integer 1 to turn on. Integer 0 to turn off.

Default: Integer 0.

disqus_url

Description: Defines the page URL associated with a comment thread. Disqus uses this URL to uniquely create and identity a comment thread.

Usage: Accepts a URL string.

Default: Retrieves from window.location.

disqus_identifier

Description Defines a custom identifier for Disqus to use in place of the page URL (disqus_thread).

Usage: Accepts a string or integer.

Default: None.

disqus_title

Description: Defines the comment thread's title.

Usage: Accepts a string.

Default: Uses the disqus_title is no title is set.

disqus_message

Description: Defines the page's content (article or blog post) to use as context.

Usage: Accepts a string.

Default: None.

disqus_iframe_css

Description: Disqus uses an iframe to do all posting, including commenting and authentication. This parameter allows the site to define an external stylesheet to use within the iframe.

Usage: Accepts URL string (full path to stylesheet).

Default: None.

disqus_container_id

Description: Disqus is contained within the container <DIV ID="disqus_thread"> on the page. If the container is changed, the ID must be passed onto Disqus.

Usage: Accepts a string.

Default: 'disqus_thread'

disqus_def_email

Description: Defines a default email address used in the comment/authentication forms in the iframes.

Usage: Accepts a string.

Default: None.

disqus_def_name

Description: Defines a default name used in the comment/authentication form sin the iframes.

Usage: Accepts a string.

Default: None.

JSEmbed (last edited 2009-04-23 08:39:29 by daniel)