3 * StatusNet - the distributed open-source microblogging tool
4 * Copyright (C) 2010, StatusNet, Inc.
6 * Notice stream of notices with a given attachment
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.
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.
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/>.
25 * @author Evan Prodromou <evan@status.net>
26 * @copyright 2010 StatusNet, Inc.
27 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
28 * @link http://status.net/
31 if (!defined('STATUSNET')) {
32 // This check helps protect against security problems;
33 // your code file can't be executed directly from the web.
38 * List notices that contain/link to/use a given URL
42 * @author Evan Prodromou <evan@status.net>
43 * @copyright 2010 StatusNet, Inc.
44 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
45 * @link http://status.net/
47 class NoticebyurlAction extends Action
49 protected $url = null;
50 protected $file = null;
51 protected $notices = null;
52 protected $page = null;
55 * For initializing members of the class.
57 * @param array $args misc. arguments
59 * @return boolean true
60 * @throws ClientException
62 function prepare(array $args = [])
64 parent::prepare($args);
66 $this->file = File::getKV('id', $this->trimmed('id'));
68 if (empty($this->file)) {
69 // TRANS: Client exception thrown when an unknown URL is provided.
70 throw new ClientException(_m('Unknown URL.'));
73 $pageArg = $this->trimmed('page');
75 $this->page = (empty($pageArg)) ? 1 : intval($pageArg);
77 $this->notices = $this->file->stream(($this->page - 1) * NOTICES_PER_PAGE,
78 NOTICES_PER_PAGE + 1);
86 * @return string page title
90 if ($this->page == 1) {
91 // TRANS: Title of notice stream of notices with a given attachment (first page).
92 // TRANS: %s is the URL.
93 return sprintf(_m('Notices linking to %s'), $this->file->url);
95 // TRANS: Title of notice stream of notices with a given attachment (all but first page).
96 // TRANS: %1$s is the URL, %2$s is the page number.
97 return sprintf(_m('Notices linking to %1$s, page %2$d'),
114 * Show main page content.
116 * Shows a list of the notices that link to the given URL
120 function showContent()
122 $nl = new NoticeList($this->notices, $this);
128 $this->pagination($this->page > 1,
129 $cnt > NOTICES_PER_PAGE,
132 array('id' => $this->file->id));
136 * Return true if read only.
140 * @param array $args other arguments
142 * @return boolean is read only action?
144 function isReadOnly($args)
150 * Return last modified, if applicable.
154 * @return string last modified http header
156 function lastModified()
158 // For comparison with If-Last-Modified
159 // If not applicable, return null
164 * Return etag, if applicable.
168 * @return string etag http header