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(
* '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,24 +83,35 @@ if (!defined('STATUSNET')) {
*/
class DisqusPlugin extends Plugin
{
public $shortname; // Required 'shortname' for actually triggering Disqus.
public $div_style; // Optional CSS chunk for the main <div>
public $shortname; // Required 'shortname' for actually triggering Disqus
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) {
$attrs['style'] = $this->div_style;
if ($this->divStyle) {
$attrs['style'] = $this->divStyle;
}
$action->element('div', $attrs, null);
$script = <<<ENDOFSCRIPT
var disqus_identifier = %d;
var disqus_identifier = %d;
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = 'http://%s.disqus.com/embed.js';
@ -101,8 +125,8 @@ ENDOFSCRIPT;
$attrs['id'] = 'disqus_thread_footer';
if ($this->div_style) {
$attrs['style'] = $this->div_style;
if ($this->divStyle) {
$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',