actions/file.php

   1 <?php
   2 /*
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2008, 2009, StatusNet, Inc.
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU Affero General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 if (!defined('STATUSNET') && !defined('LACONICA')) { exit(1); }
  21
  22 require_once(INSTALLDIR.'/actions/shownotice.php');
  23
  24 // @todo FIXME: Add documentation.
  25 class FileAction extends Action
  26 {
  27     var $id = null;
  28     var $filerec = null;
  29
  30     function prepare($args)
  31     {
  32         parent::prepare($args);
  33         $this->id = $this->trimmed('notice');
  34         if (empty($this->id)) {
  35             // TRANS: Client error displayed when no notice ID was given trying do display a file.
  36             $this->clientError(_('No notice ID.'));
  37         }
  38         $notice = Notice::getKV('id', $this->id);
  39         if (empty($notice)) {
  40             // TRANS: Client error displayed when an invalid notice ID was given trying do display a file.
  41             $this->clientError(_('No notice.'));
  42         }
  43         $atts = $notice->attachments();
  44         if (empty($atts)) {
  45             // TRANS: Client error displayed when trying do display a file for a notice without a file attachement.
  46             $this->clientError(_('No attachments.'));
  47         }
  48         foreach ($atts as $att) {
  49             if (!empty($att->filename)) {
  50                 $this->filerec = $att;
  51                 break;
  52             }
  53         }
  54         if (empty($this->filerec)) {
  55             // XXX: Is this translation hint correct? If yes, please remove comment, if no, please correct and remove comment.
  56             // TRANS: Client error displayed when trying do display a file for a notice with file attachements
  57             // TRANS: that could not be found.
  58             $this->clientError(_('No uploaded attachments.'));
  59         }
  60         return true;
  61     }
  62
  63     function handle() {
  64         common_redirect($this->filerec->url);
  65     }
  66
  67     /**
  68      * Is this action read-only?
  69      *
  70      * @return boolean true
  71      */
  72     function isReadOnly($args)
  73     {
  74         return true;
  75     }
  76 }