lib/messagelistitem.php

   1 <?php
   2 /**
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2011, StatusNet, Inc.
   5  *
   6  * A single list item for showing in a message list
   7  *
   8  * PHP version 5
   9  *
  10  * This program is free software: you can redistribute it and/or modify
  11  * it under the terms of the GNU Affero General Public License as published by
  12  * the Free Software Foundation, either version 3 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU Affero General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Affero General Public License
  21  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22  *
  23  * @category  Widget
  24  * @package   StatusNet
  25  * @author    Evan Prodromou <evan@status.net>
  26  * @copyright 2011 StatusNet, Inc.
  27  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  28  * @link      http://status.net/
  29  */
  30
  31 if (!defined('STATUSNET')) {
  32     // This check helps protect against security problems;
  33     // your code file can't be executed directly from the web.
  34     exit(1);
  35 }
  36
  37 /**
  38  * A single item in a message list
  39  *
  40  * @category  Widget
  41  * @package   StatusNet
  42  * @author    Evan Prodromou <evan@status.net>
  43  * @copyright 2011 StatusNet, Inc.
  44  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  45  * @link      http://status.net/
  46  */
  47 abstract class MessageListItem extends Widget
  48 {
  49     var $message;
  50
  51     /**
  52      * Constructor
  53      *
  54      * @param HTMLOutputter $out     Output context
  55      * @param Message       $message Message to show
  56      */
  57     function __construct($out, $message)
  58     {
  59         parent::__construct($out);
  60         $this->message = $message;
  61     }
  62
  63     /**
  64      * Show the widget
  65      *
  66      * @return void
  67      */
  68     function show()
  69     {
  70         $this->out->elementStart('li', array('class' => 'hentry notice',
  71                                              'id' => 'message-' . $this->message->id));
  72
  73         $profile = $this->getMessageProfile();
  74
  75         $this->out->elementStart('div', 'entry-title');
  76         $this->out->elementStart('span', 'vcard author');
  77         $this->out->elementStart('a', array('href' => $profile->profileurl,
  78                                             'class' => 'url'));
  79         $avatarUrl = $profile->avatarUrl(AVATAR_STREAM_SIZE);
  80         $this->out->element('img', array('src' => $avatarUrl,
  81                                          'class' => 'photo avatar',
  82                                          'width' => AVATAR_STREAM_SIZE,
  83                                          'height' => AVATAR_STREAM_SIZE,
  84                                          'alt' =>
  85                                          ($profile->fullname) ? $profile->fullname :
  86                                          $profile->nickname));
  87         $this->out->element('span', array('class' => 'nickname fn'),
  88                             $profile->nickname);
  89         $this->out->elementEnd('a');
  90         $this->out->elementEnd('span');
  91
  92         // FIXME: URL, image, video, audio
  93         $this->out->elementStart('p', array('class' => 'entry-content'));
  94         $this->out->raw($this->message->rendered);
  95         $this->out->elementEnd('p');
  96         $this->out->elementEnd('div');
  97
  98         $messageurl = common_local_url('showmessage',
  99                                        array('message' => $this->message->id));
 100
 101         // XXX: we need to figure this out better. Is this right?
 102         if (strcmp($this->message->uri, $messageurl) != 0 &&
 103             preg_match('/^http/', $this->message->uri)) {
 104             $messageurl = $this->message->uri;
 105         }
 106
 107         $this->out->elementStart('div', 'entry-content');
 108         $this->out->elementStart('a', array('rel' => 'bookmark',
 109                                             'class' => 'timestamp',
 110                                             'href' => $messageurl));
 111         $dt = common_date_iso8601($this->message->created);
 112         $this->out->element('abbr', array('class' => 'published',
 113                                           'title' => $dt),
 114                             common_date_string($this->message->created));
 115         $this->out->elementEnd('a');
 116
 117         if ($this->message->source) {
 118             $this->out->elementStart('span', 'source');
 119             // FIXME: bad i18n. Device should be a parameter (from %s).
 120             // TRANS: Followed by notice source (usually the client used to send the notice).
 121             $this->out->text(_('from'));
 122             $this->showSource($this->message->source);
 123             $this->out->elementEnd('span');
 124         }
 125         $this->out->elementEnd('div');
 126
 127         $this->out->elementEnd('li');
 128     }
 129
 130     /**
 131      * Dummy method. Serves no other purpose than to make strings available used
 132      * in self::showSource() through xgettext.
 133      *
 134      * @return void
 135      */
 136     function messageListItemDummyMessages()
 137     {
 138         // A dummy array with messages. These will get extracted by xgettext and
 139         // are used in self::showSource().
 140         $dummy_messages = array(
 141             // TRANS: A possible notice source (web interface).
 142             _m('SOURCE','web'),
 143             // TRANS: A possible notice source (XMPP).
 144             _m('SOURCE','xmpp'),
 145             // TRANS: A possible notice source (e-mail).
 146             _m('SOURCE','mail'),
 147             // TRANS: A possible notice source (OpenMicroBlogging).
 148             _m('SOURCE','omb'),
 149             // TRANS: A possible notice source (Application Programming Interface).
 150             _m('SOURCE','api'),
 151         );
 152     }
 153
 154     /**
 155      * Show the source of the message
 156      *
 157      * Returns either the name (and link) of the API client that posted the notice,
 158      * or one of other other channels.
 159      *
 160      * @param string $source the source of the message
 161      *
 162      * @return void
 163      */
 164     function showSource($source)
 165     {
 166         $source_name = _m('SOURCE',$source);
 167         switch ($source) {
 168         case 'web':
 169         case 'xmpp':
 170         case 'mail':
 171         case 'omb':
 172         case 'api':
 173             $this->out->element('span', 'device', $source_name);
 174             break;
 175         default:
 176             $ns = Notice_source::getKV($source);
 177             if ($ns) {
 178                 $this->out->elementStart('span', 'device');
 179                 $this->out->element('a', array('href' => $ns->url,
 180                                                'rel' => 'external'),
 181                                     $ns->name);
 182                 $this->out->elementEnd('span');
 183             } else {
 184                 $this->out->element('span', 'device', $source_name);
 185             }
 186             break;
 187         }
 188         return;
 189     }
 190
 191     /**
 192      * Return the profile to show in the message item
 193      *
 194      * Overridden in sub-classes to show sender, receiver, or whatever
 195      *
 196      * @return Profile profile to show avatar and name of
 197      */
 198     abstract function getMessageProfile();
 199 }