Ticket #1567 - API: Change before_id parameter to max_id
[statusnet:swintons-clone.git] / 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
27     function direct_messages($args, $apidata)
28     {
29         parent::handle($args);
30         return $this->show_messages($args, $apidata, 'received');
31     }
32
33     function sent($args, $apidata)
34     {
35         parent::handle($args);
36         return $this->show_messages($args, $apidata, 'sent');
37     }
38
39     function show_messages($args, $apidata, $type)
40     {
41         $user = $apidata['user'];
42
43         $count = $this->arg('count');
44         $since = $this->arg('since');
45         $since_id = $this->arg('since_id');
46         $max_id = $this->arg('max_id');
47
48         $page = $this->arg('page');
49
50         if (!$page) {
51             $page = 1;
52         }
53
54         if (!$count) {
55             $count = 20;
56         }
57
58         $message = new Message();
59
60         $title = null;
61         $subtitle = null;
62         $link = null;
63         $server = common_root_url();
64
65         if ($type == 'received') {
66             $message->to_profile = $user->id;
67             $title = sprintf(_("Direct messages to %s"), $user->nickname);
68             $subtitle = sprintf(_("All the direct messages sent to %s"), $user->nickname);
69             $link = $server . $user->nickname . '/inbox';
70         } else {
71             $message->from_profile = $user->id;
72             $title = _('Direct Messages You\'ve Sent');
73             $subtitle = sprintf(_("All the direct messages sent from %s"), $user->nickname);
74             $link = $server . $user->nickname . '/outbox';
75         }
76
77         if ($max_id) {
78             $message->whereAdd("id < $max_id");
79         }
80
81         if ($since_id) {
82             $message->whereAdd("id > $since_id");
83         }
84
85         $since = strtotime($this->arg('since'));
86
87         if ($since) {
88             $d = date('Y-m-d H:i:s', $since);
89             $message->whereAdd("created > '$d'");
90         }
91
92         $message->orderBy('created DESC, id DESC');
93         $message->limit((($page-1)*20), $count);
94         $message->find();
95
96         switch($apidata['content-type']) {
97          case 'xml':
98             $this->show_xml_dmsgs($message);
99             break;
100          case 'rss':
101             $this->show_rss_dmsgs($message, $title, $link, $subtitle);
102             break;
103          case 'atom':
104             $selfuri = common_root_url() . 'api/direct_messages';
105             $selfuri .= ($type == 'received') ? '.atom' : '/sent.atom';
106             $taguribase = common_config('integration', 'taguri');
107
108             if ($type == 'sent') {
109                 $id = "tag:$taguribase:SentDirectMessages:" . $user->id;
110             } else {
111                 $id = "tag:$taguribase:DirectMessages:" . $user->id;
112             }
113
114             $this->show_atom_dmsgs($message, $title, $link, $subtitle, $selfuri, $id);
115             break;
116          case 'json':
117             $this->show_json_dmsgs($message);
118             break;
119          default:
120             $this->clientError(_('API method not found!'), $code = 404);
121         }
122
123     }
124
125     // had to change this from "new" to "create" to avoid PHP reserved word
126     function create($args, $apidata)
127     {
128         parent::handle($args);
129
130         if ($_SERVER['REQUEST_METHOD'] != 'POST') {
131             $this->clientError(_('This method requires a POST.'), 400, $apidata['content-type']);
132             return;
133         }
134
135         $user = $apidata['user'];
136         $source = $this->trimmed('source');     // Not supported by Twitter.
137
138         $reserved_sources = array('web', 'omb', 'mail', 'xmpp', 'api');
139         if (!$source || in_array($source, $reserved_sources)) {
140             $source = 'api';
141         }
142
143         $content = $this->trimmed('text');
144
145         if (!$content) {
146             $this->clientError(_('No message text!'), $code = 406, $apidata['content-type']);
147         } else {
148             $content_shortened = common_shorten_links($content);
149             if (mb_strlen($content_shortened) > 140) {
150                 $this->clientError(_('That\'s too long. Max message size is 140 chars.'),
151                     $code = 406, $apidata['content-type']);
152                 return;
153             }
154         }
155
156         $other = $this->get_user($this->trimmed('user'));
157
158         if (!$other) {
159             $this->clientError(_('Recipient user not found.'), $code = 403, $apidata['content-type']);
160             return;
161         } else if (!$user->mutuallySubscribed($other)) {
162             $this->clientError(_('Can\'t send direct messages to users who aren\'t your friend.'),
163                 $code = 403, $apidata['content-type']);
164             return;
165         } else if ($user->id == $other->id) {
166             // Sending msgs to yourself is allowed by Twitter
167             $this->clientError(_('Don\'t send a message to yourself; just say it to yourself quietly instead.'),
168                 $code = 403, $apidata['content-type']);
169             return;
170         }
171
172         $message = Message::saveNew($user->id, $other->id,
173             html_entity_decode($content, ENT_NOQUOTES, 'UTF-8'), $source);
174
175         if (is_string($message)) {
176             $this->serverError($message);
177             return;
178         }
179
180         $this->notify($user, $other, $message);
181
182         if ($apidata['content-type'] == 'xml') {
183             $this->show_single_xml_dmsg($message);
184         } elseif ($apidata['content-type'] == 'json') {
185             $this->show_single_json_dmsg($message);
186         }
187
188     }
189
190     function destroy($args, $apidata)
191     {
192         parent::handle($args);
193         $this->serverError(_('API method under construction.'), $code=501);
194     }
195
196     function show_xml_dmsgs($message)
197     {
198
199         $this->init_document('xml');
200         $this->elementStart('direct-messages', array('type' => 'array'));
201
202         if (is_array($message)) {
203             foreach ($message as $m) {
204                 $twitter_dm = $this->twitter_dmsg_array($m);
205                 $this->show_twitter_xml_dmsg($twitter_dm);
206             }
207         } else {
208             while ($message->fetch()) {
209                 $twitter_dm = $this->twitter_dmsg_array($message);
210                 $this->show_twitter_xml_dmsg($twitter_dm);
211             }
212         }
213
214         $this->elementEnd('direct-messages');
215         $this->end_document('xml');
216
217     }
218
219     function show_json_dmsgs($message)
220     {
221
222         $this->init_document('json');
223
224         $dmsgs = array();
225
226         if (is_array($message)) {
227             foreach ($message as $m) {
228                 $twitter_dm = $this->twitter_dmsg_array($m);
229                 array_push($dmsgs, $twitter_dm);
230             }
231         } else {
232             while ($message->fetch()) {
233                 $twitter_dm = $this->twitter_dmsg_array($message);
234                 array_push($dmsgs, $twitter_dm);
235             }
236         }
237
238         $this->show_json_objects($dmsgs);
239         $this->end_document('json');
240
241     }
242
243     function show_rss_dmsgs($message, $title, $link, $subtitle)
244     {
245
246         $this->init_document('rss');
247
248         $this->elementStart('channel');
249         $this->element('title', null, $title);
250
251         $this->element('link', null, $link);
252         $this->element('description', null, $subtitle);
253         $this->element('language', null, 'en-us');
254         $this->element('ttl', null, '40');
255
256         if (is_array($message)) {
257             foreach ($message as $m) {
258                 $entry = $this->twitter_rss_dmsg_array($m);
259                 $this->show_twitter_rss_item($entry);
260             }
261         } else {
262             while ($message->fetch()) {
263                 $entry = $this->twitter_rss_dmsg_array($message);
264                 $this->show_twitter_rss_item($entry);
265             }
266         }
267
268         $this->elementEnd('channel');
269         $this->end_twitter_rss();
270
271     }
272
273     function show_atom_dmsgs($message, $title, $link, $subtitle, $selfuri, $id)
274     {
275
276         $this->init_document('atom');
277
278         $this->element('title', null, $title);
279         $this->element('id', null, $id);
280         $this->element('link', array('href' => $link, 'rel' => 'alternate', 'type' => 'text/html'), null);
281         $this->element('link', array('href' => $selfuri, 'rel' => 'self',
282             'type' => 'application/atom+xml'), null);
283         $this->element('updated', null, common_date_iso8601('now'));
284         $this->element('subtitle', null, $subtitle);
285
286         if (is_array($message)) {
287             foreach ($message as $m) {
288                 $entry = $this->twitter_rss_dmsg_array($m);
289                 $this->show_twitter_atom_entry($entry);
290             }
291         } else {
292             while ($message->fetch()) {
293                 $entry = $this->twitter_rss_dmsg_array($message);
294                 $this->show_twitter_atom_entry($entry);
295             }
296         }
297
298         $this->end_document('atom');
299     }
300
301     // swiped from MessageAction. Should it be place in util.php?
302     function notify($from, $to, $message)
303     {
304         mail_notify_message($message, $from, $to);
305         # XXX: Jabber, SMS notifications... probably queued
306     }
307
308 }