We are no longer offering accounts on this server. Consider https://gitlab.freedesktop.org/ as a place to host projects.

DisqusPlugin.php 8.04 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
<?php
/**
 * StatusNet, the distributed open-source microblogging tool
 *
 * Plugin to add Disqus commenting to notice pages
 *
 * PHP version 5
 *
 * LICENCE: This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @category  Plugin
 * @package   StatusNet
 * @author    Zach Copley <zach@status.net>
 * @copyright 2010 StatusNet, Inc.
 * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
 * @link      http://status.net/
 */

if (!defined('STATUSNET')) {
    exit(1);
}

/**
 *
 * This plugin adds Disqus commenting to your notices. Enabling this
 * plugin will make each notice page display the Disqus widget, and
 * notice lists will display the number of commments each notice has.
 *
 * To use this plugin, you need to first register your site with Disqus
 * and get a Discus 'shortname' for it.
 *
 *    http://disqus.com
 *
 * To enable the plugin, put the following in you config.php:
 *
 * addPlugin(
48 49 50 51
 *     'Disqus', array(
 *         'shortname' => 'YOURSHORTNAME',
 *         'divStyle'  => 'width:675px; padding-top:10px; position:relative; float:left;'
 *     )
52 53
 * );
 *
54
 * If you only want to allow commenting on a specific user's notices or
55 56
 * a specific set of users' notices initialize the plugin with the "restricted"
 * parameter and grant the "richedit" role to those users. E.g.:
57 58 59
 *
 * addPlugin(
 *     'Disqus', array(
60 61 62
 *         'shortname'  => 'YOURSHORTNAME',
 *         'divStyle'   => 'width:675px; padding-top:10px; position:relative; float:left;',
 *         'restricted' => true
63 64 65
 *     )
 * );
 *
66 67
 * $ php userrole.php -s#### -nusername -rrichedit
 *
68 69
 *
 * NOTE: the 'divStyle' in an optional parameter that passes in some
70
 * inline CSS when creating the Disqus widget. It's a shortcut to make
71
 * the widget look OK with the default StatusNet theme. If you leave
72
 * it out you'll have to edit your theme CSS files to make the widget
73 74 75 76
 * look good.  You can also control the way the widget looks by
 * adding style rules to your theme.
 *
 * See: http://help.disqus.com/entries/100878-css-customization
77
 *
78
 *
79 80 81 82 83 84 85 86 87 88
 * @category Plugin
 * @package  StatusNet
 * @author   Zach Copley <zach@status.net>
 * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
 * @link     http://status.net/
 *
 * @see      Event
 */
class DisqusPlugin extends Plugin
{
89 90
    public $shortname; // Required 'shortname' for actually triggering Disqus
    public $divStyle;  // Optional CSS chunk for the main <div>
91 92 93 94 95

    // By default, Disqus commenting will be available to all users.
    // With restricted on, only users who have been granted the
    // "richedit" role get it.
    public $restricted = false;
96 97 98 99 100 101 102

    /**
     * Add a Disqus commenting section to the end of an individual
     * notice page's content block
     *
     * @param Action $action The current action
     */
103 104 105 106
    function onEndShowContentBlock($action)
    {
        if (get_class($action) == 'ShownoticeAction') {

107
            $profile = Profile::staticGet('id', $action->notice->profile_id);
108

109 110 111 112 113 114 115 116
            if ($this->hasCommenting($profile)) {

                $attrs = array();
                $attrs['id'] = 'disqus_thread';

                if ($this->divStyle) {
                    $attrs['style'] = $this->divStyle;
                }
117

118
                $action->element('div', $attrs, null);
119

120 121 122 123 124 125 126
                $script = <<<ENDOFSCRIPT
    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';
       (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
      })();
127 128
ENDOFSCRIPT;

129
                $action->inlineScript(sprintf($script, $action->notice->id, $this->shortname));
130

131
                $attrs = array();
132

133
                $attrs['id'] = 'disqus_thread_footer';
134

135 136 137
                if ($this->divStyle) {
                    $attrs['style'] = $this->divStyle;
                }
138

139 140
                $action->elementStart('div', $attrs);
                $action->elementStart('noscript');
141

142 143 144
                $noScriptMsg = sprintf(_m("Please enable JavaScript to view the [comments powered by Disqus](http://disqus.com/?ref_noscript=%s)."), $this->shortname);
                $output = common_markup_to_html($noScriptMsg);
                $action->raw($output);
145

146
                $action->elementEnd('noscript');
147

148 149 150 151 152 153
                $action->elementStart('a', array('href' => 'http://disqus.com', 'class' => 'dsq-brlink'));
                $action->raw(_m('Comments powered by '));
                $action->element('span', array('class' => 'logo-disqus'), 'Disqus');
                $action->elementEnd('a');
                $action->elementEnd('div');
            }
154 155 156
        }
    }

157 158 159 160 161 162
    /**
     * Add Disqus comment count script to the end of the scripts section
     *
     * @param Action $action the current action
     *
     */
163 164 165 166 167 168 169 170 171 172 173 174 175 176 177
    function onEndShowScripts($action)
    {
        // fugly
        $script = <<<ENDOFSCRIPT
var disqus_shortname = '%s';
(function () {
  var s = document.createElement('script'); s.async = true;
  s.src = 'http://disqus.com/forums/%s/count.js';
  (document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
}());
ENDOFSCRIPT;
        $action->inlineScript(sprintf($script, $this->shortname, $this->shortname));

    }

178
    /**
179
     * Tack on a Disqus comments link to the notice options stanza
180 181 182 183 184
     * (the link displays the total number of comments for each notice)
     *
     * @param NoticeListItem $noticeListItem
     *
     */
185
    function onEndShowNoticeInfo($noticeListItem)
186
    {
187
        // Don't enable commenting for remote notices
188
        if (empty($noticeListItem->notice->is_local)) {
189
            return;
190 191
        }

192
        $profile = Profile::staticGet('id', $noticeListItem->notice->profile_id);
193

194
        if ($this->isAllowedRichEdit($profile)) {
195 196 197 198
            $noticeUrl = $noticeListItem->notice->bestUrl();
            $noticeUrl .= '#disqus_thread';

            $noticeListItem->out->element(
199 200 201
                'a',
                array('href' => $noticeUrl, 'class' => 'disqus_count'),
                _m('Comments')
202 203 204 205 206
            );
        }
    }

    /**
207 208 209
     * Does the current user have permission to use the Disqus plugin?
     * Always true unless the plugin's "restricted" setting is on, in which
     * case it's limited to users with the "richedit" role.
210
     *
211
     * @fixme make that more sanely configurable :)
212 213 214
     *
     * @param Profile $profile the profile to check
     *
215
     * @return boolean
216
     */
217
    private function isAllowedRichEdit($profile)
218
    {
219 220 221 222 223
        if ($this->restricted) {
            $user = User::staticGet($profile->id);
            return !empty($user) && $user->hasRole('richedit');
        } else {
            return true;
224
        }
225 226
    }

227 228 229 230 231 232 233
    /**
     * Plugin details
     *
     * @param &$versions Array of current plugins
     *
     * @return boolean true
     */
234 235 236 237 238 239 240 241 242 243 244 245
    function onPluginVersion(&$versions)
    {
        $versions[] = array('name' => 'Disqus',
                            'version' => STATUSNET_VERSION,
                            'author' => 'Zach Copley',
                            'homepage' => 'http://status.net/wiki/Plugin:Disqus',
                            'rawdescription' =>
                            _m('Use <a href="http://disqus.com/">Disqus</a>'.
                               ' to add commenting to notice pages.'));
        return true;
    }
}