actions/oauthappssettings.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * List the OAuth applications that a user has registered with this instance
   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  Settings
  23  * @package   StatusNet
  24  * @author    Zach Copley <zach@status.net>
  25  * @copyright 2008-2009 StatusNet, Inc.
  26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  27  * @link      http://status.net/
  28  */
  29
  30 if (!defined('STATUSNET') && !defined('LACONICA')) {
  31     exit(1);
  32 }
  33
  34 require_once INSTALLDIR . '/lib/applicationlist.php';
  35
  36 /**
  37  * Show a user's registered OAuth applications
  38  *
  39  * @category Settings
  40  * @package  StatusNet
  41  * @author   Zach Copley <zach@status.net>
  42  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  43  * @link     http://status.net/
  44  *
  45  * @see      SettingsAction
  46  */
  47
  48 class OauthappssettingsAction extends SettingsAction
  49 {
  50     var $page = 0;
  51
  52     function prepare($args)
  53     {
  54         parent::prepare($args);
  55         $this->page = ($this->arg('page')) ? ($this->arg('page') + 0) : 1;
  56
  57         if (!common_logged_in()) {
  58             // TRANS: Message displayed to an anonymous user trying to view OAuth application list.
  59             $this->clientError(_('You must be logged in to list your applications.'));
  60         }
  61
  62         return true;
  63     }
  64
  65     /**
  66      * Title of the page
  67      *
  68      * @return string Title of the page
  69      */
  70
  71     function title()
  72     {
  73         // TRANS: Page title for OAuth applications
  74         return _('OAuth applications');
  75     }
  76
  77     /**
  78      * Instructions for use
  79      *
  80      * @return instructions for use
  81      */
  82
  83     function getInstructions()
  84     {
  85         // TRANS: Page instructions for OAuth applications
  86         return _('Applications you have registered');
  87     }
  88
  89     /**
  90      * Content area of the page
  91      *
  92      * @return void
  93      */
  94
  95     function showContent()
  96     {
  97         $user = common_current_user();
  98
  99         $offset = ($this->page - 1) * APPS_PER_PAGE;
 100         $limit  =  APPS_PER_PAGE + 1;
 101
 102         $application = new Oauth_application();
 103         $application->owner = $user->id;
 104         $application->whereAdd("name != 'anonymous'");
 105         $application->limit($offset, $limit);
 106         $application->orderBy('created DESC');
 107         $application->find();
 108
 109         $cnt = 0;
 110
 111         if ($application) {
 112             $al = new ApplicationList($application, $user, $this);
 113             $cnt = $al->show();
 114             if (0 == $cnt) {
 115                 $this->showEmptyListMessage();
 116             }
 117         }
 118
 119         $this->elementStart('p', array('id' => 'application_register'));
 120         $this->element('a',
 121             array('href' => common_local_url('newapplication'),
 122                   'class' => 'more'
 123             ),
 124             // TRANS: Link description to add a new OAuth application.
 125             'Register a new application');
 126         $this->elementEnd('p');
 127
 128         $this->pagination(
 129             $this->page > 1,
 130             $cnt > APPS_PER_PAGE,
 131             $this->page,
 132             'oauthappssettings'
 133         );
 134     }
 135
 136     function showEmptyListMessage()
 137     {
 138         // TRANS: Empty list message on page with OAuth applications.
 139         $message = sprintf(_('You have not registered any applications yet.'));
 140
 141         $this->elementStart('div', 'guide');
 142         $this->raw(common_markup_to_html($message));
 143         $this->elementEnd('div');
 144     }
 145
 146     /**
 147      * Handle posts to this form
 148      *
 149      * Based on the button that was pressed, muxes out to other functions
 150      * to do the actual task requested.
 151      *
 152      * All sub-functions reload the form with a message -- success or failure.
 153      *
 154      * @return void
 155      */
 156
 157     function handlePost()
 158     {
 159         // CSRF protection
 160
 161         $token = $this->trimmed('token');
 162         if (!$token || $token != common_session_token()) {
 163             $this->showForm(_('There was a problem with your session token. '.
 164                               'Try again, please.'));
 165             return;
 166         }
 167     }
 168 }