* @link http://status.net/
*/
-if (!defined('STATUSNET')) {
- exit(1);
-}
-
-require_once INSTALLDIR . '/lib/apiprivateauth.php';
+if (!defined('GNUSOCIAL')) { exit(1); }
/**
* Returns the notice specified by id as a Twitter-style status and inline user
*
* @return boolean success flag
*/
- function prepare($args)
+ protected function prepare(array $args=array())
{
parent::prepare($args);
$this->notice_id = (int)$this->trimmed('id');
- if (empty($notice_id)) {
- $this->notice_id = (int)$this->arg('id');
+ $this->notice = Notice::getKV('id', $this->notice_id);
+ if (!$this->notice instanceof Notice) {
+ $deleted = Deleted_notice::getKV('id', $this->notice_id);
+ if ($deleted instanceof Deleted_notice) {
+ // TRANS: Client error displayed trying to show a deleted notice.
+ $this->clientError(_('Notice deleted.'), 410);
+ }
+ // TRANS: Client error displayed trying to show a non-existing notice.
+ $this->clientError(_('No such notice.'), 404);
+ }
+ if (!$this->notice->inScope($this->scoped)) {
+ // TRANS: Client exception thrown when trying a view a notice the user has no access to.
+ throw new ClientException(_('Access restricted.'), 403);
}
-
- $this->notice = Notice::staticGet((int)$this->notice_id);
return true;
}
*
* Check the format and show the notice
*
- * @param array $args $_REQUEST data (unused)
- *
* @return void
*/
- function handle($args)
+ protected function handle()
{
- parent::handle($args);
+ parent::handle();
- if (!in_array($this->format, array('xml', 'json'))) {
- // TRANS: Client error displayed when trying to handle an unknown API method.
- $this->clientError(_('API method not found.'), $code = 404);
- return;
+ if (!in_array($this->format, array('xml', 'json', 'atom'))) {
+ // TRANS: Client error displayed when coming across a non-supported API method.
+ $this->clientError(_('API method not found.'), 404);
}
- $this->showNotice();
+ switch ($_SERVER['REQUEST_METHOD']) {
+ case 'GET':
+ $this->showNotice();
+ break;
+ case 'DELETE':
+ $this->deleteNotice();
+ break;
+ default:
+ // TRANS: Client error displayed calling an unsupported HTTP error in API status show.
+ $this->clientError(_('HTTP method not supported.'), 405);
+ }
}
/**
function showNotice()
{
if (!empty($this->notice)) {
- if ($this->format == 'xml') {
+ switch ($this->format) {
+ case 'xml':
$this->showSingleXmlStatus($this->notice);
- } elseif ($this->format == 'json') {
+ break;
+ case 'json':
$this->show_single_json_status($this->notice);
+ break;
+ case 'atom':
+ $this->showSingleAtomStatus($this->notice);
+ break;
+ default:
+ // TRANS: Exception thrown requesting an unsupported notice output format.
+ // TRANS: %s is the requested output format.
+ throw new Exception(sprintf(_("Unsupported format: %s."), $this->format));
}
} else {
// XXX: Twitter just sets a 404 header and doens't bother
// to return an err msg
- $deleted = Deleted_notice::staticGet($this->notice_id);
+ $deleted = Deleted_notice::getKV($this->notice_id);
if (!empty($deleted)) {
$this->clientError(
}
/**
- * Is this action read only?
+ * We expose AtomPub here, so non-GET/HEAD reqs must be read/write.
*
* @param array $args other arguments
*
* @return boolean true
*/
- function isReadOnly($args)
+
+ function isReadOnly(array $args=array())
{
- return true;
+ return ($_SERVER['REQUEST_METHOD'] == 'GET' || $_SERVER['REQUEST_METHOD'] == 'HEAD');
}
/**
return null;
}
+
+ function deleteNotice()
+ {
+ if ($this->format != 'atom') {
+ // TRANS: Client error displayed when trying to delete a notice not using the Atom format.
+ $this->clientError(_('Can only delete using the Atom format.'));
+ }
+
+ if (empty($this->auth_user) ||
+ ($this->notice->profile_id != $this->auth_user->id &&
+ !$this->auth_user->hasRight(Right::DELETEOTHERSNOTICE))) {
+ // TRANS: Client error displayed when a user has no rights to delete notices of other users.
+ $this->clientError(_('Cannot delete this notice.'), 403);
+ }
+
+ if (Event::handle('StartDeleteOwnNotice', array($this->auth_user, $this->notice))) {
+ $this->notice->delete();
+ Event::handle('EndDeleteOwnNotice', array($this->auth_user, $this->notice));
+ }
+
+ // @fixme is there better output we could do here?
+
+ header('HTTP/1.1 200 OK');
+ header('Content-Type: text/plain');
+ // TRANS: Confirmation of notice deletion in API. %d is the ID (number) of the deleted notice.
+ print(sprintf(_('Deleted notice %d'), $this->notice->id));
+ print("\n");
+ }
}