Metadata-Version: 1.1
Name: collective.disqus
Version: 2.0b2
Summary: Integration of Disqus comments platform API into Plone.
Home-page: http://github.com/collective/collective.disqus
Author: JeanMichel FRANCOIS aka toutpt
Author-email: toutpt@gmail.com
License: GPLv2
Description: *****************
        collective.disqus
        *****************
        
        .. contents:: 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:
        
        * `Disqus`_
        * `IntenseDebate`_
        * `JS-Kit`_
        
        These commenting platforms can be easily integrated with sites, users just
        need to create an account and add some special code into their websites.
        
        .. 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.
        
        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`_
        * `Popular threads`_
        
        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:: https://secure.travis-ci.org/collective/collective.disqus.png
            :target: http://travis-ci.org/collective/collective.disqus
        
        Have an idea? Found a bug? Let us know by `opening a support ticket`_.
        
        .. _`opening a support ticket`: https://github.com/collective/collective.disqus/issues
        .. _`Disqus`: http://disqus.com/
        .. _`IntenseDebate`: http://intensedebate.com/
        .. _`JS-Kit`: http://js-kit.com/
        .. _`Hot threads`: http://disqus.com/api/docs/threads/listHot/
        .. _`Popular threads`: http://disqus.com/api/docs/threads/listPopular/
        .. _`API Disqus account`: http://disqus.com/api/docs/
        
        Installation
        ------------
        
        To enable this product 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.
        
        
        Contributors
        ------------
        
        - Wojciech Lichota
        - Rok Garbas
        - Harald Friessnegger
        - Héctor Velarde
        - JeanMichel FRANCOIS
        - Juan A. Diaz
        - Franco Pellegrini
        
        
        Changelog
        ---------
        
        2.0b2 (2013-02-22)
        ^^^^^^^^^^^^^^^^^^
        
        - Add Disqus icon on the control panel. [hvelarde]
        
        - Include an Id in the counter link for themming purposes [tamosauskas]
        
        - Update Traditional Chinese translation. [l34marr]
        
        - Bugfix, javascript variables weren't being embedded in the page.
          [jcbrand]
        
        
        2.0b1 (2012-12-13)
        ^^^^^^^^^^^^^^^^^^^
        
        - Added a "Disqus summary view" to include comments count on listings.
          [frapell]
        
        - Added a viewlet that will display the comments count beneath the object's 
          title. [frapell]
        
        - If wrong url (not returning json), return empty list. [flecox]
        
        - Use network-path reference to load Disqus JavaScript to avoid "This Page
          Contains Both Secure and Non-Secure Items" messages over HTTPS. [hvelarde]
        
        - Updated Brazilian Portuguese translation. [hvelarde]
        
        - Updated German translation. [fRiSi]
        
        - Updated Spanish translation. [frapell]
        
        - Bugfix for the article's titles. [frapell]
        
        - Avoid removal of registry records on reinstall. [hvelarde]
        
        - Tested for Plone 4.2 compatibility. [hvelarde]
        
        - Added portlets for hot and popular threads. [hvelarde]
        
        - Added records to access the Disqus API to the control panel. [hvelarde]
        
        - Updated development buildout configurations. [hvelarde]
        
        - Updated package distribution and documentation. [hvelarde]
        
        - Add control panel and viewlet. [toutpt]
        
        - Complete refactoring of the package. [toutpt, hvelarde, frapell]
        
        
        0.3.2 (unreleased)
        ^^^^^^^^^^^^^^^^^^
        
        - moved javascript template code from disqus_panel.pt into it's view to bypass
          a chameleon related bug. [thet]
        - added DisqusAPI class for remote DISQUS API calls with predefined control
          panel settings, it inherits from disqus-python API [piv]
        - added option to switch DISQUS credit link off [piv]
        - added DISQUS SSO Addon support [piv]
        - added export comments view from plone to WXR format to import
          it into DISQUS [piv]
        - added product layer interface and registered viewlet for it instead of
          hiding it on uninstall [piv]
        - added highly recommended disqus_url additional parameter [piv]
        - added an option to display DISQUS comments only for anonymous [zupo]
        - add french translation [toutpt]
        - updated pot file and Spanish translation; removed mo file [hvelarde]
        - include Products.CMFCore.permissions.zcml [ajung]
        - add support for language param according to http://docs.disqus.com/help/97/
          [toutpt]
        
        
        0.3.1 (2011-01-31)
        ^^^^^^^^^^^^^^^^^^
        
        - cleaned up i18n and added German translation [fRiSi]
        - added Spanish translation [hvelarde]
        - fixed action icons [hvelarde]
        - disqus_summary_listing now uses the configured shortname and includes
          the js only once [fRiSi]
        
        
        0.3.0 (2010-08-15)
        ^^^^^^^^^^^^^^^^^^
        
        - updated disqus api [garbas]
        - added disqus summary listing view with number of comments [garbas]
        - added some basic integration tests using plone.app.testing [garbas]
        - removed actionicon registration - depracated [garbas]
        - found and fixed bug in plone which was causing hidding of default plone
          commenting viewlet only for "Plone Classic Theme". [garbas]
          https://dev.plone.org/plone/ticket/10903
        - add test buildout, with coverage report and pylint check
          current result is 82% coverage and pylint score is -13.21/10 [garbas]
        - added translation for english and slovenian [garbas]
        
        
        0.2.0 (2009-10-30)
        ^^^^^^^^^^^^^^^^^^
        
        - Compatibility with Plone 4 [sargo]
        - Uninstall profile (unhide plone.comment viewlet, hide collective.disqus
          viewlet) [sargo]
        
        
        0.1.0 (2009-08-13)
        ^^^^^^^^^^^^^^^^^^
        
        - Initial release [sargo]
        
Keywords: plone disqus comments api portlets
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Office/Business :: News/Diary
Classifier: Topic :: Software Development :: Libraries :: Python Modules
