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.