Optionally restrict Disqus comments to specific users' notices

This commit is contained in:
Zach Copley 2010-09-24 18:29:02 -07:00
parent 7721e64a42
commit dc63626641

View File

@ -47,11 +47,23 @@ if (!defined('STATUSNET')) {
* addPlugin( * addPlugin(
* 'Disqus', array( * 'Disqus', array(
* 'shortname' => 'YOURSHORTNAME', * '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 * 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 * 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 * 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 * See: http://help.disqus.com/entries/100878-css-customization
* *
*
* @category Plugin * @category Plugin
* @package StatusNet * @package StatusNet
* @author Zach Copley <zach@status.net> * @author Zach Copley <zach@status.net>
@ -70,18 +83,29 @@ if (!defined('STATUSNET')) {
*/ */
class DisqusPlugin extends Plugin 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) function onEndShowContentBlock($action)
{ {
if (get_class($action) == 'ShownoticeAction') { if (get_class($action) == 'ShownoticeAction') {
$profile = Profile::staticGet('id', $action->notice->profile_id);
if ($this->hasCommenting($profile)) {
$attrs = array(); $attrs = array();
$attrs['id'] = 'disqus_thread'; $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); $action->element('div', $attrs, null);
@ -101,8 +125,8 @@ ENDOFSCRIPT;
$attrs['id'] = 'disqus_thread_footer'; $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); $action->elementStart('div', $attrs);
@ -121,7 +145,14 @@ ENDOFSCRIPT;
$action->elementEnd('div'); $action->elementEnd('div');
} }
} }
}
/**
* Add Disqus comment count script to the end of the scripts section
*
* @param Action $action the current action
*
*/
function onEndShowScripts($action) function onEndShowScripts($action)
{ {
// fugly // fugly
@ -135,15 +166,29 @@ var disqus_shortname = '%s';
ENDOFSCRIPT; ENDOFSCRIPT;
$action->inlineScript(sprintf($script, $this->shortname, $this->shortname)); $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) function onStartShowNoticeItem($noticeListItem)
{ {
// Don't enable commenting for remote notices
if (empty($noticeListItem->notice->is_local)) { if (empty($noticeListItem->notice->is_local)) {
return true; 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->showNotice();
$noticeListItem->showNoticeInfo(); $noticeListItem->showNoticeInfo();
@ -158,8 +203,43 @@ ENDOFSCRIPT;
Event::handle('EndShowNoticeItem', array($noticeListItem)); Event::handle('EndShowNoticeItem', array($noticeListItem));
return false; 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) function onPluginVersion(&$versions)
{ {
$versions[] = array('name' => 'Disqus', $versions[] = array('name' => 'Disqus',