The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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/