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