]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - actions/apistatusesdestroy.php
Localisation updates from translatewiki.net
[quix0rs-gnu-social.git] / actions / apistatusesdestroy.php
1 <?php
2 /**
3  * StatusNet, the distributed open-source microblogging tool
4  *
5  * Destroy a notice through the API
6  *
7  * PHP version 5
8  *
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.
13  *
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.
18  *
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/>.
21  *
22  * @category  API
23  * @package   StatusNet
24  * @author    Craig Andrews <candrews@integralblue.com>
25  * @author    Evan Prodromou <evan@status.net>
26  * @author    Jeffery To <jeffery.to@gmail.com>
27  * @author    Tom Blankenship <mac65@mac65.com>
28  * @author    Mike Cochrane <mikec@mikenz.geek.nz>
29  * @author    Robin Millette <robin@millette.info>
30  * @author    Zach Copley <zach@status.net>
31  * @copyright 2009 StatusNet, Inc.
32  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
33  * @link      http://status.net/
34  */
35
36 if (!defined('STATUSNET')) {
37     exit(1);
38 }
39
40 require_once INSTALLDIR . '/lib/apiauth.php';
41
42 /**
43  * Deletes one of the authenticating user's statuses (notices).
44  *
45  * @category API
46  * @package  StatusNet
47  * @author   Craig Andrews <candrews@integralblue.com>
48  * @author   Evan Prodromou <evan@status.net>
49  * @author   Jeffery To <jeffery.to@gmail.com>
50  * @author   Tom Blankenship <mac65@mac65.com>
51  * @author   Mike Cochrane <mikec@mikenz.geek.nz>
52  * @author   Robin Millette <robin@millette.info>
53  * @author   Zach Copley <zach@status.net>
54  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
55  * @link     http://status.net/
56  */
57
58 class ApiStatusesDestroyAction extends ApiAuthAction
59 {
60     var $status                = null;
61
62     /**
63      * Take arguments for running
64      *
65      * @param array $args $_REQUEST args
66      *
67      * @return boolean success flag
68      *
69      */
70
71     function prepare($args)
72     {
73         parent::prepare($args);
74
75         $this->user = $this->auth_user;
76         $this->notice_id = (int)$this->trimmed('id');
77
78         if (empty($notice_id)) {
79             $this->notice_id = (int)$this->arg('id');
80         }
81
82         $this->notice = Notice::staticGet((int)$this->notice_id);
83
84         return true;
85      }
86
87     /**
88      * Handle the request
89      *
90      * Delete the notice and all related replies
91      *
92      * @param array $args $_REQUEST data (unused)
93      *
94      * @return void
95      */
96
97     function handle($args)
98     {
99         parent::handle($args);
100
101         if (!in_array($this->format, array('xml', 'json'))) {
102              $this->clientError(_('API method not found!'), $code = 404);
103              return;
104         }
105
106          if (!in_array($_SERVER['REQUEST_METHOD'], array('POST', 'DELETE'))) {
107              $this->clientError(_('This method requires a POST or DELETE.'),
108                  400, $this->format);
109              return;
110          }
111
112          if (empty($this->notice)) {
113              $this->clientError(_('No status found with that ID.'),
114                  404, $this->format);
115              return;
116          }
117
118          if ($this->user->id == $this->notice->profile_id) {
119              $replies = new Reply;
120              $replies->get('notice_id', $this->notice_id);
121              $replies->delete();
122              $this->notice->delete();
123
124              if ($this->format == 'xml') {
125                  $this->showSingleXmlStatus($this->notice);
126              } elseif ($this->format == 'json') {
127                  $this->show_single_json_status($this->notice);
128              }
129          } else {
130              $this->clientError(_('You may not delete another user\'s status.'),
131                  403, $this->format);
132          }
133
134         $this->showNotice();
135     }
136
137     /**
138      * Show the deleted notice
139      *
140      * @return void
141      */
142
143     function showNotice()
144     {
145         if (!empty($this->notice)) {
146             if ($this->format == 'xml') {
147                 $this->showSingleXmlStatus($this->notice);
148             } elseif ($this->format == 'json') {
149                 $this->show_single_json_status($this->notice);
150             }
151         }
152     }
153
154 }