actions/showgroup.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * Group main page
   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  Group
  23  * @package   StatusNet
  24  * @author    Evan Prodromou <evan@status.net>
  25  * @author    Sarven Capadisli <csarven@status.net>
  26  * @copyright 2008-2011 StatusNet, Inc.
  27  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  28  * @link      http://status.net/
  29  */
  30
  31 if (!defined('STATUSNET') && !defined('LACONICA')) {
  32     exit(1);
  33 }
  34
  35 require_once INSTALLDIR.'/lib/noticelist.php';
  36 require_once INSTALLDIR.'/lib/feedlist.php';
  37
  38 /**
  39  * Group main page
  40  *
  41  * @category Group
  42  * @package  StatusNet
  43  * @author   Evan Prodromou <evan@status.net>
  44  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  45  * @link     http://status.net/
  46  */
  47 class ShowgroupAction extends GroupAction
  48 {
  49     /** page we're viewing. */
  50     var $page = null;
  51     var $userProfile = null;
  52     var $notice = null;
  53
  54     /**
  55      * Is this page read-only?
  56      *
  57      * @return boolean true
  58      */
  59     function isReadOnly($args)
  60     {
  61         return true;
  62     }
  63
  64     /**
  65      * Title of the page
  66      *
  67      * @return string page title, with page number
  68      */
  69     function title()
  70     {
  71         $base = $this->group->getFancyName();
  72
  73         if ($this->page == 1) {
  74             // TRANS: Page title for first group page. %s is a group name.
  75             return sprintf(_('%s group'), $base);
  76         } else {
  77             // TRANS: Page title for any but first group page.
  78             // TRANS: %1$s is a group name, $2$s is a page number.
  79             return sprintf(_('%1$s group, page %2$d'),
  80                            $base,
  81                            $this->page);
  82         }
  83     }
  84
  85     /**
  86      * Prepare the action
  87      *
  88      * Reads and validates arguments and instantiates the attributes.
  89      *
  90      * @param array $args $_REQUEST args
  91      *
  92      * @return boolean success flag
  93      */
  94     function prepare($args)
  95     {
  96         parent::prepare($args);
  97
  98         $this->page = ($this->arg('page')) ? ($this->arg('page')+0) : 1;
  99
 100
 101         $this->userProfile = Profile::current();
 102
 103         $stream = new ThreadingGroupNoticeStream($this->group, $this->userProfile);
 104
 105         $this->notice = $stream->getNotices(($this->page-1)*NOTICES_PER_PAGE,
 106                                             NOTICES_PER_PAGE + 1);
 107
 108         common_set_returnto($this->selfUrl());
 109
 110         return true;
 111     }
 112
 113     /**
 114      * Handle the request
 115      *
 116      * Shows a profile for the group, some controls, and a list of
 117      * group notices.
 118      *
 119      * @return void
 120      */
 121     function handle($args)
 122     {
 123         $this->showPage();
 124     }
 125
 126     /**
 127      * Show the page content
 128      *
 129      * Shows a group profile and a list of group notices
 130      */
 131     function showContent()
 132     {
 133         $this->showGroupNotices();
 134     }
 135
 136     /**
 137      * Show the group notices
 138      *
 139      * @return void
 140      */
 141     function showGroupNotices()
 142     {
 143         $nl = new ThreadedNoticeList($this->notice, $this, $this->userProfile);
 144         $cnt = $nl->show();
 145
 146         $this->pagination($this->page > 1,
 147                           $cnt > NOTICES_PER_PAGE,
 148                           $this->page,
 149                           'showgroup',
 150                           array('nickname' => $this->group->nickname));
 151     }
 152
 153     /**
 154      * Get a list of the feeds for this page
 155      *
 156      * @return void
 157      */
 158     function getFeeds()
 159     {
 160         $url =
 161           common_local_url('grouprss',
 162                            array('nickname' => $this->group->nickname));
 163
 164         return array(new Feed(Feed::JSON,
 165                               common_local_url('ApiTimelineGroup',
 166                                                array('format' => 'as',
 167                                                      'id' => $this->group->id)),
 168                               // TRANS: Tooltip for feed link. %s is a group nickname.
 169                               sprintf(_('Notice feed for %s group (Activity Streams JSON)'),
 170                                       $this->group->nickname)),
 171                     new Feed(Feed::RSS1,
 172                               common_local_url('grouprss',
 173                                                array('nickname' => $this->group->nickname)),
 174                               // TRANS: Tooltip for feed link. %s is a group nickname.
 175                               sprintf(_('Notice feed for %s group (RSS 1.0)'),
 176                                       $this->group->nickname)),
 177                      new Feed(Feed::RSS2,
 178                               common_local_url('ApiTimelineGroup',
 179                                                array('format' => 'rss',
 180                                                      'id' => $this->group->id)),
 181                               // TRANS: Tooltip for feed link. %s is a group nickname.
 182                               sprintf(_('Notice feed for %s group (RSS 2.0)'),
 183                                       $this->group->nickname)),
 184                      new Feed(Feed::ATOM,
 185                               common_local_url('ApiTimelineGroup',
 186                                                array('format' => 'atom',
 187                                                      'id' => $this->group->id)),
 188                               // TRANS: Tooltip for feed link. %s is a group nickname.
 189                               sprintf(_('Notice feed for %s group (Atom)'),
 190                                       $this->group->nickname)),
 191                      new Feed(Feed::FOAF,
 192                               common_local_url('foafgroup',
 193                                                array('nickname' => $this->group->nickname)),
 194                               // TRANS: Tooltip for feed link. %s is a group nickname.
 195                               sprintf(_('FOAF for %s group'),
 196                                        $this->group->nickname)));
 197     }
 198
 199     function showAnonymousMessage()
 200     {
 201         if (!(common_config('site','closed') || common_config('site','inviteonly'))) {
 202             // @todo FIXME: use group full name here if available instead of (uglier) primary alias.
 203             // TRANS: Notice on group pages for anonymous users for StatusNet sites that accept new registrations.
 204             // TRANS: **%s** is the group alias, %%%%site.name%%%% is the site name,
 205             // TRANS: %%%%action.register%%%% is the URL for registration, %%%%doc.help%%%% is a URL to help.
 206             // TRANS: This message contains Markdown links. Ensure they are formatted correctly: [Description](link).
 207             $m = sprintf(_('**%s** is a user group on %%%%site.name%%%%, a [micro-blogging](http://en.wikipedia.org/wiki/Micro-blogging) service ' .
 208                 'based on the Free Software [StatusNet](http://status.net/) tool. Its members share ' .
 209                 'short messages about their life and interests. '.
 210                 '[Join now](%%%%action.register%%%%) to become part of this group and many more! ([Read more](%%%%doc.help%%%%))'),
 211                      $this->group->nickname);
 212         } else {
 213             // @todo FIXME: use group full name here if available instead of (uglier) primary alias.
 214             // TRANS: Notice on group pages for anonymous users for StatusNet sites that accept no new registrations.
 215             // TRANS: **%s** is the group alias, %%%%site.name%%%% is the site name,
 216             // TRANS: This message contains Markdown links. Ensure they are formatted correctly: [Description](link).
 217             $m = sprintf(_('**%s** is a user group on %%%%site.name%%%%, a [micro-blogging](http://en.wikipedia.org/wiki/Micro-blogging) service ' .
 218                 'based on the Free Software [StatusNet](http://status.net/) tool. Its members share ' .
 219                 'short messages about their life and interests. '),
 220                      $this->group->nickname);
 221         }
 222         $this->elementStart('div', array('id' => 'anon_notice'));
 223         $this->raw(common_markup_to_html($m));
 224         $this->elementEnd('div');
 225     }
 226 }