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;
24 use Friendica\Content\Text\BBCode;
25 use Friendica\Core\Hook;
26 use Friendica\Core\L10n;
27 use Friendica\Core\Logger;
28 use Friendica\Core\Protocol;
29 use Friendica\Database\DBA;
30 use Friendica\Model\Contact;
31 use Friendica\Model\Group;
32 use Friendica\Model\Item as ModelItem;
33 use Friendica\Model\Photo;
34 use Friendica\Model\Tag;
35 use Friendica\Model\Post;
36 use Friendica\Protocol\Activity;
37 use Friendica\Util\Profiler;
38 use Friendica\Util\Proxy;
39 use Friendica\Util\XML;
42 * A content helper class for displaying items
53 public function __construct(Profiler $profiler, Activity $activity, L10n $l10n)
55 $this->profiler = $profiler;
56 $this->activity = $activity;
61 * Return array with details for categories and folders for an item
65 * @return [array, array]
68 * [ // categories array
70 * 'name': 'category name',
71 * 'removeurl': 'url to remove this category',
72 * 'first': 'is the first in this array? true/false',
73 * 'last': 'is the last in this array? true/false',
79 * 'name': 'folder name',
80 * 'removeurl': 'url to remove this folder',
81 * 'first': 'is the first in this array? true/false',
82 * 'last': 'is the last in this array? true/false',
88 public function determineCategoriesTerms(array $item, int $uid = 0)
94 $uid = $item['uid'] ?: $uid;
96 if (!Post\Category::existsForURIId($item['uri-id'], $uid)) {
97 return [$categories, $folders];
100 foreach (Post\Category::getArrayByURIId($item['uri-id'], $uid, Post\Category::CATEGORY) as $savedFolderName) {
101 if (!empty($item['author-link'])) {
102 $url = $item['author-link'] . "?category=" . rawurlencode($savedFolderName);
107 'name' => $savedFolderName,
109 'removeurl' => local_user() == $uid ? 'filerm/' . $item['id'] . '?cat=' . rawurlencode($savedFolderName) : '',
116 if (count($categories)) {
117 $categories[count($categories) - 1]['last'] = true;
120 if (local_user() == $uid) {
121 foreach (Post\Category::getArrayByURIId($item['uri-id'], $uid, Post\Category::FILE) as $savedFolderName) {
123 'name' => $savedFolderName,
125 'removeurl' => local_user() == $uid ? 'filerm/' . $item['id'] . '?term=' . rawurlencode($savedFolderName) : '',
133 if (count($folders)) {
134 $folders[count($folders) - 1]['last'] = true;
137 return [$categories, $folders];
141 * This function removes the tag $tag from the text $body and replaces it with
142 * the appropriate link.
144 * @param string $body the text to replace the tag in
145 * @param integer $profile_uid the user id to replace the tag for (0 = anyone)
146 * @param string $tag the tag to replace
147 * @param string $network The network of the post
149 * @return array|bool ['replaced' => $replaced, 'contact' => $contact];
150 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
151 * @throws \ImagickException
153 public static function replaceTag(&$body, $profile_uid, $tag, $network = '')
157 //is it a person tag?
158 if (Tag::isType($tag, Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION)) {
159 $tag_type = substr($tag, 0, 1);
160 //is it already replaced?
161 if (strpos($tag, '[url=')) {
165 //get the person's name
166 $name = substr($tag, 1);
168 // Sometimes the tag detection doesn't seem to work right
169 // This is some workaround
170 $nameparts = explode(' ', $name);
171 $name = $nameparts[0];
173 // Try to detect the contact in various ways
174 if (strpos($name, 'http://') || strpos($name, '@')) {
175 $contact = Contact::getByURLForUser($name, $profile_uid);
178 $fields = ['id', 'url', 'nick', 'name', 'alias', 'network', 'forum', 'prv'];
180 if (strrpos($name, '+')) {
181 // Is it in format @nick+number?
182 $tagcid = intval(substr($name, strrpos($name, '+') + 1));
183 $contact = DBA::selectFirst('contact', $fields, ['id' => $tagcid, 'uid' => $profile_uid]);
186 // select someone by nick in the current network
187 if (!DBA::isResult($contact) && ($network != '')) {
188 $condition = ["`nick` = ? AND `network` = ? AND `uid` = ?",
189 $name, $network, $profile_uid];
190 $contact = DBA::selectFirst('contact', $fields, $condition);
193 // select someone by attag in the current network
194 if (!DBA::isResult($contact) && ($network != '')) {
195 $condition = ["`attag` = ? AND `network` = ? AND `uid` = ?",
196 $name, $network, $profile_uid];
197 $contact = DBA::selectFirst('contact', $fields, $condition);
200 //select someone by name in the current network
201 if (!DBA::isResult($contact) && ($network != '')) {
202 $condition = ['name' => $name, 'network' => $network, 'uid' => $profile_uid];
203 $contact = DBA::selectFirst('contact', $fields, $condition);
206 // select someone by nick in any network
207 if (!DBA::isResult($contact)) {
208 $condition = ["`nick` = ? AND `uid` = ?", $name, $profile_uid];
209 $contact = DBA::selectFirst('contact', $fields, $condition);
212 // select someone by attag in any network
213 if (!DBA::isResult($contact)) {
214 $condition = ["`attag` = ? AND `uid` = ?", $name, $profile_uid];
215 $contact = DBA::selectFirst('contact', $fields, $condition);
218 // select someone by name in any network
219 if (!DBA::isResult($contact)) {
220 $condition = ['name' => $name, 'uid' => $profile_uid];
221 $contact = DBA::selectFirst('contact', $fields, $condition);
225 // Check if $contact has been successfully loaded
226 if (DBA::isResult($contact)) {
227 $profile = $contact['url'];
228 $newname = ($contact['name'] ?? '') ?: $contact['nick'];
231 //if there is an url for this persons profile
232 if (isset($profile) && ($newname != '')) {
234 // create profile link
235 $profile = str_replace(',', '%2c', $profile);
236 $newtag = $tag_type.'[url=' . $profile . ']' . $newname . '[/url]';
237 $body = str_replace($tag_type . $name, $newtag, $body);
241 return ['replaced' => $replaced, 'contact' => $contact];
245 * Render actions localized
248 * @throws ImagickException
249 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
251 public function localize(&$item)
253 $this->profiler->startRecording('rendering');
254 /// @todo The following functionality needs to be cleaned up.
255 if (!empty($item['verb'])) {
256 $xmlhead = "<" . "?xml version='1.0' encoding='UTF-8' ?" . ">";
258 if (stristr($item['verb'], Activity::POKE)) {
259 $verb = urldecode(substr($item['verb'], strpos($item['verb'],'#') + 1));
261 $this->profiler->stopRecording();
264 if ($item['object-type'] == "" || $item['object-type'] !== Activity\ObjectType::PERSON) {
265 $this->profiler->stopRecording();
269 $obj = XML::parseString($xmlhead . $item['object']);
271 $Bname = $obj->title;
275 foreach ($obj->link as $l) {
276 $atts = $l->attributes();
277 switch ($atts['rel']) {
278 case "alternate": $Blink = $atts['href'];
279 case "photo": $Bphoto = $atts['href'];
283 $author = ['uid' => 0, 'id' => $item['author-id'],
284 'network' => $item['author-network'], 'url' => $item['author-link']];
285 $A = '[url=' . Contact::magicLinkByContact($author) . ']' . $item['author-name'] . '[/url]';
287 if (!empty($Blink)) {
288 $B = '[url=' . Contact::magicLink($Blink) . ']' . $Bname . '[/url]';
293 if ($Bphoto != "" && !empty($Blink)) {
294 $Bphoto = '[url=' . Contact::magicLink($Blink) . '][img=80x80]' . $Bphoto . '[/img][/url]';
298 * we can't have a translation string with three positions but no distinguishable text
299 * So here is the translate string.
301 $txt = $this->l10n->t('%1$s poked %2$s');
303 // now translate the verb
304 $poked_t = trim(sprintf($txt, '', ''));
305 $txt = str_replace($poked_t, $this->l10n->t($verb), $txt);
307 // then do the sprintf on the translation string
309 $item['body'] = sprintf($txt, $A, $B) . "\n\n\n" . $Bphoto;
313 if ($this->activity->match($item['verb'], Activity::TAG)) {
314 $fields = ['author-id', 'author-link', 'author-name', 'author-network',
315 'verb', 'object-type', 'resource-id', 'body', 'plink'];
316 $obj = Post::selectFirst($fields, ['uri' => $item['parent-uri']]);
317 if (!DBA::isResult($obj)) {
318 $this->profiler->stopRecording();
322 $author_arr = ['uid' => 0, 'id' => $item['author-id'],
323 'network' => $item['author-network'], 'url' => $item['author-link']];
324 $author = '[url=' . Contact::magicLinkByContact($author_arr) . ']' . $item['author-name'] . '[/url]';
326 $author_arr = ['uid' => 0, 'id' => $obj['author-id'],
327 'network' => $obj['author-network'], 'url' => $obj['author-link']];
328 $objauthor = '[url=' . Contact::magicLinkByContact($author_arr) . ']' . $obj['author-name'] . '[/url]';
330 switch ($obj['verb']) {
332 switch ($obj['object-type']) {
333 case Activity\ObjectType::EVENT:
334 $post_type = $this->l10n->t('event');
337 $post_type = $this->l10n->t('status');
341 if ($obj['resource-id']) {
342 $post_type = $this->l10n->t('photo');
343 $m=[]; preg_match("/\[url=([^]]*)\]/", $obj['body'], $m);
344 $rr['plink'] = $m[1];
346 $post_type = $this->l10n->t('status');
348 // Let's break everthing ... ;-)
351 $plink = '[url=' . $obj['plink'] . ']' . $post_type . '[/url]';
353 $parsedobj = XML::parseString($xmlhead . $item['object']);
355 $tag = sprintf('#[url=%s]%s[/url]', $parsedobj->id, $parsedobj->content);
356 $item['body'] = $this->l10n->t('%1$s tagged %2$s\'s %3$s with %4$s', $author, $objauthor, $plink, $tag);
360 $this->profiler->stopRecording();
363 public function photoMenu($item, string $formSecurityToken)
365 $this->profiler->startRecording('rendering');
376 if (local_user() && local_user() == $item['uid'] && $item['gravity'] == GRAVITY_PARENT && !$item['self'] && !$item['mention']) {
377 $sub_link = 'javascript:doFollowThread(' . $item['id'] . '); return false;';
380 $author = ['uid' => 0, 'id' => $item['author-id'],
381 'network' => $item['author-network'], 'url' => $item['author-link']];
382 $profile_link = Contact::magicLinkByContact($author, $item['author-link']);
383 $sparkle = (strpos($profile_link, 'redir/') === 0);
386 $pcid = $item['author-id'];
389 $condition = ['uid' => local_user(), 'uri-id' => $item['author-uri-id']];
390 $contact = DBA::selectFirst('contact', ['id', 'network', 'rel'], $condition);
391 if (DBA::isResult($contact)) {
392 $cid = $contact['id'];
393 $network = $contact['network'];
394 $rel = $contact['rel'];
398 $status_link = $profile_link . '/status';
399 $photos_link = str_replace('/profile/', '/photos/', $profile_link);
400 $profile_link = $profile_link . '/profile';
404 $contact_url = 'contact/' . $pcid;
405 $posts_link = $contact_url . '/posts';
406 $block_link = $item['self'] ? '' : $contact_url . '/block?t=' . $formSecurityToken;
407 $ignore_link = $item['self'] ? '' : $contact_url . '/ignore?t=' . $formSecurityToken;
410 if ($cid && !$item['self']) {
411 $contact_url = 'contact/' . $cid;
412 $poke_link = $contact_url . '/poke';
413 $posts_link = $contact_url . '/posts';
415 if (in_array($network, [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::DIASPORA])) {
416 $pm_url = 'message/new/' . $cid;
422 $this->l10n->t('Follow Thread') => $sub_link,
423 $this->l10n->t('View Status') => $status_link,
424 $this->l10n->t('View Profile') => $profile_link,
425 $this->l10n->t('View Photos') => $photos_link,
426 $this->l10n->t('Network Posts') => $posts_link,
427 $this->l10n->t('View Contact') => $contact_url,
428 $this->l10n->t('Send PM') => $pm_url,
429 $this->l10n->t('Block') => $block_link,
430 $this->l10n->t('Ignore') => $ignore_link
433 if (!empty($item['language'])) {
434 $menu[$this->l10n->t('Languages')] = 'javascript:alert(\'' . ModelItem::getLanguageMessage($item) . '\');';
437 if ($network == Protocol::DFRN) {
438 $menu[$this->l10n->t("Poke")] = $poke_link;
441 if ((($cid == 0) || ($rel == Contact::FOLLOWER)) &&
442 in_array($item['network'], Protocol::FEDERATED)) {
443 $menu[$this->l10n->t('Connect/Follow')] = 'follow?url=' . urlencode($item['author-link']) . '&auto=1';
446 $menu = [$this->l10n->t('View Profile') => $item['author-link']];
449 $args = ['item' => $item, 'menu' => $menu];
451 Hook::callAll('item_photo_menu', $args);
453 $menu = $args['menu'];
456 foreach ($menu as $k => $v) {
457 if (strpos($v, 'javascript:') === 0) {
459 $o .= '<li role="menuitem"><a onclick="' . $v . '">' . $k . '</a></li>' . PHP_EOL;
461 $o .= '<li role="menuitem"><a href="' . $v . '">' . $k . '</a></li>' . PHP_EOL;
464 $this->profiler->stopRecording();
468 public function visibleActivity($item) {
470 if (empty($item['verb']) || $this->activity->isHidden($item['verb'])) {
474 // @TODO below if() block can be rewritten to a single line: $isVisible = allConditionsHere;
475 if ($this->activity->match($item['verb'], Activity::FOLLOW) &&
476 $item['object-type'] === Activity\ObjectType::NOTE &&
477 empty($item['self']) &&
478 $item['uid'] == local_user()) {
485 public function expandTags(array $item, bool $setPermissions = false)
487 // Look for any tags and linkify them
488 $item['inform'] = '';
489 $private_forum = false;
491 $only_to_forum = false;
495 // Convert mentions in the body to a unified format
496 $item['body'] = BBCode::setMentions($item['body'], $item['uid'], $item['network']);
498 // Search for forum mentions
499 foreach (Tag::getFromBody($item['body'], Tag::TAG_CHARACTER[Tag::MENTION] . Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION]) as $tag) {
500 $contact = Contact::getByURLForUser($tag[2], $item['uid']);
502 $receivers[] = $contact['id'];
504 if (!empty($item['inform'])) {
505 $item['inform'] .= ',';
507 $item['inform'] .= 'cid:' . $contact['id'];
509 if (($item['gravity'] == GRAVITY_COMMENT) || empty($contact['cid']) || ($contact['contact-type'] != Contact::TYPE_COMMUNITY)) {
513 if (!empty($contact['prv']) || ($tag[1] == Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION])) {
514 $private_forum = $contact['prv'];
515 $only_to_forum = ($tag[1] == Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION]);
516 $private_id = $contact['id'];
517 $forum_contact = $contact;
518 Logger::info('Private forum or exclusive mention', ['url' => $tag[2], 'mention' => $tag[1]]);
519 } elseif ($item['allow_cid'] == '<' . $contact['id'] . '>') {
520 $private_forum = false;
521 $only_to_forum = true;
522 $private_id = $contact['id'];
523 $forum_contact = $contact;
524 Logger::info('Public forum', ['url' => $tag[2], 'mention' => $tag[1]]);
526 Logger::info('Post with forum mention will not be converted to a forum post', ['url' => $tag[2], 'mention' => $tag[1]]);
529 Logger::info('Got inform', ['inform' => $item['inform']]);
531 if (($item['gravity'] == GRAVITY_PARENT) && !empty($forum_contact) && ($private_forum || $only_to_forum)) {
532 // we tagged a forum in a top level post. Now we change the post
533 $item['private'] = $private_forum ? ModelItem::PRIVATE : ModelItem::UNLISTED;
535 if ($only_to_forum) {
536 $item['postopts'] = '';
539 $item['deny_cid'] = '';
540 $item['deny_gid'] = '';
542 if ($private_forum) {
543 $item['allow_cid'] = '<' . $private_id . '>';
544 $item['allow_gid'] = '<' . Group::getIdForForum($forum_contact['id']) . '>';
546 $item['allow_cid'] = '';
547 $item['allow_gid'] = '';
549 } elseif ($setPermissions && ($item['gravity'] == GRAVITY_PARENT)) {
550 if (empty($receivers)) {
551 // For security reasons direct posts without any receiver will be posts to yourself
552 $self = Contact::selectFirst(['id'], ['uid' => $item['uid'], 'self' => true]);
553 $receivers[] = $self['id'];
556 $item['private'] = ModelItem::PRIVATE;
557 $item['allow_cid'] = '';
558 $item['allow_gid'] = '';
559 $item['deny_cid'] = '';
560 $item['deny_gid'] = '';
562 foreach ($receivers as $receiver) {
563 $item['allow_cid'] .= '<' . $receiver . '>';
569 public function getAuthorAvatar(array $item): string
571 if (in_array($item['network'], [Protocol::FEED, Protocol::MAIL])) {
572 $author_avatar = $item['contact-id'];
573 $author_updated = '';
574 $author_thumb = $item['contact-avatar'];
576 $author_avatar = $item['author-id'];
577 $author_updated = $item['author-updated'];
578 $author_thumb = $item['author-avatar'];
582 if (empty($author_thumb) || Photo::isPhotoURI($author_thumb)) {
583 $author_thumb = Contact::getAvatarUrlForId($author_avatar, Proxy::SIZE_THUMB, $author_updated);
586 return $author_thumb;
589 public function getOwnerAvatar(array $item): string
591 if (in_array($item['network'], [Protocol::FEED, Protocol::MAIL])) {
592 $owner_avatar = $item['contact-id'];
594 $owner_thumb = $item['contact-avatar'];
596 $owner_avatar = $item['owner-id'];
597 $owner_updated = $item['owner-updated'];
598 $owner_thumb = $item['owner-avatar'];
601 if (empty($owner_thumb) || Photo::isPhotoURI($owner_thumb)) {
602 $owner_thumb = Contact::getAvatarUrlForId($owner_avatar, Proxy::SIZE_THUMB, $owner_updated);