3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Module\Api\Twitter\Statuses;
24 use Friendica\Core\Logger;
25 use Friendica\Database\DBA;
27 use Friendica\Model\Contact;
28 use Friendica\Model\Item;
29 use Friendica\Model\Post;
30 use Friendica\Module\BaseApi;
33 * Returns the most recent statuses posted by the user.
35 * @see https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-user_timeline
37 class UserTimeline extends BaseApi
39 protected function rawContent(array $request = [])
41 BaseApi::checkAllowedScope(BaseApi::SCOPE_READ);
42 $uid = BaseApi::getCurrentUserID();
44 Logger::info('api_statuses_user_timeline', ['api_user' => $uid, '_REQUEST' => $request]);
46 $cid = BaseApi::getContactIDForSearchterm($this->getRequestValue($request, 'screen_name', ''), $this->getRequestValue($request, 'profileurl', ''), $this->getRequestValue($request, 'user_id', 0), $uid);
47 $count = $this->getRequestValue($request, 'count', 20, 1, 100);
48 $page = $this->getRequestValue($request, 'page', 1, 1);
49 $since_id = $this->getRequestValue($request, 'since_id', 0, 0);
50 $max_id = $this->getRequestValue($request, 'max_id', 0, 0);
51 $exclude_replies = $this->getRequestValue($request, 'exclude_replies', false);
52 $conversation_id = $this->getRequestValue($request, 'conversation_id', 0, 0);
53 $include_entities = $this->getRequestValue($request, 'include_entities', false);
55 $start = max(0, ($page - 1) * $count);
57 $condition = ["(`uid` = ? OR (`uid` = ? AND NOT `global`)) AND `gravity` IN (?, ?) AND `uri-id` > ? AND `author-id` = ?",
58 0, $uid, Item::GRAVITY_PARENT, Item::GRAVITY_COMMENT, $since_id, $cid];
60 if ($exclude_replies) {
61 $condition[0] .= ' AND `gravity` = ?';
62 $condition[] = Item::GRAVITY_PARENT;
65 if ($conversation_id > 0) {
66 $condition[0] .= " AND `parent-uri-id` = ?";
67 $condition[] = $conversation_id;
71 $condition[0] .= " AND `uri-id` <= ?";
72 $condition[] = $max_id;
74 $params = ['order' => ['uri-id' => true], 'limit' => [$start, $count]];
75 $statuses = Post::selectForUser($uid, [], $condition, $params);
78 while ($status = DBA::fetch($statuses)) {
79 $ret[] = DI::twitterStatus()->createFromUriId($status['uri-id'], $status['uid'], $include_entities)->toArray();
81 DBA::close($statuses);
83 $this->response->exit('statuses', ['status' => $ret], $this->parameters['extension'] ?? null, Contact::getPublicIdByUserId($uid));