ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / tips / Adding_Disqus_to_your_wiki.mdwn
1 <a href="http://disqus.com">Disqus</a> is a comment system that you can add to your blog to manage comments.
2
3 To add it to ikiwiki first create an account at disqus and add you blog. Then click on the Admin link at that top of the main page.
4
5 In the admin section there should be a tab called "Tools" for you site. Select the "Generic Code" option to install your site and then tweak the settings so the comments box looks like you want. This will then create a bit of javascript. Copy that code.
6
7 In ikiwiki templates edit the page.tmpl and somewhere down the bottom, I put mine just before the footer, paste in the code that you had from before. This will add a disqus comment box to every page on your site.
8
9 If you want to change your blog to also use the comments then you need to edit the inlinepage.tmpl template as well. This time remove the lines 
10
11     <TMPL_IF NAME="DISCUSSIONLINK">
12     <li><TMPL_VAR DISCUSSIONLINK></li>
13
14 and replace with
15
16     <li>
17     <TMPL_IF NAME="PERMALINK">
18     <a href="<TMPL_VAR PERMALINK>">Comment</a>
19     <TMPL_ELSE>
20     <a href="<TMPL_VAR PAGEURL>">Comment</a>
21     </TMPL_IF>
22     </li>
23
24 This changes the discussion link to a Comment link that takes you to the full page for that blog entry which should contain the disqus comments form that you added before.
25
26 Note: This does then mean that to add a comment people need to have javascript enabled.
27
28 ---
29
30 You can also try [IkiWiki::Plugin::disqus](http://code.google.com/p/ikiwiki-plugin-disqus/).