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 TwitapifavoritesAction extends TwitterapiAction {
26 function is_readonly() {
28 static $write_methods = array('favorites');
30 $cmdtext = explode('.', $this->arg('method'));
32 if (in_array($cmdtext[0], $write_methods)) {
39 function favorites($args, $apidata) {
40 parent::handle($args);
44 // function was called with an argument /favorites/api_arg.format
45 if (isset($apidata['api_arg'])) {
47 if (is_numeric($apidata['api_arg'])) {
48 $user = User::staticGet($apidata['api_arg']);
50 $nickname = common_canonical_nickname($apidata['api_arg']);
51 $user = User::staticGet('nickname', $nickname);
55 // if no user was specified, then we'll use the authenticated user
56 $user = $apidata['user'];
60 // Set the user to be the auth user if asked-for can't be found
61 // honestly! This is what Twitter does, I swear --Zach
62 $user = $apidata['user'];
65 $profile = $user->getProfile();
68 common_server_error(_('User has no profile.'));
72 $page = $this->arg('page');
82 $notice = $user->favoriteNotices((($page-1)*20), $count);
85 common_server_error(_('Could not retrieve favorite notices.'));
89 $sitename = common_config('site', 'name');
90 $siteserver = common_config('site', 'server');
92 $title = sprintf(_('%s / Favorites from %s'), $sitename, $user->nickname);
93 $id = "tag:$siteserver:favorites:".$user->id;
94 $link = common_local_url('favorites', array('nickname' => $user->nickname));
95 $subtitle = sprintf(_('%s updates favorited by %s / %s.'), $sitename, $profile->getBestName(), $user->nickname);
97 switch($apidata['content-type']) {
99 $this->show_xml_timeline($notice);
102 $this->show_rss_timeline($notice, $title, $id, $link, $subtitle);
105 $this->show_atom_timeline($notice, $title, $id, $link, $subtitle);
108 $this->show_json_timeline($notice);
111 common_user_error(_('API method not found!'), $code = 404);
116 function create($args, $apidata) {
117 parent::handle($args);
119 if (!in_array($apidata['content-type'], array('xml', 'json'))) {
120 common_user_error(_('API method not found!'), $code = 404);
124 // Check for RESTfulness
125 if (!in_array($_SERVER['REQUEST_METHOD'], array('POST', 'DELETE'))) {
126 // XXX: Twitter just prints the err msg, no XML / JSON.
127 $this->client_error(_('This method requires a POST or DELETE.'), 400, $apidata['content-type']);
131 $user = $apidata['user'];
132 $notice_id = $apidata['api_arg'];
133 $notice = Notice::staticGet($notice_id);
136 $this->client_error(_('No status found with that ID.'), 404, $apidata['content-type']);
140 // XXX: Twitter lets you fave things repeatedly via api.
141 if ($user->hasFave($notice)) {
142 $this->client_error(_('This notice is already a favorite!'), 403, $apidata['content-type']);
146 common_debug("notice: " . $apidata['api_arg']);
148 $fave = Fave::addNew($user, $notice);
151 common_server_error(_('Could not create favorite.'));
155 $this->notify($fave, $notice, $user);
156 $user->blowFavesCache();
158 if ($apidata['content-type'] == 'xml') {
159 $this->show_single_xml_status($notice);
160 } elseif ($apidata['content-type'] == 'json') {
161 $this->show_single_json_status($notice);
166 function destroy($args, $apidata) {
167 parent::handle($args);
168 common_server_error(_('API method under construction.'), $code=501);
171 // XXX: these two funcs swiped from faves. Maybe put in util.php, or some common base class?
173 function notify($fave, $notice, $user) {
174 $other = User::staticGet('id', $notice->profile_id);
175 if ($other && $other->id != $user->id) {
176 if ($other->email && $other->emailnotifyfav) {
177 $this->notify_mail($other, $user, $notice);
184 function notify_mail($other, $user, $notice) {
185 $profile = $user->getProfile();
186 $bestname = $profile->getBestName();
187 $subject = sprintf(_('%s added your notice as a favorite'), $bestname);
188 $body = sprintf(_("%1\$s just added your notice from %2\$s as one of their favorites.\n\n" .
189 "In case you forgot, you can see the text of your notice here:\n\n" .
191 "You can see the list of %1\$s's favorites here:\n\n" .
193 "Faithfully yours,\n" .
196 common_exact_date($notice->created),
197 common_local_url('shownotice', array('notice' => $notice->id)),
198 common_local_url('showfavorites', array('nickname' => $user->nickname)),
199 common_config('site', 'name'));
201 mail_to_user($other, $subject, $body);