. * * @category Personal * @package StatusNet * @author Evan Prodromou * @copyright 2008-2011 StatusNet, Inc. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 * @link http://status.net/ */ if (!defined('GNUSOCIAL')) { exit(1); } require_once INSTALLDIR.'/lib/noticelist.php'; /** * Show a single notice * * @category Personal * @package StatusNet * @author Evan Prodromou * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 * @link http://status.net/ */ class ShownoticeAction extends Action { /** * Notice object to show */ var $notice = null; /** * Profile of the notice object */ var $profile = null; /** * Avatar of the profile of the notice object */ var $avatar = null; /** * Load attributes based on database arguments * * Loads all the DB stuff * * @param array $args $_REQUEST array * * @return success flag */ protected function prepare(array $args=array()) { parent::prepare($args); if ($this->boolean('ajax')) { StatusNet::setApi(true); } $this->notice = $this->getNotice(); if (!$this->notice->inScope($this->scoped)) { // TRANS: Client exception thrown when trying a view a notice the user has no access to. throw new ClientException(_('Not available.'), 403); } $this->profile = $this->notice->getProfile(); if (!$this->profile instanceof Profile) { // TRANS: Server error displayed trying to show a notice without a connected profile. $this->serverError(_('Notice has no profile.'), 500); } try { $this->user = $this->profile->getUser(); } catch (NoSuchUserException $e) { // FIXME: deprecate $this->user stuff in extended classes $this->user = null; } try { $this->avatar = $this->profile->getAvatar(AVATAR_PROFILE_SIZE); } catch (Exception $e) { $this->avatar = null; } return true; } /** * Fetch the notice to show. This may be overridden by child classes to * customize what we fetch without duplicating all of the prepare() method. * * @return Notice */ protected function getNotice() { $id = $this->arg('notice'); $notice = Notice::getKV('id', $id); if ($notice instanceof Notice) { // Alright, got it! return $notice; } // Did we use to have it, and it got deleted? $deleted = Deleted_notice::getKV('id', $id); if ($deleted instanceof Deleted_notice) { // TRANS: Client error displayed trying to show a deleted notice. $this->clientError(_('Notice deleted.'), 410); } // TRANS: Client error displayed trying to show a non-existing notice. $this->clientError(_('No such notice.'), 404); } /** * Is this action read-only? * * @return boolean true */ function isReadOnly($args) { return true; } /** * Last-modified date for page * * When was the content of this page last modified? Based on notice, * profile, avatar. * * @return int last-modified date as unix timestamp */ function lastModified() { return max(strtotime($this->notice->modified), strtotime($this->profile->modified), ($this->avatar) ? strtotime($this->avatar->modified) : 0); } /** * An entity tag for this page * * Shows the ETag for the page, based on the notice ID and timestamps * for the notice, profile, and avatar. It's weak, since we change * the date text "one hour ago", etc. * * @return string etag */ function etag() { $avtime = ($this->avatar) ? strtotime($this->avatar->modified) : 0; return 'W/"' . implode(':', array($this->arg('action'), common_user_cache_hash(), common_language(), $this->notice->id, strtotime($this->notice->created), strtotime($this->profile->modified), $avtime)) . '"'; } /** * Title of the page * * @return string title of the page */ function title() { $base = $this->profile->getFancyName(); // TRANS: Title of the page that shows a notice. // TRANS: %1$s is a user name, %2$s is the notice creation date/time. return sprintf(_('%1$s\'s status on %2$s'), $base, common_exact_date($this->notice->created)); } /** * Handle input * * Only handles get, so just show the page. * * @param array $args $_REQUEST data (unused) * * @return void */ protected function handle() { parent::handle(); if (StatusNet::isAjax()) { $this->showAjax(); } else { $this->showPage(); } } /** * Fill the content area of the page * * Shows a single notice list item. * * @return void */ function showContent() { $this->elementStart('ol', array('class' => 'notices xoxo')); $nli = new SingleNoticeItem($this->notice, $this); $nli->show(); $this->elementEnd('ol'); } function showAjax() { $this->startHTML('text/xml;charset=utf-8'); $this->elementStart('head'); // TRANS: Title for page that shows a notice. $this->element('title', null, _m('TITLE','Notice')); $this->elementEnd('head'); $this->elementStart('body'); $nli = new NoticeListItem($this->notice, $this); $nli->show(); $this->elementEnd('body'); $this->endHTML(); } /** * Don't show page notice * * @return void */ function showPageNoticeBlock() { } /** * Don't show aside * * @return void */ function showAside() { } /** * Extra content * * We show the microid(s) for the author, if any. * * @return void */ function extraHead() { $user = User::getKV($this->profile->id); if (!$user) { return; } if ($user->emailmicroid && $user->email && $this->notice->uri) { $id = new Microid('mailto:'. $user->email, $this->notice->uri); $this->element('meta', array('name' => 'microid', 'content' => $id->toString())); } // Extras to aid in sharing notices to Facebook $avatarUrl = $this->profile->avatarUrl(AVATAR_PROFILE_SIZE); $this->element('meta', array('property' => 'og:image', 'content' => $avatarUrl)); $this->element('meta', array('property' => 'og:description', 'content' => $this->notice->content)); } } // @todo FIXME: Class documentation missing. class SingleNoticeItem extends DoFollowListItem { function avatarSize() { return AVATAR_STREAM_SIZE; } }