GNUsocial/gnu-social
4
0
Fork 1
Code Issues Releases Wiki Activity

bring messaging section (inbox, outbox, mailbox) into PEAR Code Standards compliance

Browse Source 
Actually refactored the method names on these classes to come into
complete compliance with the code standards. Untested; maybe there are
some bad method names now.

darcs-hash:20081222201304-84dde-3effcce0f9ef25fbe0bfebd505037d9ff37252fa.gz
This commit is contained in:
Evan Prodromou 2008-12-22 15:13:04 -05:00
parent 073ec99c54
commit 2d0aec255f
9 changed files with 799 additions and 507 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
_darcs/inventory
View File

@ -36,3 +36,11 @@ Evan Prodromou <evan@prodromou.name>**20081222173249]
Evan Prodromou <evan@prodromou.name>**20081222193029] Evan Prodromou <evan@prodromou.name>**20081222193029]
[bring mailbox.php into line with PEAR Coding Standards (mostly) [bring mailbox.php into line with PEAR Coding Standards (mostly)
Evan Prodromou <evan@prodromou.name>**20081222195041] Evan Prodromou <evan@prodromou.name>**20081222195041]
[bring messaging section (inbox, outbox, mailbox) into PEAR Code Standards compliance
Evan Prodromou <evan@prodromou.name>**20081222201304
Actually refactored the method names on these classes to come into
complete compliance with the code standards. Untested; maybe there are
some bad method names now.
]

BIN
_darcs/patches/20081222201304-84dde-3effcce0f9ef25fbe0bfebd505037d9ff37252fa.gz Normal file
View File

Binary file not shown.

95
_darcs/pristine/actions/inbox.php
View File

@ -1,9 +1,12 @@
<?php <?php
/* /**
* Laconica - a distributed open-source microblogging tool * Laconica, the distributed open-source microblogging tool
* Copyright (C) 2008, Controlez-Vous, Inc.
* *
* This program is free software: you can redistribute it and/or modify * action handler for message inbox
*
* PHP version 5
*
* LICENCE: This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by * it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version. * (at your option) any later version.
@ -15,15 +18,47 @@
* *
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 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/mailbox.php'); require_once INSTALLDIR.'/lib/mailbox.php';
class InboxAction extends MailboxAction { /**
* action handler for message inbox
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://laconi.ca/
* @see MailboxAction
*/
function get_title($user, $page) { class InboxAction extends MailboxAction
{
/**
* returns the title of the page
*
* @param User $user current user
* @param int $page current page
*
* @return string localised title of the page
*
* @see MailboxAction::getTitle()
*/
function getTitle($user, $page)
{
if ($page > 1) { if ($page > 1) {
$title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page); $title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page);
} else { } else {
@ -32,24 +67,60 @@ class InboxAction extends MailboxAction {
return $title; return $title;
} }
function get_messages($user, $page) { /**
* retrieve the messages for this user and this page
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*
* @see MailboxAction::getMessages()
*/
function getMessages($user, $page)
{
$message = new Message(); $message = new Message();
$message->to_profile = $user->id; $message->to_profile = $user->id;
$message->orderBy('created DESC, id DESC'); $message->orderBy('created DESC, id DESC');
$message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1); $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
if ($message->find()) { if ($message->find()) {
return $message; return $message;
} else { } else {
return NULL; return null;
} }
} }
function get_message_profile($message) { /**
* returns the profile we want to show with the message
*
* For inboxes, we show the sender.
*
* @param Message $message The message to get the profile for
*
* @return Profile The profile of the message sender
*
* @see MailboxAction::getMessageProfile()
*/
function getMessageProfile($message)
{
return $message->getFrom(); return $message->getFrom();
} }
function get_instructions() { /**
* instructions for using this page
*
* @return string localised instructions for using the page
*/
function getInstructions()
{
return _('This is your inbox, which lists your incoming private messages.'); return _('This is your inbox, which lists your incoming private messages.');
} }
} }

95
_darcs/pristine/actions/outbox.php
View File

@ -1,9 +1,12 @@
<?php <?php
/* /**
* Laconica - a distributed open-source microblogging tool * Laconica, the distributed open-source microblogging tool
* Copyright (C) 2008, Controlez-Vous, Inc.
* *
* This program is free software: you can redistribute it and/or modify * action handler for message inbox
*
* PHP version 5
*
* LICENCE: This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by * it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version. * (at your option) any later version.
@ -15,15 +18,47 @@
* *
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 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/mailbox.php'); require_once INSTALLDIR.'/lib/mailbox.php';
class OutboxAction extends MailboxAction { /**
* action handler for message outbox
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://laconi.ca/
* @see MailboxAction
*/
function get_title($user, $page) { class OutboxAction extends MailboxAction
{
/**
* returns the title of the page
*
* @param User $user current user
* @param int $page current page
*
* @return string localised title of the page
*
* @see MailboxAction::getTitle()
*/
function getTitle($user, $page)
{
if ($page > 1) { if ($page > 1) {
$title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page); $title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page);
} else { } else {
@ -32,8 +67,23 @@ class OutboxAction extends MailboxAction {
return $title; return $title;
} }
function get_messages($user, $page) { /**
* retrieve the messages for this user and this page
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*
* @see MailboxAction::getMessages()
*/
function getMessages($user, $page)
{
$message = new Message(); $message = new Message();
$message->from_profile = $user->id; $message->from_profile = $user->id;
$message->orderBy('created DESC, id DESC'); $message->orderBy('created DESC, id DESC');
$message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1); $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
@ -41,16 +91,35 @@ class OutboxAction extends MailboxAction {
if ($message->find()) { if ($message->find()) {
return $message; return $message;
} else { } else {
return NULL; return null;
} }
} }
function get_message_profile($message) { /**
* returns the profile we want to show with the message
*
* For outboxes, we show the recipient.
*
* @param Message $message The message to get the profile for
*
* @return Profile The profile of the message recipient
*
* @see MailboxAction::getMessageProfile()
*/
function getMessageProfile($message)
{
return $message->getTo(); return $message->getTo();
} }
function get_instructions() { /**
* instructions for using this page
*
* @return string localised instructions for using the page
*/
function getInstructions()
{
return _('This is your outbox, which lists private messages you have sent.'); return _('This is your outbox, which lists private messages you have sent.');
} }
} }

48
_darcs/pristine/lib/mailbox.php
View File

@ -19,7 +19,7 @@
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
* *
* @category Action * @category Message
* @package Laconica * @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca> * @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 Control Yourself, Inc. * @copyright 2008 Control Yourself, Inc.
@ -38,7 +38,7 @@ define('MESSAGES_PER_PAGE', 20);
/** /**
* common superclass for direct messages inbox and outbox * common superclass for direct messages inbox and outbox
* *
* @category Action * @category Message
* @package Laconica * @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca> * @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
@ -91,7 +91,7 @@ class MailboxAction extends PersonalAction
$page = 1; $page = 1;
} }
$this->show_page($user, $page); $this->showPage($user, $page);
} }
/** /**
@ -103,7 +103,7 @@ class MailboxAction extends PersonalAction
* @return string localised title of the page * @return string localised title of the page
*/ */
function get_title($user, $page) function getTitle($user, $page)
{ {
return ''; return '';
} }
@ -114,7 +114,7 @@ class MailboxAction extends PersonalAction
* @return string localised instructions for using the page * @return string localised instructions for using the page
*/ */
function get_instructions() function getInstructions()
{ {
return ''; return '';
} }
@ -125,7 +125,7 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_top() function showTop()
{ {
$cur = common_current_user(); $cur = common_current_user();
@ -143,17 +143,33 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_page($user, $page) function showPage($user, $page)
{ {
common_show_header($this->get_title($user, $page), common_show_header($this->getTitle($user, $page),
null, null, null, null,
array($this, 'show_top')); array($this, 'showTop'));
$this->show_box($user, $page); $this->showBox($user, $page);
common_show_footer(); common_show_footer();
} }
/**
* retrieve the messages appropriate for this mailbox
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*/
function getMessages($user, $page)
{
return null;
}
/** /**
* show the messages for a mailbox in list format * show the messages for a mailbox in list format
* *
@ -165,9 +181,9 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_box($user, $page) function showBox($user, $page)
{ {
$message = $this->get_messages($user, $page); $message = $this->getMessages($user, $page);
if ($message) { if ($message) {
@ -181,7 +197,7 @@ class MailboxAction extends PersonalAction
break; break;
} }
$this->show_message($message); $this->showMessage($message);
} }
common_element_end('ul'); common_element_end('ul');
@ -205,7 +221,7 @@ class MailboxAction extends PersonalAction
* @return Profile The profile that matches the message * @return Profile The profile that matches the message
*/ */
function get_message_profile($message) function getMessageProfile($message)
{ {
return null; return null;
} }
@ -218,12 +234,12 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_message($message) function showMessage($message)
{ {
common_element_start('li', array('class' => 'message_single', common_element_start('li', array('class' => 'message_single',
'id' => 'message-' . $message->id)); 'id' => 'message-' . $message->id));
$profile = $this->get_message_profile($message); $profile = $this->getMessageProfile($message);
$avatar = $profile->getAvatar(AVATAR_STREAM_SIZE); $avatar = $profile->getAvatar(AVATAR_STREAM_SIZE);
common_element_start('a', array('href' => $profile->profileurl)); common_element_start('a', array('href' => $profile->profileurl));

598
_darcs/tentative_pristine
View File

@ -1,393 +1,365 @@
hunk ./lib/mailbox.php 2 hunk ./actions/inbox.php 2
-/* -/*
- * Laconica - a distributed open-source microblogging tool - * Laconica - a distributed open-source microblogging tool
- * Copyright (C) 2008, Controlez-Vous, Inc. - * Copyright (C) 2008, Controlez-Vous, Inc.
+/** +/**
+ * Laconica, the distributed open-source microblogging tool + * Laconica, the distributed open-source microblogging tool
hunk ./lib/mailbox.php 5 hunk ./actions/inbox.php 5
- * This program is free software: you can redistribute it and/or modify - * This program is free software: you can redistribute it and/or modify
+ * common superclass for direct messages inbox and outbox + * action handler for message inbox
+ * + *
+ * PHP version 5 + * PHP version 5
+ * + *
+ * LICENCE: This program is free software: you can redistribute it and/or modify + * LICENCE: This program is free software: you can redistribute it and/or modify
hunk ./lib/mailbox.php 21 hunk ./actions/inbox.php 21
+ * + *
+ * @category Action + * @category Message
+ * @package Laconica + * @package Laconica
+ * @author Evan Prodromou <evan@controlyourself.ca> + * @author Evan Prodromou <evan@controlyourself.ca>
+ * @copyright 2008 Control Yourself, Inc. + * @copyright 2008 Control Yourself, Inc.
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 + * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://laconi.ca/ + * @link http://laconi.ca/
hunk ./lib/mailbox.php 30 + */
-if (!defined('LACONICA')) { exit(1); } +
+if (!defined('LACONICA')) { +if (!defined('LACONICA')) {
+ exit(1); + exit(1);
+} +}
hunk ./lib/mailbox.php 34 +
-require_once(INSTALLDIR.'/lib/personal.php'); +require_once INSTALLDIR.'/lib/mailbox.php';
+require_once INSTALLDIR.'/lib/personal.php'; +
hunk ./lib/mailbox.php 38
-class MailboxAction extends PersonalAction {
-
- function handle($args) {
+/** +/**
+ * common superclass for direct messages inbox and outbox + * action handler for message inbox
+ * + *
+ * @category Action + * @category Message
+ * @package Laconica + * @package Laconica
+ * @author Evan Prodromou <evan@controlyourself.ca> + * @author Evan Prodromou <evan@controlyourself.ca>
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 + * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://laconi.ca/ + * @link http://laconi.ca/
+ * @see InboxAction + * @see MailboxAction
+ * @see OutboxAction hunk ./actions/inbox.php 47
+ */ -if (!defined('LACONICA')) { exit(1); }
+ +class InboxAction extends MailboxAction
+class MailboxAction extends PersonalAction
+{ +{
+ /** + /**
+ * output page based on arguments
+ *
+ * @param array $args HTTP arguments (from $_REQUEST)
+ *
+ * @return void
+ */
+
+ function handle($args)
+ {
+ parent::handle($args);
+
+ $nickname = common_canonical_nickname($this->arg('nickname'));
+
+ $user = User::staticGet('nickname', $nickname);
+
+ if (!$user) {
+ $this->client_error(_('No such user.'), 404);
+ return;
+ }
+
+ $cur = common_current_user();
+
+ if (!$cur || $cur->id != $user->id) {
+ $this->client_error(_('Only the user can read their own mailboxes.'),
+ 403);
+ return;
+ }
+
+ $profile = $user->getProfile();
+
+ if (!$profile) {
+ $this->server_error(_('User has no profile.'));
+ return;
+ }
+
+ $page = $this->trimmed('page');
+
+ if (!$page) {
+ $page = 1;
+ }
+
+ $this->show_page($user, $page);
+ }
+
+ /**
+ * returns the title of the page + * returns the title of the page
+ * + *
+ * @param User $user current user + * @param User $user current user
+ * @param int $page current page + * @param int $page current page
+ * + *
+ * @return string localised title of the page + * @return string localised title of the page
+ *
+ * @see MailboxAction::getTitle()
+ */ + */
+ +
+ function get_title($user, $page) + function getTitle($user, $page)
+ { + {
+ return ''; + if ($page > 1) {
+ $title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page);
+ } else {
+ $title = sprintf(_("Inbox for %s"), $user->nickname);
+ }
+ return $title;
+ } + }
+ +
+ /** + /**
+ * retrieve the messages for this user and this page
+ *
+ * Does a query for the right messages
+ *
+ * @param User $user The current user
+ * @param int $page The page the user is on
+ *
+ * @return Message data object with stream for messages
+ *
+ * @see MailboxAction::getMessages()
+ */
+
+ function getMessages($user, $page)
+ {
+ $message = new Message();
+
+ $message->to_profile = $user->id;
+
+ $message->orderBy('created DESC, id DESC');
+ $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
+
+ if ($message->find()) {
+ return $message;
+ } else {
+ return null;
+ }
+ }
+
+ /**
+ * returns the profile we want to show with the message
+ *
+ * For inboxes, we show the sender.
+ *
+ * @param Message $message The message to get the profile for
+ *
+ * @return Profile The profile of the message sender
+ *
+ * @see MailboxAction::getMessageProfile()
+ */
hunk ./actions/inbox.php 111
-require_once(INSTALLDIR.'/lib/mailbox.php');
+ function getMessageProfile($message)
+ {
+ return $message->getFrom();
+ }
hunk ./actions/inbox.php 116
-class InboxAction extends MailboxAction {
-
- function get_title($user, $page) {
- if ($page > 1) {
- $title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page);
- } else {
- $title = sprintf(_("Inbox for %s"), $user->nickname);
- }
- return $title;
- }
-
- function get_messages($user, $page) {
- $message = new Message();
- $message->to_profile = $user->id;
- $message->orderBy('created DESC, id DESC');
- $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
+ /**
+ * instructions for using this page + * instructions for using this page
+ * + *
+ * @return string localised instructions for using the page + * @return string localised instructions for using the page
+ */ + */
+ hunk ./actions/inbox.php 122
+ function get_instructions() - if ($message->find()) {
- return $message;
- } else {
- return NULL;
- }
- }
-
- function get_message_profile($message) {
- return $message->getFrom();
- }
-
- function get_instructions() {
- return _('This is your inbox, which lists your incoming private messages.');
- }
+ function getInstructions()
+ { + {
+ return ''; + return _('This is your inbox, which lists your incoming private messages.');
+ } + }
+ hunk ./actions/outbox.php 2
-/*
- * Laconica - a distributed open-source microblogging tool
- * Copyright (C) 2008, Controlez-Vous, Inc.
+/** +/**
+ * do structured output for the "instructions" are of the page + * Laconica, the distributed open-source microblogging tool
hunk ./actions/outbox.php 5
- * This program is free software: you can redistribute it and/or modify
+ * action handler for message inbox
+ * + *
+ * @return void + * PHP version 5
+ *
+ * LICENCE: This program is free software: you can redistribute it and/or modify
hunk ./actions/outbox.php 21
+ *
+ * @category Message
+ * @package Laconica
+ * @author Evan Prodromou <evan@controlyourself.ca>
+ * @copyright 2008 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/
+ */ + */
+ +
+ function show_top() +if (!defined('LACONICA')) {
+ exit(1);
+}
+
+require_once INSTALLDIR.'/lib/mailbox.php';
+
+/**
+ * action handler for message outbox
+ *
+ * @category Message
+ * @package Laconica
+ * @author Evan Prodromou <evan@controlyourself.ca>
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://laconi.ca/
+ * @see MailboxAction
hunk ./actions/outbox.php 47
-if (!defined('LACONICA')) { exit(1); }
+class OutboxAction extends MailboxAction
+{ +{
+ $cur = common_current_user(); + /**
+ * returns the title of the page
+ *
+ * @param User $user current user
+ * @param int $page current page
+ *
+ * @return string localised title of the page
+ *
+ * @see MailboxAction::getTitle()
+ */
+ +
+ common_message_form(null, $cur, null); + function getTitle($user, $page)
+ + {
+ $this->views_menu(); + if ($page > 1) {
+ $title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page);
+ } else {
+ $title = sprintf(_("Outbox for %s"), $user->nickname);
+ }
+ return $title;
+ } + }
+ +
+ /** + /**
+ * show a full page of output + * retrieve the messages for this user and this page
+ *
+ * Does a query for the right messages
+ * + *
+ * @param User $user The current user + * @param User $user The current user
+ * @param int $page The page the user is on + * @param int $page The page the user is on
+ * + *
+ * @return void + * @return Message data object with stream for messages
+ *
+ * @see MailboxAction::getMessages()
+ */ + */
+ +
+ function show_page($user, $page) + function getMessages($user, $page)
+ { + {
+ common_show_header($this->get_title($user, $page), + $message = new Message();
+ null, null,
+ array($this, 'show_top'));
+ +
+ $this->show_box($user, $page); + $message->from_profile = $user->id;
+ $message->orderBy('created DESC, id DESC');
+ $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
+ +
+ common_show_footer(); + if ($message->find()) {
+ } + return $message;
+ + } else {
+ /** + return null;
+ * show the messages for a mailbox in list format
+ *
+ * Includes the pagination links (before, after).
+ *
+ * @param User $user The current user
+ * @param int $page The page the user is on
+ *
+ * @return void
+ */
+
+ function show_box($user, $page)
+ {
+ $message = $this->get_messages($user, $page);
+
+ if ($message) {
+
+ $cnt = 0;
+ common_element_start('ul', array('id' => 'messages'));
+
+ while ($message->fetch() && $cnt <= MESSAGES_PER_PAGE) {
+ $cnt++;
hunk ./lib/mailbox.php 180
- parent::handle($args);
+ if ($cnt > MESSAGES_PER_PAGE) {
+ break;
+ }
hunk ./lib/mailbox.php 184
- $nickname = common_canonical_nickname($this->arg('nickname'));
- $user = User::staticGet('nickname', $nickname);
+ $this->show_message($message);
+ }
hunk ./lib/mailbox.php 187
- if (!$user) {
- $this->client_error(_('No such user.'), 404);
- return;
- }
+ common_element_end('ul');
hunk ./lib/mailbox.php 189
- $cur = common_current_user();
-
- if (!$cur || $cur->id != $user->id) {
- $this->client_error(_('Only the user can read their own mailboxes.'), 403);
- return;
- }
-
- $profile = $user->getProfile();
+ common_pagination($page > 1, $cnt > MESSAGES_PER_PAGE,
+ $page, $this->trimmed('action'),
+ array('nickname' => $user->nickname));
hunk ./lib/mailbox.php 193
- if (!$profile) {
- $this->server_error(_('User has no profile.'));
- return;
- }
+ $message->free();
+ unset($message);
+ } + }
+ } + }
hunk ./lib/mailbox.php 198 +
- $page = $this->trimmed('page');
-
- if (!$page) {
- $page = 1;
- }
-
- $this->show_page($user, $page);
- }
+ /** + /**
+ * returns the profile we want to show with the message + * returns the profile we want to show with the message
+ * + *
+ * For inboxes, we show the sender; for outboxes, the recipient. + * For outboxes, we show the recipient.
+ * + *
+ * @param Message $message The message to get the profile for + * @param Message $message The message to get the profile for
+ * + *
+ * @return Profile The profile that matches the message + * @return Profile The profile of the message recipient
+ *
+ * @see MailboxAction::getMessageProfile()
+ */ + */
hunk ./lib/mailbox.php 208 hunk ./actions/outbox.php 110
-require_once(INSTALLDIR.'/lib/mailbox.php');
+ function getMessageProfile($message)
+ {
+ return $message->getTo();
+ }
hunk ./actions/outbox.php 115
-class OutboxAction extends MailboxAction {
-
- function get_title($user, $page) { - function get_title($user, $page) {
- return ''; - if ($page > 1) {
- $title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page);
- } else {
- $title = sprintf(_("Outbox for %s"), $user->nickname);
- } - }
+ function get_message_profile($message) - return $title;
- }
-
- function get_messages($user, $page) {
- $message = new Message();
- $message->from_profile = $user->id;
- $message->orderBy('created DESC, id DESC');
- $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
+ /**
+ * instructions for using this page
+ *
+ * @return string localised instructions for using the page
+ */
hunk ./actions/outbox.php 121
- if ($message->find()) {
- return $message;
- } else {
- return NULL;
- }
- }
-
- function get_message_profile($message) {
- return $message->getTo();
- }
-
- function get_instructions() {
- return _('This is your outbox, which lists private messages you have sent.');
- }
-
+ function getInstructions()
+ {
+ return _('This is your outbox, which lists private messages you have sent.');
+ }
hunk ./lib/mailbox.php 22
- * @category Action
+ * @category Message
hunk ./lib/mailbox.php 41
- * @category Action
+ * @category Message
hunk ./lib/mailbox.php 94
- $this->show_page($user, $page);
+ $this->showPage($user, $page);
hunk ./lib/mailbox.php 106
- function get_title($user, $page)
+ function getTitle($user, $page)
hunk ./lib/mailbox.php 117
- function get_instructions()
+ function getInstructions()
hunk ./lib/mailbox.php 128
- function show_top()
+ function showTop()
hunk ./lib/mailbox.php 146
- function show_page($user, $page)
+ function showPage($user, $page)
hunk ./lib/mailbox.php 148
- common_show_header($this->get_title($user, $page),
+ common_show_header($this->getTitle($user, $page),
hunk ./lib/mailbox.php 150
- array($this, 'show_top'));
+ array($this, 'showTop'));
hunk ./lib/mailbox.php 152
- $this->show_box($user, $page);
+ $this->showBox($user, $page);
hunk ./lib/mailbox.php 157
+ /**
+ * retrieve the messages appropriate for this mailbox
+ *
+ * Does a query for the right messages
+ *
+ * @param User $user The current user
+ * @param int $page The page the user is on
+ *
+ * @return Message data object with stream for messages
+ */
+
+ function getMessages($user, $page)
+ { + {
+ return null; + return null;
+ } + }
hunk ./lib/mailbox.php 213 +
- function get_instructions() { hunk ./lib/mailbox.php 184
- return ''; - function show_box($user, $page)
- } + function showBox($user, $page)
+ /** hunk ./lib/mailbox.php 186
+ * show a single message in the list format
+ *
+ * @param Message $message the message to show
+ *
+ * @return void
+ */
hunk ./lib/mailbox.php 221
- function show_top() {
+ function show_message($message)
+ {
+ common_element_start('li', array('class' => 'message_single',
+ 'id' => 'message-' . $message->id));
hunk ./lib/mailbox.php 226
- $cur = common_current_user();
-
- common_message_form(NULL, $cur, NULL);
-
- $this->views_menu();
- }
-
- function show_page($user, $page) {
+ $profile = $this->get_message_profile($message);
hunk ./lib/mailbox.php 228
- common_show_header($this->get_title($user, $page),
- NULL, NULL,
- array($this, 'show_top'));
-
- $this->show_box($user, $page);
-
- common_show_footer();
- }
-
- function show_box($user, $page) {
-
- $message = $this->get_messages($user, $page); - $message = $this->get_messages($user, $page);
- + $message = $this->getMessages($user, $page);
- if ($message) { hunk ./lib/mailbox.php 200
-
- $cnt = 0;
- common_element_start('ul', array('id' => 'messages'));
-
- while ($message->fetch() && $cnt <= MESSAGES_PER_PAGE) {
- $cnt++;
-
- if ($cnt > MESSAGES_PER_PAGE) {
- break;
- }
-
- $this->show_message($message); - $this->show_message($message);
- } + $this->showMessage($message);
+ $avatar = $profile->getAvatar(AVATAR_STREAM_SIZE); hunk ./lib/mailbox.php 224
+ common_element_start('a', array('href' => $profile->profileurl)); - function get_message_profile($message)
+ common_element('img', array('src' => ($avatar) ? + function getMessageProfile($message)
+ common_avatar_display_url($avatar) : hunk ./lib/mailbox.php 237
+ common_default_avatar(AVATAR_STREAM_SIZE), - function show_message($message)
+ 'class' => 'avatar stream', + function showMessage($message)
+ 'width' => AVATAR_STREAM_SIZE, hunk ./lib/mailbox.php 242
+ 'height' => AVATAR_STREAM_SIZE,
+ 'alt' =>
+ ($profile->fullname) ? $profile->fullname :
+ $profile->nickname));
+ common_element_end('a');
+ common_element('a', array('href' => $profile->profileurl,
+ 'class' => 'nickname'),
+ $profile->nickname);
+ // FIXME: URL, image, video, audio
+ common_element_start('p', array('class' => 'content'));
+ common_raw($message->rendered);
+ common_element_end('p');
hunk ./lib/mailbox.php 248
- common_element_end('ul');
-
- common_pagination($page > 1, $cnt > MESSAGES_PER_PAGE,
- $page, $this->trimmed('action'),
- array('nickname' => $user->nickname));
-
- $message->free();
- unset($message);
- }
- }
+ $messageurl = common_local_url('showmessage',
+ array('message' => $message->id));
hunk ./lib/mailbox.php 251
- # returns the profile we want to show with the message
-
- function get_message_profile($message) {
- return NULL;
- }
-
- function show_message($message) {
+ // XXX: we need to figure this out better. Is this right?
+ if (strcmp($message->uri, $messageurl) != 0 &&
+ preg_match('/^http/', $message->uri)) {
+ $messageurl = $message->uri;
+ }
+ common_element_start('p', 'time');
+ common_element('a', array('class' => 'permalink',
+ 'href' => $messageurl,
+ 'title' => common_exact_date($message->created)),
+ common_date_string($message->created));
+ if ($message->source) {
+ common_text(_(' from '));
+ $this->source_link($message->source);
+ }
hunk ./lib/mailbox.php 266
- common_element_start('li', array('class' => 'message_single',
- 'id' => 'message-' . $message->id));
+ common_element_end('p');
hunk ./lib/mailbox.php 268
- $profile = $this->get_message_profile($message); - $profile = $this->get_message_profile($message);
- + $profile = $this->getMessageProfile($message);
- $avatar = $profile->getAvatar(AVATAR_STREAM_SIZE);
- common_element_start('a', array('href' => $profile->profileurl));
- common_element('img', array('src' => ($avatar) ? common_avatar_display_url($avatar) : common_default_avatar(AVATAR_STREAM_SIZE),
- 'class' => 'avatar stream',
- 'width' => AVATAR_STREAM_SIZE,
- 'height' => AVATAR_STREAM_SIZE,
- 'alt' =>
- ($profile->fullname) ? $profile->fullname :
- $profile->nickname));
- common_element_end('a');
- common_element('a', array('href' => $profile->profileurl,
- 'class' => 'nickname'),
- $profile->nickname);
- # FIXME: URL, image, video, audio
- common_element_start('p', array('class' => 'content'));
- common_raw($message->rendered);
- common_element_end('p');
-
- $messageurl = common_local_url('showmessage', array('message' => $message->id));
-
- # XXX: we need to figure this out better. Is this right?
- if (strcmp($message->uri, $messageurl) != 0 && preg_match('/^http/', $message->uri)) {
- $messageurl = $message->uri;
- }
- common_element_start('p', 'time');
- common_element('a', array('class' => 'permalink',
- 'href' => $messageurl,
- 'title' => common_exact_date($message->created)),
- common_date_string($message->created));
- if ($message->source) {
- common_text(_(' from '));
- $this->source_link($message->source);
- }
-
- common_element_end('p');
-
- common_element_end('li');
- }
+ common_element_end('li');
+ }

95
actions/inbox.php
View File

@ -1,9 +1,12 @@
<?php <?php
/* /**
* Laconica - a distributed open-source microblogging tool * Laconica, the distributed open-source microblogging tool
* Copyright (C) 2008, Controlez-Vous, Inc.
* *
* This program is free software: you can redistribute it and/or modify * action handler for message inbox
*
* PHP version 5
*
* LICENCE: This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by * it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version. * (at your option) any later version.
@ -15,15 +18,47 @@
* *
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 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/mailbox.php'); require_once INSTALLDIR.'/lib/mailbox.php';
class InboxAction extends MailboxAction { /**
* action handler for message inbox
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://laconi.ca/
* @see MailboxAction
*/
function get_title($user, $page) { class InboxAction extends MailboxAction
{
/**
* returns the title of the page
*
* @param User $user current user
* @param int $page current page
*
* @return string localised title of the page
*
* @see MailboxAction::getTitle()
*/
function getTitle($user, $page)
{
if ($page > 1) { if ($page > 1) {
$title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page); $title = sprintf(_("Inbox for %s - page %d"), $user->nickname, $page);
} else { } else {
@ -32,24 +67,60 @@ class InboxAction extends MailboxAction {
return $title; return $title;
} }
function get_messages($user, $page) { /**
* retrieve the messages for this user and this page
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*
* @see MailboxAction::getMessages()
*/
function getMessages($user, $page)
{
$message = new Message(); $message = new Message();
$message->to_profile = $user->id; $message->to_profile = $user->id;
$message->orderBy('created DESC, id DESC'); $message->orderBy('created DESC, id DESC');
$message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1); $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
if ($message->find()) { if ($message->find()) {
return $message; return $message;
} else { } else {
return NULL; return null;
} }
} }
function get_message_profile($message) { /**
* returns the profile we want to show with the message
*
* For inboxes, we show the sender.
*
* @param Message $message The message to get the profile for
*
* @return Profile The profile of the message sender
*
* @see MailboxAction::getMessageProfile()
*/
function getMessageProfile($message)
{
return $message->getFrom(); return $message->getFrom();
} }
function get_instructions() { /**
* instructions for using this page
*
* @return string localised instructions for using the page
*/
function getInstructions()
{
return _('This is your inbox, which lists your incoming private messages.'); return _('This is your inbox, which lists your incoming private messages.');
} }
} }

95
actions/outbox.php
View File

@ -1,9 +1,12 @@
<?php <?php
/* /**
* Laconica - a distributed open-source microblogging tool * Laconica, the distributed open-source microblogging tool
* Copyright (C) 2008, Controlez-Vous, Inc.
* *
* This program is free software: you can redistribute it and/or modify * action handler for message inbox
*
* PHP version 5
*
* LICENCE: This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by * it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version. * (at your option) any later version.
@ -15,15 +18,47 @@
* *
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 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/mailbox.php'); require_once INSTALLDIR.'/lib/mailbox.php';
class OutboxAction extends MailboxAction { /**
* action handler for message outbox
*
* @category Message
* @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://laconi.ca/
* @see MailboxAction
*/
function get_title($user, $page) { class OutboxAction extends MailboxAction
{
/**
* returns the title of the page
*
* @param User $user current user
* @param int $page current page
*
* @return string localised title of the page
*
* @see MailboxAction::getTitle()
*/
function getTitle($user, $page)
{
if ($page > 1) { if ($page > 1) {
$title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page); $title = sprintf(_("Outbox for %s - page %d"), $user->nickname, $page);
} else { } else {
@ -32,8 +67,23 @@ class OutboxAction extends MailboxAction {
return $title; return $title;
} }
function get_messages($user, $page) { /**
* retrieve the messages for this user and this page
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*
* @see MailboxAction::getMessages()
*/
function getMessages($user, $page)
{
$message = new Message(); $message = new Message();
$message->from_profile = $user->id; $message->from_profile = $user->id;
$message->orderBy('created DESC, id DESC'); $message->orderBy('created DESC, id DESC');
$message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1); $message->limit((($page-1)*MESSAGES_PER_PAGE), MESSAGES_PER_PAGE + 1);
@ -41,16 +91,35 @@ class OutboxAction extends MailboxAction {
if ($message->find()) { if ($message->find()) {
return $message; return $message;
} else { } else {
return NULL; return null;
} }
} }
function get_message_profile($message) { /**
* returns the profile we want to show with the message
*
* For outboxes, we show the recipient.
*
* @param Message $message The message to get the profile for
*
* @return Profile The profile of the message recipient
*
* @see MailboxAction::getMessageProfile()
*/
function getMessageProfile($message)
{
return $message->getTo(); return $message->getTo();
} }
function get_instructions() { /**
* instructions for using this page
*
* @return string localised instructions for using the page
*/
function getInstructions()
{
return _('This is your outbox, which lists private messages you have sent.'); return _('This is your outbox, which lists private messages you have sent.');
} }
} }

48
lib/mailbox.php
View File

@ -19,7 +19,7 @@
* You should have received a copy of the GNU Affero General Public License * You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
* *
* @category Action * @category Message
* @package Laconica * @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca> * @author Evan Prodromou <evan@controlyourself.ca>
* @copyright 2008 Control Yourself, Inc. * @copyright 2008 Control Yourself, Inc.
@ -38,7 +38,7 @@ define('MESSAGES_PER_PAGE', 20);
/** /**
* common superclass for direct messages inbox and outbox * common superclass for direct messages inbox and outbox
* *
* @category Action * @category Message
* @package Laconica * @package Laconica
* @author Evan Prodromou <evan@controlyourself.ca> * @author Evan Prodromou <evan@controlyourself.ca>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
@ -91,7 +91,7 @@ class MailboxAction extends PersonalAction
$page = 1; $page = 1;
} }
$this->show_page($user, $page); $this->showPage($user, $page);
} }
/** /**
@ -103,7 +103,7 @@ class MailboxAction extends PersonalAction
* @return string localised title of the page * @return string localised title of the page
*/ */
function get_title($user, $page) function getTitle($user, $page)
{ {
return ''; return '';
} }
@ -114,7 +114,7 @@ class MailboxAction extends PersonalAction
* @return string localised instructions for using the page * @return string localised instructions for using the page
*/ */
function get_instructions() function getInstructions()
{ {
return ''; return '';
} }
@ -125,7 +125,7 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_top() function showTop()
{ {
$cur = common_current_user(); $cur = common_current_user();
@ -143,17 +143,33 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_page($user, $page) function showPage($user, $page)
{ {
common_show_header($this->get_title($user, $page), common_show_header($this->getTitle($user, $page),
null, null, null, null,
array($this, 'show_top')); array($this, 'showTop'));
$this->show_box($user, $page); $this->showBox($user, $page);
common_show_footer(); common_show_footer();
} }
/**
* retrieve the messages appropriate for this mailbox
*
* Does a query for the right messages
*
* @param User $user The current user
* @param int $page The page the user is on
*
* @return Message data object with stream for messages
*/
function getMessages($user, $page)
{
return null;
}
/** /**
* show the messages for a mailbox in list format * show the messages for a mailbox in list format
* *
@ -165,9 +181,9 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_box($user, $page) function showBox($user, $page)
{ {
$message = $this->get_messages($user, $page); $message = $this->getMessages($user, $page);
if ($message) { if ($message) {
@ -181,7 +197,7 @@ class MailboxAction extends PersonalAction
break; break;
} }
$this->show_message($message); $this->showMessage($message);
} }
common_element_end('ul'); common_element_end('ul');
@ -205,7 +221,7 @@ class MailboxAction extends PersonalAction
* @return Profile The profile that matches the message * @return Profile The profile that matches the message
*/ */
function get_message_profile($message) function getMessageProfile($message)
{ {
return null; return null;
} }
@ -218,12 +234,12 @@ class MailboxAction extends PersonalAction
* @return void * @return void
*/ */
function show_message($message) function showMessage($message)
{ {
common_element_start('li', array('class' => 'message_single', common_element_start('li', array('class' => 'message_single',
'id' => 'message-' . $message->id)); 'id' => 'message-' . $message->id));
$profile = $this->get_message_profile($message); $profile = $this->getMessageProfile($message);
$avatar = $profile->getAvatar(AVATAR_STREAM_SIZE); $avatar = $profile->getAvatar(AVATAR_STREAM_SIZE);
common_element_start('a', array('href' => $profile->profileurl)); common_element_start('a', array('href' => $profile->profileurl));