3 * @file src/Content/Widget.php
5 namespace Friendica\Content;
7 use Friendica\Core\Addon;
8 use Friendica\Core\Config;
9 use Friendica\Core\L10n;
10 use Friendica\Core\PConfig;
11 use Friendica\Core\Protocol;
12 use Friendica\Core\Renderer;
13 use Friendica\Core\System;
14 use Friendica\Core\Session;
15 use Friendica\Database\DBA;
16 use Friendica\Model\Contact;
17 use Friendica\Model\FileTag;
18 use Friendica\Model\GContact;
19 use Friendica\Model\Item;
20 use Friendica\Model\Profile;
21 use Friendica\Util\DateTimeFormat;
22 use Friendica\Util\Proxy as ProxyUtils;
23 use Friendica\Util\Strings;
24 use Friendica\Util\Temporal;
25 use Friendica\Util\XML;
30 * Return the follow widget
32 * @param string $value optional, default empty
34 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
36 public static function follow($value = "")
38 return Renderer::replaceMacros(Renderer::getMarkupTemplate('widget/follow.tpl'), array(
39 '$connect' => L10n::t('Add New Contact'),
40 '$desc' => L10n::t('Enter address or web location'),
41 '$hint' => L10n::t('Example: bob@example.com, http://example.com/barbara'),
43 '$follow' => L10n::t('Connect')
48 * Return Find People widget
50 public static function findPeople()
53 $global_dir = Config::get('system', 'directory');
55 if (Config::get('system', 'invitation_only')) {
56 $x = intval(PConfig::get(local_user(), 'system', 'invites_remaining'));
57 if ($x || is_site_admin()) {
58 $a->page['aside'] .= '<div class="side-link widget" id="side-invite-remain">'
59 . L10n::tt('%d invitation available', '%d invitations available', $x)
65 $nv['findpeople'] = L10n::t('Find People');
66 $nv['desc'] = L10n::t('Enter name or interest');
67 $nv['label'] = L10n::t('Connect/Follow');
68 $nv['hint'] = L10n::t('Examples: Robert Morgenstein, Fishing');
69 $nv['findthem'] = L10n::t('Find');
70 $nv['suggest'] = L10n::t('Friend Suggestions');
71 $nv['similar'] = L10n::t('Similar Interests');
72 $nv['random'] = L10n::t('Random Profile');
73 $nv['inv'] = L10n::t('Invite Friends');
74 $nv['directory'] = L10n::t('Global Directory');
75 $nv['global_dir'] = $global_dir;
76 $nv['local_directory'] = L10n::t('Local Directory');
81 return Renderer::replaceMacros(Renderer::getMarkupTemplate('widget/peoplefind.tpl'), $aside);
85 * Return unavailable networks
87 public static function unavailableNetworks()
89 // Always hide content from these networks
90 $networks = ['face', 'apdn'];
92 if (!Addon::isEnabled("discourse")) {
93 $networks[] = Protocol::DISCOURSE;
96 if (!Addon::isEnabled("statusnet")) {
97 $networks[] = Protocol::STATUSNET;
100 if (!Addon::isEnabled("pumpio")) {
101 $networks[] = Protocol::PUMPIO;
104 if (!Addon::isEnabled("twitter")) {
105 $networks[] = Protocol::TWITTER;
108 if (Config::get("system", "ostatus_disabled")) {
109 $networks[] = Protocol::OSTATUS;
112 if (!Config::get("system", "diaspora_enabled")) {
113 $networks[] = Protocol::DIASPORA;
116 if (!Addon::isEnabled("pnut")) {
117 $networks[] = Protocol::PNUT;
120 if (!sizeof($networks)) {
124 $network_filter = implode("','", $networks);
126 $network_filter = "AND `network` NOT IN ('$network_filter')";
128 return $network_filter;
132 * Display a generic filter widget based on a list of options
134 * The options array must be the following format:
137 * 'ref' => {filter value},
138 * 'name' => {option name}
143 * @param string $type The filter query string key
144 * @param string $title
145 * @param string $desc
146 * @param string $all The no filter label
147 * @param string $baseUrl The full page request URI
148 * @param array $options
149 * @param string $selected The currently selected filter option value
153 private static function filter($type, $title, $desc, $all, $baseUrl, array $options, $selected = null)
155 $queryString = parse_url($baseUrl, PHP_URL_QUERY);
159 parse_str($queryString, $queryArray);
160 unset($queryArray[$type]);
162 if (count($queryArray)) {
163 $baseUrl = substr($baseUrl, 0, strpos($baseUrl, '?')) . '?' . http_build_query($queryArray) . '&';
165 $baseUrl = substr($baseUrl, 0, strpos($baseUrl, '?')) . '?';
168 $baseUrl = trim($baseUrl, '?') . '?';
171 return Renderer::replaceMacros(Renderer::getMarkupTemplate('widget/filter.tpl'), [
175 '$selected' => $selected,
176 '$all_label' => $all,
177 '$options' => $options,
183 * Return networks widget
185 * @param string $baseurl baseurl
186 * @param string $selected optional, default empty
190 public static function contactRels($baseurl, $selected = '')
197 ['ref' => 'followers', 'name' => L10n::t('Followers')],
198 ['ref' => 'following', 'name' => L10n::t('Following')],
199 ['ref' => 'mutuals', 'name' => L10n::t('Mutual friends')],
204 L10n::t('Relationships'),
206 L10n::t('All Contacts'),
214 * Return networks widget
216 * @param string $baseurl baseurl
217 * @param string $selected optional, default empty
219 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
221 public static function networks($baseurl, $selected = '')
227 if (!Feature::isEnabled(local_user(), 'networks')) {
231 $extra_sql = self::unavailableNetworks();
233 $r = DBA::p("SELECT DISTINCT(`network`) FROM `contact` WHERE `uid` = ? AND NOT `deleted` AND `network` != '' $extra_sql ORDER BY `network`",
238 while ($rr = DBA::fetch($r)) {
239 $nets[] = ['ref' => $rr['network'], 'name' => ContactSelector::networkToName($rr['network'])];
243 if (count($nets) < 2) {
249 L10n::t('Protocols'),
251 L10n::t('All Protocols'),
259 * Return file as widget
261 * @param string $baseurl baseurl
262 * @param string $selected optional, default empty
263 * @return string|void
266 public static function fileAs($baseurl, $selected = '')
272 $saved = PConfig::get(local_user(), 'system', 'filetags');
273 if (!strlen($saved)) {
278 foreach (FileTag::fileToArray($saved) as $savedFolderName) {
279 $terms[] = ['ref' => $savedFolderName, 'name' => $savedFolderName];
282 usort($terms, function ($a, $b) {
283 return strcmp($a['name'], $b['name']);
288 L10n::t('Saved Folders'),
290 L10n::t('Everything'),
298 * Return categories widget
300 * @param string $baseurl baseurl
301 * @param string $selected optional, default empty
302 * @return string|void
303 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
305 public static function categories($baseurl, $selected = '')
309 $uid = intval($a->profile['profile_uid']);
311 if (!Feature::isEnabled($uid, 'categories')) {
315 $saved = PConfig::get($uid, 'system', 'filetags');
316 if (!strlen($saved)) {
321 foreach (FileTag::fileToArray($saved, 'category') as $savedFolderName) {
322 $terms[] = ['ref' => $savedFolderName, 'name' => $savedFolderName];
327 L10n::t('Categories'),
329 L10n::t('Everything'),
337 * Return common friends visitor widget
339 * @param string $profile_uid uid
340 * @return string|void
341 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
343 public static function commonFriendsVisitor($profile_uid)
345 if (local_user() == $profile_uid) {
351 $cid = Session::getRemoteContactID($profile_uid);
354 if (Profile::getMyURL()) {
355 $contact = DBA::selectFirst('contact', ['id'],
356 ['nurl' => Strings::normaliseLink(Profile::getMyURL()), 'uid' => $profile_uid]);
357 if (DBA::isResult($contact)) {
358 $cid = $contact['id'];
360 $gcontact = DBA::selectFirst('gcontact', ['id'], ['nurl' => Strings::normaliseLink(Profile::getMyURL())]);
361 if (DBA::isResult($gcontact)) {
362 $zcid = $gcontact['id'];
368 if ($cid == 0 && $zcid == 0) {
373 $t = GContact::countCommonFriends($profile_uid, $cid);
375 $t = GContact::countCommonFriendsZcid($profile_uid, $zcid);
383 $r = GContact::commonFriends($profile_uid, $cid, 0, 5, true);
385 $r = GContact::commonFriendsZcid($profile_uid, $zcid, 0, 5, true);
388 if (!DBA::isResult($r)) {
393 foreach ($r as $rr) {
395 'url' => Contact::magicLink($rr['url']),
396 'name' => $rr['name'],
397 'photo' => ProxyUtils::proxifyUrl($rr['photo'], false, ProxyUtils::SIZE_THUMB),
402 $tpl = Renderer::getMarkupTemplate('widget/remote_friends_common.tpl');
403 return Renderer::replaceMacros($tpl, [
404 '$desc' => L10n::tt("%d contact in common", "%d contacts in common", $t),
405 '$base' => System::baseUrl(),
406 '$uid' => $profile_uid,
407 '$cid' => (($cid) ? $cid : '0'),
408 '$linkmore' => (($t > 5) ? 'true' : ''),
409 '$more' => L10n::t('show more'),
415 * Insert a tag cloud widget for the present profile.
417 * @brief Insert a tag cloud widget for the present profile.
418 * @param int $limit Max number of displayed tags.
419 * @return string HTML formatted output.
420 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
421 * @throws \ImagickException
423 public static function tagCloud($limit = 50)
427 $uid = intval($a->profile['profile_uid']);
429 if (!$uid || !$a->profile['url']) {
433 if (Feature::isEnabled($uid, 'tagadelic')) {
434 $owner_id = Contact::getIdForURL($a->profile['url'], 0, true);
439 return Widget\TagCloud::getHTML($uid, $limit, $owner_id, 'wall');
446 * @param string $url Base page URL
447 * @param int $uid User ID consulting/publishing posts
448 * @param bool $wall True: Posted by User; False: Posted to User (network timeline)
450 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
452 public static function postedByYear(string $url, int $uid, bool $wall)
456 if (!Feature::isEnabled($uid, 'archives')) {
460 $visible_years = PConfig::get($uid, 'system', 'archive_visible_years', 5);
462 /* arrange the list in years */
463 $dnow = DateTimeFormat::localNow('Y-m-d');
467 $dthen = Item::firstPostDate($uid, $wall);
469 // Set the start and end date to the beginning of the month
470 $dnow = substr($dnow, 0, 8) . '01';
471 $dthen = substr($dthen, 0, 8) . '01';
474 * Starting with the current month, get the first and last days of every
475 * month down to and including the month of the first post
477 while (substr($dnow, 0, 7) >= substr($dthen, 0, 7)) {
478 $dyear = intval(substr($dnow, 0, 4));
479 $dstart = substr($dnow, 0, 8) . '01';
480 $dend = substr($dnow, 0, 8) . Temporal::getDaysInMonth(intval($dnow), intval(substr($dnow, 5)));
481 $start_month = DateTimeFormat::utc($dstart, 'Y-m-d');
482 $end_month = DateTimeFormat::utc($dend, 'Y-m-d');
483 $str = L10n::getDay(DateTimeFormat::utc($dnow, 'F'));
485 if (empty($ret[$dyear])) {
489 $ret[$dyear][] = [$str, $end_month, $start_month];
490 $dnow = DateTimeFormat::utc($dnow . ' -1 month', 'Y-m-d');
494 if (!DBA::isResult($ret)) {
499 $cutoff_year = intval(DateTimeFormat::localNow('Y')) - $visible_years;
500 $cutoff = array_key_exists($cutoff_year, $ret);
502 $o = Renderer::replaceMacros(Renderer::getMarkupTemplate('widget/posted_date.tpl'),[
503 '$title' => L10n::t('Archives'),
504 '$size' => $visible_years,
505 '$cutoff_year' => $cutoff_year,
506 '$cutoff' => $cutoff,
509 '$showmore' => L10n::t('show more')