apistatusesdestroy.php 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157
  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. * @copyright 2009 Free Software Foundation, Inc http://www.fsf.org
  33. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  34. * @link http://status.net/
  35. */
  36. if (!defined('STATUSNET')) {
  37. exit(1);
  38. }
  39. /**
  40. * Deletes one of the authenticating user's statuses (notices).
  41. *
  42. * @category API
  43. * @package StatusNet
  44. * @author Craig Andrews <candrews@integralblue.com>
  45. * @author Evan Prodromou <evan@status.net>
  46. * @author Jeffery To <jeffery.to@gmail.com>
  47. * @author Tom Blankenship <mac65@mac65.com>
  48. * @author Mike Cochrane <mikec@mikenz.geek.nz>
  49. * @author Robin Millette <robin@millette.info>
  50. * @author Zach Copley <zach@status.net>
  51. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  52. * @link http://status.net/
  53. */
  54. class ApiStatusesDestroyAction extends ApiAuthAction
  55. {
  56. var $status = null;
  57. /**
  58. * Take arguments for running
  59. *
  60. * @param array $args $_REQUEST args
  61. *
  62. * @return boolean success flag
  63. */
  64. function prepare($args)
  65. {
  66. parent::prepare($args);
  67. $this->user = $this->auth_user;
  68. $this->notice_id = (int)$this->trimmed('id');
  69. if (empty($notice_id)) {
  70. $this->notice_id = (int)$this->arg('id');
  71. }
  72. $this->notice = Notice::getKV((int)$this->notice_id);
  73. return true;
  74. }
  75. /**
  76. * Handle the request
  77. *
  78. * Delete the notice and all related replies
  79. *
  80. * @param array $args $_REQUEST data (unused)
  81. *
  82. * @return void
  83. */
  84. function handle($args)
  85. {
  86. parent::handle($args);
  87. if (!in_array($this->format, array('xml', 'json'))) {
  88. $this->clientError(
  89. // TRANS: Client error displayed when coming across a non-supported API method.
  90. _('API method not found.'),
  91. 404
  92. );
  93. return;
  94. }
  95. if (!in_array($_SERVER['REQUEST_METHOD'], array('POST', 'DELETE'))) {
  96. $this->clientError(
  97. // TRANS: Client error displayed trying to delete a status not using POST or DELETE.
  98. // TRANS: POST and DELETE should not be translated.
  99. _('This method requires a POST or DELETE.'),
  100. 400,
  101. $this->format
  102. );
  103. return;
  104. }
  105. if (empty($this->notice)) {
  106. $this->clientError(
  107. // TRANS: Client error displayed trying to delete a status with an invalid ID.
  108. _('No status found with that ID.'),
  109. 404, $this->format
  110. );
  111. return;
  112. }
  113. if ($this->user->id == $this->notice->profile_id) {
  114. if (Event::handle('StartDeleteOwnNotice', array($this->user, $this->notice))) {
  115. $this->notice->delete();
  116. Event::handle('EndDeleteOwnNotice', array($this->user, $this->notice));
  117. }
  118. $this->showNotice();
  119. } else {
  120. $this->clientError(
  121. // TRANS: Client error displayed trying to delete a status of another user.
  122. _('You may not delete another user\'s status.'),
  123. 403,
  124. $this->format
  125. );
  126. }
  127. }
  128. /**
  129. * Show the deleted notice
  130. *
  131. * @return void
  132. */
  133. function showNotice()
  134. {
  135. if (!empty($this->notice)) {
  136. if ($this->format == 'xml') {
  137. $this->showSingleXmlStatus($this->notice);
  138. } elseif ($this->format == 'json') {
  139. $this->show_single_json_status($this->notice);
  140. }
  141. }
  142. }
  143. }