3 * @copyright Copyright (C) 2010-2023, 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/>.
20 * This is the POST destination for most all locally posted
21 * text stuff. This function handles status, wall-to-wall status,
22 * local comments, and remote comments that are posted on this site
23 * (as opposed to being delivered in a feed).
24 * Also processed here are posts and comments coming through the
25 * statusnet/twitter API.
27 * All of these become an "item" which is our basic unit of
32 use Friendica\Content\Conversation;
33 use Friendica\Content\Text\BBCode;
34 use Friendica\Core\Hook;
35 use Friendica\Core\Logger;
36 use Friendica\Core\Protocol;
37 use Friendica\Core\System;
38 use Friendica\Core\Worker;
39 use Friendica\Database\DBA;
41 use Friendica\Model\Contact;
42 use Friendica\Model\Item;
43 use Friendica\Model\ItemURI;
44 use Friendica\Model\Post;
45 use Friendica\Network\HTTPException;
46 use Friendica\Util\DateTimeFormat;
48 function item_post(App $a) {
49 $uid = DI::userSession()->getLocalUserId();
52 throw new HTTPException\ForbiddenException();
55 if (!empty($_REQUEST['dropitems'])) {
56 item_drop($uid, $_REQUEST['dropitems']);
59 Hook::callAll('post_local_start', $_REQUEST);
61 $return_path = $_REQUEST['return'] ?? '';
62 $preview = intval($_REQUEST['preview'] ?? 0);
65 * Check for doubly-submitted posts, and reject duplicates
66 * Note that we have to ignore previews, otherwise nothing will post
67 * after it's been previewed
69 if (!$preview && !empty($_REQUEST['post_id_random'])) {
70 if (DI::session()->get('post-random') == $_REQUEST['post_id_random']) {
71 Logger::warning('duplicate post');
72 item_post_return(DI::baseUrl(), $return_path);
74 DI::session()->set('post-random', $_REQUEST['post_id_random']);
78 if (empty($_REQUEST['post_id'])) {
79 item_insert($uid, $_REQUEST, $preview, $return_path);
81 item_edit($uid, $_REQUEST, $preview, $return_path);
85 function item_drop(int $uid, string $dropitems)
87 $arr_drop = explode(',', $dropitems);
88 foreach ($arr_drop as $item) {
89 Item::deleteForUser(['id' => $item], $uid);
92 System::jsonExit(['success' => 1]);
95 function item_edit(int $uid, array $request, bool $preview, string $return_path)
97 $post = Post::selectFirst(Item::ITEM_FIELDLIST, ['id' => $request['post_id'], 'uid' => $uid]);
98 if (!DBA::isResult($post)) {
100 DI::sysmsg()->addNotice(DI::l10n()->t('Unable to locate original post.'));
101 DI::baseUrl()->redirect($return_path);
103 throw new HTTPException\NotFoundException(DI::l10n()->t('Unable to locate original post.'));
106 $post['edit'] = $post;
107 $post['file'] = Post\Category::getTextByURIId($post['uri-id'], $post['uid']);
109 Post\Media::deleteByURIId($post['uri-id'], [Post\Media::AUDIO, Post\Media::VIDEO, Post\Media::IMAGE, Post\Media::HTML]);
110 $post = item_process($post, $request, $preview, $return_path);
113 'title' => $post['title'],
114 'body' => $post['body'],
115 'attach' => $post['attach'],
116 'file' => $post['file'],
117 'location' => $post['location'],
118 'coord' => $post['coord'],
119 'edited' => DateTimeFormat::utcNow(),
120 'changed' => DateTimeFormat::utcNow()
123 $fields['body'] = Item::setHashtags($fields['body']);
125 $quote_uri_id = Item::getQuoteUriId($fields['body'], $post['uid']);
126 if (!empty($quote_uri_id)) {
127 $fields['quote-uri-id'] = $quote_uri_id;
128 $fields['body'] = BBCode::removeSharedData($post['body']);
131 Item::update($fields, ['id' => $post['id']]);
132 Item::updateDisplayCache($post['uri-id']);
135 DI::baseUrl()->redirect($return_path);
138 throw new HTTPException\OKException(DI::l10n()->t('Post updated.'));
141 function item_insert(int $uid, array $request, bool $preview, string $return_path)
143 $post = ['uid' => $uid];
144 $post = DI::contentItem()->initializePost($post);
146 $post['edit'] = null;
147 $post['post-type'] = $request['post_type'] ?? '';
148 $post['wall'] = $request['wall'] ?? true;
149 $post['pubmail'] = $request['pubmail_enable'] ?? false;
150 $post['created'] = $request['created_at'] ?? DateTimeFormat::utcNow();
151 $post['edited'] = $post['changed'] = $post['commented'] = $post['created'];
153 $post['inform'] = '';
154 $post['postopts'] = '';
157 if (!empty($request['parent'])) {
158 $parent_item = Post::selectFirst(Item::ITEM_FIELDLIST, ['id' => $request['parent']]);
160 // if this isn't the top-level parent of the conversation, find it
161 if ($parent_item['gravity'] != Item::GRAVITY_PARENT) {
162 $toplevel_item = Post::selectFirst(Item::ITEM_FIELDLIST, ['id' => $parent_item['parent']]);
164 $toplevel_item = $parent_item;
168 if (empty($toplevel_item)) {
170 DI::sysmsg()->addNotice(DI::l10n()->t('Unable to locate original post.'));
171 DI::baseUrl()->redirect($return_path);
173 throw new HTTPException\NotFoundException(DI::l10n()->t('Unable to locate original post.'));
176 // When commenting on a public post then store the post for the current user
177 // This enables interaction like starring and saving into folders
178 if ($toplevel_item['uid'] == 0) {
179 $stored = Item::storeForUserByUriId($toplevel_item['uri-id'], $post['uid'], ['post-reason' => Item::PR_ACTIVITY]);
180 Logger::info('Public item stored for user', ['uri-id' => $toplevel_item['uri-id'], 'uid' => $post['uid'], 'stored' => $stored]);
183 $post['parent'] = $toplevel_item['id'];
184 $post['gravity'] = Item::GRAVITY_COMMENT;
185 $post['thr-parent'] = $parent_item['uri'];
186 $post['wall'] = $toplevel_item['wall'];
190 $post['gravity'] = Item::GRAVITY_PARENT;
191 $post['thr-parent'] = $post['uri'];
194 $post = DI::contentItem()->getACL($post, $parent_item, $request);
196 $post['pubmail'] = $post['pubmail'] && !$post['private'];
198 $post = item_process($post, $request, $preview, $return_path);
200 $post_id = Item::insert($post);
203 DI::sysmsg()->addNotice(DI::l10n()->t('Item wasn\'t stored.'));
204 DI::baseUrl()->redirect($return_path);
207 throw new HTTPException\InternalServerErrorException(DI::l10n()->t('Item wasn\'t stored.'));
210 $post = Post::selectFirst(Item::ITEM_FIELDLIST, ['id' => $post_id]);
212 Logger::error('Item couldn\'t be fetched.', ['post_id' => $post_id]);
214 DI::baseUrl()->redirect($return_path);
217 throw new HTTPException\InternalServerErrorException(DI::l10n()->t('Item couldn\'t be fetched.'));
220 $recipients = explode(',', $request['emailcc'] ?? '');
222 DI::contentItem()->postProcessPost($post, $recipients);
224 Logger::debug('post_complete');
226 item_post_return(DI::baseUrl(), $return_path);
230 function item_process(array $post, array $request, bool $preview, string $return_path): array
232 $post['self'] = true;
233 $post['api_source'] = false;
234 $post['attach'] = '';
235 $post['title'] = trim($request['title'] ?? '');
236 $post['body'] = $request['body'] ?? '';
237 $post['location'] = trim($request['location'] ?? '');
238 $post['coord'] = trim($request['coord'] ?? '');
240 $post = DI::contentItem()->addCategories($post, $request['category'] ?? '');
242 // Add the attachment to the body.
243 if (!empty($request['has_attachment'])) {
244 $post['body'] .= DI::contentItem()->storeAttachmentFromRequest($request);
247 $post = DI::contentItem()->finalizePost($post);
249 if (!strlen($post['body'])) {
251 System::jsonExit(['preview' => '']);
255 DI::sysmsg()->addNotice(DI::l10n()->t('Empty post discarded.'));
256 DI::baseUrl()->redirect($return_path);
259 throw new HTTPException\BadRequestException(DI::l10n()->t('Empty post discarded.'));
262 // preview mode - prepare the body for display and send it via json
264 // We have to preset some fields, so that the conversation can be displayed
266 $post['uri-id'] = -1;
267 $post['author-network'] = Protocol::DFRN;
268 $post['author-updated'] = '';
269 $post['author-gsid'] = 0;
270 $post['author-uri-id'] = ItemURI::getIdByURI($post['author-link']);
271 $post['owner-updated'] = '';
272 $post['has-media'] = false;
273 $post['quote-uri-id'] = Item::getQuoteUriId($post['body'], $post['uid']);
274 $post['body'] = BBCode::removeSharedData(Item::setHashtags($post['body']));
275 $post['writable'] = true;
277 $o = DI::conversation()->create([$post], Conversation::MODE_SEARCH, false, true);
279 System::jsonExit(['preview' => $o]);
282 Hook::callAll('post_local',$post);
284 unset($post['edit']);
285 unset($post['self']);
286 unset($post['api_source']);
288 if (!empty($request['scheduled_at'])) {
289 $scheduled_at = DateTimeFormat::convert($request['scheduled_at'], 'UTC', DI::app()->getTimeZone());
290 if ($scheduled_at > DateTimeFormat::utcNow()) {
291 unset($post['created']);
292 unset($post['edited']);
293 unset($post['commented']);
294 unset($post['received']);
295 unset($post['changed']);
297 Post\Delayed::add($post['uri'], $post, Worker::PRIORITY_HIGH, Post\Delayed::PREPARED_NO_HOOK, $scheduled_at);
298 item_post_return(DI::baseUrl(), $return_path);
302 if (!empty($post['cancel'])) {
303 Logger::info('mod_item: post cancelled by addon.');
305 DI::baseUrl()->redirect($return_path);
308 $json = ['cancel' => 1];
309 if (!empty($request['jsreload'])) {
310 $json['reload'] = DI::baseUrl() . '/' . $request['jsreload'];
313 System::jsonExit($json);
319 function item_post_return($baseurl, $return_path)
322 DI::baseUrl()->redirect($return_path);
325 $json = ['success' => 1];
326 if (!empty($_REQUEST['jsreload'])) {
327 $json['reload'] = $baseurl . '/' . $_REQUEST['jsreload'];
330 Logger::debug('post_json', ['json' => $json]);
332 System::jsonExit($json);
335 function item_content(App $a)
337 if (!DI::userSession()->isAuthenticated()) {
338 throw new HTTPException\UnauthorizedException();
343 if (!$args->has(3)) {
344 throw new HTTPException\BadRequestException();
348 switch ($args->get(1)) {
350 if (DI::mode()->isAjax()) {
351 Item::deleteForUser(['id' => $args->get(2)], DI::userSession()->getLocalUserId());
352 // ajax return: [<item id>, 0 (no perm) | <owner id>]
353 System::jsonExit([intval($args->get(2)), DI::userSession()->getLocalUserId()]);
355 if (!empty($args->get(3))) {
356 $o = drop_item($args->get(2), $args->get(3));
358 $o = drop_item($args->get(2));
364 $item = Post::selectFirstForUser(DI::userSession()->getLocalUserId(), ['guid', 'author-id', 'parent', 'gravity'], ['id' => $args->get(2)]);
365 if (empty($item['author-id'])) {
366 throw new HTTPException\NotFoundException('Item not found');
369 Contact\User::setBlocked($item['author-id'], DI::userSession()->getLocalUserId(), true);
371 if (DI::mode()->isAjax()) {
372 // ajax return: [<item id>, 0 (no perm) | <owner id>]
373 System::jsonExit([intval($args->get(2)), DI::userSession()->getLocalUserId()]);
375 item_redirect_after_action($item, $args->get(3));
380 $item = Post::selectFirstForUser(DI::userSession()->getLocalUserId(), ['guid', 'author-id', 'parent', 'gravity'], ['id' => $args->get(2)]);
381 if (empty($item['author-id'])) {
382 throw new HTTPException\NotFoundException('Item not found');
385 Contact\User::setIgnored($item['author-id'], DI::userSession()->getLocalUserId(), true);
387 if (DI::mode()->isAjax()) {
388 // ajax return: [<item id>, 0 (no perm) | <owner id>]
389 System::jsonExit([intval($args->get(2)), DI::userSession()->getLocalUserId()]);
391 item_redirect_after_action($item, $args->get(3));
401 * @param string $return
403 * @throws HTTPException\InternalServerErrorException
405 function drop_item(int $id, string $return = ''): string
407 // Locate item to be deleted
408 $item = Post::selectFirstForUser(DI::userSession()->getLocalUserId(), ['id', 'uid', 'guid', 'contact-id', 'deleted', 'gravity', 'parent'], ['id' => $id]);
410 if (!DBA::isResult($item)) {
411 DI::sysmsg()->addNotice(DI::l10n()->t('Item not found.'));
412 DI::baseUrl()->redirect('network');
416 if ($item['deleted']) {
422 // check if logged in user is either the author or owner of this item
423 if (DI::userSession()->getRemoteContactID($item['uid']) == $item['contact-id']) {
424 $contact_id = $item['contact-id'];
427 if ((DI::userSession()->getLocalUserId() == $item['uid']) || $contact_id) {
429 Item::deleteForUser(['id' => $item['id']], DI::userSession()->getLocalUserId());
431 item_redirect_after_action($item, $return);
434 Logger::warning('Permission denied.', ['local' => DI::userSession()->getLocalUserId(), 'uid' => $item['uid'], 'cid' => $contact_id]);
435 DI::sysmsg()->addNotice(DI::l10n()->t('Permission denied.'));
436 DI::baseUrl()->redirect('display/' . $item['guid']);
443 function item_redirect_after_action(array $item, string $returnUrlHex)
445 $return_url = hex2bin($returnUrlHex);
447 // removes update_* from return_url to ignore Ajax refresh
448 $return_url = str_replace('update_', '', $return_url);
450 // Check if delete a comment
451 if ($item['gravity'] == Item::GRAVITY_COMMENT) {
452 if (!empty($item['parent'])) {
453 $parentitem = Post::selectFirstForUser(DI::userSession()->getLocalUserId(), ['guid'], ['id' => $item['parent']]);
456 // Return to parent guid
457 if (!empty($parentitem)) {
458 DI::baseUrl()->redirect('display/' . $parentitem['guid']);
460 } // In case something goes wrong
462 DI::baseUrl()->redirect('network');
466 // if unknown location or deleting top level post called from display
467 if (empty($return_url) || strpos($return_url, 'display') !== false) {
468 DI::baseUrl()->redirect('network');
471 DI::baseUrl()->redirect($return_url);