3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Content\Text;
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;
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;
55 // Update this value to the current date whenever changes are made to BBCode::convert
56 const VERSION = '2021-07-28';
60 const MASTODON_API = 2;
63 const TWITTER_API = 5;
67 const ACTIVITYPUB = 9;
69 const TOP_ANCHOR = '<br class="top-anchor">';
70 const BOTTOM_ANCHOR = '<br class="button-anchor">';
72 * Fetches attachment data that were generated the old way
74 * @param string $body Message body
76 * 'type' -> Message type ('link', 'video', 'photo')
77 * 'text' -> Text before the shared message
78 * 'after' -> Text after the shared message
79 * 'image' -> Preview image of the message
80 * 'url' -> Url to the attached message
81 * 'title' -> Title of the attachment
82 * 'description' -> Description of the attachment
83 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
85 private static function getOldAttachmentData(string $body): array
89 // Simplify image codes
90 $body = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $body);
92 if (preg_match_all("(\[class=(.*?)\](.*?)\[\/class\])ism", $body, $attached, PREG_SET_ORDER)) {
93 foreach ($attached as $data) {
94 if (!in_array($data[1], ['type-link', 'type-video', 'type-photo'])) {
98 $post['type'] = substr($data[1], 5);
100 $pos = strpos($body, $data[0]);
102 $post['text'] = trim(substr($body, 0, $pos));
103 $post['after'] = trim(substr($body, $pos + strlen($data[0])));
105 $post['text'] = trim(str_replace($data[0], '', $body));
109 $attacheddata = $data[2];
111 if (preg_match("/\[img\](.*?)\[\/img\]/ism", $attacheddata, $matches)) {
113 $picturedata = Images::getInfoFromURLCached($matches[1]);
116 if (($picturedata[0] >= 500) && ($picturedata[0] >= $picturedata[1])) {
117 $post['image'] = $matches[1];
119 $post['preview'] = $matches[1];
124 if (preg_match("/\[bookmark\=(.*?)\](.*?)\[\/bookmark\]/ism", $attacheddata, $matches)) {
125 $post['url'] = $matches[1];
126 $post['title'] = $matches[2];
128 if (!empty($post['url']) && (in_array($post['type'], ['link', 'video']))
129 && preg_match("/\[url\=(.*?)\](.*?)\[\/url\]/ism", $attacheddata, $matches)) {
130 $post['url'] = $matches[1];
133 // Search for description
134 if (preg_match("/\[quote\](.*?)\[\/quote\]/ism", $attacheddata, $matches)) {
135 $post['description'] = $matches[1];
143 * Fetches attachment data that were generated with the "attachment" element
145 * @param string $body Message body
147 * 'type' -> Message type ('link', 'video', 'photo')
148 * 'text' -> Text before the shared message
149 * 'after' -> Text after the shared message
150 * 'image' -> Preview image of the message
151 * 'url' -> Url to the attached message
152 * 'title' -> Title of the attachment
153 * 'description' -> Description of the attachment
154 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
156 public static function getAttachmentData(string $body): array
158 DI::profiler()->startRecording('rendering');
167 'provider_name' => '',
168 'provider_url' => '',
173 if (!preg_match("/(.*)\[attachment(.*?)\](.*?)\[\/attachment\](.*)/ism", $body, $match)) {
174 DI::profiler()->stopRecording();
175 return self::getOldAttachmentData($body);
178 $attributes = $match[2];
180 $data['text'] = trim($match[1]);
182 foreach (['type', 'url', 'title', 'image', 'preview', 'publisher_name', 'publisher_url', 'author_name', 'author_url'] as $field) {
183 preg_match('/' . preg_quote($field, '/') . '=("|\')(.*?)\1/ism', $attributes, $matches);
184 $value = $matches[2] ?? '';
188 case 'publisher_name':
189 $data['provider_name'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
192 case 'publisher_url':
193 $data['provider_url'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
197 $data['author_name'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
198 if ($data['provider_name'] == $data['author_name']) {
199 $data['author_name'] = '';
204 $data['author_url'] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
205 if ($data['provider_url'] == $data['author_url']) {
206 $data['author_url'] = '';
211 $value = self::convert(html_entity_decode($value, ENT_QUOTES, 'UTF-8'), false, true);
212 $value = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
213 $value = str_replace(['[', ']'], ['[', ']'], $value);
214 $data['title'] = $value;
217 $data[$field] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
223 if (!in_array($data['type'], ['link', 'audio', 'photo', 'video'])) {
224 DI::profiler()->stopRecording();
228 $data['description'] = trim($match[3]);
230 $data['after'] = trim($match[4]);
232 $parts = parse_url($data['url']);
233 if (!empty($parts['scheme']) && !empty($parts['host'])) {
234 if (empty($data['provider_name'])) {
235 $data['provider_name'] = $parts['host'];
237 if (empty($data['provider_url']) || empty(parse_url($data['provider_url'], PHP_URL_SCHEME))) {
238 $data['provider_url'] = $parts['scheme'] . '://' . $parts['host'];
240 if (!empty($parts['port'])) {
241 $data['provider_url'] .= ':' . $parts['port'];
246 DI::profiler()->stopRecording();
250 public static function getAttachedData(string $body, array $item = []): array
254 - type: link, video, photo
262 DI::profiler()->startRecording('rendering');
263 $has_title = !empty($item['title']);
264 $plink = $item['plink'] ?? '';
265 $post = self::getAttachmentData($body);
267 // Get all linked images with alternative image description
268 if (preg_match_all("/\[img=(http[^\[\]]*)\]([^\[\]]*)\[\/img\]/Usi", $body, $pictures, PREG_SET_ORDER)) {
269 foreach ($pictures as $picture) {
270 if (Photo::isLocal($picture[1])) {
271 $post['images'][] = ['url' => str_replace('-1.', '-0.', $picture[1]), 'description' => $picture[2]];
273 $post['remote_images'][] = ['url' => $picture[1], 'description' => $picture[2]];
276 if (!empty($post['images']) && !empty($post['images'][0]['description'])) {
277 $post['image_description'] = $post['images'][0]['description'];
281 if (preg_match_all("/\[img\]([^\[\]]*)\[\/img\]/Usi", $body, $pictures, PREG_SET_ORDER)) {
282 foreach ($pictures as $picture) {
283 if (Photo::isLocal($picture[1])) {
284 $post['images'][] = ['url' => str_replace('-1.', '-0.', $picture[1]), 'description' => ''];
286 $post['remote_images'][] = ['url' => $picture[1], 'description' => ''];
291 if (!isset($post['type'])) {
292 $post['text'] = $body;
295 // Simplify image codes
296 $post['text'] = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $post['text']);
297 $post['text'] = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", '[img]$1[/img]', $post['text']);
299 // if nothing is found, it maybe having an image.
300 if (!isset($post['type'])) {
301 if (preg_match_all("#\[url=([^\]]+?)\]\s*\[img\]([^\[]+?)\[/img\]\s*\[/url\]#ism", $post['text'], $pictures, PREG_SET_ORDER)) {
302 if ((count($pictures) == 1) && !$has_title) {
303 if (!empty($item['object-type']) && ($item['object-type'] == Activity\ObjectType::IMAGE)) {
304 // Replace the preview picture with the real picture
305 $url = str_replace('-1.', '-0.', $pictures[0][2]);
306 $data = ['url' => $url, 'type' => 'photo'];
308 // Checking, if the link goes to a picture
309 $data = ParseUrl::getSiteinfoCached($pictures[0][1]);
313 // Sometimes photo posts to the own album are not detected at the start.
314 // So we seem to cannot use the cache for these cases. That's strange.
315 if (($data['type'] != 'photo') && strstr($pictures[0][1], '/photos/')) {
316 $data = ParseUrl::getSiteinfo($pictures[0][1]);
319 if ($data['type'] == 'photo') {
320 $post['type'] = 'photo';
321 if (isset($data['images'][0])) {
322 $post['image'] = $data['images'][0]['src'];
323 $post['url'] = $data['url'];
325 $post['image'] = $data['url'];
328 $post['preview'] = $pictures[0][2];
329 $post['text'] = trim(str_replace($pictures[0][0], '', $post['text']));
331 $imgdata = Images::getInfoFromURLCached($pictures[0][1]);
332 if (($imgdata) && substr($imgdata['mime'], 0, 6) == 'image/') {
333 $post['type'] = 'photo';
334 $post['image'] = $pictures[0][1];
335 $post['preview'] = $pictures[0][2];
336 $post['text'] = trim(str_replace($pictures[0][0], '', $post['text']));
339 } elseif (count($pictures) > 0) {
340 if (count($pictures) > 4) {
341 $post['type'] = 'link';
342 $post['url'] = $plink;
344 $post['type'] = 'photo';
347 $post['image'] = $pictures[0][2];
349 foreach ($pictures as $picture) {
350 $post['text'] = trim(str_replace($picture[0], '', $post['text']));
353 } elseif (preg_match_all("(\[img\](.*?)\[\/img\])ism", $post['text'], $pictures, PREG_SET_ORDER)) {
355 $post['type'] = 'link';
356 $post['url'] = $plink;
358 $post['type'] = 'photo';
361 $post['image'] = $pictures[0][1];
362 foreach ($pictures as $picture) {
363 $post['text'] = trim(str_replace($picture[0], '', $post['text']));
367 // Test for the external links
368 preg_match_all("(\[url\](.*?)\[\/url\])ism", $post['text'], $links1, PREG_SET_ORDER);
369 preg_match_all("(\[url\=(.*?)\].*?\[\/url\])ism", $post['text'], $links2, PREG_SET_ORDER);
371 $links = array_merge($links1, $links2);
373 // If there is only a single one, then use it.
374 // This should cover link posts via API.
375 if ((count($links) == 1) && !isset($post['preview']) && !$has_title) {
376 $post['type'] = 'link';
377 $post['url'] = $links[0][1];
380 // Simplify "video" element
381 $post['text'] = preg_replace('(\[video.*?\ssrc\s?=\s?([^\s\]]+).*?\].*?\[/video\])ism', '[video]$1[/video]', $post['text']);
383 // Now count the number of external media links
384 preg_match_all("(\[vimeo\](.*?)\[\/vimeo\])ism", $post['text'], $links1, PREG_SET_ORDER);
385 preg_match_all("(\[youtube\\](.*?)\[\/youtube\\])ism", $post['text'], $links2, PREG_SET_ORDER);
386 preg_match_all("(\[video\\](.*?)\[\/video\\])ism", $post['text'], $links3, PREG_SET_ORDER);
387 preg_match_all("(\[audio\\](.*?)\[\/audio\\])ism", $post['text'], $links4, PREG_SET_ORDER);
389 // Add them to the other external links
390 $links = array_merge($links, $links1, $links2, $links3, $links4);
392 // Are there more than one?
393 if (count($links) > 1) {
394 // The post will be the type "text", which means a blog post
395 unset($post['type']);
396 $post['url'] = $plink;
399 if (!isset($post['type'])) {
400 $post['type'] = 'text';
403 if (($post['type'] == 'photo') && empty($post['images']) && !empty($post['remote_images'])) {
404 $post['images'] = $post['remote_images'];
405 $post['image'] = $post['images'][0]['url'];
406 if (!empty($post['images']) && !empty($post['images'][0]['description'])) {
407 $post['image_description'] = $post['images'][0]['description'];
410 unset($post['remote_images']);
411 } elseif (isset($post['url']) && ($post['type'] == 'video')) {
412 $data = ParseUrl::getSiteinfoCached($post['url']);
414 if (isset($data['images'][0])) {
415 $post['image'] = $data['images'][0]['src'];
417 } elseif (preg_match_all("#\[url=([^\]]+?)\]\s*\[img\]([^\[]+?)\[/img\]\s*\[/url\]#ism", $post['text'], $pictures, PREG_SET_ORDER)) {
418 foreach ($pictures as $picture) {
419 $post['text'] = trim(str_replace($picture[0], '', $post['text']));
423 DI::profiler()->stopRecording();
428 * Remove [attachment] BBCode and replaces it with a regular [url]
430 * @param string $body
431 * @param boolean $no_link_desc No link description
432 * @return string with replaced body
434 public static function removeAttachment(string $body, bool $no_link_desc = false): string
436 return preg_replace_callback("/\s*\[attachment (.*?)\](.*?)\[\/attachment\]\s*/ism",
437 function ($match) use ($body, $no_link_desc) {
438 $attach_data = self::getAttachmentData($match[0]);
439 if (empty($attach_data['url'])) {
441 } elseif (strpos(str_replace($match[0], '', $body), $attach_data['url']) !== false) {
443 } elseif (empty($attach_data['title']) || $no_link_desc) {
444 return " \n[url]" . $attach_data['url'] . "[/url]\n";
446 return " \n[url=" . $attach_data['url'] . ']' . $attach_data['title'] . "[/url]\n";
452 * Converts a BBCode text into plaintext
454 * @param string $text
455 * @param bool $keep_urls Whether to keep URLs in the resulting plaintext
458 public static function toPlaintext(string $text, bool $keep_urls = true): string
460 DI::profiler()->startRecording('rendering');
461 // Remove pictures in advance to avoid unneeded proxy calls
462 $text = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", ' $2 ', $text);
463 $text = preg_replace("/\[img.*?\[\/img\]/ism", ' ', $text);
466 $text = self::removeAttachment($text);
468 $naked_text = HTML::toPlaintext(self::convert($text, false, 0, true), 0, !$keep_urls);
470 DI::profiler()->stopRecording();
474 private static function proxyUrl(string $image, int $simplehtml = self::INTERNAL, int $uriid = 0, string $size = ''): string
476 // Only send proxied pictures to API and for internal display
477 if (!in_array($simplehtml, [self::INTERNAL, self::MASTODON_API, self::TWITTER_API])) {
479 } elseif ($uriid > 0) {
480 return Post\Link::getByLink($uriid, $image, $size);
482 return Proxy::proxifyUrl($image, $size);
487 * This function changing the visual size (not the real size) of images.
488 * The function does not work for pictures with an alternate text description.
489 * This could only be changed by using some new "img" BBCode format.
491 * @param string $srctext The body with images
492 * @return string The body with possibly scaled images
494 public static function scaleExternalImages(string $srctext): string
496 DI::profiler()->startRecording('rendering');
499 // Simplify image links
500 $s = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $s);
503 $c = preg_match_all('/\[img.*?\](.*?)\[\/img\]/ism', $s, $matches, PREG_SET_ORDER);
505 foreach ($matches as $mtch) {
506 Logger::debug('scale_external_image', ['image' => $mtch[1]]);
508 $hostname = str_replace('www.', '', substr(DI::baseUrl(), strpos(DI::baseUrl(), '://') + 3));
509 if (stristr($mtch[1], $hostname)) {
513 $curlResult = DI::httpClient()->get($mtch[1], HttpClientAccept::IMAGE);
514 if (!$curlResult->isSuccess()) {
518 Logger::debug('Got picture', ['Content-Type' => $curlResult->getHeader('Content-Type'), 'url' => $mtch[1]]);
520 $i = $curlResult->getBody();
521 $type = $curlResult->getContentType();
522 $type = Images::getMimeTypeByData($i, $mtch[1], $type);
525 $Image = new Image($i, $type);
526 if ($Image->isValid()) {
527 $orig_width = $Image->getWidth();
528 $orig_height = $Image->getHeight();
530 if ($orig_width > 640 || $orig_height > 640) {
531 $Image->scaleDown(640);
532 $new_width = $Image->getWidth();
533 $new_height = $Image->getHeight();
534 Logger::debug('External images scaled', ['orig_width' => $orig_width, 'new_width' => $new_width, 'orig_height' => $orig_height, 'new_height' => $new_height, 'match' => $mtch[0]]);
537 '[img=' . $new_width . 'x' . $new_height. ']' . $mtch[1] . '[/img]'
541 Logger::debug('New string', ['image' => $s]);
548 DI::profiler()->stopRecording();
553 * Truncates imported message body string length to max_import_size
555 * The purpose of this function is to apply system message length limits to
556 * imported messages without including any embedded photos in the length
558 * @param string $body
560 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
562 public static function limitBodySize(string $body): string
564 DI::profiler()->startRecording('rendering');
565 $maxlen = DI::config()->get('config', 'max_import_size', 0);
567 // If the length of the body, including the embedded images, is smaller
568 // than the maximum, then don't waste time looking for the images
569 if ($maxlen && (strlen($body) > $maxlen)) {
571 Logger::info('the total body length exceeds the limit', ['maxlen' => $maxlen, 'body_len' => strlen($body)]);
577 $img_start = strpos($orig_body, '[img');
578 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
579 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
580 while (($img_st_close !== false) && ($img_end !== false)) {
582 $img_st_close++; // make it point to AFTER the closing bracket
583 $img_end += $img_start;
584 $img_end += strlen('[/img]');
586 if (!strcmp(substr($orig_body, $img_start + $img_st_close, 5), 'data:')) {
587 // This is an embedded image
589 if (($textlen + $img_start) > $maxlen) {
590 if ($textlen < $maxlen) {
591 Logger::debug('the limit happens before an embedded image');
592 $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
596 $new_body = $new_body . substr($orig_body, 0, $img_start);
597 $textlen += $img_start;
600 $new_body = $new_body . substr($orig_body, $img_start, $img_end - $img_start);
603 if (($textlen + $img_end) > $maxlen) {
604 if ($textlen < $maxlen) {
605 Logger::debug('the limit happens before the end of a non-embedded image');
606 $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
610 $new_body = $new_body . substr($orig_body, 0, $img_end);
611 $textlen += $img_end;
614 $orig_body = substr($orig_body, $img_end);
616 if ($orig_body === false) {
617 // in case the body ends on a closing image tag
621 $img_start = strpos($orig_body, '[img');
622 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
623 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
626 if (($textlen + strlen($orig_body)) > $maxlen) {
627 if ($textlen < $maxlen) {
628 Logger::debug('the limit happens after the end of the last image');
629 $new_body = $new_body . substr($orig_body, 0, $maxlen - $textlen);
632 Logger::debug('the text size with embedded images extracted did not violate the limit');
633 $new_body = $new_body . $orig_body;
636 DI::profiler()->stopRecording();
639 DI::profiler()->stopRecording();
645 * Processes [attachment] tags
647 * Note: Can produce a [bookmark] tag in the returned string
649 * @param string $text
650 * @param integer $simplehtml
651 * @param bool $tryoembed
655 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
657 public static function convertAttachment(string $text, int $simplehtml = self::INTERNAL, bool $tryoembed = true, array $data = [], int $uriid = 0): string
659 DI::profiler()->startRecording('rendering');
660 $data = $data ?: self::getAttachmentData($text);
661 if (empty($data) || empty($data['url'])) {
662 DI::profiler()->stopRecording();
666 if (isset($data['title'])) {
667 $data['title'] = strip_tags($data['title']);
668 $data['title'] = str_replace(['http://', 'https://'], '', $data['title']);
673 if (((strpos($data['text'], '[img=') !== false) || (strpos($data['text'], '[img]') !== false) || DI::config()->get('system', 'always_show_preview')) && !empty($data['image'])) {
674 $data['preview'] = $data['image'];
680 if ($tryoembed && OEmbed::isAllowedURL($data['url'])) {
681 $return = OEmbed::getHTML($data['url'], $data['title']);
683 throw new Exception('OEmbed is disabled for this attachment.');
685 } catch (Exception $e) {
686 $data['title'] = ($data['title'] ?? '') ?: $data['url'];
688 if ($simplehtml != self::CONNECTORS) {
689 $return = sprintf('<div class="type-%s">', $data['type']);
692 if (!empty($data['title']) && !empty($data['url'])) {
693 if (!empty($data['image']) && empty($data['text']) && ($data['type'] == 'photo')) {
694 $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']);
696 if (!empty($data['image'])) {
697 $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']);
698 } elseif (!empty($data['preview'])) {
699 $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']);
701 $return .= sprintf('<h4><a href="%s" target="_blank" rel="noopener noreferrer">%s</a></h4>', $data['url'], $data['title']);
705 if (!empty($data['description']) && $data['description'] != $data['title']) {
707 $return .= sprintf('<blockquote>%s</blockquote>', trim(HTML::purify($data['description'])));
710 if (!empty($data['provider_url']) && !empty($data['provider_name'])) {
711 if (!empty($data['author_name'])) {
712 $return .= sprintf('<sup><a href="%s" target="_blank" rel="noopener noreferrer">%s (%s)</a></sup>', $data['provider_url'], $data['author_name'], $data['provider_name']);
714 $return .= sprintf('<sup><a href="%s" target="_blank" rel="noopener noreferrer">%s</a></sup>', $data['provider_url'], $data['provider_name']);
718 if ($simplehtml != self::CONNECTORS) {
723 DI::profiler()->stopRecording();
724 return trim(($data['text'] ?? '') . ' ' . $return . ' ' . ($data['after'] ?? ''));
727 public static function removeShareInformation(string $text, bool $plaintext = false, bool $nolink = false): string
729 DI::profiler()->startRecording('rendering');
730 $data = self::getAttachmentData($text);
733 DI::profiler()->stopRecording();
736 DI::profiler()->stopRecording();
737 return $data['text'] . ($data['after'] ?? '');
740 $title = htmlentities($data['title'] ?? '', ENT_QUOTES, 'UTF-8', false);
741 $text = htmlentities($data['text'], ENT_QUOTES, 'UTF-8', false);
742 if ($plaintext || (($title != '') && strstr($text, $title))) {
743 $data['title'] = $data['url'];
744 } elseif (($text != '') && strstr($title, $text)) {
745 $data['text'] = $data['title'];
746 $data['title'] = $data['url'];
749 if (empty($data['text']) && !empty($data['title']) && empty($data['url'])) {
750 DI::profiler()->stopRecording();
751 return $data['title'] . $data['after'];
754 // If the link already is included in the post, don't add it again
755 if (!empty($data['url']) && strpos($data['text'], $data['url'])) {
756 DI::profiler()->stopRecording();
757 return $data['text'] . $data['after'];
760 $text = $data['text'];
762 if (!empty($data['url']) && !empty($data['title'])) {
763 $text .= "\n[url=" . $data['url'] . ']' . $data['title'] . '[/url]';
764 } elseif (!empty($data['url'])) {
765 $text .= "\n[url]" . $data['url'] . '[/url]';
768 DI::profiler()->stopRecording();
769 return $text . "\n" . $data['after'];
773 * Converts [url] BBCodes in a format that looks fine on Mastodon. (callback function)
775 * @param array $match Array with the matching values
776 * @return string reformatted link including HTML codes
778 private static function convertUrlForActivityPubCallback(array $match): string
782 if (isset($match[2]) && ($match[1] != $match[2])) {
786 $parts = parse_url($url);
787 if (!isset($parts['scheme'])) {
791 return self::convertUrlForActivityPub($url);
795 * Converts [url] BBCodes in a format that looks fine on ActivityPub systems.
797 * @param string $url URL that is about to be reformatted
798 * @return string reformatted link including HTML codes
800 private static function convertUrlForActivityPub(string $url): string
802 return sprintf('<a href="%s" target="_blank" rel="noopener noreferrer">%s</a>', $url, self::getStyledURL($url));
806 * Converts an URL in a nicer format (without the scheme and possibly shortened)
808 * @param string $url URL that is about to be reformatted
809 * @return string reformatted link
811 private static function getStyledURL(string $url): string
813 $parts = parse_url($url);
814 $scheme = $parts['scheme'] . '://';
815 $styled_url = str_replace($scheme, '', $url);
817 if (strlen($styled_url) > 30) {
818 $styled_url = substr($styled_url, 0, 30) . "…";
825 * [noparse][i]italic[/i][/noparse] turns into
826 * [noparse][ i ]italic[ /i ][/noparse],
827 * to hide them from parser.
829 * @param array $match
832 private static function escapeNoparseCallback(array $match): string
834 $whole_match = $match[0];
835 $captured = $match[1];
836 $spacefied = preg_replace("/\[(.*?)\]/", "[ $1 ]", $captured);
837 $new_str = str_replace($captured, $spacefied, $whole_match);
842 * The previously spacefied [noparse][ i ]italic[ /i ][/noparse],
843 * now turns back and the [noparse] tags are trimed
844 * returning [i]italic[/i]
846 * @param array $match
849 private static function unescapeNoparseCallback(array $match): string
851 $captured = $match[1];
852 $unspacefied = preg_replace("/\[ (.*?)\ ]/", "[$1]", $captured);
857 * Returns the bracket character positions of a set of opening and closing BBCode tags, optionally skipping first
860 * @param string $text Text to search
861 * @param string $name Tag name
862 * @param int $occurrences Number of first occurrences to skip
863 * @return boolean|array
865 public static function getTagPosition(string $text, string $name, int $occurrences = 0)
867 DI::profiler()->startRecording('rendering');
868 if ($occurrences < 0) {
873 for ($i = 0; $i <= $occurrences; $i++) {
874 if ($start_open !== false) {
875 $start_open = strpos($text, '[' . $name, $start_open + 1); // allow [name= type tags
879 if ($start_open === false) {
880 DI::profiler()->stopRecording();
884 $start_equal = strpos($text, '=', $start_open);
885 $start_close = strpos($text, ']', $start_open);
887 if ($start_close === false) {
888 DI::profiler()->stopRecording();
894 $end_open = strpos($text, '[/' . $name . ']', $start_close);
896 if ($end_open === false) {
897 DI::profiler()->stopRecording();
903 'open' => $start_open,
904 'close' => $start_close
908 'close' => $end_open + strlen('[/' . $name . ']')
912 if ($start_equal !== false) {
913 $res['start']['equal'] = $start_equal + 1;
916 DI::profiler()->stopRecording();
921 * Performs a preg_replace within the boundaries of all named BBCode tags in a text
923 * @param string $pattern Preg pattern string
924 * @param string $replace Preg replace string
925 * @param string $name BBCode tag name
926 * @param string $text Text to search
929 public static function pregReplaceInTag(string $pattern, string $replace, string $name, string $text): string
931 DI::profiler()->startRecording('rendering');
933 $pos = self::getTagPosition($text, $name, $occurrences);
934 while ($pos !== false && $occurrences++ < 1000) {
935 $start = substr($text, 0, $pos['start']['open']);
936 $subject = substr($text, $pos['start']['open'], $pos['end']['close'] - $pos['start']['open']);
937 $end = substr($text, $pos['end']['close']);
938 if ($end === false) {
942 $subject = preg_replace($pattern, $replace, $subject);
943 $text = $start . $subject . $end;
945 $pos = self::getTagPosition($text, $name, $occurrences);
948 DI::profiler()->stopRecording();
952 private static function extractImagesFromItemBody(string $body): array
959 $img_start = strpos($orig_body, '[img');
960 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
961 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
962 while (($img_st_close !== false) && ($img_end !== false)) {
963 $img_st_close++; // make it point to AFTER the closing bracket
964 $img_end += $img_start;
966 if (!strcmp(substr($orig_body, $img_start + $img_st_close, 5), 'data:')) {
967 // This is an embedded image
968 $saved_image[$cnt] = substr($orig_body, $img_start + $img_st_close, $img_end - ($img_start + $img_st_close));
969 $new_body = $new_body . substr($orig_body, 0, $img_start) . '[$#saved_image' . $cnt . '#$]';
973 $new_body = $new_body . substr($orig_body, 0, $img_end + strlen('[/img]'));
976 $orig_body = substr($orig_body, $img_end + strlen('[/img]'));
978 if ($orig_body === false) {
979 // in case the body ends on a closing image tag
983 $img_start = strpos($orig_body, '[img');
984 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
985 $img_end = ($img_start !== false ? strpos(substr($orig_body, $img_start), '[/img]') : false);
988 $new_body = $new_body . $orig_body;
990 return ['body' => $new_body, 'images' => $saved_image];
993 private static function interpolateSavedImagesIntoItemBody(int $uriid, string $body, array $images): string
998 foreach ($images as $image) {
999 // We're depending on the property of 'foreach' (specified on the PHP website) that
1000 // it loops over the array starting from the first element and going sequentially
1001 // to the last element
1002 $newbody = str_replace('[$#saved_image' . $cnt . '#$]',
1003 '<img src="' . self::proxyUrl($image, self::INTERNAL, $uriid) . '" alt="' . DI::l10n()->t('Image/photo') . '" />', $newbody);
1011 * @param string $text A BBCode string
1012 * @return array Empty array if no share tag is present or the following array, missing attributes end up empty strings:
1013 * - comment : Text before the opening share tag
1014 * - shared : Text inside the share tags
1015 * - author : (Optional) Display name of the shared author
1016 * - profile : (Optional) Profile page URL of the shared author
1017 * - avatar : (Optional) Profile picture URL of the shared author
1018 * - link : (Optional) Canonical URL of the shared post
1019 * - posted : (Optional) Date the shared post was initially posted ("Y-m-d H:i:s" in GMT)
1020 * - message_id: (Optional) Shared post URI if any
1021 * - guid : (Optional) Shared post GUID if any
1023 public static function fetchShareAttributes(string $text): array
1025 DI::profiler()->startRecording('rendering');
1026 if (preg_match('~(.*?)\[share](.*)\[/share]~ism', $text, $matches)) {
1027 DI::profiler()->stopRecording();
1035 'message_id' => trim($matches[2]),
1036 'comment' => trim($matches[1]),
1040 // See Issue https://github.com/friendica/friendica/issues/10454
1041 // Hashtags in usernames are expanded to links. This here is a quick fix.
1042 $text = preg_replace('~([@!#])\[url=.*?](.*?)\[/url]~ism', '$1$2', $text);
1044 if (!preg_match('~(.*?)\[share(.*?)](.*)\[/share]~ism', $text, $matches)) {
1045 DI::profiler()->stopRecording();
1049 $attributes = self::extractShareAttributes($matches[2]);
1051 $attributes['comment'] = trim($matches[1]);
1052 $attributes['shared'] = trim($matches[3]);
1054 DI::profiler()->stopRecording();
1059 * @see BBCode::fetchShareAttributes()
1060 * @param string $shareString Internal opening share tag string matched by the regular expression
1061 * @return array A fixed attribute array where missing attribute are represented by empty strings
1063 private static function extractShareAttributes(string $shareString): array
1066 foreach (['author', 'profile', 'avatar', 'link', 'posted', 'guid', 'message_id'] as $field) {
1067 preg_match("/$field=(['\"])(.+?)\\1/ism", $shareString, $matches);
1068 $attributes[$field] = html_entity_decode($matches[2] ?? '', ENT_QUOTES, 'UTF-8');
1075 * Remove the share block
1077 * @param string $body
1080 public static function removeSharedData(string $body): string
1082 return trim(preg_replace("/\s*\[share.*?\].*?\[\/share\]\s*/ism", '', $body));
1086 * This function converts a [share] block to text according to a provided callback function whose signature is:
1088 * function(array $attributes, array $author_contact, string $content, boolean $is_quote_share): string
1091 * - $attributes is an array of attributes of the [share] block itself. Missing keys will be completed by the contact
1093 * - $author_contact is a contact record array
1094 * - $content is the inner content of the [share] block
1095 * - $is_quote_share indicates whether there's any content before the [share] block
1096 * - Return value is the string that should replace the [share] block in the provided text
1098 * This function is intended to be used by addon connector to format a share block like the target network is expecting it.
1100 * @param string $text A BBCode string
1101 * @param callable $callback
1102 * @return string The BBCode string with all [share] blocks replaced
1104 public static function convertShare(string $text, callable $callback, int $uriid = 0): string
1106 DI::profiler()->startRecording('rendering');
1107 $return = preg_replace_callback(
1108 '~(.*?)\[share(.*?)](.*)\[/share]~ism',
1109 function ($match) use ($callback, $uriid) {
1110 $attributes = self::extractShareAttributes($match[2]);
1112 $author_contact = Contact::getByURL($attributes['profile'], false, ['id', 'url', 'addr', 'name', 'micro']);
1113 $author_contact['url'] = ($author_contact['url'] ?? $attributes['profile']);
1114 $author_contact['addr'] = ($author_contact['addr'] ?? '');
1116 $attributes['author'] = ($author_contact['name'] ?? '') ?: $attributes['author'];
1117 $attributes['avatar'] = ($author_contact['micro'] ?? '') ?: $attributes['avatar'];
1118 $attributes['profile'] = ($author_contact['url'] ?? '') ?: $attributes['profile'];
1120 if (!empty($author_contact['id'])) {
1121 $attributes['avatar'] = Contact::getAvatarUrlForId($author_contact['id'], Proxy::SIZE_THUMB);
1122 } elseif ($attributes['avatar']) {
1123 $attributes['avatar'] = self::proxyUrl($attributes['avatar'], self::INTERNAL, $uriid, Proxy::SIZE_THUMB);
1126 $content = preg_replace(Strings::autoLinkRegEx(), '<a href="$1">$1</a>', $match[3]);
1128 return $match[1] . $callback($attributes, $author_contact, $content, trim($match[1]) != '');
1133 DI::profiler()->stopRecording();
1134 return trim($return);
1138 * Convert complex IMG and ZMG elements
1140 * @param [type] $text
1141 * @param integer $simplehtml
1142 * @param integer $uriid
1145 private static function convertImages(string $text, int $simplehtml, int $uriid = 0): string
1147 DI::profiler()->startRecording('rendering');
1148 $return = preg_replace_callback(
1149 "/\[[zi]mg(.*?)\]([^\[\]]*)\[\/[zi]mg\]/ism",
1150 function ($match) use ($simplehtml, $uriid) {
1151 $attribute_string = $match[1];
1153 foreach (['alt', 'width', 'height'] as $field) {
1154 preg_match("/$field=(['\"])(.+?)\\1/ism", $attribute_string, $matches);
1155 $attributes[$field] = html_entity_decode($matches[2] ?? '', ENT_QUOTES, 'UTF-8');
1158 $img_str = '<img src="' .
1159 self::proxyUrl($match[2], $simplehtml, $uriid) . '"';
1160 foreach ($attributes as $key => $value) {
1161 if (!empty($value)) {
1162 $img_str .= ' ' . $key . '="' . htmlspecialchars($value, ENT_COMPAT) . '"';
1165 return $img_str . '>';
1170 DI::profiler()->stopRecording();
1175 * Default [share] tag conversion callback
1177 * Note: Can produce a [bookmark] tag in the output
1179 * @see BBCode::convertShare()
1180 * @param array $attributes [share] block attribute values
1181 * @param array $author_contact Contact row of the shared author
1182 * @param string $content Inner content of the [share] block
1183 * @param boolean $is_quote_share Whether there is content before the [share] block
1184 * @param integer $simplehtml Mysterious integer value depending on the target network/formatting style
1186 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1188 private static function convertShareCallback(array $attributes, array $author_contact, string $content, bool $is_quote_share, int $simplehtml): string
1190 DI::profiler()->startRecording('rendering');
1191 $mention = $attributes['author'] . ' (' . ($author_contact['addr'] ?? '') . ')';
1193 switch ($simplehtml) {
1194 case self::MASTODON_API:
1195 case self::TWITTER_API:
1196 $text = ($is_quote_share? '<br>' : '') .
1197 '<b><a href="' . $attributes['link'] . '">' . html_entity_decode('♲', ENT_QUOTES, 'UTF-8') . ' ' . $author_contact['addr'] . "</a>:</b><br>\n" .
1198 '<blockquote class="shared_content" dir="auto">' . $content . '</blockquote>';
1200 case self::DIASPORA:
1201 if (stripos(Strings::normaliseLink($attributes['link']), 'http://twitter.com/') === 0) {
1202 $text = ($is_quote_share? '<hr />' : '') . '<p><a href="' . $attributes['link'] . '">' . $attributes['link'] . '</a></p>' . "\n";
1204 $headline = '<p><b>♲ <a href="' . $attributes['profile'] . '">' . $attributes['author'] . '</a>:</b></p>' . "\n";
1206 if (!empty($attributes['posted']) && !empty($attributes['link'])) {
1207 $headline = '<p><b>♲ <a href="' . $attributes['profile'] . '">' . $attributes['author'] . '</a></b> - <a href="' . $attributes['link'] . '">' . $attributes['posted'] . ' GMT</a></p>' . "\n";
1210 $text = ($is_quote_share? '<hr />' : '') . $headline . '<blockquote>' . trim($content) . '</blockquote>' . "\n";
1212 if (empty($attributes['posted']) && !empty($attributes['link'])) {
1213 $text .= '<p><a href="' . $attributes['link'] . '">[Source]</a></p>' . "\n";
1218 case self::CONNECTORS:
1219 $headline = '<p><b>' . html_entity_decode('♲ ', ENT_QUOTES, 'UTF-8');
1220 $headline .= DI::l10n()->t('<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a> %3$s', $attributes['link'], $mention, $attributes['posted']);
1221 $headline .= ':</b></p>' . "\n";
1223 $text = ($is_quote_share? '<hr />' : '') . $headline . '<blockquote class="shared_content" dir="auto">' . trim($content) . '</blockquote>' . "\n";
1227 $text = ($is_quote_share? '<br>' : '') . '<p>' . html_entity_decode('♲ ', ENT_QUOTES, 'UTF-8') . ' @' . $author_contact['addr'] . ': ' . $content . '</p>' . "\n";
1229 case self::ACTIVITYPUB:
1230 $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>';
1231 $text = '<div><a href="' . $attributes['link'] . '">' . html_entity_decode('♲', ENT_QUOTES, 'UTF-8') . '</a> ' . $author . '<blockquote>' . $content . '</blockquote></div>' . "\n";
1234 $text = ($is_quote_share? "\n" : '');
1236 $contact = Contact::getByURL($attributes['profile'], false, ['network']);
1237 $network = $contact['network'] ?? Protocol::PHANTOM;
1239 $tpl = Renderer::getMarkupTemplate('shared_content.tpl');
1240 $text .= Renderer::replaceMacros($tpl, [
1241 '$profile' => $attributes['profile'],
1242 '$avatar' => $attributes['avatar'],
1243 '$author' => $attributes['author'],
1244 '$link' => $attributes['link'],
1245 '$link_title' => DI::l10n()->t('Link to source'),
1246 '$posted' => $attributes['posted'],
1247 '$guid' => $attributes['guid'],
1248 '$network_name' => ContactSelector::networkToName($network, $attributes['profile']),
1249 '$network_icon' => ContactSelector::networkToIcon($network, $attributes['profile']),
1250 '$content' => self::TOP_ANCHOR . self::setMentions(trim($content), 0, $network) . self::BOTTOM_ANCHOR,
1258 private static function removePictureLinksCallback(array $match): string
1260 $cache_key = 'remove:' . $match[1];
1261 $text = DI::cache()->get($cache_key);
1263 if (is_null($text)) {
1264 $curlResult = DI::httpClient()->head($match[1], [HttpClientOptions::TIMEOUT => DI::config()->get('system', 'xrd_timeout')]);
1265 if ($curlResult->isSuccess()) {
1266 $mimetype = $curlResult->getHeader('Content-Type')[0] ?? '';
1271 if (substr($mimetype, 0, 6) == 'image/') {
1272 $text = '[url=' . $match[1] . ']' . $match[1] . '[/url]';
1274 $text = '[url=' . $match[2] . ']' . $match[2] . '[/url]';
1276 // if its not a picture then look if its a page that contains a picture link
1277 $body = DI::httpClient()->fetch($match[1], HttpClientAccept::HTML, 0);
1279 DI::cache()->set($cache_key, $text);
1283 $doc = new DOMDocument();
1284 @$doc->loadHTML($body);
1285 $xpath = new DOMXPath($doc);
1286 $list = $xpath->query('//meta[@name]');
1287 foreach ($list as $node) {
1290 if ($node->attributes->length) {
1291 foreach ($node->attributes as $attribute) {
1292 $attr[$attribute->name] = $attribute->value;
1296 if (strtolower($attr['name']) == 'twitter:image') {
1297 $text = '[url=' . $attr['content'] . ']' . $attr['content'] . '[/url]';
1301 DI::cache()->set($cache_key, $text);
1308 * Callback: Expands links from given $match array
1310 * @param array $match Array with link match
1311 * @return string BBCode
1313 private static function expandLinksCallback(array $match): string
1315 if (($match[3] == '') || ($match[2] == $match[3]) || stristr($match[2], $match[3])) {
1316 return ($match[1] . '[url]' . $match[2] . '[/url]');
1318 return ($match[1] . $match[3] . ' [url]' . $match[2] . '[/url]');
1323 * Callback: Cleans picture links
1325 * @param array $match Array with link match
1326 * @return string BBCode
1328 private static function cleanPictureLinksCallback(array $match): string
1330 // When the picture link is the own photo path then we can avoid fetching the link
1331 $own_photo_url = preg_quote(Strings::normaliseLink(DI::baseUrl()->get()) . '/photos/');
1332 if (preg_match('|' . $own_photo_url . '.*?/image/|', Strings::normaliseLink($match[1]))) {
1333 if (!empty($match[3])) {
1334 $text = '[img=' . str_replace('-1.', '-0.', $match[2]) . ']' . $match[3] . '[/img]';
1336 $text = '[img]' . str_replace('-1.', '-0.', $match[2]) . '[/img]';
1341 $cache_key = 'clean:' . $match[1];
1342 $text = DI::cache()->get($cache_key);
1343 if (!is_null($text)) {
1347 $curlResult = DI::httpClient()->head($match[1], [HttpClientOptions::TIMEOUT => DI::config()->get('system', 'xrd_timeout')]);
1348 if ($curlResult->isSuccess()) {
1349 $mimetype = $curlResult->getHeader('Content-Type')[0] ?? '';
1354 // if its a link to a picture then embed this picture
1355 if (substr($mimetype, 0, 6) == 'image/') {
1356 $text = '[img]' . $match[1] . '[/img]';
1358 if (!empty($match[3])) {
1359 $text = '[img=' . $match[2] . ']' . $match[3] . '[/img]';
1361 $text = '[img]' . $match[2] . '[/img]';
1364 // if its not a picture then look if its a page that contains a picture link
1365 $body = DI::httpClient()->fetch($match[1], HttpClientAccept::HTML, 0);
1367 DI::cache()->set($cache_key, $text);
1371 $doc = new DOMDocument();
1372 @$doc->loadHTML($body);
1373 $xpath = new DOMXPath($doc);
1374 $list = $xpath->query('//meta[@name]');
1375 foreach ($list as $node) {
1377 if ($node->attributes->length) {
1378 foreach ($node->attributes as $attribute) {
1379 $attr[$attribute->name] = $attribute->value;
1383 if (strtolower($attr['name']) == "twitter:image") {
1384 if (!empty($match[3])) {
1385 $text = "[img=" . $attr['content'] . "]" . $match[3] . "[/img]";
1387 $text = "[img]" . $attr['content'] . "[/img]";
1392 DI::cache()->set($cache_key, $text);
1398 * Cleans picture links
1400 * @param string $text HTML/BBCode string
1401 * @return string Cleaned HTML/BBCode
1403 public static function cleanPictureLinks(string $text): string
1405 DI::profiler()->startRecording('rendering');
1406 $return = preg_replace_callback("&\[url=([^\[\]]*)\]\[img=(.*)\](.*)\[\/img\]\[\/url\]&Usi", 'self::cleanPictureLinksCallback', $text);
1407 $return = preg_replace_callback("&\[url=([^\[\]]*)\]\[img\](.*)\[\/img\]\[\/url\]&Usi", 'self::cleanPictureLinksCallback', $return);
1408 DI::profiler()->stopRecording();
1415 * @param string $text HTML/BBCode string
1416 * @return string Cleaned HTML/BBCode
1418 public static function removeLinks(string $bbcode): string
1420 DI::profiler()->startRecording('rendering');
1421 $bbcode = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/ism", ' $1 ', $bbcode);
1422 $bbcode = preg_replace("/\[img.*?\[\/img\]/ism", ' ', $bbcode);
1424 $bbcode = preg_replace('/[@!#]\[url\=.*?\].*?\[\/url\]/ism', '', $bbcode);
1425 $bbcode = preg_replace("/\[url=[^\[\]]*\](.*)\[\/url\]/Usi", ' $1 ', $bbcode);
1426 $bbcode = preg_replace('/[@!#]?\[url.*?\[\/url\]/ism', '', $bbcode);
1427 DI::profiler()->stopRecording();
1432 * Replace names in mentions with nicknames
1434 * @param string $body HTML/BBCode
1435 * @return string Body with replaced mentions
1437 public static function setMentionsToNicknames(string $body): string
1439 DI::profiler()->startRecording('rendering');
1440 $regexp = "/([@!])\[url\=([^\[\]]*)\].*?\[\/url\]/ism";
1441 $body = preg_replace_callback($regexp, ['self', 'mentionCallback'], $body);
1442 DI::profiler()->stopRecording();
1447 * Callback function to replace a Friendica style mention in a mention with the nickname
1449 * @param array $match Matching values for the callback
1450 * @return string Replaced mention or empty string
1451 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1453 private static function mentionCallback(array $match): string
1455 if (empty($match[2])) {
1459 $data = Contact::getByURL($match[2], false, ['url', 'nick']);
1460 if (empty($data['nick'])) {
1464 return $match[1] . '[url=' . $data['url'] . ']' . $data['nick'] . '[/url]';
1468 * Converts a BBCode message for a given URI-ID to a HTML message
1470 * BBcode 2 HTML was written by WAY2WEB.net
1471 * extended to work with Mistpark/Friendica - Mike Macgirvin
1473 * Simple HTML values meaning:
1474 * - 0: Friendica display
1476 * - 2: Used for Windows Phone push, Friendica API
1477 * - 3: Used before converting to Markdown in bb2diaspora.php
1478 * - 4: Used for WordPress, Libertree (before Markdown), pump.io and tumblr
1481 * - 7: Used for dfrn, OStatus
1482 * - 8: Used for Twitter, WP backlink text setting
1486 * @param string $text
1487 * @param int $simple_html
1489 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1491 public static function convertForUriId(int $uriid = null, string $text = null, int $simple_html = self::INTERNAL): string
1493 $try_oembed = ($simple_html == self::INTERNAL);
1495 return self::convert($text ?? '', $try_oembed, $simple_html, false, $uriid ?? 0);
1499 * Converts a BBCode message to HTML message
1501 * BBcode 2 HTML was written by WAY2WEB.net
1502 * extended to work with Mistpark/Friendica - Mike Macgirvin
1504 * Simple HTML values meaning:
1505 * - 0: Friendica display
1507 * - 2: Used for Windows Phone push, Friendica API
1508 * - 3: Used before converting to Markdown in bb2diaspora.php
1509 * - 4: Used for WordPress, Libertree (before Markdown), pump.io and tumblr
1512 * - 7: Used for dfrn, OStatus
1513 * - 8: Used for Twitter, WP backlink text setting
1516 * @param string $text
1517 * @param bool $try_oembed
1518 * @param int $simple_html
1519 * @param bool $for_plaintext
1521 * @return string Converted code or empty string
1522 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1524 public static function convert(string $text = null, bool $try_oembed = true, int $simple_html = self::INTERNAL, bool $for_plaintext = false, int $uriid = 0): string
1526 // Accounting for null default column values
1527 if (is_null($text) || $text === '') {
1531 DI::profiler()->startRecording('rendering');
1533 Hook::callAll('bbcode', $text);
1537 $text = self::performWithEscapedTags($text, ['code'], function ($text) use ($try_oembed, $simple_html, $for_plaintext, $a, $uriid) {
1538 $text = self::performWithEscapedTags($text, ['noparse', 'nobb', 'pre'], function ($text) use ($try_oembed, $simple_html, $for_plaintext, $a, $uriid) {
1540 * preg_match_callback function to replace potential Oembed tags with Oembed content
1542 * $match[0] = [tag]$url[/tag] or [tag=$url]$title[/tag]
1544 * $match[2] = $title or absent
1546 $try_oembed_callback = function (array $match)
1549 $title = $match[2] ?? '';
1552 $return = OEmbed::getHTML($url, $title);
1553 } catch (Exception $ex) {
1554 $return = $match[0];
1560 // Remove the abstract element. It is a non visible element.
1561 $text = self::stripAbstract($text);
1563 // Line ending normalisation
1564 $text = str_replace("\r\n", "\n", $text);
1566 // Move new lines outside of tags
1567 $text = preg_replace("#\[(\w*)](\n*)#ism", '$2[$1]', $text);
1568 $text = preg_replace("#(\n*)\[/(\w*)]#ism", '[/$2]$1', $text);
1570 // Extract the private images which use data urls since preg has issues with
1571 // large data sizes. Stash them away while we do bbcode conversion, and then put them back
1572 // in after we've done all the regex matching. We cannot use any preg functions to do this.
1574 $extracted = self::extractImagesFromItemBody($text);
1575 $text = $extracted['body'];
1576 $saved_image = $extracted['images'];
1578 // If we find any event code, turn it into an event.
1579 // After we're finished processing the bbcode we'll
1580 // replace all of the event code with a reformatted version.
1582 $ev = Event::fromBBCode($text);
1584 // Replace any html brackets with HTML Entities to prevent executing HTML or script
1585 // Don't use strip_tags here because it breaks [url] search by replacing & with amp
1587 $text = str_replace("<", "<", $text);
1588 $text = str_replace(">", ">", $text);
1590 // remove some newlines before the general conversion
1591 $text = preg_replace("/\s?\[share(.*?)\]\s?(.*?)\s?\[\/share\]\s?/ism", "[share$1]$2[/share]", $text);
1592 $text = preg_replace("/\s?\[quote(.*?)\]\s?(.*?)\s?\[\/quote\]\s?/ism", "[quote$1]$2[/quote]", $text);
1594 // when the content is meant exporting to other systems then remove the avatar picture since this doesn't really look good on these systems
1596 $text = preg_replace("/\[share(.*?)avatar\s?=\s?'.*?'\s?(.*?)\]\s?(.*?)\s?\[\/share\]\s?/ism", "\n[share$1$2]$3[/share]", $text);
1599 // Remove linefeeds inside of the table elements. See issue #6799
1600 $search = ["\n[th]", "[th]\n", " [th]", "\n[/th]", "[/th]\n", "[/th] ",
1601 "\n[td]", "[td]\n", " [td]", "\n[/td]", "[/td]\n", "[/td] ",
1602 "\n[tr]", "[tr]\n", " [tr]", "[tr] ", "\n[/tr]", "[/tr]\n", " [/tr]", "[/tr] ",
1603 "\n[hr]", "[hr]\n", " [hr]", "[hr] ",
1604 "\n[attachment ", " [attachment ", "\n[/attachment]", "[/attachment]\n", " [/attachment]", "[/attachment] ",
1605 "[table]\n", "[table] ", " [table]", "\n[/table]", " [/table]", "[/table] "];
1606 $replace = ["[th]", "[th]", "[th]", "[/th]", "[/th]", "[/th]",
1607 "[td]", "[td]", "[td]", "[/td]", "[/td]", "[/td]",
1608 "[tr]", "[tr]", "[tr]", "[tr]", "[/tr]", "[/tr]", "[/tr]", "[/tr]",
1609 "[hr]", "[hr]", "[hr]", "[hr]",
1610 "[attachment ", "[attachment ", "[/attachment]", "[/attachment]", "[/attachment]", "[/attachment]",
1611 "[table]", "[table]", "[table]", "[/table]", "[/table]", "[/table]"];
1614 $text = str_replace($search, $replace, $text);
1615 } while ($oldtext != $text);
1617 // Replace these here only once
1618 $search = ["\n[table]", "[/table]\n"];
1619 $replace = ["[table]", "[/table]"];
1620 $text = str_replace($search, $replace, $text);
1622 // Trim new lines regardless of the system.remove_multiplicated_lines config value
1623 $text = trim($text, "\n");
1625 // removing multiplicated newlines
1626 if (DI::config()->get('system', 'remove_multiplicated_lines')) {
1627 $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",
1628 "\n[h1]", "[/h1]\n", "\n[h2]", "[/h2]\n", "\n[h3]", "[/h3]\n", "\n[h4]", "[/h4]\n", "\n[h5]", "[/h5]\n", "\n[h6]", "[/h6]\n"];
1629 $replace = ["\n\n", "\n", "\n", "[/quote]\n", "[/quote]", "[/li]", "[li]", "[*]", "[ul]", "[/ul]", "\n[share ", "[/attachment]",
1630 "[h1]", "[/h1]", "[h2]", "[/h2]", "[h3]", "[/h3]", "[h4]", "[/h4]", "[h5]", "[/h5]", "[h6]", "[/h6]"];
1633 $text = str_replace($search, $replace, $text);
1634 } while ($oldtext != $text);
1637 /// @todo Have a closer look at the different html modes
1638 // Handle attached links or videos
1639 if (in_array($simple_html, [self::MASTODON_API, self::TWITTER_API, self::ACTIVITYPUB])) {
1640 $text = self::removeAttachment($text);
1641 } elseif (!in_array($simple_html, [self::INTERNAL, self::EXTERNAL, self::CONNECTORS])) {
1642 $text = self::removeAttachment($text, true);
1644 $text = self::convertAttachment($text, $simple_html, $try_oembed, [], $uriid);
1647 $nosmile = strpos($text, '[nosmile]') !== false;
1648 $text = str_replace('[nosmile]', '', $text);
1650 // Replace non graphical smilies for external posts
1652 $text = self::performWithEscapedTags($text, ['img'], function ($text) use ($simple_html, $for_plaintext) {
1653 return Smilies::replace($text, ($simple_html != self::INTERNAL) || $for_plaintext);
1657 // leave open the posibility of [map=something]
1658 // this is replaced in Item::prepareBody() which has knowledge of the item location
1659 if (strpos($text, '[/map]') !== false) {
1660 $text = preg_replace_callback(
1661 "/\[map\](.*?)\[\/map\]/ism",
1662 function ($match) use ($simple_html) {
1663 return str_replace($match[0], '<p class="map">' . Map::byLocation($match[1], $simple_html) . '</p>', $match[0]);
1669 if (strpos($text, '[map=') !== false) {
1670 $text = preg_replace_callback(
1671 "/\[map=(.*?)\]/ism",
1672 function ($match) use ($simple_html) {
1673 return str_replace($match[0], '<p class="map">' . Map::byCoordinates(str_replace('/', ' ', $match[1]), $simple_html) . '</p>', $match[0]);
1679 if (strpos($text, '[map]') !== false) {
1680 $text = preg_replace("/\[map\]/", '<p class="map"></p>', $text);
1683 // Check for headers
1684 $text = preg_replace("(\[h1\](.*?)\[\/h1\])ism", '<h1>$1</h1>', $text);
1685 $text = preg_replace("(\[h2\](.*?)\[\/h2\])ism", '<h2>$1</h2>', $text);
1686 $text = preg_replace("(\[h3\](.*?)\[\/h3\])ism", '<h3>$1</h3>', $text);
1687 $text = preg_replace("(\[h4\](.*?)\[\/h4\])ism", '<h4>$1</h4>', $text);
1688 $text = preg_replace("(\[h5\](.*?)\[\/h5\])ism", '<h5>$1</h5>', $text);
1689 $text = preg_replace("(\[h6\](.*?)\[\/h6\])ism", '<h6>$1</h6>', $text);
1691 // Check for paragraph
1692 $text = preg_replace("(\[p\](.*?)\[\/p\])ism", '<p>$1</p>', $text);
1694 // Check for bold text
1695 $text = preg_replace("(\[b\](.*?)\[\/b\])ism", '<strong>$1</strong>', $text);
1697 // Check for Italics text
1698 $text = preg_replace("(\[i\](.*?)\[\/i\])ism", '<em>$1</em>', $text);
1700 // Check for Underline text
1701 $text = preg_replace("(\[u\](.*?)\[\/u\])ism", '<u>$1</u>', $text);
1703 // Check for strike-through text
1704 $text = preg_replace("(\[s\](.*?)\[\/s\])ism", '<s>$1</s>', $text);
1706 // Check for over-line text
1707 $text = preg_replace("(\[o\](.*?)\[\/o\])ism", '<span class="overline">$1</span>', $text);
1709 // Check for colored text
1710 $text = preg_replace("(\[color=(.*?)\](.*?)\[\/color\])ism", "<span style=\"color: $1;\">$2</span>", $text);
1712 // Check for sized text
1713 // [size=50] --> font-size: 50px (with the unit).
1714 if ($simple_html != self::DIASPORA) {
1715 $text = preg_replace("(\[size=(\d*?)\](.*?)\[\/size\])ism", '<span style="font-size:$1px;line-height:normal;">$2</span>', $text);
1716 $text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])ism", '<span style="font-size:$1;line-height:normal;">$2</span>', $text);
1718 // Issue 2199: Diaspora doesn't interpret the construct above, nor the <small> or <big> element
1719 $text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])ism", "$2", $text);
1723 // Check for centered text
1724 $text = preg_replace("(\[center\](.*?)\[\/center\])ism", '<div style="text-align:center;">$1</div>', $text);
1726 // Check for list text
1727 $text = str_replace("[*]", "<li>", $text);
1729 // Check for block-level custom CSS
1730 $text = preg_replace('#(?<=^|\n)\[style=(.*?)](.*?)\[/style](?:\n|$)#ism', '<div style="$1">$2</div>', $text);
1732 // Check for inline custom CSS
1733 $text = preg_replace("(\[style=(.*?)\](.*?)\[\/style\])ism", '<span style="$1">$2</span>', $text);
1735 // Mastodon Emoji (internal tag, do not document for users)
1736 $text = preg_replace("(\[emoji=(.*?)](.*?)\[/emoji])ism", '<span class="mastodon emoji"><img src="$1" alt="$2" title="$2"/></span>', $text);
1738 // Check for CSS classes
1739 // @deprecated since 2021.12, left for backward-compatibility reasons
1740 $text = preg_replace("(\[class=(.*?)\](.*?)\[\/class\])ism", '<span class="$1">$2</span>', $text);
1741 // Add HTML new lines
1742 $text = str_replace("\n", '<br>', $text);
1744 // handle nested lists
1747 while ((((strpos($text, "[/list]") !== false) && (strpos($text, "[list") !== false)) ||
1748 ((strpos($text, "[/ol]") !== false) && (strpos($text, "[ol]") !== false)) ||
1749 ((strpos($text, "[/ul]") !== false) && (strpos($text, "[ul]") !== false)) ||
1750 ((strpos($text, "[/li]") !== false) && (strpos($text, "[li]") !== false))) && (++$endlessloop < 20)) {
1751 $text = preg_replace("/\[list\](.*?)\[\/list\]/ism", '<ul class="listbullet" style="list-style-type: circle;">$1</ul>', $text);
1752 $text = preg_replace("/\[list=\](.*?)\[\/list\]/ism", '<ul class="listnone" style="list-style-type: none;">$1</ul>', $text);
1753 $text = preg_replace("/\[list=1\](.*?)\[\/list\]/ism", '<ul class="listdecimal" style="list-style-type: decimal;">$1</ul>', $text);
1754 $text = preg_replace("/\[list=((?-i)i)\](.*?)\[\/list\]/ism", '<ul class="listlowerroman" style="list-style-type: lower-roman;">$2</ul>', $text);
1755 $text = preg_replace("/\[list=((?-i)I)\](.*?)\[\/list\]/ism", '<ul class="listupperroman" style="list-style-type: upper-roman;">$2</ul>', $text);
1756 $text = preg_replace("/\[list=((?-i)a)\](.*?)\[\/list\]/ism", '<ul class="listloweralpha" style="list-style-type: lower-alpha;">$2</ul>', $text);
1757 $text = preg_replace("/\[list=((?-i)A)\](.*?)\[\/list\]/ism", '<ul class="listupperalpha" style="list-style-type: upper-alpha;">$2</ul>', $text);
1758 $text = preg_replace("/\[ul\](.*?)\[\/ul\]/ism", '<ul class="listbullet" style="list-style-type: circle;">$1</ul>', $text);
1759 $text = preg_replace("/\[ol\](.*?)\[\/ol\]/ism", '<ul class="listdecimal" style="list-style-type: decimal;">$1</ul>', $text);
1760 $text = preg_replace("/\[li\](.*?)\[\/li\]/ism", '<li>$1</li>', $text);
1763 $text = preg_replace("/\[th\](.*?)\[\/th\]/sm", '<th>$1</th>', $text);
1764 $text = preg_replace("/\[td\](.*?)\[\/td\]/sm", '<td>$1</td>', $text);
1765 $text = preg_replace("/\[tr\](.*?)\[\/tr\]/sm", '<tr>$1</tr>', $text);
1766 $text = preg_replace("/\[table\](.*?)\[\/table\]/sm", '<table>$1</table>', $text);
1768 $text = preg_replace("/\[table border=1\](.*?)\[\/table\]/sm", '<table border="1" >$1</table>', $text);
1769 $text = preg_replace("/\[table border=0\](.*?)\[\/table\]/sm", '<table border="0" >$1</table>', $text);
1771 $text = str_replace('[hr]', '<hr />', $text);
1773 if (!$for_plaintext) {
1774 $text = self::performWithEscapedTags($text, ['url', 'img', 'audio', 'video', 'youtube', 'vimeo', 'share', 'attachment', 'iframe', 'bookmark'], function ($text) {
1775 return preg_replace(Strings::autoLinkRegEx(), '[url]$1[/url]', $text);
1779 // Check for font change text
1780 $text = preg_replace("/\[font=(.*?)\](.*?)\[\/font\]/sm", "<span style=\"font-family: $1;\">$2</span>", $text);
1782 // Declare the format for [spoiler] layout
1783 $SpoilerLayout = '<details class="spoiler"><summary>' . DI::l10n()->t('Click to open/close') . '</summary>$1</details>';
1785 // Check for [spoiler] text
1786 // handle nested quotes
1788 while ((strpos($text, "[/spoiler]") !== false) && (strpos($text, "[spoiler]") !== false) && (++$endlessloop < 20)) {
1789 $text = preg_replace("/\[spoiler\](.*?)\[\/spoiler\]/ism", $SpoilerLayout, $text);
1792 // Check for [spoiler=Title] text
1794 // handle nested quotes
1796 while ((strpos($text, "[/spoiler]")!== false) && (strpos($text, "[spoiler=") !== false) && (++$endlessloop < 20)) {
1797 $text = preg_replace("/\[spoiler=[\"\']*(.*?)[\"\']*\](.*?)\[\/spoiler\]/ism",
1798 '<details class="spoiler"><summary>$1</summary>$2</details>',
1802 // Declare the format for [quote] layout
1803 $QuoteLayout = '<blockquote>$1</blockquote>';
1805 // Check for [quote] text
1806 // handle nested quotes
1808 while ((strpos($text, "[/quote]") !== false) && (strpos($text, "[quote]") !== false) && (++$endlessloop < 20)) {
1809 $text = preg_replace("/\[quote\](.*?)\[\/quote\]/ism", "$QuoteLayout", $text);
1812 // Check for [quote=Author] text
1814 $t_wrote = DI::l10n()->t('$1 wrote:');
1816 // handle nested quotes
1818 while ((strpos($text, "[/quote]")!== false) && (strpos($text, "[quote=") !== false) && (++$endlessloop < 20)) {
1819 $text = preg_replace("/\[quote=[\"\']*(.*?)[\"\']*\](.*?)\[\/quote\]/ism",
1820 "<p><strong class=".'"author"'.">" . $t_wrote . "</strong></p><blockquote>$2</blockquote>",
1825 // [img=widthxheight]image source[/img]
1826 $text = preg_replace_callback(
1827 "/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism",
1828 function ($matches) use ($simple_html, $uriid) {
1829 if (strpos($matches[3], "data:image/") === 0) {
1833 $matches[3] = self::proxyUrl($matches[3], $simple_html, $uriid);
1834 return "[img=" . $matches[1] . "x" . $matches[2] . "]" . $matches[3] . "[/img]";
1839 $text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '<img src="$3" style="width: $1px;" >', $text);
1840 $text = preg_replace("/\[zmg\=([0-9]*)x([0-9]*)\](.*?)\[\/zmg\]/ism", '<img class="zrl" src="$3" style="width: $1px;" >', $text);
1842 $text = preg_replace_callback("/\[img\=(.*?)\](.*?)\[\/img\]/ism",
1843 function ($matches) use ($simple_html, $uriid) {
1844 $matches[1] = self::proxyUrl($matches[1], $simple_html, $uriid);
1845 $matches[2] = htmlspecialchars($matches[2], ENT_COMPAT);
1846 return '<img src="' . $matches[1] . '" alt="' . $matches[2] . '" title="' . $matches[2] . '">';
1851 // [img]pathtoimage[/img]
1852 $text = preg_replace_callback(
1853 "/\[img\](.*?)\[\/img\]/ism",
1854 function ($matches) use ($simple_html, $uriid) {
1855 if (strpos($matches[1], "data:image/") === 0) {
1859 $matches[1] = self::proxyUrl($matches[1], $simple_html, $uriid);
1860 return "[img]" . $matches[1] . "[/img]";
1865 $text = preg_replace("/\[img\](.*?)\[\/img\]/ism", '<img src="$1" alt="' . DI::l10n()->t('Image/photo') . '" />', $text);
1866 $text = preg_replace("/\[zmg\](.*?)\[\/zmg\]/ism", '<img src="$1" alt="' . DI::l10n()->t('Image/photo') . '" />', $text);
1868 $text = self::convertImages($text, $simple_html, $uriid);
1870 $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);
1871 $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);
1872 //$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);
1874 // Simplify "video" element
1875 $text = preg_replace('(\[video[^\]]*?\ssrc\s?=\s?([^\s\]]+)[^\]]*?\].*?\[/video\])ism', '[video]$1[/video]', $text);
1878 // html5 video and audio
1879 $text = preg_replace("/\[video\](.*?\.(ogg|ogv|oga|ogm|webm|mp4).*?)\[\/video\]/ism",
1880 '<video src="$1" controls width="100%" height="auto"><a href="$1">$1</a></video>', $text);
1882 $text = preg_replace_callback("/\[video\](.*?)\[\/video\]/ism", $try_oembed_callback, $text);
1883 $text = preg_replace_callback("/\[audio\](.*?)\[\/audio\]/ism", $try_oembed_callback, $text);
1885 $text = preg_replace("/\[video\](.*?)\[\/video\]/ism",
1886 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1887 $text = preg_replace("/\[audio\](.*?)\[\/audio\]/ism", '<audio src="$1" controls><a href="$1">$1</a></audio>', $text);
1889 $text = preg_replace("/\[video\](.*?)\[\/video\]/ism",
1890 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1891 $text = preg_replace("/\[audio\](.*?)\[\/audio\]/ism",
1892 '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
1895 // Backward compatibility, [iframe] support has been removed in version 2020.12
1896 $text = preg_replace("/\[iframe\](.*?)\[\/iframe\]/ism", '<a href="$1">$1</a>', $text);
1898 // Youtube extensions
1900 $text = preg_replace_callback("/\[youtube\](https?:\/\/www.youtube.com\/watch\?v\=.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1901 $text = preg_replace_callback("/\[youtube\](www.youtube.com\/watch\?v\=.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1902 $text = preg_replace_callback("/\[youtube\](https?:\/\/www.youtube.com\/shorts\/.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1903 $text = preg_replace_callback("/\[youtube\](https?:\/\/youtu.be\/.*?)\[\/youtube\]/ism", $try_oembed_callback, $text);
1906 $text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/watch\?v\=(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1907 $text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/embed\/(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1908 $text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/shorts\/(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1909 $text = preg_replace("/\[youtube\]https?:\/\/youtu.be\/(.*?)\[\/youtube\]/ism", '[youtube]$1[/youtube]', $text);
1912 $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);
1914 $text = preg_replace("/\[youtube\]([A-Za-z0-9\-_=]+)(.*?)\[\/youtube\]/ism",
1915 '<a href="https://www.youtube.com/watch?v=$1" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=$1</a>', $text);
1919 $text = preg_replace_callback("/\[vimeo\](https?:\/\/player.vimeo.com\/video\/[0-9]+).*?\[\/vimeo\]/ism", $try_oembed_callback, $text);
1920 $text = preg_replace_callback("/\[vimeo\](https?:\/\/vimeo.com\/[0-9]+).*?\[\/vimeo\]/ism", $try_oembed_callback, $text);
1923 $text = preg_replace("/\[vimeo\]https?:\/\/player.vimeo.com\/video\/([0-9]+)(.*?)\[\/vimeo\]/ism", '[vimeo]$1[/vimeo]', $text);
1924 $text = preg_replace("/\[vimeo\]https?:\/\/vimeo.com\/([0-9]+)(.*?)\[\/vimeo\]/ism", '[vimeo]$1[/vimeo]', $text);
1927 $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);
1929 $text = preg_replace("/\[vimeo\]([0-9]+)(.*?)\[\/vimeo\]/ism",
1930 '<a href="https://vimeo.com/$1" target="_blank" rel="noopener noreferrer">https://vimeo.com/$1</a>', $text);
1934 $text = OEmbed::BBCode2HTML($text);
1936 // Avoid triple linefeeds through oembed
1937 $text = str_replace("<br style='clear:left'></span><br><br>", "<br style='clear:left'></span><br>", $text);
1939 // If we found an event earlier, strip out all the event code and replace with a reformatted version.
1940 // Replace the event-start section with the entire formatted event. The other bbcode is stripped.
1941 // Summary (e.g. title) is required, earlier revisions only required description (in addition to
1942 // start which is always required). Allow desc with a missing summary for compatibility.
1944 if ((!empty($ev['desc']) || !empty($ev['summary'])) && !empty($ev['start'])) {
1945 $sub = Event::getHTML($ev, $simple_html, $uriid);
1947 $text = preg_replace("/\[event\-summary\](.*?)\[\/event\-summary\]/ism", '', $text);
1948 $text = preg_replace("/\[event\-description\](.*?)\[\/event\-description\]/ism", '', $text);
1949 $text = preg_replace("/\[event\-start\](.*?)\[\/event\-start\]/ism", $sub, $text);
1950 $text = preg_replace("/\[event\-finish\](.*?)\[\/event\-finish\]/ism", '', $text);
1951 $text = preg_replace("/\[event\-location\](.*?)\[\/event\-location\]/ism", '', $text);
1952 $text = preg_replace("/\[event\-id\](.*?)\[\/event\-id\]/ism", '', $text);
1955 if (!$for_plaintext && DI::config()->get('system', 'big_emojis') && ($simple_html != self::DIASPORA)) {
1956 $conv = html_entity_decode(str_replace([' ', "\n", "\r"], '', $text));
1957 // Emojis are always 4 byte Unicode characters
1958 if (!empty($conv) && (strlen($conv) / mb_strlen($conv) == 4)) {
1959 $text = '<span style="font-size: xx-large; line-height: normal;">' . $text . '</span>';
1963 // Handle mentions and hashtag links
1964 if ($simple_html == self::DIASPORA) {
1965 // The ! is converted to @ since Diaspora only understands the @
1966 $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1967 '@<a href="$2">$3</a>',
1969 } elseif (in_array($simple_html, [self::OSTATUS, self::ACTIVITYPUB])) {
1970 $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1971 '<span class="h-card"><a href="$2" class="u-url mention">$1<span>$3</span></a></span>',
1973 $text = preg_replace("/([#])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1974 '<a href="$2" class="mention hashtag" rel="tag">$1<span>$3</span></a>',
1976 } elseif (in_array($simple_html, [self::INTERNAL, self::EXTERNAL, self::TWITTER_API])) {
1977 $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1978 '<bdi>$1<a href="$2" class="userinfo mention" title="$3">$3</a></bdi>',
1980 } elseif ($simple_html == self::MASTODON_API) {
1981 $text = preg_replace("/([@!])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1982 '<a class="u-url mention status-link" href="$2" rel="nofollow noopener noreferrer" target="_blank" title="$3">$1<span>$3</span></a>',
1984 $text = preg_replace("/([#])\[url\=(.*?)\](.*?)\[\/url\]/ism",
1985 '<a class="mention hashtag status-link" href="$2" rel="tag">$1<span>$3</span></a>',
1988 $text = preg_replace("/([#@!])\[url\=(.*?)\](.*?)\[\/url\]/ism", '$1$3', $text);
1991 if (!$for_plaintext) {
1992 if (in_array($simple_html, [self::OSTATUS, self::MASTODON_API, self::TWITTER_API, self::ACTIVITYPUB])) {
1993 $text = preg_replace_callback("/\[url\](.*?)\[\/url\]/ism", 'self::convertUrlForActivityPubCallback', $text);
1994 $text = preg_replace_callback("/\[url\=(.*?)\](.*?)\[\/url\]/ism", 'self::convertUrlForActivityPubCallback', $text);
1997 $text = preg_replace("(\[url\](.*?)\[\/url\])ism", " $1 ", $text);
1998 $text = preg_replace_callback("&\[url=([^\[\]]*)\]\[img\](.*)\[\/img\]\[\/url\]&Usi", 'self::removePictureLinksCallback', $text);
2001 // Bookmarks in red - will be converted to bookmarks in friendica
2002 $text = preg_replace("/#\^\[url\](.*?)\[\/url\]/ism", '[bookmark=$1]$1[/bookmark]', $text);
2003 $text = preg_replace("/#\^\[url\=(.*?)\](.*?)\[\/url\]/ism", '[bookmark=$1]$2[/bookmark]', $text);
2004 $text = preg_replace("/#\[url\=.*?\]\^\[\/url\]\[url\=(.*?)\](.*?)\[\/url\]/i",
2005 "[bookmark=$1]$2[/bookmark]", $text);
2007 if (in_array($simple_html, [self::OSTATUS, self::TWITTER])) {
2008 $text = preg_replace_callback("/([^#@!])\[url\=([^\]]*)\](.*?)\[\/url\]/ism", "self::expandLinksCallback", $text);
2009 //$text = preg_replace("/[^#@!]\[url\=([^\]]*)\](.*?)\[\/url\]/ism", ' $2 [url]$1[/url]', $text);
2010 $text = preg_replace("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", ' $2 [url]$1[/url]', $text);
2013 // Perform URL Search
2015 $text = preg_replace_callback("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", $try_oembed_callback, $text);
2018 $text = preg_replace("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", '[url=$1]$2[/url]', $text);
2020 // Handle Diaspora posts
2021 $text = preg_replace_callback(
2022 "&\[url=/?posts/([^\[\]]*)\](.*)\[\/url\]&Usi",
2024 return "[url=" . DI::baseUrl() . "/display/" . $match[1] . "]" . $match[2] . "[/url]";
2028 $text = preg_replace_callback(
2029 "&\[url=/people\?q\=(.*)\](.*)\[\/url\]&Usi",
2031 return "[url=" . DI::baseUrl() . "/search?search=%40" . $match[1] . "]" . $match[2] . "[/url]";
2035 // Server independent link to posts and comments
2036 // See issue: https://github.com/diaspora/diaspora_federation/issues/75
2037 $expression = "=diaspora://.*?/post/([0-9A-Za-z\-_@.:]{15,254}[0-9A-Za-z])=ism";
2038 $text = preg_replace($expression, DI::baseUrl()."/display/$1", $text);
2042 * - #[url=<anything>]<term>[/url]
2043 * - [url=<anything>]#<term>[/url]
2045 self::performWithEscapedTags($text, ['url', 'share'], function ($text) use ($simple_html) {
2046 $text = preg_replace_callback("/(?:#\[url\=[^\[\]]*\]|\[url\=[^\[\]]*\]#)(.*?)\[\/url\]/ism", function($matches) use ($simple_html) {
2047 if ($simple_html == self::ACTIVITYPUB) {
2048 return '<a href="' . DI::baseUrl() . '/search?tag=' . rawurlencode($matches[1])
2049 . '" data-tag="' . XML::escape($matches[1]) . '" rel="tag ugc">#'
2050 . XML::escape($matches[1]) . '</a>';
2052 return '#<a href="' . DI::baseUrl() . '/search?tag=' . rawurlencode($matches[1])
2053 . '" class="tag" rel="tag" title="' . XML::escape($matches[1]) . '">'
2054 . XML::escape($matches[1]) . '</a>';
2060 // We need no target="_blank" rel="noopener noreferrer" for local links
2061 // convert links start with DI::baseUrl() as local link without the target="_blank" rel="noopener noreferrer" attribute
2062 $escapedBaseUrl = preg_quote(DI::baseUrl(), '/');
2063 $text = preg_replace("/\[url\](".$escapedBaseUrl.".*?)\[\/url\]/ism", '<a href="$1">$1</a>', $text);
2064 $text = preg_replace("/\[url\=(".$escapedBaseUrl.".*?)\](.*?)\[\/url\]/ism", '<a href="$1">$2</a>', $text);
2066 $text = preg_replace("/\[url\](.*?)\[\/url\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>', $text);
2067 $text = preg_replace("/\[url\=(.*?)\](.*?)\[\/url\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$2</a>', $text);
2069 // Red compatibility, though the link can't be authenticated on Friendica
2070 $text = preg_replace("/\[zrl\=(.*?)\](.*?)\[\/zrl\]/ism", '<a href="$1" target="_blank" rel="noopener noreferrer">$2</a>', $text);
2073 // we may need to restrict this further if it picks up too many strays
2074 // link acct:user@host to a webfinger profile redirector
2076 $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);
2078 // Perform MAIL Search
2079 $text = preg_replace("/\[mail\](.*?)\[\/mail\]/", '<a href="mailto:$1">$1</a>', $text);
2080 $text = preg_replace("/\[mail\=(.*?)\](.*?)\[\/mail\]/", '<a href="mailto:$1">$2</a>', $text);
2082 /// @todo What is the meaning of these lines?
2083 $text = preg_replace('/\[\&\;([#a-z0-9]+)\;\]/', '&$1;', $text);
2084 $text = preg_replace('/\&\#039\;/', '\'', $text);
2086 // Currently deactivated, it made problems with " inside of alt texts.
2087 //$text = preg_replace('/\"\;/', '"', $text);
2089 // fix any escaped ampersands that may have been converted into links
2090 $text = preg_replace('/\<([^>]*?)(src|href)=(.*?)\&\;(.*?)\>/ism', '<$1$2=$3&$4>', $text);
2092 // sanitizes src attributes (http and redir URLs for displaying in a web page, cid used for inline images in emails)
2093 $allowed_src_protocols = ['//', 'http://', 'https://', 'redir/', 'cid:'];
2095 array_walk($allowed_src_protocols, function(&$value) { $value = preg_quote($value, '#');});
2097 $text = preg_replace('#<([^>]*?)(src)="(?!' . implode('|', $allowed_src_protocols) . ')(.*?)"(.*?)>#ism',
2098 '<$1$2=""$4 data-original-src="$3" class="invalid-src" title="' . DI::l10n()->t('Invalid source protocol') . '">', $text);
2100 // sanitize href attributes (only allowlisted protocols URLs)
2101 // default value for backward compatibility
2102 $allowed_link_protocols = DI::config()->get('system', 'allowed_link_protocols', []);
2104 // Always allowed protocol even if config isn't set or not including it
2105 $allowed_link_protocols[] = '//';
2106 $allowed_link_protocols[] = 'http://';
2107 $allowed_link_protocols[] = 'https://';
2108 $allowed_link_protocols[] = 'redir/';
2110 array_walk($allowed_link_protocols, function(&$value) { $value = preg_quote($value, '#');});
2112 $regex = '#<([^>]*?)(href)="(?!' . implode('|', $allowed_link_protocols) . ')(.*?)"(.*?)>#ism';
2113 $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);
2116 $text = self::convertShare(
2118 function (array $attributes, array $author_contact, $content, $is_quote_share) use ($simple_html) {
2119 return self::convertShareCallback($attributes, $author_contact, $content, $is_quote_share, $simple_html);
2123 $text = self::interpolateSavedImagesIntoItemBody($uriid, $text, $saved_image);
2126 }); // Escaped noparse, nobb, pre
2128 // Remove escaping tags and replace new lines that remain
2129 $text = preg_replace_callback('/\[(noparse|nobb)](.*?)\[\/\1]/ism', function ($match) {
2130 return str_replace("\n", "<br>", $match[2]);
2133 // Additionally, [pre] tags preserve spaces
2134 $text = preg_replace_callback("/\[pre\](.*?)\[\/pre\]/ism", function ($match) {
2135 return str_replace([' ', "\n"], [' ', "<br>"], htmlentities($match[1], ENT_NOQUOTES,'UTF-8'));
2141 $text = preg_replace_callback("#\[code(?:=([^\]]*))?\](.*?)\[\/code\]#ism",
2142 function ($matches) {
2143 if (strpos($matches[2], "\n") !== false) {
2144 $return = '<pre><code class="language-' . trim($matches[1]) . '">' . htmlentities(trim($matches[2], "\n\r"), ENT_NOQUOTES, 'UTF-8') . '</code></pre>';
2146 $return = '<code>' . htmlentities($matches[2], ENT_NOQUOTES, 'UTF-8') . '</code>';
2154 // Default iframe allowed domains/path
2155 $allowedIframeDomains = [
2156 DI::baseUrl()->getHostname()
2157 . (DI::baseUrl()->getUrlPath() ? '/' . DI::baseUrl()->getUrlPath() : '')
2158 . '/oembed/', # The path part has to change with the source in Content\Oembed::iframe
2159 'www.youtube.com/embed/',
2160 'player.vimeo.com/video/',
2163 $allowedIframeDomains = array_merge(
2164 $allowedIframeDomains,
2165 DI::config()->get('system', 'allowed_oembed') ?
2166 explode(',', DI::config()->get('system', 'allowed_oembed'))
2170 $text = HTML::purify($text, $allowedIframeDomains);
2171 DI::profiler()->stopRecording();
2177 * Strips the "abstract" tag from the provided text
2179 * @param string $text The text with BBCode
2180 * @return string The same text - but without "abstract" element
2182 public static function stripAbstract(string $text): string
2184 DI::profiler()->startRecording('rendering');
2186 $text = BBCode::performWithEscapedTags($text, ['code', 'noparse', 'nobb', 'pre'], function ($text) {
2187 $text = preg_replace("/[\s|\n]*\[abstract\].*?\[\/abstract\][\s|\n]*/ism", ' ', $text);
2188 $text = preg_replace("/[\s|\n]*\[abstract=.*?\].*?\[\/abstract][\s|\n]*/ism", ' ', $text);
2192 DI::profiler()->stopRecording();
2197 * Returns the value of the "abstract" element
2199 * @param string $text The text that maybe contains the element
2200 * @param string $addon The addon for which the abstract is meant for
2201 * @return string The abstract
2203 public static function getAbstract(string $text, string $addon = ''): string
2205 DI::profiler()->startRecording('rendering');
2206 $addon = strtolower($addon);
2208 $abstract = BBCode::performWithEscapedTags($text, ['code', 'noparse', 'nobb', 'pre'], function ($text) use ($addon) {
2209 if ($addon && preg_match('#\[abstract=' . preg_quote($addon, '#') . '](.*?)\[/abstract]#ism', $text, $matches)) {
2213 if (preg_match("#\[abstract](.*?)\[/abstract]#ism", $text, $matches)) {
2220 DI::profiler()->stopRecording();
2225 * Callback function to replace a Friendica style mention in a mention for Diaspora
2227 * @param array $match Matching values for the callback
2228 * [1] = Mention type (! or @)
2231 * @return string Replaced mention
2232 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2233 * @throws \ImagickException
2235 private static function bbCodeMention2DiasporaCallback(array $match): string
2237 $contact = Contact::getByURL($match[3], false, ['addr']);
2238 if (empty($contact['addr'])) {
2242 $mention = $match[1] . '{' . $match[2] . '; ' . $contact['addr'] . '}';
2247 * Converts a BBCode text into Markdown
2249 * This function converts a BBCode item body to be sent to Markdown-enabled
2250 * systems like Diaspora and Libertree
2252 * @param string $text
2253 * @param bool $for_diaspora Diaspora requires more changes than Libertree
2255 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2257 public static function toMarkdown(string $text, bool $for_diaspora = true): string
2259 DI::profiler()->startRecording('rendering');
2260 $original_text = $text;
2262 // Since Diaspora is creating a summary for links, this function removes them before posting
2263 if ($for_diaspora) {
2264 $text = self::removeShareInformation($text);
2268 * Transform #tags, strip off the [url] and replace spaces with underscore
2270 $url_search_string = "^\[\]";
2271 $text = preg_replace_callback("/#\[url\=([$url_search_string]*)\](.*?)\[\/url\]/i",
2272 function ($matches) {
2273 return '#' . str_replace(' ', '_', $matches[2]);
2278 // Converting images with size parameters to simple images. Markdown doesn't know it.
2279 $text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $text);
2281 // Convert it to HTML - don't try oembed
2282 if ($for_diaspora) {
2283 $text = self::convert($text, false, self::DIASPORA);
2285 // Add all tags that maybe were removed
2286 if (preg_match_all("/#\[url\=([$url_search_string]*)\](.*?)\[\/url\]/ism", $original_text, $tags)) {
2288 foreach ($tags[2] as $tag) {
2289 $tag = html_entity_decode($tag, ENT_QUOTES, 'UTF-8');
2290 if (!strpos(html_entity_decode($text, ENT_QUOTES, 'UTF-8'), '#' . $tag)) {
2291 $tagline .= '#' . $tag . ' ';
2294 $text = $text . ' ' . $tagline;
2297 $text = self::convert($text, false, self::CONNECTORS);
2300 // If a link is followed by a quote then there should be a newline before it
2301 // Maybe we should make this newline at every time before a quote.
2302 $text = str_replace(['</a><blockquote>'], ['</a><br><blockquote>'], $text);
2304 // Now convert HTML to Markdown
2305 $text = HTML::toMarkdown($text);
2307 // Libertree has a problem with escaped hashtags.
2308 $text = str_replace(['\#'], ['#'], $text);
2310 // Remove any leading or trailing whitespace, as this will mess up
2311 // the Diaspora signature verification and cause the item to disappear
2312 $text = trim($text);
2314 if ($for_diaspora) {
2315 $url_search_string = "^\[\]";
2316 $text = preg_replace_callback(
2317 "/([@!])\[(.*?)\]\(([$url_search_string]*?)\)/ism",
2318 ['self', 'bbCodeMention2DiasporaCallback'],
2323 Hook::callAll('bb2diaspora', $text);
2325 DI::profiler()->stopRecording();
2330 * Pull out all #hashtags and @person tags from $string.
2332 * We also get @person@domain.com - which would make
2333 * the regex quite complicated as tags can also
2334 * end a sentence. So we'll run through our results
2335 * and strip the period from any tags which end with one.
2336 * Returns array of tags found, or empty array.
2338 * @param string $string Post content
2339 * @return array List of tag and person names
2341 public static function getTags(string $string): array
2343 DI::profiler()->startRecording('rendering');
2346 self::performWithEscapedTags($string, ['noparse', 'pre', 'code', 'img'], function ($string) use (&$ret) {
2347 // Convert hashtag links to hashtags
2348 $string = preg_replace('/#\[url\=([^\[\]]*)\](.*?)\[\/url\]/ism', '#$2 ', $string);
2350 // Force line feeds at bbtags
2351 $string = str_replace(['[', ']'], ["\n[", "]\n"], $string);
2353 // ignore anything in a bbtag
2354 $string = preg_replace('/\[(.*?)\]/sm', '', $string);
2356 // Match full names against @tags including the space between first and last
2357 // We will look these up afterward to see if they are full names or not recognisable.
2359 if (preg_match_all('/(@[^ \x0D\x0A,:?]+ [^ \x0D\x0A@,:?]+)([ \x0D\x0A@,:?]|$)/', $string, $matches)) {
2360 foreach ($matches[1] as $match) {
2361 if (strstr($match, ']')) {
2362 // we might be inside a bbcode color tag - leave it alone
2366 if (substr($match, -1, 1) === '.') {
2367 $ret[] = substr($match, 0, -1);
2374 // Otherwise pull out single word tags. These can be @nickname, @first_last
2377 if (preg_match_all('/([!#@][^\^ \x0D\x0A,;:?\']*[^\^ \x0D\x0A,;:?!\'.])/', $string, $matches)) {
2378 foreach ($matches[1] as $match) {
2379 if (strstr($match, ']')) {
2380 // we might be inside a bbcode color tag - leave it alone
2384 // try not to catch url fragments
2385 if (strpos($string, $match) && preg_match('/[a-zA-z0-9\/]/', substr($string, strpos($string, $match) - 1, 1))) {
2394 DI::profiler()->stopRecording();
2395 return array_unique($ret);
2399 * Expand tags to URLs, checks the tag is at the start of a line or preceded by a non-word character
2401 * @param string $body HTML/BBCode
2402 * @return string body with expanded tags
2404 public static function expandTags(string $body): string
2406 return preg_replace_callback("/(?<=\W|^)([!#@])([^\^ \x0D\x0A,;:?'\"]*[^\^ \x0D\x0A,;:?!'\".])/",
2407 function (array $match) {
2408 switch ($match[1]) {
2411 $contact = Contact::getByURL($match[2]);
2412 if (!empty($contact)) {
2413 return $match[1] . '[url=' . $contact['url'] . ']' . $contact['name'] . '[/url]';
2415 return $match[1] . $match[2];
2421 return $match[1] . '[url=' . DI::baseUrl() . '/search?tag=' . $match[2] . ']' . $match[2] . '[/url]';
2427 * Perform a custom function on a text after having escaped blocks enclosed in the provided tag list.
2429 * @param string $text HTML/BBCode
2430 * @param array $tagList A list of tag names, e.g ['noparse', 'nobb', 'pre']
2431 * @param callable $callback
2433 * @see Strings::performWithEscapedBlocks
2435 public static function performWithEscapedTags(string $text, array $tagList, callable $callback): string
2437 $tagList = array_map('preg_quote', $tagList);
2439 return Strings::performWithEscapedBlocks($text, '#\[(?:' . implode('|', $tagList) . ').*?\[/(?:' . implode('|', $tagList) . ')]#ism', $callback);
2443 * Replaces mentions in the provided message body in BBCode links for the provided user and network if any
2445 * @param string $body HTML/BBCode
2446 * @param int $profile_uid Profile user id
2447 * @param string $network Network name
2448 * @return string HTML/BBCode with inserted images
2449 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2450 * @throws \ImagickException
2452 public static function setMentions(string $body, $profile_uid = 0, $network = '')
2454 DI::profiler()->startRecording('rendering');
2455 $body = self::performWithEscapedTags($body, ['noparse', 'pre', 'code', 'img'], function ($body) use ($profile_uid, $network) {
2456 $tags = self::getTags($body);
2460 foreach ($tags as $tag) {
2461 $tag_type = substr($tag, 0, 1);
2463 if ($tag_type == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
2468 * If we already tagged 'Robert Johnson', don't try and tag 'Robert'.
2469 * Robert Johnson should be first in the $tags array
2471 foreach ($tagged as $nextTag) {
2472 if (stristr($nextTag, $tag . ' ')) {
2477 if (($success = Item::replaceTag($body, $profile_uid, $tag, $network)) && $success['replaced']) {
2485 DI::profiler()->stopRecording();
2490 * @param string $author Author display name
2491 * @param string $profile Author profile URL
2492 * @param string $avatar Author profile picture URL
2493 * @param string $link Post source URL
2494 * @param string $posted Post created date
2495 * @param string|null $guid Post guid (if any)
2496 * @param string|null $uri Post uri (if any)
2498 * @TODO Rewrite to handle over whole record array
2500 public static function getShareOpeningTag(string $author, string $profile, string $avatar, string $link, string $posted, string $guid = null, string $uri = null): string
2502 DI::profiler()->startRecording('rendering');
2503 $header = "[share author='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $author) .
2504 "' profile='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $profile) .
2505 "' avatar='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $avatar) .
2506 "' link='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $link) .
2507 "' posted='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $posted);
2510 $header .= "' guid='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $guid);
2514 $header .= "' message_id='" . str_replace(["'", "[", "]"], ["'", "[", "]"], $uri);
2519 DI::profiler()->stopRecording();
2524 * Returns the BBCode relevant to embed the provided URL in a post body.
2525 * For media type, it will return [img], [video] and [audio] tags.
2526 * For regular web pages, it will either output a [bookmark] tag if title and description were provided,
2527 * an [attachment] tag or a simple [url] tag depending on $tryAttachment.
2529 * @param string $url
2530 * @param bool $tryAttachment
2531 * @param string|null $title
2532 * @param string|null $description
2533 * @param string|null $tags
2535 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2536 * @see ParseUrl::getSiteinfoCached
2538 public static function embedURL(string $url, bool $tryAttachment = true, string $title = null, string $description = null, string $tags = null): string
2540 DI::profiler()->startRecording('rendering');
2541 DI::logger()->info($url);
2543 // If there is already some content information submitted we don't
2544 // need to parse the url for content.
2545 if (!empty($title) && !empty($description)) {
2546 $title = str_replace(["\r", "\n"], ['', ''], $title);
2548 $description = '[quote]' . trim($description) . '[/quote]' . "\n";
2551 if (!empty($tags)) {
2552 $arr_tags = ParseUrl::convertTagsToArray($tags);
2553 if (count($arr_tags)) {
2554 $str_tags = "\n" . implode(' ', $arr_tags) . "\n";
2558 $result = sprintf('[bookmark=%s]%s[/bookmark]%s', $url, ($title) ? $title : $url, $description) . $str_tags;
2560 DI::logger()->info('(unparsed): returns: ' . $result);
2562 DI::profiler()->stopRecording();
2566 $siteinfo = ParseUrl::getSiteinfoCached($url);
2568 if (in_array($siteinfo['type'], ['image', 'video', 'audio'])) {
2569 switch ($siteinfo['type']) {
2571 $bbcode = "\n" . '[video]' . $url . '[/video]' . "\n";
2574 $bbcode = "\n" . '[audio]' . $url . '[/audio]' . "\n";
2577 $bbcode = "\n" . '[img]' . $url . '[/img]' . "\n";
2581 DI::profiler()->stopRecording();
2585 unset($siteinfo['keywords']);
2587 // Bypass attachment if parse url for a comment
2588 if (!$tryAttachment) {
2589 DI::profiler()->stopRecording();
2590 return "\n" . '[url=' . $url . ']' . $siteinfo['title'] . '[/url]';
2593 // Format it as BBCode attachment
2594 $bbcode = "\n" . PageInfo::getFooterFromData($siteinfo);
2595 DI::profiler()->stopRecording();