]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - actions/grouprss.php
Document messages for which clarification was requested.
[quix0rs-gnu-social.git] / actions / grouprss.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-2009 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/rssaction.php';
36
37 define('MEMBERS_PER_SECTION', 27);
38
39 /**
40  * Group RSS feed
41  *
42  * @category Group
43  * @package  StatusNet
44  * @author   Evan Prodromou <evan@status.net>
45  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
46  * @link     http://status.net/
47  */
48
49 class groupRssAction extends Rss10Action
50 {
51     /** group we're viewing. */
52     var $group = null;
53
54     /**
55      * Is this page read-only?
56      *
57      * @return boolean true
58      */
59
60     function isReadOnly($args)
61     {
62         return true;
63     }
64
65     /**
66      * Prepare the action
67      *
68      * Reads and validates arguments and instantiates the attributes.
69      *
70      * @param array $args $_REQUEST args
71      *
72      * @return boolean success flag
73      */
74
75     function prepare($args)
76     {
77         parent::prepare($args);
78
79         $nickname_arg = $this->arg('nickname');
80         $nickname = common_canonical_nickname($nickname_arg);
81
82         // Permanent redirect on non-canonical nickname
83
84         if ($nickname_arg != $nickname) {
85             $args = array('nickname' => $nickname);
86             common_redirect(common_local_url('showgroup', $args), 301);
87             return false;
88         }
89
90         if (!$nickname) {
91             $this->clientError(_('No nickname.'), 404);
92             return false;
93         }
94
95         $local = Local_group::staticGet('nickname', $nickname);
96
97         if (!$local) {
98             $this->clientError(_('No such group.'), 404);
99             return false;
100         }
101
102         $this->group = User_group::staticGet('id', $local->group_id);
103
104         if (!$this->group) {
105             $this->clientError(_('No such group.'), 404);
106             return false;
107         }
108
109         $this->notices = $this->getNotices($this->limit);
110         return true;
111     }
112
113     function getNotices($limit=0)
114     {
115
116         $group = $this->group;
117
118         if (is_null($group)) {
119             return null;
120         }
121
122         $notices = array();
123         $notice = $group->getNotices(0, ($limit == 0) ? NOTICES_PER_PAGE : $limit);
124
125         while ($notice->fetch()) {
126             $notices[] = clone($notice);
127         }
128
129         return $notices;
130     }
131
132     function getChannel()
133     {
134         $group = $this->group;
135         $c = array('url' => common_local_url('grouprss',
136                                              array('nickname' =>
137                                                    $group->nickname)),
138                    // TRANS: Message is used as link title. %s is a user nickname.
139                    'title' => sprintf(_('%s timeline'), $group->nickname),
140                    'link' => common_local_url('showgroup', array('nickname' => $group->nickname)),
141                    // TRANS: Message is used as link description. %1$s is a username, %2$s is a site name.
142                    'description' => sprintf(_('Updates from members of %1$s on %2$s!'),
143                                             $group->nickname, common_config('site', 'name')));
144         return $c;
145     }
146
147     function getImage()
148     {
149         return $this->group->homepage_logo;
150     }
151 }