====== Disqus Plugin ======

---- plugin ----
description: Add Disqus powered comments to your wiki
author     : Andreas Gohr
email      : andi@splitbrain.org
type       : syntax
lastupdate : 2016-08-09
compatible : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo
depends    : 
conflicts  : 
similar    : discussion
tags       : disqus, discussion, embed

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-disqus/zipball/master
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-disqus/
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-disqus/issues
donationurl: http://donate.dokuwiki.org/Disqus
----

This plugin integrates a threaded comment system provided by the online service [[https://disqus.com/|Disqus]]. JavaScript is required to see the comments inline, when no JavaScript is available a link to the Disqus page is provided.

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

==== Changes ====

{{rss>https://github.com/splitbrain/dokuwiki-plugin-disqus/commits/master.atom date}}

===== Configuration =====

The plugin can be configured through the [[config|Config Manager]]. You need to register a short name at [[https://disqus.com/add/|Disqus]] and set it in the ''shortname'' option. For local testing enable the ''devel'' option.

===== Syntax and Usage =====

Simply add the following macro where you want to have the comment form and the comments displayed:

  ~~DISQUS~~

Then, go to the Configuration menu and add your Disqus short name to the configuration.

Alternatively, you can add your Disqus short name inline:

  ~~DISQUS shortname~~
  
Voila!

==== Adding comments to every page ====

If you want Disqus comments on all pages in your wiki, it is easier to just call the plugin from your template. Add the following code in your template's ''main.php'' where you want the comments to appear:

<code php>
<?php
global $ACT;
if($ACT == 'show'){
    $disqus = &plugin_load('syntax','disqus');
    if($disqus) echo $disqus->_disqus($shortname);
}
?>
</code>