plugins/SubMirror/actions/basemirror.php

   1 <?php
   2 /**
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2010, 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  * PHP version 5
  20  *
  21  * @category  Action
  22  * @package   StatusNet
  23  * @author    Brion Vibber <brion@status.net>
  24  * @copyright 2010 StatusNet, Inc.
  25  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  26  * @link      http://status.net/
  27  */
  28
  29 if (!defined('STATUSNET')) {
  30     exit(1);
  31 }
  32
  33 /**
  34  * Takes parameters:
  35  *
  36  *    - feed: a profile ID
  37  *    - token: session token to prevent CSRF attacks
  38  *    - ajax: boolean; whether to return Ajax or full-browser results
  39  *
  40  * Only works if the current user is logged in.
  41  *
  42  * @category  Action
  43  * @package   StatusNet
  44  * @copyright 2010 StatusNet, Inc.
  45  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  46  * @link      http://status.net/
  47  */
  48
  49 abstract class BaseMirrorAction extends Action
  50 {
  51     var $user;
  52     var $profile;
  53
  54     /**
  55      * Check pre-requisites and instantiate attributes
  56      *
  57      * @param Array $args array of arguments (URL, GET, POST)
  58      *
  59      * @return boolean success flag
  60      */
  61
  62     function prepare($args)
  63     {
  64         parent::prepare($args);
  65         return $this->sharedBoilerplate();
  66     }
  67
  68     protected function validateFeedUrl($url)
  69     {
  70         if (common_valid_http_url($url)) {
  71             return $url;
  72         } else {
  73             $this->clientError(_m("Invalid feed URL."));
  74         }
  75     }
  76
  77     protected function validateProfile($id)
  78     {
  79         $id = intval($id);
  80         $profile = Profile::staticGet('id', $id);
  81         if ($profile && $profile->id != $this->user->id) {
  82             return $profile;
  83         }
  84         // TRANS: Error message returned to user when setting up feed mirroring, but we were unable to resolve the given URL to a working feed.
  85         $this->clientError(_m("Invalid profile for mirroring."));
  86     }
  87
  88     /**
  89      *
  90      * @param string $url
  91      * @return Profile
  92      */
  93     protected function profileForFeed($url)
  94     {
  95         $oprofile = Ostatus_profile::ensureProfileURL($url);
  96         if ($oprofile->isGroup()) {
  97             $this->clientError(_m("Can't mirror a StatusNet group at this time."));
  98         }
  99         $this->oprofile = $oprofile; // @fixme ugly side effect :D
 100         return $oprofile->localProfile();
 101     }
 102
 103     /**
 104      * @fixme none of this belongs in end classes
 105      * this stuff belongs in shared code!
 106      */
 107     function sharedBoilerplate()
 108     {
 109         // Only allow POST requests
 110
 111         if ($_SERVER['REQUEST_METHOD'] != 'POST') {
 112             $this->clientError(_('This action only accepts POST requests.'));
 113             return false;
 114         }
 115
 116         // CSRF protection
 117
 118         $token = $this->trimmed('token');
 119
 120         if (!$token || $token != common_session_token()) {
 121             $this->clientError(_('There was a problem with your session token.'.
 122                                  ' Try again, please.'));
 123             return false;
 124         }
 125
 126         // Only for logged-in users
 127
 128         $this->user = common_current_user();
 129
 130         if (empty($this->user)) {
 131             $this->clientError(_('Not logged in.'));
 132             return false;
 133         }
 134         return true;
 135     }
 136
 137     /**
 138      * Handle request
 139      *
 140      * Does the subscription and returns results.
 141      *
 142      * @param Array $args unused.
 143      *
 144      * @return void
 145      */
 146
 147     function handle($args)
 148     {
 149         // Throws exception on error
 150         $this->saveMirror();
 151
 152         if ($this->boolean('ajax')) {
 153             $this->startHTML('text/xml;charset=utf-8');
 154             $this->elementStart('head');
 155             $this->element('title', null, _('Subscribed'));
 156             $this->elementEnd('head');
 157             $this->elementStart('body');
 158             $unsubscribe = new EditMirrorForm($this, $this->profile);
 159             $unsubscribe->show();
 160             $this->elementEnd('body');
 161             $this->elementEnd('html');
 162         } else {
 163             $url = common_local_url('mirrorsettings');
 164             common_redirect($url, 303);
 165         }
 166     }
 167
 168     abstract function saveMirror();
 169 }