3 * @file src/Content/ForumManager.php
4 * @brief ForumManager class with its methods related to forum functionality
6 namespace Friendica\Content;
8 use Friendica\Core\Protocol;
9 use Friendica\Content\Text\HTML;
10 use Friendica\Core\L10n;
11 use Friendica\Core\Renderer;
12 use Friendica\Core\System;
13 use Friendica\Database\DBA;
14 use Friendica\Model\Contact;
15 use Friendica\Util\Proxy as ProxyUtils;
18 * @brief This class handles methods related to the forum functionality
23 * @brief Function to list all forums a user is connected with
25 * @param int $uid of the profile owner
26 * @param boolean $lastitem Sort by lastitem
27 * @param boolean $showhidden Show frorums which are not hidden
28 * @param boolean $showprivate Show private groups
32 * 'name' => forum name
33 * 'id' => number of the key from the array
34 * 'micro' => contact photo in format micro
35 * 'thumb' => contact photo in format thumb
38 public static function getList($uid, $lastitem, $showhidden = true, $showprivate = false)
41 $params = ['order' => ['last-item' => true]];
43 $params = ['order' => ['name']];
46 $condition_str = "`network` = ? AND `uid` = ? AND NOT `blocked` AND NOT `pending` AND NOT `archive` AND `success_update` > `failure_update` AND ";
49 $condition_str .= '(`forum` OR `prv`)';
51 $condition_str .= '`forum`';
55 $condition_str .= ' AND NOT `hidden`';
60 $fields = ['id', 'url', 'name', 'micro', 'thumb'];
61 $condition = [$condition_str, Protocol::DFRN, $uid];
62 $contacts = DBA::select('contact', $fields, $condition, $params);
67 while ($contact = DBA::fetch($contacts)) {
69 'url' => $contact['url'],
70 'name' => $contact['name'],
71 'id' => $contact['id'],
72 'micro' => $contact['micro'],
73 'thumb' => $contact['thumb'],
76 DBA::close($contacts);
83 * @brief Forumlist widget
85 * Sidebar widget to show subcribed friendica forums. If activated
86 * in the settings, it appears at the notwork page sidebar
88 * @param int $uid The ID of the User
89 * @param int $cid The contact id which is used to mark a forum as "selected"
91 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
92 * @throws \ImagickException
94 public static function widget($uid, $cid = 0)
98 //sort by last updated item
101 $contacts = self::getList($uid, $lastitem, true, true);
102 $total = count($contacts);
103 $visible_forums = 10;
105 if (DBA::isResult($contacts)) {
108 foreach ($contacts as $contact) {
109 $selected = (($cid == $contact['id']) ? ' forum-selected' : '');
112 'url' => 'network?f=&cid=' . $contact['id'],
113 'external_url' => Contact::magicLink($contact['url']),
114 'name' => $contact['name'],
115 'cid' => $contact['id'],
116 'selected' => $selected,
117 'micro' => System::removedBaseUrl(ProxyUtils::proxifyUrl($contact['micro'], false, ProxyUtils::SIZE_MICRO)),
123 $tpl = Renderer::getMarkupTemplate('widget_forumlist.tpl');
125 $o .= Renderer::replaceMacros(
128 '$title' => L10n::t('Forums'),
129 '$forums' => $entries,
130 '$link_desc' => L10n::t('External link to forum'),
132 '$visible_forums' => $visible_forums,
133 '$showmore' => L10n::t('show more')]
141 * @brief Format forumlist as contact block
143 * This function is used to show the forumlist in
144 * the advanced profile.
146 * @param int $uid The ID of the User
148 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
149 * @throws \ImagickException
151 public static function profileAdvanced($uid)
153 $profile = intval(Feature::isEnabled($uid, 'forumlist_profile'));
160 // place holder in case somebody wants configurability
163 //don't sort by last updated item
166 $contacts = self::getList($uid, $lastitem, false, false);
170 foreach ($contacts as $contact) {
171 $forumlist .= HTML::micropro($contact, false, 'forumlist-profile-advanced');
173 if ($total_shown == $show_total) {
178 if (count($contacts) > 0) {
185 * @brief count unread forum items
187 * Count unread items of connected forums and private groups
191 * 'name' => contact/forum name
192 * 'count' => counted unseen forum items
195 public static function countUnseenItems()
198 "SELECT `contact`.`id`, `contact`.`name`, COUNT(*) AS `count` FROM `item`
199 INNER JOIN `contact` ON `item`.`contact-id` = `contact`.`id`
200 WHERE `item`.`uid` = %d AND `item`.`visible` AND NOT `item`.`deleted` AND `item`.`unseen`
201 AND `contact`.`network`= 'dfrn' AND (`contact`.`forum` OR `contact`.`prv`)
202 AND NOT `contact`.`blocked` AND NOT `contact`.`hidden`
203 AND NOT `contact`.`pending` AND NOT `contact`.`archive`
204 AND `contact`.`success_update` > `failure_update`
205 GROUP BY `contact`.`id` ",