Skip to content

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

Notifications You must be signed in to change notification settings

potar/collective.disqus

 
 

Repository files navigation

collective.disqus

Table of Contents

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.

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.

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
  • Enter your blogs's/subsite's short names into 'Website short names (additional)' - it's an unrequired option. The single Plone site can have different Discus short names for different sections so you can migrate the specific subsite to different domain/url, etc. Using this option you might have different moderators for different Plone site sections. This can be achieved only by different Discus short names.

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:

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

Disqus API

More info in http://docs.disqus.com/developers/api/

Mostly Harmless

image

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

About

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

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%