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/>.
22 namespace Friendica\Content;
25 use Friendica\App\BaseURL;
26 use Friendica\Content\Text\BBCode;
27 use Friendica\Content\Text\BBCode\Video;
28 use Friendica\Content\Text\HTML;
29 use Friendica\Core\Hook;
30 use Friendica\Core\L10n;
31 use Friendica\Core\Logger;
32 use Friendica\Core\PConfig\Capability\IManagePersonalConfigValues;
33 use Friendica\Core\Protocol;
34 use Friendica\Core\Session\Capability\IHandleUserSessions;
35 use Friendica\Core\System;
36 use Friendica\Database\DBA;
38 use Friendica\Model\Attach;
39 use Friendica\Model\Circle;
40 use Friendica\Model\Contact;
41 use Friendica\Model\Conversation;
42 use Friendica\Model\FileTag;
43 use Friendica\Model\Item as ItemModel;
44 use Friendica\Model\Photo;
45 use Friendica\Model\Post;
46 use Friendica\Model\Tag;
47 use Friendica\Model\User;
48 use Friendica\Network\HTTPException;
49 use Friendica\Object\EMail\ItemCCEMail;
50 use Friendica\Protocol\Activity;
51 use Friendica\Util\ACLFormatter;
52 use Friendica\Util\DateTimeFormat;
53 use Friendica\Util\Emailer;
54 use Friendica\Util\ParseUrl;
55 use Friendica\Util\Profiler;
56 use Friendica\Util\Proxy;
57 use Friendica\Util\XML;
58 use GuzzleHttp\Psr7\Uri;
61 * A content helper class for displaying items
71 /** @var IHandleUserSessions */
75 /** @var ACLFormatter */
76 private $aclFormatter;
77 /** @var IManagePersonalConfigValues */
86 public function __construct(Profiler $profiler, Activity $activity, L10n $l10n, IHandleUserSessions $userSession, Video $bbCodeVideo, ACLFormatter $aclFormatter, IManagePersonalConfigValues $pConfig, BaseURL $baseURL, Emailer $emailer, App $app)
88 $this->profiler = $profiler;
89 $this->activity = $activity;
91 $this->userSession = $userSession;
92 $this->bbCodeVideo = $bbCodeVideo;
93 $this->aclFormatter = $aclFormatter;
94 $this->baseURL = $baseURL;
95 $this->pConfig = $pConfig;
96 $this->emailer = $emailer;
101 * Lists categories and folders for an item
107 * [ // categories array
109 * 'name': 'category name',
110 * 'removeurl': 'url to remove this category',
111 * 'first': 'is the first in this array? true/false',
112 * 'last': 'is the last in this array? true/false',
118 * 'name': 'folder name',
119 * 'removeurl': 'url to remove this folder',
120 * 'first': 'is the first in this array? true/false',
121 * 'last': 'is the last in this array? true/false',
129 public function determineCategoriesTerms(array $item, int $uid = 0): array
135 $uid = $item['uid'] ?: $uid;
137 if (empty($item['has-categories'])) {
138 return [$categories, $folders];
141 foreach (Post\Category::getArrayByURIId($item['uri-id'], $uid) as $savedFolderName) {
142 if (!empty($item['author-link'])) {
143 $url = $item['author-link'] . '/conversations?category=' . rawurlencode($savedFolderName);
148 'name' => $savedFolderName,
150 'removeurl' => $this->userSession->getLocalUserId() == $uid ? 'filerm/' . $item['id'] . '?cat=' . rawurlencode($savedFolderName) : '',
157 if (count($categories)) {
158 $categories[count($categories) - 1]['last'] = true;
161 if ($this->userSession->getLocalUserId() == $uid) {
162 foreach (Post\Category::getArrayByURIId($item['uri-id'], $uid, Post\Category::FILE) as $savedFolderName) {
164 'name' => $savedFolderName,
166 'removeurl' => $this->userSession->getLocalUserId() == $uid ? 'filerm/' . $item['id'] . '?term=' . rawurlencode($savedFolderName) : '',
174 if (count($folders)) {
175 $folders[count($folders) - 1]['last'] = true;
178 return [$categories, $folders];
182 * This function removes the tag $tag from the text $body and replaces it with
183 * the appropriate link.
185 * @param string $body the text to replace the tag in
186 * @param int $profile_uid the user id to replace the tag for (0 = anyone)
187 * @param string $tag the tag to replace
188 * @param string $network The network of the post
190 * @return array|bool ['replaced' => $replaced, 'contact' => $contact] or "false" on if already replaced
191 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
192 * @throws \ImagickException
194 public static function replaceTag(string &$body, int $profile_uid, string $tag, string $network = '')
198 //is it a person tag?
199 if (Tag::isType($tag, Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION)) {
200 $tag_type = substr($tag, 0, 1);
201 //is it already replaced?
202 if (strpos($tag, '[url=')) {
206 //get the person's name
207 $name = substr($tag, 1);
209 // Sometimes the tag detection doesn't seem to work right
210 // This is some workaround
211 $nameparts = explode(' ', $name);
212 $name = $nameparts[0];
214 // Try to detect the contact in various ways
215 if (strpos($name, 'http://') || strpos($name, '@')) {
216 $contact = Contact::getByURLForUser($name, $profile_uid);
219 $fields = ['id', 'url', 'nick', 'name', 'alias', 'network', 'forum', 'prv'];
221 if (strrpos($name, '+')) {
222 // Is it in format @nick+number?
223 $tagcid = intval(substr($name, strrpos($name, '+') + 1));
224 $contact = DBA::selectFirst('contact', $fields, ['id' => $tagcid, 'uid' => $profile_uid]);
227 // select someone by nick in the current network
228 if (!DBA::isResult($contact) && ($network != '')) {
229 $condition = ['nick' => $name, 'network' => $network, 'uid' => $profile_uid];
230 $contact = DBA::selectFirst('contact', $fields, $condition);
233 // select someone by attag in the current network
234 if (!DBA::isResult($contact) && ($network != '')) {
235 $condition = ['attag' => $name, 'network' => $network, 'uid' => $profile_uid];
236 $contact = DBA::selectFirst('contact', $fields, $condition);
239 //select someone by name in the current network
240 if (!DBA::isResult($contact) && ($network != '')) {
241 $condition = ['name' => $name, 'network' => $network, 'uid' => $profile_uid];
242 $contact = DBA::selectFirst('contact', $fields, $condition);
245 // select someone by nick in any network
246 if (!DBA::isResult($contact)) {
247 $condition = ['nick' => $name, 'uid' => $profile_uid];
248 $contact = DBA::selectFirst('contact', $fields, $condition);
251 // select someone by attag in any network
252 if (!DBA::isResult($contact)) {
253 $condition = ['attag' => $name, 'uid' => $profile_uid];
254 $contact = DBA::selectFirst('contact', $fields, $condition);
257 // select someone by name in any network
258 if (!DBA::isResult($contact)) {
259 $condition = ['name' => $name, 'uid' => $profile_uid];
260 $contact = DBA::selectFirst('contact', $fields, $condition);
264 // Check if $contact has been successfully loaded
265 if (DBA::isResult($contact)) {
266 $profile = $contact['url'];
267 $newname = ($contact['name'] ?? '') ?: $contact['nick'];
270 //if there is an url for this persons profile
271 if (isset($profile) && ($newname != '')) {
273 // create profile link
274 $profile = str_replace(',', '%2c', $profile);
275 $newtag = $tag_type . '[url=' . $profile . ']' . $newname . '[/url]';
276 $body = str_replace($tag_type . $name, $newtag, $body);
280 return ['replaced' => $replaced, 'contact' => $contact];
284 * Render actions localized
288 * @throws ImagickException
289 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
291 public function localize(array &$item)
293 $this->profiler->startRecording('rendering');
294 /// @todo The following functionality needs to be cleaned up.
295 if (!empty($item['verb'])) {
296 $xmlhead = '<?xml version="1.0" encoding="UTF-8" ?>';
298 if ($this->activity->match($item['verb'], Activity::TAG)) {
300 'author-id', 'author-link', 'author-name', 'author-network', 'author-link', 'author-alias',
301 'verb', 'object-type', 'resource-id', 'body', 'plink'
303 $obj = Post::selectFirst($fields, ['uri' => $item['parent-uri']]);
304 if (!DBA::isResult($obj)) {
305 $this->profiler->stopRecording();
311 'id' => $item['author-id'],
312 'network' => $item['author-network'],
313 'url' => $item['author-link'],
314 'alias' => $item['author-alias'],
316 $author = '[url=' . Contact::magicLinkByContact($author_arr) . ']' . $item['author-name'] . '[/url]';
320 'id' => $obj['author-id'],
321 'network' => $obj['author-network'],
322 'url' => $obj['author-link'],
323 'alias' => $obj['author-alias'],
325 $objauthor = '[url=' . Contact::magicLinkByContact($author_arr) . ']' . $obj['author-name'] . '[/url]';
327 switch ($obj['verb']) {
329 switch ($obj['object-type']) {
330 case Activity\ObjectType::EVENT:
331 $post_type = $this->l10n->t('event');
334 $post_type = $this->l10n->t('status');
339 if ($obj['resource-id']) {
340 $post_type = $this->l10n->t('photo');
341 preg_match("/\[url=([^]]*)\]/", $obj['body'], $matches);
342 $rr['plink'] = $matches[1];
344 $post_type = $this->l10n->t('status');
346 // Let's break everything ... ;-)
349 $plink = '[url=' . $obj['plink'] . ']' . $post_type . '[/url]';
351 $parsedobj = XML::parseString($xmlhead . $item['object']);
353 $tag = sprintf('#[url=%s]%s[/url]', $parsedobj->id, $parsedobj->content);
354 $item['body'] = $this->l10n->t('%1$s tagged %2$s\'s %3$s with %4$s', $author, $objauthor, $plink, $tag);
358 $this->profiler->stopRecording();
362 * Renders photo menu based on item
365 * @param string $formSecurityToken
368 public function photoMenu(array $item, string $formSecurityToken): string
370 $this->profiler->startRecording('rendering');
371 $sub_link = $contact_url = $pm_url = $status_link = '';
372 $photos_link = $posts_link = $block_link = $ignore_link = $collapse_link = $ignoreserver_link = '';
374 if ($this->userSession->getLocalUserId() && $this->userSession->getLocalUserId() == $item['uid'] && $item['gravity'] == ItemModel::GRAVITY_PARENT && !$item['self'] && !$item['mention']) {
375 $sub_link = 'javascript:doFollowThread(' . $item['id'] . '); return false;';
380 'id' => $item['author-id'],
381 'network' => $item['author-network'],
382 'url' => $item['author-link'],
383 'alias' => $item['author-alias'],
385 $profile_link = Contact::magicLinkByContact($author, $item['author-link']);
386 if (strpos($profile_link, 'contact/redir/') === 0) {
387 $status_link = $profile_link . '?' . http_build_query(['url' => $item['author-link'] . '/status']);
388 $photos_link = $profile_link . '?' . http_build_query(['url' => $item['author-link'] . '/photos']);
389 $profile_link = $profile_link . '?' . http_build_query(['url' => $item['author-link'] . '/profile']);
393 $pcid = $item['author-id'];
396 $condition = ['uid' => $this->userSession->getLocalUserId(), 'uri-id' => $item['author-uri-id']];
397 $contact = DBA::selectFirst('contact', ['id', 'network', 'rel'], $condition);
398 if (DBA::isResult($contact)) {
399 $cid = $contact['id'];
400 $network = $contact['network'];
401 $rel = $contact['rel'];
405 $contact_url = 'contact/' . $pcid;
406 $posts_link = $contact_url . '/posts';
407 $block_link = $item['self'] ? '' : $contact_url . '/block?t=' . $formSecurityToken;
408 $ignore_link = $item['self'] ? '' : $contact_url . '/ignore?t=' . $formSecurityToken;
409 $collapse_link = $item['self'] ? '' : $contact_url . '/collapse?t=' . $formSecurityToken;
412 $authorBaseUri = new Uri($item['author-baseurl'] ?? '');
413 if (!empty($item['author-gsid']) && $authorBaseUri->getHost() && !DI::baseUrl()->isLocalUrl($authorBaseUri)) {
414 $ignoreserver_link = 'settings/server/' . $item['author-gsid'] . '/ignore';
417 if ($cid && !$item['self']) {
418 $contact_url = 'contact/' . $cid;
419 $posts_link = $contact_url . '/posts';
421 if (in_array($network, [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::DIASPORA])) {
422 $pm_url = 'message/new/' . $cid;
426 if ($this->userSession->getLocalUserId()) {
428 $this->l10n->t('Follow Thread') => $sub_link,
429 $this->l10n->t('View Status') => $status_link,
430 $this->l10n->t('View Profile') => $profile_link,
431 $this->l10n->t('View Photos') => $photos_link,
432 $this->l10n->t('Network Posts') => $posts_link,
433 $this->l10n->t('View Contact') => $contact_url,
434 $this->l10n->t('Send PM') => $pm_url,
435 $this->l10n->t('Block') => $block_link,
436 $this->l10n->t('Ignore') => $ignore_link,
437 $this->l10n->t('Collapse') => $collapse_link,
438 $this->l10n->t("Ignore %s server", $authorBaseUri->getHost()) => $ignoreserver_link,
441 if (!empty($item['language'])) {
442 $menu[$this->l10n->t('Languages')] = 'javascript:alert(\'' . ItemModel::getLanguageMessage($item) . '\');';
445 if ((($cid == 0) || ($rel == Contact::FOLLOWER)) &&
446 in_array($item['network'], Protocol::FEDERATED)
448 $menu[$this->l10n->t('Connect/Follow')] = 'contact/follow?url=' . urlencode($item['author-link']) . '&auto=1';
451 $menu = [$this->l10n->t('View Profile') => $item['author-link']];
454 $args = ['item' => $item, 'menu' => $menu];
456 Hook::callAll('item_photo_menu', $args);
458 $menu = $args['menu'];
461 foreach ($menu as $k => $v) {
462 if (strpos($v, 'javascript:') === 0) {
464 $o .= '<li role="menuitem"><a onclick="' . $v . '">' . $k . '</a></li>' . PHP_EOL;
466 $o .= '<li role="menuitem"><a href="' . $v . '">' . $k . '</a></li>' . PHP_EOL;
469 $this->profiler->stopRecording();
474 * Checks if the activity is visible to current user
476 * @param array $item Activity item
477 * @return bool Whether the item is visible to the user
479 public function isVisibleActivity(array $item): bool
481 // Empty verb or hidden?
482 if (empty($item['verb']) || $this->activity->isHidden($item['verb'])) {
487 return (!($this->activity->match($item['verb'], Activity::FOLLOW) &&
488 $item['object-type'] === Activity\ObjectType::NOTE &&
489 empty($item['self']) &&
490 $item['uid'] == $this->userSession->getLocalUserId())
494 public function expandTags(array $item, bool $setPermissions = false): array
496 // Look for any tags and linkify them
497 $item['inform'] = '';
498 $private_group = false;
500 $only_to_group = false;
504 // Convert mentions in the body to a unified format
505 $item['body'] = BBCode::setMentions($item['body'], $item['uid'], $item['network']);
507 // Search for group mentions
508 foreach (Tag::getFromBody($item['body'], Tag::TAG_CHARACTER[Tag::MENTION] . Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION]) as $tag) {
509 $contact = Contact::getByURLForUser($tag[2], $item['uid']);
510 if (empty($contact)) {
514 $receivers[] = $contact['id'];
516 if (!empty($item['inform'])) {
517 $item['inform'] .= ',';
519 $item['inform'] .= 'cid:' . $contact['id'];
521 if (($item['gravity'] == ItemModel::GRAVITY_COMMENT) || empty($contact['cid']) || ($contact['contact-type'] != Contact::TYPE_COMMUNITY)) {
525 if (!empty($contact['prv']) || ($tag[1] == Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION])) {
526 $private_group = $contact['prv'];
527 $only_to_group = ($tag[1] == Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION]);
528 $private_id = $contact['id'];
529 $group_contact = $contact;
530 Logger::info('Private group or exclusive mention', ['url' => $tag[2], 'mention' => $tag[1]]);
531 } elseif ($item['allow_cid'] == '<' . $contact['id'] . '>') {
532 $private_group = false;
533 $only_to_group = true;
534 $private_id = $contact['id'];
535 $group_contact = $contact;
536 Logger::info('Public group', ['url' => $tag[2], 'mention' => $tag[1]]);
538 Logger::info('Post with group mention will not be converted to a group post', ['url' => $tag[2], 'mention' => $tag[1]]);
541 Logger::info('Got inform', ['inform' => $item['inform']]);
543 if (($item['gravity'] == ItemModel::GRAVITY_PARENT) && !empty($group_contact) && ($private_group || $only_to_group)) {
544 // we tagged a group in a top level post. Now we change the post
545 $item['private'] = $private_group ? ItemModel::PRIVATE : ItemModel::UNLISTED;
547 if ($only_to_group) {
548 $cdata = Contact::getPublicAndUserContactID($group_contact['id'], $item['uid']);
549 if (!empty($cdata['user'])) {
550 $item['owner-id'] = $cdata['user'];
551 unset($item['owner-link']);
552 unset($item['owner-name']);
553 unset($item['owner-avatar']);
556 $item['postopts'] = '';
559 $item['deny_cid'] = '';
560 $item['deny_gid'] = '';
562 if ($private_group) {
563 $item['allow_cid'] = '<' . $private_id . '>';
564 $item['allow_gid'] = '<' . Circle::getIdForGroup($group_contact['id']) . '>';
566 $item['allow_cid'] = '';
567 $item['allow_gid'] = '';
569 } elseif ($setPermissions) {
570 if (empty($receivers)) {
571 // For security reasons direct posts without any receiver will be posts to yourself
572 $self = Contact::selectFirst(['id'], ['uid' => $item['uid'], 'self' => true]);
573 $receivers[] = $self['id'];
576 $item['private'] = ItemModel::PRIVATE;
577 $item['allow_cid'] = '';
578 $item['allow_gid'] = '';
579 $item['deny_cid'] = '';
580 $item['deny_gid'] = '';
582 foreach ($receivers as $receiver) {
583 $item['allow_cid'] .= '<' . $receiver . '>';
589 public function getAuthorAvatar(array $item): string
591 if (in_array($item['network'], [Protocol::FEED, Protocol::MAIL])) {
592 $author_avatar = $item['contact-id'];
593 $author_updated = '';
594 $author_thumb = $item['contact-avatar'];
596 $author_avatar = $item['author-id'];
597 $author_updated = $item['author-updated'];
598 $author_thumb = $item['author-avatar'];
602 if (empty($author_thumb) || Photo::isPhotoURI($author_thumb)) {
603 $author_thumb = Contact::getAvatarUrlForId($author_avatar, Proxy::SIZE_THUMB, $author_updated);
606 return $author_thumb;
609 public function getOwnerAvatar(array $item): string
611 if (in_array($item['network'], [Protocol::FEED, Protocol::MAIL])) {
612 $owner_avatar = $item['contact-id'];
614 $owner_thumb = $item['contact-avatar'];
616 $owner_avatar = $item['owner-id'];
617 $owner_updated = $item['owner-updated'];
618 $owner_thumb = $item['owner-avatar'];
621 if (empty($owner_thumb) || Photo::isPhotoURI($owner_thumb)) {
622 $owner_thumb = Contact::getAvatarUrlForId($owner_avatar, Proxy::SIZE_THUMB, $owner_updated);
629 * Add a share block for the given uri-id
632 * @param string $body
635 public function addSharedPost(array $item, string $body = ''): string
638 $body = $item['body'];
641 if (empty($item['quote-uri-id']) || ($item['quote-uri-id'] == $item['uri-id'])) {
645 $fields = ['uri-id', 'uri', 'body', 'title', 'author-name', 'author-link', 'author-avatar', 'guid', 'created', 'plink', 'network', 'quote-uri-id'];
646 $shared_item = Post::selectFirst($fields, ['uri-id' => $item['quote-uri-id'], 'uid' => [$item['uid'], 0], 'private' => [ItemModel::PUBLIC, ItemModel::UNLISTED]]);
647 if (!DBA::isResult($shared_item)) {
648 Logger::notice('Post does not exist.', ['uri-id' => $item['quote-uri-id'], 'uid' => $item['uid']]);
652 return trim(BBCode::removeSharedData($body) . "\n" . $this->createSharedBlockByArray($shared_item, true));
656 * Add a share block for the given guid
658 * @param string $guid
659 * @param integer $uid
660 * @param bool $add_media
663 private function createSharedPostByGuid(string $guid, bool $add_media): string
665 $fields = ['uri-id', 'uri', 'body', 'title', 'author-name', 'author-link', 'author-avatar', 'guid', 'created', 'plink', 'network'];
666 $shared_item = Post::selectFirst($fields, ['guid' => $guid, 'uid' => 0, 'private' => [ItemModel::PUBLIC, ItemModel::UNLISTED]]);
668 if (!DBA::isResult($shared_item)) {
669 Logger::notice('Post does not exist.', ['guid' => $guid]);
673 return $this->createSharedBlockByArray($shared_item, $add_media);
677 * Add a share block for the given item array
680 * @param bool $add_media true = Media is added to the body
681 * @param bool $for_display true = The share block is used for display purposes, false = used for connectors, transport to other systems, ...
684 public function createSharedBlockByArray(array $item, bool $add_media = false, bool $for_display = false): string
686 if ($item['network'] == Protocol::FEED) {
687 return PageInfo::getFooterFromUrl($item['plink']);
688 } elseif (!in_array($item['network'] ?? '', Protocol::FEDERATED) && !$for_display) {
694 $item['body'] = Post\Media::addAttachmentsToBody($item['uri-id'], $item['body']);
697 $shared_content = BBCode::getShareOpeningTag($item['author-name'], $item['author-link'], $item['author-avatar'], $item['plink'], $item['created'], $item['guid'], $item['uri']);
699 if (!empty($item['title'])) {
700 $shared_content .= '[h3]' . $item['title'] . "[/h3]\n";
703 $shared = $this->getShareArray($item);
705 // If it is a reshared post then reformat it to avoid display problems with two share elements
706 if (!empty($shared)) {
707 if (($item['network'] != Protocol::BLUESKY) && !empty($shared['guid']) && ($encapsulated_share = $this->createSharedPostByGuid($shared['guid'], true))) {
708 if (!empty(BBCode::fetchShareAttributes($item['body']))) {
709 $item['body'] = preg_replace("/\[share.*?\](.*)\[\/share\]/ism", $encapsulated_share, $item['body']);
711 $item['body'] .= $encapsulated_share;
714 $item['body'] = HTML::toBBCode(BBCode::convertForUriId($item['uri-id'], $item['body'], BBCode::ACTIVITYPUB));
717 $shared_content .= $item['body'] . '[/share]';
719 return $shared_content;
723 * Return the shared post from an item array (if the item is shared item)
726 * @param array $fields
728 * @return array with the shared post
730 public function getSharedPost(array $item, array $fields = []): array
732 if (!empty($item['quote-uri-id']) && ($item['quote-uri-id'] != $item['uri-id'])) {
733 $shared = Post::selectFirst($fields, ['uri-id' => $item['quote-uri-id'], 'uid' => [0, $item['uid'] ?? 0]]);
734 if (is_array($shared)) {
736 'comment' => BBCode::removeSharedData($item['body'] ?? ''),
742 $attributes = BBCode::fetchShareAttributes($item['body'] ?? '');
743 if (!empty($attributes)) {
744 $shared = Post::selectFirst($fields, ['guid' => $attributes['guid'], 'uid' => [0, $item['uid'] ?? 0]]);
745 if (is_array($shared)) {
747 'comment' => $attributes['comment'],
757 * Return share data from an item array (if the item is shared item)
758 * We are providing the complete Item array, because at some time in the future
759 * we hopefully will define these values not in the body anymore but in some item fields.
760 * This function is meant to replace all similar functions in the system.
764 * @return array with share information
766 private function getShareArray(array $item): array
768 $attributes = BBCode::fetchShareAttributes($item['body'] ?? '');
769 if (!empty($attributes)) {
773 if (!empty($item['quote-uri-id']) && ($item['quote-uri-id'] != $item['uri-id'])) {
774 $shared = Post::selectFirst(['author-name', 'author-link', 'author-avatar', 'plink', 'created', 'guid', 'uri', 'body'], ['uri-id' => $item['quote-uri-id']]);
775 if (!empty($shared)) {
777 'author' => $shared['author-name'],
778 'profile' => $shared['author-link'],
779 'avatar' => $shared['author-avatar'],
780 'link' => $shared['plink'],
781 'posted' => $shared['created'],
782 'guid' => $shared['guid'],
783 'message_id' => $shared['uri'],
784 'comment' => $item['body'],
785 'shared' => $shared['body'],
794 * Add a link to a shared post at the end of the post
796 * @param string $body
797 * @param integer $quote_uri_id
800 public function addShareLink(string $body, int $quote_uri_id): string
802 $post = Post::selectFirstPost(['uri', 'plink'], ['uri-id' => $quote_uri_id]);
807 $body = BBCode::removeSharedData($body);
809 $body .= "\n♲ " . ($post['plink'] ?: $post['uri']);
814 public function storeAttachmentFromRequest(array $request): string
816 $attachment_type = $request['attachment_type'] ?? '';
817 $attachment_title = $request['attachment_title'] ?? '';
818 $attachment_text = $request['attachment_text'] ?? '';
820 $attachment_url = hex2bin($request['attachment_url'] ?? '');
821 $attachment_img_src = hex2bin($request['attachment_img_src'] ?? '');
823 $attachment_img_width = $request['attachment_img_width'] ?? 0;
824 $attachment_img_height = $request['attachment_img_height'] ?? 0;
826 // Fetch the basic attachment data
827 $attachment = ParseUrl::getSiteinfoCached($attachment_url);
828 unset($attachment['keywords']);
830 // Overwrite the basic data with possible changes from the frontend
831 $attachment['type'] = $attachment_type;
832 $attachment['title'] = $attachment_title;
833 $attachment['text'] = $attachment_text;
834 $attachment['url'] = $attachment_url;
836 if (!empty($attachment_img_src)) {
837 $attachment['images'] = [
839 'src' => $attachment_img_src,
840 'width' => $attachment_img_width,
841 'height' => $attachment_img_height
845 unset($attachment['images']);
848 return "\n" . PageInfo::getFooterFromData($attachment);
851 public function addCategories(array $post, string $category): array
853 if (!empty($post['file'])) {
854 // get the "fileas" tags for this post
855 $filedas = FileTag::fileToArray($post['file']);
858 $list_array = explode(',', trim($category));
859 $post['file'] = FileTag::arrayToFile($list_array, 'category');
861 if (!empty($filedas) && is_array($filedas)) {
862 // append the fileas stuff to the new categories list
863 $post['file'] .= FileTag::arrayToFile($filedas);
868 public function getACL(array $post, array $toplevel_item, array $request): array
870 // If this is a comment, set the permissions from the parent.
871 if ($toplevel_item) {
872 $post['allow_cid'] = $toplevel_item['allow_cid'] ?? '';
873 $post['allow_gid'] = $toplevel_item['allow_gid'] ?? '';
874 $post['deny_cid'] = $toplevel_item['deny_cid'] ?? '';
875 $post['deny_gid'] = $toplevel_item['deny_gid'] ?? '';
876 $post['private'] = $toplevel_item['private'];
880 $user = User::getById($post['uid'], ['allow_cid', 'allow_gid', 'deny_cid', 'deny_gid']);
882 throw new HTTPException\NotFoundException($this->l10n->t('Unable to fetch user.'));
885 $post['allow_cid'] = isset($request['contact_allow']) ? $this->aclFormatter->toString($request['contact_allow']) : $user['allow_cid'] ?? '';
886 $post['allow_gid'] = isset($request['circle_allow']) ? $this->aclFormatter->toString($request['circle_allow']) : $user['allow_gid'] ?? '';
887 $post['deny_cid'] = isset($request['contact_deny']) ? $this->aclFormatter->toString($request['contact_deny']) : $user['deny_cid'] ?? '';
888 $post['deny_gid'] = isset($request['circle_deny']) ? $this->aclFormatter->toString($request['circle_deny']) : $user['deny_gid'] ?? '';
890 $visibility = $request['visibility'] ?? '';
891 if ($visibility === 'public') {
892 // The ACL selector introduced in version 2019.12 sends ACL input data even when the Public visibility is selected
893 $post['allow_cid'] = $post['allow_gid'] = $post['deny_cid'] = $post['deny_gid'] = '';
894 } else if ($visibility === 'custom') {
895 // Since we know from the visibility parameter the item should be private, we have to prevent the empty ACL
896 // case that would make it public. So we always append the author's contact id to the allowed contacts.
897 // See https://github.com/friendica/friendica/issues/9672
898 $post['allow_cid'] .= $this->aclFormatter->toString(Contact::getPublicIdByUserId($post['uid']));
901 if ($post['allow_gid'] || $post['allow_cid'] || $post['deny_gid'] || $post['deny_cid']) {
902 $post['private'] = ItemModel::PRIVATE;
903 } elseif ($this->pConfig->get($post['uid'], 'system', 'unlisted')) {
904 $post['private'] = ItemModel::UNLISTED;
906 $post['private'] = ItemModel::PUBLIC;
912 public function moveAttachmentsFromBodyToAttach(array $post): array
914 if (!preg_match_all('/(\[attachment\]([0-9]+)\[\/attachment\])/', $post['body'], $match)) {
918 foreach ($match[2] as $attachment_id) {
919 $attachment = Attach::selectFirst(['id', 'uid', 'filename', 'filesize', 'filetype'], ['id' => $attachment_id, 'uid' => $post['uid']]);
920 if (empty($attachment)) {
923 if ($post['attach']) {
924 $post['attach'] .= ',';
926 $post['attach'] .= Post\Media::getAttachElement(
927 $this->baseURL . '/attach/' . $attachment['id'],
928 $attachment['filesize'],
929 $attachment['filetype'],
930 $attachment['filename'] ?? ''
934 'allow_cid' => $post['allow_cid'], 'allow_gid' => $post['allow_gid'],
935 'deny_cid' => $post['deny_cid'], 'deny_gid' => $post['deny_gid']
937 $condition = ['id' => $attachment_id];
938 Attach::update($fields, $condition);
941 $post['body'] = str_replace($match[1], '', $post['body']);
946 private function setObjectType(array $post): array
948 if (empty($post['post-type'])) {
949 $post['post-type'] = empty($post['title']) ? ItemModel::PT_NOTE : ItemModel::PT_ARTICLE;
952 // embedded bookmark or attachment in post? set bookmark flag
953 $data = BBCode::getAttachmentData($post['body']);
954 if ((preg_match_all("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", $post['body'], $match, PREG_SET_ORDER) || !empty($data['type']))
955 && ($post['post-type'] != ItemModel::PT_PERSONAL_NOTE)
957 $post['post-type'] = ItemModel::PT_PAGE;
958 $post['object-type'] = Activity\ObjectType::BOOKMARK;
961 // Setting the object type if not defined before
962 if (empty($post['object-type'])) {
963 $post['object-type'] = ($post['gravity'] == ItemModel::GRAVITY_PARENT) ? Activity\ObjectType::NOTE : Activity\ObjectType::COMMENT;
968 public function initializePost(array $post): array
970 $post['network'] = Protocol::DFRN;
971 $post['protocol'] = Conversation::PARCEL_DIRECT;
972 $post['direction'] = Conversation::PUSH;
973 $post['received'] = DateTimeFormat::utcNow();
974 $post['origin'] = true;
975 $post['wall'] = $post['wall'] ?? true;
976 $post['guid'] = $post['guid'] ?? System::createUUID();
977 $post['verb'] = $post['verb'] ?? Activity::POST;
978 $post['uri'] = $post['uri'] ?? ItemModel::newURI($post['guid']);
979 $post['thr-parent'] = $post['thr-parent'] ?? $post['uri'];
981 if (empty($post['gravity'])) {
982 $post['gravity'] = ($post['uri'] == $post['thr-parent']) ? ItemModel::GRAVITY_PARENT : ItemModel::GRAVITY_COMMENT;
985 $owner = User::getOwnerDataById($post['uid']);
987 if (!isset($post['allow_cid']) || !isset($post['allow_gid']) || !isset($post['deny_cid']) || !isset($post['deny_gid'])) {
988 $post['allow_cid'] = $owner['allow_cid'];
989 $post['allow_gid'] = $owner['allow_gid'];
990 $post['deny_cid'] = $owner['deny_cid'];
991 $post['deny_gid'] = $owner['deny_gid'];
994 if ($post['allow_gid'] || $post['allow_cid'] || $post['deny_gid'] || $post['deny_cid']) {
995 $post['private'] = ItemModel::PRIVATE;
996 } elseif ($this->pConfig->get($post['uid'], 'system', 'unlisted')) {
997 $post['private'] = ItemModel::UNLISTED;
999 $post['private'] = ItemModel::PUBLIC;
1002 if (empty($post['contact-id'])) {
1003 $post['contact-id'] = $owner['id'];
1006 if (empty($post['author-link']) && empty($post['author-id'])) {
1007 $post['author-link'] = $owner['url'];
1008 $post['author-id'] = Contact::getIdForURL($post['author-link']);
1009 $post['author-name'] = $owner['name'];
1010 $post['author-avatar'] = $owner['thumb'];
1013 if (empty($post['owner-link']) && empty($post['owner-id'])) {
1014 $post['owner-link'] = $post['author-link'];
1015 $post['owner-id'] = Contact::getIdForURL($post['owner-link']);
1016 $post['owner-name'] = $post['author-name'];
1017 $post['owner-avatar'] = $post['author-avatar'];
1023 public function finalizePost(array $post): array
1025 if (preg_match("/\[attachment\](.*?)\[\/attachment\]/ism", $post['body'], $matches)) {
1026 $post['body'] = preg_replace("/\[attachment].*?\[\/attachment\]/ism", PageInfo::getFooterFromUrl($matches[1]), $post['body']);
1029 // Convert links with empty descriptions to links without an explicit description
1030 $post['body'] = trim(preg_replace('#\[url=([^\]]*?)\]\[/url\]#ism', '[url]$1[/url]', $post['body']));
1031 $post['body'] = $this->bbCodeVideo->transform($post['body']);
1032 $post = $this->setObjectType($post);
1034 // Personal notes must never be altered to a group post.
1035 if ($post['post-type'] != ItemModel::PT_PERSONAL_NOTE) {
1036 // Look for any tags and linkify them
1037 $post = $this->expandTags($post);
1043 public function postProcessPost(array $post, array $recipients = [])
1045 if (!\Friendica\Content\Feature::isEnabled($post['uid'], 'explicit_mentions') && ($post['gravity'] == ItemModel::GRAVITY_COMMENT)) {
1046 Tag::createImplicitMentions($post['uri-id'], $post['thr-parent-id']);
1049 Hook::callAll('post_local_end', $post);
1051 $author = DBA::selectFirst('contact', ['thumb'], ['uid' => $post['uid'], 'self' => true]);
1053 foreach ($recipients as $recipient) {
1054 $address = trim($recipient);
1059 $this->emailer->send(new ItemCCEMail(
1065 $author['thumb'] ?? ''