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             return false;
  61         }
  62
  63         return true;
  64     }
  65
  66     /**
  67      * Title of the page
  68      *
  69      * @return string Title of the page
  70      */
  71
  72     function title()
  73     {
  74         // TRANS: Page title for OAuth applications
  75         return _('OAuth applications');
  76     }
  77
  78     /**
  79      * Instructions for use
  80      *
  81      * @return instructions for use
  82      */
  83
  84     function getInstructions()
  85     {
  86         // TRANS: Page instructions for OAuth applications
  87         return _('Applications you have registered');
  88     }
  89
  90     /**
  91      * Content area of the page
  92      *
  93      * @return void
  94      */
  95
  96     function showContent()
  97     {
  98         $user = common_current_user();
  99
 100         $offset = ($this->page - 1) * APPS_PER_PAGE;
 101         $limit  =  APPS_PER_PAGE + 1;
 102
 103         $application = new Oauth_application();
 104         $application->owner = $user->id;
 105         $application->whereAdd("name != 'anonymous'");
 106         $application->limit($offset, $limit);
 107         $application->orderBy('created DESC');
 108         $application->find();
 109
 110         $cnt = 0;
 111
 112         if ($application) {
 113             $al = new ApplicationList($application, $user, $this);
 114             $cnt = $al->show();
 115             if (0 == $cnt) {
 116                 $this->showEmptyListMessage();
 117             }
 118         }
 119
 120         $this->elementStart('p', array('id' => 'application_register'));
 121         $this->element('a',
 122             array('href' => common_local_url('newapplication'),
 123                   'class' => 'more'
 124             ),
 125             // TRANS: Link description to add a new OAuth application.
 126             'Register a new application');
 127         $this->elementEnd('p');
 128
 129         $this->pagination(
 130             $this->page > 1,
 131             $cnt > APPS_PER_PAGE,
 132             $this->page,
 133             'oauthappssettings'
 134         );
 135     }
 136
 137     function showEmptyListMessage()
 138     {
 139         // TRANS: Empty list message on page with OAuth applications.
 140         $message = sprintf(_('You have not registered any applications yet.'));
 141
 142         $this->elementStart('div', 'guide');
 143         $this->raw(common_markup_to_html($message));
 144         $this->elementEnd('div');
 145     }
 146
 147     /**
 148      * Handle posts to this form
 149      *
 150      * Based on the button that was pressed, muxes out to other functions
 151      * to do the actual task requested.
 152      *
 153      * All sub-functions reload the form with a message -- success or failure.
 154      *
 155      * @return void
 156      */
 157
 158     function handlePost()
 159     {
 160         // CSRF protection
 161
 162         $token = $this->trimmed('token');
 163         if (!$token || $token != common_session_token()) {
 164             $this->showForm(_('There was a problem with your session token. '.
 165                               'Try again, please.'));
 166             return;
 167         }
 168     }
 169 }