lib/threadednoticelist.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * widget for displaying a list of notices
   6  *
   7  * PHP version 5
   8  *
   9  * LICENCE: This program is free software: you can redistribute it and/or modify
  10  * it under the terms of the GNU Affero General Public License as published by
  11  * the Free Software Foundation, either version 3 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU Affero General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License
  20  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21  *
  22  * @category  UI
  23  * @package   StatusNet
  24  * @author    Brion Vibber <brion@status.net>
  25  * @copyright 2011 StatusNet, Inc.
  26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  27  * @link      http://status.net/
  28  */
  29
  30 if (!defined('GNUSOCIAL')) { exit(1); }
  31
  32 /**
  33  * widget for displaying a list of notices
  34  *
  35  * There are a number of actions that display a list of notices, in
  36  * reverse chronological order. This widget abstracts out most of the
  37  * code for UI for notice lists. It's overridden to hide some
  38  * data for e.g. the profile page.
  39  *
  40  * @category UI
  41  * @package  StatusNet
  42  * @author   Evan Prodromou <evan@status.net>
  43  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  44  * @link     http://status.net/
  45  * @see      Notice
  46  * @see      NoticeListItem
  47  * @see      ProfileNoticeList
  48  */
  49 class ThreadedNoticeList extends NoticeList
  50 {
  51     protected $userProfile;
  52
  53     function __construct(Notice $notice, Action $out=null, $profile=-1)
  54     {
  55         parent::__construct($notice, $out);
  56         if (is_int($profile) && $profile == -1) {
  57             $profile = Profile::current();
  58         }
  59         $this->userProfile = $profile;
  60     }
  61
  62     /**
  63      * show the list of notices
  64      *
  65      * "Uses up" the stream by looping through it. So, probably can't
  66      * be called twice on the same list.
  67      *
  68      * @return int count of notices listed.
  69      */
  70     function show()
  71     {
  72         $this->out->elementStart('div', array('id' =>'notices_primary'));
  73         // TRANS: Header for Notices section.
  74         $this->out->element('h2', null, _m('HEADER','Notices'));
  75         $this->out->elementStart('ol', array('class' => 'notices threaded-notices xoxo'));
  76
  77                 $notices = $this->notice->fetchAll();
  78                 $total = count($notices);
  79                 $notices = array_slice($notices, 0, NOTICES_PER_PAGE);
  80
  81         $allnotices = self::_allNotices($notices);
  82         self::prefill($allnotices);
  83
  84         $conversations = array();
  85
  86         foreach ($notices as $notice) {
  87
  88             // Collapse repeats into their originals...
  89
  90             if ($notice->repeat_of) {
  91                 $orig = Notice::getKV('id', $notice->repeat_of);
  92                 if ($orig instanceof Notice) {
  93                     $notice = $orig;
  94                 }
  95             }
  96             $convo = $notice->conversation;
  97             if (!empty($conversations[$convo])) {
  98                 // Seen this convo already -- skip!
  99                 continue;
 100             }
 101             $conversations[$convo] = true;
 102
 103             // Get the convo's root notice
 104             $root = $notice->conversationRoot($this->userProfile);
 105             if ($root instanceof Notice) {
 106                 $notice = $root;
 107             }
 108
 109             try {
 110                 $item = $this->newListItem($notice);
 111                 $item->show();
 112             } catch (Exception $e) {
 113                 // we log exceptions and continue
 114                 common_log(LOG_ERR, $e->getMessage());
 115                 continue;
 116             }
 117         }
 118
 119         $this->out->elementEnd('ol');
 120         $this->out->elementEnd('div');
 121
 122         return $total;
 123     }
 124
 125     function _allNotices($notices)
 126     {
 127         $convId = array();
 128         foreach ($notices as $notice) {
 129             $convId[] = $notice->conversation;
 130         }
 131         $convId = array_unique($convId);
 132         $allMap = Notice::listGet('conversation', $convId);
 133         $allArray = array();
 134         foreach ($allMap as $convId => $convNotices) {
 135             $allArray = array_merge($allArray, $convNotices);
 136         }
 137         return $allArray;
 138     }
 139
 140     /**
 141      * returns a new list item for the current notice
 142      *
 143      * Recipe (factory?) method; overridden by sub-classes to give
 144      * a different list item class.
 145      *
 146      * @param Notice $notice the current notice
 147      *
 148      * @return NoticeListItem a list item for displaying the notice
 149      */
 150     function newListItem(Notice $notice)
 151     {
 152         return new ThreadedNoticeListItem($notice, $this->out, $this->userProfile);
 153     }
 154 }
 155
 156 /**
 157  * widget for displaying a single notice
 158  *
 159  * This widget has the core smarts for showing a single notice: what to display,
 160  * where, and under which circumstances. Its key method is show(); this is a recipe
 161  * that calls all the other show*() methods to build up a single notice. The
 162  * ProfileNoticeListItem subclass, for example, overrides showAuthor() to skip
 163  * author info (since that's implicit by the data in the page).
 164  *
 165  * @category UI
 166  * @package  StatusNet
 167  * @author   Evan Prodromou <evan@status.net>
 168  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
 169  * @link     http://status.net/
 170  * @see      NoticeList
 171  * @see      ProfileNoticeListItem
 172  */
 173 class ThreadedNoticeListItem extends NoticeListItem
 174 {
 175     protected $userProfile = null;
 176
 177     function __construct(Notice $notice, Action $out=null, $profile=null)
 178     {
 179         parent::__construct($notice, $out);
 180         $this->userProfile = $profile;
 181     }
 182
 183     function initialItems()
 184     {
 185         return 3;
 186     }
 187
 188     /**
 189      * finish the notice
 190      *
 191      * Close the last elements in the notice list item
 192      *
 193      * @return void
 194      */
 195     function showEnd()
 196     {
 197         $max = $this->initialItems();
 198         if (!$this->repeat instanceof Notice) {
 199             $stream = new ConversationNoticeStream($this->notice->conversation, $this->userProfile);
 200             $notice = $stream->getNotices(0, $max + 2);
 201             $notices = array();
 202             $cnt = 0;
 203             $moreCutoff = null;
 204             while ($notice->fetch()) {
 205                 if (Event::handle('StartAddNoticeReply', array($this, $this->notice, $notice))) {
 206                     // Don't list repeats as separate notices in a conversation
 207                     if (!empty($notice->repeat_of)) {
 208                         continue;
 209                     }
 210
 211                     if ($notice->id == $this->notice->id) {
 212                         // Skip!
 213                         continue;
 214                     }
 215                     $cnt++;
 216                     if ($cnt > $max) {
 217                         // boo-yah
 218                         $moreCutoff = clone($notice);
 219                         break;
 220                     }
 221                     $notices[] = clone($notice); // *grumble* inefficient as hell
 222                     Event::handle('EndAddNoticeReply', array($this, $this->notice, $notice));
 223                 }
 224             }
 225
 226             if (Event::handle('StartShowThreadedNoticeTail', array($this, $this->notice, &$notices))) {
 227                 $threadActive = count($notices) > 0; // has this thread had any activity?
 228
 229                 $this->out->elementStart('ul', 'notices threaded-replies xoxo');
 230
 231                 if (Event::handle('StartShowThreadedNoticeTailItems', array($this, $this->notice, &$threadActive))) {
 232                     // Repeats and Faves/Likes are handled in plugins.
 233                     Event::handle('EndShowThreadedNoticeTailItems', array($this, $this->notice, &$threadActive));
 234                 }
 235
 236                 if (count($notices)>0) {
 237                     if ($moreCutoff) {
 238                         $item = new ThreadedNoticeListMoreItem($moreCutoff, $this->out, count($notices));
 239                         $item->show();
 240                     }
 241                     foreach (array_reverse($notices) as $notice) {
 242                         if (Event::handle('StartShowThreadedNoticeSub', array($this, $this->notice, $notice))) {
 243                             $item = new ThreadedNoticeListSubItem($notice, $this->notice, $this->out);
 244                             $item->show();
 245                             Event::handle('EndShowThreadedNoticeSub', array($this, $this->notice, $notice));
 246                         }
 247                     }
 248                 }
 249
 250                 Event::handle('EndShowThreadedNoticeTail', array($this, $this->notice, $notices));
 251                 $this->out->elementEnd('ul');
 252             }
 253         }
 254
 255         parent::showEnd();
 256     }
 257 }
 258
 259 // @todo FIXME: needs documentation.
 260 class ThreadedNoticeListSubItem extends NoticeListItem
 261 {
 262     protected $root = null;
 263
 264     function __construct(Notice $notice, $root, Action $out=null)
 265     {
 266         $this->root = $root;
 267         parent::__construct($notice, $out);
 268     }
 269
 270     function avatarSize()
 271     {
 272         return AVATAR_STREAM_SIZE; // @fixme would like something in between
 273     }
 274
 275     function showNoticeLocation()
 276     {
 277         //
 278     }
 279
 280     function showNoticeSource()
 281     {
 282         //
 283     }
 284
 285     function getReplyProfiles()
 286     {
 287         $all = parent::getReplyProfiles();
 288
 289         $profiles = array();
 290
 291         $rootAuthor = $this->root->getProfile();
 292
 293         foreach ($all as $profile) {
 294             if ($profile->id != $rootAuthor->id) {
 295                 $profiles[] = $profile;
 296             }
 297         }
 298
 299         return $profiles;
 300     }
 301
 302     function showEnd()
 303     {
 304         $threadActive = null;   // unused here for now, but maybe in the future?
 305         if (Event::handle('StartShowThreadedNoticeTailItems', array($this, $this->notice, &$threadActive))) {
 306             // Repeats and Faves/Likes are handled in plugins.
 307             Event::handle('EndShowThreadedNoticeTailItems', array($this, $this->notice, &$threadActive));
 308         }
 309         parent::showEnd();
 310     }
 311 }
 312
 313 /**
 314  * Placeholder for loading more replies...
 315  */
 316 class ThreadedNoticeListMoreItem extends NoticeListItem
 317 {
 318     protected $cnt;
 319
 320     function __construct(Notice $notice, Action $out, $cnt)
 321     {
 322         parent::__construct($notice, $out);
 323         $this->cnt = $cnt;
 324     }
 325
 326     /**
 327      * recipe function for displaying a single notice.
 328      *
 329      * This uses all the other methods to correctly display a notice. Override
 330      * it or one of the others to fine-tune the output.
 331      *
 332      * @return void
 333      */
 334     function show()
 335     {
 336         $this->showStart();
 337         $this->showMiniForm();
 338         $this->showEnd();
 339     }
 340
 341     /**
 342      * start a single notice.
 343      *
 344      * @return void
 345      */
 346     function showStart()
 347     {
 348         $this->out->elementStart('li', array('class' => 'notice-reply-comments'));
 349     }
 350
 351     function showEnd()
 352     {
 353         $this->out->elementEnd('li');
 354     }
 355
 356     function showMiniForm()
 357     {
 358         $id = $this->notice->conversation;
 359         $url = common_local_url('conversation', array('id' => $id));
 360
 361         $n = Conversation::noticeCount($id) - 1;
 362
 363         // TRANS: Link to show replies for a notice.
 364         // TRANS: %d is the number of replies to a notice and used for plural.
 365         $msg = sprintf(_m('Show reply', 'Show all %d replies', $n), $n);
 366
 367         $this->out->element('a', array('href' => $url), $msg);
 368     }
 369 }