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\Model\Contact;
25 use Friendica\Core\Logger;
26 use Friendica\Core\Protocol;
27 use Friendica\Database\Database;
28 use Friendica\Database\DBA;
30 use Friendica\Model\APContact;
31 use Friendica\Model\Contact;
32 use Friendica\Model\Profile;
33 use Friendica\Model\User;
34 use Friendica\Protocol\ActivityPub;
35 use Friendica\Util\DateTimeFormat;
36 use Friendica\Util\Strings;
39 * This class provides relationship information based on the `contact-relation` table.
40 * This table is directional (cid = source, relation-cid = target), references public contacts (with uid=0) and records both
41 * follows and the last interaction (likes/comments) on public posts.
46 * No discovery of followers/followings
48 const DISCOVERY_NONE = 0;
50 * Discover followers/followings of local contacts
52 const DISCOVERY_LOCAL = 1;
54 * Discover followers/followings of local contacts and contacts that visibly interacted on the system
56 const DISCOVERY_INTERACTOR = 2;
58 * Discover followers/followings of all contacts
60 const DISCOVERY_ALL = 3;
62 public static function store(int $target, int $actor, string $interaction_date)
64 if ($actor == $target) {
68 DBA::insert('contact-relation', ['last-interaction' => $interaction_date, 'cid' => $target, 'relation-cid' => $actor], Database::INSERT_UPDATE);
72 * Fetches the followers of a given profile and adds them
74 * @param string $url URL of a profile
77 public static function discoverByUrl(string $url)
79 $contact = Contact::getByURL($url);
80 if (empty($contact)) {
81 Logger::info('Contact not found', ['url' => $url]);
85 if (!self::isDiscoverable($url, $contact)) {
86 Logger::info('Contact is not discoverable', ['url' => $url]);
90 $uid = User::getIdForURL($url);
92 Logger::info('Fetch the followers/followings locally', ['url' => $url]);
93 $followers = self::getContacts($uid, [Contact::FOLLOWER, Contact::FRIEND]);
94 $followings = self::getContacts($uid, [Contact::SHARING, Contact::FRIEND]);
95 } elseif (!Contact::isLocal($url)) {
96 Logger::info('Fetch the followers/followings by polling the endpoints', ['url' => $url]);
97 $apcontact = APContact::getByURL($url, false);
99 if (!empty($apcontact['followers']) && is_string($apcontact['followers'])) {
100 $followers = ActivityPub::fetchItems($apcontact['followers']);
105 if (!empty($apcontact['following']) && is_string($apcontact['following'])) {
106 $followings = ActivityPub::fetchItems($apcontact['following']);
111 Logger::warning('Contact seems to be local but could not be found here', ['url' => $url]);
116 if (empty($followers) && empty($followings)) {
117 Contact::update(['last-discovery' => DateTimeFormat::utcNow()], ['id' => $contact['id']]);
118 Logger::info('The contact does not offer discoverable data', ['id' => $contact['id'], 'url' => $url, 'network' => $contact['network']]);
122 $target = $contact['id'];
124 if (!empty($followers)) {
125 // Clear the follower list, since it will be recreated in the next step
126 DBA::update('contact-relation', ['follows' => false], ['cid' => $target]);
130 foreach (array_merge($followers, $followings) as $contact) {
131 if (is_string($contact)) {
132 $contacts[] = $contact;
133 } elseif (!empty($contact['url']) && is_string($contact['url'])) {
134 $contacts[] = $contact['url'];
137 $contacts = array_unique($contacts);
139 $follower_counter = 0;
140 $following_counter = 0;
142 Logger::info('Discover contacts', ['id' => $target, 'url' => $url, 'contacts' => count($contacts)]);
143 foreach ($contacts as $contact) {
144 $actor = Contact::getIdForURL($contact);
145 if (!empty($actor)) {
146 if (in_array($contact, $followers)) {
147 $fields = ['cid' => $target, 'relation-cid' => $actor, 'follows' => true, 'follow-updated' => DateTimeFormat::utcNow()];
148 DBA::insert('contact-relation', $fields, Database::INSERT_UPDATE);
152 if (in_array($contact, $followings)) {
153 $fields = ['cid' => $actor, 'relation-cid' => $target, 'follows' => true, 'follow-updated' => DateTimeFormat::utcNow()];
154 DBA::insert('contact-relation', $fields, Database::INSERT_UPDATE);
155 $following_counter++;
160 if (!empty($followers)) {
161 // Delete all followers that aren't followers anymore (and aren't interacting)
162 DBA::delete('contact-relation', ['cid' => $target, 'follows' => false, 'last-interaction' => DBA::NULL_DATETIME]);
165 Contact::update(['last-discovery' => DateTimeFormat::utcNow()], ['id' => $target]);
166 Logger::info('Contacts discovery finished', ['id' => $target, 'url' => $url, 'follower' => $follower_counter, 'following' => $following_counter]);
171 * Fetch contact url list from the given local user
173 * @param integer $uid
175 * @return array contact list
177 private static function getContacts(int $uid, array $rel): array
180 $profile = Profile::getByUID($uid);
181 if (!empty($profile['hide-friends'])) {
194 $condition = DBA::mergeConditions($condition, ["`url` IN (SELECT `url` FROM `apcontact`)"]);
195 $contacts = DBA::select('contact', ['url'], $condition);
196 while ($contact = DBA::fetch($contacts)) {
197 $list[] = $contact['url'];
199 DBA::close($contacts);
205 * Tests if a given contact url is discoverable
207 * @param string $url Contact url
208 * @param array $contact Contact array
209 * @return boolean True if contact is discoverable
211 public static function isDiscoverable(string $url, array $contact = []): bool
213 $contact_discovery = DI::config()->get('system', 'contact_discovery');
215 if ($contact_discovery == self::DISCOVERY_NONE) {
219 if (empty($contact)) {
220 $contact = Contact::getByURL($url, false);
223 if (empty($contact)) {
227 if ($contact['last-discovery'] > DateTimeFormat::utc('now - 1 month')) {
228 Logger::info('No discovery - Last was less than a month ago.', ['id' => $contact['id'], 'url' => $url, 'discovery' => $contact['last-discovery']]);
232 if ($contact_discovery != self::DISCOVERY_ALL) {
233 $local = DBA::exists('contact', ["`nurl` = ? AND `uid` != ?", Strings::normaliseLink($url), 0]);
234 if (($contact_discovery == self::DISCOVERY_LOCAL) && !$local) {
235 Logger::info('No discovery - This contact is not followed/following locally.', ['id' => $contact['id'], 'url' => $url]);
239 if ($contact_discovery == self::DISCOVERY_INTERACTOR) {
240 $interactor = DBA::exists('contact-relation', ["`relation-cid` = ? AND `last-interaction` > ?", $contact['id'], DBA::NULL_DATETIME]);
241 if (!$local && !$interactor) {
242 Logger::info('No discovery - This contact is not interacting locally.', ['id' => $contact['id'], 'url' => $url]);
246 } elseif ($contact['created'] > DateTimeFormat::utc('now - 1 day')) {
247 // Newly created contacts are not discovered to avoid DDoS attacks
248 Logger::info('No discovery - Contact record is less than a day old.', ['id' => $contact['id'], 'url' => $url, 'discovery' => $contact['created']]);
252 if (!in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::OSTATUS])) {
253 $apcontact = APContact::getByURL($url, false);
254 if (empty($apcontact)) {
255 Logger::info('No discovery - The contact does not seem to speak ActivityPub.', ['id' => $contact['id'], 'url' => $url, 'network' => $contact['network']]);
264 * Check if the cached suggestion is outdated
266 * @param integer $uid
269 static public function areSuggestionsOutdated(int $uid): bool
271 return DI::pConfig()->get($uid, 'suggestion', 'last_update') + 3600 < time();
275 * Update contact suggestions for a given user
277 * @param integer $uid
280 static public function updateCachedSuggestions(int $uid)
282 if (!self::areSuggestionsOutdated($uid)) {
286 DBA::delete('account-suggestion', ['uid' => $uid, 'ignore' => false]);
288 foreach (self::getSuggestions($uid) as $contact) {
289 DBA::insert('account-suggestion', ['uri-id' => $contact['uri-id'], 'uid' => $uid, 'level' => 1], Database::INSERT_IGNORE);
292 DI::pConfig()->set($uid, 'suggestion', 'last_update', time());
296 * Returns a cached array of suggested contacts for given user id
298 * @param int $uid User id
299 * @param int $start optional, default 0
300 * @param int $limit optional, default 80
303 static public function getCachedSuggestions(int $uid, int $start = 0, int $limit = 80): array
305 $condition = ["`uid` = ? AND `uri-id` IN (SELECT `uri-id` FROM `account-suggestion` WHERE NOT `ignore` AND `uid` = ?)", 0, $uid];
306 $params = ['limit' => [$start, $limit]];
307 $cached = DBA::selectToArray('contact', [], $condition, $params);
309 if (!empty($cached)) {
312 return self::getSuggestions($uid, $start, $limit);
317 * Returns an array of suggested contacts for given user id
319 * @param int $uid User id
320 * @param int $start optional, default 0
321 * @param int $limit optional, default 80
324 static public function getSuggestions(int $uid, int $start = 0, int $limit = 80): array
326 $cid = Contact::getPublicIdByUserId($uid);
327 $totallimit = $start + $limit;
330 Logger::info('Collecting suggestions', ['uid' => $uid, 'cid' => $cid, 'start' => $start, 'limit' => $limit]);
332 $diaspora = DI::config()->get('system', 'diaspora_enabled') ? Protocol::DIASPORA : Protocol::ACTIVITYPUB;
333 $ostatus = !DI::config()->get('system', 'ostatus_disabled') ? Protocol::OSTATUS : Protocol::ACTIVITYPUB;
335 // The query returns contacts where contacts interacted with whom the given user follows.
336 // Contacts who already are in the user's contact table are ignored.
337 $results = DBA::select('contact', [], ["`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` IN
338 (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ?)
339 AND NOT `cid` IN (SELECT `id` FROM `contact` WHERE `uid` = ? AND `nurl` IN
340 (SELECT `nurl` FROM `contact` WHERE `uid` = ? AND `rel` IN (?, ?))) AND `id` = `cid`)
341 AND NOT `hidden` AND `network` IN (?, ?, ?, ?)
342 AND NOT `uri-id` IN (SELECT `uri-id` FROM `account-suggestion` WHERE `uri-id` = `contact`.`uri-id` AND `uid` = ?)",
345 $uid, Contact::FRIEND, Contact::SHARING,
346 Protocol::ACTIVITYPUB, Protocol::DFRN, $diaspora, $ostatus, $uid
348 'order' => ['last-item' => true],
349 'limit' => $totallimit,
353 while ($contact = DBA::fetch($results)) {
354 $contacts[$contact['id']] = $contact;
357 DBA::close($results);
359 Logger::info('Contacts of contacts who are followed by the given user', ['uid' => $uid, 'cid' => $cid, 'count' => count($contacts)]);
361 if (count($contacts) >= $totallimit) {
362 return array_slice($contacts, $start, $limit);
365 // The query returns contacts where contacts interacted with whom also interacted with the given user.
366 // Contacts who already are in the user's contact table are ignored.
367 $results = DBA::select('contact', [],
368 ["`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` IN
369 (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ?)
370 AND NOT `cid` IN (SELECT `id` FROM `contact` WHERE `uid` = ? AND `nurl` IN
371 (SELECT `nurl` FROM `contact` WHERE `uid` = ? AND `rel` IN (?, ?))) AND `id` = `cid`)
372 AND NOT `hidden` AND `network` IN (?, ?, ?, ?)
373 AND NOT `uri-id` IN (SELECT `uri-id` FROM `account-suggestion` WHERE `uri-id` = `contact`.`uri-id` AND `uid` = ?)",
374 $cid, 0, $uid, Contact::FRIEND, Contact::SHARING,
375 Protocol::ACTIVITYPUB, Protocol::DFRN, $diaspora, $ostatus, $uid],
376 ['order' => ['last-item' => true], 'limit' => $totallimit]
379 while ($contact = DBA::fetch($results)) {
380 $contacts[$contact['id']] = $contact;
382 DBA::close($results);
384 Logger::info('Contacts of contacts who are following the given user', ['uid' => $uid, 'cid' => $cid, 'count' => count($contacts)]);
386 if (count($contacts) >= $totallimit) {
387 return array_slice($contacts, $start, $limit);
390 // The query returns contacts that follow the given user but aren't followed by that user.
391 $results = DBA::select('contact', [],
392 ["`nurl` IN (SELECT `nurl` FROM `contact` WHERE `uid` = ? AND `rel` = ?)
393 AND NOT `hidden` AND `uid` = ? AND `network` IN (?, ?, ?, ?)
394 AND NOT `uri-id` IN (SELECT `uri-id` FROM `account-suggestion` WHERE `uri-id` = `contact`.`uri-id` AND `uid` = ?)",
395 $uid, Contact::FOLLOWER, 0,
396 Protocol::ACTIVITYPUB, Protocol::DFRN, $diaspora, $ostatus, $uid],
397 ['order' => ['last-item' => true], 'limit' => $totallimit]
400 while ($contact = DBA::fetch($results)) {
401 $contacts[$contact['id']] = $contact;
403 DBA::close($results);
405 Logger::info('Followers that are not followed by the given user', ['uid' => $uid, 'cid' => $cid, 'count' => count($contacts)]);
407 if (count($contacts) >= $totallimit) {
408 return array_slice($contacts, $start, $limit);
411 // The query returns any contact that isn't followed by that user.
412 $results = DBA::select('contact', [],
413 ["NOT `nurl` IN (SELECT `nurl` FROM `contact` WHERE `uid` = ? AND `rel` IN (?, ?) AND `nurl` = `nurl`)
414 AND NOT `hidden` AND `uid` = ? AND `network` IN (?, ?, ?, ?)
415 AND NOT `uri-id` IN (SELECT `uri-id` FROM `account-suggestion` WHERE `uri-id` = `contact`.`uri-id` AND `uid` = ?)",
416 $uid, Contact::FRIEND, Contact::SHARING, 0,
417 Protocol::ACTIVITYPUB, Protocol::DFRN, $diaspora, $ostatus, $uid],
418 ['order' => ['last-item' => true], 'limit' => $totallimit]
421 while ($contact = DBA::fetch($results)) {
422 $contacts[$contact['id']] = $contact;
424 DBA::close($results);
426 Logger::info('Any contact', ['uid' => $uid, 'cid' => $cid, 'count' => count($contacts)]);
428 return array_slice($contacts, $start, $limit);
432 * Counts all the known follows of the provided public contact
434 * @param int $cid Public contact id
435 * @param array $condition Additional condition on the contact table
439 public static function countFollows(int $cid, array $condition = []): int
441 $condition = DBA::mergeConditions($condition, [
442 '`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)',
446 return DI::dba()->count('contact', $condition);
450 * Returns a paginated list of contacts that are followed the provided public contact.
452 * @param int $cid Public contact id
453 * @param array $condition Additional condition on the contact table
456 * @param bool $shuffle
460 public static function listFollows(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
462 $condition = DBA::mergeConditions($condition,
463 ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)',
467 return DI::dba()->selectToArray('contact', [], $condition,
468 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
473 * Counts all the known followers of the provided public contact
475 * @param int $cid Public contact id
476 * @param array $condition Additional condition on the contact table
480 public static function countFollowers(int $cid, array $condition = [])
482 $condition = DBA::mergeConditions($condition,
483 ['`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)',
487 return DI::dba()->count('contact', $condition);
491 * Returns a paginated list of contacts that follow the provided public contact.
493 * @param int $cid Public contact id
494 * @param array $condition Additional condition on the contact table
497 * @param bool $shuffle
501 public static function listFollowers(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
503 $condition = DBA::mergeConditions($condition,
504 ['`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)', $cid]
507 return DI::dba()->selectToArray('contact', [], $condition,
508 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
513 * Counts the number of contacts that are known mutuals with the provided public contact.
515 * @param int $cid Public contact id
516 * @param array $condition Additional condition array on the contact table
520 public static function countMutuals(int $cid, array $condition = [])
522 $condition = DBA::mergeConditions($condition,
523 ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
524 AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)',
528 return DI::dba()->count('contact', $condition);
532 * Returns a paginated list of contacts that are known mutuals with the provided public contact.
534 * @param int $cid Public contact id
535 * @param array $condition Additional condition on the contact table
538 * @param bool $shuffle
542 public static function listMutuals(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
544 $condition = DBA::mergeConditions($condition,
545 ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
546 AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)',
550 return DI::dba()->selectToArray('contact', [], $condition,
551 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
557 * Counts the number of contacts with any relationship with the provided public contact.
559 * @param int $cid Public contact id
560 * @param array $condition Additional condition array on the contact table
564 public static function countAll(int $cid, array $condition = [])
566 $condition = DBA::mergeConditions($condition,
567 ['(`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
568 OR `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`))',
572 return DI::dba()->count('contact', $condition);
576 * Returns a paginated list of contacts with any relationship with the provided public contact.
578 * @param int $cid Public contact id
579 * @param array $condition Additional condition on the contact table
582 * @param bool $shuffle
586 public static function listAll(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
588 $condition = DBA::mergeConditions($condition,
589 ['(`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
590 OR `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`))',
594 return DI::dba()->selectToArray('contact', [], $condition,
595 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
600 * Counts the number of contacts that both provided public contacts have interacted with at least once.
601 * Interactions include follows and likes and comments on public posts.
603 * @param int $sourceId Public contact id
604 * @param int $targetId Public contact id
605 * @param array $condition Additional condition array on the contact table
609 public static function countCommon(int $sourceId, int $targetId, array $condition = [])
611 $condition = DBA::mergeConditions($condition,
612 ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ?)
613 AND `id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ?)',
614 $sourceId, $targetId]
617 return DI::dba()->count('contact', $condition);
621 * Returns a paginated list of contacts that both provided public contacts have interacted with at least once.
622 * Interactions include follows and likes and comments on public posts.
624 * @param int $sourceId Public contact id
625 * @param int $targetId Public contact id
626 * @param array $condition Additional condition on the contact table
629 * @param bool $shuffle
630 * @return array|bool Array on success, false on failure
633 public static function listCommon(int $sourceId, int $targetId, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
635 $condition = DBA::mergeConditions($condition,
636 ["`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ?)
637 AND `id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ?)",
638 $sourceId, $targetId]
641 return DI::dba()->selectToArray('contact', [], $condition,
642 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
647 * Counts the number of contacts that are followed by both provided public contacts.
649 * @param int $sourceId Public contact id
650 * @param int $targetId Public contact id
651 * @param array $condition Additional condition array on the contact table
655 public static function countCommonFollows(int $sourceId, int $targetId, array $condition = []): int
657 $condition = DBA::mergeConditions($condition,
658 ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
659 AND `id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)',
660 $sourceId, $targetId]
663 return DI::dba()->count('contact', $condition);
667 * Returns a paginated list of contacts that are followed by both provided public contacts.
669 * @param int $sourceId Public contact id
670 * @param int $targetId Public contact id
671 * @param array $condition Additional condition array on the contact table
674 * @param bool $shuffle
675 * @return array|bool Array on success, false on failure
678 public static function listCommonFollows(int $sourceId, int $targetId, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
680 $condition = DBA::mergeConditions($condition,
681 ["`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
682 AND `id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)",
683 $sourceId, $targetId]
686 return DI::dba()->selectToArray('contact', [], $condition,
687 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
692 * Counts the number of contacts that follow both provided public contacts.
694 * @param int $sourceId Public contact id
695 * @param int $targetId Public contact id
696 * @param array $condition Additional condition on the contact table
700 public static function countCommonFollowers(int $sourceId, int $targetId, array $condition = []): int
702 $condition = DBA::mergeConditions($condition,
703 ["`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)
704 AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)",
705 $sourceId, $targetId]
708 return DI::dba()->count('contact', $condition);
712 * Returns a paginated list of contacts that follow both provided public contacts.
714 * @param int $sourceId Public contact id
715 * @param int $targetId Public contact id
716 * @param array $condition Additional condition on the contact table
719 * @param bool $shuffle
720 * @return array|bool Array on success, false on failure
723 public static function listCommonFollowers(int $sourceId, int $targetId, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
725 $condition = DBA::mergeConditions($condition,
726 ["`id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)
727 AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)",
728 $sourceId, $targetId]
731 return DI::dba()->selectToArray('contact', [], $condition,
732 ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]