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\Protocol\ActivityPub;
24 use Friendica\Content\Text\BBCode;
25 use Friendica\Content\Text\HTML;
26 use Friendica\Content\Text\Markdown;
27 use Friendica\Core\Cache\Enum\Duration;
28 use Friendica\Core\Logger;
29 use Friendica\Core\Protocol;
30 use Friendica\Core\System;
31 use Friendica\Core\Worker;
32 use Friendica\Database\DBA;
34 use Friendica\Model\APContact;
35 use Friendica\Model\Contact;
36 use Friendica\Model\Conversation;
37 use Friendica\Model\Event;
38 use Friendica\Model\GServer;
39 use Friendica\Model\Item;
40 use Friendica\Model\ItemURI;
41 use Friendica\Model\Mail;
42 use Friendica\Model\Tag;
43 use Friendica\Model\User;
44 use Friendica\Model\Post;
45 use Friendica\Protocol\Activity;
46 use Friendica\Protocol\ActivityPub;
47 use Friendica\Protocol\Delivery;
48 use Friendica\Protocol\Relay;
49 use Friendica\Util\DateTimeFormat;
50 use Friendica\Util\HTTPSignature;
51 use Friendica\Util\JsonLD;
52 use Friendica\Util\Network;
53 use Friendica\Util\Strings;
56 * ActivityPub Processor Protocol class
60 const CACHEKEY_FETCH_ACTIVITY = 'processor:fetchMissingActivity:';
61 const CACHEKEY_JUST_FETCHED = 'processor:isJustFetched:';
64 * Add an object id to the list of processed ids
70 private static function addActivityId(string $id)
72 DBA::delete('fetched-activity', ["`received` < ?", DateTimeFormat::utc('now - 5 minutes')]);
73 DBA::insert('fetched-activity', ['object-id' => $id, 'received' => DateTimeFormat::utcNow()]);
77 * Checks if the given object id has just been fetched
83 private static function isFetched(string $id): bool
85 return DBA::exists('fetched-activity', ['object-id' => $id]);
89 * Extracts the tag character (#, @, !) from mention links
94 public static function normalizeMentionLinks(string $body): string
96 $body = preg_replace('%\[url=([^\[\]]*)]([#@!])(.*?)\[/url]%ism', '$2[url=$1]$3[/url]', $body);
97 $body = preg_replace('%([#@!])\[zrl=([^\[\]]*)](.*?)\[/zrl]%ism', '$1[url=$2]$3[/url]', $body);
102 * Convert the language array into a language JSON
104 * @param array $languages
105 * @return string language JSON
107 private static function processLanguages(array $languages): string
109 $codes = array_keys($languages);
111 foreach ($codes as $code) {
119 return json_encode($lang);
122 * Replaces emojis in the body
125 * @param string $body
126 * @param array $emojis
128 * @return string with replaced emojis
130 private static function replaceEmojis(int $uri_id, string $body, array $emojis): string
134 array_column($emojis, 'name'),
135 array_map(function ($emoji) {
136 return '[emoji=' . $emoji['href'] . ']' . $emoji['name'] . '[/emoji]';
141 // We store the emoji here to be able to avoid storing it in the media
142 foreach ($emojis as $emoji) {
143 Post\Link::getByLink($uri_id, $emoji['href']);
149 * Store attached media files in the post-media table
152 * @param array $attachment
155 private static function storeAttachmentAsMedia(int $uriid, array $attachment)
157 if (empty($attachment['url'])) {
161 $data = ['uri-id' => $uriid];
162 $data['type'] = Post\Media::UNKNOWN;
163 $data['url'] = $attachment['url'];
164 $data['mimetype'] = $attachment['mediaType'] ?? null;
165 $data['height'] = $attachment['height'] ?? null;
166 $data['width'] = $attachment['width'] ?? null;
167 $data['size'] = $attachment['size'] ?? null;
168 $data['preview'] = $attachment['image'] ?? null;
169 $data['description'] = $attachment['name'] ?? null;
171 Post\Media::insert($data);
175 * Store attachment data
177 * @param array $activity
180 private static function storeAttachments(array $activity, array $item)
182 if (empty($activity['attachments'])) {
186 foreach ($activity['attachments'] as $attach) {
187 self::storeAttachmentAsMedia($item['uri-id'], $attach);
192 * Store question data
194 * @param array $activity
197 private static function storeQuestion(array $activity, array $item)
199 if (empty($activity['question'])) {
202 $question = ['multiple' => $activity['question']['multiple']];
204 if (!empty($activity['question']['voters'])) {
205 $question['voters'] = $activity['question']['voters'];
208 if (!empty($activity['question']['end-time'])) {
209 $question['end-time'] = DateTimeFormat::utc($activity['question']['end-time']);
212 Post\Question::update($item['uri-id'], $question);
214 foreach ($activity['question']['options'] as $key => $option) {
215 $option = ['name' => $option['name'], 'replies' => $option['replies']];
216 Post\QuestionOption::update($item['uri-id'], $key, $option);
219 Logger::debug('Storing incoming question', ['type' => $activity['type'], 'uri-id' => $item['uri-id'], 'question' => $activity['question']]);
225 * @param array $activity Activity array
226 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
227 * @throws \ImagickException
229 public static function updateItem(array $activity)
231 $item = Post::selectFirst(['uri', 'uri-id', 'thr-parent', 'gravity', 'post-type', 'private'], ['uri' => $activity['id']]);
232 if (!DBA::isResult($item)) {
233 Logger::notice('No existing item, item will be created', ['uri' => $activity['id']]);
234 $item = self::createItem($activity, false);
236 Queue::remove($activity);
240 self::postItem($activity, $item);
244 $item['changed'] = DateTimeFormat::utcNow();
245 $item['edited'] = DateTimeFormat::utc($activity['updated']);
247 Post\Media::deleteByURIId($item['uri-id'], [Post\Media::AUDIO, Post\Media::VIDEO, Post\Media::IMAGE, Post\Media::HTML]);
248 $item = self::processContent($activity, $item);
250 Queue::remove($activity);
254 self::storeAttachments($activity, $item);
255 self::storeQuestion($activity, $item);
257 Post\History::add($item['uri-id'], $item);
258 Item::update($item, ['uri' => $activity['id']]);
260 Queue::remove($activity);
262 if ($activity['object_type'] == 'as:Event') {
263 $posts = Post::select(['event-id', 'uid'], ["`uri` = ? AND `event-id` > ?", $activity['id'], 0]);
264 while ($post = DBA::fetch($posts)) {
265 self::updateEvent($post['event-id'], $activity);
271 * Update an existing event
273 * @param int $event_id
274 * @param array $activity
276 private static function updateEvent(int $event_id, array $activity)
278 $event = DBA::selectFirst('event', [], ['id' => $event_id]);
280 $event['edited'] = DateTimeFormat::utc($activity['updated']);
281 $event['summary'] = HTML::toBBCode($activity['name']);
282 $event['desc'] = HTML::toBBCode($activity['content']);
283 if (!empty($activity['start-time'])) {
284 $event['start'] = DateTimeFormat::utc($activity['start-time']);
286 if (!empty($activity['end-time'])) {
287 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
289 $event['nofinish'] = empty($event['finish']);
290 $event['location'] = $activity['location'];
292 Logger::info('Updating event', ['uri' => $activity['id'], 'id' => $event_id]);
293 Event::store($event);
297 * Prepares data for a message
299 * @param array $activity Activity array
300 * @param bool $fetch_parents
302 * @return array Internal item
304 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
305 * @throws \ImagickException
307 public static function createItem(array $activity, bool $fetch_parents): array
310 $item['verb'] = Activity::POST;
311 $item['thr-parent'] = $activity['reply-to-id'];
313 if ($activity['reply-to-id'] == $activity['id']) {
314 $item['gravity'] = Item::GRAVITY_PARENT;
315 $item['object-type'] = Activity\ObjectType::NOTE;
317 $item['gravity'] = Item::GRAVITY_COMMENT;
318 $item['object-type'] = Activity\ObjectType::COMMENT;
321 if (!empty($activity['conversation'])) {
322 $item['conversation'] = $activity['conversation'];
323 } elseif (!empty($activity['context'])) {
324 $item['conversation'] = $activity['context'];
327 if (!empty($item['conversation'])) {
328 $conversation = Post::selectFirstThread(['uri'], ['conversation' => $item['conversation']]);
329 if (!empty($conversation)) {
330 Logger::debug('Got conversation', ['conversation' => $item['conversation'], 'parent' => $conversation]);
331 $item['parent-uri'] = $conversation['uri'];
332 $item['parent-uri-id'] = ItemURI::getIdByURI($item['parent-uri']);
338 Logger::debug('Create Item', ['id' => $activity['id'], 'conversation' => $item['conversation'] ?? '']);
339 if (empty($activity['author']) && empty($activity['actor'])) {
340 Logger::notice('Missing author and actor. We quit here.', ['activity' => $activity]);
341 Queue::remove($activity);
345 if (!in_array(0, $activity['receiver']) || !DI::config()->get('system', 'fetch_parents')) {
346 $fetch_parents = false;
349 if ($fetch_parents && empty($activity['directmessage']) && ($activity['id'] != $activity['reply-to-id']) && !Post::exists(['uri' => $activity['reply-to-id']])) {
350 $result = self::fetchParent($activity, !empty($conversation));
351 if (!empty($result) && ($item['thr-parent'] != $result) && Post::exists(['uri' => $result])) {
352 $item['thr-parent'] = $result;
356 $item['diaspora_signed_text'] = $activity['diaspora:comment'] ?? '';
358 if (empty($conversation) && empty($activity['directmessage']) && ($item['gravity'] != Item::GRAVITY_PARENT) && !Post::exists(['uri' => $item['thr-parent']])) {
359 Logger::notice('Parent not found, message will be discarded.', ['thr-parent' => $item['thr-parent']]);
360 if (!$fetch_parents) {
361 Queue::remove($activity);
366 $item['network'] = Protocol::ACTIVITYPUB;
367 $item['author-link'] = $activity['author'];
368 $item['author-id'] = Contact::getIdForURL($activity['author']);
369 $item['owner-link'] = $activity['actor'];
370 $item['owner-id'] = Contact::getIdForURL($activity['actor']);
372 if (in_array(0, $activity['receiver']) && !empty($activity['unlisted'])) {
373 $item['private'] = Item::UNLISTED;
374 } elseif (in_array(0, $activity['receiver'])) {
375 $item['private'] = Item::PUBLIC;
377 $item['private'] = Item::PRIVATE;
380 if (!empty($activity['raw'])) {
381 $item['source'] = $activity['raw'];
384 $item['protocol'] = Conversation::PARCEL_ACTIVITYPUB;
386 if (isset($activity['push'])) {
387 $item['direction'] = $activity['push'] ? Conversation::PUSH : Conversation::PULL;
390 if (!empty($activity['from-relay'])) {
391 $item['direction'] = Conversation::RELAY;
394 if ($activity['object_type'] == 'as:Article') {
395 $item['post-type'] = Item::PT_ARTICLE;
396 } elseif ($activity['object_type'] == 'as:Audio') {
397 $item['post-type'] = Item::PT_AUDIO;
398 } elseif ($activity['object_type'] == 'as:Document') {
399 $item['post-type'] = Item::PT_DOCUMENT;
400 } elseif ($activity['object_type'] == 'as:Event') {
401 $item['post-type'] = Item::PT_EVENT;
402 } elseif ($activity['object_type'] == 'as:Image') {
403 $item['post-type'] = Item::PT_IMAGE;
404 } elseif ($activity['object_type'] == 'as:Page') {
405 $item['post-type'] = Item::PT_PAGE;
406 } elseif ($activity['object_type'] == 'as:Question') {
407 $item['post-type'] = Item::PT_POLL;
408 } elseif ($activity['object_type'] == 'as:Video') {
409 $item['post-type'] = Item::PT_VIDEO;
411 $item['post-type'] = Item::PT_NOTE;
414 $item['isGroup'] = false;
416 if (!empty($activity['thread-completion'])) {
417 if ($activity['thread-completion'] != $item['owner-id']) {
418 $actor = Contact::getById($activity['thread-completion'], ['url']);
419 $item['causer-link'] = $actor['url'];
420 $item['causer-id'] = $activity['thread-completion'];
421 Logger::info('Use inherited actor as causer.', ['id' => $item['owner-id'], 'activity' => $activity['thread-completion'], 'owner' => $item['owner-link'], 'actor' => $actor['url']]);
423 // Store the original actor in the "causer" fields to enable the check for ignored or blocked contacts
424 $item['causer-link'] = $item['owner-link'];
425 $item['causer-id'] = $item['owner-id'];
426 Logger::info('Use actor as causer.', ['id' => $item['owner-id'], 'actor' => $item['owner-link']]);
429 $item['owner-link'] = $item['author-link'];
430 $item['owner-id'] = $item['author-id'];
433 if (!$item['isGroup'] && !empty($activity['receiver_urls']['as:audience'])) {
434 foreach ($activity['receiver_urls']['as:audience'] as $audience) {
435 $actor = APContact::getByURL($audience, false);
436 if (($actor['type'] ?? 'Person') == 'Group') {
437 Logger::debug('Group post detected via audience.', ['audience' => $audience, 'actor' => $activity['actor'], 'author' => $activity['author']]);
438 $item['isGroup'] = true;
439 $item['group-link'] = $item['owner-link'] = $audience;
440 $item['owner-id'] = Contact::getIdForURL($audience);
445 $owner = APContact::getByURL($item['owner-link'], false);
448 if (!$item['isGroup'] && (($owner['type'] ?? 'Person') == 'Group')) {
449 Logger::debug('Group post detected via owner.', ['actor' => $activity['actor'], 'author' => $activity['author']]);
450 $item['isGroup'] = true;
451 $item['group-link'] = $item['owner-link'];
452 } elseif (!empty($item['causer-link'])) {
453 $causer = APContact::getByURL($item['causer-link'], false);
456 if (!$item['isGroup'] && (($causer['type'] ?? 'Person') == 'Group')) {
457 Logger::debug('Group post detected via causer.', ['actor' => $activity['actor'], 'author' => $activity['author'], 'causer' => $item['causer-link']]);
458 $item['isGroup'] = true;
459 $item['group-link'] = $item['causer-link'];
462 if (!empty($item['group-link']) && empty($item['causer-link'])) {
463 $item['causer-link'] = $item['group-link'];
464 $item['causer-id'] = Contact::getIdForURL($item['causer-link']);
467 $item['uri'] = $activity['id'];
469 if (empty($activity['published']) || empty($activity['updated'])) {
470 DI::logger()->notice('published or updated keys are empty for activity', ['activity' => $activity]);
473 $item['created'] = DateTimeFormat::utc($activity['published'] ?? 'now');
474 $item['edited'] = DateTimeFormat::utc($activity['updated'] ?? 'now');
475 $guid = $activity['sc:identifier'] ?: self::getGUIDByURL($item['uri']);
476 $item['guid'] = $activity['diaspora:guid'] ?: $guid;
478 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
479 if (empty($item['uri-id'])) {
480 Logger::warning('Unable to get a uri-id for an item uri', ['uri' => $item['uri'], 'guid' => $item['guid']]);
484 $item['thr-parent-id'] = ItemURI::getIdByURI($item['thr-parent']);
486 $item = self::processContent($activity, $item);
488 Logger::info('Message was not processed');
489 Queue::remove($activity);
493 $item['plink'] = $activity['alternate-url'] ?? $item['uri'];
495 self::storeAttachments($activity, $item);
496 self::storeQuestion($activity, $item);
498 // We received the post via AP, so we set the protocol of the server to AP
499 $contact = Contact::getById($item['author-id'], ['gsid']);
500 if (!empty($contact['gsid'])) {
501 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
504 if ($item['author-id'] != $item['owner-id']) {
505 $contact = Contact::getById($item['owner-id'], ['gsid']);
506 if (!empty($contact['gsid'])) {
507 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
515 * Fetch and process parent posts for the given activity
517 * @param array $activity
518 * @param bool $in_background
522 private static function fetchParent(array $activity, bool $in_background = false): string
524 if (self::isFetched($activity['reply-to-id'])) {
525 Logger::info('Id is already fetched', ['id' => $activity['reply-to-id']]);
529 self::addActivityId($activity['reply-to-id']);
531 $completion = $activity['completion-mode'] ?? Receiver::COMPLETION_NONE;
533 if (DI::config()->get('system', 'decoupled_receiver') && ($completion != Receiver::COMPLETION_MANUAL)) {
534 $in_background = true;
537 $recursion_depth = $activity['recursion-depth'] ?? 0;
539 if (!$in_background && ($recursion_depth < DI::config()->get('system', 'max_recursion_depth'))) {
540 Logger::info('Parent not found. Try to refetch it.', ['completion' => $completion, 'recursion-depth' => $recursion_depth, 'parent' => $activity['reply-to-id']]);
541 $result = self::fetchMissingActivity($activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
542 if (empty($result) && self::isActivityGone($activity['reply-to-id'])) {
543 Logger::notice('The activity is gone, the queue entry will be deleted', ['parent' => $activity['reply-to-id']]);
544 if (!empty($activity['entry-id'])) {
545 Queue::deleteById($activity['entry-id']);
547 } elseif (!empty($result)) {
548 $post = Post::selectFirstPost(['uri'], ['uri' => [$result, $activity['reply-to-id']]]);
549 if (!empty($post['uri'])) {
550 Logger::info('The activity has been fetched and created.', ['result' => $result, 'uri' => $post['uri']]);
553 Logger::notice('The activity exists but has not been created, the queue entry will be deleted.', ['parent' => $result]);
554 if (!empty($activity['entry-id'])) {
555 Queue::deleteById($activity['entry-id']);
560 } elseif (self::isActivityGone($activity['reply-to-id'])) {
561 Logger::notice('The activity is gone. We will not spawn a worker. The queue entry will be deleted', ['parent' => $activity['reply-to-id']]);
562 if ($in_background) {
563 // fetching in background is done for all activities where we have got the conversation
564 // There we only delete the single activity and not the whole thread since we can store the
565 // other posts in the thread even with missing posts.
566 Queue::remove($activity);
567 } elseif (!empty($activity['entry-id'])) {
568 Queue::deleteById($activity['entry-id']);
571 } elseif ($in_background) {
572 Logger::notice('Fetching is done in the background.', ['parent' => $activity['reply-to-id']]);
574 Logger::notice('Recursion level is too high.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
577 if (!Fetch::hasWorker($activity['reply-to-id'])) {
578 Logger::notice('Fetching is done by worker.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
579 Fetch::add($activity['reply-to-id']);
580 $activity['recursion-depth'] = 0;
581 $wid = Worker::add(Worker::PRIORITY_HIGH, 'FetchMissingActivity', $activity['reply-to-id'], $activity, '', Receiver::COMPLETION_ASYNC);
582 Fetch::setWorkerId($activity['reply-to-id'], $wid);
584 Logger::debug('Activity will already be fetched via a worker.', ['url' => $activity['reply-to-id']]);
591 * Check if a given activity is no longer available
597 public static function isActivityGone(string $url): bool
600 $curlResult = HTTPSignature::fetchRaw($url, 0);
601 } catch (\Exception $exception) {
602 Logger::notice('Error fetching url', ['url' => $url, 'exception' => $exception]);
606 if (Network::isUrlBlocked($url)) {
610 // @todo To ensure that the remote system is working correctly, we can check if the "Content-Type" contains JSON
611 if (in_array($curlResult->getReturnCode(), [401, 404])) {
615 if ($curlResult->isSuccess()) {
616 $object = json_decode($curlResult->getBody(), true);
617 if (!empty($object)) {
618 $activity = JsonLD::compact($object);
619 if (JsonLD::fetchElement($activity, '@type') == 'as:Tombstone') {
623 } elseif ($curlResult->getReturnCode() == 0) {
624 $host = parse_url($url, PHP_URL_HOST);
625 if (!(filter_var($host, FILTER_VALIDATE_IP) || @dns_get_record($host . '.', DNS_A + DNS_AAAA))) {
635 * @param array $activity
636 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
637 * @throws \ImagickException
639 public static function deleteItem(array $activity)
641 $owner = Contact::getIdForURL($activity['actor']);
643 Logger::info('Deleting item', ['object' => $activity['object_id'], 'owner' => $owner]);
644 Item::markForDeletion(['uri' => $activity['object_id'], 'owner-id' => $owner]);
645 Queue::remove($activity);
649 * Prepare the item array for an activity
651 * @param array $activity Activity array
652 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
653 * @throws \ImagickException
655 public static function addTag(array $activity)
657 if (empty($activity['object_content']) || empty($activity['object_id'])) {
661 foreach ($activity['receiver'] as $receiver) {
662 $item = Post::selectFirst(['id', 'uri-id', 'origin', 'author-link'], ['uri' => $activity['target_id'], 'uid' => $receiver]);
663 if (!DBA::isResult($item)) {
664 // We don't fetch missing content for this purpose
668 if (($item['author-link'] != $activity['actor']) && !$item['origin']) {
669 Logger::info('Not origin, not from the author, skipping update', ['id' => $item['id'], 'author' => $item['author-link'], 'actor' => $activity['actor']]);
673 Tag::store($item['uri-id'], Tag::HASHTAG, $activity['object_content'], $activity['object_id']);
674 Logger::info('Tagged item', ['id' => $item['id'], 'tag' => $activity['object_content'], 'uri' => $activity['target_id'], 'actor' => $activity['actor']]);
679 * Prepare the item array for an activity
681 * @param array $activity Activity array
682 * @param string $verb Activity verb
683 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
684 * @throws \ImagickException
686 public static function createActivity(array $activity, string $verb)
688 $activity['reply-to-id'] = $activity['object_id'];
689 $item = self::createItem($activity, false);
691 Logger::debug('Activity was not prepared', ['id' => $activity['object_id']]);
695 $item['verb'] = $verb;
696 $item['thr-parent'] = $activity['object_id'];
697 $item['gravity'] = Item::GRAVITY_ACTIVITY;
698 unset($item['post-type']);
699 $item['object-type'] = Activity\ObjectType::NOTE;
701 if (!empty($activity['content'])) {
702 $item['body'] = HTML::toBBCode($activity['content']);
705 $item['diaspora_signed_text'] = $activity['diaspora:like'] ?? '';
707 self::postItem($activity, $item);
711 * Fetch the Uri-Id of a post for the "featured" collection
713 * @param array $activity
716 private static function getUriIdForFeaturedCollection(array $activity)
718 $actor = APContact::getByURL($activity['actor']);
723 // Refetch the account when the "featured" collection is missing.
724 // This can be removed in a future version (end of 2022 should be good).
725 if (empty($actor['featured'])) {
726 $actor = APContact::getByURL($activity['actor'], true);
732 $parent = Post::selectFirst(['uri-id', 'author-id'], ['uri' => $activity['object_id']]);
733 if (empty($parent['uri-id'])) {
734 if (self::fetchMissingActivity($activity['object_id'], $activity, '', Receiver::COMPLETION_AUTO)) {
735 $parent = Post::selectFirst(['uri-id'], ['uri' => $activity['object_id']]);
739 if (!empty($parent['uri-id'])) {
747 * Add a post to the "Featured" collection
749 * @param array $activity
751 public static function addToFeaturedCollection(array $activity)
753 $post = self::getUriIdForFeaturedCollection($activity);
758 Logger::debug('Add post to featured collection', ['post' => $post]);
760 Post\Collection::add($post['uri-id'], Post\Collection::FEATURED, $post['author-id']);
761 Queue::remove($activity);
765 * Remove a post to the "Featured" collection
767 * @param array $activity
769 public static function removeFromFeaturedCollection(array $activity)
771 $post = self::getUriIdForFeaturedCollection($activity);
776 Logger::debug('Remove post from featured collection', ['post' => $post]);
778 Post\Collection::remove($post['uri-id'], Post\Collection::FEATURED);
779 Queue::remove($activity);
785 * @param array $activity Activity array
788 * @return int event id
791 public static function createEvent(array $activity, array $item): int
793 $event['summary'] = HTML::toBBCode($activity['name'] ?: $activity['summary']);
794 $event['desc'] = HTML::toBBCode($activity['content'] ?? '');
795 if (!empty($activity['start-time'])) {
796 $event['start'] = DateTimeFormat::utc($activity['start-time']);
798 if (!empty($activity['end-time'])) {
799 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
801 $event['nofinish'] = empty($event['finish']);
802 $event['location'] = $activity['location'];
803 $event['cid'] = $item['contact-id'];
804 $event['uid'] = $item['uid'];
805 $event['uri'] = $item['uri'];
806 $event['edited'] = $item['edited'];
807 $event['private'] = $item['private'];
808 $event['guid'] = $item['guid'];
809 $event['plink'] = $item['plink'];
810 $event['network'] = $item['network'];
811 $event['protocol'] = $item['protocol'];
812 $event['direction'] = $item['direction'];
813 $event['source'] = $item['source'];
815 $ev = DBA::selectFirst('event', ['id'], ['uri' => $item['uri'], 'uid' => $item['uid']]);
816 if (DBA::isResult($ev)) {
817 $event['id'] = $ev['id'];
820 $event_id = Event::store($event);
822 Logger::info('Event was stored', ['id' => $event_id]);
828 * Process the content
830 * @param array $activity Activity array
832 * @return array|bool Returns the item array or false if there was an unexpected occurrence
835 private static function processContent(array $activity, array $item)
837 if (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/markdown')) {
838 $item['title'] = strip_tags($activity['name'] ?? '');
839 $content = Markdown::toBBCode($activity['content']);
840 } elseif (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/bbcode')) {
841 $item['title'] = $activity['name'];
842 $content = $activity['content'];
844 // By default assume "text/html"
845 $item['title'] = HTML::toBBCode($activity['name'] ?? '');
846 $content = HTML::toBBCode($activity['content'] ?? '');
849 $item['title'] = trim(BBCode::toPlaintext($item['title']));
851 if (!empty($activity['languages'])) {
852 $item['language'] = self::processLanguages($activity['languages']);
855 if (!empty($activity['emojis'])) {
856 $content = self::replaceEmojis($item['uri-id'], $content, $activity['emojis']);
859 $content = self::addMentionLinks($content, $activity['tags']);
861 if (!empty($activity['quote-url'])) {
862 $id = Item::fetchByLink($activity['quote-url'], 0, ActivityPub\Receiver::COMPLETION_ASYNC);
864 $shared_item = Post::selectFirst(['uri-id'], ['id' => $id]);
865 $item['quote-uri-id'] = $shared_item['uri-id'];
866 } elseif ($uri_id = ItemURI::getIdByURI($activity['quote-url'], false)) {
867 Logger::info('Quote was not fetched but the uri-id existed', ['guid' => $item['guid'], 'uri-id' => $item['uri-id'], 'quote' => $activity['quote-url'], 'uri-id' => $uri_id]);
868 $item['quote-uri-id'] = $uri_id;
870 Logger::info('Quote was not fetched', ['guid' => $item['guid'], 'uri-id' => $item['uri-id'], 'quote' => $activity['quote-url']]);
874 if (!empty($activity['source'])) {
875 $item['body'] = $activity['source'];
876 $item['raw-body'] = $content;
878 $quote_uri_id = Item::getQuoteUriId($item['body']);
879 if (empty($item['quote-uri-id']) && !empty($quote_uri_id)) {
880 $item['quote-uri-id'] = $quote_uri_id;
883 $item['body'] = BBCode::removeSharedData($item['body']);
885 $parent_uri = $item['parent-uri'] ?? $item['thr-parent'];
886 if (empty($activity['directmessage']) && ($parent_uri != $item['uri']) && ($item['gravity'] == Item::GRAVITY_COMMENT)) {
887 $parent = Post::selectFirst(['id', 'uri-id', 'private', 'author-link', 'alias'], ['uri' => $parent_uri]);
888 if (!DBA::isResult($parent)) {
889 Logger::warning('Unknown parent item.', ['uri' => $parent_uri]);
892 $content = self::removeImplicitMentionsFromBody($content, $parent);
894 $item['content-warning'] = HTML::toBBCode($activity['summary'] ?? '');
895 $item['raw-body'] = $item['body'] = $content;
898 if (!empty($item['author-id']) && ($item['author-id'] == $item['owner-id'])) {
899 foreach (Tag::getFromBody($item['body'], Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION]) as $tag) {
900 $actor = APContact::getByURL($tag[2], false);
901 if (($actor['type'] ?? 'Person') == 'Group') {
902 Logger::debug('Group post detected via exclusive mention.', ['mention' => $actor['url'], 'actor' => $activity['actor'], 'author' => $activity['author']]);
903 $item['isGroup'] = true;
904 $item['group-link'] = $item['owner-link'] = $actor['url'];
905 $item['owner-id'] = Contact::getIdForURL($actor['url']);
911 self::storeFromBody($item);
912 self::storeTags($item['uri-id'], $activity['tags']);
914 self::storeReceivers($item['uri-id'], $activity['receiver_urls'] ?? []);
916 $item['location'] = $activity['location'];
918 if (!empty($activity['latitude']) && !empty($activity['longitude'])) {
919 $item['coord'] = $activity['latitude'] . ' ' . $activity['longitude'];
922 $item['app'] = $activity['generator'];
928 * Store hashtags and mentions
932 private static function storeFromBody(array $item)
934 // Make sure to delete all existing tags (can happen when called via the update functionality)
935 DBA::delete('post-tag', ['uri-id' => $item['uri-id']]);
937 Tag::storeFromBody($item['uri-id'], $item['body'], '@!');
941 * Generate a GUID out of an URL of an ActivityPub post.
943 * @param string $url message URL
944 * @return string with GUID
946 private static function getGUIDByURL(string $url): string
948 $parsed = parse_url($url);
950 $host_hash = hash('crc32', $parsed['host']);
952 unset($parsed["scheme"]);
953 unset($parsed["host"]);
955 $path = implode("/", $parsed);
957 return $host_hash . '-'. hash('fnv164', $path) . '-'. hash('joaat', $path);
961 * Checks if an incoming message is wanted
963 * @param array $activity
965 * @return boolean Is the message wanted?
967 private static function isSolicitedMessage(array $activity, array $item): bool
969 // The checks are split to improve the support when searching why a message was accepted.
970 if (count($activity['receiver']) != 1) {
971 // The message has more than one receiver, so it is wanted.
972 Logger::debug('Message has got several receivers - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
976 if ($item['private'] == Item::PRIVATE) {
977 // We only look at public posts here. Private posts are expected to be intentionally posted to the single receiver.
978 Logger::debug('Message is private - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
982 if (!empty($activity['from-relay'])) {
983 // We check relay posts at another place. When it arrived here, the message is already checked.
984 Logger::debug('Message is a relay post that is already checked - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
988 if (in_array($activity['completion-mode'] ?? Receiver::COMPLETION_NONE, [Receiver::COMPLETION_MANUAL, Receiver::COMPLETION_ANNOUNCE])) {
989 // Manual completions and completions caused by reshares are allowed without any further checks.
990 Logger::debug('Message is in completion mode - accepted', ['mode' => $activity['completion-mode'], 'uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
994 if ($item['gravity'] != Item::GRAVITY_PARENT) {
995 // We cannot reliably check at this point if a comment or activity belongs to an accepted post or needs to be fetched
996 // This can possibly be improved in the future.
997 Logger::debug('Message is no parent - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
1001 $tags = array_column(Tag::getByURIId($item['uri-id'], [Tag::HASHTAG]), 'name');
1002 if (Relay::isSolicitedPost($tags, $item['body'], $item['author-id'], $item['uri'], Protocol::ACTIVITYPUB, $activity['thread-completion'] ?? 0)) {
1003 Logger::debug('Post is accepted because of the relay settings', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
1011 * Creates an item post
1013 * @param array $activity Activity data
1014 * @param array $item item array
1015 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1016 * @throws \ImagickException
1018 public static function postItem(array $activity, array $item)
1026 ksort($activity['receiver']);
1028 if (!self::isSolicitedMessage($activity, $item)) {
1029 DBA::delete('item-uri', ['id' => $item['uri-id']]);
1030 if (!empty($activity['entry-id'])) {
1031 Queue::deleteById($activity['entry-id']);
1036 foreach ($activity['receiver'] as $receiver) {
1037 if ($receiver == -1) {
1041 if (($receiver != 0) && empty($item['parent-uri-id']) && !empty($item['thr-parent-id'])) {
1042 $parent = Post::selectFirst(['parent-uri-id', 'parent-uri'], ['uri-id' => $item['thr-parent-id'], 'uid' => [0, $receiver]]);
1043 if (!empty($parent['parent-uri-id'])) {
1044 $item['parent-uri-id'] = $parent['parent-uri-id'];
1045 $item['parent-uri'] = $parent['parent-uri'];
1049 $item['uid'] = $receiver;
1051 $type = $activity['reception_type'][$receiver] ?? Receiver::TARGET_UNKNOWN;
1053 case Receiver::TARGET_TO:
1054 $item['post-reason'] = Item::PR_TO;
1056 case Receiver::TARGET_CC:
1057 $item['post-reason'] = Item::PR_CC;
1059 case Receiver::TARGET_BTO:
1060 $item['post-reason'] = Item::PR_BTO;
1062 case Receiver::TARGET_BCC:
1063 $item['post-reason'] = Item::PR_BCC;
1065 case Receiver::TARGET_AUDIENCE:
1066 $item['post-reason'] = Item::PR_AUDIENCE;
1068 case Receiver::TARGET_FOLLOWER:
1069 $item['post-reason'] = Item::PR_FOLLOWER;
1071 case Receiver::TARGET_ANSWER:
1072 $item['post-reason'] = Item::PR_COMMENT;
1074 case Receiver::TARGET_GLOBAL:
1075 $item['post-reason'] = Item::PR_GLOBAL;
1078 $item['post-reason'] = Item::PR_NONE;
1081 $item['post-reason'] = Item::getPostReason($item);
1083 if (in_array($item['post-reason'], [Item::PR_GLOBAL, Item::PR_NONE])) {
1084 if (!empty($activity['from-relay'])) {
1085 $item['post-reason'] = Item::PR_RELAY;
1086 } elseif (!empty($activity['thread-completion'])) {
1087 $item['post-reason'] = Item::PR_FETCHED;
1088 } elseif (!empty($activity['push'])) {
1089 $item['post-reason'] = Item::PR_PUSHED;
1091 } elseif (($item['post-reason'] == Item::PR_FOLLOWER) && !empty($activity['from-relay'])) {
1092 // When a post arrives via a relay and we follow the author, we have to override the causer.
1093 // Otherwise the system assumes that we follow the relay. (See "addRowInformation")
1094 Logger::debug('Relay post for follower', ['receiver' => $receiver, 'guid' => $item['guid'], 'relay' => $activity['from-relay']]);
1095 $item['causer-id'] = ($item['gravity'] == Item::GRAVITY_PARENT) ? $item['owner-id'] : $item['author-id'];
1098 if ($item['isGroup']) {
1099 $item['contact-id'] = Contact::getIdForURL($item['group-link'], $receiver);
1101 $item['contact-id'] = Contact::getIdForURL($item['author-link'], $receiver);
1104 if (($receiver != 0) && empty($item['contact-id'])) {
1105 $item['contact-id'] = Contact::getIdForURL($activity['author']);
1108 if (!empty($activity['directmessage']) && self::postMail($item)) {
1112 if (($receiver != 0) && ($item['gravity'] == Item::GRAVITY_PARENT) && !in_array($item['post-reason'], [Item::PR_FOLLOWER, Item::PR_TAG, item::PR_TO, Item::PR_CC, Item::PR_AUDIENCE])) {
1113 if (!$item['isGroup']) {
1114 if ($item['post-reason'] == Item::PR_BCC) {
1115 Logger::info('Top level post via BCC from a non sharer, ignoring', ['uid' => $receiver, 'contact' => $item['contact-id'], 'url' => $item['uri']]);
1119 if ((DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') != Item::COMPLETION_LIKE)
1120 && in_array($activity['thread-children-type'] ?? '', Receiver::ACTIVITY_TYPES)) {
1121 Logger::info('Top level post from thread completion from a non sharer had been initiated via an activity, ignoring',
1122 ['type' => $activity['thread-children-type'], 'user' => $item['uid'], 'causer' => $item['causer-link'], 'author' => $activity['author'], 'url' => $item['uri']]);
1128 $user = User::getById($receiver, ['account-type']);
1129 if (!empty($user['account-type'])) {
1130 $isGroup = ($user['account-type'] == User::ACCOUNT_TYPE_COMMUNITY);
1133 if ((DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') == Item::COMPLETION_NONE)
1134 && ((!$isGroup && !$item['isGroup'] && ($activity['type'] != 'as:Announce'))
1135 || !Contact::isSharingByURL($activity['actor'], $receiver))) {
1136 Logger::info('Actor is a non sharer, is no group or it is no announce', ['uid' => $receiver, 'actor' => $activity['actor'], 'url' => $item['uri'], 'type' => $activity['type']]);
1140 Logger::info('Accepting post', ['uid' => $receiver, 'url' => $item['uri']]);
1143 if (!self::hasParents($item, $receiver)) {
1147 if (($item['gravity'] != Item::GRAVITY_ACTIVITY) && ($activity['object_type'] == 'as:Event')) {
1148 $event_id = self::createEvent($activity, $item);
1150 $item = Event::getItemArrayForImportedId($event_id, $item);
1153 $item_id = Item::insert($item);
1155 Logger::info('Item insertion successful', ['user' => $item['uid'], 'item_id' => $item_id]);
1158 Logger::notice('Item insertion aborted', ['uri' => $item['uri'], 'uid' => $item['uid']]);
1159 if (($item['uid'] == 0) && (count($activity['receiver']) > 1)) {
1160 Logger::info('Public item was aborted. We skip for all users.', ['uri' => $item['uri']]);
1165 if ($item['uid'] == 0) {
1170 Queue::remove($activity);
1172 if ($success && Queue::hasChildren($item['uri']) && Post::exists(['uri' => $item['uri']])) {
1173 Queue::processReplyByUri($item['uri']);
1176 // Store send a follow request for every reshare - but only when the item had been stored
1177 if ($stored && ($item['private'] != Item::PRIVATE) && ($item['gravity'] == Item::GRAVITY_PARENT) && !empty($item['author-link']) && ($item['author-link'] != $item['owner-link'])) {
1178 $author = APContact::getByURL($item['owner-link'], false);
1179 // We send automatic follow requests for reshared messages. (We don't need though for group posts)
1180 if ($author['type'] != 'Group') {
1181 Logger::info('Send follow request', ['uri' => $item['uri'], 'stored' => $stored, 'to' => $item['author-link']]);
1182 ActivityPub\Transmitter::sendFollowObject($item['uri'], $item['author-link']);
1188 * Checks if there are parent posts for the given receiver.
1189 * If not, then the system will try to add them.
1191 * @param array $item
1192 * @param integer $receiver
1195 private static function hasParents(array $item, int $receiver)
1197 if (($receiver == 0) || ($item['gravity'] == Item::GRAVITY_PARENT)) {
1201 $fields = ['causer-id' => $item['causer-id'] ?? $item['author-id'], 'post-reason' => Item::PR_FETCHED];
1205 if ($item['verb'] != Activity::ANNOUNCE) {
1206 switch (DI::pConfig()->get($receiver, 'system', 'accept_only_sharer')) {
1207 case Item::COMPLETION_COMMENT:
1208 $add_parent = ($item['gravity'] != Item::GRAVITY_ACTIVITY);
1211 case Item::COMPLETION_NONE:
1212 $add_parent = false;
1218 $add_parent = Contact::isSharing($fields['causer-id'], $receiver);
1219 if (!$add_parent && ($item['author-id'] != $fields['causer-id'])) {
1220 $add_parent = Contact::isSharing($item['author-id'], $receiver);
1222 if (!$add_parent && !in_array($item['owner-id'], [$fields['causer-id'], $item['author-id']])) {
1223 $add_parent = Contact::isSharing($item['owner-id'], $receiver);
1227 $has_parents = false;
1229 if (!empty($item['parent-uri-id'])) {
1230 if (Post::exists(['uri-id' => $item['parent-uri-id'], 'uid' => $receiver])) {
1231 $has_parents = true;
1232 } elseif ($add_parent && Post::exists(['uri-id' => $item['parent-uri-id'], 'uid' => 0])) {
1233 $stored = Item::storeForUserByUriId($item['parent-uri-id'], $receiver, $fields);
1234 $has_parents = (bool)$stored;
1236 Logger::notice('Inserted missing parent post', ['stored' => $stored, 'uid' => $receiver, 'parent' => $item['parent-uri']]);
1238 Logger::notice('Parent could not be added.', ['uid' => $receiver, 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1241 } elseif ($add_parent) {
1242 Logger::debug('Parent does not exist.', ['uid' => $receiver, 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1244 Logger::debug('Parent should not be added.', ['uid' => $receiver, 'gravity' => $item['gravity'], 'verb' => $item['verb'], 'guid' => $item['guid'], 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1248 if (empty($item['parent-uri-id']) || ($item['thr-parent-id'] != $item['parent-uri-id'])) {
1249 if (Post::exists(['uri-id' => $item['thr-parent-id'], 'uid' => $receiver])) {
1250 $has_parents = true;
1251 } elseif (($has_parents || $add_parent) && Post::exists(['uri-id' => $item['thr-parent-id'], 'uid' => 0])) {
1252 $stored = Item::storeForUserByUriId($item['thr-parent-id'], $receiver, $fields);
1253 $has_parents = $has_parents || (bool)$stored;
1255 Logger::notice('Inserted missing thread parent post', ['stored' => $stored, 'uid' => $receiver, 'thread-parent' => $item['thr-parent']]);
1257 Logger::notice('Thread parent could not be added.', ['uid' => $receiver, 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1259 } elseif ($add_parent) {
1260 Logger::debug('Thread parent does not exist.', ['uid' => $receiver, 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1262 Logger::debug('Thread parent should not be added.', ['uid' => $receiver, 'gravity' => $item['gravity'], 'verb' => $item['verb'], 'guid' => $item['guid'], 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1266 return $has_parents;
1270 * Store tags and mentions into the tag table
1272 * @param integer $uriid
1273 * @param array $tags
1275 private static function storeTags(int $uriid, array $tags = null)
1277 foreach ($tags as $tag) {
1278 if (empty($tag['name']) || empty($tag['type']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
1282 $hash = substr($tag['name'], 0, 1);
1284 if ($tag['type'] == 'Mention') {
1285 if (in_array($hash, [Tag::TAG_CHARACTER[Tag::MENTION],
1286 Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION],
1287 Tag::TAG_CHARACTER[Tag::IMPLICIT_MENTION]])) {
1288 $tag['name'] = substr($tag['name'], 1);
1290 $type = Tag::IMPLICIT_MENTION;
1292 if (!empty($tag['href'])) {
1293 $apcontact = APContact::getByURL($tag['href']);
1294 if (!empty($apcontact['name']) || !empty($apcontact['nick'])) {
1295 $tag['name'] = $apcontact['name'] ?: $apcontact['nick'];
1298 } elseif ($tag['type'] == 'Hashtag') {
1299 if ($hash == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
1300 $tag['name'] = substr($tag['name'], 1);
1302 $type = Tag::HASHTAG;
1305 if (empty($tag['name'])) {
1309 Tag::store($uriid, $type, $tag['name'], $tag['href']);
1313 public static function storeReceivers(int $uriid, array $receivers)
1315 foreach (['as:to' => Tag::TO, 'as:cc' => Tag::CC, 'as:bto' => Tag::BTO, 'as:bcc' => Tag::BCC, 'as:audience' => Tag::AUDIENCE, 'as:attributedTo' => Tag::ATTRIBUTED] as $element => $type) {
1316 if (!empty($receivers[$element])) {
1317 foreach ($receivers[$element] as $receiver) {
1318 if ($receiver == ActivityPub::PUBLIC_COLLECTION) {
1319 $name = Receiver::PUBLIC_COLLECTION;
1320 } elseif ($path = parse_url($receiver, PHP_URL_PATH)) {
1321 $name = trim($path, '/');
1322 } elseif ($host = parse_url($receiver, PHP_URL_HOST)) {
1325 Logger::warning('Unable to coerce name from receiver', ['element' => $element, 'type' => $type, 'receiver' => $receiver]);
1329 $target = Tag::getTargetType($receiver);
1330 Logger::debug('Got target type', ['type' => $target, 'url' => $receiver]);
1331 Tag::store($uriid, $type, $name, $receiver, $target);
1338 * Creates an mail post
1340 * @param array $item item array
1341 * @return int|bool New mail table row id or false on error
1342 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1344 private static function postMail(array $item): bool
1346 if (($item['gravity'] != Item::GRAVITY_PARENT) && !DBA::exists('mail', ['uri' => $item['thr-parent'], 'uid' => $item['uid']])) {
1347 Logger::info('Parent not found, mail will be discarded.', ['uid' => $item['uid'], 'uri' => $item['thr-parent']]);
1351 if (!Contact::isFollower($item['contact-id'], $item['uid']) && !Contact::isSharing($item['contact-id'], $item['uid'])) {
1352 Logger::info('Contact is not a sharer or follower, mail will be discarded.', ['item' => $item]);
1356 Logger::info('Direct Message', $item);
1359 $msg['uid'] = $item['uid'];
1361 $msg['contact-id'] = $item['contact-id'];
1363 $contact = Contact::getById($item['contact-id'], ['name', 'url', 'photo']);
1364 $msg['from-name'] = $contact['name'];
1365 $msg['from-url'] = $contact['url'];
1366 $msg['from-photo'] = $contact['photo'];
1368 $msg['uri'] = $item['uri'];
1369 $msg['created'] = $item['created'];
1371 $parent = DBA::selectFirst('mail', ['parent-uri', 'title'], ['uri' => $item['thr-parent']]);
1372 if (DBA::isResult($parent)) {
1373 $msg['parent-uri'] = $parent['parent-uri'];
1374 $msg['title'] = $parent['title'];
1376 $msg['parent-uri'] = $item['thr-parent'];
1378 if (!empty($item['title'])) {
1379 $msg['title'] = $item['title'];
1380 } elseif (!empty($item['content-warning'])) {
1381 $msg['title'] = $item['content-warning'];
1383 // Trying to generate a title out of the body
1384 $title = $item['body'];
1386 while (preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $title, $matches)) {
1387 $title = $matches[3];
1390 $title = trim(BBCode::toPlaintext($title));
1392 if (strlen($title) > 20) {
1393 $title = substr($title, 0, 20) . '...';
1396 $msg['title'] = $title;
1399 $msg['body'] = $item['body'];
1401 return Mail::insert($msg);
1405 * Fetch featured posts from a contact with the given url
1407 * @param string $url
1410 public static function fetchFeaturedPosts(string $url)
1412 Logger::info('Fetch featured posts', ['contact' => $url]);
1414 $apcontact = APContact::getByURL($url);
1415 if (empty($apcontact['featured'])) {
1416 Logger::info('Contact does not have a featured collection', ['contact' => $url]);
1420 $pcid = Contact::getIdForURL($url, 0, false);
1422 Logger::notice('Contact not found', ['contact' => $url]);
1426 $posts = Post\Collection::selectToArrayForContact($pcid, Post\Collection::FEATURED);
1427 if (!empty($posts)) {
1428 $old_featured = array_column($posts, 'uri-id');
1433 $featured = ActivityPub::fetchItems($apcontact['featured']);
1434 if (empty($featured)) {
1435 Logger::info('Contact does not have featured posts', ['contact' => $url]);
1437 foreach ($old_featured as $uri_id) {
1438 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1439 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1447 foreach ($featured as $post) {
1448 if (empty($post['id'])) {
1451 $id = Item::fetchByLink($post['id'], 0, ActivityPub\Receiver::COMPLETION_ASYNC);
1453 $item = Post::selectFirst(['uri-id', 'featured', 'author-id'], ['id' => $id]);
1454 if (!empty($item['uri-id'])) {
1455 if (!$item['featured']) {
1456 Post\Collection::add($item['uri-id'], Post\Collection::FEATURED, $item['author-id']);
1457 Logger::debug('Added featured post', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1460 Logger::debug('Post already had been featured', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1464 $index = array_search($item['uri-id'], $old_featured);
1465 if (!($index === false)) {
1466 unset($old_featured[$index]);
1472 foreach ($old_featured as $uri_id) {
1473 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1474 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1477 Logger::info('Fetched featured posts', ['new' => $new, 'old' => $old, 'contact' => $url]);
1480 public static function fetchCachedActivity(string $url, int $uid): array
1482 $cachekey = self::CACHEKEY_FETCH_ACTIVITY . $uid . ':' . hash('sha256', $url);
1483 $object = DI::cache()->get($cachekey);
1485 if (!is_null($object)) {
1486 if (!empty($object)) {
1487 Logger::debug('Fetch from cache', ['url' => $url, 'uid' => $uid]);
1489 Logger::debug('Fetch from negative cache', ['url' => $url, 'uid' => $uid]);
1494 $object = ActivityPub::fetchContent($url, $uid);
1495 if (empty($object)) {
1496 Logger::notice('Activity was not fetchable, aborting.', ['url' => $url, 'uid' => $uid]);
1497 // We perform negative caching.
1498 DI::cache()->set($cachekey, [], Duration::FIVE_MINUTES);
1502 if (empty($object['id'])) {
1503 Logger::notice('Activity has got not id, aborting. ', ['url' => $url, 'object' => $object]);
1506 DI::cache()->set($cachekey, $object, Duration::FIVE_MINUTES);
1508 Logger::debug('Activity was fetched successfully', ['url' => $url, 'uid' => $uid]);
1514 * Fetches missing posts
1516 * @param string $url message URL
1517 * @param array $child activity array with the child of this message
1518 * @param string $relay_actor Relay actor
1519 * @param int $completion Completion mode, see Receiver::COMPLETION_*
1520 * @param int $uid User id that is used to fetch the activity
1521 * @return string fetched message URL
1522 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1523 * @throws \ImagickException
1525 public static function fetchMissingActivity(string $url, array $child = [], string $relay_actor = '', int $completion = Receiver::COMPLETION_MANUAL, int $uid = 0): string
1527 $object = self::fetchCachedActivity($url, $uid);
1528 if (empty($object)) {
1534 if (!empty($object['attributedTo'])) {
1535 $attributed_to = $object['attributedTo'];
1536 if (is_array($attributed_to)) {
1537 $compacted = JsonLD::compact($object);
1538 $attributed_to = JsonLD::fetchElement($compacted, 'as:attributedTo', '@id');
1540 $signer[] = $attributed_to;
1543 if (!empty($object['actor'])) {
1544 $object_actor = $object['actor'];
1545 } elseif (!empty($attributed_to)) {
1546 $object_actor = $attributed_to;
1552 $signer[] = $object_actor;
1554 if (!empty($child['author'])) {
1555 $actor = $child['author'];
1558 $actor = $object_actor;
1561 if (!empty($object['published'])) {
1562 $published = $object['published'];
1563 } elseif (!empty($child['published'])) {
1564 $published = $child['published'];
1566 $published = DateTimeFormat::utcNow();
1570 $activity['@context'] = $object['@context'] ?? ActivityPub::CONTEXT;
1571 unset($object['@context']);
1572 $activity['id'] = $object['id'];
1573 $activity['to'] = $object['to'] ?? [];
1574 $activity['cc'] = $object['cc'] ?? [];
1575 $activity['audience'] = $object['audience'] ?? [];
1576 $activity['actor'] = $actor;
1577 $activity['object'] = $object;
1578 $activity['published'] = $published;
1579 $activity['type'] = 'Create';
1581 $ldactivity = JsonLD::compact($activity);
1583 $ldactivity['recursion-depth'] = !empty($child['recursion-depth']) ? $child['recursion-depth'] + 1 : 0;
1585 if ($object_actor != $actor) {
1586 Contact::updateByUrlIfNeeded($object_actor);
1589 Contact::updateByUrlIfNeeded($actor);
1591 if (!empty($child['thread-completion'])) {
1592 $ldactivity['thread-completion'] = $child['thread-completion'];
1593 $ldactivity['completion-mode'] = $child['completion-mode'] ?? Receiver::COMPLETION_NONE;
1595 $ldactivity['thread-completion'] = Contact::getIdForURL($relay_actor ?: $actor);
1596 $ldactivity['completion-mode'] = $completion;
1599 if ($completion == Receiver::COMPLETION_RELAY) {
1600 $ldactivity['from-relay'] = $ldactivity['thread-completion'];
1601 if (!self::acceptIncomingMessage($ldactivity, $object['id'])) {
1606 if (!empty($child['thread-children-type'])) {
1607 $ldactivity['thread-children-type'] = $child['thread-children-type'];
1608 } elseif (!empty($child['type'])) {
1609 $ldactivity['thread-children-type'] = $child['type'];
1611 $ldactivity['thread-children-type'] = 'as:Create';
1614 if (($completion == Receiver::COMPLETION_RELAY) && Queue::exists($url, 'as:Create')) {
1615 Logger::info('Activity has already been queued.', ['url' => $url, 'object' => $activity['id']]);
1616 } elseif (ActivityPub\Receiver::processActivity($ldactivity, json_encode($activity), $uid, true, false, $signer, '', $completion)) {
1617 Logger::info('Activity had been fetched and processed.', ['url' => $url, 'entry' => $child['entry-id'] ?? 0, 'completion' => $completion, 'object' => $activity['id']]);
1619 Logger::info('Activity had been fetched and will be processed later.', ['url' => $url, 'entry' => $child['entry-id'] ?? 0, 'completion' => $completion, 'object' => $activity['id']]);
1622 return $activity['id'];
1626 * Test if incoming relay messages should be accepted
1628 * @param array $activity activity array
1629 * @param string $id object ID
1630 * @return boolean true if message is accepted
1632 private static function acceptIncomingMessage(array $activity, string $id): bool
1634 if (empty($activity['as:object'])) {
1635 Logger::info('No object field in activity - accepted', ['id' => $id]);
1639 $replyto = JsonLD::fetchElement($activity['as:object'], 'as:inReplyTo', '@id');
1640 $uriid = ItemURI::getIdByURI($replyto ?? '');
1641 if (Post::exists(['uri-id' => $uriid])) {
1642 Logger::info('Post is a reply to an existing post - accepted', ['id' => $id, 'uri-id' => $uriid, 'replyto' => $replyto]);
1646 $attributed_to = JsonLD::fetchElement($activity['as:object'], 'as:attributedTo', '@id');
1647 $authorid = Contact::getIdForURL($attributed_to);
1649 $content = JsonLD::fetchElement($activity['as:object'], 'as:name', '@value') ?? '';
1650 $content .= ' ' . JsonLD::fetchElement($activity['as:object'], 'as:summary', '@value') ?? '';
1651 $content .= ' ' . HTML::toBBCode(JsonLD::fetchElement($activity['as:object'], 'as:content', '@value') ?? '');
1653 $attachments = JsonLD::fetchElementArray($activity['as:object'], 'as:attachment') ?? [];
1654 foreach ($attachments as $media) {
1655 if (!empty($media['as:summary'])) {
1656 $content .= ' ' . JsonLD::fetchElement($media, 'as:summary', '@value');
1658 if (!empty($media['as:name'])) {
1659 $content .= ' ' . JsonLD::fetchElement($media, 'as:name', '@value');
1664 $tags = Receiver::processTags(JsonLD::fetchElementArray($activity['as:object'], 'as:tag') ?? []);
1665 if (!empty($tags)) {
1666 foreach ($tags as $tag) {
1667 if (($tag['type'] != 'Hashtag') && !strpos($tag['type'], ':Hashtag')) {
1670 $messageTags[] = ltrim(mb_strtolower($tag['name']), '#');
1674 return Relay::isSolicitedPost($messageTags, $content, $authorid, $id, Protocol::ACTIVITYPUB, $activity['thread-completion'] ?? 0);
1678 * perform a "follow" request
1680 * @param array $activity
1682 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1683 * @throws \ImagickException
1685 public static function followUser(array $activity)
1687 $uid = User::getIdForURL($activity['object_id']);
1689 Queue::remove($activity);
1693 $owner = User::getOwnerDataById($uid);
1694 if (empty($owner)) {
1698 $cid = Contact::getIdForURL($activity['actor'], $uid);
1700 self::switchContact($cid);
1701 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1705 'author-id' => Contact::getIdForURL($activity['actor']),
1706 'author-link' => $activity['actor'],
1709 // Ensure that the contact has got the right network type
1710 self::switchContact($item['author-id']);
1712 $result = Contact::addRelationship($owner, [], $item, false, $activity['content'] ?? '');
1713 if ($result === true) {
1714 ActivityPub\Transmitter::sendContactAccept($item['author-link'], $activity['id'], $owner['uid']);
1717 $cid = Contact::getIdForURL($activity['actor'], $uid);
1722 if ($result && DI::config()->get('system', 'transmit_pending_events') && ($owner['contact-type'] == Contact::TYPE_COMMUNITY)) {
1723 self::transmitPendingEvents($cid, $owner['uid']);
1726 if (empty($contact)) {
1727 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1729 Logger::notice('Follow user ' . $uid . ' from contact ' . $cid . ' with id ' . $activity['id']);
1730 Queue::remove($activity);
1734 * Transmit pending events to the new follower
1736 * @param integer $cid Contact id
1737 * @param integer $uid User id
1740 private static function transmitPendingEvents(int $cid, int $uid)
1742 $account = DBA::selectFirst('account-user-view', ['ap-inbox', 'ap-sharedinbox'], ['id' => $cid]);
1743 $inbox = $account['ap-sharedinbox'] ?: $account['ap-inbox'];
1745 $events = DBA::select('event', ['id'], ["`uid` = ? AND `start` > ? AND `type` != ?", $uid, DateTimeFormat::utcNow(), 'birthday']);
1746 while ($event = DBA::fetch($events)) {
1747 $post = Post::selectFirst(['id', 'uri-id', 'created'], ['event-id' => $event['id']]);
1751 if (DI::config()->get('system', 'bulk_delivery')) {
1752 Post\Delivery::add($post['uri-id'], $uid, $inbox, $post['created'], Delivery::POST, [$cid]);
1753 Worker::add(Worker::PRIORITY_HIGH, 'APDelivery', '', 0, $inbox, 0);
1755 Worker::add(Worker::PRIORITY_HIGH, 'APDelivery', Delivery::POST, $post['id'], $inbox, $uid, [$cid], $post['uri-id']);
1761 * Update the given profile
1763 * @param array $activity
1764 * @throws \Exception
1766 public static function updatePerson(array $activity)
1768 if (empty($activity['object_id'])) {
1772 Logger::info('Updating profile', ['object' => $activity['object_id']]);
1773 Contact::updateFromProbeByURL($activity['object_id']);
1774 Queue::remove($activity);
1778 * Delete the given profile
1780 * @param array $activity
1782 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1784 public static function deletePerson(array $activity)
1786 if (empty($activity['object_id']) || empty($activity['actor'])) {
1787 Logger::info('Empty object id or actor.');
1788 Queue::remove($activity);
1792 if ($activity['object_id'] != $activity['actor']) {
1793 Logger::info('Object id does not match actor.');
1794 Queue::remove($activity);
1798 $contacts = DBA::select('contact', ['id'], ['nurl' => Strings::normaliseLink($activity['object_id'])]);
1799 while ($contact = DBA::fetch($contacts)) {
1800 Contact::remove($contact['id']);
1802 DBA::close($contacts);
1804 Logger::info('Deleted contact', ['object' => $activity['object_id']]);
1805 Queue::remove($activity);
1809 * Add moved contacts as followers for all subscribers of the old contact
1811 * @param array $activity
1813 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1815 public static function movePerson(array $activity)
1817 if (empty($activity['target_id']) || empty($activity['object_id'])) {
1818 Queue::remove($activity);
1822 if ($activity['object_id'] != $activity['actor']) {
1823 Logger::notice('Object is not the actor', ['activity' => $activity]);
1824 Queue::remove($activity);
1828 $from = Contact::getByURL($activity['object_id'], false, ['uri-id']);
1829 if (empty($from['uri-id'])) {
1830 Logger::info('Object not found', ['activity' => $activity]);
1831 Queue::remove($activity);
1835 $contacts = DBA::select('contact', ['uid', 'url'], ["`uri-id` = ? AND `uid` != ? AND `rel` IN (?, ?)", $from['uri-id'], 0, Contact::FRIEND, Contact::SHARING]);
1836 while ($from_contact = DBA::fetch($contacts)) {
1837 $result = Contact::createFromProbeForUser($from_contact['uid'], $activity['target_id']);
1838 Logger::debug('Follower added', ['from' => $from_contact, 'result' => $result]);
1840 DBA::close($contacts);
1841 Queue::remove($activity);
1845 * Blocks the user by the contact
1847 * @param array $activity
1849 * @throws \Exception
1851 public static function blockAccount(array $activity)
1853 $cid = Contact::getIdForURL($activity['actor']);
1858 $uid = User::getIdForURL($activity['object_id']);
1863 Contact\User::setIsBlocked($cid, $uid, true);
1865 Logger::info('Contact blocked user', ['contact' => $cid, 'user' => $uid]);
1866 Queue::remove($activity);
1870 * Unblocks the user by the contact
1872 * @param array $activity
1874 * @throws \Exception
1876 public static function unblockAccount(array $activity)
1878 $cid = Contact::getIdForURL($activity['actor']);
1883 $uid = User::getIdForURL($activity['object_object']);
1888 Contact\User::setIsBlocked($cid, $uid, false);
1890 Logger::info('Contact unblocked user', ['contact' => $cid, 'user' => $uid]);
1891 Queue::remove($activity);
1897 * @param array $activity
1899 * @throws \Exception
1901 public static function ReportAccount(array $activity)
1903 $account = Contact::getByURL($activity['object_id'], null, ['id', 'gsid']);
1904 if (empty($account)) {
1905 Logger::info('Unknown account', ['activity' => $activity]);
1906 Queue::remove($activity);
1910 $reporter_id = Contact::getIdForURL($activity['actor']);
1911 if (empty($reporter_id)) {
1912 Logger::info('Unknown actor', ['activity' => $activity]);
1913 Queue::remove($activity);
1918 foreach ($activity['object_ids'] as $status_id) {
1919 $post = Post::selectFirst(['uri-id'], ['uri' => $status_id]);
1920 if (!empty($post['uri-id'])) {
1921 $uri_ids[] = $post['uri-id'];
1925 $report = DI::reportFactory()->createFromReportsRequest(System::getRules(true), $reporter_id, $account['id'], $account['gsid'], $activity['content'], 'other', false, $uri_ids);
1926 DI::report()->save($report);
1928 Logger::info('Stored report', ['reporter' => $reporter_id, 'account' => $account, 'comment' => $activity['content'], 'object_ids' => $activity['object_ids']]);
1932 * Accept a follow request
1934 * @param array $activity
1935 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1936 * @throws \ImagickException
1938 public static function acceptFollowUser(array $activity)
1940 if (!empty($activity['object_actor'])) {
1941 $uid = User::getIdForURL($activity['object_actor']);
1943 } elseif (!empty($activity['receiver']) && (count($activity['receiver']) == 1)) {
1944 $uid = array_shift($activity['receiver']);
1949 Logger::notice('User could not be detected', ['activity' => $activity]);
1950 Queue::remove($activity);
1954 $cid = Contact::getIdForURL($activity['actor'], $uid);
1956 Logger::notice('No contact found', ['actor' => $activity['actor']]);
1957 Queue::remove($activity);
1961 $id = Transmitter::activityIDFromContact($cid);
1962 if ($id == $activity['object_id']) {
1963 Logger::info('Successful id check', ['uid' => $uid, 'cid' => $cid]);
1965 Logger::info('Unsuccessful id check', ['uid' => $uid, 'cid' => $cid, 'id' => $id, 'object_id' => $activity['object_id']]);
1967 Queue::remove($activity);
1972 self::switchContact($cid);
1974 $fields = ['pending' => false];
1976 $contact = DBA::selectFirst('contact', ['rel'], ['id' => $cid]);
1977 if ($contact['rel'] == Contact::FOLLOWER) {
1978 $fields['rel'] = Contact::FRIEND;
1981 $condition = ['id' => $cid];
1982 Contact::update($fields, $condition);
1983 Logger::info('Accept contact request', ['contact' => $cid, 'user' => $uid]);
1984 Queue::remove($activity);
1988 * Reject a follow request
1990 * @param array $activity
1991 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1992 * @throws \ImagickException
1994 public static function rejectFollowUser(array $activity)
1996 $uid = User::getIdForURL($activity['object_actor']);
2001 $cid = Contact::getIdForURL($activity['actor'], $uid);
2003 Logger::info('No contact found', ['actor' => $activity['actor']]);
2007 self::switchContact($cid);
2009 $contact = Contact::getById($cid, ['rel']);
2010 if ($contact['rel'] == Contact::SHARING) {
2011 Contact::remove($cid);
2012 Logger::info('Rejected contact request - contact removed', ['contact' => $cid, 'user' => $uid]);
2013 } elseif ($contact['rel'] == Contact::FRIEND) {
2014 Contact::update(['rel' => Contact::FOLLOWER], ['id' => $cid]);
2016 Logger::info('Rejected contact request', ['contact' => $cid, 'user' => $uid]);
2018 Queue::remove($activity);
2022 * Undo activity like "like" or "dislike"
2024 * @param array $activity
2025 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2026 * @throws \ImagickException
2028 public static function undoActivity(array $activity)
2030 if (empty($activity['object_id'])) {
2034 if (empty($activity['object_actor'])) {
2038 $author_id = Contact::getIdForURL($activity['object_actor']);
2039 if (empty($author_id)) {
2043 Item::markForDeletion(['uri' => $activity['object_id'], 'author-id' => $author_id, 'gravity' => Item::GRAVITY_ACTIVITY]);
2044 Queue::remove($activity);
2048 * Activity to remove a follower
2050 * @param array $activity
2051 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2052 * @throws \ImagickException
2054 public static function undoFollowUser(array $activity)
2056 $uid = User::getIdForURL($activity['object_object']);
2061 $owner = User::getOwnerDataById($uid);
2062 if (empty($owner)) {
2066 $cid = Contact::getIdForURL($activity['actor'], $uid);
2068 Logger::info('No contact found', ['actor' => $activity['actor']]);
2072 self::switchContact($cid);
2074 $contact = DBA::selectFirst('contact', [], ['id' => $cid]);
2075 if (!DBA::isResult($contact)) {
2079 Contact::removeFollower($contact);
2080 Logger::info('Undo following request', ['contact' => $cid, 'user' => $uid]);
2081 Queue::remove($activity);
2085 * Switches a contact to AP if needed
2087 * @param integer $cid Contact ID
2089 * @throws \Exception
2091 private static function switchContact(int $cid)
2093 $contact = DBA::selectFirst('contact', ['network', 'url'], ['id' => $cid]);
2094 if (!DBA::isResult($contact) || in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN]) || Contact::isLocal($contact['url'])) {
2098 Logger::info('Change existing contact', ['cid' => $cid, 'previous' => $contact['network']]);
2099 Contact::updateFromProbe($cid);
2103 * Collects implicit mentions like:
2104 * - the author of the parent item
2105 * - all the mentioned conversants in the parent item
2107 * @param array $parent Item array with at least ['id', 'author-link', 'alias']
2109 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2111 private static function getImplicitMentionList(array $parent): array
2113 $parent_terms = Tag::getByURIId($parent['uri-id'], [Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION]);
2115 $parent_author = Contact::getByURL($parent['author-link'], false, ['url', 'nurl', 'alias']);
2117 $implicit_mentions = [];
2118 if (empty($parent_author['url'])) {
2119 Logger::notice('Author public contact unknown.', ['author-link' => $parent['author-link'], 'parent-id' => $parent['id']]);
2121 $implicit_mentions[] = $parent_author['url'];
2122 $implicit_mentions[] = $parent_author['nurl'];
2123 $implicit_mentions[] = $parent_author['alias'];
2126 if (!empty($parent['alias'])) {
2127 $implicit_mentions[] = $parent['alias'];
2130 foreach ($parent_terms as $term) {
2131 $contact = Contact::getByURL($term['url'], false, ['url', 'nurl', 'alias']);
2132 if (!empty($contact['url'])) {
2133 $implicit_mentions[] = $contact['url'];
2134 $implicit_mentions[] = $contact['nurl'];
2135 $implicit_mentions[] = $contact['alias'];
2139 return $implicit_mentions;
2143 * Strips from the body prepended implicit mentions
2145 * @param string $body
2146 * @param array $parent
2149 private static function removeImplicitMentionsFromBody(string $body, array $parent): string
2151 if (DI::config()->get('system', 'disable_implicit_mentions')) {
2155 $potential_mentions = self::getImplicitMentionList($parent);
2157 $kept_mentions = [];
2159 // Extract one prepended mention at a time from the body
2160 while(preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $body, $matches)) {
2161 if (!in_array($matches[2], $potential_mentions)) {
2162 $kept_mentions[] = $matches[1];
2165 $body = $matches[3];
2168 // Re-appending the kept mentions to the body after extraction
2169 $kept_mentions[] = $body;
2171 return implode('', $kept_mentions);
2175 * Adds links to string mentions
2177 * @param string $body
2178 * @param array $tags
2181 protected static function addMentionLinks(string $body, array $tags): string
2183 // This prevents links to be added again to Pleroma-style mention links
2184 $body = self::normalizeMentionLinks($body);
2186 $body = BBCode::performWithEscapedTags($body, ['url'], function ($body) use ($tags) {
2187 foreach ($tags as $tag) {
2188 if (empty($tag['name']) || empty($tag['type']) || empty($tag['href']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
2192 $hash = substr($tag['name'], 0, 1);
2193 $name = substr($tag['name'], 1);
2194 if (!in_array($hash, Tag::TAG_CHARACTER)) {
2196 $name = $tag['name'];
2199 if (Network::isValidHttpUrl($tag['href'])) {
2200 $body = str_replace($tag['name'], $hash . '[url=' . $tag['href'] . ']' . $name . '[/url]', $body);