You are here: System » DisqusPlugin

DisqusPlugin

16 Dec 2014 - 13:21 | Version 1 |
Disqus-based commenting system

DisqusPlugin allows to embed the popular DISQUS commenting system to Foswiki. This is mostly of use when running a public site on the internet to allow a wider range of people to comment on your site. Instead of requiring them to register and log in to your site, they can use their existing Disqus, Facebook, google+ or twitter identity already authenticated on the net.

Note that all comments will be stored on disqus.com, not on your own server. There are however APIs to import and export this data. Further note that you will have to register an account on disqus.com and register your Foswiki site. The generated short name for your site then has to be stored in {DisqusPlugin}{ForumName}. All maintenance of comments including moderation is done via disqus.com as well, not on your own site.

Use %!DISQUS% on any page to start a discussion on that page.

Use %!DISQUS_COUNT% to display the number of comments on page.

DISQUS -- embed a discussion

This will embed all required javascript code to the page so that it loads the disqus widget on page load.

Parameters Description Default
[topic] the topic to render the discussion for current topic
title the title to be used for that discussion title of the html page
url the location of the page hosting this discussion the current view url

DISQUS_COUNT -- display number of comments on a given topic

This is mostly useful when rendering a list of topics with discussions and add the number of comments for each.

Parameters Description Default
[topic] the topic to render the counter for current topic
format markup template to be used <a href="$url" class="disqus_count" data-disqus-identifier="$id"></a>

Skin integration

DisqusPlugin is already integrated into Foswiki:Extensions/NatSkin's pluggable commenting system. Use the COMMENTSYSTEM preference variable to switch it to disqus.

Installation Instructions

See also comments above.

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Info

Change History:  
31 Aug 2015 ignore discussions in template (_) webs
16 Dec 2014 make it work with async page loads as per AngularSkin
5 May 2013 initial release
Dependencies: None
Home page: Foswiki:Extensions/DisqusPlugin

Contact Us

Atomikos Corporate Headquarters
Hoveniersstraat, 39/1, 2800
Mechelen, Belgium

E info@atomikos.com
E sales@atomikos.com
T +3215613055

Subscribe to our newsletter

Never miss an update

Copyright 2017 Atomikos BVBA