Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Integration of Disqus Service into Plone. Disqus is a comment plateform

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.rst

collective.disqus

Overview

Integrates the Disqus commenting platform into Plone.

Default Plone discussion mechanism doesn't have a nice panel to administer comments. It's hard to find new comments. It's not possible to block posts with links or any other unwelcome contents.

However there are much more specialized tools for commenting on the web:

These commenting platforms can be easily integrated with sites, users just need to create an account and add some special code into their websites.

Installation

To enable this package in a buildout-based installation:

  1. Edit your buildout.cfg and add collective.disqus to the list of eggs to install:

    [buildout]
    ...
    eggs =
        collective.disqus
    

After updating the configuration you need to run ''bin/buildout'', which will take care of updating your system.

Go to the 'Site Setup' page in a Plone site and click on the 'Add-ons' link.

Check the box next to collective.disqus and click the 'Activate' button.

Note

You may have to empty your browser cache and save your resource registries in order to see the effects of the product installation.

Upgrading from 0.3.1

Warning

Versions 2.0 and up are not backwards compatible. If you are coming from an old version, you'll need to write your own upgrade code, or simply manually uninstall the old package before installing the new one.

If you're upgrading from a pre-2.0 installation you'll have to manually reconfigure the @@disqus-controlpanel.

A GenericSetup upgrade profile called "collective.disqus: cleanup old 0.3.1 install" will undo the viewlet suppression that was part of 0.3.1. This may also unhide other belowcontent viewlets, YMMV. It does not provide a full upgrade.

Usage

Configuration

To enable Disqus comments in your site you need to:

  • Enable Global comments from Plone's default "Discussion settings" tool from control panel
  • Go to Disqus control panel and enable "Activate Disqus as system comment for Plone"
  • Enter your blog's short name as provided by Disqus

Now a Disqus comment box should be shown for each content type that has comments enabled.

Comments count

The product provides a 'Disqus summary view' that you can apply to any folderish or collection-type content type. It will show a comments count next to the "Read more..." link of each element.

In addition, there's a counter beneath the title of any object that accepts comments. This is done through a viewlet named as "disqus.comments.count".

Portlets

This product provides 2 portlets that you can use:

  • Hot threads: Shows a list of threads sorted by hotness (date and likes)
  • Popular threads: Shows a list of threads sorted by number of posts made since the specified interval

They both use the Disqus API, and for them to work, you need to provide:

  • Access token
  • Public key
  • Secret key

And to get them, you need to register an API Disqus account

TODO

Add a portlet that shows a list of Trending threads.

Mostly Harmless

https://secure.travis-ci.org/collective/collective.disqus.png?branch=master https://coveralls.io/repos/collective/collective.disqus/badge.png?branch=master

Got an idea? Found a bug? Let us know by opening a support ticket.

Something went wrong with that request. Please try again.