src/Protocol/ActivityPub/Processor.php

   1 <?php
   2 /**
   3  * @copyright Copyright (C) 2010-2022, the Friendica project
   4  *
   5  * @license GNU AGPL version 3 or any later version
   6  *
   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.
  11  *
  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.
  16  *
  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/>.
  19  *
  20  */
  21
  22 namespace Friendica\Protocol\ActivityPub;
  23
  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\Database\DBA;
  31 use Friendica\DI;
  32 use Friendica\Model\APContact;
  33 use Friendica\Model\Contact;
  34 use Friendica\Model\Conversation;
  35 use Friendica\Model\Event;
  36 use Friendica\Model\GServer;
  37 use Friendica\Model\Item;
  38 use Friendica\Model\ItemURI;
  39 use Friendica\Model\Mail;
  40 use Friendica\Model\Tag;
  41 use Friendica\Model\User;
  42 use Friendica\Model\Post;
  43 use Friendica\Protocol\Activity;
  44 use Friendica\Protocol\ActivityPub;
  45 use Friendica\Protocol\Relay;
  46 use Friendica\Util\DateTimeFormat;
  47 use Friendica\Util\JsonLD;
  48 use Friendica\Util\Strings;
  49
  50 /**
  51  * ActivityPub Processor Protocol class
  52  */
  53 class Processor
  54 {
  55         /**
  56          * Extracts the tag character (#, @, !) from mention links
  57          *
  58          * @param string $body
  59          * @return string
  60          */
  61         protected static function normalizeMentionLinks(string $body): string
  62         {
  63                 return preg_replace('%\[url=([^\[\]]*)]([#@!])(.*?)\[/url]%ism', '$2[url=$1]$3[/url]', $body);
  64         }
  65
  66         /**
  67          * Convert the language array into a language JSON
  68          *
  69          * @param array $languages
  70          * @return string language JSON
  71          */
  72         private static function processLanguages(array $languages)
  73         {
  74                 $codes = array_keys($languages);
  75                 $lang = [];
  76                 foreach ($codes as $code) {
  77                         $lang[$code] = 1;
  78                 }
  79
  80                 if (empty($lang)) {
  81                         return '';
  82                 }
  83
  84                 return json_encode($lang);
  85         }
  86         /**
  87          * Replaces emojis in the body
  88          *
  89          * @param array $emojis
  90          * @param string $body
  91          *
  92          * @return string with replaced emojis
  93          */
  94         private static function replaceEmojis(int $uri_id, $body, array $emojis)
  95         {
  96                 $body = strtr($body,
  97                         array_combine(
  98                                 array_column($emojis, 'name'),
  99                                 array_map(function ($emoji) {
 100                                         return '[emoji=' . $emoji['href'] . ']' . $emoji['name'] . '[/emoji]';
 101                                 }, $emojis)
 102                         )
 103                 );
 104
 105                 // We store the emoji here to be able to avoid storing it in the media
 106                 foreach ($emojis as $emoji) {
 107                         Post\Link::getByLink($uri_id, $emoji['href']);
 108                 }
 109                 return $body;
 110         }
 111
 112         /**
 113          * Store attached media files in the post-media table
 114          *
 115          * @param int $uriid
 116          * @param array $attachment
 117          * @return void
 118          */
 119         private static function storeAttachmentAsMedia(int $uriid, array $attachment)
 120         {
 121                 if (empty($attachment['url'])) {
 122                         return;
 123                 }
 124
 125                 $data = ['uri-id' => $uriid];
 126                 $data['type'] = Post\Media::UNKNOWN;
 127                 $data['url'] = $attachment['url'];
 128                 $data['mimetype'] = $attachment['mediaType'] ?? null;
 129                 $data['height'] = $attachment['height'] ?? null;
 130                 $data['width'] = $attachment['width'] ?? null;
 131                 $data['size'] = $attachment['size'] ?? null;
 132                 $data['preview'] = $attachment['image'] ?? null;
 133                 $data['description'] = $attachment['name'] ?? null;
 134
 135                 Post\Media::insert($data);
 136         }
 137
 138         /**
 139          * Stire attachment data
 140          *
 141          * @param array   $activity
 142          * @param array   $item
 143          */
 144         private static function storeAttachments($activity, $item)
 145         {
 146                 if (empty($activity['attachments'])) {
 147                         return;
 148                 }
 149
 150                 foreach ($activity['attachments'] as $attach) {
 151                         self::storeAttachmentAsMedia($item['uri-id'], $attach);
 152                 }
 153         }
 154
 155         /**
 156          * Updates a message
 157          *
 158          * @param array $activity Activity array
 159          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 160          */
 161         public static function updateItem($activity)
 162         {
 163                 $item = Post::selectFirst(['uri', 'uri-id', 'thr-parent', 'gravity', 'post-type'], ['uri' => $activity['id']]);
 164                 if (!DBA::isResult($item)) {
 165                         Logger::warning('No existing item, item will be created', ['uri' => $activity['id']]);
 166                         $item = self::createItem($activity);
 167                         self::postItem($activity, $item);
 168                         return;
 169                 }
 170
 171                 $item['changed'] = DateTimeFormat::utcNow();
 172                 $item['edited'] = DateTimeFormat::utc($activity['updated']);
 173
 174                 $item = self::processContent($activity, $item);
 175
 176                 self::storeAttachments($activity, $item);
 177
 178                 if (empty($item)) {
 179                         return;
 180                 }
 181
 182                 Item::update($item, ['uri' => $activity['id']]);
 183
 184                 if ($activity['object_type'] == 'as:Event') {
 185                         $posts = Post::select(['event-id', 'uid'], ["`uri` = ? AND `event-id` > ?", $activity['id'], 0]);
 186                         while ($post = DBA::fetch($posts)) {
 187                                 self::updateEvent($post['event-id'], $activity);
 188                         }
 189                 }
 190         }
 191
 192         /**
 193          * Update an existing event
 194          *
 195          * @param int $event_id
 196          * @param array $activity
 197          */
 198         private static function updateEvent(int $event_id, array $activity)
 199         {
 200                 $event = DBA::selectFirst('event', [], ['id' => $event_id]);
 201
 202                 $event['edited']   = DateTimeFormat::utc($activity['updated']);
 203                 $event['summary']  = HTML::toBBCode($activity['name']);
 204                 $event['desc']     = HTML::toBBCode($activity['content']);
 205                 $event['start']    = $activity['start-time'];
 206                 $event['finish']   = $activity['end-time'];
 207                 $event['nofinish'] = empty($event['finish']);
 208                 $event['location'] = $activity['location'];
 209
 210                 Logger::info('Updating event', ['uri' => $activity['id'], 'id' => $event_id]);
 211                 Event::store($event);
 212         }
 213
 214         /**
 215          * Prepares data for a message
 216          *
 217          * @param array $activity Activity array
 218          * @return array Internal item
 219          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 220          * @throws \ImagickException
 221          */
 222         public static function createItem($activity)
 223         {
 224                 $item = [];
 225                 $item['verb'] = Activity::POST;
 226                 $item['thr-parent'] = $activity['reply-to-id'];
 227
 228                 if ($activity['reply-to-id'] == $activity['id']) {
 229                         $item['gravity'] = GRAVITY_PARENT;
 230                         $item['object-type'] = Activity\ObjectType::NOTE;
 231                 } else {
 232                         $item['gravity'] = GRAVITY_COMMENT;
 233                         $item['object-type'] = Activity\ObjectType::COMMENT;
 234                 }
 235
 236                 if (empty($activity['directmessage']) && ($activity['id'] != $activity['reply-to-id']) && !Post::exists(['uri' => $activity['reply-to-id']])) {
 237                         Logger::notice('Parent not found. Try to refetch it.', ['parent' => $activity['reply-to-id']]);
 238                         self::fetchMissingActivity($activity['reply-to-id'], $activity);
 239                 }
 240
 241                 $item['diaspora_signed_text'] = $activity['diaspora:comment'] ?? '';
 242
 243                 /// @todo What to do with $activity['context']?
 244                 if (empty($activity['directmessage']) && ($item['gravity'] != GRAVITY_PARENT) && !Post::exists(['uri' => $item['thr-parent']])) {
 245                         Logger::info('Parent not found, message will be discarded.', ['thr-parent' => $item['thr-parent']]);
 246                         return [];
 247                 }
 248
 249                 $item['network'] = Protocol::ACTIVITYPUB;
 250                 $item['author-link'] = $activity['author'];
 251                 $item['author-id'] = Contact::getIdForURL($activity['author']);
 252                 $item['owner-link'] = $activity['actor'];
 253                 $item['owner-id'] = Contact::getIdForURL($activity['actor']);
 254
 255                 if (in_array(0, $activity['receiver']) && !empty($activity['unlisted'])) {
 256                         $item['private'] = Item::UNLISTED;
 257                 } elseif (in_array(0, $activity['receiver'])) {
 258                         $item['private'] = Item::PUBLIC;
 259                 } else {
 260                         $item['private'] = Item::PRIVATE;
 261                 }
 262
 263                 if (!empty($activity['raw'])) {
 264                         $item['source'] = $activity['raw'];
 265                         $item['protocol'] = Conversation::PARCEL_ACTIVITYPUB;
 266                         $item['conversation-href'] = $activity['context'] ?? '';
 267                         $item['conversation-uri'] = $activity['conversation'] ?? '';
 268
 269                         if (isset($activity['push'])) {
 270                                 $item['direction'] = $activity['push'] ? Conversation::PUSH : Conversation::PULL;
 271                         }
 272                 }
 273
 274                 if (!empty($activity['from-relay'])) {
 275                         $item['direction'] = Conversation::RELAY;
 276                 }
 277
 278                 if ($activity['object_type'] == 'as:Article') {
 279                         $item['post-type'] = Item::PT_ARTICLE;
 280                 } elseif ($activity['object_type'] == 'as:Audio') {
 281                         $item['post-type'] = Item::PT_AUDIO;
 282                 } elseif ($activity['object_type'] == 'as:Document') {
 283                         $item['post-type'] = Item::PT_DOCUMENT;
 284                 } elseif ($activity['object_type'] == 'as:Event') {
 285                         $item['post-type'] = Item::PT_EVENT;
 286                 } elseif ($activity['object_type'] == 'as:Image') {
 287                         $item['post-type'] = Item::PT_IMAGE;
 288                 } elseif ($activity['object_type'] == 'as:Page') {
 289                         $item['post-type'] = Item::PT_PAGE;
 290                 } elseif ($activity['object_type'] == 'as:Question') {
 291                         $item['post-type'] = Item::PT_POLL;
 292                 } elseif ($activity['object_type'] == 'as:Video') {
 293                         $item['post-type'] = Item::PT_VIDEO;
 294                 } else {
 295                         $item['post-type'] = Item::PT_NOTE;
 296                 }
 297
 298                 $item['isForum'] = false;
 299
 300                 if (!empty($activity['thread-completion'])) {
 301                         if ($activity['thread-completion'] != $item['owner-id']) {
 302                                 $actor = Contact::getById($activity['thread-completion'], ['url']);
 303                                 $item['causer-link'] = $actor['url'];
 304                                 $item['causer-id'] = $activity['thread-completion'];
 305                                 Logger::info('Use inherited actor as causer.', ['id' => $item['owner-id'], 'activity' => $activity['thread-completion'], 'owner' => $item['owner-link'], 'actor' => $actor['url']]);
 306                         } else {
 307                                 // Store the original actor in the "causer" fields to enable the check for ignored or blocked contacts
 308                                 $item['causer-link'] = $item['owner-link'];
 309                                 $item['causer-id'] = $item['owner-id'];
 310                                 Logger::info('Use actor as causer.', ['id' => $item['owner-id'], 'actor' => $item['owner-link']]);
 311                         }
 312
 313                         $item['owner-link'] = $item['author-link'];
 314                         $item['owner-id'] = $item['author-id'];
 315                 } else {
 316                         $actor = APContact::getByURL($item['owner-link'], false);
 317                         $item['isForum'] = ($actor['type'] == 'Group');
 318                 }
 319
 320                 $item['uri'] = $activity['id'];
 321
 322                 if (empty($activity['published']) || empty($activity['updated'])) {
 323                         DI::logger()->notice('published or updated keys are empty for activity', ['activity' => $activity, 'callstack' => System::callstack(10)]);
 324                 }
 325
 326                 $item['created'] = DateTimeFormat::utc($activity['published'] ?? 'now');
 327                 $item['edited'] = DateTimeFormat::utc($activity['updated'] ?? 'now');
 328                 $guid = $activity['sc:identifier'] ?: self::getGUIDByURL($item['uri']);
 329                 $item['guid'] = $activity['diaspora:guid'] ?: $guid;
 330
 331                 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
 332                 if (empty($item['uri-id'])) {
 333                         Logger::warning('Unable to get a uri-id for an item uri', ['uri' => $item['uri'], 'guid' => $item['guid']]);
 334                         return [];
 335                 }
 336
 337                 $item = self::processContent($activity, $item);
 338                 if (empty($item)) {
 339                         Logger::info('Message was not processed');
 340                         return [];
 341                 }
 342
 343                 $item['plink'] = $activity['alternate-url'] ?? $item['uri'];
 344
 345                 self::storeAttachments($activity, $item);
 346
 347                 // We received the post via AP, so we set the protocol of the server to AP
 348                 $contact = Contact::getById($item['author-id'], ['gsid']);
 349                 if (!empty($contact['gsid'])) {
 350                         GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
 351                 }
 352
 353                 if ($item['author-id'] != $item['owner-id']) {
 354                         $contact = Contact::getById($item['owner-id'], ['gsid']);
 355                         if (!empty($contact['gsid'])) {
 356                                 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
 357                         }
 358                 }
 359
 360                 return $item;
 361         }
 362
 363         /**
 364          * Delete items
 365          *
 366          * @param array $activity
 367          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 368          * @throws \ImagickException
 369          */
 370         public static function deleteItem($activity)
 371         {
 372                 $owner = Contact::getIdForURL($activity['actor']);
 373
 374                 Logger::info('Deleting item', ['object' => $activity['object_id'], 'owner'  => $owner]);
 375                 Item::markForDeletion(['uri' => $activity['object_id'], 'owner-id' => $owner]);
 376         }
 377
 378         /**
 379          * Prepare the item array for an activity
 380          *
 381          * @param array $activity Activity array
 382          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 383          * @throws \ImagickException
 384          */
 385         public static function addTag($activity)
 386         {
 387                 if (empty($activity['object_content']) || empty($activity['object_id'])) {
 388                         return;
 389                 }
 390
 391                 foreach ($activity['receiver'] as $receiver) {
 392                         $item = Post::selectFirst(['id', 'uri-id', 'origin', 'author-link'], ['uri' => $activity['target_id'], 'uid' => $receiver]);
 393                         if (!DBA::isResult($item)) {
 394                                 // We don't fetch missing content for this purpose
 395                                 continue;
 396                         }
 397
 398                         if (($item['author-link'] != $activity['actor']) && !$item['origin']) {
 399                                 Logger::info('Not origin, not from the author, skipping update', ['id' => $item['id'], 'author' => $item['author-link'], 'actor' => $activity['actor']]);
 400                                 continue;
 401                         }
 402
 403                         Tag::store($item['uri-id'], Tag::HASHTAG, $activity['object_content'], $activity['object_id']);
 404                         Logger::info('Tagged item', ['id' => $item['id'], 'tag' => $activity['object_content'], 'uri' => $activity['target_id'], 'actor' => $activity['actor']]);
 405                 }
 406         }
 407
 408         /**
 409          * Prepare the item array for an activity
 410          *
 411          * @param array  $activity Activity array
 412          * @param string $verb     Activity verb
 413          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 414          * @throws \ImagickException
 415          */
 416         public static function createActivity($activity, $verb)
 417         {
 418                 $item = self::createItem($activity);
 419                 $item['verb'] = $verb;
 420                 $item['thr-parent'] = $activity['object_id'];
 421                 $item['gravity'] = GRAVITY_ACTIVITY;
 422                 unset($item['post-type']);
 423                 $item['object-type'] = Activity\ObjectType::NOTE;
 424
 425                 $item['diaspora_signed_text'] = $activity['diaspora:like'] ?? '';
 426
 427                 self::postItem($activity, $item);
 428         }
 429
 430         /**
 431          * Create an event
 432          *
 433          * @param array $activity Activity array
 434          * @param array $item
 435          *
 436          * @return int event id
 437          * @throws \Exception
 438          */
 439         public static function createEvent($activity, $item)
 440         {
 441                 $event['summary']   = HTML::toBBCode($activity['name']);
 442                 $event['desc']      = HTML::toBBCode($activity['content']);
 443                 $event['start']     = $activity['start-time'];
 444                 $event['finish']    = $activity['end-time'];
 445                 $event['nofinish']  = empty($event['finish']);
 446                 $event['location']  = $activity['location'];
 447                 $event['cid']       = $item['contact-id'];
 448                 $event['uid']       = $item['uid'];
 449                 $event['uri']       = $item['uri'];
 450                 $event['edited']    = $item['edited'];
 451                 $event['private']   = $item['private'];
 452                 $event['guid']      = $item['guid'];
 453                 $event['plink']     = $item['plink'];
 454                 $event['network']   = $item['network'];
 455                 $event['protocol']  = $item['protocol'];
 456                 $event['direction'] = $item['direction'];
 457                 $event['source']    = $item['source'];
 458
 459                 $ev = DBA::selectFirst('event', ['id'], ['uri' => $item['uri'], 'uid' => $item['uid']]);
 460                 if (DBA::isResult($ev)) {
 461                         $event['id'] = $ev['id'];
 462                 }
 463
 464                 $event_id = Event::store($event);
 465
 466                 Logger::info('Event was stored', ['id' => $event_id]);
 467
 468                 return $event_id;
 469         }
 470
 471         /**
 472          * Process the content
 473          *
 474          * @param array $activity Activity array
 475          * @param array $item
 476          * @return array|bool Returns the item array or false if there was an unexpected occurrence
 477          * @throws \Exception
 478          */
 479         private static function processContent($activity, $item)
 480         {
 481                 if (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/markdown')) {
 482                         $item['title'] = Markdown::toBBCode($activity['name']);
 483                         $content = Markdown::toBBCode($activity['content']);
 484                 } elseif (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/bbcode')) {
 485                         $item['title'] = $activity['name'];
 486                         $content = $activity['content'];
 487                 } else {
 488                         // By default assume "text/html"
 489                         $item['title'] = HTML::toBBCode($activity['name']);
 490                         $content = HTML::toBBCode($activity['content']);
 491                 }
 492
 493                 if (!empty($activity['languages'])) {
 494                         $item['language'] = self::processLanguages($activity['languages']);
 495                 }
 496
 497                 if (!empty($activity['emojis'])) {
 498                         $content = self::replaceEmojis($item['uri-id'], $content, $activity['emojis']);
 499                 }
 500
 501                 $content = self::addMentionLinks($content, $activity['tags']);
 502
 503                 if (!empty($activity['source'])) {
 504                         $item['body'] = $activity['source'];
 505                         $item['raw-body'] = $content;
 506                         $item['body'] = Item::improveSharedDataInBody($item);
 507                 } else {
 508                         if (empty($activity['directmessage']) && ($item['thr-parent'] != $item['uri']) && ($item['gravity'] == GRAVITY_COMMENT)) {
 509                                 $item_private = !in_array(0, $activity['item_receiver']);
 510                                 $parent = Post::selectFirst(['id', 'uri-id', 'private', 'author-link', 'alias'], ['uri' => $item['thr-parent']]);
 511                                 if (!DBA::isResult($parent)) {
 512                                         Logger::warning('Unknown parent item.', ['uri' => $item['thr-parent']]);
 513                                         return false;
 514                                 }
 515                                 if ($item_private && ($parent['private'] != Item::PRIVATE)) {
 516                                         Logger::warning('Item is private but the parent is not. Dropping.', ['item-uri' => $item['uri'], 'thr-parent' => $item['thr-parent']]);
 517                                         return false;
 518                                 }
 519
 520                                 $content = self::removeImplicitMentionsFromBody($content, $parent);
 521                         }
 522                         $item['content-warning'] = HTML::toBBCode($activity['summary']);
 523                         $item['raw-body'] = $item['body'] = $content;
 524                 }
 525
 526                 self::storeFromBody($item);
 527                 self::storeTags($item['uri-id'], $activity['tags']);
 528
 529                 $item['location'] = $activity['location'];
 530
 531                 if (!empty($activity['latitude']) && !empty($activity['longitude'])) {
 532                         $item['coord'] = $activity['latitude'] . ' ' . $activity['longitude'];
 533                 }
 534
 535                 $item['app'] = $activity['generator'];
 536
 537                 return $item;
 538         }
 539
 540         /**
 541          * Store hashtags and mentions
 542          *
 543          * @param array $item
 544          */
 545         private static function storeFromBody(array $item)
 546         {
 547                 // Make sure to delete all existing tags (can happen when called via the update functionality)
 548                 DBA::delete('post-tag', ['uri-id' => $item['uri-id']]);
 549
 550                 Tag::storeFromBody($item['uri-id'], $item['body'], '@!');
 551         }
 552
 553         /**
 554          * Generate a GUID out of an URL
 555          *
 556          * @param string $url message URL
 557          * @return string with GUID
 558          */
 559         private static function getGUIDByURL(string $url)
 560         {
 561                 $parsed = parse_url($url);
 562
 563                 $host_hash = hash('crc32', $parsed['host']);
 564
 565                 unset($parsed["scheme"]);
 566                 unset($parsed["host"]);
 567
 568                 $path = implode("/", $parsed);
 569
 570                 return $host_hash . '-'. hash('fnv164', $path) . '-'. hash('joaat', $path);
 571         }
 572
 573         /**
 574          * Creates an item post
 575          *
 576          * @param array $activity Activity data
 577          * @param array $item     item array
 578          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 579          * @throws \ImagickException
 580          */
 581         public static function postItem(array $activity, array $item)
 582         {
 583                 if (empty($item)) {
 584                         return;
 585                 }
 586
 587                 $stored = false;
 588                 ksort($activity['receiver']);
 589
 590                 foreach ($activity['receiver'] as $receiver) {
 591                         if ($receiver == -1) {
 592                                 continue;
 593                         }
 594
 595                         $item['uid'] = $receiver;
 596
 597                         $type = $activity['reception_type'][$receiver] ?? Receiver::TARGET_UNKNOWN;
 598                         switch($type) {
 599                                 case Receiver::TARGET_TO:
 600                                         $item['post-reason'] = Item::PR_TO;
 601                                         break;
 602                                 case Receiver::TARGET_CC:
 603                                         $item['post-reason'] = Item::PR_CC;
 604                                         break;
 605                                 case Receiver::TARGET_BTO:
 606                                         $item['post-reason'] = Item::PR_BTO;
 607                                         break;
 608                                 case Receiver::TARGET_BCC:
 609                                         $item['post-reason'] = Item::PR_BCC;
 610                                         break;
 611                                 case Receiver::TARGET_FOLLOWER:
 612                                         $item['post-reason'] = Item::PR_FOLLOWER;
 613                                         break;
 614                                 case Receiver::TARGET_ANSWER:
 615                                         $item['post-reason'] = Item::PR_COMMENT;
 616                                         break;
 617                                 case Receiver::TARGET_GLOBAL:
 618                                         $item['post-reason'] = Item::PR_GLOBAL;
 619                                         break;
 620                                 default:
 621                                         $item['post-reason'] = Item::PR_NONE;
 622                         }
 623
 624                         if (!empty($activity['from-relay'])) {
 625                                 $item['post-reason'] = Item::PR_RELAY;
 626                         } elseif (!empty($activity['thread-completion'])) {
 627                                 $item['post-reason'] = Item::PR_FETCHED;
 628                         }
 629
 630                         if ($item['isForum'] ?? false) {
 631                                 $item['contact-id'] = Contact::getIdForURL($activity['actor'], $receiver);
 632                         } else {
 633                                 $item['contact-id'] = Contact::getIdForURL($activity['author'], $receiver);
 634                         }
 635
 636                         if (($receiver != 0) && empty($item['contact-id'])) {
 637                                 $item['contact-id'] = Contact::getIdForURL($activity['author']);
 638                         }
 639
 640                         if (!empty($activity['directmessage'])) {
 641                                 self::postMail($activity, $item);
 642                                 continue;
 643                         }
 644
 645                         if (!($item['isForum'] ?? false) && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT) &&
 646                                 ($item['post-reason'] == Item::PR_BCC) && !Contact::isSharingByURL($activity['author'], $receiver)) {
 647                                 Logger::info('Top level post via BCC from a non sharer, ignoring', ['uid' => $receiver, 'contact' => $item['contact-id']]);
 648                                 continue;
 649                         }
 650
 651                         $is_forum = false;
 652
 653                         if ($receiver != 0) {
 654                                 $user = User::getById($receiver, ['account-type']);
 655                                 if (!empty($user['account-type'])) {
 656                                         $is_forum = ($user['account-type'] == User::ACCOUNT_TYPE_COMMUNITY);
 657                                 }
 658                         }
 659
 660                         if (!$is_forum && DI::pConfig()->get($receiver, 'system', 'accept_only_sharer', false) && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT)) {
 661                                 $skip = !Contact::isSharingByURL($activity['author'], $receiver);
 662
 663                                 if ($skip && (($activity['type'] == 'as:Announce') || ($item['isForum'] ?? false))) {
 664                                         $skip = !Contact::isSharingByURL($activity['actor'], $receiver);
 665                                 }
 666
 667                                 if ($skip) {
 668                                         Logger::info('Skipping post', ['uid' => $receiver, 'url' => $item['uri']]);
 669                                         continue;
 670                                 }
 671
 672                                 Logger::info('Accepting post', ['uid' => $receiver, 'url' => $item['uri']]);
 673                         }
 674
 675                         if (($item['gravity'] != GRAVITY_ACTIVITY) && ($activity['object_type'] == 'as:Event')) {
 676                                 $event_id = self::createEvent($activity, $item);
 677
 678                                 $item = Event::getItemArrayForImportedId($event_id, $item);
 679                         }
 680
 681                         $item_id = Item::insert($item);
 682                         if ($item_id) {
 683                                 Logger::info('Item insertion successful', ['user' => $item['uid'], 'item_id' => $item_id]);
 684                         } else {
 685                                 Logger::notice('Item insertion aborted', ['user' => $item['uid']]);
 686                         }
 687
 688                         if ($item['uid'] == 0) {
 689                                 $stored = $item_id;
 690                         }
 691                 }
 692
 693                 // Store send a follow request for every reshare - but only when the item had been stored
 694                 if ($stored && ($item['private'] != Item::PRIVATE) && ($item['gravity'] == GRAVITY_PARENT) && ($item['author-link'] != $item['owner-link'])) {
 695                         $author = APContact::getByURL($item['owner-link'], false);
 696                         // We send automatic follow requests for reshared messages. (We don't need though for forum posts)
 697                         if ($author['type'] != 'Group') {
 698                                 Logger::info('Send follow request', ['uri' => $item['uri'], 'stored' => $stored, 'to' => $item['author-link']]);
 699                                 ActivityPub\Transmitter::sendFollowObject($item['uri'], $item['author-link']);
 700                         }
 701                 }
 702         }
 703
 704         /**
 705          * Store tags and mentions into the tag table
 706          *
 707          * @param integer $uriid
 708          * @param array $tags
 709          */
 710         private static function storeTags(int $uriid, array $tags = null)
 711         {
 712                 foreach ($tags as $tag) {
 713                         if (empty($tag['name']) || empty($tag['type']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
 714                                 continue;
 715                         }
 716
 717                         $hash = substr($tag['name'], 0, 1);
 718
 719                         if ($tag['type'] == 'Mention') {
 720                                 if (in_array($hash, [Tag::TAG_CHARACTER[Tag::MENTION],
 721                                         Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION],
 722                                         Tag::TAG_CHARACTER[Tag::IMPLICIT_MENTION]])) {
 723                                         $tag['name'] = substr($tag['name'], 1);
 724                                 }
 725                                 $type = Tag::IMPLICIT_MENTION;
 726
 727                                 if (!empty($tag['href'])) {
 728                                         $apcontact = APContact::getByURL($tag['href']);
 729                                         if (!empty($apcontact['name']) || !empty($apcontact['nick'])) {
 730                                                 $tag['name'] = $apcontact['name'] ?: $apcontact['nick'];
 731                                         }
 732                                 }
 733                         } elseif ($tag['type'] == 'Hashtag') {
 734                                 if ($hash == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
 735                                         $tag['name'] = substr($tag['name'], 1);
 736                                 }
 737                                 $type = Tag::HASHTAG;
 738                         }
 739
 740                         if (empty($tag['name'])) {
 741                                 continue;
 742                         }
 743
 744                         Tag::store($uriid, $type, $tag['name'], $tag['href']);
 745                 }
 746         }
 747
 748         /**
 749          * Creates an mail post
 750          *
 751          * @param array $activity Activity data
 752          * @param array $item     item array
 753          * @return int|bool New mail table row id or false on error
 754          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 755          */
 756         private static function postMail($activity, $item)
 757         {
 758                 if (($item['gravity'] != GRAVITY_PARENT) && !DBA::exists('mail', ['uri' => $item['thr-parent'], 'uid' => $item['uid']])) {
 759                         Logger::info('Parent not found, mail will be discarded.', ['uid' => $item['uid'], 'uri' => $item['thr-parent']]);
 760                         return false;
 761                 }
 762
 763                 Logger::info('Direct Message', $item);
 764
 765                 $msg = [];
 766                 $msg['uid'] = $item['uid'];
 767
 768                 $msg['contact-id'] = $item['contact-id'];
 769
 770                 $contact = Contact::getById($item['contact-id'], ['name', 'url', 'photo']);
 771                 $msg['from-name'] = $contact['name'];
 772                 $msg['from-url'] = $contact['url'];
 773                 $msg['from-photo'] = $contact['photo'];
 774
 775                 $msg['uri'] = $item['uri'];
 776                 $msg['created'] = $item['created'];
 777
 778                 $parent = DBA::selectFirst('mail', ['parent-uri', 'title'], ['uri' => $item['thr-parent']]);
 779                 if (DBA::isResult($parent)) {
 780                         $msg['parent-uri'] = $parent['parent-uri'];
 781                         $msg['title'] = $parent['title'];
 782                 } else {
 783                         $msg['parent-uri'] = $item['thr-parent'];
 784
 785                         if (!empty($item['title'])) {
 786                                 $msg['title'] = $item['title'];
 787                         } elseif (!empty($item['content-warning'])) {
 788                                 $msg['title'] = $item['content-warning'];
 789                         } else {
 790                                 // Trying to generate a title out of the body
 791                                 $title = $item['body'];
 792
 793                                 while (preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $title, $matches)) {
 794                                         $title = $matches[3];
 795                                 }
 796
 797                                 $title = trim(BBCode::toPlaintext($title));
 798
 799                                 if (strlen($title) > 20) {
 800                                         $title = substr($title, 0, 20) . '...';
 801                                 }
 802
 803                                 $msg['title'] = $title;
 804                         }
 805                 }
 806                 $msg['body'] = $item['body'];
 807
 808                 return Mail::insert($msg);
 809         }
 810
 811         /**
 812          * Fetches missing posts
 813          *
 814          * @param string $url         message URL
 815          * @param array  $child       activity array with the child of this message
 816          * @param string $relay_actor Relay actor
 817          * @return string fetched message URL
 818          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 819          */
 820         public static function fetchMissingActivity(string $url, array $child = [], string $relay_actor = '')
 821         {
 822                 if (!empty($child['receiver'])) {
 823                         $uid = ActivityPub\Receiver::getFirstUserFromReceivers($child['receiver']);
 824                 } else {
 825                         $uid = 0;
 826                 }
 827
 828                 $object = ActivityPub::fetchContent($url, $uid);
 829                 if (empty($object)) {
 830                         Logger::notice('Activity was not fetchable, aborting.', ['url' => $url]);
 831                         return '';
 832                 }
 833
 834                 if (empty($object['id'])) {
 835                         Logger::notice('Activity has got not id, aborting. ', ['url' => $url, 'object' => $object]);
 836                         return '';
 837                 }
 838
 839                 if (!empty($object['actor'])) {
 840                         $object_actor = $object['actor'];
 841                 } elseif (!empty($object['attributedTo'])) {
 842                         $object_actor = $object['attributedTo'];
 843                         if (is_array($object_actor)) {
 844                                 $compacted = JsonLD::compact($object);
 845                                 $object_actor = JsonLD::fetchElement($compacted, 'as:attributedTo', '@id');
 846                         }
 847                 } else {
 848                         // Shouldn't happen
 849                         $object_actor = '';
 850                 }
 851
 852                 $signer = [$object_actor];
 853
 854                 if (!empty($child['author'])) {
 855                         $actor = $child['author'];
 856                         $signer[] = $actor;
 857                 } else {
 858                         $actor = $object_actor;
 859                 }
 860
 861                 if (!empty($object['published'])) {
 862                         $published = $object['published'];
 863                 } elseif (!empty($child['published'])) {
 864                         $published = $child['published'];
 865                 } else {
 866                         $published = DateTimeFormat::utcNow();
 867                 }
 868
 869                 $activity = [];
 870                 $activity['@context'] = $object['@context'] ?? ActivityPub::CONTEXT;
 871                 unset($object['@context']);
 872                 $activity['id'] = $object['id'];
 873                 $activity['to'] = $object['to'] ?? [];
 874                 $activity['cc'] = $object['cc'] ?? [];
 875                 $activity['actor'] = $actor;
 876                 $activity['object'] = $object;
 877                 $activity['published'] = $published;
 878                 $activity['type'] = 'Create';
 879
 880                 $ldactivity = JsonLD::compact($activity);
 881
 882                 if (!empty($relay_actor)) {
 883                         $ldactivity['thread-completion'] = $ldactivity['from-relay'] = Contact::getIdForURL($relay_actor);
 884                 } elseif (!empty($child['thread-completion'])) {
 885                         $ldactivity['thread-completion'] = $child['thread-completion'];
 886                 } else {
 887                         $ldactivity['thread-completion'] = Contact::getIdForURL($actor);
 888                 }
 889
 890                 if (!empty($relay_actor) && !self::acceptIncomingMessage($ldactivity, $object['id'])) {
 891                         return '';
 892                 }
 893
 894                 ActivityPub\Receiver::processActivity($ldactivity, json_encode($activity), $uid, true, false, $signer);
 895
 896                 Logger::notice('Activity had been fetched and processed.', ['url' => $url, 'object' => $activity['id']]);
 897
 898                 return $activity['id'];
 899         }
 900
 901         /**
 902          * Test if incoming relay messages should be accepted
 903          *
 904          * @param array $activity activity array
 905          * @param string $id      object ID
 906          * @return boolean true if message is accepted
 907          */
 908         private static function acceptIncomingMessage(array $activity, string $id)
 909         {
 910                 if (empty($activity['as:object'])) {
 911                         Logger::info('No object field in activity - accepted', ['id' => $id]);
 912                         return true;
 913                 }
 914
 915                 $replyto = JsonLD::fetchElement($activity['as:object'], 'as:inReplyTo', '@id');
 916                 $uriid = ItemURI::getIdByURI($replyto);
 917                 if (Post::exists(['uri-id' => $uriid])) {
 918                         Logger::info('Post is a reply to an existing post - accepted', ['id' => $id, 'uri-id' => $uriid, 'replyto' => $replyto]);
 919                         return true;
 920                 }
 921
 922                 $attributed_to = JsonLD::fetchElement($activity['as:object'], 'as:attributedTo', '@id');
 923                 $authorid = Contact::getIdForURL($attributed_to);
 924
 925                 $body = HTML::toBBCode(JsonLD::fetchElement($activity['as:object'], 'as:content', '@value'));
 926
 927                 $messageTags = [];
 928                 $tags = Receiver::processTags(JsonLD::fetchElementArray($activity['as:object'], 'as:tag') ?? []);
 929                 if (!empty($tags)) {
 930                         foreach ($tags as $tag) {
 931                                 if ($tag['type'] != 'Hashtag') {
 932                                         continue;
 933                                 }
 934                                 $messageTags[] = ltrim(mb_strtolower($tag['name']), '#');
 935                         }
 936                 }
 937
 938                 return Relay::isSolicitedPost($messageTags, $body, $authorid, $id, Protocol::ACTIVITYPUB);
 939         }
 940
 941         /**
 942          * perform a "follow" request
 943          *
 944          * @param array $activity
 945          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 946          * @throws \ImagickException
 947          */
 948         public static function followUser($activity)
 949         {
 950                 $uid = User::getIdForURL($activity['object_id']);
 951                 if (empty($uid)) {
 952                         return;
 953                 }
 954
 955                 $owner = User::getOwnerDataById($uid);
 956                 if (empty($owner)) {
 957                         return;
 958                 }
 959
 960                 $cid = Contact::getIdForURL($activity['actor'], $uid);
 961                 if (!empty($cid)) {
 962                         self::switchContact($cid);
 963                         Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
 964                 }
 965
 966                 $item = ['author-id' => Contact::getIdForURL($activity['actor']),
 967                         'author-link' => $activity['actor']];
 968
 969                 // Ensure that the contact has got the right network type
 970                 self::switchContact($item['author-id']);
 971
 972                 $result = Contact::addRelationship($owner, [], $item, false, $activity['content'] ?? '');
 973                 if ($result === true) {
 974                         ActivityPub\Transmitter::sendContactAccept($item['author-link'], $activity['id'], $owner['uid']);
 975                 }
 976
 977                 $cid = Contact::getIdForURL($activity['actor'], $uid);
 978                 if (empty($cid)) {
 979                         return;
 980                 }
 981
 982                 if (empty($contact)) {
 983                         Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
 984                 }
 985
 986                 Logger::notice('Follow user ' . $uid . ' from contact ' . $cid . ' with id ' . $activity['id']);
 987         }
 988
 989         /**
 990          * Update the given profile
 991          *
 992          * @param array $activity
 993          * @throws \Exception
 994          */
 995         public static function updatePerson($activity)
 996         {
 997                 if (empty($activity['object_id'])) {
 998                         return;
 999                 }
1000
1001                 Logger::info('Updating profile', ['object' => $activity['object_id']]);
1002                 Contact::updateFromProbeByURL($activity['object_id']);
1003         }
1004
1005         /**
1006          * Delete the given profile
1007          *
1008          * @param array $activity
1009          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1010          */
1011         public static function deletePerson($activity)
1012         {
1013                 if (empty($activity['object_id']) || empty($activity['actor'])) {
1014                         Logger::info('Empty object id or actor.');
1015                         return;
1016                 }
1017
1018                 if ($activity['object_id'] != $activity['actor']) {
1019                         Logger::info('Object id does not match actor.');
1020                         return;
1021                 }
1022
1023                 $contacts = DBA::select('contact', ['id'], ['nurl' => Strings::normaliseLink($activity['object_id'])]);
1024                 while ($contact = DBA::fetch($contacts)) {
1025                         Contact::remove($contact['id']);
1026                 }
1027                 DBA::close($contacts);
1028
1029                 Logger::info('Deleted contact', ['object' => $activity['object_id']]);
1030         }
1031
1032         /**
1033          * Accept a follow request
1034          *
1035          * @param array $activity
1036          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1037          * @throws \ImagickException
1038          */
1039         public static function acceptFollowUser($activity)
1040         {
1041                 $uid = User::getIdForURL($activity['object_actor']);
1042                 if (empty($uid)) {
1043                         return;
1044                 }
1045
1046                 $cid = Contact::getIdForURL($activity['actor'], $uid);
1047                 if (empty($cid)) {
1048                         Logger::info('No contact found', ['actor' => $activity['actor']]);
1049                         return;
1050                 }
1051
1052                 self::switchContact($cid);
1053
1054                 $fields = ['pending' => false];
1055
1056                 $contact = DBA::selectFirst('contact', ['rel'], ['id' => $cid]);
1057                 if ($contact['rel'] == Contact::FOLLOWER) {
1058                         $fields['rel'] = Contact::FRIEND;
1059                 }
1060
1061                 $condition = ['id' => $cid];
1062                 Contact::update($fields, $condition);
1063                 Logger::info('Accept contact request', ['contact' => $cid, 'user' => $uid]);
1064         }
1065
1066         /**
1067          * Reject a follow request
1068          *
1069          * @param array $activity
1070          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1071          * @throws \ImagickException
1072          */
1073         public static function rejectFollowUser($activity)
1074         {
1075                 $uid = User::getIdForURL($activity['object_actor']);
1076                 if (empty($uid)) {
1077                         return;
1078                 }
1079
1080                 $cid = Contact::getIdForURL($activity['actor'], $uid);
1081                 if (empty($cid)) {
1082                         Logger::info('No contact found', ['actor' => $activity['actor']]);
1083                         return;
1084                 }
1085
1086                 self::switchContact($cid);
1087
1088                 $contact = Contact::getById($cid, ['rel']);
1089                 if ($contact['rel'] == Contact::SHARING) {
1090                         Contact::remove($cid);
1091                         Logger::info('Rejected contact request - contact removed', ['contact' => $cid, 'user' => $uid]);
1092                 } elseif ($contact['rel'] == Contact::FRIEND) {
1093                         Contact::update(['rel' => Contact::FOLLOWER], ['id' => $cid]);
1094                 } else {
1095                         Logger::info('Rejected contact request', ['contact' => $cid, 'user' => $uid]);
1096                 }
1097         }
1098
1099         /**
1100          * Undo activity like "like" or "dislike"
1101          *
1102          * @param array $activity
1103          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1104          * @throws \ImagickException
1105          */
1106         public static function undoActivity($activity)
1107         {
1108                 if (empty($activity['object_id'])) {
1109                         return;
1110                 }
1111
1112                 if (empty($activity['object_actor'])) {
1113                         return;
1114                 }
1115
1116                 $author_id = Contact::getIdForURL($activity['object_actor']);
1117                 if (empty($author_id)) {
1118                         return;
1119                 }
1120
1121                 Item::markForDeletion(['uri' => $activity['object_id'], 'author-id' => $author_id, 'gravity' => GRAVITY_ACTIVITY]);
1122         }
1123
1124         /**
1125          * Activity to remove a follower
1126          *
1127          * @param array $activity
1128          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1129          * @throws \ImagickException
1130          */
1131         public static function undoFollowUser($activity)
1132         {
1133                 $uid = User::getIdForURL($activity['object_object']);
1134                 if (empty($uid)) {
1135                         return;
1136                 }
1137
1138                 $owner = User::getOwnerDataById($uid);
1139                 if (empty($owner)) {
1140                         return;
1141                 }
1142
1143                 $cid = Contact::getIdForURL($activity['actor'], $uid);
1144                 if (empty($cid)) {
1145                         Logger::info('No contact found', ['actor' => $activity['actor']]);
1146                         return;
1147                 }
1148
1149                 self::switchContact($cid);
1150
1151                 $contact = DBA::selectFirst('contact', [], ['id' => $cid]);
1152                 if (!DBA::isResult($contact)) {
1153                         return;
1154                 }
1155
1156                 Contact::removeFollower($contact);
1157                 Logger::info('Undo following request', ['contact' => $cid, 'user' => $uid]);
1158         }
1159
1160         /**
1161          * Switches a contact to AP if needed
1162          *
1163          * @param integer $cid Contact ID
1164          * @throws \Exception
1165          */
1166         private static function switchContact($cid)
1167         {
1168                 $contact = DBA::selectFirst('contact', ['network', 'url'], ['id' => $cid]);
1169                 if (!DBA::isResult($contact) || in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN]) || Contact::isLocal($contact['url'])) {
1170                         return;
1171                 }
1172
1173                 Logger::info('Change existing contact', ['cid' => $cid, 'previous' => $contact['network']]);
1174                 Contact::updateFromProbe($cid);
1175         }
1176
1177         /**
1178          * Collects implicit mentions like:
1179          * - the author of the parent item
1180          * - all the mentioned conversants in the parent item
1181          *
1182          * @param array $parent Item array with at least ['id', 'author-link', 'alias']
1183          * @return array
1184          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1185          */
1186         private static function getImplicitMentionList(array $parent)
1187         {
1188                 $parent_terms = Tag::getByURIId($parent['uri-id'], [Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION]);
1189
1190                 $parent_author = Contact::getByURL($parent['author-link'], false, ['url', 'nurl', 'alias']);
1191
1192                 $implicit_mentions = [];
1193                 if (empty($parent_author['url'])) {
1194                         Logger::notice('Author public contact unknown.', ['author-link' => $parent['author-link'], 'parent-id' => $parent['id']]);
1195                 } else {
1196                         $implicit_mentions[] = $parent_author['url'];
1197                         $implicit_mentions[] = $parent_author['nurl'];
1198                         $implicit_mentions[] = $parent_author['alias'];
1199                 }
1200
1201                 if (!empty($parent['alias'])) {
1202                         $implicit_mentions[] = $parent['alias'];
1203                 }
1204
1205                 foreach ($parent_terms as $term) {
1206                         $contact = Contact::getByURL($term['url'], false, ['url', 'nurl', 'alias']);
1207                         if (!empty($contact['url'])) {
1208                                 $implicit_mentions[] = $contact['url'];
1209                                 $implicit_mentions[] = $contact['nurl'];
1210                                 $implicit_mentions[] = $contact['alias'];
1211                         }
1212                 }
1213
1214                 return $implicit_mentions;
1215         }
1216
1217         /**
1218          * Strips from the body prepended implicit mentions
1219          *
1220          * @param string $body
1221          * @param array $parent
1222          * @return string
1223          */
1224         private static function removeImplicitMentionsFromBody(string $body, array $parent)
1225         {
1226                 if (DI::config()->get('system', 'disable_implicit_mentions')) {
1227                         return $body;
1228                 }
1229
1230                 $potential_mentions = self::getImplicitMentionList($parent);
1231
1232                 $kept_mentions = [];
1233
1234                 // Extract one prepended mention at a time from the body
1235                 while(preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $body, $matches)) {
1236                         if (!in_array($matches[2], $potential_mentions)) {
1237                                 $kept_mentions[] = $matches[1];
1238                         }
1239
1240                         $body = $matches[3];
1241                 }
1242
1243                 // Re-appending the kept mentions to the body after extraction
1244                 $kept_mentions[] = $body;
1245
1246                 return implode('', $kept_mentions);
1247         }
1248
1249         /**
1250          * Adds links to string mentions
1251          *
1252          * @param string $body
1253          * @param array  $tags
1254          * @return string
1255          */
1256         protected static function addMentionLinks(string $body, array $tags): string
1257         {
1258                 // This prevents links to be added again to Pleroma-style mention links
1259                 $body = self::normalizeMentionLinks($body);
1260
1261                 $body = BBCode::performWithEscapedTags($body, ['url'], function ($body) use ($tags) {
1262                         foreach ($tags as $tag) {
1263                                 if (empty($tag['name']) || empty($tag['type']) || empty($tag['href']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
1264                                         continue;
1265                                 }
1266
1267                                 $hash = substr($tag['name'], 0, 1);
1268                                 $name = substr($tag['name'], 1);
1269                                 if (!in_array($hash, Tag::TAG_CHARACTER)) {
1270                                         $hash = '';
1271                                         $name = $tag['name'];
1272                                 }
1273
1274                                 $body = str_replace($tag['name'], $hash . '[url=' . $tag['href'] . ']' . $name . '[/url]', $body);
1275                         }
1276
1277                         return $body;
1278                 });
1279
1280                 return $body;
1281         }
1282 }