3 * Laconica, the distributed open-source microblogging tool
5 * Base class for settings actions
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.
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.
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/>.
24 * @author Evan Prodromou <evan@controlyourself.ca>
25 * @copyright 2008-2009 Control Yourself, Inc.
26 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
27 * @link http://laconi.ca/
30 if (!defined('LACONICA')) {
34 require_once INSTALLDIR.'/lib/settingsgroupnav.php';
37 * Base class for settings group of actions
41 * @author Evan Prodromou <evan@controlyourself.ca>
42 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
43 * @link http://laconi.ca/
48 class SettingsAction extends Action
51 * A message for the user.
57 * Whether the message is a good one or a bad one.
63 * Handle input and output a page
65 * @param array $args $_REQUEST arguments
70 function handle($args)
72 parent::handle($args);
73 if (!common_logged_in()) {
74 $this->clientError(_('Not logged in.'));
76 } else if (!common_is_real_login()) {
77 // Cookie theft means that automatic logins can't
78 // change important settings or see private info, and
79 // _all_ our settings are important
80 common_set_returnto($this->selfUrl());
81 common_redirect(common_local_url('login'));
82 } else if ($_SERVER['REQUEST_METHOD'] == 'POST') {
90 * Handle a POST request
92 * @return boolean success flag
101 * show the settings form
103 * @param string $msg an extra message for the user
104 * @param string $success good message or bad message?
109 function showForm($msg=null, $success=false)
112 $this->success = $success;
118 * show human-readable instructions for the page
123 function showPageNotice()
126 $this->element('div', ($this->success) ? 'success' : 'error',
129 $inst = $this->getInstructions();
130 $output = common_markup_to_html($inst);
132 $this->elementStart('div', 'instructions');
134 $this->elementEnd('div');
139 * instructions recipe for sub-classes
141 * Subclasses should override this to return readable instructions. They'll
142 * be processed by common_markup_to_html().
144 * @return string instructions text
147 function getInstructions()
153 * Show the local navigation menu
155 * This is the same for all settings, so we show it here.
160 function showLocalNav()
162 $menu = new SettingsGroupNav($this);