"""

 This module enables support fot the Disqus comment system.

 This module requires the following configuration parameters:

     disqus_short_name - The short name of the website account 

                         in Disqus.

 The following parameters are optional:

     disqus_developer - A boolean value for allowing testing on a private 

                        server. See http://disqus.com/help/#faq-14

 The comments are enabled for the flavours that contain a template file named:

     disqus-enabled.

 For example, for enabling the comments for the flavour 'html', an empty file

 named 'disqus-enabled.html' must be created under the directory 'html.flav'.

 This program is distributed under the BSD license.

 """

 __author__ = "Juan Manuel Caicedo"

 __version__ = "0.1"

 __url__ = "http://cavorite.com/labs/pyblosxom-disqus/"

 __description__ = "Allows to use the service Disqus for comments on each blog entry."

 def cb_start(args):

     """

     Sets the defaults values for the optional configuration properties.

     """

     request = args["request"]

     config = request.getConfiguration()

     if not config.has_key('disqus_developer'):

         config['disqus_developer'] = False

 def verify_installation(request):

     """

     Verifies the plugin installation checking for the required configuration properties.

     """

     config = request.getConfiguration()

     retval = 1

     if not config.has_key('disqus_short_name'):

         print 'The "short name" of the Disqus account dmust be specified in the config file'

         retval = 0

     return retval

 def cb_story(args):

     """

     Adds the Disqus code for embedding the comments.

     """

     renderer = args['renderer']

     entry = args['entry']

     template = args['template']

     request = args["request"]

     data = request.getData()

     config = request.getConfiguration()

     if len(renderer.getContent()) == 1 \

             and renderer.flavour.has_key('disqus-enabled') \

             and not entry.has_key("nocomments"):

         short_name = config['disqus_short_name']

         template = '<div id="disqus_thread"></div>'

         if config.get('disqus_developer'):

             template = template + '''

             <script type="text/javascript" >

             var disqus_developer = 1;

             </script>

             '''

         template = template + '''<script type="text/javascript" src="http://disqus.com/forums/%(short_name)s/embed.js"></script><noscript><a href="http://%(short_name)s.disqus.com/?url=ref">View the discussion thread.</a></noscript><a href="http://disqus.com" class="dsq-brlink">blog comments powered by <span class="logo-disqus">Disqus</span></a>''' % {'short_name': short_name}

         args['template'] = args['template'] + template

     return template