639 lines
19 KiB
PHP
639 lines
19 KiB
PHP
<?php
|
|
/*
|
|
* Laconica - a distributed open-source microblogging tool
|
|
* Copyright (C) 2008, Controlez-Vous, Inc.
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
if (!defined('LACONICA')) { exit(1); }
|
|
|
|
require_once(INSTALLDIR.'/lib/twitterapi.php');
|
|
|
|
/* XXX: Please don't freak out about all the ugly comments in this file.
|
|
* They are mostly in here for reference while I work on the
|
|
* API. I'll fix things up later to make them look better later. -- Zach
|
|
*/
|
|
class TwitapistatusesAction extends TwitterapiAction {
|
|
|
|
function public_timeline($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$sitename = common_config('site', 'name');
|
|
$siteserver = common_config('site', 'server');
|
|
$title = sprintf(_("%s public timeline"), $sitename);
|
|
$id = "tag:$siteserver:Statuses";
|
|
$link = common_root_url();
|
|
$subtitle = sprintf(_("%s updates from everyone!"), $sitemap);
|
|
|
|
// Number of public statuses to return by default -- Twitter sends 20
|
|
$MAX_PUBSTATUSES = 20;
|
|
|
|
$notice = DB_DataObject::factory('notice');
|
|
|
|
// FIXME: To really live up to the spec we need to build a list
|
|
// of notices by users who have custom avatars, so fix this SQL -- Zach
|
|
|
|
# FIXME: bad performance
|
|
$notice->whereAdd('EXISTS (SELECT user.id from user where user.id = notice.profile_id)');
|
|
$notice->orderBy('created DESC, notice.id DESC');
|
|
$notice->limit($MAX_PUBSTATUSES);
|
|
$cnt = $notice->find();
|
|
|
|
if ($cnt > 0) {
|
|
|
|
switch($apidata['content-type']) {
|
|
case 'xml':
|
|
$this->show_xml_timeline($notice);
|
|
break;
|
|
case 'rss':
|
|
$this->show_rss_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'atom':
|
|
$this->show_atom_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'json':
|
|
$this->show_json_timeline($notice);
|
|
break;
|
|
default:
|
|
common_user_error("API method not found!", $code = 404);
|
|
break;
|
|
}
|
|
|
|
} else {
|
|
common_server_error('Couldn\'t find any statuses.', $code = 503);
|
|
}
|
|
|
|
exit();
|
|
}
|
|
|
|
function show_xml_timeline($notice) {
|
|
|
|
header('Content-Type: application/xml; charset=utf-8');
|
|
common_start_xml();
|
|
common_element_start('statuses', array('type' => 'array'));
|
|
|
|
if (is_array($notice)) {
|
|
foreach ($notice as $n) {
|
|
$twitter_status = $this->twitter_status_array($n);
|
|
$this->show_twitter_xml_status($twitter_status);
|
|
}
|
|
} else {
|
|
while ($notice->fetch()) {
|
|
$twitter_status = $this->twitter_status_array($notice);
|
|
$this->show_twitter_xml_status($twitter_status);
|
|
}
|
|
}
|
|
|
|
common_element_end('statuses');
|
|
common_end_xml();
|
|
}
|
|
|
|
function show_rss_timeline($notice, $title, $id, $link, $subtitle) {
|
|
|
|
header("Content-Type: application/rss+xml; charset=utf-8");
|
|
|
|
$this->init_twitter_rss();
|
|
|
|
common_element_start('channel');
|
|
common_element('title', NULL, $title);
|
|
common_element('link', NULL, $link);
|
|
common_element('description', NULL, $subtitle);
|
|
common_element('language', NULL, 'en-us');
|
|
common_element('ttl', NULL, '40');
|
|
|
|
|
|
if (is_array($notice)) {
|
|
foreach ($notice as $n) {
|
|
$entry = $this->twitter_rss_entry_array($n);
|
|
$this->show_twitter_rss_item($entry);
|
|
}
|
|
} else {
|
|
while ($notice->fetch()) {
|
|
$entry = $this->twitter_rss_entry_array($notice);
|
|
$this->show_twitter_rss_item($entry);
|
|
}
|
|
}
|
|
|
|
common_element_end('channel');
|
|
$this->end_twitter_rss();
|
|
}
|
|
|
|
function show_atom_timeline($notice, $title, $id, $link, $subtitle=NULL) {
|
|
|
|
header('Content-Type: application/atom+xml; charset=utf-8');
|
|
|
|
$this->init_twitter_atom();
|
|
|
|
common_element('title', NULL, $title);
|
|
common_element('id', NULL, $id);
|
|
common_element('link', array('href' => $link, 'rel' => 'alternate', 'type' => 'text/html'), NULL);
|
|
common_element('subtitle', NULL, $subtitle);
|
|
|
|
if (is_array($notice)) {
|
|
foreach ($notice as $n) {
|
|
$entry = $this->twitter_rss_entry_array($n);
|
|
$this->show_twitter_atom_entry($entry);
|
|
}
|
|
} else {
|
|
while ($notice->fetch()) {
|
|
$entry = $this->twitter_rss_entry_array($notice);
|
|
$this->show_twitter_atom_entry($entry);
|
|
}
|
|
}
|
|
|
|
$this->end_twitter_atom();
|
|
}
|
|
|
|
function show_json_timeline($notice) {
|
|
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
|
|
$statuses = array();
|
|
|
|
if (is_array($notice)) {
|
|
foreach ($notice as $n) {
|
|
$twitter_status = $this->twitter_status_array($n);
|
|
array_push($statuses, $twitter_status);
|
|
}
|
|
} else {
|
|
while ($notice->fetch()) {
|
|
$twitter_status = $this->twitter_status_array($notice);
|
|
array_push($statuses, $twitter_status);
|
|
}
|
|
}
|
|
|
|
$this->show_twitter_json_statuses($statuses);
|
|
}
|
|
|
|
/*
|
|
Returns the 20 most recent statuses posted by the authenticating user and that user's friends.
|
|
This is the equivalent of /home on the Web.
|
|
|
|
URL: http://server/api/statuses/friends_timeline.format
|
|
|
|
Parameters:
|
|
|
|
* since. Optional. Narrows the returned results to just those statuses created after the specified
|
|
HTTP-formatted date. The same behavior is available by setting an If-Modified-Since header in
|
|
your HTTP request.
|
|
Ex: http://server/api/statuses/friends_timeline.rss?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
|
|
* since_id. Optional. Returns only statuses with an ID greater than (that is, more recent than)
|
|
the specified ID. Ex: http://server/api/statuses/friends_timeline.xml?since_id=12345
|
|
* count. Optional. Specifies the number of statuses to retrieve. May not be greater than 200.
|
|
Ex: http://server/api/statuses/friends_timeline.xml?count=5
|
|
* page. Optional. Ex: http://server/api/statuses/friends_timeline.rss?page=3
|
|
|
|
Formats: xml, json, rss, atom
|
|
*/
|
|
function friends_timeline($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$since = $this->arg('since');
|
|
$since_id = $this->arg('since_id');
|
|
$count = $this->arg('count');
|
|
$page = $this->arg('page');
|
|
|
|
if (!$page) {
|
|
$page = 1;
|
|
}
|
|
|
|
if (!$count) {
|
|
$count = 20;
|
|
}
|
|
|
|
$user = $this->get_user($id, $apidata);
|
|
$profile = $user->getProfile();
|
|
|
|
$sitename = common_config('site', 'name');
|
|
$siteserver = common_config('site', 'server');
|
|
|
|
$title = sprintf(_("%s and friends"), $user->nickname);
|
|
$id = "tag:$siteserver:friends:".$user->id;
|
|
$link = common_local_url('all', array('nickname' => $user->nickname));
|
|
$subtitle = sprintf(_("Updates from %s and friends on %s!"), $user->nickname, $sitename);
|
|
|
|
$notice = new Notice();
|
|
|
|
# XXX: chokety and bad
|
|
|
|
$notice->whereAdd('EXISTS (SELECT subscribed from subscription where subscriber = '.$profile->id.' and subscribed = notice.profile_id)', 'OR');
|
|
$notice->whereAdd('profile_id = ' . $profile->id, 'OR');
|
|
|
|
# XXX: since
|
|
# XXX: since_id
|
|
|
|
$notice->orderBy('created DESC, notice.id DESC');
|
|
|
|
$notice->limit((($page-1)*20), $count);
|
|
|
|
$cnt = $notice->find();
|
|
|
|
switch($apidata['content-type']) {
|
|
case 'xml':
|
|
$this->show_xml_timeline($notice);
|
|
break;
|
|
case 'rss':
|
|
$this->show_rss_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'atom':
|
|
$this->show_atom_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'json':
|
|
$this->show_json_timeline($notice);
|
|
break;
|
|
default:
|
|
common_user_error("API method not found!", $code = 404);
|
|
}
|
|
|
|
exit();
|
|
}
|
|
|
|
/*
|
|
Returns the 20 most recent statuses posted from the authenticating user. It's also possible to
|
|
request another user's timeline via the id parameter below. This is the equivalent of the Web
|
|
/archive page for your own user, or the profile page for a third party.
|
|
|
|
URL: http://server/api/statuses/user_timeline.format
|
|
|
|
Formats: xml, json, rss, atom
|
|
|
|
Parameters:
|
|
|
|
* id. Optional. Specifies the ID or screen name of the user for whom to return the
|
|
friends_timeline. Ex: http://server/api/statuses/user_timeline/12345.xml or
|
|
http://server/api/statuses/user_timeline/bob.json.
|
|
* count. Optional. Specifies the number of
|
|
statuses to retrieve. May not be greater than 200. Ex:
|
|
http://server/api/statuses/user_timeline.xml?count=5
|
|
* since. Optional. Narrows the returned
|
|
results to just those statuses created after the specified HTTP-formatted date. The same
|
|
behavior is available by setting an If-Modified-Since header in your HTTP request. Ex:
|
|
http://server/api/statuses/user_timeline.rss?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
|
|
* since_id. Optional. Returns only statuses with an ID greater than (that is, more recent than)
|
|
the specified ID. Ex: http://server/api/statuses/user_timeline.xml?since_id=12345 * page.
|
|
Optional. Ex: http://server/api/statuses/friends_timeline.rss?page=3
|
|
*/
|
|
function user_timeline($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$id = $this->arg('id');
|
|
$count = $this->arg('count');
|
|
$since = $this->arg('since');
|
|
$since_id = $this->arg('since_id');
|
|
|
|
if (!$page) {
|
|
$page = 1;
|
|
}
|
|
|
|
if (!$count) {
|
|
$count = 20;
|
|
}
|
|
|
|
$user = $this->get_user($id, $apidata['user']);
|
|
|
|
if (!$user) {
|
|
$this->client_error(_('No such user'), 404);
|
|
return;
|
|
}
|
|
|
|
$profile = $user->getProfile();
|
|
|
|
$sitename = common_config('site', 'name');
|
|
$siteserver = common_config('site', 'server');
|
|
|
|
$title = sprintf(_("%s timeline"), $user->nickname);
|
|
$id = "tag:$siteserver:user:".$user->id;
|
|
$link = common_local_url('showstream', array('nickname' => $user->nickname));
|
|
$subtitle = sprintf(_("Updates from %s on %s!"), $user->nickname, $sitename);
|
|
|
|
$notice = new Notice();
|
|
|
|
$notice->profile_id = $user->id;
|
|
|
|
# XXX: since
|
|
# XXX: since_id
|
|
|
|
$notice->orderBy('created DESC, notice.id DESC');
|
|
|
|
$notice->limit((($page-1)*20), $count);
|
|
|
|
$cnt = $notice->find();
|
|
|
|
switch($apidata['content-type']) {
|
|
case 'xml':
|
|
$this->show_xml_timeline($notice);
|
|
break;
|
|
case 'rss':
|
|
$this->show_rss_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'atom':
|
|
$this->show_atom_timeline($notice, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'json':
|
|
$this->show_json_timeline($notice);
|
|
break;
|
|
default:
|
|
common_user_error("API method not found!", $code = 404);
|
|
}
|
|
|
|
exit();
|
|
}
|
|
|
|
function show($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$id = $apidata['api_arg'];
|
|
$notice = Notice::staticGet($id);
|
|
|
|
if ($notice) {
|
|
|
|
if ($apidata['content-type'] == 'xml') {
|
|
$this->show_single_xml_status($notice);
|
|
} elseif ($apidata['content-type'] == 'json') {
|
|
$this->show_single_json_status($notice);
|
|
}
|
|
} else {
|
|
header('HTTP/1.1 404 Not Found');
|
|
}
|
|
|
|
exit();
|
|
}
|
|
|
|
function show_single_xml_status($notice) {
|
|
header('Content-Type: application/xml; charset=utf-8');
|
|
common_start_xml();
|
|
$twitter_status = $this->twitter_status_array($notice);
|
|
$this->show_twitter_xml_status($twitter_status);
|
|
common_end_xml();
|
|
exit();
|
|
}
|
|
|
|
function show_single_json_status($notice) {
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
$status = $this->twitter_status_array($notice);
|
|
$this->show_twitter_json_statuses($status);
|
|
exit();
|
|
}
|
|
|
|
function update($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$user = $apidata['user'];
|
|
|
|
$notice = DB_DataObject::factory('notice');
|
|
|
|
$notice->profile_id = $user->id; # user id *is* profile id
|
|
$notice->created = DB_DataObject_Cast::dateTime();
|
|
$notice->content = $this->trimmed('status');
|
|
|
|
if (!$notice->content) {
|
|
|
|
// XXX: Note: In this case, Twitter simply returns '200 OK'
|
|
// No error is given, but the status is not posted to the
|
|
// user's timeline. Seems bad. Shouldn't we throw an
|
|
// errror? -- Zach
|
|
exit();
|
|
|
|
} else if (strlen($notice->content) > 140) {
|
|
|
|
// XXX: Twitter truncates anything over 140, flags the status
|
|
// as "truncated." Sending this error may screw up some clients
|
|
// that assume Twitter will truncate for them. Should we just
|
|
// truncate too? -- Zach
|
|
header('HTTP/1.1 406 Not Acceptable');
|
|
print "That's too long. Max notice size is 140 chars.\n";
|
|
exit();
|
|
}
|
|
|
|
$notice->rendered = common_render_content($notice->content, $notice);
|
|
|
|
$id = $notice->insert();
|
|
|
|
if (!$id) {
|
|
common_server_error('Could not update status!', 500);
|
|
exit();
|
|
}
|
|
|
|
$orig = clone($notice);
|
|
$notice->uri = common_notice_uri($notice);
|
|
|
|
if (!$notice->update($orig)) {
|
|
common_server_error('Could not save status!', 500);
|
|
exit();
|
|
}
|
|
|
|
common_save_replies($notice);
|
|
common_broadcast_notice($notice);
|
|
|
|
// FIXME: Bad Hack
|
|
// I should be able to just sent this notice off for display,
|
|
// but $notice->created does not contain a string at this
|
|
// point and I don't know how to convert it to one here. So
|
|
// I'm forced to have DBObject pull the notice back out of the
|
|
// DB before printing. --Zach
|
|
$apidata['api_arg'] = $id;
|
|
$this->show($args, $apidata);
|
|
|
|
exit();
|
|
}
|
|
|
|
/*
|
|
Returns the 20 most recent @replies (status updates prefixed with @username) for the authenticating user.
|
|
URL: http://server/api/statuses/replies.format
|
|
|
|
Formats: xml, json, rss, atom
|
|
|
|
Parameters:
|
|
|
|
* page. Optional. Retrieves the 20 next most recent replies. Ex: http://server/api/statuses/replies.xml?page=3
|
|
* since. Optional. Narrows the returned results to just those replies created after the specified HTTP-formatted date. The
|
|
same behavior is available by setting an If-Modified-Since header in your HTTP request. Ex:
|
|
http://server/api/statuses/replies.xml?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
|
|
* since_id. Optional. Returns only statuses with an ID greater than (that is, more recent than) the specified
|
|
ID. Ex: http://server/api/statuses/replies.xml?since_id=12345
|
|
*/
|
|
function replies($args, $apidata) {
|
|
parent::handle($args);
|
|
|
|
$since = $this->arg('since');
|
|
|
|
$count = $this->arg('count');
|
|
$page = $this->arg('page');
|
|
|
|
$user = $apidata['user'];
|
|
$profile = $user->getProfile();
|
|
|
|
$sitename = common_config('site', 'name');
|
|
$siteserver = common_config('site', 'server');
|
|
|
|
$title = sprintf(_("%s / Updates replying to %s"), $sitename, $user->nickname);
|
|
$id = "tag:$siteserver:replies:".$user->id;
|
|
$link = common_local_url('replies', array('nickname' => $user->nickname));
|
|
$subtitle = "gar";
|
|
$subtitle = sprintf(_("%s updates that reply to updates from %s / %."), $sitename, $user->nickname, $user->nickname);
|
|
|
|
if (!$page) {
|
|
$page = 1;
|
|
}
|
|
|
|
if (!$count) {
|
|
$count = 20;
|
|
}
|
|
|
|
$reply = new Reply();
|
|
|
|
$reply->profile_id = $user->id;
|
|
|
|
$reply->orderBy('modified DESC');
|
|
|
|
$page = ($this->arg('page')) ? ($this->arg('page')+0) : 1;
|
|
|
|
$reply->limit((($page-1)*20), $count);
|
|
|
|
$cnt = $reply->find();
|
|
|
|
$notices = array();
|
|
|
|
if ($cnt) {
|
|
while ($reply->fetch()) {
|
|
$notice = new Notice();
|
|
$notice->id = $reply->notice_id;
|
|
$result = $notice->find(true);
|
|
if (!$result) {
|
|
continue;
|
|
}
|
|
$notices[] = clone($notice);
|
|
}
|
|
}
|
|
|
|
switch($apidata['content-type']) {
|
|
case 'xml':
|
|
$this->show_xml_timeline($notices);
|
|
break;
|
|
case 'rss':
|
|
$this->show_rss_timeline($notices, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'atom':
|
|
$this->show_atom_timeline($notices, $title, $id, $link, $subtitle);
|
|
break;
|
|
case 'json':
|
|
$this->show_json_timeline($notices);
|
|
break;
|
|
default:
|
|
common_user_error("API method not found!", $code = 404);
|
|
}
|
|
|
|
|
|
exit();
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
Destroys the status specified by the required ID parameter. The authenticating user must be
|
|
the author of the specified status.
|
|
|
|
URL: http://server/api/statuses/destroy/id.format
|
|
|
|
Formats: xml, json
|
|
|
|
Parameters:
|
|
|
|
* id. Required. The ID of the status to destroy. Ex:
|
|
http://server/api/statuses/destroy/12345.json or
|
|
http://server/api/statuses/destroy/23456.xml
|
|
|
|
*/
|
|
function destroy($args, $apidata) {
|
|
parent::handle($args);
|
|
common_server_error("API method under construction.", $code=501);
|
|
}
|
|
|
|
# User Methods
|
|
|
|
/*
|
|
Returns up to 100 of the authenticating user's friends who have most recently updated, each with current status inline.
|
|
It's also possible to request another user's recent friends list via the id parameter below.
|
|
|
|
URL: http://server/api/statuses/friends.format
|
|
|
|
Formats: xml, json
|
|
|
|
Parameters:
|
|
|
|
* id. Optional. The ID or screen name of the user for whom to request a list of friends. Ex:
|
|
http://server/api/statuses/friends/12345.json
|
|
or
|
|
http://server/api/statuses/friends/bob.xml
|
|
* page. Optional. Retrieves the next 100 friends. Ex: http://server/api/statuses/friends.xml?page=2
|
|
* lite. Optional. Prevents the inline inclusion of current status. Must be set to a value of true. Ex:
|
|
http://server/api/statuses/friends.xml?lite=true
|
|
* since. Optional. Narrows the returned results to just those friendships created after the specified
|
|
HTTP-formatted date. The same behavior is available by setting an If-Modified-Since header in your HTTP
|
|
request. Ex: http://server/api/statuses/friends.xml?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
|
|
*/
|
|
function friends($args, $apidata) {
|
|
parent::handle($args);
|
|
common_server_error("API method under construction.", $code=501);
|
|
}
|
|
|
|
/*
|
|
Returns the authenticating user's followers, each with current status inline. They are ordered by the
|
|
order in which they joined Twitter (this is going to be changed).
|
|
|
|
URL: http://server/api/statuses/followers.format
|
|
Formats: xml, json
|
|
|
|
Parameters:
|
|
|
|
* id. Optional. The ID or screen name of the user for whom to request a list of followers. Ex:
|
|
http://server/api/statuses/followers/12345.json
|
|
or
|
|
http://server/api/statuses/followers/bob.xml
|
|
* page. Optional. Retrieves the next 100 followers. Ex: http://server/api/statuses/followers.xml?page=2
|
|
* lite. Optional. Prevents the inline inclusion of current status. Must be set to a value of true.
|
|
Ex: http://server/api/statuses/followers.xml?lite=true
|
|
*/
|
|
function followers($args, $apidata) {
|
|
parent::handle($args);
|
|
common_server_error("API method under construction.", $code=501);
|
|
}
|
|
|
|
/*
|
|
Returns a list of the users currently featured on the site with their current statuses inline.
|
|
URL: http://server/api/statuses/featured.format
|
|
|
|
Formats: xml, json
|
|
*/
|
|
function featured($args, $apidata) {
|
|
parent::handle($args);
|
|
common_server_error("API method under construction.", $code=501);
|
|
}
|
|
|
|
function get_user($id, $apidata) {
|
|
if (!$id) {
|
|
return $apidata['user'];
|
|
} else if (is_numeric($id)) {
|
|
return User::staticGet($id);
|
|
} else {
|
|
return User::staticGet('nickname', $id);
|
|
}
|
|
}
|
|
}
|
|
|
|
|