NAME

IkiWiki::Plugin::disqus - Add Disqus comments to IkiWiki pages

DESCRIPTION

This plugin makes it easy for you to add Disqus comments to pages and blog posts in IkiWiki. It also provides a way to allow you to prevent comments from being posted on certain pages.

INSTALLATION

Put disqus.pm in $HOME/.ikiwiki/IkiWiki/Plugin/ or elsewhere in your @INC path.

CONFIGURATION

Add to the configuration in your blog.setup file.

## Disqus plugin
# Your disqus forum "shortname"
disqus_shortname => 'your_short_name',
# A list of regular expressions matching pages that should
# not have the disqus comments placed on them.
#
# Example:
#  disqus_skip_patterns => [ qr(^index$), qr(^posts$), qr(^tags/) ],
disqus_skip_patterns => [ qr(^index$), qr(^posts$), qr(^tags/) ],

Add disqus to the list of plugins:

add_plugins => [qw{goodstuff disqus}],

You should also turn off the comments plugin"

disable_plugins => [qw(comments)],

TEMPLATES

You will need to add the following code to page.tmpl. I suggest putting it just before the COMMENTS block or after the content div.

<TMPL_IF DISQUS>
<div id="disqus_comments">
<TMPL_VAR DISQUS_COMMENTS>
</div>
</TMPL_IF>

BUGS AND LIMITATIONS

Report bugs at http://code.google.com/p/ikiwiki-plugin-disqus/issues/list

AUTHOR(S)

Randall Smith <perlstalker@vuser.org>

LICENSE AND COPYRIGHT

Copyright (C) 2012 Randall Smith

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

SEE ALSO

http://ikiwiki.info/
http://docs.disqus.com/developers/universal/