3 * Form action extendable class.
9 * @author Evan Prodromou <evan@status.net>
10 * @license http://www.fsf.org/licensing/licenses/agpl.html AGPLv3
11 * @link http://status.net/
13 * StatusNet - the distributed open-source microblogging tool
14 * Copyright (C) 2008, 2009, StatusNet, Inc.
16 * This program is free software: you can redistribute it and/or modify
17 * it under the terms of the GNU Affero General Public License as published by
18 * the Free Software Foundation, either version 3 of the License, or
19 * (at your option) any later version.
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU Affero General Public License for more details.
26 * You should have received a copy of the GNU Affero General Public License
27 * along with this program. If not, see <http://www.gnu.org/licenses/>.
30 if (!defined('STATUSNET')) {
35 * Form action extendable class
39 * @author Evan Prodromou <evan@status.net>
40 * @author Mikael Nordfeldth <evan@status.net>
41 * @license http://www.fsf.org/licensing/licenses/agpl.html AGPLv3
42 * @link http://status.net/
44 class FormAction extends ManagedAction
46 protected $form = null;
47 protected $type = null;
48 protected $needLogin = true;
49 protected $canPost = true;
51 protected function prepare(array $args=array()) {
52 parent::prepare($args);
54 $this->form = $this->form ?: $this->action;
55 $this->args['form'] = $this->form;
57 $this->type = !is_null($this->type) ? $this->type : $this->trimmed('type');
58 $this->args['context'] = $this->trimmed('action'); // reply for notice for example
67 public function isReadOnly($args) {
68 return !$this->isPost();
71 public function showPageNotice()
73 $this->showInstructions();
74 if ($msg = $this->getError()) {
75 $this->element('div', 'error', $msg);
77 if ($msg = $this->getInfo()) {
78 $this->element('div', 'info', $msg);
83 * Outputs the instructions for the form
87 public function showInstructions()
89 // instructions are nice, so users know what to do
90 $this->raw(common_markup_to_html($this->getInstructions()));
94 * @return string with instructions to pass into common_markup_to_html()
96 public function getInstructions()
102 * Gets called from handle() if isPost() is true;
105 protected function handlePost()
107 parent::handlePost();
109 // check for this before token since all POST and FILES data
110 // is losts when size is exceeded
111 if (empty($_POST) && $_SERVER['CONTENT_LENGTH']>0) {
112 // TRANS: Client error displayed when the number of bytes in a POST request exceeds a limit.
113 // TRANS: %s is the number of bytes of the CONTENT_LENGTH.
114 $msg = _m('The server was unable to handle that much POST data (%s MiB) due to its current configuration.',
115 'The server was unable to handle that much POST data (%s MiB) due to its current configuration.',
116 round($_SERVER['CONTENT_LENGTH']/1024/1024,2));
117 throw new ClientException($msg);
120 $this->checkSessionToken();