3 * Laconica - a distributed open-source microblogging tool
4 * Copyright (C) 2008, Controlez-Vous, Inc.
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.
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.
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/>.
20 if (!defined('LACONICA')) { exit(1); }
22 require_once(INSTALLDIR.'/lib/twitterapi.php');
24 class TwitapifriendshipsAction extends TwitterapiAction {
26 function is_readonly() {
28 static $write_methods = array( 'create',
31 $cmdtext = explode('.', $this->arg('method'));
33 if (in_array($cmdtext[0], $write_methods)) {
40 function create($args, $apidata) {
41 parent::handle($args);
43 $id = $apidata['api_arg'];
45 $other = $this->get_user($id);
48 $this->client_error(_('Could not follow user: User not found.'), 403, $apidata['content-type']);
52 $user = $apidata['user'];
54 if ($user->isSubscribed($other)) {
55 $this->client_error("Could not follow user: $other->nickname is already on your list.", 403, $apidata['content-type']);
59 $sub = new Subscription();
63 $sub->subscriber = $user->id;
64 $sub->subscribed = $other->id;
65 $sub->created = DB_DataObject_Cast::dateTime(); # current time
67 $result = $sub->insert();
70 $this->client_error("Could not follow user: $other->nickname.", 400, $apidata['content-type']);
74 $sub->query('COMMIT');
76 mail_subscribe_notify($other, $user);
78 $type = $apidata['content-type'];
79 $this->init_document($type);
80 $this->show_profile($other, $type);
81 $this->end_document($type);
87 //Discontinues friendship with the user specified in the ID parameter as the authenticating user. Returns the un-friended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful.
89 //URL: http://twitter.com/friendships/destroy/id.format
95 //* id. Required. The ID or screen name of the user with whom to discontinue friendship. Ex: http://twitter.com/friendships/destroy/12345.json or http://twitter.com/friendships/destroy/bob.xml
97 function destroy($args, $apidata) {
98 parent::handle($args);
99 $id = $apidata['api_arg'];
101 # We can't subscribe to a remote person, but we can unsub
103 $other = $this->get_profile($id);
104 $user = $apidata['user'];
106 $sub = new Subscription();
107 $sub->subscriber = $user->id;
108 $sub->subscribed = $other->id;
110 if ($sub->find(TRUE)) {
111 $sub->query('BEGIN');
113 $sub->query('COMMIT');
115 $this->client_error(_('You are not friends with the specified user.'), 403, $apidata['content-type']);
119 $type = $apidata['content-type'];
120 $this->init_document($type);
121 $this->show_profile($other, $type);
122 $this->end_document($type);
126 // Tests if a friendship exists between two users.
129 // URL: http://twitter.com/friendships/exists.format
131 // Formats: xml, json, none
135 // * user_a. Required. The ID or screen_name of the first user to test friendship for.
136 // * user_b. Required. The ID or screen_name of the second user to test friendship for.
137 // * Ex: http://twitter.com/friendships/exists.xml?user_a=alice&user_b=bob
139 function exists($args, $apidata) {
140 parent::handle($args);
143 $user_a_id = $this->trimmed('user_a');
144 $user_b_id = $this->trimmed('user_b');
146 $user_a = $this->get_user($user_a_id);
147 $user_b = $this->get_user($user_b_id);
149 if (!$user_a || !$user_b) {
150 $this->client_error(_('Two user ids or screen_names must be supplied.'), 400, $apidata['content-type']);
154 if ($user_a->isSubscribed($user_b)) {
160 switch ($apidata['content-type']) {
162 $this->init_document('xml');
163 common_element('friends', NULL, $result);
164 $this->end_document('xml');
167 $this->init_document('json');
168 print json_encode($result);
169 $this->end_document('json');
172 print $result; // Really? --Zach
179 function get_profile($id) {
180 if (is_numeric($id)) {
181 return Profile::staticGet($id);
183 $user = User::staticGet('nickname', $id);
185 return $user->getProfile();
192 function get_user($id) {
193 if (is_numeric($id)) {
194 return User::staticGet($id);
196 return User::staticGet('nickname', $id);