actions/designadminpanel.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * Design administration panel
   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    Evan Prodromou <evan@status.net>
  25  * @author    Zach Copley <zach@status.net>
  26  * @author    Sarven Capadisli <csarven@status.net>
  27  * @copyright 2008-2009 StatusNet, Inc.
  28  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  29  * @link      http://status.net/
  30  */
  31
  32 if (!defined('STATUSNET')) {
  33     exit(1);
  34 }
  35
  36 /**
  37  * Administer design settings
  38  *
  39  * @category Admin
  40  * @package  StatusNet
  41  * @author   Evan Prodromou <evan@status.net>
  42  * @author   Zach Copley <zach@status.net>
  43  * @author   Sarven Capadisli <csarven@status.net>
  44  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  45  * @link     http://status.net/
  46  */
  47
  48 class DesignadminpanelAction extends AdminPanelAction
  49 {
  50     /**
  51      * Returns the page title
  52      *
  53      * @return string page title
  54      */
  55
  56     function title()
  57     {
  58         return _('Design');
  59     }
  60
  61     /**
  62      * Instructions for using this form.
  63      *
  64      * @return string instructions
  65      */
  66
  67     function getInstructions()
  68     {
  69         return _('Design settings for this StatusNet site.');
  70     }
  71
  72     /**
  73      * Show the site admin panel form
  74      *
  75      * @return void
  76      */
  77
  78     function showForm()
  79     {
  80         $form = new DesignAdminPanelForm($this);
  81         $form->show();
  82         return;
  83     }
  84
  85     /**
  86      * Save settings from the form
  87      *
  88      * @return void
  89      */
  90
  91     function saveSettings()
  92     {
  93         static $settings = array('theme');
  94
  95         $values = array();
  96
  97         foreach ($settings as $setting) {
  98             $values[$setting] = $this->trimmed($setting);
  99         }
 100
 101         // This throws an exception on validation errors
 102
 103         $this->validate($values);
 104
 105         // assert(all values are valid);
 106
 107         $config = new Config();
 108
 109         $config->query('BEGIN');
 110
 111         foreach ($settings as $setting) {
 112             Config::save('site', $setting, $values[$setting]);
 113         }
 114
 115         $config->query('COMMIT');
 116
 117         return;
 118     }
 119
 120     function validate(&$values)
 121     {
 122         if (!in_array($values['theme'], Theme::listAvailable())) {
 123             $this->clientError(sprintf(_("Theme not available: %s"), $values['theme']));
 124         }
 125     }
 126 }
 127
 128 class DesignAdminPanelForm extends Form
 129 {
 130     /**
 131      * ID of the form
 132      *
 133      * @return int ID of the form
 134      */
 135
 136     function id()
 137     {
 138         return 'form_design_admin_panel';
 139     }
 140
 141     /**
 142      * class of the form
 143      *
 144      * @return string class of the form
 145      */
 146
 147     function formClass()
 148     {
 149         return 'form_settings';
 150     }
 151
 152     /**
 153      * Action of the form
 154      *
 155      * @return string URL of the action
 156      */
 157
 158     function action()
 159     {
 160         return common_local_url('designadminpanel');
 161     }
 162
 163     /**
 164      * Data elements of the form
 165      *
 166      * @return void
 167      */
 168
 169     function formData()
 170     {
 171         $themes = Theme::listAvailable();
 172
 173         asort($themes);
 174
 175         $themes = array_combine($themes, $themes);
 176
 177         $this->out->elementStart('ul', 'form_data');
 178         $this->out->elementStart('li');
 179
 180         $this->out->dropdown('theme', _('Theme'),
 181                              $themes, _('Theme for the site.'),
 182                              true, $this->value('theme'));
 183
 184         $this->out->elementEnd('li');
 185         $this->out->elementEnd('ul');
 186     }
 187
 188     /**
 189      * Utility to simplify some of the duplicated code around
 190      * params and settings.
 191      *
 192      * @param string $setting      Name of the setting
 193      * @param string $title        Title to use for the input
 194      * @param string $instructions Instructions for this field
 195      *
 196      * @return void
 197      */
 198
 199     function input($setting, $title, $instructions)
 200     {
 201         $this->out->input($setting, $title, $this->value($setting), $instructions);
 202     }
 203
 204     /**
 205      * Utility to simplify getting the posted-or-stored setting value
 206      *
 207      * @param string $setting Name of the setting
 208      *
 209      * @return string param value if posted, or current config value
 210      */
 211
 212     function value($setting)
 213     {
 214         $value = $this->out->trimmed($setting);
 215         if (empty($value)) {
 216             $value = common_config('site', $setting);
 217         }
 218         return $value;
 219     }
 220
 221     /**
 222      * Action elements
 223      *
 224      * @return void
 225      */
 226
 227     function formActions()
 228     {
 229         $this->out->submit('submit', _('Save'), 'submit', null, _('Save site settings'));
 230     }
 231 }