src/Content/Text/BBCode.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\Content\Text;
  23
  24 use DOMDocument;
  25 use DOMXPath;
  26 use Exception;
  27 use Friendica\Content\ContactSelector;
  28 use Friendica\Content\Item;
  29 use Friendica\Content\OEmbed;
  30 use Friendica\Content\PageInfo;
  31 use Friendica\Content\Smilies;
  32 use Friendica\Core\Hook;
  33 use Friendica\Core\Logger;
  34 use Friendica\Core\Protocol;
  35 use Friendica\Core\Renderer;
  36 use Friendica\DI;
  37 use Friendica\Model\Contact;
  38 use Friendica\Model\Event;
  39 use Friendica\Model\Photo;
  40 use Friendica\Model\Post;
  41 use Friendica\Model\Tag;
  42 use Friendica\Network\HTTPClient\Client\HttpClientAccept;
  43 use Friendica\Network\HTTPClient\Client\HttpClientOptions;
  44 use Friendica\Object\Image;
  45 use Friendica\Protocol\Activity;
  46 use Friendica\Util\Images;
  47 use Friendica\Util\Map;
  48 use Friendica\Util\ParseUrl;
  49 use Friendica\Util\Proxy;
  50 use Friendica\Util\Strings;
  51 use Friendica\Util\XML;
  52
  53 class BBCode
  54 {
  55         // Update this value to the current date whenever changes are made to BBCode::convert
  56         const VERSION = '2021-07-28';
  57
  58         const INTERNAL = 0;
  59         const EXTERNAL = 1;
  60         const API = 2;
  61         const DIASPORA = 3;
  62         const CONNECTORS = 4;
  63         const OSTATUS = 7;
  64         const TWITTER = 8;
  65         const BACKLINK = 8;
  66         const ACTIVITYPUB = 9;
  67
  68         const TOP_ANCHOR = '<br class="top-anchor">';
  69         const BOTTOM_ANCHOR = '<br class="button-anchor">';
  70         /**
  71          * Fetches attachment data that were generated the old way
  72          *
  73          * @param string $body Message body
  74          * @return array
  75          *                     'type' -> Message type ('link', 'video', 'photo')
  76          *                     'text' -> Text before the shared message
  77          *                     'after' -> Text after the shared message
  78          *                     'image' -> Preview image of the message
  79          *                     'url' -> Url to the attached message
  80          *                     'title' -> Title of the attachment
  81          *                     'description' -> Description of the attachment
  82          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
  83          */
  84         private static function getOldAttachmentData(string $body): array
  85         {
  86                 $post = [];
  87
  88                 // Simplify image codes
  89                 $body = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $body);
  90
  91                 if (preg_match_all("(\[class=(.*?)\](.*?)\[\/class\])ism", $body, $attached, PREG_SET_ORDER)) {
  92                         foreach ($attached as $data) {
  93                                 if (!in_array($data[1], ['type-link', 'type-video', 'type-photo'])) {
  94                                         continue;
  95                                 }
  96
  97                                 $post['type'] = substr($data[1], 5);
  98
  99                                 $pos = strpos($body, $data[0]);
 100                                 if ($pos > 0) {
 101                                         $post['text'] = trim(substr($body, 0, $pos));
 102                                         $post['after'] = trim(substr($body, $pos + strlen($data[0])));
 103                                 } else {
 104                                         $post['text'] = trim(str_replace($data[0], '', $body));
 105                                         $post['after'] = '';
 106                                 }
 107
 108                                 $attacheddata = $data[2];
 109
 110                                 if (preg_match("/\[img\](.*?)\[\/img\]/ism", $attacheddata, $matches)) {
 111
 112                                         $picturedata = Images::getInfoFromURLCached($matches[1]);
 113
 114                                         if ($picturedata) {
 115                                                 if (($picturedata[0] >= 500) && ($picturedata[0] >= $picturedata[1])) {
 116                                                         $post['image'] = $matches[1];
 117                                                 } else {
 118                                                         $post['preview'] = $matches[1];
 119                                                 }
 120                                         }
 121                                 }
 122
 123                                 if (preg_match("/\[bookmark\=(.*?)\](.*?)\[\/bookmark\]/ism", $attacheddata, $matches)) {
 124                                         $post['url'] = $matches[1];
 125                                         $post['title'] = $matches[2];
 126                                 }
 127                                 if (!empty($post['url']) && (in_array($post['type'], ['link', 'video']))
 128                                         && preg_match("/\[url\=(.*?)\](.*?)\[\/url\]/ism", $attacheddata, $matches)) {
 129                                         $post['url'] = $matches[1];
 130                                 }
 131
 132                                 // Search for description
 133                                 if (preg_match("/\[quote\](.*?)\[\/quote\]/ism", $attacheddata, $matches)) {
 134                                         $post['description'] = $matches[1];
 135                                 }
 136                         }
 137                 }
 138                 return $post;
 139         }
 140
 141         /**
 142          * Fetches attachment data that were generated with the "attachment" element
 143          *
 144          * @param string $body Message body
 145          * @return array
 146          *                     'type' -> Message type ('link', 'video', 'photo')
 147          *                     'text' -> Text before the shared message
 148          *                     'after' -> Text after the shared message
 149          *                     'image' -> Preview image of the message
 150          *                     'url' -> Url to the attached message
 151          *                     'title' -> Title of the attachment
 152          *                     'description' -> Description of the attachment
 153          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 154          */
 155         public static function getAttachmentData(string $body): array
 156         {
 157                 DI::profiler()->startRecording('rendering');
 158                 $data = [
 159                         'type'          => '',
 160                         'text'          => '',
 161                         'after'         => '',
 162                         'image'         => null,
 163                         'url'           => '',
 164                         'author_name'   => '',
 165                         'author_url'    => '',
 166                         'provider_name' => '',
 167                         'provider_url'  => '',
 168                         'title'         => '',
 169                         'description'   => '',
 170                 ];
 171
 172                 if (!preg_match("/(.*)\[attachment(.*?)\](.*?)\[\/attachment\](.*)/ism", $body, $match)) {
 173                         DI::profiler()->stopRecording();
 174                         return self::getOldAttachmentData($body);
 175                 }
 176
 177                 $attributes = $match[2];
 178
 179                 $data['text'] = trim($match[1]);
 180
 181                 foreach (['type', 'url', 'title', 'image', 'preview', 'publisher_name', 'publisher_url', 'author_name', 'author_url'] as $field) {
 182                         preg_match('/' . preg_quote($field, '/') . '=("|\')(.*?)\1/ism', $attributes, $matches);
 183                         $value = $matches[2] ?? '';
 184
 185                         if ($value != '') {
 186                                 switch ($field) {
 187                                         case 'publisher_name':
 188                                                 $data['provider_name'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 189                                                 break;
 190
 191                                         case 'publisher_url':
 192                                                 $data['provider_url'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 193                                                 break;
 194
 195                                         case 'author_name':
 196                                                 $data['author_name'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 197                                                 if ($data['provider_name'] == $data['author_name']) {
 198                                                         $data['author_name'] = '';
 199                                                 }
 200                                                 break;
 201
 202                                         case 'author_url':
 203                                                 $data['author_url'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 204                                                 if ($data['provider_url'] == $data['author_url']) {
 205                                                         $data['author_url'] = '';
 206                                                 }
 207                                                 break;
 208
 209                                         case 'title':
 210                                                 $value = self::convert(html_entity_decode($value, ENT_QUOTES, 'UTF-8'), false, true);
 211                                                 $value = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 212                                                 $value = str_replace(['[', ']'], ['&#91;', '&#93;'], $value);
 213                                                 $data['title'] = $value;
 214
 215                                         default:
 216                                                 $data[$field] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
 217                                                 break;
 218                                 }
 219                         }
 220                 }
 221
 222                 if (!in_array($data['type'], ['link', 'audio', 'photo', 'video'])) {
 223                         DI::profiler()->stopRecording();
 224                         return [];
 225                 }
 226
 227                 $data['description'] = trim($match[3]);
 228
 229                 $data['after'] = trim($match[4]);
 230
 231                 $parts = parse_url($data['url']);
 232                 if (!empty($parts['scheme']) && !empty($parts['host'])) {
 233                         if (empty($data['provider_name'])) {
 234                                 $data['provider_name'] = $parts['host'];
 235                         }
 236                         if (empty($data['provider_url']) || empty(parse_url($data['provider_url'], PHP_URL_SCHEME))) {
 237                                 $data['provider_url'] = $parts['scheme'] . '://' . $parts['host'];
 238
 239                                 if (!empty($parts['port'])) {
 240                                         $data['provider_url'] .= ':' . $parts['port'];
 241                                 }
 242                         }
 243                 }
 244
 245                 DI::profiler()->stopRecording();
 246                 return $data;
 247         }
 248
 249         public static function getAttachedData(string $body, array $item = []): array
 250         {
 251                 /*
 252                 - text:
 253                 - type: link, video, photo
 254                 - title:
 255                 - url:
 256                 - image:
 257                 - description:
 258                 - (thumbnail)
 259                 */
 260
 261                 DI::profiler()->startRecording('rendering');
 262                 $has_title = !empty($item['title']);
 263                 $plink = $item['plink'] ?? '';
 264                 $post = self::getAttachmentData($body);
 265
 266                 // Get all linked images with alternative image description
 267                 if (preg_match_all("/\[img=(http[^\[\]]*)\]([^\[\]]*)\[\/img\]/Usi", $body, $pictures, PREG_SET_ORDER)) {
 268                         foreach ($pictures as $picture) {
 269                                 if (Photo::isLocal($picture[1])) {
 270                                         $post['images'][] = ['url' => str_replace('-1.', '-0.', $picture[1]), 'description' => $picture[2]];
 271                                 } else {
 272                                         $post['remote_images'][] = ['url' => $picture[1], 'description' => $picture[2]];
 273                                 }
 274                         }
 275                         if (!empty($post['images']) && !empty($post['images'][0]['description'])) {
 276                                 $post['image_description'] = $post['images'][0]['description'];
 277                         }
 278                 }
 279
 280                 if (preg_match_all("/\[img\]([^\[\]]*)\[\/img\]/Usi", $body, $pictures, PREG_SET_ORDER)) {
 281                         foreach ($pictures as $picture) {
 282                                 if (Photo::isLocal($picture[1])) {
 283                                         $post['images'][] = ['url' => str_replace('-1.', '-0.', $picture[1]), 'description' => ''];
 284                                 } else {
 285                                         $post['remote_images'][] = ['url' => $picture[1], 'description' => ''];
 286                                 }
 287                         }
 288                 }
 289
 290                 // if nothing is found, it maybe having an image.
 291                 if (!isset($post['type'])) {
 292                         // Simplify image codes
 293                         $body = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $body);
 294                         $body = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", '[img]$1[/img]', $body);
 295                         $post['text'] = $body;
 296
 297                         if (preg_match_all("#\[url=([^\]]+?)\]\s*\[img\]([^\[]+?)\[/img\]\s*\[/url\]#ism", $body, $pictures, PREG_SET_ORDER)) {
 298                                 if ((count($pictures) == 1) && !$has_title) {
 299                                         if (!empty($item['object-type']) && ($item['object-type'] == Activity\ObjectType::IMAGE)) {
 300                                                 // Replace the preview picture with the real picture
 301                                                 $url = str_replace('-1.', '-0.', $pictures[0][2]);
 302                                                 $data = ['url' => $url, 'type' => 'photo'];
 303                                         } else {
 304                                                 // Checking, if the link goes to a picture
 305                                                 $data = ParseUrl::getSiteinfoCached($pictures[0][1]);
 306                                         }
 307
 308                                         // Workaround:
 309                                         // Sometimes photo posts to the own album are not detected at the start.
 310                                         // So we seem to cannot use the cache for these cases. That's strange.
 311                                         if (($data['type'] != 'photo') && strstr($pictures[0][1], '/photos/')) {
 312                                                 $data = ParseUrl::getSiteinfo($pictures[0][1]);
 313                                         }
 314
 315                                         if ($data['type'] == 'photo') {
 316                                                 $post['type'] = 'photo';
 317                                                 if (isset($data['images'][0])) {
 318                                                         $post['image'] = $data['images'][0]['src'];
 319                                                         $post['url'] = $data['url'];
 320                                                 } else {
 321                                                         $post['image'] = $data['url'];
 322                                                 }
 323
 324                                                 $post['preview'] = $pictures[0][2];
 325                                                 $post['text'] = trim(str_replace($pictures[0][0], '', $body));
 326                                         } else {
 327                                                 $imgdata = Images::getInfoFromURLCached($pictures[0][1]);
 328                                                 if (($imgdata) && substr($imgdata['mime'], 0, 6) == 'image/') {
 329                                                         $post['type'] = 'photo';
 330                                                         $post['image'] = $pictures[0][1];
 331                                                         $post['preview'] = $pictures[0][2];
 332                                                         $post['text'] = trim(str_replace($pictures[0][0], '', $body));
 333                                                 }
 334                                         }
 335                                 } elseif (count($pictures) > 0) {
 336                                         if (count($pictures) > 4) {
 337                                                 $post['type'] = 'link';
 338                                                 $post['url'] = $plink;
 339                                         } else {
 340                                                 $post['type'] = 'photo';
 341                                         }
 342
 343                                         $post['image'] = $pictures[0][2];
 344                                         $post['text'] = $body;
 345
 346                                         foreach ($pictures as $picture) {
 347                                                 $post['text'] = trim(str_replace($picture[0], '', $post['text']));
 348                                         }
 349                                 }
 350                         } elseif (preg_match_all("(\[img\](.*?)\[\/img\])ism", $body, $pictures, PREG_SET_ORDER)) {
 351                                 if ($has_title) {
 352                                         $post['type'] = 'link';
 353                                         $post['url'] = $plink;
 354                                 } else {
 355                                         $post['type'] = 'photo';
 356                                 }
 357
 358                                 $post['image'] = $pictures[0][1];
 359                                 $post['text'] = $body;
 360                                 foreach ($pictures as $picture) {
 361                                         $post['text'] = trim(str_replace($picture[0], '', $post['text']));
 362                                 }
 363                         }
 364
 365                         // Test for the external links
 366                         preg_match_all("(\[url\](.*?)\[\/url\])ism", $post['text'], $links1, PREG_SET_ORDER);
 367                         preg_match_all("(\[url\=(.*?)\].*?\[\/url\])ism", $post['text'], $links2, PREG_SET_ORDER);
 368
 369                         $links = array_merge($links1, $links2);
 370
 371                         // If there is only a single one, then use it.
 372                         // This should cover link posts via API.
 373                         if ((count($links) == 1) && !isset($post['preview']) && !$has_title) {
 374                                 $post['type'] = 'link';
 375                                 $post['url'] = $links[0][1];
 376                         }
 377
 378                         // Simplify "video" element
 379                         $post['text'] = preg_replace('(\[video.*?\ssrc\s?=\s?([^\s\]]+).*?\].*?\[/video\])ism', '[video]$1[/video]', $post['text']);
 380
 381                         // Now count the number of external media links
 382                         preg_match_all("(\[vimeo\](.*?)\[\/vimeo\])ism", $post['text'], $links1, PREG_SET_ORDER);
 383                         preg_match_all("(\[youtube\\](.*?)\[\/youtube\\])ism", $post['text'], $links2, PREG_SET_ORDER);
 384                         preg_match_all("(\[video\\](.*?)\[\/video\\])ism", $post['text'], $links3, PREG_SET_ORDER);
 385                         preg_match_all("(\[audio\\](.*?)\[\/audio\\])ism", $post['text'], $links4, PREG_SET_ORDER);
 386
 387                         // Add them to the other external links
 388                         $links = array_merge($links, $links1, $links2, $links3, $links4);
 389
 390                         // Are there more than one?
 391                         if (count($links) > 1) {
 392                                 // The post will be the type "text", which means a blog post
 393                                 unset($post['type']);
 394                                 $post['url'] = $plink;
 395                         }
 396
 397                         if (!isset($post['type'])) {
 398                                 $post['type'] = 'text';
 399                                 $post['text'] = trim($body);
 400                         }
 401
 402                         if (($post['type'] == 'photo') && empty($post['images']) && !empty($post['remote_images'])) {
 403                                 $post['images'] = $post['remote_images'];
 404                                 $post['image'] = $post['images'][0]['url'];
 405                                 if (!empty($post['images']) && !empty($post['images'][0]['description'])) {
 406                                         $post['image_description'] = $post['images'][0]['description'];
 407                                 }
 408                         }
 409                         unset($post['remote_images']);
 410                 } elseif (isset($post['url']) && ($post['type'] == 'video')) {
 411                         $data = ParseUrl::getSiteinfoCached($post['url']);
 412
 413                         if (isset($data['images'][0])) {
 414                                 $post['image'] = $data['images'][0]['src'];
 415                         }
 416                 }
 417
 418                 DI::profiler()->stopRecording();
 419                 return $post;
 420         }
 421
 422         /**
 423          * Remove [attachment] BBCode and replaces it with a regular [url]
 424          *
 425          * @param string  $body
 426          * @param boolean $no_link_desc No link description
 427          *
 428          * @return string with replaced body
 429          */
 430         public static function removeAttachment(string $body, bool $no_link_desc = false): string
 431         {
 432                 return preg_replace_callback("/\s*\[attachment (.*?)\](.*?)\[\/attachment\]\s*/ism",
 433                         function ($match) use ($body, $no_link_desc) {
 434                                 $attach_data = self::getAttachmentData($match[0]);
 435                                 if (empty($attach_data['url'])) {
 436                                         return $match[0];
 437                                 } elseif (strpos(str_replace($match[0], '', $body), $attach_data['url']) !== false) {
 438                                         return '';
 439                                 } elseif (empty($attach_data['title']) || $no_link_desc) {
 440                                         return " \n[url]" . $attach_data['url'] . "[/url]\n";
 441                                 } else {
 442                                         return " \n[url=" . $attach_data['url'] . ']' . $attach_data['title'] . "[/url]\n";
 443                                 }
 444                 }, $body);
 445         }
 446
 447         /**
 448          * Converts a BBCode text into plaintext
 449          *
 450          * @param string $text
 451          * @param bool $keep_urls Whether to keep URLs in the resulting plaintext
 452          *
 453          * @return string
 454          */
 455         public static function toPlaintext(string $text, bool $keep_urls = true): string
 456         {
 457                 DI::profiler()->startRecording('rendering');
 458                 // Remove pictures in advance to avoid unneeded proxy calls
 459                 $text = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", ' $2 ', $text);
 460                 $text = preg_replace("/\[img.*?\[\/img\]/ism", ' ', $text);
 461
 462                 // Remove attachment
 463                 $text = self::removeAttachment($text);
 464
 465                 $naked_text = HTML::toPlaintext(self::convert($text, false, 0, true), 0, !$keep_urls);
 466
 467                 DI::profiler()->stopRecording();
 468                 return $naked_text;
 469         }
 470
 471         private static function proxyUrl(string $image, int $simplehtml = self::INTERNAL, int $uriid = 0, string $size = ''): string
 472         {
 473                 // Only send proxied pictures to API and for internal display
 474                 if (!in_array($simplehtml, [self::INTERNAL, self::API])) {
 475                         return $image;
 476                 } elseif ($uriid > 0) {
 477                         return Post\Link::getByLink($uriid, $image, $size);
 478                 } else {
 479                         return Proxy::proxifyUrl($image, $size);
 480                 }
 481         }
 482
 483         /**
 484          * This function changing the visual size (not the real size) of images.
 485          * The function does not work for pictures with an alternate text description.
 486          * This could only be changed by using some new "img" BBCode format.
 487          *
 488          * @param string $srctext The body with images
 489          * @return string The body with possibly scaled images
 490          */
 491         public static function scaleExternalImages(string $srctext): string
 492         {
 493                 DI::profiler()->startRecording('rendering');
 494                 $s = $srctext;
 495
 496                 // Simplify image links
 497                 $s = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $s);
 498
 499                 $matches = null;
 500                 $c = preg_match_all('/\[img.*?\](.*?)\[\/img\]/ism', $s, $matches, PREG_SET_ORDER);
 501                 if ($c) {
 502                         foreach ($matches as $mtch) {
 503                                 Logger::info('scale_external_image', ['image' => $mtch[1]]);
 504
 505                                 $hostname = str_replace('www.', '', substr(DI::baseUrl(), strpos(DI::baseUrl(), '://') + 3));
 506                                 if (stristr($mtch[1], $hostname)) {
 507                                         continue;
 508                                 }
 509
 510                                 $curlResult = DI::httpClient()->get($mtch[1], HttpClientAccept::IMAGE);
 511                                 if (!$curlResult->isSuccess()) {
 512                                         continue;
 513                                 }
 514
 515                                 Logger::debug('Got picture', ['Content-Type' => $curlResult->getHeader('Content-Type'), 'url' => $mtch[1]]);
 516
 517                                 $i = $curlResult->getBody();
 518                                 $type = $curlResult->getContentType();
 519                                 $type = Images::getMimeTypeByData($i, $mtch[1], $type);
 520
 521                                 if ($i) {
 522                                         $Image = new Image($i, $type);
 523                                         if ($Image->isValid()) {
 524                                                 $orig_width = $Image->getWidth();
 525                                                 $orig_height = $Image->getHeight();
 526
 527                                                 if ($orig_width > 640 || $orig_height > 640) {
 528                                                         $Image->scaleDown(640);
 529                                                         $new_width = $Image->getWidth();
 530                                                         $new_height = $Image->getHeight();
 531                                                         Logger::info('External images scaled', ['orig_width' => $orig_width, 'new_width' => $new_width, 'orig_height' => $orig_height, 'new_height' => $new_height, 'match' => $mtch[0]]);
 532                                                         $s = str_replace(
 533                                                                 $mtch[0],
 534                                                                 '[img=' . $new_width . 'x' . $new_height. ']' . $mtch[1] . '[/img]'
 535                                                                 . "\n",
 536                                                                 $s
 537                                                         );
 538                                                         Logger::info('New string', ['image' => $s]);
 539                                                 }
 540                                         }
 541                                 }
 542                         }
 543                 }
 544
 545                 DI::profiler()->stopRecording();
 546                 return $s;
 547         }
 548
 549         /**
 550          * Truncates imported message body string length to max_import_size
 551          *
 552          * The purpose of this function is to apply system message length limits to
 553          * imported messages without including any embedded photos in the length
 554          *
 555          * @param string $body
 556          * @return string
 557          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 558          */
 559         public static function limitBodySize(string $body): string
 560         {
 561                 DI::profiler()->startRecording('rendering');
 562                 $maxlen = DI::config()->get('config', 'max_import_size', 0);
 563
 564                 // If the length of the body, including the embedded images, is smaller
 565                 // than the maximum, then don't waste time looking for the images
 566                 if ($maxlen && (strlen($body) > $maxlen)) {
 567
 568                         Logger::info('the total body length exceeds the limit', ['maxlen' => $maxlen, 'body_len' => strlen($body)]);
 569
 570                         $orig_body = $body;
 571                         $new_body = '';
 572                         $textlen = 0;
 573
 574                         $img_start = strpos($orig_body, '[img');
 575                         $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
 576                         $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
 577                         while (($img_st_close !== false) && ($img_end !== false)) {
 578
 579                                 $img_st_close++; // make it point to AFTER the closing bracket
 580                                 $img_end += $img_start;
 581                                 $img_end += strlen('[/img]');
 582
 583                                 if (!strcmp(substr($orig_body, $img_start + $img_st_close, 5), 'data:')) {
 584                                         // This is an embedded image
 585
 586                                         if (($textlen + $img_start) > $maxlen) {
 587                                                 if ($textlen < $maxlen) {
 588                                                         Logger::info('the limit happens before an embedded image');
 589                                                         $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
 590                                                         $textlen = $maxlen;
 591                                                 }
 592                                         } else {
 593                                                 $new_body = $new_body . substr($orig_body, 0, $img_start);
 594                                                 $textlen += $img_start;
 595                                         }
 596
 597                                         $new_body = $new_body . substr($orig_body, $img_start, $img_end - $img_start);
 598                                 } else {
 599
 600                                         if (($textlen + $img_end) > $maxlen) {
 601                                                 if ($textlen < $maxlen) {
 602                                                         Logger::info('the limit happens before the end of a non-embedded image');
 603                                                         $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
 604                                                         $textlen = $maxlen;
 605                                                 }
 606                                         } else {
 607                                                 $new_body = $new_body . substr($orig_body, 0, $img_end);
 608                                                 $textlen += $img_end;
 609                                         }
 610                                 }
 611                                 $orig_body = substr($orig_body, $img_end);
 612
 613                                 if ($orig_body === false) {
 614                                         // in case the body ends on a closing image tag
 615                                         $orig_body = '';
 616                                 }
 617
 618                                 $img_start = strpos($orig_body, '[img');
 619                                 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
 620                                 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
 621                         }
 622
 623                         if (($textlen + strlen($orig_body)) > $maxlen) {
 624                                 if ($textlen < $maxlen) {
 625                                         Logger::info('the limit happens after the end of the last image');
 626                                         $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
 627                                 }
 628                         } else {
 629                                 Logger::info('the text size with embedded images extracted did not violate the limit');
 630                                 $new_body = $new_body . $orig_body;
 631                         }
 632
 633                         DI::profiler()->stopRecording();
 634                         return $new_body;
 635                 } else {
 636                         DI::profiler()->stopRecording();
 637                         return $body;
 638                 }
 639         }
 640
 641         /**
 642          * Processes [attachment] tags
 643          *
 644          * Note: Can produce a [bookmark] tag in the returned string
 645          *
 646          * @param string  $text
 647          * @param integer $simplehtml
 648          * @param bool    $tryoembed
 649          * @param array   $data
 650          * @param int     $uriid
 651          * @return string
 652          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
 653          */
 654         public static function convertAttachment(string $text, int $simplehtml = self::INTERNAL, bool $tryoembed = true, array $data = [], int $uriid = 0): string
 655         {
 656                 DI::profiler()->startRecording('rendering');
 657                 $data = $data ?: self::getAttachmentData($text);
 658                 if (empty($data) || empty($data['url'])) {
 659                         DI::profiler()->stopRecording();
 660                         return $text;
 661                 }
 662
 663                 if (isset($data['title'])) {
 664                         $data['title'] = strip_tags($data['title']);
 665                         $data['title'] = str_replace(['http://', 'https://'], '', $data['title']);
 666                 } else {
 667                         $data['title'] = '';
 668                 }
 669
 670                 if (((strpos($data['text'], '[img=') !== false) || (strpos($data['text'], '[img]') !== false) || DI::config()->get('system', 'always_show_preview')) && !empty($data['image'])) {
 671                         $data['preview'] = $data['image'];
 672                         $data['image'] = '';
 673                 }
 674
 675                 $return = '';
 676                 try {
 677                         if ($tryoembed && OEmbed::isAllowedURL($data['url'])) {
 678                                 $return = OEmbed::getHTML($data['url'], $data['title']);
 679                         } else {
 680                                 throw new Exception('OEmbed is disabled for this attachment.');
 681                         }
 682                 } catch (Exception $e) {
 683                         $data['title'] = ($data['title'] ?? '') ?: $data['url'];
 684
 685                         if ($simplehtml != self::CONNECTORS) {
 686                                 $return = sprintf('<div class="type-%s">', $data['type']);
 687                         }
 688
 689                         if (!empty($data['title']) && !empty($data['url'])) {
 690                                 if (!empty($data['image']) && empty($data['text']) && ($data['type'] == 'photo')) {
 691                                         $return .= sprintf('<a href="%s" target="_blank" rel="noopener noreferrer"><img src="%s" alt="" title="%s" class="attachment-image" /></a>', $data['url'], self::proxyUrl($data['image'], $simplehtml, $uriid), $data['title']);
 692                                 } else {
 693                                         if (!empty($data['image'])) {
 694                                                 $return .= sprintf('<a href="%s" target="_blank" rel="noopener noreferrer"><img src="%s" alt="" title="%s" class="attachment-image" /></a><br>', $data['url'], self::proxyUrl($data['image'], $simplehtml, $uriid), $data['title']);
 695                                         } elseif (!empty($data['preview'])) {
 696                                                 $return .= sprintf('<a href="%s" target="_blank" rel="noopener noreferrer"><img src="%s" alt="" title="%s" class="attachment-preview" /></a><br>', $data['url'], self::proxyUrl($data['preview'], $simplehtml, $uriid), $data['title']);
 697                                         }
 698                                         $return .= sprintf('<h4><a href="%s" target="_blank" rel="noopener noreferrer">%s</a></h4>', $data['url'], $data['title']);
 699                                 }
 700                         }
 701
 702                         if (!empty($data['description']) && $data['description'] != $data['title']) {
 703                                 // Sanitize the HTML
 704                                 $return .= sprintf('<blockquote>%s</blockquote>', trim(HTML::purify($data['description'])));
 705                         }
 706
 707                         if (!empty($data['provider_url']) && !empty($data['provider_name'])) {
 708                                 if (!empty($data['author_name'])) {
 709                                         $return .= sprintf('<sup><a href="%s" target="_blank" rel="noopener noreferrer">%s (%s)</a></sup>', $data['provider_url'], $data['author_name'], $data['provider_name']);
 710                                 } else {
 711                                         $return .= sprintf('<sup><a href="%s" target="_blank" rel="noopener noreferrer">%s</a></sup>', $data['provider_url'], $data['provider_name']);
 712                                 }
 713                         }
 714
 715                         if ($simplehtml != self::CONNECTORS) {
 716                                 $return .= '</div>';
 717                         }
 718                 }
 719
 720                 DI::profiler()->stopRecording();
 721                 return trim(($data['text'] ?? '') . ' ' . $return . ' ' . ($data['after'] ?? ''));
 722         }
 723
 724         public static function removeShareInformation(string $text, bool $plaintext = false, bool $nolink = false): string
 725         {
 726                 DI::profiler()->startRecording('rendering');
 727                 $data = self::getAttachmentData($text);
 728
 729                 if (!$data) {
 730                         DI::profiler()->stopRecording();
 731                         return $text;
 732                 } elseif ($nolink) {
 733                         DI::profiler()->stopRecording();
 734                         return $data['text'] . ($data['after'] ?? '');
 735                 }
 736
 737                 $title = htmlentities($data['title'] ?? '', ENT_QUOTES, 'UTF-8', false);
 738                 $text = htmlentities($data['text'], ENT_QUOTES, 'UTF-8', false);
 739                 if ($plaintext || (($title != '') && strstr($text, $title))) {
 740                         $data['title'] = $data['url'];
 741                 } elseif (($text != '') && strstr($title, $text)) {
 742                         $data['text'] = $data['title'];
 743                         $data['title'] = $data['url'];
 744                 }
 745
 746                 if (empty($data['text']) && !empty($data['title']) && empty($data['url'])) {
 747                         DI::profiler()->stopRecording();
 748                         return $data['title'] . $data['after'];
 749                 }
 750
 751                 // If the link already is included in the post, don't add it again
 752                 if (!empty($data['url']) && strpos($data['text'], $data['url'])) {
 753                         DI::profiler()->stopRecording();
 754                         return $data['text'] . $data['after'];
 755                 }
 756
 757                 $text = $data['text'];
 758
 759                 if (!empty($data['url']) && !empty($data['title'])) {
 760                         $text .= "\n[url=" . $data['url'] . ']' . $data['title'] . '[/url]';
 761                 } elseif (!empty($data['url'])) {
 762                         $text .= "\n[url]" . $data['url'] . '[/url]';
 763                 }
 764
 765                 DI::profiler()->stopRecording();
 766                 return $text . "\n" . $data['after'];
 767         }
 768
 769         /**
 770          * Converts [url] BBCodes in a format that looks fine on Mastodon. (callback function)
 771          *
 772          * @param array $match Array with the matching values
 773          * @return string reformatted link including HTML codes
 774          */
 775         private static function convertUrlForActivityPubCallback(array $match): string
 776         {
 777                 $url = $match[1];
 778
 779                 if (isset($match[2]) && ($match[1] != $match[2])) {
 780                         return $match[0];
 781                 }
 782
 783                 $parts = parse_url($url);
 784                 if (!isset($parts['scheme'])) {
 785                         return $match[0];
 786                 }
 787
 788                 return self::convertUrlForActivityPub($url);
 789         }
 790
 791         /**
 792          * Converts [url] BBCodes in a format that looks fine on ActivityPub systems.
 793          *
 794          * @param string $url URL that is about to be reformatted
 795          * @return string reformatted link including HTML codes
 796          */
 797         private static function convertUrlForActivityPub(string $url): string
 798         {
 799                 return sprintf('<a href="%s" target="_blank" rel="noopener noreferrer">%s</a>', $url, self::getStyledURL($url));
 800         }
 801
 802         /**
 803          * Converts an URL in a nicer format (without the scheme and possibly shortened)
 804          *
 805          * @param string $url URL that is about to be reformatted
 806          * @return string reformatted link
 807          */
 808         private static function getStyledURL(string $url): string
 809         {
 810                 $parts = parse_url($url);
 811                 $scheme = $parts['scheme'] . '://';
 812                 $styled_url = str_replace($scheme, '', $url);
 813
 814                 if (strlen($styled_url) > 30) {
 815                         $styled_url = substr($styled_url, 0, 30) . "…";
 816                 }
 817
 818                 return $styled_url;
 819         }
 820
 821         /*
 822          * [noparse][i]italic[/i][/noparse] turns into
 823          * [noparse][ i ]italic[ /i ][/noparse],
 824          * to hide them from parser.
 825          *
 826          * @param array $match
 827          * @return string
 828          */
 829         private static function escapeNoparseCallback(array $match): string
 830         {
 831                 $whole_match = $match[0];
 832                 $captured = $match[1];
 833                 $spacefied = preg_replace("/\[(.*?)\]/", "[ $1 ]", $captured);
 834                 $new_str = str_replace($captured, $spacefied, $whole_match);
 835                 return $new_str;
 836         }
 837
 838         /*
 839          * The previously spacefied [noparse][ i ]italic[ /i ][/noparse],
 840          * now turns back and the [noparse] tags are trimed
 841          * returning [i]italic[/i]
 842          *
 843          * @param array $match
 844          * @return string
 845          */
 846         private static function unescapeNoparseCallback(array $match): string
 847         {
 848                 $captured = $match[1];
 849                 $unspacefied = preg_replace("/\[ (.*?)\ ]/", "[$1]", $captured);
 850                 return $unspacefied;
 851         }
 852
 853         /**
 854          * Returns the bracket character positions of a set of opening and closing BBCode tags, optionally skipping first
 855          * occurrences
 856          *
 857          * @param string $text        Text to search
 858          * @param string $name        Tag name
 859          * @param int    $occurrences Number of first occurrences to skip
 860          * @return boolean|array
 861          */
 862         public static function getTagPosition(string $text, string $name, int $occurrences = 0)
 863         {
 864                 DI::profiler()->startRecording('rendering');
 865                 if ($occurrences < 0) {
 866                         $occurrences = 0;
 867                 }
 868
 869                 $start_open = -1;
 870                 for ($i = 0; $i <= $occurrences; $i++) {
 871                         if ($start_open !== false) {
 872                                 $start_open = strpos($text, '[' . $name, $start_open + 1); // allow [name= type tags
 873                         }
 874                 }
 875
 876                 if ($start_open === false) {
 877                         DI::profiler()->stopRecording();
 878                         return false;
 879                 }
 880
 881                 $start_equal = strpos($text, '=', $start_open);
 882                 $start_close = strpos($text, ']', $start_open);
 883
 884                 if ($start_close === false) {
 885                         DI::profiler()->stopRecording();
 886                         return false;
 887                 }
 888
 889                 $start_close++;
 890
 891                 $end_open = strpos($text, '[/' . $name . ']', $start_close);
 892
 893                 if ($end_open === false) {
 894                         DI::profiler()->stopRecording();
 895                         return false;
 896                 }
 897
 898                 $res = [
 899                         'start' => [
 900                                 'open' => $start_open,
 901                                 'close' => $start_close
 902                         ],
 903                         'end' => [
 904                                 'open' => $end_open,
 905                                 'close' => $end_open + strlen('[/' . $name . ']')
 906                         ],
 907                 ];
 908
 909                 if ($start_equal !== false) {
 910                         $res['start']['equal'] = $start_equal + 1;
 911                 }
 912
 913                 DI::profiler()->stopRecording();
 914                 return $res;
 915         }
 916
 917         /**
 918          * Performs a preg_replace within the boundaries of all named BBCode tags in a text
 919          *
 920          * @param string $pattern Preg pattern string
 921          * @param string $replace Preg replace string
 922          * @param string $name    BBCode tag name
 923          * @param string $text    Text to search
 924          * @return string
 925          */
 926         public static function pregReplaceInTag(string $pattern, string $replace, string $name, string $text): string
 927         {
 928                 DI::profiler()->startRecording('rendering');
 929                 $occurrences = 0;
 930                 $pos = self::getTagPosition($text, $name, $occurrences);
 931                 while ($pos !== false && $occurrences++ < 1000) {
 932                         $start = substr($text, 0, $pos['start']['open']);
 933                         $subject = substr($text, $pos['start']['open'], $pos['end']['close'] - $pos['start']['open']);
 934                         $end = substr($text, $pos['end']['close']);
 935                         if ($end === false) {
 936                                 $end = '';
 937                         }
 938
 939                         $subject = preg_replace($pattern, $replace, $subject);
 940                         $text = $start . $subject . $end;
 941
 942                         $pos = self::getTagPosition($text, $name, $occurrences);
 943                 }
 944
 945                 DI::profiler()->stopRecording();
 946                 return $text;
 947         }
 948
 949         private static function extractImagesFromItemBody(string $body): array
 950         {
 951                 $saved_image = [];
 952                 $orig_body = $body;
 953                 $new_body = '';
 954
 955                 $cnt = 0;
 956                 $img_start = strpos($orig_body, '[img');
 957                 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
 958                 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
 959                 while (($img_st_close !== false) && ($img_end !== false)) {
 960                         $img_st_close++; // make it point to AFTER the closing bracket
 961                         $img_end += $img_start;
 962
 963                         if (!strcmp(substr($orig_body, $img_start + $img_st_close, 5), 'data:')) {
 964                                 // This is an embedded image
 965                                 $saved_image[$cnt] = substr($orig_body, $img_start + $img_st_close, $img_end - ($img_start + $img_st_close));
 966                                 $new_body = $new_body . substr($orig_body, 0, $img_start) . '[$#saved_image' . $cnt . '#$]';
 967
 968                                 $cnt++;
 969                         } else {
 970                                 $new_body = $new_body . substr($orig_body, 0, $img_end + strlen('[/img]'));
 971                         }
 972
 973                         $orig_body = substr($orig_body, $img_end + strlen('[/img]'));
 974
 975                         if ($orig_body === false) {
 976                                 // in case the body ends on a closing image tag
 977                                 $orig_body = '';
 978                         }
 979
 980                         $img_start = strpos($orig_body, '[img');
 981                         $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
 982                         $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
 983                 }
 984
 985                 $new_body = $new_body . $orig_body;
 986
 987                 return ['body' => $new_body, 'images' => $saved_image];
 988         }
 989
 990         private static function interpolateSavedImagesIntoItemBody(int $uriid, string $body, array $images): string
 991         {
 992                 $newbody = $body;
 993
 994                 $cnt = 0;
 995                 foreach ($images as $image) {
 996                         // We're depending on the property of 'foreach' (specified on the PHP website) that
 997                         // it loops over the array starting from the first element and going sequentially
 998                         // to the last element
 999                         $newbody = str_replace('[$#saved_image' . $cnt . '#$]',
1000                                 '<img src="' . self::proxyUrl($image, self::INTERNAL, $uriid) . '" alt="' . DI::l10n()->t('Image/photo') . '" />', $newbody);
1001                         $cnt++;
1002                 }
1003
1004                 return $newbody;
1005         }
1006
1007         /**
1008          * @param string $text A BBCode string
1009          * @return array Empty array if no share tag is present or the following array, missing attributes end up empty strings:
1010          *               - comment: Text before the opening share tag
1011          *               - shared : Text inside the share tags
1012          *               - author : (Optional) Display name of the shared author
1013          *               - profile: (Optional) Profile page URL of the shared author
1014          *               - avatar : (Optional) Profile picture URL of the shared author
1015          *               - link   : (Optional) Canonical URL of the shared post
1016          *               - posted : (Optional) Date the shared post was initially posted ("Y-m-d H:i:s" in GMT)
1017          *               - guid   : (Optional) Shared post GUID if any
1018          */
1019         public static function fetchShareAttributes(string $text): array
1020         {
1021                 DI::profiler()->startRecording('rendering');
1022                 // See Issue https://github.com/friendica/friendica/issues/10454
1023                 // Hashtags in usernames are expanded to links. This here is a quick fix.
1024                 $text = preg_replace('~([@!#])\[url=.*?](.*?)\[/url]~ism', '$1$2', $text);
1025
1026                 if (!preg_match('~(.*?)\[share(.*?)](.*)\[/share]~ism', $text, $matches)) {
1027                         DI::profiler()->stopRecording();
1028                         return [];
1029                 }
1030
1031                 $attributes = self::extractShareAttributes($matches[2]);
1032
1033                 $attributes['comment'] = trim($matches[1]);
1034                 $attributes['shared'] = trim($matches[3]);
1035
1036                 DI::profiler()->stopRecording();
1037                 return $attributes;
1038         }
1039
1040         /**
1041          * @see BBCode::fetchShareAttributes()
1042          * @param string $shareString Internal opening share tag string matched by the regular expression
1043          * @return array A fixed attribute array where missing attribute are represented by empty strings
1044          */
1045         private static function extractShareAttributes(string $shareString): array
1046         {
1047                 $attributes = [];
1048                 foreach (['author', 'profile', 'avatar', 'link', 'posted', 'guid'] as $field) {
1049                         preg_match("/$field=(['\"])(.+?)\\1/ism", $shareString, $matches);
1050                         $attributes[$field] = html_entity_decode($matches[2] ?? '', ENT_QUOTES, 'UTF-8');
1051                 }
1052
1053                 return $attributes;
1054         }
1055
1056         /**
1057          * This function converts a [share] block to text according to a provided callback function whose signature is:
1058          *
1059          * function(array $attributes, array $author_contact, string $content, boolean $is_quote_share): string
1060          *
1061          * Where:
1062          * - $attributes is an array of attributes of the [share] block itself. Missing keys will be completed by the contact
1063          * data lookup
1064          * - $author_contact is a contact record array
1065          * - $content is the inner content of the [share] block
1066          * - $is_quote_share indicates whether there's any content before the [share] block
1067          * - Return value is the string that should replace the [share] block in the provided text
1068          *
1069          * This function is intended to be used by addon connector to format a share block like the target network is expecting it.
1070          *
1071          * @param  string   $text     A BBCode string
1072          * @param  callable $callback
1073          * @return string The BBCode string with all [share] blocks replaced
1074          */
1075         public static function convertShare(string $text, callable $callback, int $uriid = 0): string
1076         {
1077                 DI::profiler()->startRecording('rendering');
1078                 $return = preg_replace_callback(
1079                         '~(.*?)\[share(.*?)](.*)\[/share]~ism',
1080                         function ($match) use ($callback, $uriid) {
1081                                 $attributes = self::extractShareAttributes($match[2]);
1082
1083                                 $author_contact = Contact::getByURL($attributes['profile'], false, ['id', 'url', 'addr', 'name', 'micro']);
1084                                 $author_contact['url'] = ($author_contact['url'] ?? $attributes['profile']);
1085                                 $author_contact['addr'] = ($author_contact['addr'] ?? '');
1086
1087                                 $attributes['author']   = ($author_contact['name']  ?? '') ?: $attributes['author'];
1088                                 $attributes['avatar']   = ($author_contact['micro'] ?? '') ?: $attributes['avatar'];
1089                                 $attributes['profile']  = ($author_contact['url']   ?? '') ?: $attributes['profile'];
1090
1091                                 if (!empty($author_contact['id'])) {
1092                                         $attributes['avatar'] = Contact::getAvatarUrlForId($author_contact['id'], Proxy::SIZE_THUMB);
1093                                 } elseif ($attributes['avatar']) {
1094                                         $attributes['avatar'] = self::proxyUrl($attributes['avatar'], self::INTERNAL, $uriid, Proxy::SIZE_THUMB);
1095                                 }
1096
1097                                 $content = preg_replace(Strings::autoLinkRegEx(), '<a href="$1">$1</a>', $match[3]);
1098
1099                                 return $match[1] . $callback($attributes, $author_contact, $content, trim($match[1]) != '');
1100                         },
1101                         $text
1102                 );
1103
1104                 DI::profiler()->stopRecording();
1105                 return $return;
1106         }
1107
1108         /**
1109          * Convert complex IMG and ZMG elements
1110          *
1111          * @param [type] $text
1112          * @param integer $simplehtml
1113          * @param integer $uriid
1114          * @return string
1115          */
1116         private static function convertImages(string $text, int $simplehtml, int $uriid = 0): string
1117         {
1118                 DI::profiler()->startRecording('rendering');
1119                 $return = preg_replace_callback(
1120                         "/\[[zi]mg(.*?)\]([^\[\]]*)\[\/[zi]mg\]/ism",
1121                         function ($match) use ($simplehtml, $uriid) {
1122                                 $attribute_string = $match[1];
1123                                 $attributes = [];
1124                                 foreach (['alt', 'width', 'height'] as $field) {
1125                                         preg_match("/$field=(['\"])(.+?)\\1/ism", $attribute_string, $matches);
1126                                         $attributes[$field] = html_entity_decode($matches[2] ?? '', ENT_QUOTES, 'UTF-8');
1127                                 }
1128
1129                                 $img_str = '<img src="' .
1130                                 self::proxyUrl($match[2], $simplehtml, $uriid) . '"';
1131                                 foreach ($attributes as $key => $value) {
1132                                         if (!empty($value)) {
1133                                                 $img_str .= ' ' . $key . '="' . htmlspecialchars($value, ENT_COMPAT) . '"';
1134                                         }
1135                                 }
1136                                 return $img_str . '>';
1137                         },
1138                         $text
1139                 );
1140
1141                 DI::profiler()->stopRecording();
1142                 return $return;
1143         }
1144
1145         /**
1146          * Default [share] tag conversion callback
1147          *
1148          * Note: Can produce a [bookmark] tag in the output
1149          *
1150          * @see BBCode::convertShare()
1151          * @param array   $attributes     [share] block attribute values
1152          * @param array   $author_contact Contact row of the shared author
1153          * @param string  $content        Inner content of the [share] block
1154          * @param boolean $is_quote_share Whether there is content before the [share] block
1155          * @param integer $simplehtml     Mysterious integer value depending on the target network/formatting style
1156          * @return string
1157          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1158          */
1159         private static function convertShareCallback(array $attributes, array $author_contact, string $content, bool $is_quote_share, int $simplehtml): string
1160         {
1161                 DI::profiler()->startRecording('rendering');
1162                 $mention = $attributes['author'] . ' (' . ($author_contact['addr'] ?? '') . ')';
1163
1164                 switch ($simplehtml) {
1165                         case self::API:
1166                                 $text = ($is_quote_share? '<br>' : '') .
1167                                 '<b><a href="' . $attributes['link'] . '">' . html_entity_decode('&#x2672;', ENT_QUOTES, 'UTF-8') . ' ' . $author_contact['addr'] . "</a>:</b><br>\n" .
1168                                 '<blockquote class="shared_content" dir="auto">' . $content . '</blockquote>';
1169                                 break;
1170                         case self::DIASPORA:
1171                                 if (stripos(Strings::normaliseLink($attributes['link']), 'http://twitter.com/') === 0) {
1172                                         $text = ($is_quote_share? '<hr />' : '') . '<p><a href="' . $attributes['link'] . '">' . $attributes['link'] . '</a></p>' . "\n";
1173                                 } else {
1174                                         $headline = '<p><b>♲ <a href="' . $attributes['profile'] . '">' . $attributes['author'] . '</a>:</b></p>' . "\n";
1175
1176                                         if (!empty($attributes['posted']) && !empty($attributes['link'])) {
1177                                                 $headline = '<p><b>♲ <a href="' . $attributes['profile'] . '">' . $attributes['author'] . '</a></b> - <a href="' . $attributes['link'] . '">' . $attributes['posted'] . ' GMT</a></p>' . "\n";
1178                                         }
1179
1180                                         $text = ($is_quote_share? '<hr />' : '') . $headline . '<blockquote>' . trim($content) . '</blockquote>' . "\n";
1181
1182                                         if (empty($attributes['posted']) && !empty($attributes['link'])) {
1183                                                 $text .= '<p><a href="' . $attributes['link'] . '">[Source]</a></p>' . "\n";
1184                                         }
1185                                 }
1186
1187                                 break;
1188                         case self::CONNECTORS:
1189                                 $headline = '<p><b>' . html_entity_decode('&#x2672; ', ENT_QUOTES, 'UTF-8');
1190                                 $headline .= DI::l10n()->t('<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a> %3$s', $attributes['link'], $mention, $attributes['posted']);
1191                                 $headline .= ':</b></p>' . "\n";
1192
1193                                 $text = ($is_quote_share? '<hr />' : '') . $headline . '<blockquote class="shared_content" dir="auto">' . trim($content) . '</blockquote>' . "\n";
1194
1195                                 break;
1196                         case self::OSTATUS:
1197                                 $text = ($is_quote_share? '<br>' : '') . '<p>' . html_entity_decode('&#x2672; ', ENT_QUOTES, 'UTF-8') . ' @' . $author_contact['addr'] . ': ' . $content . '</p>' . "\n";
1198                                 break;
1199                         case self::ACTIVITYPUB:
1200                                 $author = '@<span class="vcard"><a href="' . $author_contact['url'] . '" class="url u-url mention" title="' . $author_contact['addr'] . '"><span class="fn nickname mention">' . $author_contact['addr'] . '</span></a>:</span>';
1201                                 $text = '<div><a href="' . $attributes['link'] . '">' . html_entity_decode('&#x2672;', ENT_QUOTES, 'UTF-8') . '</a> ' . $author . '<blockquote>' . $content . '</blockquote></div>' . "\n";
1202                                 break;
1203                         default:
1204                                 $text = ($is_quote_share? "\n" : '');
1205
1206                                 $contact = Contact::getByURL($attributes['profile'], false, ['network']);
1207                                 $network = $contact['network'] ?? Protocol::PHANTOM;
1208
1209                                 $tpl = Renderer::getMarkupTemplate('shared_content.tpl');
1210                                 $text .= Renderer::replaceMacros($tpl, [
1211                                         '$profile'      => $attributes['profile'],
1212                                         '$avatar'       => $attributes['avatar'],
1213                                         '$author'       => $attributes['author'],
1214                                         '$link'         => $attributes['link'],
1215                                         '$link_title'   => DI::l10n()->t('Link to source'),
1216                                         '$posted'       => $attributes['posted'],
1217                                         '$guid'         => $attributes['guid'],
1218                                         '$network_name' => ContactSelector::networkToName($network, $attributes['profile']),
1219                                         '$network_icon' => ContactSelector::networkToIcon($network, $attributes['profile']),
1220                                         '$content'      => self::TOP_ANCHOR . self::setMentions(trim($content), 0, $network) . self::BOTTOM_ANCHOR,
1221                                 ]);
1222                                 break;
1223                 }
1224
1225                 return $text;
1226         }
1227
1228         private static function removePictureLinksCallback(array $match): string
1229         {
1230                 $cache_key = 'remove:' . $match[1];
1231                 $text = DI::cache()->get($cache_key);
1232
1233                 if (is_null($text)) {
1234                         $curlResult = DI::httpClient()->head($match[1], [HttpClientOptions::TIMEOUT => DI::config()->get('system', 'xrd_timeout')]);
1235                         if ($curlResult->isSuccess()) {
1236                                 $mimetype = $curlResult->getHeader('Content-Type')[0] ?? '';
1237                         } else {
1238                                 $mimetype = '';
1239                         }
1240
1241                         if (substr($mimetype, 0, 6) == 'image/') {
1242                                 $text = '[url=' . $match[1] . ']' . $match[1] . '[/url]';
1243                         } else {
1244                                 $text = '[url=' . $match[2] . ']' . $match[2] . '[/url]';
1245
1246                                 // if its not a picture then look if its a page that contains a picture link
1247                                 $body = DI::httpClient()->fetch($match[1], HttpClientAccept::HTML, 0);
1248                                 if (empty($body)) {
1249                                         DI::cache()->set($cache_key, $text);
1250                                         return $text;
1251                                 }
1252
1253                                 $doc = new DOMDocument();
1254                                 @$doc->loadHTML($body);
1255                                 $xpath = new DOMXPath($doc);
1256                                 $list = $xpath->query('//meta[@name]');
1257                                 foreach ($list as $node) {
1258                                         $attr = [];
1259
1260                                         if ($node->attributes->length) {
1261                                                 foreach ($node->attributes as $attribute) {
1262                                                         $attr[$attribute->name] = $attribute->value;
1263                                                 }
1264                                         }
1265
1266                                         if (strtolower($attr['name']) == 'twitter:image') {
1267                                                 $text = '[url=' . $attr['content'] . ']' . $attr['content'] . '[/url]';
1268                                         }
1269                                 }
1270                         }
1271                         DI::cache()->set($cache_key, $text);
1272                 }
1273
1274                 return $text;
1275         }
1276
1277         /**
1278          * Callback: Expands links from given $match array
1279          *
1280          * @param arrat $match Array with link match
1281          * @return string BBCode
1282          */
1283         private static function expandLinksCallback(array $match): string
1284         {
1285                 if (($match[3] == '') || ($match[2] == $match[3]) || stristr($match[2], $match[3])) {
1286                         return ($match[1] . '[url]' . $match[2] . '[/url]');
1287                 } else {
1288                         return ($match[1] . $match[3] . ' [url]' . $match[2] . '[/url]');
1289                 }
1290         }
1291
1292         /**
1293          * Callback: Cleans picture links
1294          *
1295          * @param arrat $match Array with link match
1296          * @return string BBCode
1297          */
1298         private static function cleanPictureLinksCallback(array $match): string
1299         {
1300                 // When the picture link is the own photo path then we can avoid fetching the link
1301                 $own_photo_url = preg_quote(Strings::normaliseLink(DI::baseUrl()->get()) . '/photos/');
1302                 if (preg_match('|' . $own_photo_url . '.*?/image/|', Strings::normaliseLink($match[1]))) {
1303                         if (!empty($match[3])) {
1304                                 $text = '[img=' . str_replace('-1.', '-0.', $match[2]) . ']' . $match[3] . '[/img]';
1305                         } else {
1306                                 $text = '[img]' . str_replace('-1.', '-0.', $match[2]) . '[/img]';
1307                         }
1308                         return $text;
1309                 }
1310
1311                 $cache_key = 'clean:' . $match[1];
1312                 $text = DI::cache()->get($cache_key);
1313                 if (!is_null($text)) {
1314                         return $text;
1315                 }
1316
1317                 $curlResult = DI::httpClient()->head($match[1], [HttpClientOptions::TIMEOUT => DI::config()->get('system', 'xrd_timeout')]);
1318                 if ($curlResult->isSuccess()) {
1319                         $mimetype = $curlResult->getHeader('Content-Type')[0] ?? '';
1320                 } else {
1321                         $mimetype = '';
1322                 }
1323
1324                 // if its a link to a picture then embed this picture
1325                 if (substr($mimetype, 0, 6) == 'image/') {
1326                         $text = '[img]' . $match[1] . '[/img]';
1327                 } else {
1328                         if (!empty($match[3])) {
1329                                 $text = '[img=' . $match[2] . ']' . $match[3] . '[/img]';
1330                         } else {
1331                                 $text = '[img]' . $match[2] . '[/img]';
1332                         }
1333
1334                         // if its not a picture then look if its a page that contains a picture link
1335                         $body = DI::httpClient()->fetch($match[1], HttpClientAccept::HTML, 0);
1336                         if (empty($body)) {
1337                                 DI::cache()->set($cache_key, $text);
1338                                 return $text;
1339                         }
1340
1341                         $doc = new DOMDocument();
1342                         @$doc->loadHTML($body);
1343                         $xpath = new DOMXPath($doc);
1344                         $list = $xpath->query('//meta[@name]');
1345                         foreach ($list as $node) {
1346                                 $attr = [];
1347                                 if ($node->attributes->length) {
1348                                         foreach ($node->attributes as $attribute) {
1349                                                 $attr[$attribute->name] = $attribute->value;
1350                                         }
1351                                 }
1352
1353                                 if (strtolower($attr['name']) == "twitter:image") {
1354                                         if (!empty($match[3])) {
1355                                                 $text = "[img=" . $attr['content'] . "]" . $match[3] . "[/img]";
1356                                         } else {
1357                                                 $text = "[img]" . $attr['content'] . "[/img]";
1358                                         }
1359                                 }
1360                         }
1361                 }
1362                 DI::cache()->set($cache_key, $text);
1363
1364                 return $text;
1365         }
1366
1367         /**
1368          * Cleans picture links
1369          *
1370          * @param string $text HTML/BBCode string
1371          * @return string Cleaned HTML/BBCode
1372          */
1373         public static function cleanPictureLinks(string $text): string
1374         {
1375                 DI::profiler()->startRecording('rendering');
1376                 $return = preg_replace_callback("&\[url=([^\[\]]*)\]\[img=(.*)\](.*)\[\/img\]\[\/url\]&Usi", 'self::cleanPictureLinksCallback', $text);
1377                 $return = preg_replace_callback("&\[url=([^\[\]]*)\]\[img\](.*)\[\/img\]\[\/url\]&Usi", 'self::cleanPictureLinksCallback', $return);
1378                 DI::profiler()->stopRecording();
1379                 return $return;
1380         }
1381
1382         /**
1383          * Removes links
1384          *
1385          * @param string $text HTML/BBCode string
1386          * @return string Cleaned HTML/BBCode
1387          */
1388         public static function removeLinks(string $bbcode): string
1389         {
1390                 DI::profiler()->startRecording('rendering');
1391                 $bbcode = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", ' $1 ', $bbcode);
1392                 $bbcode = preg_replace("/\[img.*?\[\/img\]/ism", ' ', $bbcode);
1393
1394                 $bbcode = preg_replace('/[@!#]\[url\=.*?\].*?\[\/url\]/ism', '', $bbcode);
1395                 $bbcode = preg_replace("/\[url=[^\[\]]*\](.*)\[\/url\]/Usi", ' $1 ', $bbcode);
1396                 $bbcode = preg_replace('/[@!#]?\[url.*?\[\/url\]/ism', '', $bbcode);
1397                 DI::profiler()->stopRecording();
1398                 return $bbcode;
1399         }
1400
1401         /**
1402          * Replace names in mentions with nicknames
1403          *
1404          * @param string $body HTML/BBCode
1405          * @return string Body with replaced mentions
1406          */
1407         public static function setMentionsToNicknames(string $body): string
1408         {
1409                 DI::profiler()->startRecording('rendering');
1410                 $regexp = "/([@!])\[url\=([^\[\]]*)\].*?\[\/url\]/ism";
1411                 $body = preg_replace_callback($regexp, ['self', 'mentionCallback'], $body);
1412                 DI::profiler()->stopRecording();
1413                 return $body;
1414         }
1415
1416         /**
1417          * Callback function to replace a Friendica style mention in a mention with the nickname
1418          *
1419          * @param array $match Matching values for the callback
1420          * @return string Replaced mention or empty string
1421          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1422          */
1423         private static function mentionCallback(array $match): string
1424         {
1425                 if (empty($match[2])) {
1426                         return '';
1427                 }
1428
1429                 $data = Contact::getByURL($match[2], false, ['url', 'nick']);
1430                 if (empty($data['nick'])) {
1431                         return $match[0];
1432                 }
1433
1434                 return $match[1] . '[url=' . $data['url'] . ']' . $data['nick'] . '[/url]';
1435         }
1436
1437         /**
1438          * Converts a BBCode message for a given URI-ID to a HTML message
1439          *
1440          * BBcode 2 HTML was written by WAY2WEB.net
1441          * extended to work with Mistpark/Friendica - Mike Macgirvin
1442          *
1443          * Simple HTML values meaning:
1444          * - 0: Friendica display
1445          * - 1: Unused
1446          * - 2: Used for Windows Phone push, Friendica API
1447          * - 3: Used before converting to Markdown in bb2diaspora.php
1448          * - 4: Used for WordPress, Libertree (before Markdown), pump.io and tumblr
1449          * - 5: Unused
1450          * - 6: Unused
1451          * - 7: Used for dfrn, OStatus
1452          * - 8: Used for Twitter, WP backlink text setting
1453          * - 9: ActivityPub
1454          *
1455          * @param int    $uriid
1456          * @param string $text
1457          * @param int    $simple_html
1458          * @return string
1459          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1460          */
1461         public static function convertForUriId(int $uriid = null, string $text = null, int $simple_html = self::INTERNAL): string
1462         {
1463                 $try_oembed = ($simple_html == self::INTERNAL);
1464
1465                 return self::convert($text ?? '', $try_oembed, $simple_html, false, $uriid ?? 0);
1466         }
1467
1468         /**
1469          * Converts a BBCode message to HTML message
1470          *
1471          * BBcode 2 HTML was written by WAY2WEB.net
1472          * extended to work with Mistpark/Friendica - Mike Macgirvin
1473          *
1474          * Simple HTML values meaning:
1475          * - 0: Friendica display
1476          * - 1: Unused
1477          * - 2: Used for Windows Phone push, Friendica API
1478          * - 3: Used before converting to Markdown in bb2diaspora.php
1479          * - 4: Used for WordPress, Libertree (before Markdown), pump.io and tumblr
1480          * - 5: Unused
1481          * - 6: Unused
1482          * - 7: Used for dfrn, OStatus
1483          * - 8: Used for Twitter, WP backlink text setting
1484          * - 9: ActivityPub
1485          *
1486          * @param string $text
1487          * @param bool   $try_oembed
1488          * @param int    $simple_html
1489          * @param bool   $for_plaintext
1490          * @param int    $uriid
1491          * @return string Converted code or empty string
1492          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1493          */
1494         public static function convert(string $text = null, bool $try_oembed = true, int $simple_html = self::INTERNAL, bool $for_plaintext = false, int $uriid = 0): string
1495         {
1496                 // Accounting for null default column values
1497                 if (is_null($text) || $text === '') {
1498                         return '';
1499                 }
1500
1501                 DI::profiler()->startRecording('rendering');
1502
1503                 Hook::callAll('bbcode', $text);
1504
1505                 $a = DI::app();
1506
1507                 $text = self::performWithEscapedTags($text, ['code'], function ($text) use ($try_oembed, $simple_html, $for_plaintext, $a, $uriid) {
1508                         $text = self::performWithEscapedTags($text, ['noparse', 'nobb', 'pre'], function ($text) use ($try_oembed, $simple_html, $for_plaintext, $a, $uriid) {
1509                                 /*
1510                                  * preg_match_callback function to replace potential Oembed tags with Oembed content
1511                                  *
1512                                  * $match[0] = [tag]$url[/tag] or [tag=$url]$title[/tag]
1513                                  * $match[1] = $url
1514                                  * $match[2] = $title or absent
1515                                  */
1516                                 $try_oembed_callback = function (array $match)
1517                                 {
1518                                         $url = $match[1];
1519                                         $title = $match[2] ?? '';
1520
1521                                         try {
1522                                                 $return = OEmbed::getHTML($url, $title);
1523                                         } catch (Exception $ex) {
1524                                                 $return = $match[0];
1525                                         }
1526
1527                                         return $return;
1528                                 };
1529
1530                                 // Remove the abstract element. It is a non visible element.
1531                                 $text = self::stripAbstract($text);
1532
1533                                 // Line ending normalisation
1534                                 $text = str_replace("\r\n", "\n", $text);
1535
1536                                 // Move new lines outside of tags
1537                                 $text = preg_replace("#\[(\w*)](\n*)#ism", '$2[$1]', $text);
1538                                 $text = preg_replace("#(\n*)\[/(\w*)]#ism", '[/$2]$1', $text);
1539
1540                                 // Extract the private images which use data urls since preg has issues with
1541                                 // large data sizes. Stash them away while we do bbcode conversion, and then put them back
1542                                 // in after we've done all the regex matching. We cannot use any preg functions to do this.
1543
1544                                 $extracted = self::extractImagesFromItemBody($text);
1545                                 $text = $extracted['body'];
1546                                 $saved_image = $extracted['images'];
1547
1548                                 // If we find any event code, turn it into an event.
1549                                 // After we're finished processing the bbcode we'll
1550                                 // replace all of the event code with a reformatted version.
1551
1552                                 $ev = Event::fromBBCode($text);
1553
1554                                 // Replace any html brackets with HTML Entities to prevent executing HTML or script
1555                                 // Don't use strip_tags here because it breaks [url] search by replacing & with amp
1556
1557                                 $text = str_replace("<", "&lt;", $text);
1558                                 $text = str_replace(">", "&gt;", $text);
1559
1560                                 // remove some newlines before the general conversion
1561                                 $text = preg_replace("/\s?\[share(.*?)\]\s?(.*?)\s?\[\/share\]\s?/ism", "[share$1]$2[/share]", $text);
1562                                 $text = preg_replace("/\s?\[quote(.*?)\]\s?(.*?)\s?\[\/quote\]\s?/ism", "[quote$1]$2[/quote]", $text);
1563
1564                                 // when the content is meant exporting to other systems then remove the avatar picture since this doesn't really look good on these systems
1565                                 if (!$try_oembed) {
1566                                         $text = preg_replace("/\[share(.*?)avatar\s?=\s?'.*?'\s?(.*?)\]\s?(.*?)\s?\[\/share\]\s?/ism", "\n[share$1$2]$3[/share]", $text);
1567                                 }
1568
1569                                 // Remove linefeeds inside of the table elements. See issue #6799
1570                                 $search = ["\n[th]", "[th]\n", " [th]", "\n[/th]", "[/th]\n", "[/th] ",
1571                                         "\n[td]", "[td]\n", " [td]", "\n[/td]", "[/td]\n", "[/td] ",
1572                                         "\n[tr]", "[tr]\n", " [tr]", "[tr] ", "\n[/tr]", "[/tr]\n", " [/tr]", "[/tr] ",
1573                                         "\n[hr]", "[hr]\n", " [hr]", "[hr] ",
1574                                         "\n[attachment ", " [attachment ", "\n[/attachment]", "[/attachment]\n", " [/attachment]", "[/attachment] ",
1575                                         "[table]\n", "[table] ", " [table]", "\n[/table]", " [/table]", "[/table] "];
1576                                 $replace = ["[th]", "[th]", "[th]", "[/th]", "[/th]", "[/th]",
1577                                         "[td]", "[td]", "[td]", "[/td]", "[/td]", "[/td]",
1578                                         "[tr]", "[tr]", "[tr]", "[tr]", "[/tr]", "[/tr]", "[/tr]", "[/tr]",
1579                                         "[hr]", "[hr]", "[hr]", "[hr]",
1580                                         "[attachment ", "[attachment ", "[/attachment]", "[/attachment]", "[/attachment]", "[/attachment]",
1581                                         "[table]", "[table]", "[table]", "[/table]", "[/table]", "[/table]"];
1582                                 do {
1583                                         $oldtext = $text;
1584                                         $text = str_replace($search, $replace, $text);
1585                                 } while ($oldtext != $text);
1586
1587                                 // Replace these here only once
1588                                 $search = ["\n[table]", "[/table]\n"];
1589                                 $replace = ["[table]", "[/table]"];
1590                                 $text = str_replace($search, $replace, $text);
1591
1592                                 // Trim new lines regardless of the system.remove_multiplicated_lines config value
1593                                 $text = trim($text, "\n");
1594
1595                                 // removing multiplicated newlines
1596                                 if (DI::config()->get('system', 'remove_multiplicated_lines')) {
1597                                         $search = ["\n\n\n", "\n ", " \n", "[/quote]\n\n", "\n[/quote]", "[/li]\n", "\n[li]", "\n[*]", "\n[ul]", "[/ul]\n", "\n\n[share ", "[/attachment]\n",
1598                                                         "\n[h1]", "[/h1]\n", "\n[h2]", "[/h2]\n", "\n[h3]", "[/h3]\n", "\n[h4]", "[/h4]\n", "\n[h5]", "[/h5]\n", "\n[h6]", "[/h6]\n"];
1599                                         $replace = ["\n\n", "\n", "\n", "[/quote]\n", "[/quote]", "[/li]", "[li]", "[*]", "[ul]", "[/ul]", "\n[share ", "[/attachment]",
1600                                                         "[h1]", "[/h1]", "[h2]", "[/h2]", "[h3]", "[/h3]", "[h4]", "[/h4]", "[h5]", "[/h5]", "[h6]", "[/h6]"];
1601                                         do {
1602                                                 $oldtext = $text;
1603                                                 $text = str_replace($search, $replace, $text);
1604                                         } while ($oldtext != $text);
1605                                 }
1606
1607                                 /// @todo Have a closer look at the different html modes
1608                                 // Handle attached links or videos
1609                                 if (in_array($simple_html, [self::API, self::ACTIVITYPUB])) {
1610                                         $text = self::removeAttachment($text);
1611                                 } elseif (!in_array($simple_html, [self::INTERNAL, self::EXTERNAL, self::CONNECTORS])) {
1612                                         $text = self::removeAttachment($text, true);
1613                                 } else {
1614                                         $text = self::convertAttachment($text, $simple_html, $try_oembed, [], $uriid);
1615                                 }
1616
1617                                 $nosmile = strpos($text, '[nosmile]') !== false;
1618                                 $text = str_replace('[nosmile]', '', $text);
1619
1620                                 // Replace non graphical smilies for external posts
1621                                 if (!$nosmile) {
1622                                         $text = self::performWithEscapedTags($text, ['img'], function ($text) use ($simple_html, $for_plaintext) {
1623                                                 return Smilies::replace($text, ($simple_html != self::INTERNAL) || $for_plaintext);
1624                                         });
1625                                 }
1626
1627                                 // leave open the posibility of [map=something]
1628                                 // this is replaced in Item::prepareBody() which has knowledge of the item location
1629                                 if (strpos($text, '[/map]') !== false) {
1630                                         $text = preg_replace_callback(
1631                                                 "/\[map\](.*?)\[\/map\]/ism",
1632                                                 function ($match) use ($simple_html) {
1633                                                         return str_replace($match[0], '<p class="map">' . Map::byLocation($match[1], $simple_html) . '</p>', $match[0]);
1634                                                 },
1635                                                 $text
1636                                         );
1637                                 }
1638
1639                                 if (strpos($text, '[map=') !== false) {
1640                                         $text = preg_replace_callback(
1641                                                 "/\[map=(.*?)\]/ism",
1642                                                 function ($match) use ($simple_html) {
1643                                                         return str_replace($match[0], '<p class="map">' . Map::byCoordinates(str_replace('/', ' ', $match[1]), $simple_html) . '</p>', $match[0]);
1644                                                 },
1645                                                 $text
1646                                         );
1647                                 }
1648
1649                                 if (strpos($text, '[map]') !== false) {
1650                                         $text = preg_replace("/\[map\]/", '<p class="map"></p>', $text);
1651                                 }
1652
1653                                 // Check for headers
1654                                 $text = preg_replace("(\[h1\](.*?)\[\/h1\])ism", '<h1>$1</h1>', $text);
1655                                 $text = preg_replace("(\[h2\](.*?)\[\/h2\])ism", '<h2>$1</h2>', $text);
1656                                 $text = preg_replace("(\[h3\](.*?)\[\/h3\])ism", '<h3>$1</h3>', $text);
1657                                 $text = preg_replace("(\[h4\](.*?)\[\/h4\])ism", '<h4>$1</h4>', $text);
1658                                 $text = preg_replace("(\[h5\](.*?)\[\/h5\])ism", '<h5>$1</h5>', $text);
1659                                 $text = preg_replace("(\[h6\](.*?)\[\/h6\])ism", '<h6>$1</h6>', $text);
1660
1661                                 // Check for paragraph
1662                                 $text = preg_replace("(\[p\](.*?)\[\/p\])ism", '<p>$1</p>', $text);
1663
1664                                 // Check for bold text
1665                                 $text = preg_replace("(\[b\](.*?)\[\/b\])ism", '<strong>$1</strong>', $text);
1666
1667                                 // Check for Italics text
1668                                 $text = preg_replace("(\[i\](.*?)\[\/i\])ism", '<em>$1</em>', $text);
1669
1670                                 // Check for Underline text
1671                                 $text = preg_replace("(\[u\](.*?)\[\/u\])ism", '<u>$1</u>', $text);
1672
1673                                 // Check for strike-through text
1674                                 $text = preg_replace("(\[s\](.*?)\[\/s\])ism", '<s>$1</s>', $text);
1675
1676                                 // Check for over-line text
1677                                 $text = preg_replace("(\[o\](.*?)\[\/o\])ism", '<span class="overline">$1</span>', $text);
1678
1679                                 // Check for colored text
1680                                 $text = preg_replace("(\[color=(.*?)\](.*?)\[\/color\])ism", "<span style=\"color: $1;\">$2</span>", $text);
1681
1682                                 // Check for sized text
1683                                 // [size=50] --> font-size: 50px (with the unit).
1684                                 if ($simple_html != self::DIASPORA) {
1685                                         $text = preg_replace("(\[size=(\d*?)\](.*?)\[\/size\])ism", '<span style="font-size:$1px;line-height:normal;">$2</span>', $text);
1686                                         $text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])ism", '<span style="font-size:$1;line-height:normal;">$2</span>', $text);
1687                                 } else {
1688                                         // Issue 2199: Diaspora doesn't interpret the construct above, nor the <small> or <big> element
1689                                         $text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])ism", "$2", $text);
1690                                 }
1691
1692
1693                                 // Check for centered text
1694                                 $text = preg_replace("(\[center\](.*?)\[\/center\])ism", '<div style="text-align:center;">$1</div>', $text);
1695
1696                                 // Check for list text
1697                                 $text = str_replace("[*]", "<li>", $text);
1698
1699                                 // Check for block-level custom CSS
1700                                 $text = preg_replace('#(?<=^|\n)\[style=(.*?)](.*?)\[/style](?:\n|$)#ism', '<div style="$1">$2</div>', $text);
1701
1702                                 // Check for inline custom CSS
1703                                 $text = preg_replace("(\[style=(.*?)\](.*?)\[\/style\])ism", '<span style="$1">$2</span>', $text);
1704
1705                                 // Mastodon Emoji (internal tag, do not document for users)
1706                                 $text = preg_replace("(\[emoji=(.*?)](.*?)\[/emoji])ism", '<span class="mastodon emoji"><img src="$1" alt="$2" title="$2"/></span>', $text);
1707
1708                                 // Check for CSS classes
1709                                 // @deprecated since 2021.12, left for backward-compatibility reasons
1710                                 $text = preg_replace("(\[class=(.*?)\](.*?)\[\/class\])ism", '<span class="$1">$2</span>', $text);
1711                                 // Add HTML new lines
1712                                 $text = str_replace("\n", '<br>', $text);
1713
1714                                 // handle nested lists
1715                                 $endlessloop = 0;
1716
1717                                 while ((((strpos($text, "[/list]") !== false) && (strpos($text, "[list") !== false)) ||
1718                                                 ((strpos($text, "[/ol]") !== false) && (strpos($text, "[ol]") !== false)) ||
1719                                                 ((strpos($text, "[/ul]") !== false) && (strpos($text, "[ul]") !== false)) ||
1720                                                 ((strpos($text, "[/li]") !== false) && (strpos($text, "[li]") !== false))) && (++$endlessloop < 20)) {
1721                                         $text = preg_replace("/\[list\](.*?)\[\/list\]/ism", '<ul class="listbullet" style="list-style-type: circle;">$1</ul>', $text);
1722                                         $text = preg_replace("/\[list=\](.*?)\[\/list\]/ism", '<ul class="listnone" style="list-style-type: none;">$1</ul>', $text);
1723                                         $text = preg_replace("/\[list=1\](.*?)\[\/list\]/ism", '<ul class="listdecimal" style="list-style-type: decimal;">$1</ul>', $text);
1724                                         $text = preg_replace("/\[list=((?-i)i)\](.*?)\[\/list\]/ism", '<ul class="listlowerroman" style="list-style-type: lower-roman;">$2</ul>', $text);
1725                                         $text = preg_replace("/\[list=((?-i)I)\](.*?)\[\/list\]/ism", '<ul class="listupperroman" style="list-style-type: upper-roman;">$2</ul>', $text);
1726                                         $text = preg_replace("/\[list=((?-i)a)\](.*?)\[\/list\]/ism", '<ul class="listloweralpha" style="list-style-type: lower-alpha;">$2</ul>', $text);
1727                                         $text = preg_replace("/\[list=((?-i)A)\](.*?)\[\/list\]/ism", '<ul class="listupperalpha" style="list-style-type: upper-alpha;">$2</ul>', $text);
1728                                         $text = preg_replace("/\[ul\](.*?)\[\/ul\]/ism", '<ul class="listbullet" style="list-style-type: circle;">$1</ul>', $text);
1729                                         $text = preg_replace("/\[ol\](.*?)\[\/ol\]/ism", '<ul class="listdecimal" style="list-style-type: decimal;">$1</ul>', $text);
1730                                         $text = preg_replace("/\[li\](.*?)\[\/li\]/ism", '<li>$1</li>', $text);
1731                                 }
1732
1733                                 $text = preg_replace("/\[th\](.*?)\[\/th\]/sm", '<th>$1</th>', $text);
1734                                 $text = preg_replace("/\[td\](.*?)\[\/td\]/sm", '<td>$1</td>', $text);
1735                                 $text = preg_replace("/\[tr\](.*?)\[\/tr\]/sm", '<tr>$1</tr>', $text);
1736                                 $text = preg_replace("/\[table\](.*?)\[\/table\]/sm", '<table>$1</table>', $text);
1737
1738                                 $text = preg_replace("/\[table border=1\](.*?)\[\/table\]/sm", '<table border="1" >$1</table>', $text);
1739                                 $text = preg_replace("/\[table border=0\](.*?)\[\/table\]/sm", '<table border="0" >$1</table>', $text);
1740
1741                                 $text = str_replace('[hr]', '<hr />', $text);
1742
1743                                 if (!$for_plaintext) {
1744                                         $text = self::performWithEscapedTags($text, ['url', 'img', 'audio', 'video', 'youtube', 'vimeo', 'share', 'attachment', 'iframe', 'bookmark'], function ($text) {
1745                                                 return preg_replace(Strings::autoLinkRegEx(), '[url]$1[/url]', $text);
1746                                         });
1747                                 }
1748
1749                                 // Check for font change text
1750                                 $text = preg_replace("/\[font=(.*?)\](.*?)\[\/font\]/sm", "<span style=\"font-family: $1;\">$2</span>", $text);
1751
1752                                 // Declare the format for [spoiler] layout
1753                                 $SpoilerLayout = '<details class="spoiler"><summary>' . DI::l10n()->t('Click to open/close') . '</summary>$1</details>';
1754
1755                                 // Check for [spoiler] text
1756                                 // handle nested quotes
1757                                 $endlessloop = 0;
1758                                 while ((strpos($text, "[/spoiler]") !== false) && (strpos($text, "[spoiler]") !== false) && (++$endlessloop < 20)) {
1759                                         $text = preg_replace("/\[spoiler\](.*?)\[\/spoiler\]/ism", $SpoilerLayout, $text);
1760                                 }
1761
1762                                 // Check for [spoiler=Title] text
1763
1764                                 // handle nested quotes
1765                                 $endlessloop = 0;
1766                                 while ((strpos($text, "[/spoiler]")!== false)  && (strpos($text, "[spoiler=") !== false) && (++$endlessloop < 20)) {
1767                                         $text = preg_replace("/\[spoiler=[\"\']*(.*?)[\"\']*\](.*?)\[\/spoiler\]/ism",
1768                                                 '<details class="spoiler"><summary>$1</summary>$2</details>',
1769                                                 $text);
1770                                 }
1771
1772                                 // Declare the format for [quote] layout
1773                                 $QuoteLayout = '<blockquote>$1</blockquote>';
1774
1775                                 // Check for [quote] text
1776                                 // handle nested quotes
1777                                 $endlessloop = 0;
1778                                 while ((strpos($text, "[/quote]") !== false) && (strpos($text, "[quote]") !== false) && (++$endlessloop < 20)) {
1779                                         $text = preg_replace("/\[quote\](.*?)\[\/quote\]/ism", "$QuoteLayout", $text);
1780                                 }
1781
1782                                 // Check for [quote=Author] text
1783
1784                                 $t_wrote = DI::l10n()->t('$1 wrote:');
1785
1786                                 // handle nested quotes
1787                                 $endlessloop = 0;
1788                                 while ((strpos($text, "[/quote]")!== false)  && (strpos($text, "[quote=") !== false) && (++$endlessloop < 20)) {
1789                                         $text = preg_replace("/\[quote=[\"\']*(.*?)[\"\']*\](.*?)\[\/quote\]/ism",
1790                                                 "<p><strong class=".'"author"'.">" . $t_wrote . "</strong></p><blockquote>$2</blockquote>",
1791                                                 $text);
1792                                 }
1793
1794
1795                                 // [img=widthxheight]image source[/img]
1796                                 $text = preg_replace_callback(
1797                                         "/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism",
1798                                         function ($matches) use ($simple_html, $uriid) {
1799                                                 if (strpos($matches[3], "data:image/") === 0) {
1800                                                         return $matches[0];
1801                                                 }
1802
1803                                                 $matches[3] = self::proxyUrl($matches[3], $simple_html, $uriid);
1804                                                 return "[img=" . $matches[1] . "x" . $matches[2] . "]" . $matches[3] . "[/img]";
1805                                         },
1806                                         $text
1807                                 );
1808
1809                                 $text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '<img src="$3" style="width: $1px;" >', $text);
1810                                 $text = preg_replace("/\[zmg\=([0-9]*)x([0-9]*)\](.*?)\[\/zmg\]/ism", '<img class="zrl" src="$3" style="width: $1px;" >', $text);
1811
1812                                 $text = preg_replace_callback("/\[img\=(.*?)\](.*?)\[\/img\]/ism",
1813                                         function ($matches) use ($simple_html, $uriid) {
1814                                                 $matches[1] = self::proxyUrl($matches[1], $simple_html, $uriid);
1815                                                 $matches[2] = htmlspecialchars($matches[2], ENT_COMPAT);
1816                                                 return '<img src="' . $matches[1] . '" alt="' . $matches[2] . '" title="' . $matches[2] . '">';
1817                                         },
1818                                         $text);
1819
1820                                 // Images
1821                                 // [img]pathtoimage[/img]
1822                                 $text = preg_replace_callback(
1823                                         "/\[img\](.*?)\[\/img\]/ism",
1824                                         function ($matches) use ($simple_html, $uriid) {
1825                                                 if (strpos($matches[1], "data:image/") === 0) {
1826                                                         return $matches[0];
1827                                                 }
1828
1829                                                 $matches[1] = self::proxyUrl($matches[1], $simple_html, $uriid);
1830                                                 return "[img]" . $matches[1] . "[/img]";
1831                                         },
1832                                         $text
1833                                 );
1834
1835                                 $text = preg_replace("/\[img\](.*?)\[\/img\]/ism", '<img src="$1" alt="' . DI::l10n()->t('Image/photo') . '" />', $text);
1836                                 $text = preg_replace("/\[zmg\](.*?)\[\/zmg\]/ism", '<img src="$1" alt="' . DI::l10n()->t('Image/photo') . '" />', $text);
1837
1838                                 $text = self::convertImages($text, $simple_html, $uriid);
1839
1840                                 $text = preg_replace("/\[crypt\](.*?)\[\/crypt\]/ism", '<br><img src="' .DI::baseUrl() . '/images/lock_icon.gif" alt="' . DI::l10n()->t('Encrypted content') . '" title="' . DI::l10n()->t('Encrypted content') . '" /><br>', $text);
1841                                 $text = preg_replace("/\[crypt(.*?)\](.*?)\[\/crypt\]/ism", '<br><img src="' .DI::baseUrl() . '/images/lock_icon.gif" alt="' . DI::l10n()->t('Encrypted content') . '" title="' . '$1' . ' ' . DI::l10n()->t('Encrypted content') . '" /><br>', $text);
1842                                 //$text = preg_replace("/\[crypt=(.*?)\](.*?)\[\/crypt\]/ism", '<br><img src="' .DI::baseUrl() . '/images/lock_icon.gif" alt="' . DI::l10n()->t('Encrypted content') . '" title="' . '$1' . ' ' . DI::l10n()->t('Encrypted content') . '" /><br>', $text);
1843
1844                                 // Simplify "video" element
1845                                 $text = preg_replace('(\[video[^\]]*?\ssrc\s?=\s?([^\s\]]+)[^\]]*?\].*?\[/video\])ism', '[video]$1[/video]', $text);
1846
1847                                 if ($try_oembed) {
1848                                         // html5 video and audio
1849                                         $text = preg_replace("/\[video\](.*?\.(ogg|ogv|oga|ogm|webm|mp4).*?)\[\/video\]/ism",
1850                                                 '<video src="$1" controls width="100%" height="auto"><a href="$1">$1</a></video>', $text);
1851
1852                                         $text = preg_replace_callback("/\[video\](.*?)\[\/video\]/ism", $try_oembed_callback, $text);
1853                                         $text = preg_replace_callback("/\[audio\](.*?)\[\/audio\]/ism", $try_oembed_callback, $text);
1854
1855                                         $text = preg_replace("/\[video\](.*?)\[\/video\]/ism",
1856                                                 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1857                                         $text = preg_replace("/\[audio\](.*?)\[\/audio\]/ism", '<audio src="$1" controls><a href="$1">$1</a></audio>', $text);
1858                                 } else {
1859                                         $text = preg_replace("/\[video\](.*?)\[\/video\]/ism",
1860                                                 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1861                                         $text = preg_replace("/\[audio\](.*?)\[\/audio\]/ism",
1862                                                 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1863                                 }
1864
1865                                 // Backward compatibility, [iframe] support has been removed in version 2020.12
1866                                 $text = preg_replace("/\[iframe\](.*?)\[\/iframe\]/ism", '<a href="$1">$1</a>', $text);
1867
1868                                 // Youtube extensions
1869                                 if ($try_oembed) {
1870                                         $text = preg_replace_callback("/\[youtube\](https?:\/\/www.youtube.com\/watch\?v\=.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1871                                         $text = preg_replace_callback("/\[youtube\](www.youtube.com\/watch\?v\=.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1872                                         $text = preg_replace_callback("/\[youtube\](https?:\/\/youtu.be\/.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1873                                 }
1874
1875                                 $text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/watch\?v\=(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1876                                 $text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/embed\/(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1877                                 $text = preg_replace("/\[youtube\]https?:\/\/youtu.be\/(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1878
1879                                 if ($try_oembed) {
1880                                         $text = preg_replace("/\[youtube\]([A-Za-z0-9\-_=]+)(.*?)\[\/youtube\]/ism", '<iframe width="' . $a->getThemeInfoValue('videowidth') . '" height="' . $a->getThemeInfoValue('videoheight') . '" src="https://www.youtube.com/embed/$1" frameborder="0" ></iframe>', $text);
1881                                 } else {
1882                                         $text = preg_replace("/\[youtube\]([A-Za-z0-9\-_=]+)(.*?)\[\/youtube\]/ism",
1883                                                 '<a href="https://www.youtube.com/watch?v=$1" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=$1</a>', $text);
1884                                 }
1885
1886                                 if ($try_oembed) {
1887                                         $text = preg_replace_callback("/\[vimeo\](https?:\/\/player.vimeo.com\/video\/[0-9]+).*?\[\/vimeo\]/ism", $try_oembed_callback, $text);
1888                                         $text = preg_replace_callback("/\[vimeo\](https?:\/\/vimeo.com\/[0-9]+).*?\[\/vimeo\]/ism", $try_oembed_callback, $text);
1889                                 }
1890
1891                                 $text = preg_replace("/\[vimeo\]https?:\/\/player.vimeo.com\/video\/([0-9]+)(.*?)\[\/vimeo\]/ism", '[vimeo]$1[/vimeo]', $text);
1892                                 $text = preg_replace("/\[vimeo\]https?:\/\/vimeo.com\/([0-9]+)(.*?)\[\/vimeo\]/ism", '[vimeo]$1[/vimeo]', $text);
1893
1894                                 if ($try_oembed) {
1895                                         $text = preg_replace("/\[vimeo\]([0-9]+)(.*?)\[\/vimeo\]/ism", '<iframe width="' . $a->getThemeInfoValue('videowidth') . '" height="' . $a->getThemeInfoValue('videoheight') . '" src="https://player.vimeo.com/video/$1" frameborder="0" ></iframe>', $text);
1896                                 } else {
1897                                         $text = preg_replace("/\[vimeo\]([0-9]+)(.*?)\[\/vimeo\]/ism",
1898                                                 '<a href="https://vimeo.com/$1" target="_blank" rel="noopener noreferrer">https://vimeo.com/$1</a>', $text);
1899                                 }
1900
1901                                 // oembed tag
1902                                 $text = OEmbed::BBCode2HTML($text);
1903
1904                                 // Avoid triple linefeeds through oembed
1905                                 $text = str_replace("<br style='clear:left'></span><br><br>", "<br style='clear:left'></span><br>", $text);
1906
1907                                 // If we found an event earlier, strip out all the event code and replace with a reformatted version.
1908                                 // Replace the event-start section with the entire formatted event. The other bbcode is stripped.
1909                                 // Summary (e.g. title) is required, earlier revisions only required description (in addition to
1910                                 // start which is always required). Allow desc with a missing summary for compatibility.
1911
1912                                 if ((!empty($ev['desc']) || !empty($ev['summary'])) && !empty($ev['start'])) {
1913                                         $sub = Event::getHTML($ev, $simple_html, $uriid);
1914
1915                                         $text = preg_replace("/\[event\-summary\](.*?)\[\/event\-summary\]/ism", '', $text);
1916                                         $text = preg_replace("/\[event\-description\](.*?)\[\/event\-description\]/ism", '', $text);
1917                                         $text = preg_replace("/\[event\-start\](.*?)\[\/event\-start\]/ism", $sub, $text);
1918                                         $text = preg_replace("/\[event\-finish\](.*?)\[\/event\-finish\]/ism", '', $text);
1919                                         $text = preg_replace("/\[event\-location\](.*?)\[\/event\-location\]/ism", '', $text);
1920                                         $text = preg_replace("/\[event\-id\](.*?)\[\/event\-id\]/ism", '', $text);
1921                                 }
1922
1923                                 if (!$for_plaintext && DI::config()->get('system', 'big_emojis') && ($simple_html != self::DIASPORA)) {
1924                                         $conv = html_entity_decode(str_replace([' ', "\n", "\r"], '', $text));
1925                                         // Emojis are always 4 byte Unicode characters
1926                                         if (!empty($conv) && (strlen($conv) / mb_strlen($conv) == 4)) {
1927                                                 $text = '<span style="font-size: xx-large; line-height: normal;">' . $text . '</span>';
1928                                         }
1929                                 }
1930
1931                                 // Handle mentions and hashtag links
1932                                 if ($simple_html == self::DIASPORA) {
1933                                         // The ! is converted to @ since Diaspora only understands the @
1934                                         $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1935                                                 '@<a href="$2">$3</a>',
1936                                                 $text);
1937                                 } elseif (in_array($simple_html, [self::OSTATUS, self::ACTIVITYPUB])) {
1938                                         $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1939                                                 '<span class="h-card"><a href="$2" class="u-url mention">$1<span>$3</span></a></span>',
1940                                                 $text);
1941                                         $text = preg_replace("/([#])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1942                                                 '<a href="$2" class="mention hashtag" rel="tag">$1<span>$3</span></a>',
1943                                                 $text);
1944                                 } elseif (in_array($simple_html, [self::INTERNAL, self::EXTERNAL, self::API])) {
1945                                         $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1946                                                 '<bdi>$1<a href="$2" class="userinfo mention" title="$3">$3</a></bdi>',
1947                                                 $text);
1948                                 } else {
1949                                         $text = preg_replace("/([#@!])\[url\=(.*?)\](.*?)\[\/url\]/ism", '$1$3', $text);
1950                                 }
1951
1952                                 if (!$for_plaintext) {
1953                                         if (in_array($simple_html, [self::OSTATUS, self::API, self::ACTIVITYPUB])) {
1954                                                 $text = preg_replace_callback("/\[url\](.*?)\[\/url\]/ism", 'self::convertUrlForActivityPubCallback', $text);
1955                                                 $text = preg_replace_callback("/\[url\=(.*?)\](.*?)\[\/url\]/ism", 'self::convertUrlForActivityPubCallback', $text);
1956                                         }
1957                                 } else {
1958                                         $text = preg_replace("(\[url\](.*?)\[\/url\])ism", " $1 ", $text);
1959                                         $text = preg_replace_callback("&\[url=([^\[\]]*)\]\[img\](.*)\[\/img\]\[\/url\]&Usi", 'self::removePictureLinksCallback', $text);
1960                                 }
1961
1962                                 // Bookmarks in red - will be converted to bookmarks in friendica
1963                                 $text = preg_replace("/#\^\[url\](.*?)\[\/url\]/ism", '[bookmark=$1]$1[/bookmark]', $text);
1964                                 $text = preg_replace("/#\^\[url\=(.*?)\](.*?)\[\/url\]/ism", '[bookmark=$1]$2[/bookmark]', $text);
1965                                 $text = preg_replace("/#\[url\=.*?\]\^\[\/url\]\[url\=(.*?)\](.*?)\[\/url\]/i",
1966                                                         "[bookmark=$1]$2[/bookmark]", $text);
1967
1968                                 if (in_array($simple_html, [self::OSTATUS, self::TWITTER])) {
1969                                         $text = preg_replace_callback("/([^#@!])\[url\=([^\]]*)\](.*?)\[\/url\]/ism", "self::expandLinksCallback", $text);
1970                                         //$text = preg_replace("/[^#@!]\[url\=([^\]]*)\](.*?)\[\/url\]/ism", ' $2 [url]$1[/url]', $text);
1971                                         $text = preg_replace("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", ' $2 [url]$1[/url]', $text);
1972                                 }
1973
1974                                 // Perform URL Search
1975                                 if ($try_oembed) {
1976                                         $text = preg_replace_callback("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", $try_oembed_callback, $text);
1977                                 }
1978
1979                                 $text = preg_replace("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", '[url=$1]$2[/url]', $text);
1980
1981                                 // Handle Diaspora posts
1982                                 $text = preg_replace_callback(
1983                                         "&\[url=/?posts/([^\[\]]*)\](.*)\[\/url\]&Usi",
1984                                         function ($match) {
1985                                                 return "[url=" . DI::baseUrl() . "/display/" . $match[1] . "]" . $match[2] . "[/url]";
1986                                         }, $text
1987                                 );
1988
1989                                 $text = preg_replace_callback(
1990                                         "&\[url=/people\?q\=(.*)\](.*)\[\/url\]&Usi",
1991                                         function ($match) {
1992                                                 return "[url=" . DI::baseUrl() . "/search?search=%40" . $match[1] . "]" . $match[2] . "[/url]";
1993                                         }, $text
1994                                 );
1995
1996                                 // Server independent link to posts and comments
1997                                 // See issue: https://github.com/diaspora/diaspora_federation/issues/75
1998                                 $expression = "=diaspora://.*?/post/([0-9A-Za-z\-_@.:]{15,254}[0-9A-Za-z])=ism";
1999                                 $text = preg_replace($expression, DI::baseUrl()."/display/$1", $text);
2000
2001                                 /* Tag conversion
2002                                  * Supports:
2003                                  * - #[url=<anything>]<term>[/url]
2004                                  * - [url=<anything>]#<term>[/url]
2005                                  */
2006                                 self::performWithEscapedTags($text, ['url', 'share'], function ($text) use ($simple_html) {
2007                                         $text = preg_replace_callback("/(?:#\[url\=[^\[\]]*\]|\[url\=[^\[\]]*\]#)(.*?)\[\/url\]/ism", function($matches) use ($simple_html) {
2008                                                 if ($simple_html == self::ACTIVITYPUB) {
2009                                                         return '<a href="' . DI::baseUrl() . '/search?tag=' . rawurlencode($matches[1])
2010                                                                 . '" data-tag="' . XML::escape($matches[1]) . '" rel="tag ugc">#'
2011                                                                 . XML::escape($matches[1]) . '</a>';
2012                                                 } else {
2013                                                         return '#<a href="' . DI::baseUrl() . '/search?tag=' . rawurlencode($matches[1])
2014                                                                 . '" class="tag" rel="tag" title="' . XML::escape($matches[1]) . '">'
2015                                                                 . XML::escape($matches[1]) . '</a>';
2016                                                 }
2017                                         }, $text);
2018                                         return $text;
2019                                 });
2020
2021                                 // We need no target="_blank" rel="noopener noreferrer" for local links
2022                                 // convert links start with DI::baseUrl() as local link without the target="_blank" rel="noopener noreferrer" attribute
2023                                 $escapedBaseUrl = preg_quote(DI::baseUrl(), '/');
2024                                 $text = preg_replace("/\[url\](".$escapedBaseUrl.".*?)\[\/url\]/ism", '<a href="$1">$1</a>', $text);
2025                                 $text = preg_replace("/\[url\=(".$escapedBaseUrl.".*?)\](.*?)\[\/url\]/ism", '<a href="$1">$2</a>', $text);
2026
2027                                 $text = preg_replace("/\[url\](.*?)\[\/url\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
2028                                 $text = preg_replace("/\[url\=(.*?)\](.*?)\[\/url\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$2</a>', $text);
2029
2030                                 // Red compatibility, though the link can't be authenticated on Friendica
2031                                 $text = preg_replace("/\[zrl\=(.*?)\](.*?)\[\/zrl\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$2</a>', $text);
2032
2033
2034                                 // we may need to restrict this further if it picks up too many strays
2035                                 // link acct:user@host to a webfinger profile redirector
2036
2037                                 $text = preg_replace('/acct:([^@]+)@((?!\-)(?:[a-zA-Z\d\-]{0,62}[a-zA-Z\d]\.){1,126}(?!\d+)[a-zA-Z\d]{1,63})/', '<a href="' . DI::baseUrl() . '/acctlink?addr=$1@$2" target="extlink">acct:$1@$2</a>', $text);
2038
2039                                 // Perform MAIL Search
2040                                 $text = preg_replace("/\[mail\](.*?)\[\/mail\]/", '<a href="mailto:$1">$1</a>', $text);
2041                                 $text = preg_replace("/\[mail\=(.*?)\](.*?)\[\/mail\]/", '<a href="mailto:$1">$2</a>', $text);
2042
2043                                 /// @todo What is the meaning of these lines?
2044                                 $text = preg_replace('/\[\&amp\;([#a-z0-9]+)\;\]/', '&$1;', $text);
2045                                 $text = preg_replace('/\&\#039\;/', '\'', $text);
2046
2047                                 // Currently deactivated, it made problems with " inside of alt texts.
2048                                 //$text = preg_replace('/\&quot\;/', '"', $text);
2049
2050                                 // fix any escaped ampersands that may have been converted into links
2051                                 $text = preg_replace('/\<([^>]*?)(src|href)=(.*?)\&amp\;(.*?)\>/ism', '<$1$2=$3&$4>', $text);
2052
2053                                 // sanitizes src attributes (http and redir URLs for displaying in a web page, cid used for inline images in emails)
2054                                 $allowed_src_protocols = ['//', 'http://', 'https://', 'redir/', 'cid:'];
2055
2056                                 array_walk($allowed_src_protocols, function(&$value) { $value = preg_quote($value, '#');});
2057
2058                                 $text = preg_replace('#<([^>]*?)(src)="(?!' . implode('|', $allowed_src_protocols) . ')(.*?)"(.*?)>#ism',
2059                                                          '<$1$2=""$4 data-original-src="$3" class="invalid-src" title="' . DI::l10n()->t('Invalid source protocol') . '">', $text);
2060
2061                                 // sanitize href attributes (only allowlisted protocols URLs)
2062                                 // default value for backward compatibility
2063                                 $allowed_link_protocols = DI::config()->get('system', 'allowed_link_protocols', []);
2064
2065                                 // Always allowed protocol even if config isn't set or not including it
2066                                 $allowed_link_protocols[] = '//';
2067                                 $allowed_link_protocols[] = 'http://';
2068                                 $allowed_link_protocols[] = 'https://';
2069                                 $allowed_link_protocols[] = 'redir/';
2070
2071                                 array_walk($allowed_link_protocols, function(&$value) { $value = preg_quote($value, '#');});
2072
2073                                 $regex = '#<([^>]*?)(href)="(?!' . implode('|', $allowed_link_protocols) . ')(.*?)"(.*?)>#ism';
2074                                 $text = preg_replace($regex, '<$1$2="javascript:void(0)"$4 data-original-href="$3" class="invalid-href" title="' . DI::l10n()->t('Invalid link protocol') . '">', $text);
2075
2076                                 // Shared content
2077                                 $text = self::convertShare(
2078                                         $text,
2079                                         function (array $attributes, array $author_contact, $content, $is_quote_share) use ($simple_html) {
2080                                                 return self::convertShareCallback($attributes, $author_contact, $content, $is_quote_share, $simple_html);
2081                                         }, $uriid
2082                                 );
2083
2084                                 $text = self::interpolateSavedImagesIntoItemBody($uriid, $text, $saved_image);
2085
2086                                 return $text;
2087                         }); // Escaped noparse, nobb, pre
2088
2089                         // Remove escaping tags and replace new lines that remain
2090                         $text = preg_replace_callback('/\[(noparse|nobb)](.*?)\[\/\1]/ism', function ($match) {
2091                                 return str_replace("\n", "<br>", $match[2]);
2092                         }, $text);
2093
2094                         // Additionally, [pre] tags preserve spaces
2095                         $text = preg_replace_callback("/\[pre\](.*?)\[\/pre\]/ism", function ($match) {
2096                                 return str_replace([' ', "\n"], ['&nbsp;', "<br>"], htmlentities($match[1], ENT_NOQUOTES,'UTF-8'));
2097                         }, $text);
2098
2099                         return $text;
2100                 }); // Escaped code
2101
2102                 $text = preg_replace_callback("#\[code(?:=([^\]]*))?\](.*?)\[\/code\]#ism",
2103                         function ($matches) {
2104                                 if (strpos($matches[2], "\n") !== false) {
2105                                         $return = '<pre><code class="language-' . trim($matches[1]) . '">' . htmlentities(trim($matches[2], "\n\r"), ENT_NOQUOTES, 'UTF-8') . '</code></pre>';
2106                                 } else {
2107                                         $return = '<code>' . htmlentities($matches[2], ENT_NOQUOTES, 'UTF-8') . '</code>';
2108                                 }
2109
2110                                 return $return;
2111                         },
2112                         $text
2113                 );
2114
2115                 // Default iframe allowed domains/path
2116                 $allowedIframeDomains = [
2117                         DI::baseUrl()->getHostname()
2118                         . (DI::baseUrl()->getUrlPath() ? '/' . DI::baseUrl()->getUrlPath() : '')
2119                         . '/oembed/', # The path part has to change with the source in Content\Oembed::iframe
2120                         'www.youtube.com/embed/',
2121                         'player.vimeo.com/video/',
2122                 ];
2123
2124                 $allowedIframeDomains = array_merge(
2125                         $allowedIframeDomains,
2126                         DI::config()->get('system', 'allowed_oembed') ?
2127                                 explode(',', DI::config()->get('system', 'allowed_oembed'))
2128                                 : []
2129                 );
2130
2131                 $text = HTML::purify($text, $allowedIframeDomains);
2132                 DI::profiler()->stopRecording();
2133
2134                 return trim($text);
2135         }
2136
2137         /**
2138          * Strips the "abstract" tag from the provided text
2139          *
2140          * @param string $text The text with BBCode
2141          * @return string The same text - but without "abstract" element
2142          */
2143         public static function stripAbstract(string $text): string
2144         {
2145                 DI::profiler()->startRecording('rendering');
2146
2147                 $text = BBCode::performWithEscapedTags($text, ['code', 'noparse', 'nobb', 'pre'], function ($text) {
2148                         $text = preg_replace("/[\s|\n]*\[abstract\].*?\[\/abstract\][\s|\n]*/ism", ' ', $text);
2149                         $text = preg_replace("/[\s|\n]*\[abstract=.*?\].*?\[\/abstract][\s|\n]*/ism", ' ', $text);
2150                         return $text;
2151                 });
2152
2153                 DI::profiler()->stopRecording();
2154                 return $text;
2155         }
2156
2157         /**
2158          * Returns the value of the "abstract" element
2159          *
2160          * @param string $text  The text that maybe contains the element
2161          * @param string $addon The addon for which the abstract is meant for
2162          * @return string The abstract
2163          */
2164         public static function getAbstract(string $text, string $addon = ''): string
2165         {
2166                 DI::profiler()->startRecording('rendering');
2167                 $addon = strtolower($addon);
2168
2169                 $abstract = BBCode::performWithEscapedTags($text, ['code', 'noparse', 'nobb', 'pre'], function ($text) use ($addon) {
2170                         if ($addon && preg_match('#\[abstract=' . preg_quote($addon, '#') . '](.*?)\[/abstract]#ism', $text, $matches)) {
2171                                 return $matches[1];
2172                         }
2173
2174                         if (preg_match("#\[abstract](.*?)\[/abstract]#ism", $text, $matches)) {
2175                                 return $matches[1];
2176                         }
2177
2178                         return '';
2179                 });
2180
2181                 DI::profiler()->stopRecording();
2182                 return $abstract;
2183         }
2184
2185         /**
2186          * Callback function to replace a Friendica style mention in a mention for Diaspora
2187          *
2188          * @param array $match Matching values for the callback
2189          *                     [1] = Mention type (! or @)
2190          *                     [2] = Name
2191          *                     [3] = Address
2192          * @return string Replaced mention
2193          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2194          * @throws \ImagickException
2195          */
2196         private static function bbCodeMention2DiasporaCallback(array $match): string
2197         {
2198                 $contact = Contact::getByURL($match[3], false, ['addr']);
2199                 if (empty($contact['addr'])) {
2200                         return $match[0];
2201                 }
2202
2203                 $mention = $match[1] . '{' . $match[2] . '; ' . $contact['addr'] . '}';
2204                 return $mention;
2205         }
2206
2207         /**
2208          * Converts a BBCode text into Markdown
2209          *
2210          * This function converts a BBCode item body to be sent to Markdown-enabled
2211          * systems like Diaspora and Libertree
2212          *
2213          * @param string $text
2214          * @param bool   $for_diaspora Diaspora requires more changes than Libertree
2215          * @return string
2216          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2217          */
2218         public static function toMarkdown(string $text, bool $for_diaspora = true): string
2219         {
2220                 DI::profiler()->startRecording('rendering');
2221                 $original_text = $text;
2222
2223                 // Since Diaspora is creating a summary for links, this function removes them before posting
2224                 if ($for_diaspora) {
2225                         $text = self::removeShareInformation($text);
2226                 }
2227
2228                 /**
2229                  * Transform #tags, strip off the [url] and replace spaces with underscore
2230                  */
2231                 $url_search_string = "^\[\]";
2232                 $text = preg_replace_callback("/#\[url\=([$url_search_string]*)\](.*?)\[\/url\]/i",
2233                         function ($matches) {
2234                                 return '#' . str_replace(' ', '_', $matches[2]);
2235                         },
2236                         $text
2237                 );
2238
2239                 // Converting images with size parameters to simple images. Markdown doesn't know it.
2240                 $text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $text);
2241
2242                 // Convert it to HTML - don't try oembed
2243                 if ($for_diaspora) {
2244                         $text = self::convert($text, false, self::DIASPORA);
2245
2246                         // Add all tags that maybe were removed
2247                         if (preg_match_all("/#\[url\=([$url_search_string]*)\](.*?)\[\/url\]/ism", $original_text, $tags)) {
2248                                 $tagline = '';
2249                                 foreach ($tags[2] as $tag) {
2250                                         $tag = html_entity_decode($tag, ENT_QUOTES, 'UTF-8');
2251                                         if (!strpos(html_entity_decode($text, ENT_QUOTES, 'UTF-8'), '#' . $tag)) {
2252                                                 $tagline .= '#' . $tag . ' ';
2253                                         }
2254                                 }
2255                                 $text = $text . ' ' . $tagline;
2256                         }
2257                 } else {
2258                         $text = self::convert($text, false, self::CONNECTORS);
2259                 }
2260
2261                 // If a link is followed by a quote then there should be a newline before it
2262                 // Maybe we should make this newline at every time before a quote.
2263                 $text = str_replace(['</a><blockquote>'], ['</a><br><blockquote>'], $text);
2264
2265                 // Now convert HTML to Markdown
2266                 $text = HTML::toMarkdown($text);
2267
2268                 // Libertree has a problem with escaped hashtags.
2269                 $text = str_replace(['\#'], ['#'], $text);
2270
2271                 // Remove any leading or trailing whitespace, as this will mess up
2272                 // the Diaspora signature verification and cause the item to disappear
2273                 $text = trim($text);
2274
2275                 if ($for_diaspora) {
2276                         $url_search_string = "^\[\]";
2277                         $text = preg_replace_callback(
2278                                 "/([@!])\[(.*?)\]\(([$url_search_string]*?)\)/ism",
2279                                 ['self', 'bbCodeMention2DiasporaCallback'],
2280                                 $text
2281                         );
2282                 }
2283
2284                 Hook::callAll('bb2diaspora', $text);
2285
2286                 DI::profiler()->stopRecording();
2287                 return $text;
2288         }
2289
2290         /**
2291          * Pull out all #hashtags and @person tags from $string.
2292          *
2293          * We also get @person@domain.com - which would make
2294          * the regex quite complicated as tags can also
2295          * end a sentence. So we'll run through our results
2296          * and strip the period from any tags which end with one.
2297          * Returns array of tags found, or empty array.
2298          *
2299          * @param string $string Post content
2300          * @return array List of tag and person names
2301          */
2302         public static function getTags(string $string): array
2303         {
2304                 DI::profiler()->startRecording('rendering');
2305                 $ret = [];
2306
2307                 self::performWithEscapedTags($string, ['noparse', 'pre', 'code', 'img'], function ($string) use (&$ret) {
2308                         // Convert hashtag links to hashtags
2309                         $string = preg_replace('/#\[url\=([^\[\]]*)\](.*?)\[\/url\]/ism', '#$2 ', $string);
2310
2311                         // Force line feeds at bbtags
2312                         $string = str_replace(['[', ']'], ["\n[", "]\n"], $string);
2313
2314                         // ignore anything in a bbtag
2315                         $string = preg_replace('/\[(.*?)\]/sm', '', $string);
2316
2317                         // Match full names against @tags including the space between first and last
2318                         // We will look these up afterward to see if they are full names or not recognisable.
2319
2320                         if (preg_match_all('/(@[^ \x0D\x0A,:?]+ [^ \x0D\x0A@,:?]+)([ \x0D\x0A@,:?]|$)/', $string, $matches)) {
2321                                 foreach ($matches[1] as $match) {
2322                                         if (strstr($match, ']')) {
2323                                                 // we might be inside a bbcode color tag - leave it alone
2324                                                 continue;
2325                                         }
2326
2327                                         if (substr($match, -1, 1) === '.') {
2328                                                 $ret[] = substr($match, 0, -1);
2329                                         } else {
2330                                                 $ret[] = $match;
2331                                         }
2332                                 }
2333                         }
2334
2335                         // Otherwise pull out single word tags. These can be @nickname, @first_last
2336                         // and #hash tags.
2337
2338                         if (preg_match_all('/([!#@][^\^ \x0D\x0A,;:?\']*[^\^ \x0D\x0A,;:?!\'.])/', $string, $matches)) {
2339                                 foreach ($matches[1] as $match) {
2340                                         if (strstr($match, ']')) {
2341                                                 // we might be inside a bbcode color tag - leave it alone
2342                                                 continue;
2343                                         }
2344
2345                                         // try not to catch url fragments
2346                                         if (strpos($string, $match) && preg_match('/[a-zA-z0-9\/]/', substr($string, strpos($string, $match) - 1, 1))) {
2347                                                 continue;
2348                                         }
2349
2350                                         $ret[] = $match;
2351                                 }
2352                         }
2353                 });
2354
2355                 DI::profiler()->stopRecording();
2356                 return array_unique($ret);
2357         }
2358
2359         /**
2360          * Expand tags to URLs, checks the tag is at the start of a line or preceded by a non-word character
2361          *
2362          * @param string $body HTML/BBCode
2363          * @return string body with expanded tags
2364          */
2365         public static function expandTags(string $body): string
2366         {
2367                 return preg_replace_callback("/(?<=\W|^)([!#@])([^\^ \x0D\x0A,;:?'\"]*[^\^ \x0D\x0A,;:?!'\".])/",
2368                         function (array $match) {
2369                                 switch ($match[1]) {
2370                                         case '!':
2371                                         case '@':
2372                                                 $contact = Contact::getByURL($match[2]);
2373                                                 if (!empty($contact)) {
2374                                                         return $match[1] . '[url=' . $contact['url'] . ']' . $contact['name'] . '[/url]';
2375                                                 } else {
2376                                                         return $match[1] . $match[2];
2377                                                 }
2378                                                 break;
2379
2380                                         case '#':
2381                                         default:
2382                                                 return $match[1] . '[url=' . DI::baseUrl() . '/search?tag=' . $match[2] . ']' . $match[2] . '[/url]';
2383                                 }
2384                         }, $body);
2385         }
2386
2387         /**
2388          * Perform a custom function on a text after having escaped blocks enclosed in the provided tag list.
2389          *
2390          * @param string   $text HTML/BBCode
2391          * @param array    $tagList A list of tag names, e.g ['noparse', 'nobb', 'pre']
2392          * @param callable $callback
2393          * @return string
2394          * @see Strings::performWithEscapedBlocks
2395          */
2396         public static function performWithEscapedTags(string $text, array $tagList, callable $callback): string
2397         {
2398                 $tagList = array_map('preg_quote', $tagList);
2399
2400                 return Strings::performWithEscapedBlocks($text, '#\[(?:' . implode('|', $tagList) . ').*?\[/(?:' . implode('|', $tagList) . ')]#ism', $callback);
2401         }
2402
2403         /**
2404          * Replaces mentions in the provided message body in BBCode links for the provided user and network if any
2405          *
2406          * @param string $body HTML/BBCode
2407          * @param int $profile_uid Profile user id
2408          * @param string $network Network name
2409          * @return string HTML/BBCode with inserted images
2410          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2411          * @throws \ImagickException
2412          */
2413         public static function setMentions(string $body, $profile_uid = 0, $network = '')
2414         {
2415                 DI::profiler()->startRecording('rendering');
2416                 $body = self::performWithEscapedTags($body, ['noparse', 'pre', 'code', 'img'], function ($body) use ($profile_uid, $network) {
2417                         $tags = self::getTags($body);
2418
2419                         $tagged = [];
2420
2421                         foreach ($tags as $tag) {
2422                                 $tag_type = substr($tag, 0, 1);
2423
2424                                 if ($tag_type == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
2425                                         continue;
2426                                 }
2427
2428                                 /*
2429                                  * If we already tagged 'Robert Johnson', don't try and tag 'Robert'.
2430                                  * Robert Johnson should be first in the $tags array
2431                                  */
2432                                 foreach ($tagged as $nextTag) {
2433                                         if (stristr($nextTag, $tag . ' ')) {
2434                                                 continue 2;
2435                                         }
2436                                 }
2437
2438                                 if (($success = Item::replaceTag($body, $profile_uid, $tag, $network)) && $success['replaced']) {
2439                                         $tagged[] = $tag;
2440                                 }
2441                         }
2442
2443                         return $body;
2444                 });
2445
2446                 DI::profiler()->stopRecording();
2447                 return $body;
2448         }
2449
2450         /**
2451          * @param string      $author  Author display name
2452          * @param string      $profile Author profile URL
2453          * @param string      $avatar  Author profile picture URL
2454          * @param string      $link    Post source URL
2455          * @param string      $posted  Post created date
2456          * @param string|null $guid    Post guid (if any)
2457          * @return string
2458          * @TODO Rewrite to handle over whole record array
2459          */
2460         public static function getShareOpeningTag(string $author, string $profile, string $avatar, string $link, string $posted, string $guid = null): string
2461         {
2462                 DI::profiler()->startRecording('rendering');
2463                 $header = "[share author='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $author) .
2464                         "' profile='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $profile) .
2465                         "' avatar='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $avatar) .
2466                         "' link='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $link) .
2467                         "' posted='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $posted);
2468
2469                 if ($guid) {
2470                         $header .= "' guid='" . str_replace(["'", "[", "]"], ["&#x27;", "&#x5B;", "&#x5D;"], $guid);
2471                 }
2472
2473                 $header  .= "']";
2474
2475                 DI::profiler()->stopRecording();
2476                 return $header;
2477         }
2478
2479         /**
2480          * Returns the BBCode relevant to embed the provided URL in a post body.
2481          * For media type, it will return [img], [video] and [audio] tags.
2482          * For regular web pages, it will either output a [bookmark] tag if title and description were provided,
2483          * an [attachment] tag or a simple [url] tag depending on $tryAttachment.
2484          *
2485          * @param string      $url
2486          * @param bool        $tryAttachment
2487          * @param string|null $title
2488          * @param string|null $description
2489          * @param string|null $tags
2490          * @return string
2491          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2492          * @see ParseUrl::getSiteinfoCached
2493          */
2494         public static function embedURL(string $url, bool $tryAttachment = true, string $title = null, string $description = null, string $tags = null): string
2495         {
2496                 DI::profiler()->startRecording('rendering');
2497                 DI::logger()->info($url);
2498
2499                 // If there is already some content information submitted we don't
2500                 // need to parse the url for content.
2501                 if (!empty($title) && !empty($description)) {
2502                         $title = str_replace(["\r", "\n"], ['', ''], $title);
2503
2504                         $description = '[quote]' . trim($description) . '[/quote]' . "\n";
2505
2506                         $str_tags = '';
2507                         if (!empty($tags)) {
2508                                 $arr_tags = ParseUrl::convertTagsToArray($tags);
2509                                 if (count($arr_tags)) {
2510                                         $str_tags = "\n" . implode(' ', $arr_tags) . "\n";
2511                                 }
2512                         }
2513
2514                         $result = sprintf('[bookmark=%s]%s[/bookmark]%s', $url, ($title) ? $title : $url, $description) . $str_tags;
2515
2516                         DI::logger()->info('(unparsed): returns: ' . $result);
2517
2518                         DI::profiler()->stopRecording();
2519                         return $result;
2520                 }
2521
2522                 $siteinfo = ParseUrl::getSiteinfoCached($url);
2523
2524                 if (in_array($siteinfo['type'], ['image', 'video', 'audio'])) {
2525                         switch ($siteinfo['type']) {
2526                                 case 'video':
2527                                         $bbcode = "\n" . '[video]' . $url . '[/video]' . "\n";
2528                                         break;
2529                                 case 'audio':
2530                                         $bbcode = "\n" . '[audio]' . $url . '[/audio]' . "\n";
2531                                         break;
2532                                 default:
2533                                         $bbcode = "\n" . '[img]' . $url . '[/img]' . "\n";
2534                                         break;
2535                         }
2536
2537                         DI::profiler()->stopRecording();
2538                         return $bbcode;
2539                 }
2540
2541                 unset($siteinfo['keywords']);
2542
2543                 // Bypass attachment if parse url for a comment
2544                 if (!$tryAttachment) {
2545                         DI::profiler()->stopRecording();
2546                         return "\n" . '[url=' . $url . ']' . $siteinfo['title'] . '[/url]';
2547                 }
2548
2549                 // Format it as BBCode attachment
2550                 $bbcode = "\n" . PageInfo::getFooterFromData($siteinfo);
2551                 DI::profiler()->stopRecording();
2552                 return $bbcode;
2553         }
2554 }