actions/twitapidirect_messages.php

   1 <?php
   2 /*
   3  * Laconica - a distributed open-source microblogging tool
   4  * Copyright (C) 2008, Controlez-Vous, Inc.
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU Affero General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 if (!defined('LACONICA')) { exit(1); }
  21
  22 require_once(INSTALLDIR.'/lib/twitterapi.php');
  23
  24 class Twitapidirect_messagesAction extends TwitterapiAction {
  25
  26         function is_readonly() {
  27
  28                 static $write_methods = array(  'direct_messages',
  29                                                                                 'sent');
  30
  31                 $cmdtext = explode('.', $this->arg('method'));
  32
  33                 if (in_array($cmdtext[0], $write_methods)) {
  34                         return false;
  35                 }
  36
  37                 return true;
  38         }
  39
  40         function direct_messages($args, $apidata) {
  41                 parent::handle($args);
  42                 return $this->show_messages($args, $apidata, 'received');
  43         }
  44
  45         function sent($args, $apidata) {
  46                 parent::handle($args);
  47                 return $this->show_messages($args, $apidata, 'sent');
  48         }
  49
  50         function show_messages($args, $apidata, $type) {
  51
  52                 $user = $apidata['user'];
  53
  54                 $count = $this->arg('count');
  55                 $since = $this->arg('since');
  56                 $since_id = $this->arg('since_id');
  57                 $page = $this->arg('page');
  58
  59                 if (!$page) {
  60                         $page = 1;
  61                 }
  62
  63                 if (!$count) {
  64                         $count = 20;
  65                 }
  66
  67                 $message = new Message();
  68
  69                 $title = null;
  70                 $subtitle = null;
  71                 $link = null;
  72                 $server = common_root_url();
  73
  74                 if ($type == 'received') {
  75                         $message->to_profile = $user->id;
  76                         $title = sprintf(_("Direct messages to %s"), $user->nickname);
  77                         $subtitle = sprintf(_("All the direct messages sent to %s"), $user->nickname);
  78                         $link = $server . $user->nickname . '/inbox';
  79                 } else {
  80                         $message->from_profile = $user->id;
  81                         $title = _('Direct Messages You\'ve Sent');
  82                         $subtitle = sprintf(_("All the direct messages sent from %s"), $user->nickname);
  83                         $link = $server . $user->nickname . '/outbox';
  84                 }
  85
  86                 $message->orderBy('created DESC, id DESC');
  87                 $message->limit((($page-1)*20), $count);
  88                 $message->find();
  89
  90                 switch($apidata['content-type']) {
  91                  case 'xml':
  92                         $this->show_xml_dmsgs($message);
  93                         break;
  94                  case 'rss':
  95                         $this->show_rss_dmsgs($message, $title, $link, $subtitle);
  96                         break;
  97                  case 'atom':
  98                         $this->show_atom_dmsgs($message, $title, $link, $subtitle);
  99                         break;
 100                  case 'json':
 101                         $this->show_json_dmsgs($message);
 102                         break;
 103                  default:
 104                         common_user_error(_('API method not found!'), $code = 404);
 105                 }
 106
 107                 exit();
 108         }
 109
 110         // had to change this from "new" to "create" to avoid PHP reserved word
 111         function create($args, $apidata) {
 112                 parent::handle($args);
 113
 114                 if ($_SERVER['REQUEST_METHOD'] != 'POST') {
 115                         $this->client_error(_('This method requires a POST.'), 400, $apidata['content-type']);
 116                         exit();
 117                 }
 118
 119                 $user = $apidata['user'];
 120                 $source = $this->trimmed('source');  // Not supported by Twitter.
 121
 122                 if (!$source) {
 123                         $source = 'api';
 124                 }
 125
 126                 $content = $this->trimmed('text');
 127
 128                 if (!$content) {
 129                         $this->client_error(_('No message text!'), $code = 406, $apidata['content-type']);
 130                 } else if (mb_strlen($status) > 140) {
 131                         $this->client_error(_('That\'s too long. Max message size is 140 chars.'),
 132                                 $code = 406, $apidata['content-type']);
 133                         exit();
 134                 }
 135
 136                 common_debug($this->trimmed('user'));
 137
 138                 $other = $this->get_user($this->trimmed('user'));
 139
 140                 if (!$other) {
 141                         $this->client_error(_('Recipient user not found.'), $code = 403, $apidata['content-type']);
 142                         exit();
 143                 } else if (!$user->mutuallySubscribed($other)) {
 144                         $this->client_error(_('Can\'t send direct messages to users who aren\'t your friend.'),
 145                                 $code = 403, $apidata['content-type']);
 146                         exit();
 147                 } else if ($user->id == $other->id) {
 148                         // Sending msgs to yourself is allowed by Twitter
 149                         $this->client_error(_('Don\'t send a message to yourself; just say it to yourself quietly instead.'),
 150                                 $code = 403, $apidata['content-type']);
 151                         exit();
 152                 }
 153
 154                 $message = Message::saveNew($user->id, $other->id, $content, $source);
 155
 156                 if (is_string($message)) {
 157                         $this->server_error($message);
 158                         exit();
 159                 }
 160
 161                 $this->notify($user, $other, $message);
 162
 163                 if ($apidata['content-type'] == 'xml') {
 164                         $this->show_single_xml_dmsg($message);
 165                 } elseif ($apidata['content-type'] == 'json') {
 166                         $this->show_single_json_dmsg($message);
 167                 }
 168
 169                 exit();
 170         }
 171
 172         function destroy($args, $apidata) {
 173                 parent::handle($args);
 174                 common_server_error(_('API method under construction.'), $code=501);
 175                 exit();
 176         }
 177
 178         function show_xml_dmsgs($message) {
 179
 180                 $this->init_document('xml');
 181                 common_element_start('direct-messages', array('type' => 'array'));
 182
 183                 if (is_array($messages)) {
 184                         foreach ($message as $m) {
 185                                 $twitter_dm = $this->twitter_dmsg_array($m);
 186                                 $this->show_twitter_xml_dmsg($twitter_dm);
 187                         }
 188                 } else {
 189                         while ($message->fetch()) {
 190                                 $twitter_dm = $this->twitter_dmsg_array($message);
 191                                 $this->show_twitter_xml_dmsg($twitter_dm);
 192                         }
 193                 }
 194
 195                 common_element_end('direct-messages');
 196                 $this->end_document('xml');
 197
 198         }
 199
 200         function show_json_dmsgs($message) {
 201
 202                 $this->init_document('json');
 203
 204                 $dmsgs = array();
 205
 206                 if (is_array($message)) {
 207                         foreach ($message as $m) {
 208                                 $twitter_dm = $this->twitter_dmsg_array($m);
 209                                 array_push($dmsgs, $twitter_dm);
 210                         }
 211                 } else {
 212                         while ($message->fetch()) {
 213                                 $twitter_dm = $this->twitter_dmsg_array($message);
 214                                 array_push($dmsgs, $twitter_dm);
 215                         }
 216                 }
 217
 218                 $this->show_twitter_json_dmsgs($dmsgs);
 219                 $this->end_document('json');
 220
 221         }
 222
 223         function show_rss_dmsgs($message, $title, $link, $subtitle) {
 224
 225                 $this->init_document('rss');
 226
 227                 common_element_start('channel');
 228                 common_element('title', NULL, $title);
 229
 230                 common_element('link', NULL, $link);
 231                 common_element('description', NULL, $subtitle);
 232                 common_element('language', NULL, 'en-us');
 233                 common_element('ttl', NULL, '40');
 234
 235                 if (is_array($message)) {
 236                         foreach ($message as $m) {
 237                                 $entry = $this->twitter_rss_dmsg_array($m);
 238                                 $this->show_twitter_rss_item($entry);
 239                         }
 240                 } else {
 241                         while ($message->fetch()) {
 242                                 $entry = $this->twitter_rss_dmsg_array($message);
 243                                 $this->show_twitter_rss_item($entry);
 244                         }
 245                 }
 246
 247                 common_element_end('channel');
 248                 $this->end_twitter_rss();
 249
 250         }
 251
 252         function show_atom_dmsgs($message, $title, $link, $subtitle) {
 253
 254                 $this->init_document('atom');
 255
 256                 common_element('title', NULL, $title);
 257                 $siteserver = common_config('site', 'server');
 258                 common_element('id', NULL, "tag:$siteserver,2008:DirectMessage");
 259                 common_element('link', array('href' => $link, 'rel' => 'alternate', 'type' => 'text/html'), NULL);
 260                 common_element('updated', NULL, common_date_iso8601(strftime('%c')));
 261                 common_element('subtitle', NULL, $subtitle);
 262
 263                 if (is_array($message)) {
 264                         foreach ($message as $m) {
 265                                 $entry = $this->twitter_rss_dmsg_array($m);
 266                                 $this->show_twitter_atom_entry($entry);
 267                         }
 268                 } else {
 269                         while ($message->fetch()) {
 270                                 $entry = $this->twitter_rss_dmsg_array($message);
 271                                 $this->show_twitter_atom_entry($entry);
 272                         }
 273                 }
 274
 275                 $this->end_document('atom');
 276         }
 277
 278         // swiped from MessageAction. Should it be place in util.php?
 279         function notify($from, $to, $message) {
 280                 mail_notify_message($message, $from, $to);
 281                 # XXX: Jabber, SMS notifications... probably queued
 282         }
 283
 284 }