3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Protocol\ActivityPub;
24 use Friendica\Content\Text\BBCode;
25 use Friendica\Content\Text\HTML;
26 use Friendica\Content\Text\Markdown;
27 use Friendica\Core\Logger;
28 use Friendica\Core\Protocol;
29 use Friendica\Core\System;
30 use Friendica\Core\Worker;
31 use Friendica\Database\DBA;
33 use Friendica\Model\APContact;
34 use Friendica\Model\Contact;
35 use Friendica\Model\Conversation;
36 use Friendica\Model\Event;
37 use Friendica\Model\GServer;
38 use Friendica\Model\Item;
39 use Friendica\Model\ItemURI;
40 use Friendica\Model\Mail;
41 use Friendica\Model\Tag;
42 use Friendica\Model\User;
43 use Friendica\Model\Post;
44 use Friendica\Protocol\Activity;
45 use Friendica\Protocol\ActivityPub;
46 use Friendica\Protocol\Relay;
47 use Friendica\Util\DateTimeFormat;
48 use Friendica\Util\JsonLD;
49 use Friendica\Util\Strings;
50 use Friendica\Worker\Delivery;
53 * ActivityPub Processor Protocol class
58 * Extracts the tag character (#, @, !) from mention links
63 protected static function normalizeMentionLinks(string $body): string
65 return preg_replace('%\[url=([^\[\]]*)]([#@!])(.*?)\[/url]%ism', '$2[url=$1]$3[/url]', $body);
69 * Convert the language array into a language JSON
71 * @param array $languages
72 * @return string language JSON
74 private static function processLanguages(array $languages): string
76 $codes = array_keys($languages);
78 foreach ($codes as $code) {
86 return json_encode($lang);
89 * Replaces emojis in the body
93 * @param array $emojis
95 * @return string with replaced emojis
97 private static function replaceEmojis(int $uri_id, string $body, array $emojis): string
101 array_column($emojis, 'name'),
102 array_map(function ($emoji) {
103 return '[emoji=' . $emoji['href'] . ']' . $emoji['name'] . '[/emoji]';
108 // We store the emoji here to be able to avoid storing it in the media
109 foreach ($emojis as $emoji) {
110 Post\Link::getByLink($uri_id, $emoji['href']);
116 * Store attached media files in the post-media table
119 * @param array $attachment
122 private static function storeAttachmentAsMedia(int $uriid, array $attachment)
124 if (empty($attachment['url'])) {
128 $data = ['uri-id' => $uriid];
129 $data['type'] = Post\Media::UNKNOWN;
130 $data['url'] = $attachment['url'];
131 $data['mimetype'] = $attachment['mediaType'] ?? null;
132 $data['height'] = $attachment['height'] ?? null;
133 $data['width'] = $attachment['width'] ?? null;
134 $data['size'] = $attachment['size'] ?? null;
135 $data['preview'] = $attachment['image'] ?? null;
136 $data['description'] = $attachment['name'] ?? null;
138 Post\Media::insert($data);
142 * Stire attachment data
144 * @param array $activity
147 private static function storeAttachments(array $activity, array $item)
149 if (empty($activity['attachments'])) {
153 foreach ($activity['attachments'] as $attach) {
154 self::storeAttachmentAsMedia($item['uri-id'], $attach);
159 * Store attachment data
161 * @param array $activity
164 private static function storeQuestion(array $activity, array $item)
166 if (empty($activity['question'])) {
169 $question = ['multiple' => $activity['question']['multiple']];
171 if (!empty($activity['question']['voters'])) {
172 $question['voters'] = $activity['question']['voters'];
175 if (!empty($activity['question']['end-time'])) {
176 $question['end-time'] = DateTimeFormat::utc($activity['question']['end-time']);
179 Post\Question::update($item['uri-id'], $question);
181 foreach ($activity['question']['options'] as $key => $option) {
182 $option = ['name' => $option['name'], 'replies' => $option['replies']];
183 Post\QuestionOption::update($item['uri-id'], $key, $option);
186 Logger::debug('Storing incoming question', ['type' => $activity['type'], 'uri-id' => $item['uri-id'], 'question' => $activity['question']]);
192 * @param array $activity Activity array
193 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
194 * @throws \ImagickException
196 public static function updateItem(array $activity)
198 $item = Post::selectFirst(['uri', 'uri-id', 'thr-parent', 'gravity', 'post-type'], ['uri' => $activity['id']]);
199 if (!DBA::isResult($item)) {
200 Logger::warning('No existing item, item will be created', ['uri' => $activity['id']]);
201 $item = self::createItem($activity);
206 self::postItem($activity, $item);
210 $item['changed'] = DateTimeFormat::utcNow();
211 $item['edited'] = DateTimeFormat::utc($activity['updated']);
213 $item = self::processContent($activity, $item);
215 self::storeAttachments($activity, $item);
216 self::storeQuestion($activity, $item);
222 Post\History::add($item['uri-id'], $item);
223 Item::update($item, ['uri' => $activity['id']]);
225 Queue::remove($activity);
227 if ($activity['object_type'] == 'as:Event') {
228 $posts = Post::select(['event-id', 'uid'], ["`uri` = ? AND `event-id` > ?", $activity['id'], 0]);
229 while ($post = DBA::fetch($posts)) {
230 self::updateEvent($post['event-id'], $activity);
236 * Update an existing event
238 * @param int $event_id
239 * @param array $activity
241 private static function updateEvent(int $event_id, array $activity)
243 $event = DBA::selectFirst('event', [], ['id' => $event_id]);
245 $event['edited'] = DateTimeFormat::utc($activity['updated']);
246 $event['summary'] = HTML::toBBCode($activity['name']);
247 $event['desc'] = HTML::toBBCode($activity['content']);
248 if (!empty($activity['start-time'])) {
249 $event['start'] = DateTimeFormat::utc($activity['start-time']);
251 if (!empty($activity['end-time'])) {
252 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
254 $event['nofinish'] = empty($event['finish']);
255 $event['location'] = $activity['location'];
257 Logger::info('Updating event', ['uri' => $activity['id'], 'id' => $event_id]);
258 Event::store($event);
262 * Prepares data for a message
264 * @param array $activity Activity array
265 * @return array Internal item
266 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
267 * @throws \ImagickException
269 public static function createItem(array $activity): array
272 $item['verb'] = Activity::POST;
273 $item['thr-parent'] = $activity['reply-to-id'];
275 if ($activity['reply-to-id'] == $activity['id']) {
276 $item['gravity'] = GRAVITY_PARENT;
277 $item['object-type'] = Activity\ObjectType::NOTE;
279 $item['gravity'] = GRAVITY_COMMENT;
280 $item['object-type'] = Activity\ObjectType::COMMENT;
283 if (empty($activity['directmessage']) && ($activity['id'] != $activity['reply-to-id']) && !Post::exists(['uri' => $activity['reply-to-id']])) {
284 $recursion_depth = $activity['recursion-depth'] ?? 0;
285 Logger::notice('Parent not found. Try to refetch it.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
286 if ($recursion_depth < 10) {
287 $result = self::fetchMissingActivity($activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
288 $fetch_by_worker = empty($result);
290 Logger::notice('Recursion level is too high.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
291 $fetch_by_worker = true;
294 if ($fetch_by_worker) {
295 Logger::notice('Fetching is done by worker.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
296 $activity['recursion-depth'] = 0;
297 $wid = Worker::add(PRIORITY_HIGH, 'FetchMissingActivity', $activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
298 Queue::setWorkerId($activity, $wid);
303 $item['diaspora_signed_text'] = $activity['diaspora:comment'] ?? '';
305 /// @todo What to do with $activity['context']?
306 if (empty($activity['directmessage']) && ($item['gravity'] != GRAVITY_PARENT) && !Post::exists(['uri' => $item['thr-parent']])) {
307 Logger::info('Parent not found, message will be discarded.', ['thr-parent' => $item['thr-parent']]);
311 $item['network'] = Protocol::ACTIVITYPUB;
312 $item['author-link'] = $activity['author'];
313 $item['author-id'] = Contact::getIdForURL($activity['author']);
314 $item['owner-link'] = $activity['actor'];
315 $item['owner-id'] = Contact::getIdForURL($activity['actor']);
317 if (in_array(0, $activity['receiver']) && !empty($activity['unlisted'])) {
318 $item['private'] = Item::UNLISTED;
319 } elseif (in_array(0, $activity['receiver'])) {
320 $item['private'] = Item::PUBLIC;
322 $item['private'] = Item::PRIVATE;
325 if (!empty($activity['raw'])) {
326 $item['source'] = $activity['raw'];
327 $item['protocol'] = Conversation::PARCEL_ACTIVITYPUB;
328 $item['conversation-href'] = $activity['context'] ?? '';
329 $item['conversation-uri'] = $activity['conversation'] ?? '';
331 if (isset($activity['push'])) {
332 $item['direction'] = $activity['push'] ? Conversation::PUSH : Conversation::PULL;
336 if (!empty($activity['from-relay'])) {
337 $item['direction'] = Conversation::RELAY;
340 if ($activity['object_type'] == 'as:Article') {
341 $item['post-type'] = Item::PT_ARTICLE;
342 } elseif ($activity['object_type'] == 'as:Audio') {
343 $item['post-type'] = Item::PT_AUDIO;
344 } elseif ($activity['object_type'] == 'as:Document') {
345 $item['post-type'] = Item::PT_DOCUMENT;
346 } elseif ($activity['object_type'] == 'as:Event') {
347 $item['post-type'] = Item::PT_EVENT;
348 } elseif ($activity['object_type'] == 'as:Image') {
349 $item['post-type'] = Item::PT_IMAGE;
350 } elseif ($activity['object_type'] == 'as:Page') {
351 $item['post-type'] = Item::PT_PAGE;
352 } elseif ($activity['object_type'] == 'as:Question') {
353 $item['post-type'] = Item::PT_POLL;
354 } elseif ($activity['object_type'] == 'as:Video') {
355 $item['post-type'] = Item::PT_VIDEO;
357 $item['post-type'] = Item::PT_NOTE;
360 $item['isForum'] = false;
362 if (!empty($activity['thread-completion'])) {
363 if ($activity['thread-completion'] != $item['owner-id']) {
364 $actor = Contact::getById($activity['thread-completion'], ['url']);
365 $item['causer-link'] = $actor['url'];
366 $item['causer-id'] = $activity['thread-completion'];
367 Logger::info('Use inherited actor as causer.', ['id' => $item['owner-id'], 'activity' => $activity['thread-completion'], 'owner' => $item['owner-link'], 'actor' => $actor['url']]);
369 // Store the original actor in the "causer" fields to enable the check for ignored or blocked contacts
370 $item['causer-link'] = $item['owner-link'];
371 $item['causer-id'] = $item['owner-id'];
372 Logger::info('Use actor as causer.', ['id' => $item['owner-id'], 'actor' => $item['owner-link']]);
375 $item['owner-link'] = $item['author-link'];
376 $item['owner-id'] = $item['author-id'];
378 $actor = APContact::getByURL($item['owner-link'], false);
379 $item['isForum'] = ($actor['type'] == 'Group');
382 $item['uri'] = $activity['id'];
384 if (empty($activity['published']) || empty($activity['updated'])) {
385 DI::logger()->notice('published or updated keys are empty for activity', ['activity' => $activity, 'callstack' => System::callstack(10)]);
388 $item['created'] = DateTimeFormat::utc($activity['published'] ?? 'now');
389 $item['edited'] = DateTimeFormat::utc($activity['updated'] ?? 'now');
390 $guid = $activity['sc:identifier'] ?: self::getGUIDByURL($item['uri']);
391 $item['guid'] = $activity['diaspora:guid'] ?: $guid;
393 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
394 if (empty($item['uri-id'])) {
395 Logger::warning('Unable to get a uri-id for an item uri', ['uri' => $item['uri'], 'guid' => $item['guid']]);
399 $item = self::processContent($activity, $item);
401 Logger::info('Message was not processed');
405 $item['plink'] = $activity['alternate-url'] ?? $item['uri'];
407 self::storeAttachments($activity, $item);
408 self::storeQuestion($activity, $item);
410 // We received the post via AP, so we set the protocol of the server to AP
411 $contact = Contact::getById($item['author-id'], ['gsid']);
412 if (!empty($contact['gsid'])) {
413 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
416 if ($item['author-id'] != $item['owner-id']) {
417 $contact = Contact::getById($item['owner-id'], ['gsid']);
418 if (!empty($contact['gsid'])) {
419 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
429 * @param array $activity
430 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
431 * @throws \ImagickException
433 public static function deleteItem(array $activity)
435 $owner = Contact::getIdForURL($activity['actor']);
437 Logger::info('Deleting item', ['object' => $activity['object_id'], 'owner' => $owner]);
438 Item::markForDeletion(['uri' => $activity['object_id'], 'owner-id' => $owner]);
439 Queue::remove($activity);
443 * Prepare the item array for an activity
445 * @param array $activity Activity array
446 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
447 * @throws \ImagickException
449 public static function addTag(array $activity)
451 if (empty($activity['object_content']) || empty($activity['object_id'])) {
455 foreach ($activity['receiver'] as $receiver) {
456 $item = Post::selectFirst(['id', 'uri-id', 'origin', 'author-link'], ['uri' => $activity['target_id'], 'uid' => $receiver]);
457 if (!DBA::isResult($item)) {
458 // We don't fetch missing content for this purpose
462 if (($item['author-link'] != $activity['actor']) && !$item['origin']) {
463 Logger::info('Not origin, not from the author, skipping update', ['id' => $item['id'], 'author' => $item['author-link'], 'actor' => $activity['actor']]);
467 Tag::store($item['uri-id'], Tag::HASHTAG, $activity['object_content'], $activity['object_id']);
468 Logger::info('Tagged item', ['id' => $item['id'], 'tag' => $activity['object_content'], 'uri' => $activity['target_id'], 'actor' => $activity['actor']]);
473 * Prepare the item array for an activity
475 * @param array $activity Activity array
476 * @param string $verb Activity verb
477 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
478 * @throws \ImagickException
480 public static function createActivity(array $activity, string $verb)
482 $item = self::createItem($activity);
487 $item['verb'] = $verb;
488 $item['thr-parent'] = $activity['object_id'];
489 $item['gravity'] = GRAVITY_ACTIVITY;
490 unset($item['post-type']);
491 $item['object-type'] = Activity\ObjectType::NOTE;
493 if (!empty($activity['content'])) {
494 $item['body'] = HTML::toBBCode($activity['content']);
497 $item['diaspora_signed_text'] = $activity['diaspora:like'] ?? '';
499 self::postItem($activity, $item);
503 * Fetch the Uri-Id of a post for the "featured" collection
505 * @param array $activity
508 private static function getUriIdForFeaturedCollection(array $activity)
510 $actor = APContact::getByURL($activity['actor']);
515 // Refetch the account when the "featured" collection is missing.
516 // This can be removed in a future version (end of 2022 should be good).
517 if (empty($actor['featured'])) {
518 $actor = APContact::getByURL($activity['actor'], true);
524 if ($activity['target_id'] != $actor['featured']) {
528 $id = Contact::getIdForURL($activity['actor']);
533 $parent = Post::selectFirst(['uri-id'], ['uri' => $activity['object_id'], 'author-id' => $id]);
534 if (!empty($parent['uri-id'])) {
535 return $parent['uri-id'];
542 * Add a post to the "Featured" collection
544 * @param array $activity
546 public static function addToFeaturedCollection(array $activity)
548 $uriid = self::getUriIdForFeaturedCollection($activity);
553 Logger::debug('Add post to featured collection', ['uri-id' => $uriid]);
555 Post\Collection::add($uriid, Post\Collection::FEATURED);
556 Queue::remove($activity);
560 * Remove a post to the "Featured" collection
562 * @param array $activity
564 public static function removeFromFeaturedCollection(array $activity)
566 $uriid = self::getUriIdForFeaturedCollection($activity);
571 Logger::debug('Remove post from featured collection', ['uri-id' => $uriid]);
573 Post\Collection::remove($uriid, Post\Collection::FEATURED);
574 Queue::remove($activity);
580 * @param array $activity Activity array
583 * @return int event id
586 public static function createEvent(array $activity, array $item): int
588 $event['summary'] = HTML::toBBCode($activity['name'] ?: $activity['summary']);
589 $event['desc'] = HTML::toBBCode($activity['content']);
590 if (!empty($activity['start-time'])) {
591 $event['start'] = DateTimeFormat::utc($activity['start-time']);
593 if (!empty($activity['end-time'])) {
594 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
596 $event['nofinish'] = empty($event['finish']);
597 $event['location'] = $activity['location'];
598 $event['cid'] = $item['contact-id'];
599 $event['uid'] = $item['uid'];
600 $event['uri'] = $item['uri'];
601 $event['edited'] = $item['edited'];
602 $event['private'] = $item['private'];
603 $event['guid'] = $item['guid'];
604 $event['plink'] = $item['plink'];
605 $event['network'] = $item['network'];
606 $event['protocol'] = $item['protocol'];
607 $event['direction'] = $item['direction'];
608 $event['source'] = $item['source'];
610 $ev = DBA::selectFirst('event', ['id'], ['uri' => $item['uri'], 'uid' => $item['uid']]);
611 if (DBA::isResult($ev)) {
612 $event['id'] = $ev['id'];
615 $event_id = Event::store($event);
617 Logger::info('Event was stored', ['id' => $event_id]);
623 * Process the content
625 * @param array $activity Activity array
627 * @return array|bool Returns the item array or false if there was an unexpected occurrence
630 private static function processContent(array $activity, array $item)
632 if (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/markdown')) {
633 $item['title'] = strip_tags($activity['name']);
634 $content = Markdown::toBBCode($activity['content']);
635 } elseif (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/bbcode')) {
636 $item['title'] = $activity['name'];
637 $content = $activity['content'];
639 // By default assume "text/html"
640 $item['title'] = HTML::toBBCode($activity['name'] ?? '');
641 $content = HTML::toBBCode($activity['content'] ?? '');
644 $item['title'] = trim(BBCode::toPlaintext($item['title']));
646 if (!empty($activity['languages'])) {
647 $item['language'] = self::processLanguages($activity['languages']);
650 if (!empty($activity['emojis'])) {
651 $content = self::replaceEmojis($item['uri-id'], $content, $activity['emojis']);
654 $content = self::addMentionLinks($content, $activity['tags']);
656 if (!empty($activity['source'])) {
657 $item['body'] = $activity['source'];
658 $item['raw-body'] = $content;
659 $item['body'] = Item::improveSharedDataInBody($item);
661 if (empty($activity['directmessage']) && ($item['thr-parent'] != $item['uri']) && ($item['gravity'] == GRAVITY_COMMENT)) {
662 $parent = Post::selectFirst(['id', 'uri-id', 'private', 'author-link', 'alias'], ['uri' => $item['thr-parent']]);
663 if (!DBA::isResult($parent)) {
664 Logger::warning('Unknown parent item.', ['uri' => $item['thr-parent']]);
667 if (($parent['private'] == Item::PRIVATE) && ($parent['private'] != Item::PRIVATE)) {
668 Logger::warning('Item is private but the parent is not. Dropping.', ['item-uri' => $item['uri'], 'thr-parent' => $item['thr-parent']]);
672 $content = self::removeImplicitMentionsFromBody($content, $parent);
674 $item['content-warning'] = HTML::toBBCode($activity['summary'] ?? '');
675 $item['raw-body'] = $item['body'] = $content;
678 self::storeFromBody($item);
679 self::storeTags($item['uri-id'], $activity['tags']);
681 self::storeReceivers($item['uri-id'], $activity['receiver_urls'] ?? []);
683 $item['location'] = $activity['location'];
685 if (!empty($activity['latitude']) && !empty($activity['longitude'])) {
686 $item['coord'] = $activity['latitude'] . ' ' . $activity['longitude'];
689 $item['app'] = $activity['generator'];
695 * Store hashtags and mentions
699 private static function storeFromBody(array $item)
701 // Make sure to delete all existing tags (can happen when called via the update functionality)
702 DBA::delete('post-tag', ['uri-id' => $item['uri-id']]);
704 Tag::storeFromBody($item['uri-id'], $item['body'], '@!');
708 * Generate a GUID out of an URL of an ActivityPub post.
710 * @param string $url message URL
711 * @return string with GUID
713 private static function getGUIDByURL(string $url): string
715 $parsed = parse_url($url);
717 $host_hash = hash('crc32', $parsed['host']);
719 unset($parsed["scheme"]);
720 unset($parsed["host"]);
722 $path = implode("/", $parsed);
724 return $host_hash . '-'. hash('fnv164', $path) . '-'. hash('joaat', $path);
728 * Checks if an incoming message is wanted
730 * @param array $activity
732 * @return boolean Is the message wanted?
734 private static function isSolicitedMessage(array $activity, array $item): bool
736 // The checks are split to improve the support when searching why a message was accepted.
737 if (count($activity['receiver']) != 1) {
738 // The message has more than one receiver, so it is wanted.
739 Logger::debug('Message has got several receivers - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
743 if ($item['private'] == Item::PRIVATE) {
744 // We only look at public posts here. Private posts are expected to be intentionally posted to the single receiver.
745 Logger::debug('Message is private - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
749 if (!empty($activity['from-relay'])) {
750 // We check relay posts at another place. When it arrived here, the message is already checked.
751 Logger::debug('Message is a relay post that is already checked - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
755 if (in_array($activity['completion-mode'] ?? Receiver::COMPLETION_NONE, [Receiver::COMPLETION_MANUAL, Receiver::COMPLETION_ANNOUCE])) {
756 // Manual completions and completions caused by reshares are allowed without any further checks.
757 Logger::debug('Message is in completion mode - accepted', ['mode' => $activity['completion-mode'], 'uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
761 if ($item['gravity'] != GRAVITY_PARENT) {
762 // We cannot reliably check at this point if a comment or activity belongs to an accepted post or needs to be fetched
763 // This can possibly be improved in the future.
764 Logger::debug('Message is no parent - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
768 $tags = array_column(Tag::getByURIId($item['uri-id'], [Tag::HASHTAG]), 'name');
769 if (Relay::isSolicitedPost($tags, $item['body'], $item['author-id'], $item['uri'], Protocol::ACTIVITYPUB)) {
770 Logger::debug('Post is accepted because of the relay settings', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
778 * Creates an item post
780 * @param array $activity Activity data
781 * @param array $item item array
782 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
783 * @throws \ImagickException
785 public static function postItem(array $activity, array $item)
793 ksort($activity['receiver']);
795 if (!self::isSolicitedMessage($activity, $item)) {
796 DBA::delete('item-uri', ['id' => $item['uri-id']]);
800 foreach ($activity['receiver'] as $receiver) {
801 if ($receiver == -1) {
805 $item['uid'] = $receiver;
807 $type = $activity['reception_type'][$receiver] ?? Receiver::TARGET_UNKNOWN;
809 case Receiver::TARGET_TO:
810 $item['post-reason'] = Item::PR_TO;
812 case Receiver::TARGET_CC:
813 $item['post-reason'] = Item::PR_CC;
815 case Receiver::TARGET_BTO:
816 $item['post-reason'] = Item::PR_BTO;
818 case Receiver::TARGET_BCC:
819 $item['post-reason'] = Item::PR_BCC;
821 case Receiver::TARGET_FOLLOWER:
822 $item['post-reason'] = Item::PR_FOLLOWER;
824 case Receiver::TARGET_ANSWER:
825 $item['post-reason'] = Item::PR_COMMENT;
827 case Receiver::TARGET_GLOBAL:
828 $item['post-reason'] = Item::PR_GLOBAL;
831 $item['post-reason'] = Item::PR_NONE;
834 if (!empty($activity['from-relay'])) {
835 $item['post-reason'] = Item::PR_RELAY;
836 } elseif (!empty($activity['thread-completion'])) {
837 $item['post-reason'] = Item::PR_FETCHED;
840 if ($item['isForum'] ?? false) {
841 $item['contact-id'] = Contact::getIdForURL($activity['actor'], $receiver);
843 $item['contact-id'] = Contact::getIdForURL($activity['author'], $receiver);
846 if (($receiver != 0) && empty($item['contact-id'])) {
847 $item['contact-id'] = Contact::getIdForURL($activity['author']);
850 if (!empty($activity['directmessage'])) {
851 self::postMail($activity, $item);
855 if (!($item['isForum'] ?? false) && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT) && !Contact::isSharingByURL($activity['author'], $receiver)) {
856 if ($item['post-reason'] == Item::PR_BCC) {
857 Logger::info('Top level post via BCC from a non sharer, ignoring', ['uid' => $receiver, 'contact' => $item['contact-id']]);
862 !empty($activity['thread-children-type'])
863 && in_array($activity['thread-children-type'], Receiver::ACTIVITY_TYPES)
864 && DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') != Item::COMPLETION_LIKE
866 Logger::info('Top level post from thread completion from a non sharer had been initiated via an activity, ignoring',
867 ['type' => $activity['thread-children-type'], 'user' => $item['uid'], 'causer' => $item['causer-link'], 'author' => $activity['author'], 'url' => $item['uri']]);
874 if ($receiver != 0) {
875 $user = User::getById($receiver, ['account-type']);
876 if (!empty($user['account-type'])) {
877 $is_forum = ($user['account-type'] == User::ACCOUNT_TYPE_COMMUNITY);
881 if (!$is_forum && DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') == Item::COMPLETION_NONE && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT)) {
882 $skip = !Contact::isSharingByURL($activity['author'], $receiver);
884 if ($skip && (($activity['type'] == 'as:Announce') || ($item['isForum'] ?? false))) {
885 $skip = !Contact::isSharingByURL($activity['actor'], $receiver);
889 Logger::info('Skipping post', ['uid' => $receiver, 'url' => $item['uri']]);
893 Logger::info('Accepting post', ['uid' => $receiver, 'url' => $item['uri']]);
896 if (($item['gravity'] != GRAVITY_ACTIVITY) && ($activity['object_type'] == 'as:Event')) {
897 $event_id = self::createEvent($activity, $item);
899 $item = Event::getItemArrayForImportedId($event_id, $item);
902 $item_id = Item::insert($item);
904 Logger::info('Item insertion successful', ['user' => $item['uid'], 'item_id' => $item_id]);
907 Logger::notice('Item insertion aborted', ['user' => $item['uid']]);
910 if ($item['uid'] == 0) {
916 Queue::remove($activity);
917 Queue::processReplyByUri($item['uri']);
920 // Store send a follow request for every reshare - but only when the item had been stored
921 if ($stored && ($item['private'] != Item::PRIVATE) && ($item['gravity'] == GRAVITY_PARENT) && !empty($item['author-link']) && ($item['author-link'] != $item['owner-link'])) {
922 $author = APContact::getByURL($item['owner-link'], false);
923 // We send automatic follow requests for reshared messages. (We don't need though for forum posts)
924 if ($author['type'] != 'Group') {
925 Logger::info('Send follow request', ['uri' => $item['uri'], 'stored' => $stored, 'to' => $item['author-link']]);
926 ActivityPub\Transmitter::sendFollowObject($item['uri'], $item['author-link']);
932 * Store tags and mentions into the tag table
934 * @param integer $uriid
937 private static function storeTags(int $uriid, array $tags = null)
939 foreach ($tags as $tag) {
940 if (empty($tag['name']) || empty($tag['type']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
944 $hash = substr($tag['name'], 0, 1);
946 if ($tag['type'] == 'Mention') {
947 if (in_array($hash, [Tag::TAG_CHARACTER[Tag::MENTION],
948 Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION],
949 Tag::TAG_CHARACTER[Tag::IMPLICIT_MENTION]])) {
950 $tag['name'] = substr($tag['name'], 1);
952 $type = Tag::IMPLICIT_MENTION;
954 if (!empty($tag['href'])) {
955 $apcontact = APContact::getByURL($tag['href']);
956 if (!empty($apcontact['name']) || !empty($apcontact['nick'])) {
957 $tag['name'] = $apcontact['name'] ?: $apcontact['nick'];
960 } elseif ($tag['type'] == 'Hashtag') {
961 if ($hash == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
962 $tag['name'] = substr($tag['name'], 1);
964 $type = Tag::HASHTAG;
967 if (empty($tag['name'])) {
971 Tag::store($uriid, $type, $tag['name'], $tag['href']);
975 public static function storeReceivers(int $uriid, array $receivers)
977 foreach (['as:to' => Tag::TO, 'as:cc' => Tag::CC, 'as:bto' => Tag::BTO, 'as:bcc' => Tag::BCC] as $element => $type) {
978 if (!empty($receivers[$element])) {
979 foreach ($receivers[$element] as $receiver) {
980 if ($receiver == ActivityPub::PUBLIC_COLLECTION) {
981 $name = Receiver::PUBLIC_COLLECTION;
983 $name = trim(parse_url($receiver, PHP_URL_PATH), '/');
986 $target = Tag::getTargetType($receiver);
987 Logger::debug('Got target type', ['type' => $target, 'url' => $receiver]);
988 Tag::store($uriid, $type, $name, $receiver, $target);
995 * Creates an mail post
997 * @param array $activity Activity data
998 * @param array $item item array
999 * @return int|bool New mail table row id or false on error
1000 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1002 private static function postMail(array $activity, array $item)
1004 if (($item['gravity'] != GRAVITY_PARENT) && !DBA::exists('mail', ['uri' => $item['thr-parent'], 'uid' => $item['uid']])) {
1005 Logger::info('Parent not found, mail will be discarded.', ['uid' => $item['uid'], 'uri' => $item['thr-parent']]);
1009 Logger::info('Direct Message', $item);
1012 $msg['uid'] = $item['uid'];
1014 $msg['contact-id'] = $item['contact-id'];
1016 $contact = Contact::getById($item['contact-id'], ['name', 'url', 'photo']);
1017 $msg['from-name'] = $contact['name'];
1018 $msg['from-url'] = $contact['url'];
1019 $msg['from-photo'] = $contact['photo'];
1021 $msg['uri'] = $item['uri'];
1022 $msg['created'] = $item['created'];
1024 $parent = DBA::selectFirst('mail', ['parent-uri', 'title'], ['uri' => $item['thr-parent']]);
1025 if (DBA::isResult($parent)) {
1026 $msg['parent-uri'] = $parent['parent-uri'];
1027 $msg['title'] = $parent['title'];
1029 $msg['parent-uri'] = $item['thr-parent'];
1031 if (!empty($item['title'])) {
1032 $msg['title'] = $item['title'];
1033 } elseif (!empty($item['content-warning'])) {
1034 $msg['title'] = $item['content-warning'];
1036 // Trying to generate a title out of the body
1037 $title = $item['body'];
1039 while (preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $title, $matches)) {
1040 $title = $matches[3];
1043 $title = trim(BBCode::toPlaintext($title));
1045 if (strlen($title) > 20) {
1046 $title = substr($title, 0, 20) . '...';
1049 $msg['title'] = $title;
1052 $msg['body'] = $item['body'];
1054 return Mail::insert($msg);
1058 * Fetch featured posts from a contact with the given url
1060 * @param string $url
1063 public static function fetchFeaturedPosts(string $url)
1065 Logger::info('Fetch featured posts', ['contact' => $url]);
1067 $apcontact = APContact::getByURL($url);
1068 if (empty($apcontact['featured'])) {
1069 Logger::info('Contact does not have a featured collection', ['contact' => $url]);
1073 $pcid = Contact::getIdForURL($url, 0, false);
1075 Logger::info('Contact not found', ['contact' => $url]);
1079 $posts = Post\Collection::selectToArrayForContact($pcid, Post\Collection::FEATURED);
1080 if (!empty($posts)) {
1081 $old_featured = array_column($posts, 'uri-id');
1086 $featured = ActivityPub::fetchItems($apcontact['featured']);
1087 if (empty($featured)) {
1088 Logger::info('Contact does not have featured posts', ['contact' => $url]);
1090 foreach ($old_featured as $uri_id) {
1091 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1092 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1100 foreach ($featured as $post) {
1101 if (empty($post['id'])) {
1104 $id = Item::fetchByLink($post['id']);
1106 $item = Post::selectFirst(['uri-id', 'featured'], ['id' => $id]);
1107 if (!empty($item['uri-id'])) {
1108 if (!$item['featured']) {
1109 Post\Collection::add($item['uri-id'], Post\Collection::FEATURED);
1110 Logger::debug('Added featured post', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1113 Logger::debug('Post already had been featured', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1117 $index = array_search($item['uri-id'], $old_featured);
1118 if (!($index === false)) {
1119 unset($old_featured[$index]);
1125 foreach ($old_featured as $uri_id) {
1126 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1127 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1130 Logger::info('Fetched featured posts', ['new' => $new, 'old' => $old, 'contact' => $url]);
1134 * Fetches missing posts
1136 * @param string $url message URL
1137 * @param array $child activity array with the child of this message
1138 * @param string $relay_actor Relay actor
1139 * @param int $completion Completion mode, see Receiver::COMPLETION_*
1140 * @return string fetched message URL
1141 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1142 * @throws \ImagickException
1144 public static function fetchMissingActivity(string $url, array $child = [], string $relay_actor = '', int $completion = Receiver::COMPLETION_MANUAL): string
1146 if (!empty($child['receiver'])) {
1147 $uid = ActivityPub\Receiver::getFirstUserFromReceivers($child['receiver']);
1152 $object = ActivityPub::fetchContent($url, $uid);
1153 if (empty($object)) {
1154 Logger::notice('Activity was not fetchable, aborting.', ['url' => $url, 'uid' => $uid]);
1158 if (empty($object['id'])) {
1159 Logger::notice('Activity has got not id, aborting. ', ['url' => $url, 'object' => $object]);
1163 if (!empty($object['actor'])) {
1164 $object_actor = $object['actor'];
1165 } elseif (!empty($object['attributedTo'])) {
1166 $object_actor = $object['attributedTo'];
1167 if (is_array($object_actor)) {
1168 $compacted = JsonLD::compact($object);
1169 $object_actor = JsonLD::fetchElement($compacted, 'as:attributedTo', '@id');
1176 $signer = [$object_actor];
1178 if (!empty($child['author'])) {
1179 $actor = $child['author'];
1182 $actor = $object_actor;
1185 if (!empty($object['published'])) {
1186 $published = $object['published'];
1187 } elseif (!empty($child['published'])) {
1188 $published = $child['published'];
1190 $published = DateTimeFormat::utcNow();
1194 $activity['@context'] = $object['@context'] ?? ActivityPub::CONTEXT;
1195 unset($object['@context']);
1196 $activity['id'] = $object['id'];
1197 $activity['to'] = $object['to'] ?? [];
1198 $activity['cc'] = $object['cc'] ?? [];
1199 $activity['actor'] = $actor;
1200 $activity['object'] = $object;
1201 $activity['published'] = $published;
1202 $activity['type'] = 'Create';
1204 $ldactivity = JsonLD::compact($activity);
1206 $ldactivity['recursion-depth'] = !empty($child['recursion-depth']) ? $child['recursion-depth'] + 1 : 1;
1208 if (!empty($relay_actor)) {
1209 $ldactivity['thread-completion'] = $ldactivity['from-relay'] = Contact::getIdForURL($relay_actor);
1210 $ldactivity['completion-mode'] = Receiver::COMPLETION_RELAY;
1211 } elseif (!empty($child['thread-completion'])) {
1212 $ldactivity['thread-completion'] = $child['thread-completion'];
1213 $ldactivity['completion-mode'] = $child['completion-mode'] ?? Receiver::COMPLETION_NONE;
1215 $ldactivity['thread-completion'] = Contact::getIdForURL($actor);
1216 $ldactivity['completion-mode'] = $completion;
1219 if (!empty($child['type'])) {
1220 $ldactivity['thread-children-type'] = $child['type'];
1223 if (!empty($relay_actor) && !self::acceptIncomingMessage($ldactivity, $object['id'])) {
1227 ActivityPub\Receiver::processActivity($ldactivity, json_encode($activity), $uid, true, false, $signer);
1229 Logger::notice('Activity had been fetched and processed.', ['url' => $url, 'object' => $activity['id']]);
1231 return $activity['id'];
1235 * Test if incoming relay messages should be accepted
1237 * @param array $activity activity array
1238 * @param string $id object ID
1239 * @return boolean true if message is accepted
1241 private static function acceptIncomingMessage(array $activity, string $id): bool
1243 if (empty($activity['as:object'])) {
1244 Logger::info('No object field in activity - accepted', ['id' => $id]);
1248 $replyto = JsonLD::fetchElement($activity['as:object'], 'as:inReplyTo', '@id');
1249 $uriid = ItemURI::getIdByURI($replyto ?? '');
1250 if (Post::exists(['uri-id' => $uriid])) {
1251 Logger::info('Post is a reply to an existing post - accepted', ['id' => $id, 'uri-id' => $uriid, 'replyto' => $replyto]);
1255 $attributed_to = JsonLD::fetchElement($activity['as:object'], 'as:attributedTo', '@id');
1256 $authorid = Contact::getIdForURL($attributed_to);
1258 $body = HTML::toBBCode(JsonLD::fetchElement($activity['as:object'], 'as:content', '@value') ?? '');
1261 $tags = Receiver::processTags(JsonLD::fetchElementArray($activity['as:object'], 'as:tag') ?? []);
1262 if (!empty($tags)) {
1263 foreach ($tags as $tag) {
1264 if ($tag['type'] != 'Hashtag') {
1267 $messageTags[] = ltrim(mb_strtolower($tag['name']), '#');
1271 return Relay::isSolicitedPost($messageTags, $body, $authorid, $id, Protocol::ACTIVITYPUB);
1275 * perform a "follow" request
1277 * @param array $activity
1279 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1280 * @throws \ImagickException
1282 public static function followUser(array $activity)
1284 $uid = User::getIdForURL($activity['object_id']);
1289 $owner = User::getOwnerDataById($uid);
1290 if (empty($owner)) {
1294 $cid = Contact::getIdForURL($activity['actor'], $uid);
1296 self::switchContact($cid);
1297 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1301 'author-id' => Contact::getIdForURL($activity['actor']),
1302 'author-link' => $activity['actor'],
1305 // Ensure that the contact has got the right network type
1306 self::switchContact($item['author-id']);
1308 $result = Contact::addRelationship($owner, [], $item, false, $activity['content'] ?? '');
1309 if ($result === true) {
1310 ActivityPub\Transmitter::sendContactAccept($item['author-link'], $activity['id'], $owner['uid']);
1313 $cid = Contact::getIdForURL($activity['actor'], $uid);
1318 if ($result && DI::config()->get('system', 'transmit_pending_events') && ($owner['contact-type'] == Contact::TYPE_COMMUNITY)) {
1319 self::transmitPendingEvents($cid, $owner['uid']);
1322 if (empty($contact)) {
1323 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1326 Logger::notice('Follow user ' . $uid . ' from contact ' . $cid . ' with id ' . $activity['id']);
1330 * Transmit pending events to the new follower
1332 * @param integer $cid Contact id
1333 * @param integer $uid User id
1336 private static function transmitPendingEvents(int $cid, int $uid)
1338 $account = DBA::selectFirst('account-user-view', ['ap-inbox', 'ap-sharedinbox'], ['id' => $cid]);
1339 $inbox = $account['ap-sharedinbox'] ?: $account['ap-inbox'];
1341 $events = DBA::select('event', ['id'], ["`uid` = ? AND `start` > ? AND `type` != ?", $uid, DateTimeFormat::utcNow(), 'birthday']);
1342 while ($event = DBA::fetch($events)) {
1343 $post = Post::selectFirst(['id', 'uri-id', 'created'], ['event-id' => $event['id']]);
1347 if (DI::config()->get('system', 'bulk_delivery')) {
1348 Post\Delivery::add($post['uri-id'], $uid, $inbox, $post['created'], Delivery::POST, [$cid]);
1349 Worker::add(PRIORITY_HIGH, 'APDelivery', '', 0, $inbox, 0);
1351 Worker::add(PRIORITY_HIGH, 'APDelivery', Delivery::POST, $post['id'], $inbox, $uid, [$cid], $post['uri-id']);
1357 * Update the given profile
1359 * @param array $activity
1360 * @throws \Exception
1362 public static function updatePerson(array $activity)
1364 if (empty($activity['object_id'])) {
1368 Logger::info('Updating profile', ['object' => $activity['object_id']]);
1369 Contact::updateFromProbeByURL($activity['object_id']);
1370 Queue::remove($activity);
1374 * Delete the given profile
1376 * @param array $activity
1378 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1380 public static function deletePerson(array $activity)
1382 if (empty($activity['object_id']) || empty($activity['actor'])) {
1383 Logger::info('Empty object id or actor.');
1387 if ($activity['object_id'] != $activity['actor']) {
1388 Logger::info('Object id does not match actor.');
1392 $contacts = DBA::select('contact', ['id'], ['nurl' => Strings::normaliseLink($activity['object_id'])]);
1393 while ($contact = DBA::fetch($contacts)) {
1394 Contact::remove($contact['id']);
1396 DBA::close($contacts);
1398 Logger::info('Deleted contact', ['object' => $activity['object_id']]);
1399 Queue::remove($activity);
1403 * Blocks the user by the contact
1405 * @param array $activity
1407 * @throws \Exception
1409 public static function blockAccount(array $activity)
1411 $cid = Contact::getIdForURL($activity['actor']);
1416 $uid = User::getIdForURL($activity['object_id']);
1421 Contact\User::setIsBlocked($cid, $uid, true);
1423 Logger::info('Contact blocked user', ['contact' => $cid, 'user' => $uid]);
1427 * Unblocks the user by the contact
1429 * @param array $activity
1431 * @throws \Exception
1433 public static function unblockAccount(array $activity)
1435 $cid = Contact::getIdForURL($activity['actor']);
1440 $uid = User::getIdForURL($activity['object_object']);
1445 Contact\User::setIsBlocked($cid, $uid, false);
1447 Logger::info('Contact unblocked user', ['contact' => $cid, 'user' => $uid]);
1451 * Accept a follow request
1453 * @param array $activity
1454 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1455 * @throws \ImagickException
1457 public static function acceptFollowUser(array $activity)
1459 $uid = User::getIdForURL($activity['object_actor']);
1464 $cid = Contact::getIdForURL($activity['actor'], $uid);
1466 Logger::info('No contact found', ['actor' => $activity['actor']]);
1470 self::switchContact($cid);
1472 $fields = ['pending' => false];
1474 $contact = DBA::selectFirst('contact', ['rel'], ['id' => $cid]);
1475 if ($contact['rel'] == Contact::FOLLOWER) {
1476 $fields['rel'] = Contact::FRIEND;
1479 $condition = ['id' => $cid];
1480 Contact::update($fields, $condition);
1481 Logger::info('Accept contact request', ['contact' => $cid, 'user' => $uid]);
1482 Queue::remove($activity);
1486 * Reject a follow request
1488 * @param array $activity
1489 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1490 * @throws \ImagickException
1492 public static function rejectFollowUser(array $activity)
1494 $uid = User::getIdForURL($activity['object_actor']);
1499 $cid = Contact::getIdForURL($activity['actor'], $uid);
1501 Logger::info('No contact found', ['actor' => $activity['actor']]);
1505 self::switchContact($cid);
1507 $contact = Contact::getById($cid, ['rel']);
1508 if ($contact['rel'] == Contact::SHARING) {
1509 Contact::remove($cid);
1510 Logger::info('Rejected contact request - contact removed', ['contact' => $cid, 'user' => $uid]);
1511 } elseif ($contact['rel'] == Contact::FRIEND) {
1512 Contact::update(['rel' => Contact::FOLLOWER], ['id' => $cid]);
1514 Logger::info('Rejected contact request', ['contact' => $cid, 'user' => $uid]);
1516 Queue::remove($activity);
1520 * Undo activity like "like" or "dislike"
1522 * @param array $activity
1523 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1524 * @throws \ImagickException
1526 public static function undoActivity(array $activity)
1528 if (empty($activity['object_id'])) {
1532 if (empty($activity['object_actor'])) {
1536 $author_id = Contact::getIdForURL($activity['object_actor']);
1537 if (empty($author_id)) {
1541 Item::markForDeletion(['uri' => $activity['object_id'], 'author-id' => $author_id, 'gravity' => GRAVITY_ACTIVITY]);
1542 Queue::remove($activity);
1546 * Activity to remove a follower
1548 * @param array $activity
1549 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1550 * @throws \ImagickException
1552 public static function undoFollowUser(array $activity)
1554 $uid = User::getIdForURL($activity['object_object']);
1559 $owner = User::getOwnerDataById($uid);
1560 if (empty($owner)) {
1564 $cid = Contact::getIdForURL($activity['actor'], $uid);
1566 Logger::info('No contact found', ['actor' => $activity['actor']]);
1570 self::switchContact($cid);
1572 $contact = DBA::selectFirst('contact', [], ['id' => $cid]);
1573 if (!DBA::isResult($contact)) {
1577 Contact::removeFollower($contact);
1578 Logger::info('Undo following request', ['contact' => $cid, 'user' => $uid]);
1579 Queue::remove($activity);
1583 * Switches a contact to AP if needed
1585 * @param integer $cid Contact ID
1587 * @throws \Exception
1589 private static function switchContact(int $cid)
1591 $contact = DBA::selectFirst('contact', ['network', 'url'], ['id' => $cid]);
1592 if (!DBA::isResult($contact) || in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN]) || Contact::isLocal($contact['url'])) {
1596 Logger::info('Change existing contact', ['cid' => $cid, 'previous' => $contact['network']]);
1597 Contact::updateFromProbe($cid);
1601 * Collects implicit mentions like:
1602 * - the author of the parent item
1603 * - all the mentioned conversants in the parent item
1605 * @param array $parent Item array with at least ['id', 'author-link', 'alias']
1607 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1609 private static function getImplicitMentionList(array $parent): array
1611 $parent_terms = Tag::getByURIId($parent['uri-id'], [Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION]);
1613 $parent_author = Contact::getByURL($parent['author-link'], false, ['url', 'nurl', 'alias']);
1615 $implicit_mentions = [];
1616 if (empty($parent_author['url'])) {
1617 Logger::notice('Author public contact unknown.', ['author-link' => $parent['author-link'], 'parent-id' => $parent['id']]);
1619 $implicit_mentions[] = $parent_author['url'];
1620 $implicit_mentions[] = $parent_author['nurl'];
1621 $implicit_mentions[] = $parent_author['alias'];
1624 if (!empty($parent['alias'])) {
1625 $implicit_mentions[] = $parent['alias'];
1628 foreach ($parent_terms as $term) {
1629 $contact = Contact::getByURL($term['url'], false, ['url', 'nurl', 'alias']);
1630 if (!empty($contact['url'])) {
1631 $implicit_mentions[] = $contact['url'];
1632 $implicit_mentions[] = $contact['nurl'];
1633 $implicit_mentions[] = $contact['alias'];
1637 return $implicit_mentions;
1641 * Strips from the body prepended implicit mentions
1643 * @param string $body
1644 * @param array $parent
1647 private static function removeImplicitMentionsFromBody(string $body, array $parent): string
1649 if (DI::config()->get('system', 'disable_implicit_mentions')) {
1653 $potential_mentions = self::getImplicitMentionList($parent);
1655 $kept_mentions = [];
1657 // Extract one prepended mention at a time from the body
1658 while(preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $body, $matches)) {
1659 if (!in_array($matches[2], $potential_mentions)) {
1660 $kept_mentions[] = $matches[1];
1663 $body = $matches[3];
1666 // Re-appending the kept mentions to the body after extraction
1667 $kept_mentions[] = $body;
1669 return implode('', $kept_mentions);
1673 * Adds links to string mentions
1675 * @param string $body
1676 * @param array $tags
1679 protected static function addMentionLinks(string $body, array $tags): string
1681 // This prevents links to be added again to Pleroma-style mention links
1682 $body = self::normalizeMentionLinks($body);
1684 $body = BBCode::performWithEscapedTags($body, ['url'], function ($body) use ($tags) {
1685 foreach ($tags as $tag) {
1686 if (empty($tag['name']) || empty($tag['type']) || empty($tag['href']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
1690 $hash = substr($tag['name'], 0, 1);
1691 $name = substr($tag['name'], 1);
1692 if (!in_array($hash, Tag::TAG_CHARACTER)) {
1694 $name = $tag['name'];
1697 $body = str_replace($tag['name'], $hash . '[url=' . $tag['href'] . ']' . $name . '[/url]', $body);