const PHANTOM = 'unkn'; // Place holder
+ /**
+ * Returns whether the provided protocol supports following
+ *
+ * @param $protocol
+ * @return bool
+ * @throws HTTPException\InternalServerErrorException
+ */
+ public static function supportsFollow($protocol): bool
+ {
+ if (in_array($protocol, self::NATIVE_SUPPORT)) {
+ return true;
+ }
+
+ $hook_data = [
+ 'protocol' => $protocol,
+ 'result' => null
+ ];
+ Hook::callAll('support_follow', $hook_data);
+
+ return $hook_data['result'] === true;
+ }
+
+ /**
+ * Returns whether the provided protocol supports revoking inbound follows
+ *
+ * @param $protocol
+ * @return bool
+ * @throws HTTPException\InternalServerErrorException
+ */
+ public static function supportsRevokeFollow($protocol): bool
+ {
+ if (in_array($protocol, self::NATIVE_SUPPORT)) {
+ return true;
+ }
+
+ $hook_data = [
+ 'protocol' => $protocol,
+ 'result' => null
+ ];
+ Hook::callAll('support_revoke_follow', $hook_data);
+
+ return $hook_data['result'] === true;
+ }
+
/**
* Returns the address string for the provided profile URL
*
*
* @param array $user User unfriending
* @param array $contact Contact unfriended
- * @param boolean $two_way Revoke eventual inbound follow as well
- * @return bool|null true if successful, false if not, null if no action was performed
+ * @return bool|null true if successful, false if not, null if no remote action was performed
* @throws HTTPException\InternalServerErrorException
* @throws \ImagickException
*/
- public static function terminateFriendship(array $user, array $contact, bool $two_way = false): bool
+ public static function terminateFriendship(array $user, array $contact): ?bool
{
if (empty($contact['network'])) {
throw new \InvalidArgumentException('Missing network key in contact array');
} elseif ($protocol == Protocol::DIASPORA) {
return Diaspora::sendUnshare($user, $contact) > 0;
} elseif ($protocol == Protocol::ACTIVITYPUB) {
- if ($two_way) {
- ActivityPub\Transmitter::sendContactReject($contact['url'], $contact['hub-verify'], $user['uid']);
- }
-
return ActivityPub\Transmitter::sendContactUndo($contact['url'], $contact['id'], $user['uid']);
}
- // Catch-all addon hook
+ // Catch-all hook for connector addons
$hook_data = [
'contact' => $contact,
- 'two_way' => $two_way,
'result' => null
];
Hook::callAll('unfollow', $hook_data);
return $hook_data['result'];
}
+
+ /**
+ * Revoke an incoming follow from the provided contact
+ *
+ * @param array $contact Private contact (uid != 0) array
+ * @return bool|null true if successful, false if not, null if no action was performed
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
+ * @throws \ImagickException
+ */
+ public static function revokeFollow(array $contact): ?bool
+ {
+ if (empty($contact['network'])) {
+ throw new \InvalidArgumentException('Missing network key in contact array');
+ }
+
+ $protocol = $contact['network'];
+ if ($protocol == Protocol::DFRN && !empty($contact['protocol'])) {
+ $protocol = $contact['protocol'];
+ }
+
+ if ($protocol == Protocol::ACTIVITYPUB) {
+ return ActivityPub\Transmitter::sendContactReject($contact['url'], $contact['hub-verify'], $contact['uid']);
+ }
+
+ // Catch-all hook for connector addons
+ $hook_data = [
+ 'contact' => $contact,
+ 'result' => null,
+ ];
+ Hook::callAll('revoke_follow', $hook_data);
+
+ return $hook_data['result'];
+ }
+
+ /**
+ * Send a block message to a remote server. Only useful for connector addons.
+ *
+ * @param array $contact Public contact record to block
+ * @param int $uid User issuing the block
+ * @return bool|null true if successful, false if not, null if no action was performed
+ * @throws HTTPException\InternalServerErrorException
+ */
+ public static function block(array $contact, int $uid): ?bool
+ {
+ // Catch-all hook for connector addons
+ $hook_data = [
+ 'contact' => $contact,
+ 'uid' => $uid,
+ 'result' => null,
+ ];
+ Hook::callAll('block', $hook_data);
+
+ return $hook_data['result'];
+ }
+
+ /**
+ * Send an unblock message to a remote server. Only useful for connector addons.
+ *
+ * @param array $contact Public contact record to unblock
+ * @param int $uid User revoking the block
+ * @return bool|null true if successful, false if not, null if no action was performed
+ * @throws HTTPException\InternalServerErrorException
+ */
+ public static function unblock(array $contact, int $uid): ?bool
+ {
+ // Catch-all hook for connector addons
+ $hook_data = [
+ 'contact' => $contact,
+ 'uid' => $uid,
+ 'result' => null,
+ ];
+ Hook::callAll('unblock', $hook_data);
+
+ return $hook_data['result'];
+ }
}