Optionally restrict Disqus comments to specific users' notices

plugins/Disqus/DisqusPlugin.php

@@ -47,11 +47,23 @@ if (!defined('STATUSNET')) {
  * addPlugin(
  *     'Disqus', array(
  *         'shortname' => 'YOURSHORTNAME',
- *      'div_style' => 'width:675px; padding-top:10px; position:relative; float:left;'
+ *         'divStyle'  => 'width:675px; padding-top:10px; position:relative; float:left;'
  *     )
  * );
  *
- * NOTE: the 'div_style' in an optional parameter that passes in some
+ * If you only want to allow commenting on a specific user's notices or
+ * a specific set of user's notices, use the "nicknames" array, e.g.:
+ *
+ * addPlugin(
+ *     'Disqus', array(
+ *         'shortname' => 'YOURSHORTNAME',
+ *         'divStyle'  => 'width:675px; padding-top:10px; position:relative; float:left;',
+ *         'nicknames' => array('spock', 'kirk', 'bones')
+ *     )
+ * );
+ *
+ *
+ * NOTE: the 'divStyle' in an optional parameter that passes in some
  * inline CSS when creating the Disqus widget. It's a shortcut to make
  * the widget look OK with the default StatusNet theme. If you leave
  * it out you'll have to edit your theme CSS files to make the widget
@@ -60,6 +72,7 @@ if (!defined('STATUSNET')) {
  *
  * See: http://help.disqus.com/entries/100878-css-customization
  *
+ *
  * @category Plugin
  * @package  StatusNet
  * @author   Zach Copley <zach@status.net>
@@ -70,18 +83,29 @@ if (!defined('STATUSNET')) {
  */
 class DisqusPlugin extends Plugin
 {
-    public $shortname; // Required 'shortname' for actually triggering Disqus.
+    public $shortname; // Required 'shortname' for actually triggering Disqus
-    public $div_style; // Optional CSS chunk for the main <div>
+    public $divStyle;  // Optional CSS chunk for the main <div>
+    public $nicknames; // Optional array of nicks to restrict commenting to (default on for all users)
 
+    /**
+     * Add a Disqus commenting section to the end of an individual
+     * notice page's content block
+     *
+     * @param Action $action The current action
+     */
     function onEndShowContentBlock($action)
     {
         if (get_class($action) == 'ShownoticeAction') {
 
+            $profile = Profile::staticGet('id', $action->notice->profile_id);
+
+            if ($this->hasCommenting($profile)) {
+
                 $attrs = array();
                 $attrs['id'] = 'disqus_thread';
 
-            if ($this->div_style) {
+                if ($this->divStyle) {
-                $attrs['style'] = $this->div_style;
+                    $attrs['style'] = $this->divStyle;
                 }
 
                 $action->element('div', $attrs, null);
@@ -101,8 +125,8 @@ ENDOFSCRIPT;
 
                 $attrs['id'] = 'disqus_thread_footer';
 
-            if ($this->div_style) {
+                if ($this->divStyle) {
-                $attrs['style'] = $this->div_style;
+                    $attrs['style'] = $this->divStyle;
                 }
 
                 $action->elementStart('div', $attrs);
@@ -121,7 +145,14 @@ ENDOFSCRIPT;
                 $action->elementEnd('div');
             }
         }
+    }
 
+    /**
+     * Add Disqus comment count script to the end of the scripts section
+     *
+     * @param Action $action the current action
+     *
+     */
     function onEndShowScripts($action)
     {
         // fugly
@@ -135,15 +166,29 @@ var disqus_shortname = '%s';
 ENDOFSCRIPT;
         $action->inlineScript(sprintf($script, $this->shortname, $this->shortname));
 
-        return true;
     }
 
+    /**
+     * Override the default Notice display to add Disqus comments link
+     * (the link displays the total number of comments for each notice)
+     *
+     * @param NoticeListItem $noticeListItem
+     *
+     * @return boolean override
+     */
     function onStartShowNoticeItem($noticeListItem)
     {
+        // Don't enable commenting for remote notices
         if (empty($noticeListItem->notice->is_local)) {
             return true;
         }
 
+        $profile = Profile::staticGet('id', $noticeListItem->notice->profile_id);
+
+        if ($this->hasCommenting($profile)) {
+
+            // @todo Refactor individual notice display to have it's own event hooks
+
             $noticeListItem->showNotice();
             $noticeListItem->showNoticeInfo();
 
@@ -158,8 +203,43 @@ ENDOFSCRIPT;
             Event::handle('EndShowNoticeItem', array($noticeListItem));
 
             return false;
+        } else {
+            return true;
+        }
     }
 
+    /**
+     * Helper to check whether commenting should be enabled
+     * for a given notice
+     *
+     * Assumes commenting should be enabled, unless the
+     * nicknames array is populated
+     *
+     * @param Profile $profile the profile to check
+     *
+     * @return boolean true if yes
+     */
+    private function hasCommenting($profile)
+    {
+        if (!empty($this->nicknames)) {
+            foreach ($this->nicknames as $nickname) {
+                if ($profile->nickname == $nickname) {
+                    return true;
+                }
+            }
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Plugin details
+     *
+     * @param &$versions Array of current plugins
+     *
+     * @return boolean true
+     */
     function onPluginVersion(&$versions)
     {
         $versions[] = array('name' => 'Disqus',