3 * @copyright Copyright (C) 2010-2023, 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;
25 use Friendica\App\Arguments;
26 use Friendica\App\BaseURL;
27 use Friendica\BaseModule;
28 use Friendica\Core\ACL;
29 use Friendica\Core\Config\Capability\IManageConfigValues;
30 use Friendica\Core\Hook;
31 use Friendica\Core\L10n;
32 use Friendica\Core\PConfig\Capability\IManagePersonalConfigValues;
33 use Friendica\Core\Protocol;
34 use Friendica\Core\Renderer;
35 use Friendica\Core\Session\Capability\IHandleUserSessions;
36 use Friendica\Core\Theme;
37 use Friendica\Database\DBA;
38 use Friendica\Model\Contact;
39 use Friendica\Model\Item as ItemModel;
40 use Friendica\Model\Post;
41 use Friendica\Model\Tag;
42 use Friendica\Model\User;
43 use Friendica\Model\Verb;
44 use Friendica\Object\Post as PostObject;
45 use Friendica\Object\Thread;
46 use Friendica\Protocol\Activity;
47 use Friendica\Util\Crypto;
48 use Friendica\Util\DateTimeFormat;
49 use Friendica\Util\Profiler;
50 use Friendica\Util\Strings;
51 use Friendica\Util\Temporal;
52 use Psr\Log\LoggerInterface;
56 const MODE_COMMUNITY = 'community';
57 const MODE_CONTACTS = 'contacts';
58 const MODE_CONTACT_POSTS = 'contact-posts';
59 const MODE_DISPLAY = 'display';
60 const MODE_FILED = 'filed';
61 const MODE_NETWORK = 'network';
62 const MODE_NOTES = 'notes';
63 const MODE_SEARCH = 'search';
64 const MODE_PROFILE = 'profile';
72 /** @var LoggerInterface */
76 /** @var App\Arguments */
78 /** @var IManagePersonalConfigValues */
82 /** @var IManageConfigValues */
90 /** @var IHandleUserSessions */
93 public function __construct(LoggerInterface $logger, Profiler $profiler, Activity $activity, L10n $l10n, Item $item, Arguments $args, BaseURL $baseURL, IManageConfigValues $config, IManagePersonalConfigValues $pConfig, App\Page $page, App\Mode $mode, App $app, IHandleUserSessions $session)
95 $this->activity = $activity;
97 $this->config = $config;
99 $this->baseURL = $baseURL;
100 $this->profiler = $profiler;
101 $this->logger = $logger;
104 $this->pConfig = $pConfig;
107 $this->session = $session;
111 * Checks item to see if it is one of the builtin activities (like/dislike, event attendance, consensus items, etc.)
113 * Increments the count of each matching activity and adds a link to the author as needed.
115 * @param array $activity
116 * @param array &$conv_responses (already created with builtin activity structure)
118 * @throws ImagickException
119 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
121 public function builtinActivityPuller(array $activity, array &$conv_responses)
123 $thread_parent = $activity['thr-parent-row'] ?? [];
125 foreach ($conv_responses as $mode => $v) {
130 $verb = Activity::LIKE;
133 $verb = Activity::DISLIKE;
136 $verb = Activity::ATTEND;
139 $verb = Activity::ATTENDNO;
142 $verb = Activity::ATTENDMAYBE;
145 $verb = Activity::ANNOUNCE;
151 if (!empty($activity['verb']) && $this->activity->match($activity['verb'], $verb) && ($activity['gravity'] != ItemModel::GRAVITY_PARENT)) {
154 'id' => $activity['author-id'],
155 'network' => $activity['author-network'],
156 'url' => $activity['author-link']
158 $url = Contact::magicLinkByContact($author);
159 if (strpos($url, 'contact/redir/') === 0) {
160 $sparkle = ' class="sparkle" ';
163 $link = '<a href="' . $url . '"' . $sparkle . '>' . htmlentities($activity['author-name']) . '</a>';
165 if (empty($activity['thr-parent-id'])) {
166 $activity['thr-parent-id'] = $activity['parent-uri-id'];
169 // Skip when the causer of the parent is the same as the author of the announce
170 if (($verb == Activity::ANNOUNCE) && !empty($thread_parent['causer-id']) && ($thread_parent['causer-id'] == $activity['author-id'])) {
174 if (!isset($conv_responses[$mode][$activity['thr-parent-id']])) {
175 $conv_responses[$mode][$activity['thr-parent-id']] = [
179 } elseif (in_array($link, $conv_responses[$mode][$activity['thr-parent-id']]['links'])) {
180 // only list each unique author once
184 if ($this->session->getPublicContactId() == $activity['author-id']) {
185 $conv_responses[$mode][$activity['thr-parent-id']]['self'] = 1;
188 $conv_responses[$mode][$activity['thr-parent-id']]['links'][] = $link;
190 // there can only be one activity verb per item so if we found anything, we can stop looking
197 * Format the activity text for an item/photo/video
199 * @param array $links = array of pre-linked names of actors
200 * @param string $verb = one of 'like, 'dislike', 'attendyes', 'attendno', 'attendmaybe'
201 * @param int $id = item id
202 * @return string formatted text
203 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
205 public function formatActivity(array $links, string $verb, int $id): string
207 $this->profiler->startRecording('rendering');
212 $total = count($links);
216 // Phrase if there is only one liker. In other cases it will be uses for the expanded
217 // list which show all likers
220 $phrase = $this->l10n->t('%s likes this.', $likers);
223 $phrase = $this->l10n->t('%s doesn\'t like this.', $likers);
226 $phrase = $this->l10n->t('%s attends.', $likers);
229 $phrase = $this->l10n->t('%s doesn\'t attend.', $likers);
232 $phrase = $this->l10n->t('%s attends maybe.', $likers);
235 $phrase = $this->l10n->t('%s reshared this.', $likers);
238 } elseif ($total > 1) {
239 if ($total < $this->config->get('system', 'max_likers')) {
240 $likers = implode(', ', array_slice($links, 0, -1));
241 $likers .= ' ' . $this->l10n->t('and') . ' ' . $links[count($links) - 1];
243 $likers = implode(', ', array_slice($links, 0, $this->config->get('system', 'max_likers') - 1));
244 $likers .= ' ' . $this->l10n->t('and %d other people', $total - $this->config->get('system', 'max_likers'));
247 $spanatts = "class=\"btn btn-link fakelink\" onclick=\"openClose('{$verb}list-$id');\"";
252 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> like this', $spanatts, $total);
253 $explikers = $this->l10n->t('%s like this.', $likers);
256 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> don\'t like this', $spanatts, $total);
257 $explikers = $this->l10n->t('%s don\'t like this.', $likers);
260 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> attend', $spanatts, $total);
261 $explikers = $this->l10n->t('%s attend.', $likers);
264 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> don\'t attend', $spanatts, $total);
265 $explikers = $this->l10n->t('%s don\'t attend.', $likers);
268 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> attend maybe', $spanatts, $total);
269 $explikers = $this->l10n->t('%s attend maybe.', $likers);
272 $phrase = $this->l10n->t('<button type="button" %1$s>%2$d people</button> reshared this', $spanatts, $total);
273 $explikers = $this->l10n->t('%s reshared this.', $likers);
277 $expanded .= "\t" . '<p class="wall-item-' . $verb . '-expanded" id="' . $verb . 'list-' . $id . '" style="display: none;" >' . $explikers . '</p>';
280 $o .= Renderer::replaceMacros(Renderer::getMarkupTemplate('voting_fakelink.tpl'), [
281 '$phrase' => $phrase,
287 $this->profiler->stopRecording();
291 public function statusEditor(array $x = [], int $notes_cid = 0, bool $popup = false): string
293 $user = User::getById($this->app->getLoggedInUserId(), ['uid', 'nickname', 'allow_location', 'default-location']);
294 if (empty($user['uid'])) {
298 $this->profiler->startRecording('rendering');
301 $x['allow_location'] = $x['allow_location'] ?? $user['allow_location'];
302 $x['default_location'] = $x['default_location'] ?? $user['default-location'];
303 $x['nickname'] = $x['nickname'] ?? $user['nickname'];
304 $x['lockstate'] = $x['lockstate'] ?? ACL::getLockstateForUserId($user['uid']) ? 'lock' : 'unlock';
305 $x['acl'] = $x['acl'] ?? ACL::getFullSelectorHTML($this->page, $user['uid'], true);
306 $x['bang'] = $x['bang'] ?? '';
307 $x['visitor'] = $x['visitor'] ?? 'block';
308 $x['is_owner'] = $x['is_owner'] ?? true;
309 $x['profile_uid'] = $x['profile_uid'] ?? $this->session->getLocalUserId();
312 $geotag = !empty($x['allow_location']) ? Renderer::replaceMacros(Renderer::getMarkupTemplate('jot_geotag.tpl'), []) : '';
314 $tpl = Renderer::getMarkupTemplate('jot-header.tpl');
315 $this->page['htmlhead'] .= Renderer::replaceMacros($tpl, [
316 '$newpost' => 'true',
317 '$baseurl' => $this->baseURL->get(true),
318 '$geotag' => $geotag,
319 '$nickname' => $x['nickname'],
320 '$ispublic' => $this->l10n->t('Visible to <strong>everybody</strong>'),
321 '$linkurl' => $this->l10n->t('Please enter a image/video/audio/webpage URL:'),
322 '$term' => $this->l10n->t('Tag term:'),
323 '$fileas' => $this->l10n->t('Save to Folder:'),
324 '$whereareu' => $this->l10n->t('Where are you right now?'),
325 '$delitems' => $this->l10n->t("Delete item\x28s\x29?"),
326 '$is_mobile' => $this->mode->isMobile(),
330 Hook::callAll('jot_tool', $jotplugins);
332 if ($this->config->get('system', 'set_creation_date')) {
333 $created_at = Temporal::getDateTimeField(
334 new \DateTime(DBA::NULL_DATETIME),
335 new \DateTime('now'),
337 $this->l10n->t('Created at'),
344 $tpl = Renderer::getMarkupTemplate('jot.tpl');
346 $o .= Renderer::replaceMacros($tpl, [
347 '$new_post' => $this->l10n->t('New Post'),
348 '$return_path' => $this->args->getQueryString(),
350 '$share' => ($x['button'] ?? '') ?: $this->l10n->t('Share'),
351 '$loading' => $this->l10n->t('Loading...'),
352 '$upload' => $this->l10n->t('Upload photo'),
353 '$shortupload' => $this->l10n->t('upload photo'),
354 '$attach' => $this->l10n->t('Attach file'),
355 '$shortattach' => $this->l10n->t('attach file'),
356 '$edbold' => $this->l10n->t('Bold'),
357 '$editalic' => $this->l10n->t('Italic'),
358 '$eduline' => $this->l10n->t('Underline'),
359 '$edquote' => $this->l10n->t('Quote'),
360 '$edcode' => $this->l10n->t('Code'),
361 '$edimg' => $this->l10n->t('Image'),
362 '$edurl' => $this->l10n->t('Link'),
363 '$edattach' => $this->l10n->t('Link or Media'),
364 '$edvideo' => $this->l10n->t('Video'),
365 '$setloc' => $this->l10n->t('Set your location'),
366 '$shortsetloc' => $this->l10n->t('set location'),
367 '$noloc' => $this->l10n->t('Clear browser location'),
368 '$shortnoloc' => $this->l10n->t('clear location'),
369 '$title' => $x['title'] ?? '',
370 '$placeholdertitle' => $this->l10n->t('Set title'),
371 '$category' => $x['category'] ?? '',
372 '$placeholdercategory' => Feature::isEnabled($this->session->getLocalUserId(), 'categories') ? $this->l10n->t("Categories \x28comma-separated list\x29") : '',
373 '$scheduled_at' => Temporal::getDateTimeField(
375 new \DateTime('now + 6 months'),
377 $this->l10n->t('Scheduled at'),
380 '$created_at' => $created_at,
381 '$wait' => $this->l10n->t('Please wait'),
382 '$permset' => $this->l10n->t('Permission settings'),
383 '$shortpermset' => $this->l10n->t('Permissions'),
384 '$wall' => $notes_cid ? 0 : 1,
385 '$posttype' => $notes_cid ? ItemModel::PT_PERSONAL_NOTE : ItemModel::PT_ARTICLE,
386 '$content' => $x['content'] ?? '',
387 '$post_id' => $x['post_id'] ?? '',
388 '$baseurl' => $this->baseURL->get(true),
389 '$defloc' => $x['default_location'],
390 '$visitor' => $x['visitor'],
391 '$pvisit' => $notes_cid ? 'none' : $x['visitor'],
392 '$public' => $this->l10n->t('Public post'),
393 '$lockstate' => $x['lockstate'],
394 '$bang' => $x['bang'],
395 '$profile_uid' => $x['profile_uid'],
396 '$preview' => $this->l10n->t('Preview'),
397 '$jotplugins' => $jotplugins,
398 '$notes_cid' => $notes_cid,
399 '$cancel' => $this->l10n->t('Cancel'),
400 '$rand_num' => Crypto::randomDigits(12),
402 // ACL permissions box
405 //jot nav tab (used in some themes)
406 '$message' => $this->l10n->t('Message'),
407 '$browser' => $this->l10n->t('Browser'),
409 '$compose_link_title' => $this->l10n->t('Open Compose page'),
410 '$always_open_compose' => $this->pConfig->get($this->session->getLocalUserId(), 'frio', 'always_open_compose', false),
414 if ($popup == true) {
415 $o = '<div id="jot-popup" style="display: none;">' . $o . '</div>';
418 $this->profiler->stopRecording();
423 * "Render" a conversation or list of items for HTML display.
424 * There are two major forms of display:
425 * - Sequential or unthreaded ("New Item View" or search results)
426 * - conversation view
427 * The $mode parameter decides between the various renderings and also
428 * figures out how to determine page owner and other contextual items
429 * that are based on unique features of the calling module.
430 * @param array $items
431 * @param string $mode
432 * @param $update @TODO Which type?
433 * @param bool $preview
434 * @param string $order
437 * @throws ImagickException
438 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
440 public function create(array $items, string $mode, $update, bool $preview = false, string $order = 'commented', int $uid = 0): string
442 $this->profiler->startRecording('rendering');
444 $this->page->registerFooterScript(Theme::getPathForFile('asset/typeahead.js/dist/typeahead.bundle.js'));
445 $this->page->registerFooterScript(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput.js'));
446 $this->page->registerStylesheet(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput.css'));
447 $this->page->registerStylesheet(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput-typeahead.css'));
449 $ssl_state = (bool)$this->session->getLocalUserId();
451 $live_update_div = '';
453 $blocklist = $this->getBlocklist();
455 $previewing = (($preview) ? ' preview ' : '');
457 if ($mode === self::MODE_NETWORK) {
458 $items = $this->addChildren($items, false, $order, $uid, $mode);
461 * The special div is needed for liveUpdate to kick in for this page.
462 * We only launch liveUpdate if you aren't filtering in some incompatible
463 * way and also you aren't writing a comment (discovered in javascript).
465 $live_update_div = '<div id="live-network"></div>' . "\r\n"
466 . "<script> var profile_uid = " . $_SESSION['uid']
467 . "; var netargs = '" . substr($this->args->getCommand(), 8)
469 . (!empty($_GET['contactid']) ? '&contactid=' . rawurlencode($_GET['contactid']) : '')
470 . (!empty($_GET['search']) ? '&search=' . rawurlencode($_GET['search']) : '')
471 . (!empty($_GET['star']) ? '&star=' . rawurlencode($_GET['star']) : '')
472 . (!empty($_GET['order']) ? '&order=' . rawurlencode($_GET['order']) : '')
473 . (!empty($_GET['bmark']) ? '&bmark=' . rawurlencode($_GET['bmark']) : '')
474 . (!empty($_GET['liked']) ? '&liked=' . rawurlencode($_GET['liked']) : '')
475 . (!empty($_GET['conv']) ? '&conv=' . rawurlencode($_GET['conv']) : '')
476 . (!empty($_GET['nets']) ? '&nets=' . rawurlencode($_GET['nets']) : '')
477 . (!empty($_GET['cmin']) ? '&cmin=' . rawurlencode($_GET['cmin']) : '')
478 . (!empty($_GET['cmax']) ? '&cmax=' . rawurlencode($_GET['cmax']) : '')
479 . (!empty($_GET['file']) ? '&file=' . rawurlencode($_GET['file']) : '')
481 . "'; </script>\r\n";
483 } elseif ($mode === self::MODE_PROFILE) {
484 $items = $this->addChildren($items, false, $order, $uid, $mode);
487 $tab = !empty($_GET['tab']) ? trim($_GET['tab']) : 'posts';
489 if ($tab === 'posts') {
491 * This is ugly, but we can't pass the profile_uid through the session to the ajax updater,
492 * because browser prefetching might change it on us. We have to deliver it with the page.
495 $live_update_div = '<div id="live-profile"></div>' . "\r\n"
496 . "<script> var profile_uid = " . $uid
497 . "; var netargs = '?f='; </script>\r\n";
500 } elseif ($mode === self::MODE_NOTES) {
501 $items = $this->addChildren($items, false, $order, $this->session->getLocalUserId(), $mode);
504 $live_update_div = '<div id="live-notes"></div>' . "\r\n"
505 . "<script> var profile_uid = " . $this->session->getLocalUserId()
506 . "; var netargs = '?f='; </script>\r\n";
508 } elseif ($mode === self::MODE_DISPLAY) {
509 $items = $this->addChildren($items, false, $order, $uid, $mode);
512 $live_update_div = '<div id="live-display"></div>' . "\r\n"
513 . "<script> var profile_uid = " . ($this->session->getLocalUserId() ?: 0) . ";"
516 } elseif ($mode === self::MODE_COMMUNITY) {
517 $items = $this->addChildren($items, true, $order, $uid, $mode);
520 $live_update_div = '<div id="live-community"></div>' . "\r\n"
521 . "<script> var profile_uid = -1; var netargs = '" . substr($this->args->getCommand(), 10)
523 . (!empty($_GET['no_sharer']) ? '&no_sharer=' . rawurlencode($_GET['no_sharer']) : '')
524 . (!empty($_GET['accounttype']) ? '&accounttype=' . rawurlencode($_GET['accounttype']) : '')
525 . "'; </script>\r\n";
527 } elseif ($mode === self::MODE_CONTACTS) {
528 $items = $this->addChildren($items, false, $order, $uid, $mode);
531 $live_update_div = '<div id="live-contact"></div>' . "\r\n"
532 . "<script> var profile_uid = -1; var netargs = '" . substr($this->args->getCommand(), 8)
533 ."?f='; </script>\r\n";
535 } elseif ($mode === self::MODE_SEARCH) {
536 $live_update_div = '<div id="live-search"></div>' . "\r\n";
539 $page_dropping = $this->session->getLocalUserId() && $this->session->getLocalUserId() == $uid && $mode != self::MODE_SEARCH;
542 $_SESSION['return_path'] = $this->args->getQueryString();
545 $cb = ['items' => $items, 'mode' => $mode, 'update' => $update, 'preview' => $preview];
546 Hook::callAll('conversation_start', $cb);
548 $items = $cb['items'];
559 if ($this->pConfig->get($this->session->getLocalUserId(), 'system', 'hide_dislike')) {
560 unset($conv_responses['dislike']);
563 // array with html for each thread (parent+comments)
567 $page_template = Renderer::getMarkupTemplate("conversation.tpl");
568 $formSecurityToken = BaseModule::getFormSecurityToken('contact_action');
570 if (!empty($items)) {
571 if (in_array($mode, [self::MODE_COMMUNITY, self::MODE_CONTACTS, self::MODE_PROFILE])) {
574 $writable = $items[0]['writable'] || ($items[0]['uid'] == 0) && in_array($items[0]['network'], Protocol::FEDERATED);
577 if (!$this->session->getLocalUserId()) {
581 if (in_array($mode, [self::MODE_FILED, self::MODE_SEARCH, self::MODE_CONTACT_POSTS])) {
584 * "New Item View" on network page or search page results
585 * - just loop through the items and format them minimally for display
588 $tpl = 'search_item.tpl';
592 foreach ($items as $item) {
593 if (in_array($item['uri-id'], $uriids)) {
597 $uriids[] = $item['uri-id'];
599 if (!$this->item->isVisibleActivity($item)) {
603 if (in_array($item['author-id'], $blocklist)) {
609 // prevent private email from leaking.
610 if ($item['network'] === Protocol::MAIL && $this->session->getLocalUserId() != $item['uid']) {
614 $profile_name = $item['author-name'];
615 if (!empty($item['author-link']) && empty($item['author-name'])) {
616 $profile_name = $item['author-link'];
619 $tags = Tag::populateFromItem($item);
621 $author = ['uid' => 0, 'id' => $item['author-id'], 'network' => $item['author-network'], 'url' => $item['author-link']];
622 $profile_link = Contact::magicLinkByContact($author);
625 if (strpos($profile_link, 'contact/redir/') === 0) {
626 $sparkle = ' sparkle';
629 $locate = ['location' => $item['location'], 'coord' => $item['coord'], 'html' => ''];
630 Hook::callAll('render_location', $locate);
631 $location_html = $locate['html'] ?: Strings::escapeHtml($locate['location'] ?: $locate['coord'] ?: '');
633 $this->item->localize($item);
634 if ($mode === self::MODE_FILED) {
641 'dropping' => $dropping,
642 'pagedrop' => $page_dropping,
643 'select' => $this->l10n->t('Select'),
644 'delete' => $this->l10n->t('Delete'),
654 if ($this->pConfig->get($this->session->getLocalUserId(), 'system', 'hide_dislike')) {
655 unset($likebuttons['dislike']);
658 $body_html = ItemModel::prepareBody($item, true, $preview);
660 [$categories, $folders] = $this->item->determineCategoriesTerms($item, $this->session->getLocalUserId());
662 if (!empty($item['title'])) {
663 $title = $item['title'];
664 } elseif (!empty($item['content-warning']) && $this->pConfig->get($this->session->getLocalUserId(), 'system', 'disable_cw', false)) {
665 $title = ucfirst($item['content-warning']);
670 if (!empty($item['featured'])) {
671 $pinned = $this->l10n->t('Pinned item');
678 'id' => ($preview ? 'P0' : $item['id']),
679 'guid' => ($preview ? 'Q0' : $item['guid']),
680 'commented' => $item['commented'],
681 'received' => $item['received'],
682 'created_date' => $item['created'],
683 'uriid' => $item['uri-id'],
684 'network' => $item['network'],
685 'network_name' => ContactSelector::networkToName($item['author-network'], $item['author-link'], $item['network'], $item['author-gsid']),
686 'network_icon' => ContactSelector::networkToIcon($item['network'], $item['author-link'], $item['author-gsid']),
687 'linktitle' => $this->l10n->t('View %s\'s profile @ %s', $profile_name, $item['author-link']),
688 'profile_url' => $profile_link,
689 'item_photo_menu_html' => $this->item->photoMenu($item, $formSecurityToken),
690 'name' => $profile_name,
691 'sparkle' => $sparkle,
693 'thumb' => $this->baseURL->remove($this->item->getAuthorAvatar($item)),
695 'body_html' => $body_html,
696 'tags' => $tags['tags'],
697 'hashtags' => $tags['hashtags'],
698 'mentions' => $tags['mentions'],
699 'implicit_mentions' => $tags['implicit_mentions'],
700 'txt_cats' => $this->l10n->t('Categories:'),
701 'txt_folders' => $this->l10n->t('Filed under:'),
702 'has_cats' => ((count($categories)) ? 'true' : ''),
703 'has_folders' => ((count($folders)) ? 'true' : ''),
704 'categories' => $categories,
705 'folders' => $folders,
706 'text' => strip_tags($body_html),
707 'localtime' => DateTimeFormat::local($item['created'], 'r'),
708 'utc' => DateTimeFormat::utc($item['created'], 'c'),
709 'ago' => (($item['app']) ? $this->l10n->t('%s from %s', Temporal::getRelativeDate($item['created']), $item['app']) : Temporal::getRelativeDate($item['created'])),
710 'location_html' => $location_html,
714 'owner_photo' => $this->baseURL->remove($this->item->getOwnerAvatar($item)),
715 'plink' => ItemModel::getPlink($item),
718 'isstarred' => 'unstarred',
721 'vote' => $likebuttons,
723 'dislike_html ' => '',
724 'comment_html' => '',
725 'conv' => ($preview ? '' : ['href' => 'display/' . $item['guid'], 'title' => $this->l10n->t('View in context')]),
726 'previewing' => $previewing,
727 'wait' => $this->l10n->t('Please wait'),
731 $arr = ['item' => $item, 'output' => $tmp_item];
732 Hook::callAll('display_item', $arr);
734 $threads[$threadsid]['id'] = $item['id'];
735 $threads[$threadsid]['network'] = $item['network'];
736 $threads[$threadsid]['items'] = [$arr['output']];
740 $page_template = Renderer::getMarkupTemplate("threaded_conversation.tpl");
742 $conv = new Thread($mode, $preview, $writable);
745 * get all the topmost parents
746 * this shouldn't be needed, as we should have only them in our array
747 * But for now, this array respects the old style, just in case
749 foreach ($items as $item) {
750 if (in_array($item['author-id'], $blocklist)) {
754 // Can we put this after the visibility check?
755 $this->builtinActivityPuller($item, $conv_responses);
757 // Only add what is visible
758 if ($item['network'] === Protocol::MAIL && $this->session->getLocalUserId() != $item['uid']) {
762 if (!$this->item->isVisibleActivity($item)) {
766 /// @todo Check if this call is needed or not
767 $arr = ['item' => $item];
768 Hook::callAll('display_item', $arr);
770 $item['pagedrop'] = $page_dropping;
772 if ($item['gravity'] == ItemModel::GRAVITY_PARENT) {
773 $item_object = new PostObject($item);
774 $conv->addParent($item_object);
778 $threads = $conv->getTemplateData($conv_responses, $formSecurityToken);
780 $this->logger->info('[ERROR] conversation : Failed to get template data.');
786 $o = Renderer::replaceMacros($page_template, [
787 '$baseurl' => $this->baseURL->get($ssl_state),
788 '$return_path' => $this->args->getQueryString(),
789 '$live_update' => $live_update_div,
790 '$remove' => $this->l10n->t('remove'),
792 '$update' => $update,
793 '$threads' => $threads,
794 '$dropping' => ($page_dropping ? $this->l10n->t('Delete Selected Items') : false),
797 $this->profiler->stopRecording();
801 private function getBlocklist(): array
803 if (!$this->session->getLocalUserId()) {
807 $str_blocked = str_replace(["\n", "\r"], ",", $this->pConfig->get($this->session->getLocalUserId(), 'system', 'blocked') ?? '');
808 if (empty($str_blocked)) {
814 foreach (explode(',', $str_blocked) as $entry) {
815 $cid = Contact::getIdForURL(trim($entry), 0, false);
825 * Adds some information (Causer, post reason, direction) to the fetched post row.
827 * @param array $row Post row
828 * @param array $activity Contact data of the resharer
829 * @param array $thr_parent Thread parent row
831 * @return array items with parents and comments
833 private function addRowInformation(array $row, array $activity, array $thr_parent): array
835 $this->profiler->startRecording('rendering');
837 if (!$row['writable']) {
838 $row['writable'] = in_array($row['network'], Protocol::FEDERATED);
841 if (!empty($activity)) {
842 if (($row['gravity'] == ItemModel::GRAVITY_PARENT)) {
843 $row['post-reason'] = ItemModel::PR_ANNOUNCEMENT;
845 $row = array_merge($row, $activity);
846 $contact = Contact::getById($activity['causer-id'], ['url', 'name', 'thumb']);
848 $row['causer-link'] = $contact['url'];
849 $row['causer-avatar'] = $contact['thumb'];
850 $row['causer-name'] = $contact['name'];
851 } elseif (($row['gravity'] == ItemModel::GRAVITY_ACTIVITY) && ($row['verb'] == Activity::ANNOUNCE) &&
852 ($row['author-id'] == $activity['causer-id'])) {
857 switch ($row['post-reason']) {
858 case ItemModel::PR_TO:
859 $row['direction'] = ['direction' => 7, 'title' => $this->l10n->t('You had been addressed (%s).', 'to')];
861 case ItemModel::PR_CC:
862 $row['direction'] = ['direction' => 7, 'title' => $this->l10n->t('You had been addressed (%s).', 'cc')];
864 case ItemModel::PR_BTO:
865 $row['direction'] = ['direction' => 7, 'title' => $this->l10n->t('You had been addressed (%s).', 'bto')];
867 case ItemModel::PR_BCC:
868 $row['direction'] = ['direction' => 7, 'title' => $this->l10n->t('You had been addressed (%s).', 'bcc')];
870 case ItemModel::PR_FOLLOWER:
871 $row['direction'] = ['direction' => 6, 'title' => $this->l10n->t('You are following %s.', $row['causer-name'] ?: $row['author-name'])];
873 case ItemModel::PR_TAG:
874 $row['direction'] = ['direction' => 4, 'title' => $this->l10n->t('You subscribed to one or more tags in this post.')];
876 case ItemModel::PR_ANNOUNCEMENT:
877 if (!empty($row['causer-id']) && $this->pConfig->get($this->session->getLocalUserId(), 'system', 'display_resharer')) {
878 $row['owner-id'] = $row['causer-id'];
879 $row['owner-link'] = $row['causer-link'];
880 $row['owner-avatar'] = $row['causer-avatar'];
881 $row['owner-name'] = $row['causer-name'];
884 if (in_array($row['gravity'], [ItemModel::GRAVITY_PARENT, ItemModel::GRAVITY_COMMENT]) && !empty($row['causer-id'])) {
885 $causer = ['uid' => 0, 'id' => $row['causer-id'], 'network' => $row['causer-network'], 'url' => $row['causer-link']];
887 $row['reshared'] = $this->l10n->t('%s reshared this.', '<a href="'. htmlentities(Contact::magicLinkByContact($causer)) .'">' . htmlentities($row['causer-name']) . '</a>');
889 $row['direction'] = ['direction' => 3, 'title' => (empty($row['causer-id']) ? $this->l10n->t('Reshared') : $this->l10n->t('Reshared by %s <%s>', $row['causer-name'], $row['causer-link']))];
891 case ItemModel::PR_COMMENT:
892 $row['direction'] = ['direction' => 5, 'title' => $this->l10n->t('%s is participating in this thread.', $row['author-name'])];
894 case ItemModel::PR_STORED:
895 $row['direction'] = ['direction' => 8, 'title' => $this->l10n->t('Stored for general reasons')];
897 case ItemModel::PR_GLOBAL:
898 $row['direction'] = ['direction' => 9, 'title' => $this->l10n->t('Global post')];
900 case ItemModel::PR_RELAY:
901 $row['direction'] = ['direction' => 10, 'title' => (empty($row['causer-id']) ? $this->l10n->t('Sent via an relay server') : $this->l10n->t('Sent via the relay server %s <%s>', $row['causer-name'], $row['causer-link']))];
903 case ItemModel::PR_FETCHED:
904 $row['direction'] = ['direction' => 2, 'title' => (empty($row['causer-id']) ? $this->l10n->t('Fetched') : $this->l10n->t('Fetched because of %s <%s>', $row['causer-name'], $row['causer-link']))];
906 case ItemModel::PR_COMPLETION:
907 $row['direction'] = ['direction' => 2, 'title' => $this->l10n->t('Stored because of a child post to complete this thread.')];
909 case ItemModel::PR_DIRECT:
910 $row['direction'] = ['direction' => 6, 'title' => $this->l10n->t('Local delivery')];
912 case ItemModel::PR_ACTIVITY:
913 $row['direction'] = ['direction' => 2, 'title' => $this->l10n->t('Stored because of your activity (like, comment, star, ...)')];
915 case ItemModel::PR_DISTRIBUTE:
916 $row['direction'] = ['direction' => 6, 'title' => $this->l10n->t('Distributed')];
918 case ItemModel::PR_PUSHED:
919 $row['direction'] = ['direction' => 1, 'title' => $this->l10n->t('Pushed to us')];
923 $row['thr-parent-row'] = $thr_parent;
925 $this->profiler->stopRecording();
930 * Add comments to top level entries that had been fetched before
932 * The system will fetch the comments for the local user whenever possible.
933 * This behaviour is currently needed to allow commenting on Friendica posts.
935 * @param array $parents Parent items
936 * @param bool $block_authors
939 * @param string $mode
940 * @return array items with parents and comments
941 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
943 private function addChildren(array $parents, bool $block_authors, string $order, int $uid, string $mode): array
945 $this->profiler->startRecording('rendering');
946 if (count($parents) > 1) {
947 $max_comments = $this->config->get('system', 'max_comments', 100);
949 $max_comments = $this->config->get('system', 'max_display_comments', 1000);
954 $commentcounter = [];
955 $activitycounter = [];
957 foreach ($parents as $parent) {
958 if (!empty($parent['thr-parent-id']) && !empty($parent['gravity']) && ($parent['gravity'] == ItemModel::GRAVITY_ACTIVITY)) {
959 $uriid = $parent['thr-parent-id'];
960 if (!empty($parent['author-id'])) {
961 $activities[$uriid] = ['causer-id' => $parent['author-id']];
962 foreach (['commented', 'received', 'created'] as $orderfields) {
963 if (!empty($parent[$orderfields])) {
964 $activities[$uriid][$orderfields] = $parent[$orderfields];
969 $uriid = $parent['uri-id'];
973 $commentcounter[$uriid] = 0;
974 $activitycounter[$uriid] = 0;
977 $condition = ['parent-uri-id' => $uriids];
978 if ($block_authors) {
979 $condition['author-hidden'] = false;
982 if ($this->config->get('system', 'emoji_activities')) {
983 $emojis = $this->getEmojis($uriids);
984 $condition = DBA::mergeConditions($condition, ["(`gravity` != ? OR `origin`)", ItemModel::GRAVITY_ACTIVITY]);
987 $condition = DBA::mergeConditions($condition,
988 ["`uid` IN (0, ?) AND (NOT `vid` IN (?, ?, ?) OR `vid` IS NULL)", $uid, Verb::getID(Activity::FOLLOW), Verb::getID(Activity::VIEW), Verb::getID(Activity::READ)]);
990 $condition = DBA::mergeConditions($condition,
991 ["`visible` AND NOT `deleted` AND NOT `author-blocked` AND NOT `owner-blocked`
992 AND ((NOT `contact-pending` AND (`contact-rel` IN (?, ?))) OR `self` OR `contact-uid` = ?)",
993 Contact::SHARING, Contact::FRIEND, 0]);
995 $thread_parents = Post::select(['uri-id', 'causer-id'], $condition, ['order' => ['uri-id' => false, 'uid']]);
999 while ($row = Post::fetch($thread_parents)) {
1000 $thr_parent[$row['uri-id']] = $row;
1002 DBA::close($thread_parents);
1004 $params = ['order' => ['uri-id' => true, 'uid' => true]];
1006 $thread_items = Post::select(array_merge(ItemModel::DISPLAY_FIELDLIST, ['featured', 'contact-uid', 'gravity', 'post-type', 'post-reason']), $condition, $params);
1009 $quote_uri_ids = [];
1012 while ($row = Post::fetch($thread_items)) {
1013 if (!empty($items[$row['uri-id']]) && ($row['uid'] == 0)) {
1017 if (($mode != self::MODE_CONTACTS) && !$row['origin']) {
1018 $row['featured'] = false;
1021 if ($max_comments > 0) {
1022 if (($row['gravity'] == ItemModel::GRAVITY_COMMENT) && (++$commentcounter[$row['parent-uri-id']] > $max_comments)) {
1025 if (($row['gravity'] == ItemModel::GRAVITY_ACTIVITY) && (++$activitycounter[$row['parent-uri-id']] > $max_comments)) {
1030 $authors[] = $row['author-id'];
1031 $authors[] = $row['owner-id'];
1033 if (in_array($row['gravity'], [ItemModel::GRAVITY_PARENT, ItemModel::GRAVITY_COMMENT])) {
1034 $quote_uri_ids[$row['uri-id']] = [
1035 'uri-id' => $row['uri-id'],
1036 'uri' => $row['uri'],
1037 'parent-uri-id' => $row['parent-uri-id'],
1038 'parent-uri' => $row['parent-uri'],
1042 $items[$row['uri-id']] = $this->addRowInformation($row, $activities[$row['uri-id']] ?? [], $thr_parent[$row['thr-parent-id']] ?? []);
1045 DBA::close($thread_items);
1047 $quotes = Post::select(array_merge(ItemModel::DISPLAY_FIELDLIST, ['featured', 'contact-uid', 'gravity', 'post-type', 'post-reason']), ['quote-uri-id' => array_column($quote_uri_ids, 'uri-id'), 'body' => '', 'uid' => 0]);
1048 while ($quote = Post::fetch($quotes)) {
1052 $row['verb'] = $row['body'] = $row['raw-body'] = Activity::ANNOUNCE;
1053 $row['gravity'] = ItemModel::GRAVITY_ACTIVITY;
1054 $row['object-type'] = Activity\ObjectType::NOTE;
1055 $row['parent-uri'] = $quote_uri_ids[$quote['quote-uri-id']]['parent-uri'];
1056 $row['parent-uri-id'] = $quote_uri_ids[$quote['quote-uri-id']]['parent-uri-id'];
1057 $row['thr-parent'] = $quote_uri_ids[$quote['quote-uri-id']]['uri'];
1058 $row['thr-parent-id'] = $quote_uri_ids[$quote['quote-uri-id']]['uri-id'];
1060 $authors[] = $row['author-id'];
1061 $authors[] = $row['owner-id'];
1063 $items[$row['uri-id']] = $this->addRowInformation($row, [], []);
1065 DBA::close($quotes);
1067 $authors = array_unique($authors);
1072 if (!empty($authors)) {
1073 $usercontacts = DBA::select('user-contact', ['cid', 'blocked', 'ignored', 'collapsed'], ['uid' => $uid, 'cid' => $authors]);
1074 while ($usercontact = DBA::fetch($usercontacts)) {
1075 if ($usercontact['blocked']) {
1076 $blocks[] = $usercontact['cid'];
1078 if ($usercontact['ignored']) {
1079 $ignores[] = $usercontact['cid'];
1081 if ($usercontact['collapsed']) {
1082 $collapses[] = $usercontact['cid'];
1085 DBA::close($usercontacts);
1088 foreach ($items as $key => $row) {
1089 $items[$key]['emojis'] = $emojis[$key] ?? [];
1091 $always_display = in_array($mode, [self::MODE_CONTACTS, self::MODE_CONTACT_POSTS]);
1093 $items[$key]['user-blocked-author'] = !$always_display && in_array($row['author-id'], $blocks);
1094 $items[$key]['user-ignored-author'] = !$always_display && in_array($row['author-id'], $ignores);
1095 $items[$key]['user-blocked-owner'] = !$always_display && in_array($row['owner-id'], $blocks);
1096 $items[$key]['user-ignored-owner'] = !$always_display && in_array($row['owner-id'], $ignores);
1097 $items[$key]['user-collapsed-author'] = !$always_display && in_array($row['author-id'], $collapses);
1098 $items[$key]['user-collapsed-owner'] = !$always_display && in_array($row['owner-id'], $collapses);
1100 if (in_array($mode, [self::MODE_COMMUNITY, self::MODE_NETWORK]) &&
1101 (in_array($row['author-id'], $blocks) || in_array($row['owner-id'], $blocks) || in_array($row['author-id'], $ignores) || in_array($row['owner-id'], $ignores))) {
1102 unset($items[$key]);
1106 $items = $this->convSort($items, $order);
1108 $this->profiler->stopRecording();
1113 * Fetch emoji reaction from the conversation
1115 * @param array $uriids
1118 private function getEmojis(array $uriids): array
1121 Activity::LIKE => '👍',
1122 Activity::DISLIKE => '👎',
1123 Activity::ATTEND => '✔️',
1124 Activity::ATTENDMAYBE => '❓',
1125 Activity::ATTENDNO => '❌',
1126 Activity::ANNOUNCE => '♻',
1127 Activity::VIEW => '📺',
1130 $index_list = array_values($activity_emoji);
1131 $verbs = array_merge(array_keys($activity_emoji), [Activity::EMOJIREACT]);
1133 $condition = DBA::mergeConditions(['parent-uri-id' => $uriids, 'gravity' => ItemModel::GRAVITY_ACTIVITY, 'verb' => $verbs], ["NOT `deleted`"]);
1134 $separator = chr(255) . chr(255) . chr(255);
1136 $sql = "SELECT `thr-parent-id`, `body`, `verb`, COUNT(*) AS `total`, GROUP_CONCAT(REPLACE(`author-name`, '" . $separator . "', ' ') SEPARATOR '". $separator ."' LIMIT 50) AS `title` FROM `post-view` WHERE " . array_shift($condition) . " GROUP BY `thr-parent-id`, `verb`, `body`";
1140 $rows = DBA::p($sql, $condition);
1141 while ($row = DBA::fetch($rows)) {
1142 $row['verb'] = $row['body'] ? Activity::EMOJIREACT : $row['verb'];
1143 $emoji = $row['body'] ?: $activity_emoji[$row['verb']];
1144 if (!isset($index_list[$emoji])) {
1145 $index_list[] = $emoji;
1147 $index = array_search($emoji, $index_list);
1149 $emojis[$row['thr-parent-id']][$index]['emoji'] = $emoji;
1150 $emojis[$row['thr-parent-id']][$index]['verb'] = $row['verb'];
1151 $emojis[$row['thr-parent-id']][$index]['total'] = $emojis[$row['thr-parent-id']][$emoji]['total'] ?? 0 + $row['total'];
1152 $emojis[$row['thr-parent-id']][$index]['title'] = array_unique(array_merge($emojis[$row['thr-parent-id']][$emoji]['title'] ?? [], explode($separator, $row['title'])));
1160 * Plucks the children of the given parent from a given item list.
1162 * @param array $item_list
1163 * @param array $parent
1164 * @param bool $recursive
1167 private function getItemChildren(array &$item_list, array $parent, bool $recursive = true): array
1169 $this->profiler->startRecording('rendering');
1171 foreach ($item_list as $i => $item) {
1172 if ($item['gravity'] != ItemModel::GRAVITY_PARENT) {
1174 // Fallback to parent-uri if thr-parent is not set
1175 $thr_parent = $item['thr-parent-id'];
1176 if ($thr_parent == '') {
1177 $thr_parent = $item['parent-uri-id'];
1180 if ($thr_parent == $parent['uri-id']) {
1181 $item['children'] = $this->getItemChildren($item_list, $item);
1183 $children[] = $item;
1184 unset($item_list[$i]);
1186 } elseif ($item['parent-uri-id'] == $parent['uri-id']) {
1187 $children[] = $item;
1188 unset($item_list[$i]);
1192 $this->profiler->stopRecording();
1197 * Recursively sorts a tree-like item array
1199 * @param array $items
1202 private function sortItemChildren(array $items): array
1204 $this->profiler->startRecording('rendering');
1206 usort($result, [$this, 'sortThrReceivedRev']);
1207 foreach ($result as $k => $i) {
1208 if (isset($result[$k]['children'])) {
1209 $result[$k]['children'] = $this->sortItemChildren($result[$k]['children']);
1212 $this->profiler->stopRecording();
1217 * Recursively add all children items at the top level of a list
1219 * @param array $children List of items to append
1220 * @param array $item_list
1222 private function addChildrenToList(array $children, array &$item_list)
1224 foreach ($children as $child) {
1225 $item_list[] = $child;
1226 if (isset($child['children'])) {
1227 $this->addChildrenToList($child['children'], $item_list);
1233 * Selectively flattens a tree-like item structure to prevent threading stairs
1235 * This recursive function takes the item tree structure created by conv_sort() and
1236 * flatten the extraneous depth levels when people reply sequentially, removing the
1237 * stairs effect in threaded conversations limiting the available content width.
1239 * The basic principle is the following: if a post item has only one reply and is
1240 * the last reply of its parent, then the reply is moved to the parent.
1242 * This process is rendered somewhat more complicated because items can be either
1243 * replies or likes, and these don't factor at all in the reply count/last reply.
1245 * @param array $parent A tree-like array of items
1248 private function smartFlattenConversation(array $parent): array
1250 $this->profiler->startRecording('rendering');
1251 if (!isset($parent['children']) || count($parent['children']) == 0) {
1252 $this->profiler->stopRecording();
1256 // We use a for loop to ensure we process the newly-moved items
1257 for ($i = 0; $i < count($parent['children']); $i++) {
1258 $child = $parent['children'][$i];
1260 if (isset($child['children']) && count($child['children'])) {
1261 // This helps counting only the regular posts
1262 $count_post_closure = function ($var) {
1263 $this->profiler->stopRecording();
1264 return $var['verb'] === Activity::POST;
1267 $child_post_count = count(array_filter($child['children'], $count_post_closure));
1269 $remaining_post_count = count(array_filter(array_slice($parent['children'], $i), $count_post_closure));
1271 // If there's only one child's children post and this is the last child post
1272 if ($child_post_count == 1 && $remaining_post_count == 1) {
1274 // Searches the post item in the children
1276 while ($child['children'][$j]['verb'] !== Activity::POST && $j < count($child['children'])) {
1280 $moved_item = $child['children'][$j];
1281 unset($parent['children'][$i]['children'][$j]);
1282 $parent['children'][] = $moved_item;
1284 $parent['children'][$i] = $this->smartFlattenConversation($child);
1289 $this->profiler->stopRecording();
1294 * Expands a flat list of items into corresponding tree-like conversation structures.
1296 * sort the top-level posts either on "received" or "commented", and finally
1297 * append all the items at the top level (???)
1299 * @param array $item_list A list of items belonging to one or more conversations
1300 * @param string $order Either on "received" or "commented"
1302 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1304 private function convSort(array $item_list, string $order): array
1306 $this->profiler->startRecording('rendering');
1309 if (!(is_array($item_list) && count($item_list))) {
1310 $this->profiler->stopRecording();
1314 $blocklist = $this->getBlocklist();
1318 // Dedupes the item list on the uri to prevent infinite loops
1319 foreach ($item_list as $item) {
1320 if (in_array($item['author-id'], $blocklist)) {
1324 $item_array[$item['uri-id']] = $item;
1327 // Extract the top level items
1328 foreach ($item_array as $item) {
1329 if ($item['gravity'] == ItemModel::GRAVITY_PARENT) {
1334 if (stristr($order, 'pinned_received')) {
1335 usort($parents, [$this, 'sortThrFeaturedReceived']);
1336 } elseif (stristr($order, 'pinned_commented')) {
1337 usort($parents, [$this, 'sortThrFeaturedCommented']);
1338 } elseif (stristr($order, 'received')) {
1339 usort($parents, [$this, 'sortThrReceived']);
1340 } elseif (stristr($order, 'commented')) {
1341 usort($parents, [$this, 'sortThrCommented']);
1342 } elseif (stristr($order, 'created')) {
1343 usort($parents, [$this, 'sortThrCreated']);
1347 * Plucks children from the item_array, second pass collects eventual orphan
1348 * items and add them as children of their top-level post.
1350 foreach ($parents as $i => $parent) {
1351 $parents[$i]['children'] = array_merge($this->getItemChildren($item_array, $parent, true),
1352 $this->getItemChildren($item_array, $parent, false));
1355 foreach ($parents as $i => $parent) {
1356 $parents[$i]['children'] = $this->sortItemChildren($parents[$i]['children']);
1359 if (!$this->pConfig->get($this->session->getLocalUserId(), 'system', 'no_smart_threading', 0)) {
1360 foreach ($parents as $i => $parent) {
1361 $parents[$i] = $this->smartFlattenConversation($parent);
1365 /// @TODO: Stop recusrsively adding all children back to the top level (!!!)
1366 /// However, this apparently ensures responses (likes, attendance) display (?!)
1367 foreach ($parents as $parent) {
1368 if (count($parent['children'])) {
1369 $this->addChildrenToList($parent['children'], $parents);
1373 $this->profiler->stopRecording();
1378 * usort() callback to sort item arrays by featured and the received key
1384 private function sortThrFeaturedReceived(array $a, array $b): int
1386 if ($b['featured'] && !$a['featured']) {
1388 } elseif (!$b['featured'] && $a['featured']) {
1392 return strcmp($b['received'], $a['received']);
1396 * usort() callback to sort item arrays by featured and the received key
1402 private function sortThrFeaturedCommented(array $a, array $b): int
1404 if ($b['featured'] && !$a['featured']) {
1406 } elseif (!$b['featured'] && $a['featured']) {
1410 return strcmp($b['commented'], $a['commented']);
1414 * usort() callback to sort item arrays by the received key
1420 private function sortThrReceived(array $a, array $b): int
1422 return strcmp($b['received'], $a['received']);
1426 * usort() callback to reverse sort item arrays by the received key
1432 private function sortThrReceivedRev(array $a, array $b): int
1434 return strcmp($a['received'], $b['received']);
1438 * usort() callback to sort item arrays by the commented key
1444 private function sortThrCommented(array $a, array $b): int
1446 return strcmp($b['commented'], $a['commented']);
1450 * usort() callback to sort item arrays by the created key
1456 private function sortThrCreated(array $a, array $b): int
1458 return strcmp($b['created'], $a['created']);