X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;ds=inline;f=actions%2Fnewnotice.php;h=9f44d251652dd08a17e261194f24890f32fa4210;hb=bdb8c12d975846ce128619e672b8064b8f5f890a;hp=c412e893decb675e01aa74a9b86a4fe14a947243;hpb=2d456a15e5652a0c0e2c0f9f50221eed2d16e109;p=quix0rs-gnu-social.git
diff --git a/actions/newnotice.php b/actions/newnotice.php
index c412e893de..9f44d25165 100644
--- a/actions/newnotice.php
+++ b/actions/newnotice.php
@@ -1,68 +1,140 @@
.
+ * along with this program. If not, see .
+ *
+ * @category Personal
+ * @package Laconica
+ * @author Evan Prodromou
+ * @author Zach Copley
+ * @author Sarven Capadisli
+ * @copyright 2008-2009 Control Yourself, Inc.
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://laconi.ca/
*/
-if (!defined('LACONICA')) { exit(1); }
+if (!defined('LACONICA')) {
+ exit(1);
+}
-require_once INSTALLDIR . '/lib/noticelist.php';
+require_once INSTALLDIR.'/lib/noticelist.php';
+
+/**
+ * Action for posting new notices
+ *
+ * @category Personal
+ * @package Laconica
+ * @author Evan Prodromou
+ * @author Zach Copley
+ * @author Sarven Capadisli
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://laconi.ca/
+ */
class NewnoticeAction extends Action
{
+ /**
+ * Error message, if any
+ */
+
+ var $msg = null;
+
+ /**
+ * Title of the page
+ *
+ * Note that this usually doesn't get called unless something went wrong
+ *
+ * @return string page title
+ */
+
+ function title()
+ {
+ return _('New notice');
+ }
+
+ /**
+ * Handle input, produce output
+ *
+ * Switches based on GET or POST method. On GET, shows a form
+ * for posting a notice. On POST, saves the results of that form.
+ *
+ * Results may be a full page, or just a single notice list item,
+ * depending on whether AJAX was requested.
+ *
+ * @param array $args $_REQUEST contents
+ *
+ * @return void
+ */
function handle($args)
{
parent::handle($args);
if (!common_logged_in()) {
- common_user_error(_('Not logged in.'));
+ $this->clientError(_('Not logged in.'));
} else if ($_SERVER['REQUEST_METHOD'] == 'POST') {
- # CSRF protection - token set in common_notice_form()
+ // CSRF protection
$token = $this->trimmed('token');
if (!$token || $token != common_session_token()) {
- $this->client_error(_('There was a problem with your session token. Try again, please.'));
+ $this->clientError(_('There was a problem with your session token. '.
+ 'Try again, please.'));
return;
}
- $this->save_new_notice();
+ try {
+ $this->saveNewNotice();
+ } catch (Exception $e) {
+ $this->showForm($e->getMessage());
+ return;
+ }
} else {
- $this->show_form();
+ $this->showForm();
}
}
- function save_new_notice()
- {
+ /**
+ * Save a new notice, based on arguments
+ *
+ * If successful, will show the notice, or return an Ajax-y result.
+ * If not, it will show an error message -- possibly Ajax-y.
+ *
+ * Also, if the notice input looks like a command, it will run the
+ * command and show the results -- again, possibly ajaxy.
+ *
+ * @return void
+ */
+ function saveNewNotice()
+ {
$user = common_current_user();
- assert($user); # XXX: maybe an error instead...
+ assert($user); // XXX: maybe an error instead...
$content = $this->trimmed('status_textarea');
if (!$content) {
- $this->show_form(_('No content!'));
- return;
+ $this->clientError(_('No content!'));
} else {
$content_shortened = common_shorten_links($content);
if (mb_strlen($content_shortened) > 140) {
- common_debug("Content = '$content_shortened'", __FILE__);
- common_debug("mb_strlen(\$content) = " . mb_strlen($content_shortened), __FILE__);
- $this->show_form(_('That\'s too long. Max notice size is 140 chars.'));
- return;
+ $this->clientError(_('That\'s too long. '.
+ 'Max notice size is 140 chars.'));
}
}
@@ -72,33 +144,34 @@ class NewnoticeAction extends Action
if ($cmd) {
if ($this->boolean('ajax')) {
- $cmd->execute(new AjaxWebChannel());
+ $cmd->execute(new AjaxWebChannel($this));
} else {
- $cmd->execute(new WebChannel());
+ $cmd->execute(new WebChannel($this));
}
return;
}
$replyto = $this->trimmed('inreplyto');
- $notice = Notice::saveNew($user->id, $content, 'web', 1, ($replyto == 'false') ? null : $replyto);
+ $notice = Notice::saveNew($user->id, $content, 'web', 1,
+ ($replyto == 'false') ? null : $replyto);
if (is_string($notice)) {
- $this->show_form($notice);
+ $this->clientError($notice);
return;
}
common_broadcast_notice($notice);
if ($this->boolean('ajax')) {
- common_start_html('text/xml;charset=utf-8', true);
- common_element_start('head');
- common_element('title', null, _('Notice posted'));
- common_element_end('head');
- common_element_start('body');
- $this->show_notice($notice);
- common_element_end('body');
- common_element_end('html');
+ $this->startHTML('text/xml;charset=utf-8');
+ $this->elementStart('head');
+ $this->element('title', null, _('Notice posted'));
+ $this->elementEnd('head');
+ $this->elementStart('body');
+ $this->showNotice($notice);
+ $this->elementEnd('body');
+ $this->elementEnd('html');
} else {
$returnto = $this->trimmed('returnto');
@@ -113,29 +186,64 @@ class NewnoticeAction extends Action
}
}
- function ajax_error_msg($msg)
- {
- common_start_html('text/xml;charset=utf-8', true);
- common_element_start('head');
- common_element('title', null, _('Ajax Error'));
- common_element_end('head');
- common_element_start('body');
- common_element('p', array('id' => 'error'), $msg);
- common_element_end('body');
- common_element_end('html');
- }
+ /**
+ * Show an Ajax-y error message
+ *
+ * Goes back to the browser, where it's shown in a popup.
+ *
+ * @param string $msg Message to show
+ *
+ * @return void
+ */
- function show_top($content=null)
+ function ajaxErrorMsg($msg)
{
- common_notice_form(null, $content);
+ $this->startHTML('text/xml;charset=utf-8', true);
+ $this->elementStart('head');
+ $this->element('title', null, _('Ajax Error'));
+ $this->elementEnd('head');
+ $this->elementStart('body');
+ $this->element('p', array('id' => 'error'), $msg);
+ $this->elementEnd('body');
+ $this->elementEnd('html');
}
- function show_form($msg=null)
+ /**
+ * Formerly page output
+ *
+ * This used to be the whole page output; now that's been largely
+ * subsumed by showPage. So this just stores an error message, if
+ * it was passed, and calls showPage.
+ *
+ * Note that since we started doing Ajax output, this page is rarely
+ * seen.
+ *
+ * @param string $msg An error message, if any
+ *
+ * @return void
+ */
+
+ function showForm($msg=null)
{
if ($msg && $this->boolean('ajax')) {
- $this->ajax_error_msg($msg);
+ $this->ajaxErrorMsg($msg);
return;
}
+
+ $this->msg = $msg;
+ $this->showPage();
+ }
+
+ /**
+ * Overload for replies or bad results
+ *
+ * We show content in the notice form if there were replies or results.
+ *
+ * @return void
+ */
+
+ function showNoticeForm()
+ {
$content = $this->trimmed('status_textarea');
if (!$content) {
$replyto = $this->trimmed('replyto');
@@ -144,18 +252,41 @@ class NewnoticeAction extends Action
$content = '@' . $profile->nickname . ' ';
}
}
- common_show_header(_('New notice'), null, $content,
- array($this, 'show_top'));
- if ($msg) {
- common_element('p', array('id' => 'error'), $msg);
+
+ $notice_form = new NoticeForm($this, '', $content);
+ $notice_form->show();
+ }
+
+ /**
+ * Show an error message
+ *
+ * Shows an error message if there is one.
+ *
+ * @return void
+ *
+ * @todo maybe show some instructions?
+ */
+
+ function showPageNotice()
+ {
+ if ($this->msg) {
+ $this->element('p', array('id' => 'error'), $this->msg);
}
- common_show_footer();
}
- function show_notice($notice)
+ /**
+ * Output a notice
+ *
+ * Used to generate the notice code for Ajax results.
+ *
+ * @param Notice $notice Notice that was saved
+ *
+ * @return void
+ */
+
+ function showNotice($notice)
{
- $nli = new NoticeListItem($notice);
+ $nli = new NoticeListItem($notice, $this);
$nli->show();
}
-
}