3 * @copyright Copyright (C) 2020, Friendica
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\Protocol;
24 use Friendica\Content\Feature;
25 use Friendica\Content\PageInfo;
26 use Friendica\Content\Text\BBCode;
27 use Friendica\Content\Text\Markdown;
28 use Friendica\Core\Cache\Duration;
29 use Friendica\Core\Logger;
30 use Friendica\Core\Protocol;
31 use Friendica\Core\System;
32 use Friendica\Core\Worker;
33 use Friendica\Database\DBA;
35 use Friendica\Model\Contact;
36 use Friendica\Model\Conversation;
37 use Friendica\Model\FContact;
38 use Friendica\Model\Item;
39 use Friendica\Model\ItemURI;
40 use Friendica\Model\Mail;
41 use Friendica\Model\Post;
42 use Friendica\Model\Tag;
43 use Friendica\Model\User;
44 use Friendica\Network\Probe;
45 use Friendica\Util\Crypto;
46 use Friendica\Util\DateTimeFormat;
47 use Friendica\Util\Map;
48 use Friendica\Util\Network;
49 use Friendica\Util\Strings;
50 use Friendica\Util\XML;
51 use Friendica\Worker\Delivery;
55 * This class contain functions to create and send Diaspora XML files
60 * Return a list of participating contacts for a thread
62 * This is used for the participation feature.
63 * One of the parameters is a contact array.
64 * This is done to avoid duplicates.
66 * @param array $item Item that is about to be delivered
67 * @param array $contacts The previously fetched contacts
69 * @return array of relay servers
72 public static function participantsForThread(array $item, array $contacts)
74 if (!in_array($item['private'], [Item::PUBLIC, Item::UNLISTED]) || in_array($item["verb"], [Activity::FOLLOW, Activity::TAG])) {
75 Logger::info('Item is private or a participation request. It will not be relayed', ['guid' => $item['guid'], 'private' => $item['private'], 'verb' => $item['verb']]);
79 $items = Item::select(['author-id', 'author-link', 'parent-author-link', 'parent-guid', 'guid'],
80 ['parent' => $item['parent'], 'gravity' => [GRAVITY_COMMENT, GRAVITY_ACTIVITY]]);
81 while ($item = DBA::fetch($items)) {
82 $contact = DBA::selectFirst('contact', ['id', 'url', 'name', 'protocol', 'batch', 'network'],
83 ['id' => $item['author-id']]);
84 if (!DBA::isResult($contact) || empty($contact['batch']) ||
85 ($contact['network'] != Protocol::DIASPORA) ||
86 Strings::compareLink($item['parent-author-link'], $item['author-link'])) {
91 foreach ($contacts as $entry) {
92 if ($entry['batch'] == $contact['batch']) {
98 Logger::info('Add participant to receiver list', ['parent' => $item['parent-guid'], 'item' => $item['guid'], 'participant' => $contact['url']]);
99 $contacts[] = $contact;
108 * verify the envelope and return the verified data
110 * @param string $envelope The magic envelope
112 * @return string verified data
113 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
114 * @throws \ImagickException
116 private static function verifyMagicEnvelope($envelope)
118 $basedom = XML::parseString($envelope, true);
120 if (!is_object($basedom)) {
121 Logger::log("Envelope is no XML file");
125 $children = $basedom->children('http://salmon-protocol.org/ns/magic-env');
127 if (sizeof($children) == 0) {
128 Logger::log("XML has no children");
134 $data = Strings::base64UrlDecode($children->data);
135 $type = $children->data->attributes()->type[0];
137 $encoding = $children->encoding;
139 $alg = $children->alg;
141 $sig = Strings::base64UrlDecode($children->sig);
142 $key_id = $children->sig->attributes()->key_id[0];
144 $handle = Strings::base64UrlDecode($key_id);
147 $b64url_data = Strings::base64UrlEncode($data);
148 $msg = str_replace(["\n", "\r", " ", "\t"], ["", "", "", ""], $b64url_data);
150 $signable_data = $msg.".".Strings::base64UrlEncode($type).".".Strings::base64UrlEncode($encoding).".".Strings::base64UrlEncode($alg);
153 Logger::log('No author could be decoded. Discarding. Message: ' . $envelope);
157 $key = self::key($handle);
159 Logger::log("Couldn't get a key for handle " . $handle . ". Discarding.");
163 $verify = Crypto::rsaVerify($signable_data, $sig, $key);
165 Logger::log('Message from ' . $handle . ' did not verify. Discarding.');
173 * encrypts data via AES
175 * @param string $key The AES key
176 * @param string $iv The IV (is used for CBC encoding)
177 * @param string $data The data that is to be encrypted
179 * @return string encrypted data
181 private static function aesEncrypt($key, $iv, $data)
183 return openssl_encrypt($data, 'aes-256-cbc', str_pad($key, 32, "\0"), OPENSSL_RAW_DATA, str_pad($iv, 16, "\0"));
187 * decrypts data via AES
189 * @param string $key The AES key
190 * @param string $iv The IV (is used for CBC encoding)
191 * @param string $encrypted The encrypted data
193 * @return string decrypted data
195 private static function aesDecrypt($key, $iv, $encrypted)
197 return openssl_decrypt($encrypted, 'aes-256-cbc', str_pad($key, 32, "\0"), OPENSSL_RAW_DATA, str_pad($iv, 16, "\0"));
201 * Decodes incoming Diaspora message in the new format
203 * @param string $raw raw post message
204 * @param string $privKey The private key of the importer
205 * @param boolean $no_exit Don't do an http exit on error
208 * 'message' -> decoded Diaspora XML message
209 * 'author' -> author diaspora handle
210 * 'key' -> author public key (converted to pkcs#8)
211 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
212 * @throws \ImagickException
214 public static function decodeRaw(string $raw, string $privKey = '', bool $no_exit = false)
216 $data = json_decode($raw);
218 // Is it a private post? Then decrypt the outer Salmon
219 if (is_object($data)) {
220 $encrypted_aes_key_bundle = base64_decode($data->aes_key);
221 $ciphertext = base64_decode($data->encrypted_magic_envelope);
223 $outer_key_bundle = '';
224 @openssl_private_decrypt($encrypted_aes_key_bundle, $outer_key_bundle, $privKey);
225 $j_outer_key_bundle = json_decode($outer_key_bundle);
227 if (!is_object($j_outer_key_bundle)) {
228 Logger::log('Outer Salmon did not verify. Discarding.');
232 throw new \Friendica\Network\HTTPException\BadRequestException();
236 $outer_iv = base64_decode($j_outer_key_bundle->iv);
237 $outer_key = base64_decode($j_outer_key_bundle->key);
239 $xml = self::aesDecrypt($outer_key, $outer_iv, $ciphertext);
244 $basedom = XML::parseString($xml, true);
246 if (!is_object($basedom)) {
247 Logger::log('Received data does not seem to be an XML. Discarding. '.$xml);
251 throw new \Friendica\Network\HTTPException\BadRequestException();
255 $base = $basedom->children(ActivityNamespace::SALMON_ME);
257 // Not sure if this cleaning is needed
258 $data = str_replace([" ", "\t", "\r", "\n"], ["", "", "", ""], $base->data);
260 // Build the signed data
261 $type = $base->data[0]->attributes()->type[0];
262 $encoding = $base->encoding;
264 $signed_data = $data.'.'.Strings::base64UrlEncode($type).'.'.Strings::base64UrlEncode($encoding).'.'.Strings::base64UrlEncode($alg);
266 // This is the signature
267 $signature = Strings::base64UrlDecode($base->sig);
269 // Get the senders' public key
270 $key_id = $base->sig[0]->attributes()->key_id[0];
271 $author_addr = base64_decode($key_id);
272 if ($author_addr == '') {
273 Logger::log('No author could be decoded. Discarding. Message: ' . $xml);
277 throw new \Friendica\Network\HTTPException\BadRequestException();
281 $key = self::key($author_addr);
283 Logger::log("Couldn't get a key for handle " . $author_addr . ". Discarding.");
287 throw new \Friendica\Network\HTTPException\BadRequestException();
291 $verify = Crypto::rsaVerify($signed_data, $signature, $key);
293 Logger::log('Message did not verify. Discarding.');
297 throw new \Friendica\Network\HTTPException\BadRequestException();
301 return ['message' => (string)Strings::base64UrlDecode($base->data),
302 'author' => XML::unescape($author_addr),
303 'key' => (string)$key];
307 * Decodes incoming Diaspora message in the deprecated format
309 * @param string $xml urldecoded Diaspora salmon
310 * @param string $privKey The private key of the importer
313 * 'message' -> decoded Diaspora XML message
314 * 'author' -> author diaspora handle
315 * 'key' -> author public key (converted to pkcs#8)
316 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
317 * @throws \ImagickException
319 public static function decode(string $xml, string $privKey = '')
322 $basedom = XML::parseString($xml);
324 if (!is_object($basedom)) {
325 Logger::notice('XML is not parseable.');
328 $children = $basedom->children('https://joindiaspora.com/protocol');
330 $inner_aes_key = null;
333 if ($children->header) {
335 $author_link = str_replace('acct:', '', $children->header->author_id);
337 // This happens with posts from a relais
338 if (empty($privKey)) {
339 Logger::info('This is no private post in the old format');
343 $encrypted_header = json_decode(base64_decode($children->encrypted_header));
345 $encrypted_aes_key_bundle = base64_decode($encrypted_header->aes_key);
346 $ciphertext = base64_decode($encrypted_header->ciphertext);
348 $outer_key_bundle = '';
349 openssl_private_decrypt($encrypted_aes_key_bundle, $outer_key_bundle, $privKey);
351 $j_outer_key_bundle = json_decode($outer_key_bundle);
353 $outer_iv = base64_decode($j_outer_key_bundle->iv);
354 $outer_key = base64_decode($j_outer_key_bundle->key);
356 $decrypted = self::aesDecrypt($outer_key, $outer_iv, $ciphertext);
358 Logger::info('decrypted', ['data' => $decrypted]);
359 $idom = XML::parseString($decrypted);
361 $inner_iv = base64_decode($idom->iv);
362 $inner_aes_key = base64_decode($idom->aes_key);
364 $author_link = str_replace('acct:', '', $idom->author_id);
367 $dom = $basedom->children(ActivityNamespace::SALMON_ME);
369 // figure out where in the DOM tree our data is hiding
372 if ($dom->provenance->data) {
373 $base = $dom->provenance;
374 } elseif ($dom->env->data) {
376 } elseif ($dom->data) {
381 Logger::log('unable to locate salmon data in xml');
382 throw new \Friendica\Network\HTTPException\BadRequestException();
386 // Stash the signature away for now. We have to find their key or it won't be good for anything.
387 $signature = Strings::base64UrlDecode($base->sig);
391 // strip whitespace so our data element will return to one big base64 blob
392 $data = str_replace([" ", "\t", "\r", "\n"], ["", "", "", ""], $base->data);
395 // stash away some other stuff for later
397 $type = $base->data[0]->attributes()->type[0];
398 $keyhash = $base->sig[0]->attributes()->keyhash[0];
399 $encoding = $base->encoding;
403 $signed_data = $data.'.'.Strings::base64UrlEncode($type).'.'.Strings::base64UrlEncode($encoding).'.'.Strings::base64UrlEncode($alg);
407 $data = Strings::base64UrlDecode($data);
411 $inner_decrypted = $data;
413 // Decode the encrypted blob
414 $inner_encrypted = base64_decode($data);
415 $inner_decrypted = self::aesDecrypt($inner_aes_key, $inner_iv, $inner_encrypted);
419 Logger::log('Could not retrieve author URI.');
420 throw new \Friendica\Network\HTTPException\BadRequestException();
422 // Once we have the author URI, go to the web and try to find their public key
423 // (first this will look it up locally if it is in the fcontact cache)
424 // This will also convert diaspora public key from pkcs#1 to pkcs#8
426 Logger::log('Fetching key for '.$author_link);
427 $key = self::key($author_link);
430 Logger::log('Could not retrieve author key.');
431 throw new \Friendica\Network\HTTPException\BadRequestException();
434 $verify = Crypto::rsaVerify($signed_data, $signature, $key);
437 Logger::log('Message did not verify. Discarding.');
438 throw new \Friendica\Network\HTTPException\BadRequestException();
441 Logger::log('Message verified.');
443 return ['message' => (string)$inner_decrypted,
444 'author' => XML::unescape($author_link),
445 'key' => (string)$key];
450 * Dispatches public messages and find the fitting receivers
452 * @param array $msg The post that will be dispatched
453 * @param bool $fetched The message had been fetched (default "false")
455 * @return int The message id of the generated message, "true" or "false" if there was an error
456 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
457 * @throws \ImagickException
459 public static function dispatchPublic($msg, bool $fetched = false)
461 $enabled = intval(DI::config()->get("system", "diaspora_enabled"));
463 Logger::log("diaspora is disabled");
467 if (!($fields = self::validPosting($msg))) {
468 Logger::log("Invalid posting");
472 $importer = ["uid" => 0, "page-flags" => User::PAGE_FLAGS_FREELOVE];
473 $success = self::dispatch($importer, $msg, $fields, $fetched);
479 * Dispatches the different message types to the different functions
481 * @param array $importer Array of the importer user
482 * @param array $msg The post that will be dispatched
483 * @param SimpleXMLElement $fields SimpleXML object that contains the message
484 * @param bool $fetched The message had been fetched (default "false")
486 * @return int The message id of the generated message, "true" or "false" if there was an error
487 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
488 * @throws \ImagickException
490 public static function dispatch(array $importer, $msg, SimpleXMLElement $fields = null, bool $fetched = false)
492 // The sender is the handle of the contact that sent the message.
493 // This will often be different with relayed messages (for example "like" and "comment")
494 $sender = $msg["author"];
496 // This is only needed for private postings since this is already done for public ones before
497 if (is_null($fields)) {
499 if (!($fields = self::validPosting($msg))) {
500 Logger::log("Invalid posting");
507 $type = $fields->getName();
509 Logger::info('Received message', ['type' => $type, 'sender' => $sender, 'user' => $importer["uid"]]);
512 case "account_migration":
514 Logger::log('Message with type ' . $type . ' is not private, quitting.');
517 return self::receiveAccountMigration($importer, $fields);
519 case "account_deletion":
520 return self::receiveAccountDeletion($fields);
523 return self::receiveComment($importer, $sender, $fields, $msg["message"], $fetched);
527 Logger::log('Message with type ' . $type . ' is not private, quitting.');
530 return self::receiveContactRequest($importer, $fields);
534 Logger::log('Message with type ' . $type . ' is not private, quitting.');
537 return self::receiveConversation($importer, $msg, $fields);
540 return self::receiveLike($importer, $sender, $fields);
544 Logger::log('Message with type ' . $type . ' is not private, quitting.');
547 return self::receiveMessage($importer, $fields);
549 case "participation":
551 Logger::log('Message with type ' . $type . ' is not private, quitting.');
554 return self::receiveParticipation($importer, $fields);
556 case "photo": // Not implemented
557 return self::receivePhoto($importer, $fields);
559 case "poll_participation": // Not implemented
560 return self::receivePollParticipation($importer, $fields);
564 Logger::log('Message with type ' . $type . ' is not private, quitting.');
567 return self::receiveProfile($importer, $fields);
570 return self::receiveReshare($importer, $fields, $msg["message"]);
573 return self::receiveRetraction($importer, $sender, $fields);
575 case "status_message":
576 return self::receiveStatusMessage($importer, $fields, $msg["message"], $fetched);
579 Logger::log("Unknown message type ".$type);
585 * Checks if a posting is valid and fetches the data fields.
587 * This function does not only check the signature.
588 * It also does the conversion between the old and the new diaspora format.
590 * @param array $msg Array with the XML, the sender handle and the sender signature
592 * @return bool|SimpleXMLElement If the posting is valid then an array with an SimpleXML object is returned
593 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
594 * @throws \ImagickException
596 private static function validPosting($msg)
598 $data = XML::parseString($msg["message"]);
600 if (!is_object($data)) {
601 Logger::info('No valid XML', ['message' => $msg['message']]);
605 // Is this the new or the old version?
606 if ($data->getName() == "XML") {
608 foreach ($data->post->children() as $child) {
616 $type = $element->getName();
619 Logger::log("Got message type ".$type.": ".$msg["message"], Logger::DATA);
621 // All retractions are handled identically from now on.
622 // In the new version there will only be "retraction".
623 if (in_array($type, ["signed_retraction", "relayable_retraction"]))
624 $type = "retraction";
626 if ($type == "request") {
630 $fields = new SimpleXMLElement("<".$type."/>");
633 $author_signature = null;
634 $parent_author_signature = null;
636 foreach ($element->children() as $fieldname => $entry) {
638 // Translation for the old XML structure
639 if ($fieldname == "diaspora_handle") {
640 $fieldname = "author";
642 if ($fieldname == "participant_handles") {
643 $fieldname = "participants";
645 if (in_array($type, ["like", "participation"])) {
646 if ($fieldname == "target_type") {
647 $fieldname = "parent_type";
650 if ($fieldname == "sender_handle") {
651 $fieldname = "author";
653 if ($fieldname == "recipient_handle") {
654 $fieldname = "recipient";
656 if ($fieldname == "root_diaspora_id") {
657 $fieldname = "root_author";
659 if ($type == "status_message") {
660 if ($fieldname == "raw_message") {
664 if ($type == "retraction") {
665 if ($fieldname == "post_guid") {
666 $fieldname = "target_guid";
668 if ($fieldname == "type") {
669 $fieldname = "target_type";
674 if (($fieldname == "author_signature") && ($entry != "")) {
675 $author_signature = base64_decode($entry);
676 } elseif (($fieldname == "parent_author_signature") && ($entry != "")) {
677 $parent_author_signature = base64_decode($entry);
678 } elseif (!in_array($fieldname, ["author_signature", "parent_author_signature", "target_author_signature"])) {
679 if ($signed_data != "") {
683 $signed_data .= $entry;
685 if (!in_array($fieldname, ["parent_author_signature", "target_author_signature"])
686 || ($orig_type == "relayable_retraction")
688 XML::copy($entry, $fields, $fieldname);
692 // This is something that shouldn't happen at all.
693 if (in_array($type, ["status_message", "reshare", "profile"])) {
694 if ($msg["author"] != $fields->author) {
695 Logger::log("Message handle is not the same as envelope sender. Quitting this message.");
700 // Only some message types have signatures. So we quit here for the other types.
701 if (!in_array($type, ["comment", "like"])) {
704 // No author_signature? This is a must, so we quit.
705 if (!isset($author_signature)) {
706 Logger::log("No author signature for type ".$type." - Message: ".$msg["message"], Logger::DEBUG);
710 if (isset($parent_author_signature)) {
711 $key = self::key($msg["author"]);
713 Logger::info('No key found for parent', ['author' => $msg["author"]]);
717 if (!Crypto::rsaVerify($signed_data, $parent_author_signature, $key, "sha256")) {
718 Logger::log("No valid parent author signature for parent author ".$msg["author"]. " in type ".$type." - signed data: ".$signed_data." - Message: ".$msg["message"]." - Signature ".$parent_author_signature, Logger::DEBUG);
723 $key = self::key($fields->author);
725 Logger::info('No key found', ['author' => $fields->author]);
729 if (!Crypto::rsaVerify($signed_data, $author_signature, $key, "sha256")) {
730 Logger::log("No valid author signature for author ".$fields->author. " in type ".$type." - signed data: ".$signed_data." - Message: ".$msg["message"]." - Signature ".$author_signature, Logger::DEBUG);
738 * Fetches the public key for a given handle
740 * @param string $handle The handle
742 * @return string The public key
743 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
744 * @throws \ImagickException
746 private static function key($handle)
748 $handle = strval($handle);
750 Logger::log("Fetching diaspora key for: ".$handle);
752 $r = FContact::getByURL($handle);
761 * get a handle (user@domain.tld) from a given contact id
763 * @param int $contact_id The id in the contact table
764 * @param int $pcontact_id The id in the contact table (Used for the public contact)
766 * @return string the handle
769 private static function handleFromContact($contact_id, $pcontact_id = 0)
773 Logger::log("contact id is ".$contact_id." - pcontact id is ".$pcontact_id, Logger::DEBUG);
775 if ($pcontact_id != 0) {
776 $contact = DBA::selectFirst('contact', ['addr'], ['id' => $pcontact_id]);
778 if (DBA::isResult($contact) && !empty($contact["addr"])) {
779 return strtolower($contact["addr"]);
784 "SELECT `network`, `addr`, `self`, `url`, `nick` FROM `contact` WHERE `id` = %d",
788 if (DBA::isResult($r)) {
791 Logger::log("contact 'self' = ".$contact['self']." 'url' = ".$contact['url'], Logger::DEBUG);
793 if ($contact['addr'] != "") {
794 $handle = $contact['addr'];
796 $baseurl_start = strpos($contact['url'], '://') + 3;
797 // allows installations in a subdirectory--not sure how Diaspora will handle
798 $baseurl_length = strpos($contact['url'], '/profile') - $baseurl_start;
799 $baseurl = substr($contact['url'], $baseurl_start, $baseurl_length);
800 $handle = $contact['nick'].'@'.$baseurl;
804 return strtolower($handle);
808 * Get a contact id for a given handle
810 * @todo Move to Friendica\Model\Contact
812 * @param int $uid The user id
813 * @param string $handle The handle in the format user@domain.tld
815 * @return array Contact data
816 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
817 * @throws \ImagickException
819 private static function contactByHandle($uid, $handle)
821 return Contact::getByURL($handle, null, [], $uid);
825 * Checks if the given contact url does support ActivityPub
827 * @param string $url profile url
828 * @param boolean $update true = always update, false = never update, null = update when not found or outdated
830 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
831 * @throws \ImagickException
833 public static function isSupportedByContactUrl($url, $update = null)
835 return !empty(FContact::getByURL($url, $update));
839 * Check if posting is allowed for this contact
841 * @param array $importer Array of the importer user
842 * @param array $contact The contact that is checked
843 * @param bool $is_comment Is the check for a comment?
845 * @return bool is the contact allowed to post?
847 private static function postAllow(array $importer, array $contact, $is_comment = false)
850 * Perhaps we were already sharing with this person. Now they're sharing with us.
851 * That makes us friends.
852 * Normally this should have handled by getting a request - but this could get lost
854 // It is deactivated by now, due to side effects. See issue https://github.com/friendica/friendica/pull/4033
855 // It is not removed by now. Possibly the code is needed?
856 //if (!$is_comment && $contact["rel"] == Contact::FOLLOWER && in_array($importer["page-flags"], array(User::PAGE_FLAGS_FREELOVE))) {
859 // array('rel' => Contact::FRIEND, 'writable' => true),
860 // array('id' => $contact["id"], 'uid' => $contact["uid"])
863 // $contact["rel"] = Contact::FRIEND;
864 // Logger::log("defining user ".$contact["nick"]." as friend");
867 // Contact server is blocked
868 if (Network::isUrlBlocked($contact['url'])) {
870 // We don't seem to like that person
871 } elseif ($contact["blocked"]) {
872 // Maybe blocked, don't accept.
874 // We are following this person?
875 } elseif (($contact["rel"] == Contact::SHARING) || ($contact["rel"] == Contact::FRIEND)) {
876 // Yes, then it is fine.
878 // Is it a post to a community?
879 } elseif (($contact["rel"] == Contact::FOLLOWER) && in_array($importer["page-flags"], [User::PAGE_FLAGS_COMMUNITY, User::PAGE_FLAGS_PRVGROUP])) {
882 // Is the message a global user or a comment?
883 } elseif (($importer["uid"] == 0) || $is_comment) {
884 // Messages for the global users and comments are always accepted
892 * Fetches the contact id for a handle and checks if posting is allowed
894 * @param array $importer Array of the importer user
895 * @param string $handle The checked handle in the format user@domain.tld
896 * @param bool $is_comment Is the check for a comment?
898 * @return array The contact data
901 private static function allowedContactByHandle(array $importer, $handle, $is_comment = false)
903 $contact = self::contactByHandle($importer["uid"], $handle);
905 Logger::log("A Contact for handle ".$handle." and user ".$importer["uid"]." was not found");
906 // If a contact isn't found, we accept it anyway if it is a comment
907 if ($is_comment && ($importer["uid"] != 0)) {
908 return self::contactByHandle(0, $handle);
909 } elseif ($is_comment) {
916 if (!self::postAllow($importer, $contact, $is_comment)) {
917 Logger::log("The handle: ".$handle." is not allowed to post to user ".$importer["uid"]);
924 * Does the message already exists on the system?
926 * @param int $uid The user id
927 * @param string $guid The guid of the message
929 * @return int|bool message id if the message already was stored into the system - or false.
932 private static function messageExists($uid, $guid)
934 $item = Item::selectFirst(['id'], ['uid' => $uid, 'guid' => $guid]);
935 if (DBA::isResult($item)) {
936 Logger::log("message ".$guid." already exists for user ".$uid);
944 * Checks for links to posts in a message
946 * @param array $item The item array
949 private static function fetchGuid(array $item)
951 $expression = "=diaspora://.*?/post/([0-9A-Za-z\-_@.:]{15,254}[0-9A-Za-z])=ism";
952 preg_replace_callback(
954 function ($match) use ($item) {
955 self::fetchGuidSub($match, $item);
960 preg_replace_callback(
961 "&\[url=/?posts/([^\[\]]*)\](.*)\[\/url\]&Usi",
962 function ($match) use ($item) {
963 self::fetchGuidSub($match, $item);
970 * Checks for relative /people/* links in an item body to match local
971 * contacts or prepends the remote host taken from the author link.
973 * @param string $body The item body to replace links from
974 * @param string $author_link The author link for missing local contact fallback
976 * @return string the replaced string
978 public static function replacePeopleGuid($body, $author_link)
980 $return = preg_replace_callback(
981 "&\[url=/people/([^\[\]]*)\](.*)\[\/url\]&Usi",
982 function ($match) use ($author_link) {
984 // 0 => '[url=/people/0123456789abcdef]Foo Bar[/url]'
985 // 1 => '0123456789abcdef'
987 $handle = FContact::getUrlByGuid($match[1]);
990 $return = '@[url='.$handle.']'.$match[2].'[/url]';
992 // No local match, restoring absolute remote URL from author scheme and host
993 $author_url = parse_url($author_link);
994 $return = '[url='.$author_url['scheme'].'://'.$author_url['host'].'/people/'.$match[1].']'.$match[2].'[/url]';
1006 * sub function of "fetchGuid" which checks for links in messages
1008 * @param array $match array containing a link that has to be checked for a message link
1009 * @param array $item The item array
1011 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1012 * @throws \ImagickException
1014 private static function fetchGuidSub($match, $item)
1016 if (!self::storeByGuid($match[1], $item["author-link"])) {
1017 self::storeByGuid($match[1], $item["owner-link"]);
1022 * Fetches an item with a given guid from a given server
1024 * @param string $guid the message guid
1025 * @param string $server The server address
1026 * @param int $uid The user id of the user
1028 * @return int the message id of the stored message or false
1029 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1030 * @throws \ImagickException
1032 private static function storeByGuid($guid, $server, $uid = 0)
1034 $serverparts = parse_url($server);
1036 if (empty($serverparts["host"]) || empty($serverparts["scheme"])) {
1040 $server = $serverparts["scheme"]."://".$serverparts["host"];
1042 Logger::log("Trying to fetch item ".$guid." from ".$server, Logger::DEBUG);
1044 $msg = self::message($guid, $server);
1050 Logger::log("Successfully fetched item ".$guid." from ".$server, Logger::DEBUG);
1052 // Now call the dispatcher
1053 return self::dispatchPublic($msg, true);
1057 * Fetches a message from a server
1059 * @param string $guid message guid
1060 * @param string $server The url of the server
1061 * @param int $level Endless loop prevention
1064 * 'message' => The message XML
1065 * 'author' => The author handle
1066 * 'key' => The public key of the author
1067 * @throws \Exception
1069 private static function message($guid, $server, $level = 0)
1075 // This will work for new Diaspora servers and Friendica servers from 3.5
1076 $source_url = $server."/fetch/post/".urlencode($guid);
1078 Logger::log("Fetch post from ".$source_url, Logger::DEBUG);
1080 $envelope = DI::httpRequest()->fetch($source_url);
1082 Logger::log("Envelope was fetched.", Logger::DEBUG);
1083 $x = self::verifyMagicEnvelope($envelope);
1085 Logger::log("Envelope could not be verified.", Logger::DEBUG);
1087 Logger::log("Envelope was verified.", Logger::DEBUG);
1097 $source_xml = XML::parseString($x);
1099 if (!is_object($source_xml)) {
1103 if ($source_xml->post->reshare) {
1104 // Reshare of a reshare - old Diaspora version
1105 Logger::log("Message is a reshare", Logger::DEBUG);
1106 return self::message($source_xml->post->reshare->root_guid, $server, ++$level);
1107 } elseif ($source_xml->getName() == "reshare") {
1108 // Reshare of a reshare - new Diaspora version
1109 Logger::log("Message is a new reshare", Logger::DEBUG);
1110 return self::message($source_xml->root_guid, $server, ++$level);
1115 // Fetch the author - for the old and the new Diaspora version
1116 if ($source_xml->post->status_message && $source_xml->post->status_message->diaspora_handle) {
1117 $author = (string)$source_xml->post->status_message->diaspora_handle;
1118 } elseif ($source_xml->author && ($source_xml->getName() == "status_message")) {
1119 $author = (string)$source_xml->author;
1122 // If this isn't a "status_message" then quit
1124 Logger::log("Message doesn't seem to be a status message", Logger::DEBUG);
1128 $msg = ["message" => $x, "author" => $author];
1130 $msg["key"] = self::key($msg["author"]);
1136 * Fetches an item with a given URL
1138 * @param string $url the message url
1140 * @return int the message id of the stored message or false
1141 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1142 * @throws \ImagickException
1144 public static function fetchByURL($url, $uid = 0)
1146 // Check for Diaspora (and Friendica) typical paths
1147 if (!preg_match("=(https?://.+)/(?:posts|display|objects)/([a-zA-Z0-9-_@.:%]+[a-zA-Z0-9])=i", $url, $matches)) {
1148 Logger::info('Invalid url', ['url' => $url]);
1152 $guid = urldecode($matches[2]);
1154 $item = Item::selectFirst(['id'], ['guid' => $guid, 'uid' => $uid]);
1155 if (DBA::isResult($item)) {
1156 Logger::info('Found', ['id' => $item['id']]);
1160 Logger::info('Fetch GUID from origin', ['guid' => $guid, 'server' => $matches[1]]);
1161 $ret = self::storeByGuid($guid, $matches[1], $uid);
1162 Logger::info('Result', ['ret' => $ret]);
1164 $item = Item::selectFirst(['id'], ['guid' => $guid, 'uid' => $uid]);
1165 if (DBA::isResult($item)) {
1166 Logger::info('Found', ['id' => $item['id']]);
1169 Logger::info('Not found', ['guid' => $guid, 'uid' => $uid]);
1175 * Fetches the item record of a given guid
1177 * @param int $uid The user id
1178 * @param string $guid message guid
1179 * @param string $author The handle of the item
1180 * @param array $contact The contact of the item owner
1182 * @return array the item record
1183 * @throws \Exception
1185 private static function parentItem($uid, $guid, $author, array $contact)
1187 $fields = ['id', 'parent', 'body', 'wall', 'uri', 'guid', 'private', 'origin',
1188 'author-name', 'author-link', 'author-avatar', 'gravity',
1189 'owner-name', 'owner-link', 'owner-avatar'];
1190 $condition = ['uid' => $uid, 'guid' => $guid];
1191 $item = Item::selectFirst($fields, $condition);
1193 if (!DBA::isResult($item)) {
1194 $person = FContact::getByURL($author);
1195 $result = self::storeByGuid($guid, $person["url"], $uid);
1197 // We don't have an url for items that arrived at the public dispatcher
1198 if (!$result && !empty($contact["url"])) {
1199 $result = self::storeByGuid($guid, $contact["url"], $uid);
1203 Logger::log("Fetched missing item ".$guid." - result: ".$result, Logger::DEBUG);
1205 $item = Item::selectFirst($fields, $condition);
1209 if (!DBA::isResult($item)) {
1210 Logger::log("parent item not found: parent: ".$guid." - user: ".$uid);
1213 Logger::log("parent item found: parent: ".$guid." - user: ".$uid);
1219 * returns contact details
1221 * @param array $def_contact The default contact if the person isn't found
1222 * @param array $person The record of the person
1223 * @param int $uid The user id
1226 * 'cid' => contact id
1227 * 'network' => network type
1228 * @throws \Exception
1230 private static function authorContactByUrl($def_contact, $person, $uid)
1232 $condition = ['nurl' => Strings::normaliseLink($person["url"]), 'uid' => $uid];
1233 $contact = DBA::selectFirst('contact', ['id', 'network'], $condition);
1234 if (DBA::isResult($contact)) {
1235 $cid = $contact["id"];
1236 $network = $contact["network"];
1238 $cid = $def_contact["id"];
1239 $network = Protocol::DIASPORA;
1242 return ["cid" => $cid, "network" => $network];
1246 * Is the profile a hubzilla profile?
1248 * @param string $url The profile link
1250 * @return bool is it a hubzilla server?
1252 private static function isHubzilla($url)
1254 return(strstr($url, '/channel/'));
1258 * Generate a post link with a given handle and message guid
1260 * @param string $addr The user handle
1261 * @param string $guid message guid
1262 * @param string $parent_guid optional parent guid
1264 * @return string the post link
1265 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1266 * @throws \ImagickException
1268 private static function plink($addr, $guid, $parent_guid = '')
1270 $contact = Contact::getByURL($addr);
1271 if (empty($contact)) {
1272 Logger::info('No contact data for address', ['addr' => $addr]);
1276 if (empty($contact['baseurl'])) {
1277 $contact['baseurl'] = 'https://' . substr($addr, strpos($addr, '@') + 1);
1278 Logger::info('Create baseurl from address', ['baseurl' => $contact['baseurl'], 'url' => $contact['url']]);
1282 $gserver = DBA::selectFirst('gserver', ['platform'], ['nurl' => Strings::normaliseLink($contact['baseurl'])]);
1283 if (!empty($gserver['platform'])) {
1284 $platform = strtolower($gserver['platform']);
1285 Logger::info('Detected platform', ['platform' => $platform, 'url' => $contact['url']]);
1288 if (!in_array($platform, ['diaspora', 'friendica', 'hubzilla', 'socialhome'])) {
1289 if (self::isHubzilla($contact['url'])) {
1290 Logger::info('Detected unknown platform as Hubzilla', ['platform' => $platform, 'url' => $contact['url']]);
1291 $platform = 'hubzilla';
1292 } elseif ($contact['network'] == Protocol::DFRN) {
1293 Logger::info('Detected unknown platform as Friendica', ['platform' => $platform, 'url' => $contact['url']]);
1294 $platform = 'friendica';
1298 if ($platform == 'friendica') {
1299 return str_replace('/profile/' . $contact['nick'] . '/', '/display/' . $guid, $contact['url'] . '/');
1302 if ($platform == 'hubzilla') {
1303 return $contact['baseurl'] . '/item/' . $guid;
1306 if ($platform == 'socialhome') {
1307 return $contact['baseurl'] . '/content/' . $guid;
1310 if ($platform != 'diaspora') {
1311 Logger::info('Unknown platform', ['platform' => $platform, 'url' => $contact['url']]);
1315 if ($parent_guid != '') {
1316 return $contact['baseurl'] . '/posts/' . $parent_guid . '#' . $guid;
1318 return $contact['baseurl'] . '/posts/' . $guid;
1323 * Receives account migration
1325 * @param array $importer Array of the importer user
1326 * @param object $data The message object
1328 * @return bool Success
1329 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1330 * @throws \ImagickException
1332 private static function receiveAccountMigration(array $importer, $data)
1334 $old_handle = Strings::escapeTags(XML::unescape($data->author));
1335 $new_handle = Strings::escapeTags(XML::unescape($data->profile->author));
1336 $signature = Strings::escapeTags(XML::unescape($data->signature));
1338 $contact = self::contactByHandle($importer["uid"], $old_handle);
1340 Logger::log("cannot find contact for sender: ".$old_handle." and user ".$importer["uid"]);
1344 Logger::log("Got migration for ".$old_handle.", to ".$new_handle." with user ".$importer["uid"]);
1347 $signed_text = 'AccountMigration:'.$old_handle.':'.$new_handle;
1348 $key = self::key($old_handle);
1349 if (!Crypto::rsaVerify($signed_text, $signature, $key, "sha256")) {
1350 Logger::log('No valid signature for migration.');
1354 // Update the profile
1355 self::receiveProfile($importer, $data->profile);
1357 // change the technical stuff in contact
1358 $data = Probe::uri($new_handle);
1359 if ($data['network'] == Protocol::PHANTOM) {
1360 Logger::log('Account for '.$new_handle." couldn't be probed.");
1364 $fields = ['url' => $data['url'], 'nurl' => Strings::normaliseLink($data['url']),
1365 'name' => $data['name'], 'nick' => $data['nick'],
1366 'addr' => $data['addr'], 'batch' => $data['batch'],
1367 'notify' => $data['notify'], 'poll' => $data['poll'],
1368 'network' => $data['network']];
1370 DBA::update('contact', $fields, ['addr' => $old_handle]);
1372 Logger::log('Contacts are updated.');
1378 * Processes an account deletion
1380 * @param object $data The message object
1382 * @return bool Success
1383 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1385 private static function receiveAccountDeletion($data)
1387 $author = Strings::escapeTags(XML::unescape($data->author));
1389 $contacts = DBA::select('contact', ['id'], ['addr' => $author]);
1390 while ($contact = DBA::fetch($contacts)) {
1391 Contact::remove($contact["id"]);
1393 DBA::close($contacts);
1395 Logger::log('Removed contacts for ' . $author);
1401 * Fetch the uri from our database if we already have this item (maybe from ourselves)
1403 * @param string $author Author handle
1404 * @param string $guid Message guid
1405 * @param boolean $onlyfound Only return uri when found in the database
1407 * @return string The constructed uri or the one from our database
1408 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1409 * @throws \ImagickException
1411 private static function getUriFromGuid($author, $guid, $onlyfound = false)
1413 $item = Item::selectFirst(['uri'], ['guid' => $guid]);
1414 if (DBA::isResult($item)) {
1415 return $item["uri"];
1416 } elseif (!$onlyfound) {
1417 $person = FContact::getByURL($author);
1419 $parts = parse_url($person['url']);
1420 unset($parts['path']);
1421 $host_url = Network::unparseURL($parts);
1423 return $host_url . '/objects/' . $guid;
1430 * Fetch the guid from our database with a given uri
1432 * @param string $uri Message uri
1433 * @param string $uid Author handle
1435 * @return string The post guid
1436 * @throws \Exception
1438 private static function getGuidFromUri($uri, $uid)
1440 $item = Item::selectFirst(['guid'], ['uri' => $uri, 'uid' => $uid]);
1441 if (DBA::isResult($item)) {
1442 return $item["guid"];
1449 * Store the mentions in the tag table
1451 * @param integer $uriid
1452 * @param string $text
1454 private static function storeMentions(int $uriid, string $text)
1456 preg_match_all('/([@!]){(?:([^}]+?); ?)?([^} ]+)}/', $text, $matches, PREG_SET_ORDER);
1457 if (empty($matches)) {
1462 * Matching values for the preg match
1463 * [1] = mention type (@ or !)
1464 * [2] = name (optional)
1468 foreach ($matches as $match) {
1469 if (empty($match)) {
1473 $person = FContact::getByURL($match[3]);
1474 if (empty($person)) {
1478 Tag::storeByHash($uriid, $match[1], $person['name'] ?: $person['nick'], $person['url']);
1483 * Processes an incoming comment
1485 * @param array $importer Array of the importer user
1486 * @param string $sender The sender of the message
1487 * @param object $data The message object
1488 * @param string $xml The original XML of the message
1489 * @param bool $fetched The message had been fetched and not pushed
1491 * @return int The message id of the generated comment or "false" if there was an error
1492 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1493 * @throws \ImagickException
1495 private static function receiveComment(array $importer, $sender, $data, $xml, bool $fetched)
1497 $author = Strings::escapeTags(XML::unescape($data->author));
1498 $guid = Strings::escapeTags(XML::unescape($data->guid));
1499 $parent_guid = Strings::escapeTags(XML::unescape($data->parent_guid));
1500 $text = XML::unescape($data->text);
1502 if (isset($data->created_at)) {
1503 $created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($data->created_at)));
1505 $created_at = DateTimeFormat::utcNow();
1508 if (isset($data->thread_parent_guid)) {
1509 $thread_parent_guid = Strings::escapeTags(XML::unescape($data->thread_parent_guid));
1510 $thr_parent = self::getUriFromGuid("", $thread_parent_guid, true);
1515 $contact = self::allowedContactByHandle($importer, $sender, true);
1520 $message_id = self::messageExists($importer["uid"], $guid);
1525 $toplevel_parent_item = self::parentItem($importer["uid"], $parent_guid, $author, $contact);
1526 if (!$toplevel_parent_item) {
1530 $person = FContact::getByURL($author);
1531 if (!is_array($person)) {
1532 Logger::log("unable to find author details");
1536 // Fetch the contact id - if we know this contact
1537 $author_contact = self::authorContactByUrl($contact, $person, $importer["uid"]);
1541 $datarray["uid"] = $importer["uid"];
1542 $datarray["contact-id"] = $author_contact["cid"];
1543 $datarray["network"] = $author_contact["network"];
1545 $datarray["author-link"] = $person["url"];
1546 $datarray["author-id"] = Contact::getIdForURL($person["url"], 0);
1548 $datarray["owner-link"] = $contact["url"];
1549 $datarray["owner-id"] = Contact::getIdForURL($contact["url"], 0);
1551 // Will be overwritten for sharing accounts in Item::insert
1553 $datarray["post-type"] = Item::PT_FETCHED;
1554 } elseif ($datarray["uid"] == 0) {
1555 $datarray["post-type"] = Item::PT_GLOBAL;
1557 $datarray["post-type"] = Item::PT_COMMENT;
1560 $datarray["guid"] = $guid;
1561 $datarray["uri"] = self::getUriFromGuid($author, $guid);
1562 $datarray['uri-id'] = ItemURI::insert(['uri' => $datarray['uri'], 'guid' => $datarray['guid']]);
1564 $datarray["verb"] = Activity::POST;
1565 $datarray["gravity"] = GRAVITY_COMMENT;
1567 $datarray['thr-parent'] = $thr_parent ?: $toplevel_parent_item['uri'];
1569 $datarray["object-type"] = Activity\ObjectType::COMMENT;
1571 $datarray["protocol"] = Conversation::PARCEL_DIASPORA;
1572 $datarray["source"] = $xml;
1574 $datarray["changed"] = $datarray["created"] = $datarray["edited"] = $created_at;
1576 $datarray["plink"] = self::plink($author, $guid, $toplevel_parent_item['guid']);
1577 $body = Markdown::toBBCode($text);
1579 $datarray["body"] = self::replacePeopleGuid($body, $person["url"]);
1581 self::storeMentions($datarray['uri-id'], $text);
1582 Tag::storeRawTagsFromBody($datarray['uri-id'], $datarray["body"]);
1584 self::fetchGuid($datarray);
1586 // If we are the origin of the parent we store the original data.
1587 // We notify our followers during the item storage.
1588 if ($toplevel_parent_item["origin"]) {
1589 $datarray['diaspora_signed_text'] = json_encode($data);
1592 if (Item::isTooOld($datarray)) {
1593 Logger::info('Comment is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
1597 $message_id = Item::insert($datarray);
1599 if ($message_id <= 0) {
1604 Logger::log("Stored comment ".$datarray["guid"]." with message id ".$message_id, Logger::DEBUG);
1605 if ($datarray['uid'] == 0) {
1606 Item::distribute($message_id, json_encode($data));
1614 * processes and stores private messages
1616 * @param array $importer Array of the importer user
1617 * @param array $contact The contact of the message
1618 * @param object $data The message object
1619 * @param array $msg Array of the processed message, author handle and key
1620 * @param object $mesg The private message
1621 * @param array $conversation The conversation record to which this message belongs
1623 * @return bool "true" if it was successful
1624 * @throws \Exception
1626 private static function receiveConversationMessage(array $importer, array $contact, $data, $msg, $mesg, $conversation)
1628 $author = Strings::escapeTags(XML::unescape($data->author));
1629 $guid = Strings::escapeTags(XML::unescape($data->guid));
1630 $subject = Strings::escapeTags(XML::unescape($data->subject));
1632 // "diaspora_handle" is the element name from the old version
1633 // "author" is the element name from the new version
1634 if ($mesg->author) {
1635 $msg_author = Strings::escapeTags(XML::unescape($mesg->author));
1636 } elseif ($mesg->diaspora_handle) {
1637 $msg_author = Strings::escapeTags(XML::unescape($mesg->diaspora_handle));
1642 $msg_guid = Strings::escapeTags(XML::unescape($mesg->guid));
1643 $msg_conversation_guid = Strings::escapeTags(XML::unescape($mesg->conversation_guid));
1644 $msg_text = XML::unescape($mesg->text);
1645 $msg_created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($mesg->created_at)));
1647 if ($msg_conversation_guid != $guid) {
1648 Logger::log("message conversation guid does not belong to the current conversation.");
1652 $body = Markdown::toBBCode($msg_text);
1653 $message_uri = $msg_author.":".$msg_guid;
1655 $person = FContact::getByURL($msg_author);
1657 return Mail::insert([
1658 'uid' => $importer['uid'],
1659 'guid' => $msg_guid,
1660 'convid' => $conversation['id'],
1661 'from-name' => $person['name'],
1662 'from-photo' => $person['photo'],
1663 'from-url' => $person['url'],
1664 'contact-id' => $contact['id'],
1665 'title' => $subject,
1667 'uri' => $message_uri,
1668 'parent-uri' => $author . ':' . $guid,
1669 'created' => $msg_created_at
1674 * Processes new private messages (answers to private messages are processed elsewhere)
1676 * @param array $importer Array of the importer user
1677 * @param array $msg Array of the processed message, author handle and key
1678 * @param object $data The message object
1680 * @return bool Success
1681 * @throws \Exception
1683 private static function receiveConversation(array $importer, $msg, $data)
1685 $author = Strings::escapeTags(XML::unescape($data->author));
1686 $guid = Strings::escapeTags(XML::unescape($data->guid));
1687 $subject = Strings::escapeTags(XML::unescape($data->subject));
1688 $created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($data->created_at)));
1689 $participants = Strings::escapeTags(XML::unescape($data->participants));
1691 $messages = $data->message;
1693 if (!count($messages)) {
1694 Logger::log("empty conversation");
1698 $contact = self::allowedContactByHandle($importer, $msg["author"], true);
1703 $conversation = DBA::selectFirst('conv', [], ['uid' => $importer["uid"], 'guid' => $guid]);
1704 if (!DBA::isResult($conversation)) {
1706 "INSERT INTO `conv` (`uid`, `guid`, `creator`, `created`, `updated`, `subject`, `recips`)
1707 VALUES (%d, '%s', '%s', '%s', '%s', '%s', '%s')",
1708 intval($importer["uid"]),
1710 DBA::escape($author),
1711 DBA::escape($created_at),
1712 DBA::escape(DateTimeFormat::utcNow()),
1713 DBA::escape($subject),
1714 DBA::escape($participants)
1717 $conversation = DBA::selectFirst('conv', [], ['uid' => $importer["uid"], 'guid' => $guid]);
1720 if (!$conversation) {
1721 Logger::log("unable to create conversation.");
1725 foreach ($messages as $mesg) {
1726 self::receiveConversationMessage($importer, $contact, $data, $msg, $mesg, $conversation);
1733 * Processes "like" messages
1735 * @param array $importer Array of the importer user
1736 * @param string $sender The sender of the message
1737 * @param object $data The message object
1739 * @return int The message id of the generated like or "false" if there was an error
1740 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1741 * @throws \ImagickException
1743 private static function receiveLike(array $importer, $sender, $data)
1745 $author = Strings::escapeTags(XML::unescape($data->author));
1746 $guid = Strings::escapeTags(XML::unescape($data->guid));
1747 $parent_guid = Strings::escapeTags(XML::unescape($data->parent_guid));
1748 $parent_type = Strings::escapeTags(XML::unescape($data->parent_type));
1749 $positive = Strings::escapeTags(XML::unescape($data->positive));
1751 // likes on comments aren't supported by Diaspora - only on posts
1752 // But maybe this will be supported in the future, so we will accept it.
1753 if (!in_array($parent_type, ["Post", "Comment"])) {
1757 $contact = self::allowedContactByHandle($importer, $sender, true);
1762 $message_id = self::messageExists($importer["uid"], $guid);
1767 $toplevel_parent_item = self::parentItem($importer["uid"], $parent_guid, $author, $contact);
1768 if (!$toplevel_parent_item) {
1772 $person = FContact::getByURL($author);
1773 if (!is_array($person)) {
1774 Logger::log("unable to find author details");
1778 // Fetch the contact id - if we know this contact
1779 $author_contact = self::authorContactByUrl($contact, $person, $importer["uid"]);
1781 // "positive" = "false" would be a Dislike - wich isn't currently supported by Diaspora
1782 // We would accept this anyhow.
1783 if ($positive == "true") {
1784 $verb = Activity::LIKE;
1786 $verb = Activity::DISLIKE;
1791 $datarray["protocol"] = Conversation::PARCEL_DIASPORA;
1793 $datarray["uid"] = $importer["uid"];
1794 $datarray["contact-id"] = $author_contact["cid"];
1795 $datarray["network"] = $author_contact["network"];
1797 $datarray["owner-link"] = $datarray["author-link"] = $person["url"];
1798 $datarray["owner-id"] = $datarray["author-id"] = Contact::getIdForURL($person["url"], 0);
1800 $datarray["guid"] = $guid;
1801 $datarray["uri"] = self::getUriFromGuid($author, $guid);
1803 $datarray["verb"] = $verb;
1804 $datarray["gravity"] = GRAVITY_ACTIVITY;
1805 $datarray['thr-parent'] = $toplevel_parent_item['uri'];
1807 $datarray["object-type"] = Activity\ObjectType::NOTE;
1809 $datarray["body"] = $verb;
1811 // Diaspora doesn't provide a date for likes
1812 $datarray["changed"] = $datarray["created"] = $datarray["edited"] = DateTimeFormat::utcNow();
1814 // like on comments have the comment as parent. So we need to fetch the toplevel parent
1815 if ($toplevel_parent_item['gravity'] != GRAVITY_PARENT) {
1816 $toplevel = Item::selectFirst(['origin'], ['id' => $toplevel_parent_item['parent']]);
1817 $origin = $toplevel["origin"];
1819 $origin = $toplevel_parent_item["origin"];
1822 // If we are the origin of the parent we store the original data.
1823 // We notify our followers during the item storage.
1825 $datarray['diaspora_signed_text'] = json_encode($data);
1828 if (Item::isTooOld($datarray)) {
1829 Logger::info('Like is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
1833 $message_id = Item::insert($datarray);
1835 if ($message_id <= 0) {
1840 Logger::log("Stored like ".$datarray["guid"]." with message id ".$message_id, Logger::DEBUG);
1841 if ($datarray['uid'] == 0) {
1842 Item::distribute($message_id, json_encode($data));
1850 * Processes private messages
1852 * @param array $importer Array of the importer user
1853 * @param object $data The message object
1855 * @return bool Success?
1856 * @throws \Exception
1858 private static function receiveMessage(array $importer, $data)
1860 $author = Strings::escapeTags(XML::unescape($data->author));
1861 $guid = Strings::escapeTags(XML::unescape($data->guid));
1862 $conversation_guid = Strings::escapeTags(XML::unescape($data->conversation_guid));
1863 $text = XML::unescape($data->text);
1864 $created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($data->created_at)));
1866 $contact = self::allowedContactByHandle($importer, $author, true);
1871 $conversation = null;
1873 $condition = ['uid' => $importer["uid"], 'guid' => $conversation_guid];
1874 $conversation = DBA::selectFirst('conv', [], $condition);
1876 if (!DBA::isResult($conversation)) {
1877 Logger::log("conversation not available.");
1881 $message_uri = $author.":".$guid;
1883 $person = FContact::getByURL($author);
1885 Logger::log("unable to find author details");
1889 $body = Markdown::toBBCode($text);
1891 $body = self::replacePeopleGuid($body, $person["url"]);
1893 return Mail::insert([
1894 'uid' => $importer['uid'],
1896 'convid' => $conversation['id'],
1897 'from-name' => $person['name'],
1898 'from-photo' => $person['photo'],
1899 'from-url' => $person['url'],
1900 'contact-id' => $contact['id'],
1901 'title' => $conversation['subject'],
1904 'uri' => $message_uri,
1905 'parent-uri' => $author.":".$conversation['guid'],
1906 'created' => $created_at
1911 * Processes participations - unsupported by now
1913 * @param array $importer Array of the importer user
1914 * @param object $data The message object
1916 * @return bool success
1917 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1918 * @throws \ImagickException
1920 private static function receiveParticipation(array $importer, $data)
1922 $author = strtolower(Strings::escapeTags(XML::unescape($data->author)));
1923 $guid = Strings::escapeTags(XML::unescape($data->guid));
1924 $parent_guid = Strings::escapeTags(XML::unescape($data->parent_guid));
1926 $contact = self::allowedContactByHandle($importer, $author, true);
1931 if (self::messageExists($importer["uid"], $guid)) {
1935 $toplevel_parent_item = self::parentItem($importer["uid"], $parent_guid, $author, $contact);
1936 if (!$toplevel_parent_item) {
1940 if (!$toplevel_parent_item['origin']) {
1941 Logger::info('Not our origin. Participation is ignored', ['parent_guid' => $parent_guid, 'guid' => $guid, 'author' => $author]);
1944 if (!in_array($toplevel_parent_item['private'], [Item::PUBLIC, Item::UNLISTED])) {
1945 Logger::info('Item is not public, participation is ignored', ['parent_guid' => $parent_guid, 'guid' => $guid, 'author' => $author]);
1949 $person = FContact::getByURL($author);
1950 if (!is_array($person)) {
1951 Logger::log("Person not found: ".$author);
1955 $author_contact = self::authorContactByUrl($contact, $person, $importer["uid"]);
1957 // Store participation
1960 $datarray["protocol"] = Conversation::PARCEL_DIASPORA;
1962 $datarray["uid"] = $importer["uid"];
1963 $datarray["contact-id"] = $author_contact["cid"];
1964 $datarray["network"] = $author_contact["network"];
1966 $datarray["owner-link"] = $datarray["author-link"] = $person["url"];
1967 $datarray["owner-id"] = $datarray["author-id"] = Contact::getIdForURL($person["url"], 0);
1969 $datarray["guid"] = $guid;
1970 $datarray["uri"] = self::getUriFromGuid($author, $guid);
1972 $datarray["verb"] = Activity::FOLLOW;
1973 $datarray["gravity"] = GRAVITY_ACTIVITY;
1974 $datarray['thr-parent'] = $toplevel_parent_item['uri'];
1976 $datarray["object-type"] = Activity\ObjectType::NOTE;
1978 $datarray["body"] = Activity::FOLLOW;
1980 // Diaspora doesn't provide a date for a participation
1981 $datarray["changed"] = $datarray["created"] = $datarray["edited"] = DateTimeFormat::utcNow();
1983 if (Item::isTooOld($datarray)) {
1984 Logger::info('Participation is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
1988 $message_id = Item::insert($datarray);
1990 Logger::info('Participation stored', ['id' => $message_id, 'guid' => $guid, 'parent_guid' => $parent_guid, 'author' => $author]);
1992 // Send all existing comments and likes to the requesting server
1993 $comments = Item::select(['id', 'uri-id', 'parent-author-network', 'author-network', 'verb'],
1994 ['parent' => $toplevel_parent_item['id'], 'gravity' => [GRAVITY_COMMENT, GRAVITY_ACTIVITY]]);
1995 while ($comment = Item::fetch($comments)) {
1996 if (in_array($comment['verb'], [Activity::FOLLOW, Activity::TAG])) {
1997 Logger::info('participation messages are not relayed', ['item' => $comment['id']]);
2001 if ($comment['author-network'] == Protocol::ACTIVITYPUB) {
2002 Logger::info('Comments from ActivityPub authors are not relayed', ['item' => $comment['id']]);
2006 if ($comment['parent-author-network'] == Protocol::ACTIVITYPUB) {
2007 Logger::info('Comments to comments from ActivityPub authors are not relayed', ['item' => $comment['id']]);
2011 Logger::info('Deliver participation', ['item' => $comment['id'], 'contact' => $author_contact["cid"]]);
2012 if (Worker::add(PRIORITY_HIGH, 'Delivery', Delivery::POST, $comment['id'], $author_contact["cid"])) {
2013 Post\DeliveryData::incrementQueueCount($comment['uri-id'], 1);
2016 DBA::close($comments);
2022 * Processes photos - unneeded
2024 * @param array $importer Array of the importer user
2025 * @param object $data The message object
2027 * @return bool always true
2029 private static function receivePhoto(array $importer, $data)
2031 // There doesn't seem to be a reason for this function,
2032 // since the photo data is transmitted in the status message as well
2037 * Processes poll participations - unssupported
2039 * @param array $importer Array of the importer user
2040 * @param object $data The message object
2042 * @return bool always true
2044 private static function receivePollParticipation(array $importer, $data)
2046 // We don't support polls by now
2051 * Processes incoming profile updates
2053 * @param array $importer Array of the importer user
2054 * @param object $data The message object
2056 * @return bool Success
2057 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2058 * @throws \ImagickException
2060 private static function receiveProfile(array $importer, $data)
2062 $author = strtolower(Strings::escapeTags(XML::unescape($data->author)));
2064 $contact = self::contactByHandle($importer["uid"], $author);
2069 $name = XML::unescape($data->first_name).((strlen($data->last_name)) ? " ".XML::unescape($data->last_name) : "");
2070 $image_url = XML::unescape($data->image_url);
2071 $birthday = XML::unescape($data->birthday);
2072 $about = Markdown::toBBCode(XML::unescape($data->bio));
2073 $location = Markdown::toBBCode(XML::unescape($data->location));
2074 $searchable = (XML::unescape($data->searchable) == "true");
2075 $nsfw = (XML::unescape($data->nsfw) == "true");
2076 $tags = XML::unescape($data->tag_string);
2078 $tags = explode("#", $tags);
2081 foreach ($tags as $tag) {
2082 $tag = trim(strtolower($tag));
2088 $keywords = implode(", ", $keywords);
2090 $handle_parts = explode("@", $author);
2091 $nick = $handle_parts[0];
2094 $name = $handle_parts[0];
2097 if (preg_match("|^https?://|", $image_url) === 0) {
2098 $image_url = "http://".$handle_parts[1].$image_url;
2101 Contact::updateAvatar($contact["id"], $image_url);
2103 // Generic birthday. We don't know the timezone. The year is irrelevant.
2105 $birthday = str_replace("1000", "1901", $birthday);
2107 if ($birthday != "") {
2108 $birthday = DateTimeFormat::utc($birthday, "Y-m-d");
2111 // this is to prevent multiple birthday notifications in a single year
2112 // if we already have a stored birthday and the 'm-d' part hasn't changed, preserve the entry, which will preserve the notify year
2114 if (substr($birthday, 5) === substr($contact["bd"], 5)) {
2115 $birthday = $contact["bd"];
2118 $fields = ['name' => $name, 'location' => $location,
2119 'name-date' => DateTimeFormat::utcNow(), 'about' => $about,
2120 'addr' => $author, 'nick' => $nick, 'keywords' => $keywords,
2121 'unsearchable' => !$searchable, 'sensitive' => $nsfw];
2123 if (!empty($birthday)) {
2124 $fields['bd'] = $birthday;
2127 DBA::update('contact', $fields, ['id' => $contact['id']]);
2129 Logger::log("Profile of contact ".$contact["id"]." stored for user ".$importer["uid"], Logger::DEBUG);
2135 * Processes incoming friend requests
2137 * @param array $importer Array of the importer user
2138 * @param array $contact The contact that send the request
2140 * @throws \Exception
2142 private static function receiveRequestMakeFriend(array $importer, array $contact)
2144 if ($contact["rel"] == Contact::SHARING) {
2147 ['rel' => Contact::FRIEND, 'writable' => true],
2148 ['id' => $contact["id"], 'uid' => $importer["uid"]]
2154 * Processes incoming sharing notification
2156 * @param array $importer Array of the importer user
2157 * @param object $data The message object
2159 * @return bool Success
2160 * @throws \Exception
2162 private static function receiveContactRequest(array $importer, $data)
2164 $author = XML::unescape($data->author);
2165 $recipient = XML::unescape($data->recipient);
2167 if (!$author || !$recipient) {
2171 // the current protocol version doesn't know these fields
2172 // That means that we will assume their existance
2173 if (isset($data->following)) {
2174 $following = (XML::unescape($data->following) == "true");
2179 if (isset($data->sharing)) {
2180 $sharing = (XML::unescape($data->sharing) == "true");
2185 $contact = self::contactByHandle($importer["uid"], $author);
2187 // perhaps we were already sharing with this person. Now they're sharing with us.
2188 // That makes us friends.
2191 Logger::log("Author ".$author." (Contact ".$contact["id"].") wants to follow us.", Logger::DEBUG);
2192 self::receiveRequestMakeFriend($importer, $contact);
2194 // refetch the contact array
2195 $contact = self::contactByHandle($importer["uid"], $author);
2197 // If we are now friends, we are sending a share message.
2198 // Normally we needn't to do so, but the first message could have been vanished.
2199 if (in_array($contact["rel"], [Contact::FRIEND])) {
2200 $user = DBA::selectFirst('user', [], ['uid' => $importer["uid"]]);
2201 if (DBA::isResult($user)) {
2202 Logger::log("Sending share message to author ".$author." - Contact: ".$contact["id"]." - User: ".$importer["uid"], Logger::DEBUG);
2203 self::sendShare($user, $contact);
2208 Logger::log("Author ".$author." doesn't want to follow us anymore.", Logger::DEBUG);
2209 Contact::removeFollower($importer, $contact);
2214 if (!$following && $sharing && in_array($importer["page-flags"], [User::PAGE_FLAGS_SOAPBOX, User::PAGE_FLAGS_NORMAL])) {
2215 Logger::log("Author ".$author." wants to share with us - but doesn't want to listen. Request is ignored.", Logger::DEBUG);
2217 } elseif (!$following && !$sharing) {
2218 Logger::log("Author ".$author." doesn't want anything - and we don't know the author. Request is ignored.", Logger::DEBUG);
2220 } elseif (!$following && $sharing) {
2221 Logger::log("Author ".$author." wants to share with us.", Logger::DEBUG);
2222 } elseif ($following && $sharing) {
2223 Logger::log("Author ".$author." wants to have a bidirectional conection.", Logger::DEBUG);
2224 } elseif ($following && !$sharing) {
2225 Logger::log("Author ".$author." wants to listen to us.", Logger::DEBUG);
2228 $ret = FContact::getByURL($author);
2230 if (!$ret || ($ret["network"] != Protocol::DIASPORA)) {
2231 Logger::log("Cannot resolve diaspora handle ".$author." for ".$recipient);
2235 $cid = Contact::getIdForURL($ret['url'], $importer['uid']);
2237 $contact = DBA::selectFirst('contact', [], ['id' => $cid, 'network' => Protocol::NATIVE_SUPPORT]);
2242 $item = ['author-id' => Contact::getIdForURL($ret['url']),
2243 'author-link' => $ret['url']];
2245 $result = Contact::addRelationship($importer, $contact, $item, false);
2246 if ($result === true) {
2247 $contact_record = self::contactByHandle($importer['uid'], $author);
2248 if (!$contact_record) {
2249 Logger::info('unable to locate newly created contact record.');
2253 $user = DBA::selectFirst('user', [], ['uid' => $importer['uid']]);
2254 if (DBA::isResult($user)) {
2255 self::sendShare($user, $contact_record);
2257 // Send the profile data, maybe it weren't transmitted before
2258 self::sendProfile($importer['uid'], [$contact_record]);
2266 * Fetches a message with a given guid
2268 * @param string $guid message guid
2269 * @param string $orig_author handle of the original post
2270 * @return array The fetched item
2271 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2272 * @throws \ImagickException
2274 public static function originalItem($guid, $orig_author)
2277 Logger::log('Empty guid. Quitting.');
2281 // Do we already have this item?
2282 $fields = ['body', 'title', 'app', 'created', 'object-type', 'uri', 'guid',
2283 'author-name', 'author-link', 'author-avatar', 'plink', 'uri-id'];
2284 $condition = ['guid' => $guid, 'visible' => true, 'deleted' => false, 'private' => [Item::PUBLIC, Item::UNLISTED]];
2285 $item = Item::selectFirst($fields, $condition);
2287 if (DBA::isResult($item)) {
2288 Logger::log("reshared message ".$guid." already exists on system.");
2290 // Maybe it is already a reshared item?
2291 // Then refetch the content, if it is a reshare from a reshare.
2292 // If it is a reshared post from another network then reformat to avoid display problems with two share elements
2293 if (self::isReshare($item["body"], true)) {
2295 } elseif (self::isReshare($item["body"], false) || strstr($item["body"], "[share")) {
2296 $item["body"] = Markdown::toBBCode(BBCode::toMarkdown($item["body"]));
2298 $item["body"] = self::replacePeopleGuid($item["body"], $item["author-link"]);
2300 // Add OEmbed and other information to the body
2301 $item["body"] = PageInfo::searchAndAppendToBody($item["body"], false, true);
2309 if (!DBA::isResult($item)) {
2310 if (empty($orig_author)) {
2311 Logger::log('Empty author for guid ' . $guid . '. Quitting.');
2315 $server = "https://".substr($orig_author, strpos($orig_author, "@") + 1);
2316 Logger::log("1st try: reshared message ".$guid." will be fetched via SSL from the server ".$server);
2317 $stored = self::storeByGuid($guid, $server);
2320 $server = "http://".substr($orig_author, strpos($orig_author, "@") + 1);
2321 Logger::log("2nd try: reshared message ".$guid." will be fetched without SSL from the server ".$server);
2322 $stored = self::storeByGuid($guid, $server);
2326 $fields = ['body', 'title', 'app', 'created', 'object-type', 'uri', 'guid',
2327 'author-name', 'author-link', 'author-avatar', 'plink', 'uri-id'];
2328 $condition = ['guid' => $guid, 'visible' => true, 'deleted' => false, 'private' => [Item::PUBLIC, Item::UNLISTED]];
2329 $item = Item::selectFirst($fields, $condition);
2331 if (DBA::isResult($item)) {
2332 // If it is a reshared post from another network then reformat to avoid display problems with two share elements
2333 if (self::isReshare($item["body"], false)) {
2334 $item["body"] = Markdown::toBBCode(BBCode::toMarkdown($item["body"]));
2335 $item["body"] = self::replacePeopleGuid($item["body"], $item["author-link"]);
2346 * Stores a reshare activity
2348 * @param array $item Array of reshare post
2349 * @param integer $parent_message_id Id of the parent post
2350 * @param string $guid GUID string of reshare action
2351 * @param string $author Author handle
2353 private static function addReshareActivity($item, $parent_message_id, $guid, $author)
2355 $parent = Item::selectFirst(['uri', 'guid'], ['id' => $parent_message_id]);
2359 $datarray['uid'] = $item['uid'];
2360 $datarray['contact-id'] = $item['contact-id'];
2361 $datarray['network'] = $item['network'];
2363 $datarray['author-link'] = $item['author-link'];
2364 $datarray['author-id'] = $item['author-id'];
2366 $datarray['owner-link'] = $datarray['author-link'];
2367 $datarray['owner-id'] = $datarray['author-id'];
2369 $datarray['guid'] = $parent['guid'] . '-' . $guid;
2370 $datarray['uri'] = self::getUriFromGuid($author, $datarray['guid']);
2371 $datarray['thr-parent'] = $parent['uri'];
2373 $datarray['verb'] = $datarray['body'] = Activity::ANNOUNCE;
2374 $datarray['gravity'] = GRAVITY_ACTIVITY;
2375 $datarray['object-type'] = Activity\ObjectType::NOTE;
2377 $datarray['protocol'] = $item['protocol'];
2379 $datarray['plink'] = self::plink($author, $datarray['guid']);
2380 $datarray['private'] = $item['private'];
2381 $datarray['changed'] = $datarray['created'] = $datarray['edited'] = $item['created'];
2383 if (Item::isTooOld($datarray)) {
2384 Logger::info('Reshare activity is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
2388 $message_id = Item::insert($datarray);
2391 Logger::info('Stored reshare activity.', ['guid' => $guid, 'id' => $message_id]);
2392 if ($datarray['uid'] == 0) {
2393 Item::distribute($message_id);
2399 * Processes a reshare message
2401 * @param array $importer Array of the importer user
2402 * @param object $data The message object
2403 * @param string $xml The original XML of the message
2405 * @return int the message id
2406 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2407 * @throws \ImagickException
2409 private static function receiveReshare(array $importer, $data, $xml)
2411 $author = Strings::escapeTags(XML::unescape($data->author));
2412 $guid = Strings::escapeTags(XML::unescape($data->guid));
2413 $created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($data->created_at)));
2414 $root_author = Strings::escapeTags(XML::unescape($data->root_author));
2415 $root_guid = Strings::escapeTags(XML::unescape($data->root_guid));
2416 /// @todo handle unprocessed property "provider_display_name"
2417 $public = Strings::escapeTags(XML::unescape($data->public));
2419 $contact = self::allowedContactByHandle($importer, $author, false);
2424 $message_id = self::messageExists($importer["uid"], $guid);
2429 $original_item = self::originalItem($root_guid, $root_author);
2430 if (!$original_item) {
2436 $datarray["uid"] = $importer["uid"];
2437 $datarray["contact-id"] = $contact["id"];
2438 $datarray["network"] = Protocol::DIASPORA;
2440 $datarray["author-link"] = $contact["url"];
2441 $datarray["author-id"] = Contact::getIdForURL($contact["url"], 0);
2443 $datarray["owner-link"] = $datarray["author-link"];
2444 $datarray["owner-id"] = $datarray["author-id"];
2446 $datarray["guid"] = $guid;
2447 $datarray["uri"] = $datarray["thr-parent"] = self::getUriFromGuid($author, $guid);
2448 $datarray['uri-id'] = ItemURI::insert(['uri' => $datarray['uri'], 'guid' => $datarray['guid']]);
2450 $datarray["verb"] = Activity::POST;
2451 $datarray["gravity"] = GRAVITY_PARENT;
2453 $datarray["protocol"] = Conversation::PARCEL_DIASPORA;
2454 $datarray["source"] = $xml;
2456 /// @todo Copy tag data from original post
2458 $prefix = BBCode::getShareOpeningTag(
2459 $original_item["author-name"],
2460 $original_item["author-link"],
2461 $original_item["author-avatar"],
2462 $original_item["plink"],
2463 $original_item["created"],
2464 $original_item["guid"]
2467 if (!empty($original_item['title'])) {
2468 $prefix .= '[h3]' . $original_item['title'] . "[/h3]\n";
2471 $datarray["body"] = $prefix.$original_item["body"]."[/share]";
2473 Tag::storeFromBody($datarray['uri-id'], $datarray["body"]);
2475 Post\Media::copy($original_item['uri-id'], $datarray['uri-id']);
2476 $datarray["app"] = $original_item["app"];
2478 $datarray["plink"] = self::plink($author, $guid);
2479 $datarray["private"] = (($public == "false") ? Item::PRIVATE : Item::PUBLIC);
2480 $datarray["changed"] = $datarray["created"] = $datarray["edited"] = $created_at;
2482 $datarray["object-type"] = $original_item["object-type"];
2484 self::fetchGuid($datarray);
2486 if (Item::isTooOld($datarray)) {
2487 Logger::info('Reshare is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
2491 $message_id = Item::insert($datarray);
2493 self::sendParticipation($contact, $datarray);
2495 $root_message_id = self::messageExists($importer["uid"], $root_guid);
2496 if ($root_message_id) {
2497 self::addReshareActivity($datarray, $root_message_id, $guid, $author);
2501 Logger::log("Stored reshare ".$datarray["guid"]." with message id ".$message_id, Logger::DEBUG);
2502 if ($datarray['uid'] == 0) {
2503 Item::distribute($message_id);
2512 * Processes retractions
2514 * @param array $importer Array of the importer user
2515 * @param array $contact The contact of the item owner
2516 * @param object $data The message object
2518 * @return bool success
2519 * @throws \Exception
2521 private static function itemRetraction(array $importer, array $contact, $data)
2523 $author = Strings::escapeTags(XML::unescape($data->author));
2524 $target_guid = Strings::escapeTags(XML::unescape($data->target_guid));
2525 $target_type = Strings::escapeTags(XML::unescape($data->target_type));
2527 $person = FContact::getByURL($author);
2528 if (!is_array($person)) {
2529 Logger::log("unable to find author detail for ".$author);
2533 if (empty($contact["url"])) {
2534 $contact["url"] = $person["url"];
2537 // Fetch items that are about to be deleted
2538 $fields = ['uid', 'id', 'parent', 'author-link', 'file'];
2540 // When we receive a public retraction, we delete every item that we find.
2541 if ($importer['uid'] == 0) {
2542 $condition = ['guid' => $target_guid, 'deleted' => false];
2544 $condition = ['guid' => $target_guid, 'deleted' => false, 'uid' => $importer['uid']];
2547 $r = Item::select($fields, $condition);
2548 if (!DBA::isResult($r)) {
2549 Logger::log("Target guid ".$target_guid." was not found on this system for user ".$importer['uid'].".");
2553 while ($item = Item::fetch($r)) {
2554 if (strstr($item['file'], '[')) {
2555 Logger::log("Target guid " . $target_guid . " for user " . $item['uid'] . " is filed. So it won't be deleted.", Logger::DEBUG);
2559 // Fetch the parent item
2560 $parent = Item::selectFirst(['author-link'], ['id' => $item['parent']]);
2562 // Only delete it if the parent author really fits
2563 if (!Strings::compareLink($parent["author-link"], $contact["url"]) && !Strings::compareLink($item["author-link"], $contact["url"])) {
2564 Logger::log("Thread author ".$parent["author-link"]." and item author ".$item["author-link"]." don't fit to expected contact ".$contact["url"], Logger::DEBUG);
2568 Item::markForDeletion(['id' => $item['id']]);
2570 Logger::log("Deleted target ".$target_guid." (".$item["id"].") from user ".$item["uid"]." parent: ".$item['parent'], Logger::DEBUG);
2577 * Receives retraction messages
2579 * @param array $importer Array of the importer user
2580 * @param string $sender The sender of the message
2581 * @param object $data The message object
2583 * @return bool Success
2584 * @throws \Exception
2586 private static function receiveRetraction(array $importer, $sender, $data)
2588 $target_type = Strings::escapeTags(XML::unescape($data->target_type));
2590 $contact = self::contactByHandle($importer["uid"], $sender);
2591 if (!$contact && (in_array($target_type, ["Contact", "Person"]))) {
2592 Logger::log("cannot find contact for sender: ".$sender." and user ".$importer["uid"]);
2600 Logger::log("Got retraction for ".$target_type.", sender ".$sender." and user ".$importer["uid"], Logger::DEBUG);
2602 switch ($target_type) {
2607 case "StatusMessage":
2608 return self::itemRetraction($importer, $contact, $data);
2610 case "PollParticipation":
2612 // Currently unsupported
2616 Logger::log("Unknown target type ".$target_type);
2623 * Checks if an incoming message is wanted
2625 * @param string $url
2626 * @param integer $uriid
2627 * @param string $author
2628 * @param string $body
2629 * @return boolean Is the message wanted?
2631 private static function isSolicitedMessage(string $url, int $uriid, string $author, string $body)
2633 $contact = Contact::getByURL($author);
2634 if (DBA::exists('contact', ["`nurl` = ? AND `uid` != ? AND `rel` IN (?, ?)",
2635 $contact['nurl'], 0, Contact::FRIEND, Contact::SHARING])) {
2636 Logger::info('Author has got followers - accepted', ['url' => $url, 'author' => $author]);
2640 $taglist = Tag::getByURIId($uriid, [Tag::HASHTAG]);
2641 $tags = array_column($taglist, 'name');
2642 return Relay::isSolicitedPost($tags, $body, $contact['id'], $url, Protocol::DIASPORA);
2646 * Store an attached photo in the post-media table
2649 * @param object $photo
2652 private static function storePhotoAsMedia(int $uriid, $photo)
2655 $data['uri-id'] = $uriid;
2656 $data['type'] = Post\Media::IMAGE;
2657 $data['url'] = XML::unescape($photo->remote_photo_path) . XML::unescape($photo->remote_photo_name);
2658 $data['height'] = (int)XML::unescape($photo->height ?? 0);
2659 $data['width'] = (int)XML::unescape($photo->width ?? 0);
2660 $data['description'] = XML::unescape($photo->text ?? '');
2662 Post\Media::insert($data);
2666 * Receives status messages
2668 * @param array $importer Array of the importer user
2669 * @param SimpleXMLElement $data The message object
2670 * @param string $xml The original XML of the message
2671 * @param bool $fetched The message had been fetched and not pushed
2672 * @return int The message id of the newly created item
2673 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2674 * @throws \ImagickException
2676 private static function receiveStatusMessage(array $importer, SimpleXMLElement $data, $xml, bool $fetched)
2678 $author = Strings::escapeTags(XML::unescape($data->author));
2679 $guid = Strings::escapeTags(XML::unescape($data->guid));
2680 $created_at = DateTimeFormat::utc(Strings::escapeTags(XML::unescape($data->created_at)));
2681 $public = Strings::escapeTags(XML::unescape($data->public));
2682 $text = XML::unescape($data->text);
2683 $provider_display_name = Strings::escapeTags(XML::unescape($data->provider_display_name));
2685 $contact = self::allowedContactByHandle($importer, $author, false);
2690 $message_id = self::messageExists($importer["uid"], $guid);
2696 if ($data->location) {
2697 foreach ($data->location->children() as $fieldname => $data) {
2698 $address[$fieldname] = Strings::escapeTags(XML::unescape($data));
2702 $raw_body = $body = Markdown::toBBCode($text);
2706 $datarray["guid"] = $guid;
2707 $datarray["uri"] = $datarray["thr-parent"] = self::getUriFromGuid($author, $guid);
2708 $datarray['uri-id'] = ItemURI::insert(['uri' => $datarray['uri'], 'guid' => $datarray['guid']]);
2710 // Attach embedded pictures to the body
2712 foreach ($data->photo as $photo) {
2713 self::storePhotoAsMedia($datarray['uri-id'], $photo);
2714 $body = "[img]".XML::unescape($photo->remote_photo_path).
2715 XML::unescape($photo->remote_photo_name)."[/img]\n".$body;
2718 $datarray["object-type"] = Activity\ObjectType::IMAGE;
2720 $datarray["object-type"] = Activity\ObjectType::NOTE;
2722 // Add OEmbed and other information to the body
2723 if (!self::isHubzilla($contact["url"])) {
2724 $body = PageInfo::searchAndAppendToBody($body, false, true);
2728 /// @todo enable support for polls
2729 //if ($data->poll) {
2730 // foreach ($data->poll AS $poll)
2735 /// @todo enable support for events
2737 $datarray["uid"] = $importer["uid"];
2738 $datarray["contact-id"] = $contact["id"];
2739 $datarray["network"] = Protocol::DIASPORA;
2741 $datarray["author-link"] = $contact["url"];
2742 $datarray["author-id"] = Contact::getIdForURL($contact["url"], 0);
2744 $datarray["owner-link"] = $datarray["author-link"];
2745 $datarray["owner-id"] = $datarray["author-id"];
2747 $datarray["verb"] = Activity::POST;
2748 $datarray["gravity"] = GRAVITY_PARENT;
2750 $datarray["protocol"] = Conversation::PARCEL_DIASPORA;
2751 $datarray["source"] = $xml;
2754 $datarray["post-type"] = Item::PT_FETCHED;
2755 } elseif ($datarray["uid"] == 0) {
2756 $datarray["post-type"] = Item::PT_GLOBAL;
2759 $datarray["body"] = self::replacePeopleGuid($body, $contact["url"]);
2760 $datarray["raw-body"] = self::replacePeopleGuid($raw_body, $contact["url"]);
2762 self::storeMentions($datarray['uri-id'], $text);
2763 Tag::storeRawTagsFromBody($datarray['uri-id'], $datarray["body"]);
2765 if (!$fetched && !self::isSolicitedMessage($datarray["uri"], $datarray['uri-id'], $author, $body)) {
2766 DBA::delete('item-uri', ['uri' => $datarray['uri']]);
2770 if ($provider_display_name != "") {
2771 $datarray["app"] = $provider_display_name;
2774 $datarray["plink"] = self::plink($author, $guid);
2775 $datarray["private"] = (($public == "false") ? Item::PRIVATE : Item::PUBLIC);
2776 $datarray["changed"] = $datarray["created"] = $datarray["edited"] = $created_at;
2778 if (isset($address["address"])) {
2779 $datarray["location"] = $address["address"];
2782 if (isset($address["lat"]) && isset($address["lng"])) {
2783 $datarray["coord"] = $address["lat"]." ".$address["lng"];
2786 self::fetchGuid($datarray);
2788 if (Item::isTooOld($datarray)) {
2789 Logger::info('Status is too old', ['created' => $datarray['created'], 'uid' => $datarray['uid'], 'guid' => $datarray['guid']]);
2793 $message_id = Item::insert($datarray);
2795 self::sendParticipation($contact, $datarray);
2798 Logger::log("Stored item ".$datarray["guid"]." with message id ".$message_id, Logger::DEBUG);
2799 if ($datarray['uid'] == 0) {
2800 Item::distribute($message_id);
2808 /* ************************************************************************************** *
2809 * Here are all the functions that are needed to transmit data with the Diaspora protocol *
2810 * ************************************************************************************** */
2813 * returnes the handle of a contact
2815 * @param array $contact contact array
2817 * @return string the handle in the format user@domain.tld
2818 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2820 private static function myHandle(array $contact)
2822 if (!empty($contact["addr"])) {
2823 return $contact["addr"];
2826 // Normally we should have a filled "addr" field - but in the past this wasn't the case
2827 // So - just in case - we build the the address here.
2828 if ($contact["nickname"] != "") {
2829 $nick = $contact["nickname"];
2831 $nick = $contact["nick"];
2834 return $nick . "@" . substr(DI::baseUrl(), strpos(DI::baseUrl(), "://") + 3);
2839 * Creates the data for a private message in the new format
2841 * @param string $msg The message that is to be transmitted
2842 * @param array $user The record of the sender
2843 * @param array $contact Target of the communication
2844 * @param string $prvkey The private key of the sender
2845 * @param string $pubkey The public key of the receiver
2847 * @return string The encrypted data
2848 * @throws \Exception
2850 public static function encodePrivateData($msg, array $user, array $contact, $prvkey, $pubkey)
2852 Logger::log("Message: ".$msg, Logger::DATA);
2854 // without a public key nothing will work
2856 Logger::log("pubkey missing: contact id: ".$contact["id"]);
2860 $aes_key = openssl_random_pseudo_bytes(32);
2861 $b_aes_key = base64_encode($aes_key);
2862 $iv = openssl_random_pseudo_bytes(16);
2863 $b_iv = base64_encode($iv);
2865 $ciphertext = self::aesEncrypt($aes_key, $iv, $msg);
2867 $json = json_encode(["iv" => $b_iv, "key" => $b_aes_key]);
2869 $encrypted_key_bundle = "";
2870 if (!@openssl_public_encrypt($json, $encrypted_key_bundle, $pubkey)) {
2874 $json_object = json_encode(
2875 ["aes_key" => base64_encode($encrypted_key_bundle),
2876 "encrypted_magic_envelope" => base64_encode($ciphertext)]
2879 return $json_object;
2883 * Creates the envelope for the "fetch" endpoint and for the new format
2885 * @param string $msg The message that is to be transmitted
2886 * @param array $user The record of the sender
2888 * @return string The envelope
2889 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2891 public static function buildMagicEnvelope($msg, array $user)
2893 $b64url_data = Strings::base64UrlEncode($msg);
2894 $data = str_replace(["\n", "\r", " ", "\t"], ["", "", "", ""], $b64url_data);
2896 $key_id = Strings::base64UrlEncode(self::myHandle($user));
2897 $type = "application/xml";
2898 $encoding = "base64url";
2899 $alg = "RSA-SHA256";
2900 $signable_data = $data.".".Strings::base64UrlEncode($type).".".Strings::base64UrlEncode($encoding).".".Strings::base64UrlEncode($alg);
2902 // Fallback if the private key wasn't transmitted in the expected field
2903 if ($user['uprvkey'] == "") {
2904 $user['uprvkey'] = $user['prvkey'];
2907 $signature = Crypto::rsaSign($signable_data, $user["uprvkey"]);
2908 $sig = Strings::base64UrlEncode($signature);
2910 $xmldata = ["me:env" => ["me:data" => $data,
2911 "@attributes" => ["type" => $type],
2912 "me:encoding" => $encoding,
2915 "@attributes2" => ["key_id" => $key_id]]];
2917 $namespaces = ["me" => "http://salmon-protocol.org/ns/magic-env"];
2919 return XML::fromArray($xmldata, $xml, false, $namespaces);
2923 * Create the envelope for a message
2925 * @param string $msg The message that is to be transmitted
2926 * @param array $user The record of the sender
2927 * @param array $contact Target of the communication
2928 * @param string $prvkey The private key of the sender
2929 * @param string $pubkey The public key of the receiver
2930 * @param bool $public Is the message public?
2932 * @return string The message that will be transmitted to other servers
2933 * @throws \Exception
2935 public static function buildMessage($msg, array $user, array $contact, $prvkey, $pubkey, $public = false)
2937 // The message is put into an envelope with the sender's signature
2938 $envelope = self::buildMagicEnvelope($msg, $user);
2940 // Private messages are put into a second envelope, encrypted with the receivers public key
2942 $envelope = self::encodePrivateData($envelope, $user, $contact, $prvkey, $pubkey);
2949 * Creates a signature for a message
2951 * @param array $owner the array of the owner of the message
2952 * @param array $message The message that is to be signed
2954 * @return string The signature
2956 private static function signature($owner, $message)
2959 unset($sigmsg["author_signature"]);
2960 unset($sigmsg["parent_author_signature"]);
2962 $signed_text = implode(";", $sigmsg);
2964 return base64_encode(Crypto::rsaSign($signed_text, $owner["uprvkey"], "sha256"));
2968 * Transmit a message to a target server
2970 * @param array $owner the array of the item owner
2971 * @param array $contact Target of the communication
2972 * @param string $envelope The message that is to be transmitted
2973 * @param bool $public_batch Is it a public post?
2974 * @param string $guid message guid
2976 * @return int Result of the transmission
2977 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2978 * @throws \ImagickException
2980 private static function transmit(array $owner, array $contact, $envelope, $public_batch, $guid = "")
2982 $enabled = intval(DI::config()->get("system", "diaspora_enabled"));
2987 $logid = Strings::getRandomHex(4);
2989 // We always try to use the data from the fcontact table.
2990 // This is important for transmitting data to Friendica servers.
2991 if (!empty($contact['addr'])) {
2992 $fcontact = FContact::getByURL($contact['addr']);
2993 if (!empty($fcontact)) {
2994 $dest_url = ($public_batch ? $fcontact["batch"] : $fcontact["notify"]);
2998 if (empty($dest_url)) {
2999 $dest_url = ($public_batch ? $contact["batch"] : $contact["notify"]);
3003 Logger::log("no url for contact: ".$contact["id"]." batch mode =".$public_batch);
3007 Logger::log("transmit: ".$logid."-".$guid." ".$dest_url);
3009 if (!intval(DI::config()->get("system", "diaspora_test"))) {
3010 $content_type = (($public_batch) ? "application/magic-envelope+xml" : "application/json");
3012 $postResult = DI::httpRequest()->post($dest_url . "/", $envelope, ["Content-Type: " . $content_type]);
3013 $return_code = $postResult->getReturnCode();
3015 Logger::log("test_mode");
3019 Logger::log("transmit: ".$logid."-".$guid." to ".$dest_url." returns: ".$return_code);
3021 return $return_code ? $return_code : -1;
3026 * Build the post xml
3028 * @param string $type The message type
3029 * @param array $message The message data
3031 * @return string The post XML
3033 public static function buildPostXml($type, $message)
3035 $data = [$type => $message];
3037 return XML::fromArray($data, $xml);
3041 * Builds and transmit messages
3043 * @param array $owner the array of the item owner
3044 * @param array $contact Target of the communication
3045 * @param string $type The message type
3046 * @param array $message The message data
3047 * @param bool $public_batch Is it a public post?
3048 * @param string $guid message guid
3050 * @return int Result of the transmission
3051 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3052 * @throws \ImagickException
3054 private static function buildAndTransmit(array $owner, array $contact, $type, $message, $public_batch = false, $guid = "")
3056 $msg = self::buildPostXml($type, $message);
3058 Logger::log('message: '.$msg, Logger::DATA);
3059 Logger::log('send guid '.$guid, Logger::DEBUG);
3061 // Fallback if the private key wasn't transmitted in the expected field
3062 if (empty($owner['uprvkey'])) {
3063 $owner['uprvkey'] = $owner['prvkey'];
3066 // When sending content to Friendica contacts using the Diaspora protocol
3067 // we have to fetch the public key from the fcontact.
3068 // This is due to the fact that legacy DFRN had unique keys for every contact.
3069 $pubkey = $contact['pubkey'];
3070 if (!empty($contact['addr'])) {
3071 $fcontact = FContact::getByURL($contact['addr']);
3072 if (!empty($fcontact)) {
3073 $pubkey = $fcontact['pubkey'];
3077 $envelope = self::buildMessage($msg, $owner, $contact, $owner['uprvkey'], $pubkey, $public_batch);
3079 $return_code = self::transmit($owner, $contact, $envelope, $public_batch, $guid);
3081 Logger::log("guid: ".$guid." result ".$return_code, Logger::DEBUG);
3083 return $return_code;
3087 * sends a participation (Used to get all further updates)
3089 * @param array $contact Target of the communication
3090 * @param array $item Item array
3092 * @return int The result of the transmission
3093 * @throws \Exception
3095 private static function sendParticipation(array $contact, array $item)
3097 // Don't send notifications for private postings
3098 if ($item['private'] == Item::PRIVATE) {
3102 $cachekey = "diaspora:sendParticipation:".$item['guid'];
3104 $result = DI::cache()->get($cachekey);
3105 if (!is_null($result)) {
3109 // Fetch some user id to have a valid handle to transmit the participation.
3110 // In fact it doesn't matter which user sends this - but it is needed by the protocol.
3111 // If the item belongs to a user, we take this user id.
3112 if ($item['uid'] == 0) {
3113 $condition = ['verified' => true, 'blocked' => false, 'account_removed' => false, 'account_expired' => false];
3114 $first_user = DBA::selectFirst('user', ['uid'], $condition);
3115 $owner = User::getOwnerDataById($first_user['uid']);
3117 $owner = User::getOwnerDataById($item['uid']);
3120 $author = self::myHandle($owner);
3122 $message = ["author" => $author,
3123 "guid" => System::createUUID(),
3124 "parent_type" => "Post",
3125 "parent_guid" => $item["guid"]];
3127 Logger::log("Send participation for ".$item["guid"]." by ".$author, Logger::DEBUG);
3129 // It doesn't matter what we store, we only want to avoid sending repeated notifications for the same item
3130 DI::cache()->set($cachekey, $item["guid"], Duration::QUARTER_HOUR);
3132 return self::buildAndTransmit($owner, $contact, "participation", $message);
3136 * sends an account migration
3138 * @param array $owner the array of the item owner
3139 * @param array $contact Target of the communication
3140 * @param int $uid User ID
3142 * @return int The result of the transmission
3143 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3144 * @throws \ImagickException
3146 public static function sendAccountMigration(array $owner, array $contact, $uid)
3148 $old_handle = DI::pConfig()->get($uid, 'system', 'previous_addr');
3149 $profile = self::createProfileData($uid);
3151 $signed_text = 'AccountMigration:'.$old_handle.':'.$profile['author'];
3152 $signature = base64_encode(Crypto::rsaSign($signed_text, $owner["uprvkey"], "sha256"));
3154 $message = ["author" => $old_handle,
3155 "profile" => $profile,
3156 "signature" => $signature];
3158 Logger::info('Send account migration', ['msg' => $message]);
3160 return self::buildAndTransmit($owner, $contact, "account_migration", $message);
3164 * Sends a "share" message
3166 * @param array $owner the array of the item owner
3167 * @param array $contact Target of the communication
3169 * @return int The result of the transmission
3170 * @throws \Exception
3172 public static function sendShare(array $owner, array $contact)
3175 * @todo support the different possible combinations of "following" and "sharing"
3176 * Currently, Diaspora only interprets the "sharing" field
3178 * Before switching this code productive, we have to check all "sendShare" calls if "rel" is set correctly
3182 switch ($contact["rel"]) {
3183 case Contact::FRIEND:
3187 case Contact::SHARING:
3191 case Contact::FOLLOWER:
3197 $message = ["author" => self::myHandle($owner),
3198 "recipient" => $contact["addr"],
3199 "following" => "true",
3200 "sharing" => "true"];
3202 Logger::info('Send share', ['msg' => $message]);
3204 return self::buildAndTransmit($owner, $contact, "contact", $message);
3208 * sends an "unshare"
3210 * @param array $owner the array of the item owner
3211 * @param array $contact Target of the communication
3213 * @return int The result of the transmission
3214 * @throws \Exception
3216 public static function sendUnshare(array $owner, array $contact)
3218 $message = ["author" => self::myHandle($owner),
3219 "recipient" => $contact["addr"],
3220 "following" => "false",
3221 "sharing" => "false"];
3223 Logger::info('Send unshare', ['msg' => $message]);
3225 return self::buildAndTransmit($owner, $contact, "contact", $message);
3229 * Checks a message body if it is a reshare
3231 * @param string $body The message body that is to be check
3232 * @param bool $complete Should it be a complete check or a simple check?
3234 * @return array|bool Reshare details or "false" if no reshare
3235 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3236 * @throws \ImagickException
3238 public static function isReshare($body, $complete = true)
3240 $body = trim($body);
3242 $reshared = Item::getShareArray(['body' => $body]);
3243 if (empty($reshared)) {
3247 // Skip if it isn't a pure repeated messages
3248 // Does it start with a share?
3249 if (!empty($reshared['comment']) && $complete) {
3253 if (!empty($reshared['guid']) && $complete) {
3254 $condition = ['guid' => $reshared['guid'], 'network' => [Protocol::DFRN, Protocol::DIASPORA]];
3255 $item = Item::selectFirst(['contact-id'], $condition);
3256 if (DBA::isResult($item)) {
3258 $ret["root_handle"] = self::handleFromContact($item["contact-id"]);
3259 $ret["root_guid"] = $reshared['guid'];
3261 } elseif ($complete) {
3262 // We are resharing something that isn't a DFRN or Diaspora post.
3263 // So we have to return "false" on "$complete" to not trigger a reshare.
3266 } elseif (empty($reshared['guid']) && $complete) {
3272 if (!empty($reshared['profile']) && ($cid = Contact::getIdForURL($reshared['profile']))) {
3273 $contact = DBA::selectFirst('contact', ['addr'], ['id' => $cid]);
3274 if (!empty($contact['addr'])) {
3275 $ret['root_handle'] = $contact['addr'];
3279 if (empty($ret) && !$complete) {
3287 * Create an event array
3289 * @param integer $event_id The id of the event
3291 * @return array with event data
3292 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3294 private static function buildEvent($event_id)
3296 $r = q("SELECT `guid`, `uid`, `start`, `finish`, `nofinish`, `summary`, `desc`, `location`, `adjust` FROM `event` WHERE `id` = %d", intval($event_id));
3297 if (!DBA::isResult($r)) {
3305 $r = q("SELECT `timezone` FROM `user` WHERE `uid` = %d", intval($event['uid']));
3306 if (!DBA::isResult($r)) {
3312 $r = q("SELECT `addr`, `nick` FROM `contact` WHERE `uid` = %d AND `self`", intval($event['uid']));
3313 if (!DBA::isResult($r)) {
3319 $eventdata['author'] = self::myHandle($owner);
3321 if ($event['guid']) {
3322 $eventdata['guid'] = $event['guid'];
3325 $mask = DateTimeFormat::ATOM;
3327 /// @todo - establish "all day" events in Friendica
3328 $eventdata["all_day"] = "false";
3330 $eventdata['timezone'] = 'UTC';
3331 if (!$event['adjust'] && $user['timezone']) {
3332 $eventdata['timezone'] = $user['timezone'];
3335 if ($event['start']) {
3336 $eventdata['start'] = DateTimeFormat::convert($event['start'], "UTC", $eventdata['timezone'], $mask);
3338 if ($event['finish'] && !$event['nofinish']) {
3339 $eventdata['end'] = DateTimeFormat::convert($event['finish'], "UTC", $eventdata['timezone'], $mask);
3341 if ($event['summary']) {
3342 $eventdata['summary'] = html_entity_decode(BBCode::toMarkdown($event['summary']));
3344 if ($event['desc']) {
3345 $eventdata['description'] = html_entity_decode(BBCode::toMarkdown($event['desc']));
3347 if ($event['location']) {
3348 $event['location'] = preg_replace("/\[map\](.*?)\[\/map\]/ism", '$1', $event['location']);
3349 $coord = Map::getCoordinates($event['location']);
3352 $location["address"] = html_entity_decode(BBCode::toMarkdown($event['location']));
3353 if (!empty($coord['lat']) && !empty($coord['lon'])) {
3354 $location["lat"] = $coord['lat'];
3355 $location["lng"] = $coord['lon'];
3357 $location["lat"] = 0;
3358 $location["lng"] = 0;
3360 $eventdata['location'] = $location;
3367 * Create a post (status message or reshare)
3369 * @param array $item The item that will be exported
3370 * @param array $owner the array of the item owner
3373 * 'type' -> Message type ("status_message" or "reshare")
3374 * 'message' -> Array of XML elements of the status
3375 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3376 * @throws \ImagickException
3378 public static function buildStatus(array $item, array $owner)
3380 $cachekey = "diaspora:buildStatus:".$item['guid'];
3382 $result = DI::cache()->get($cachekey);
3383 if (!is_null($result)) {
3387 $myaddr = self::myHandle($owner);
3389 $public = ($item["private"] == Item::PRIVATE ? "false" : "true");
3390 $created = DateTimeFormat::utc($item['received'], DateTimeFormat::ATOM);
3391 $edited = DateTimeFormat::utc($item["edited"] ?? $item["created"], DateTimeFormat::ATOM);
3393 // Detect a share element and do a reshare
3394 if (($item['private'] != Item::PRIVATE) && ($ret = self::isReshare($item["body"]))) {
3395 $message = ["author" => $myaddr,
3396 "guid" => $item["guid"],
3397 "created_at" => $created,
3398 "root_author" => $ret["root_handle"],
3399 "root_guid" => $ret["root_guid"],
3400 "provider_display_name" => $item["app"],
3401 "public" => $public];
3405 $title = $item["title"];
3406 $body = $item["body"];
3408 // Fetch the title from an attached link - if there is one
3409 if (empty($item["title"]) && DI::pConfig()->get($owner['uid'], 'system', 'attach_link_title')) {
3410 $page_data = BBCode::getAttachmentData($item['body']);
3411 if (!empty($page_data['type']) && !empty($page_data['title']) && ($page_data['type'] == 'link')) {
3412 $title = $page_data['title'];
3416 if ($item['author-link'] != $item['owner-link']) {
3417 $body = BBCode::getShareOpeningTag($item['author-name'], $item['author-link'], $item['author-avatar'],
3418 $item['plink'], $item['created']) . $body . '[/share]';
3421 // convert to markdown
3422 $body = html_entity_decode(BBCode::toMarkdown($body));
3425 if (strlen($title)) {
3426 $body = "### ".html_entity_decode($title)."\n\n".$body;
3429 $attachments = Post\Media::getByURIId($item['uri-id'], [Post\Media::DOCUMENT, Post\Media::TORRENT, Post\Media::UNKNOWN]);
3430 if (!empty($attachments)) {
3431 $body .= "\n".DI::l10n()->t("Attachments:")."\n";
3432 foreach ($attachments as $attachment) {
3433 $body .= "[" . $attachment['description'] . "](" . $attachment['url'] . ")\n";
3439 if ($item["location"] != "")
3440 $location["address"] = $item["location"];
3442 if ($item["coord"] != "") {
3443 $coord = explode(" ", $item["coord"]);
3444 $location["lat"] = $coord[0];
3445 $location["lng"] = $coord[1];
3448 $message = ["author" => $myaddr,
3449 "guid" => $item["guid"],
3450 "created_at" => $created,
3451 "edited_at" => $edited,
3452 "public" => $public,
3454 "provider_display_name" => $item["app"],
3455 "location" => $location];
3457 // Diaspora rejects messages when they contain a location without "lat" or "lng"
3458 if (!isset($location["lat"]) || !isset($location["lng"])) {
3459 unset($message["location"]);
3462 if ($item['event-id'] > 0) {
3463 $event = self::buildEvent($item['event-id']);
3464 if (count($event)) {
3465 $message['event'] = $event;
3467 if (!empty($event['location']['address']) &&
3468 !empty($event['location']['lat']) &&
3469 !empty($event['location']['lng'])) {
3470 $message['location'] = $event['location'];
3473 /// @todo Once Diaspora supports it, we will remove the body and the location hack above
3474 // $message['text'] = '';
3478 $type = "status_message";
3481 $msg = ["type" => $type, "message" => $message];
3483 DI::cache()->set($cachekey, $msg, Duration::QUARTER_HOUR);
3488 private static function prependParentAuthorMention($body, $profile_url)
3490 $profile = Contact::getByURL($profile_url, false, ['addr', 'name', 'contact-type']);
3491 if (!empty($profile['addr'])
3492 && $profile['contact-type'] != Contact::TYPE_COMMUNITY
3493 && !strstr($body, $profile['addr'])
3494 && !strstr($body, $profile_url)
3496 $body = '@[url=' . $profile_url . ']' . $profile['name'] . '[/url] ' . $body;
3505 * @param array $item The item that will be exported
3506 * @param array $owner the array of the item owner
3507 * @param array $contact Target of the communication
3508 * @param bool $public_batch Is it a public post?
3510 * @return int The result of the transmission
3511 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3512 * @throws \ImagickException
3514 public static function sendStatus(array $item, array $owner, array $contact, $public_batch = false)
3516 $status = self::buildStatus($item, $owner);
3518 return self::buildAndTransmit($owner, $contact, $status["type"], $status["message"], $public_batch, $item["guid"]);
3522 * Creates a "like" object
3524 * @param array $item The item that will be exported
3525 * @param array $owner the array of the item owner
3527 * @return array The data for a "like"
3528 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3530 private static function constructLike(array $item, array $owner)
3532 $parent = Item::selectFirst(['guid', 'uri', 'thr-parent'], ['uri' => $item["thr-parent"]]);
3533 if (!DBA::isResult($parent)) {
3537 $target_type = ($parent["uri"] === $parent["thr-parent"] ? "Post" : "Comment");
3539 if ($item['verb'] === Activity::LIKE) {
3541 } elseif ($item['verb'] === Activity::DISLIKE) {
3542 $positive = "false";
3545 return(["author" => self::myHandle($owner),
3546 "guid" => $item["guid"],
3547 "parent_guid" => $parent["guid"],
3548 "parent_type" => $target_type,
3549 "positive" => $positive,
3550 "author_signature" => ""]);
3554 * Creates an "EventParticipation" object
3556 * @param array $item The item that will be exported
3557 * @param array $owner the array of the item owner
3559 * @return array The data for an "EventParticipation"
3560 * @throws \Exception
3562 private static function constructAttend(array $item, array $owner)
3564 $parent = Item::selectFirst(['guid'], ['uri' => $item['thr-parent']]);
3565 if (!DBA::isResult($parent)) {
3569 switch ($item['verb']) {
3570 case Activity::ATTEND:
3571 $attend_answer = 'accepted';
3573 case Activity::ATTENDNO:
3574 $attend_answer = 'declined';
3576 case Activity::ATTENDMAYBE:
3577 $attend_answer = 'tentative';
3580 Logger::log('Unknown verb '.$item['verb'].' in item '.$item['guid']);
3584 return(["author" => self::myHandle($owner),
3585 "guid" => $item["guid"],
3586 "parent_guid" => $parent["guid"],
3587 "status" => $attend_answer,
3588 "author_signature" => ""]);
3592 * Creates the object for a comment
3594 * @param array $item The item that will be exported
3595 * @param array $owner the array of the item owner
3597 * @return array|false The data for a comment
3598 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3600 private static function constructComment(array $item, array $owner)
3602 $cachekey = "diaspora:constructComment:".$item['guid'];
3604 $result = DI::cache()->get($cachekey);
3605 if (!is_null($result)) {
3609 $toplevel_item = Item::selectFirst(['guid', 'author-id', 'author-link'], ['id' => $item['parent'], 'parent' => $item['parent']]);
3610 if (!DBA::isResult($toplevel_item)) {
3611 Logger::error('Missing parent conversation item', ['parent' => $item['parent']]);
3615 $thread_parent_item = $toplevel_item;
3616 if ($item['thr-parent'] != $item['parent-uri']) {
3617 $thread_parent_item = Item::selectFirst(['guid', 'author-id', 'author-link'], ['uri' => $item['thr-parent'], 'uid' => $item['uid']]);
3620 $body = $item["body"];
3622 // The replied to autor mention is prepended for clarity if:
3623 // - Item replied isn't yours
3624 // - Item is public or explicit mentions are disabled
3625 // - Implicit mentions are enabled
3627 $item['author-id'] != $thread_parent_item['author-id']
3628 && (empty($item['uid']) || !Feature::isEnabled($item['uid'], 'explicit_mentions'))
3629 && !DI::config()->get('system', 'disable_implicit_mentions')
3631 $body = self::prependParentAuthorMention($body, $thread_parent_item['author-link']);
3634 $text = html_entity_decode(BBCode::toMarkdown($body));
3635 $created = DateTimeFormat::utc($item["created"], DateTimeFormat::ATOM);
3636 $edited = DateTimeFormat::utc($item["edited"], DateTimeFormat::ATOM);
3639 "author" => self::myHandle($owner),
3640 "guid" => $item["guid"],
3641 "created_at" => $created,
3642 "edited_at" => $edited,
3643 "parent_guid" => $toplevel_item["guid"],
3645 "author_signature" => ""
3648 // Send the thread parent guid only if it is a threaded comment
3649 if ($item['thr-parent'] != $item['parent-uri']) {
3650 $comment['thread_parent_guid'] = $thread_parent_item['guid'];
3653 DI::cache()->set($cachekey, $comment, Duration::QUARTER_HOUR);
3659 * Send a like or a comment
3661 * @param array $item The item that will be exported
3662 * @param array $owner the array of the item owner
3663 * @param array $contact Target of the communication
3664 * @param bool $public_batch Is it a public post?
3666 * @return int The result of the transmission
3667 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3668 * @throws \ImagickException
3670 public static function sendFollowup(array $item, array $owner, array $contact, $public_batch = false)
3672 if (in_array($item['verb'], [Activity::ATTEND, Activity::ATTENDNO, Activity::ATTENDMAYBE])) {
3673 $message = self::constructAttend($item, $owner);
3674 $type = "event_participation";
3675 } elseif (in_array($item["verb"], [Activity::LIKE, Activity::DISLIKE])) {
3676 $message = self::constructLike($item, $owner);
3678 } elseif (!in_array($item["verb"], [Activity::FOLLOW, Activity::TAG])) {
3679 $message = self::constructComment($item, $owner);
3683 if (empty($message)) {
3687 $message["author_signature"] = self::signature($owner, $message);
3689 return self::buildAndTransmit($owner, $contact, $type, $message, $public_batch, $item["guid"]);
3693 * Creates a message from a signature record entry
3695 * @param array $item The item that will be exported
3696 * @return array The message
3698 private static function messageFromSignature(array $item)
3700 // Split the signed text
3701 $signed_parts = explode(";", $item['signed_text']);
3703 if ($item["deleted"]) {
3704 $message = ["author" => $item['signer'],
3705 "target_guid" => $signed_parts[0],
3706 "target_type" => $signed_parts[1]];
3707 } elseif (in_array($item["verb"], [Activity::LIKE, Activity::DISLIKE])) {
3708 $message = ["author" => $signed_parts[4],
3709 "guid" => $signed_parts[1],
3710 "parent_guid" => $signed_parts[3],
3711 "parent_type" => $signed_parts[2],
3712 "positive" => $signed_parts[0],
3713 "author_signature" => $item['signature'],
3714 "parent_author_signature" => ""];
3716 // Remove the comment guid
3717 $guid = array_shift($signed_parts);
3719 // Remove the parent guid
3720 $parent_guid = array_shift($signed_parts);
3722 // Remove the handle
3723 $handle = array_pop($signed_parts);
3726 "author" => $handle,
3728 "parent_guid" => $parent_guid,
3729 "text" => implode(";", $signed_parts),
3730 "author_signature" => $item['signature'],
3731 "parent_author_signature" => ""
3738 * Relays messages (like, comment, retraction) to other servers if we are the thread owner
3740 * @param array $item The item that will be exported
3741 * @param array $owner the array of the item owner
3742 * @param array $contact Target of the communication
3743 * @param bool $public_batch Is it a public post?
3745 * @return int The result of the transmission
3746 * @throws \Exception
3748 public static function sendRelay(array $item, array $owner, array $contact, $public_batch = false)
3750 if ($item["deleted"]) {
3751 return self::sendRetraction($item, $owner, $contact, $public_batch, true);
3752 } elseif (in_array($item["verb"], [Activity::LIKE, Activity::DISLIKE])) {
3758 Logger::log("Got relayable data ".$type." for item ".$item["guid"]." (".$item["id"].")", Logger::DEBUG);
3760 $msg = json_decode($item['signed_text'], true);
3763 if (is_array($msg)) {
3764 foreach ($msg as $field => $data) {
3765 if (!$item["deleted"]) {
3766 if ($field == "diaspora_handle") {
3769 if ($field == "target_type") {
3770 $field = "parent_type";
3774 $message[$field] = $data;
3777 Logger::log("Signature text for item ".$item["guid"]." (".$item["id"].") couldn't be extracted: ".$item['signed_text'], Logger::DEBUG);
3780 $message["parent_author_signature"] = self::signature($owner, $message);
3782 Logger::info('Relayed data', ['msg' => $message]);
3784 return self::buildAndTransmit($owner, $contact, $type, $message, $public_batch, $item["guid"]);
3788 * Sends a retraction (deletion) of a message, like or comment
3790 * @param array $item The item that will be exported
3791 * @param array $owner the array of the item owner
3792 * @param array $contact Target of the communication
3793 * @param bool $public_batch Is it a public post?
3794 * @param bool $relay Is the retraction transmitted from a relay?
3796 * @return int The result of the transmission
3797 * @throws \Exception
3799 public static function sendRetraction(array $item, array $owner, array $contact, $public_batch = false, $relay = false)
3801 $itemaddr = self::handleFromContact($item["contact-id"], $item["author-id"]);
3803 $msg_type = "retraction";
3805 if ($item['gravity'] == GRAVITY_PARENT) {
3806 $target_type = "Post";
3807 } elseif (in_array($item["verb"], [Activity::LIKE, Activity::DISLIKE])) {
3808 $target_type = "Like";
3810 $target_type = "Comment";
3813 $message = ["author" => $itemaddr,
3814 "target_guid" => $item['guid'],
3815 "target_type" => $target_type];
3817 Logger::info('Got message', ['msg' => $message]);
3819 return self::buildAndTransmit($owner, $contact, $msg_type, $message, $public_batch, $item["guid"]);
3825 * @param array $item The item that will be exported
3826 * @param array $owner The owner
3827 * @param array $contact Target of the communication
3829 * @return int The result of the transmission
3830 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3831 * @throws \ImagickException
3833 public static function sendMail(array $item, array $owner, array $contact)
3835 $myaddr = self::myHandle($owner);
3837 $cnv = DBA::selectFirst('conv', [], ['id' => $item["convid"], 'uid' => $item["uid"]]);
3838 if (!DBA::isResult($cnv)) {
3839 Logger::log("conversation not found.");
3843 $body = BBCode::toMarkdown($item["body"]);
3844 $created = DateTimeFormat::utc($item["created"], DateTimeFormat::ATOM);
3847 "author" => $myaddr,
3848 "guid" => $item["guid"],
3849 "conversation_guid" => $cnv["guid"],
3851 "created_at" => $created,
3854 if ($item["reply"]) {
3859 "author" => $cnv["creator"],
3860 "guid" => $cnv["guid"],
3861 "subject" => $cnv["subject"],
3862 "created_at" => DateTimeFormat::utc($cnv['created'], DateTimeFormat::ATOM),
3863 "participants" => $cnv["recips"],
3867 $type = "conversation";
3870 return self::buildAndTransmit($owner, $contact, $type, $message, false, $item["guid"]);
3874 * Split a name into first name and last name
3876 * @param string $name The name
3878 * @return array The array with "first" and "last"
3880 public static function splitName($name) {
3881 $name = trim($name);
3883 // Is the name longer than 64 characters? Then cut the rest of it.
3884 if (strlen($name) > 64) {
3885 if ((strpos($name, ' ') <= 64) && (strpos($name, ' ') !== false)) {
3886 $name = trim(substr($name, 0, strrpos(substr($name, 0, 65), ' ')));
3888 $name = substr($name, 0, 64);
3892 // Take the first word as first name
3893 $first = ((strpos($name, ' ') ? trim(substr($name, 0, strpos($name, ' '))) : $name));
3894 $last = (($first === $name) ? '' : trim(substr($name, strlen($first))));
3895 if ((strlen($first) < 32) && (strlen($last) < 32)) {
3896 return ['first' => $first, 'last' => $last];
3899 // Take the last word as last name
3900 $first = ((strrpos($name, ' ') ? trim(substr($name, 0, strrpos($name, ' '))) : $name));
3901 $last = (($first === $name) ? '' : trim(substr($name, strlen($first))));
3903 if ((strlen($first) < 32) && (strlen($last) < 32)) {
3904 return ['first' => $first, 'last' => $last];
3907 // Take the first 32 characters if there is no space in the first 32 characters
3908 if ((strpos($name, ' ') > 32) || (strpos($name, ' ') === false)) {
3909 $first = substr($name, 0, 32);
3910 $last = substr($name, 32);
3911 return ['first' => $first, 'last' => $last];
3914 $first = trim(substr($name, 0, strrpos(substr($name, 0, 33), ' ')));
3915 $last = (($first === $name) ? '' : trim(substr($name, strlen($first))));
3917 // Check if the last name is longer than 32 characters
3918 if (strlen($last) > 32) {
3919 if (strpos($last, ' ') <= 32) {
3920 $last = trim(substr($last, 0, strrpos(substr($last, 0, 33), ' ')));
3922 $last = substr($last, 0, 32);
3926 return ['first' => $first, 'last' => $last];
3930 * Create profile data
3932 * @param int $uid The user id
3934 * @return array The profile data
3935 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
3937 private static function createProfileData($uid)
3939 $profile = DBA::selectFirst('owner-view', ['uid', 'addr', 'name', 'location', 'net-publish', 'dob', 'about', 'pub_keywords'], ['uid' => $uid]);
3940 if (!DBA::isResult($profile)) {
3944 $handle = $profile["addr"];
3946 $split_name = self::splitName($profile['name']);
3947 $first = $split_name['first'];
3948 $last = $split_name['last'];
3950 $large = DI::baseUrl().'/photo/custom/300/'.$profile['uid'].'.jpg';
3951 $medium = DI::baseUrl().'/photo/custom/100/'.$profile['uid'].'.jpg';
3952 $small = DI::baseUrl().'/photo/custom/50/' .$profile['uid'].'.jpg';
3953 $searchable = ($profile['net-publish'] ? 'true' : 'false');
3959 if ($searchable === 'true') {
3962 if ($profile['dob'] && ($profile['dob'] > '0000-00-00')) {
3963 list($year, $month, $day) = sscanf($profile['dob'], '%4d-%2d-%2d');
3967 $dob = DateTimeFormat::utc($year . '-' . $month . '-'. $day, 'Y-m-d');
3970 $about = BBCode::toMarkdown($profile['about']);
3972 $location = $profile['location'];
3974 if ($profile['pub_keywords']) {
3975 $kw = str_replace(',', ' ', $profile['pub_keywords']);
3976 $kw = str_replace(' ', ' ', $kw);
3977 $arr = explode(' ', $kw);
3979 for ($x = 0; $x < 5; $x ++) {
3980 if (!empty($arr[$x])) {
3981 $tags .= '#'. trim($arr[$x]) .' ';
3986 $tags = trim($tags);
3989 return ["author" => $handle,
3990 "first_name" => $first,
3991 "last_name" => $last,
3992 "image_url" => $large,
3993 "image_url_medium" => $medium,
3994 "image_url_small" => $small,
3997 "location" => $location,
3998 "searchable" => $searchable,
4000 "tag_string" => $tags];
4004 * Sends profile data
4006 * @param int $uid The user id
4007 * @param bool $recips optional, default false
4009 * @throws \Exception
4011 public static function sendProfile($uid, $recips = false)
4017 $owner = User::getOwnerDataById($uid);
4024 "SELECT `id`,`name`,`network`,`pubkey`,`notify` FROM `contact` WHERE `network` = '%s'
4025 AND `uid` = %d AND `rel` != %d",
4026 DBA::escape(Protocol::DIASPORA),
4028 intval(Contact::SHARING)
4036 $message = self::createProfileData($uid);
4038 // @ToDo Split this into single worker jobs
4039 foreach ($recips as $recip) {
4040 Logger::log("Send updated profile data for user ".$uid." to contact ".$recip["id"], Logger::DEBUG);
4041 self::buildAndTransmit($owner, $recip, "profile", $message);
4046 * Creates the signature for likes that are created on our system
4048 * @param integer $uid The user of that comment
4049 * @param array $item Item array
4051 * @return array Signed content
4052 * @throws \Exception
4054 public static function createLikeSignature($uid, array $item)
4056 $owner = User::getOwnerDataById($uid);
4057 if (empty($owner)) {
4058 Logger::info('No owner post, so not storing signature');
4062 if (!in_array($item["verb"], [Activity::LIKE, Activity::DISLIKE])) {
4066 $message = self::constructLike($item, $owner);
4067 if ($message === false) {
4071 $message["author_signature"] = self::signature($owner, $message);
4077 * Creates the signature for Comments that are created on our system
4079 * @param integer $uid The user of that comment
4080 * @param array $item Item array
4082 * @return array Signed content
4083 * @throws \Exception
4085 public static function createCommentSignature($uid, array $item)
4087 $owner = User::getOwnerDataById($uid);
4088 if (empty($owner)) {
4089 Logger::info('No owner post, so not storing signature');
4093 $parent = Item::selectFirst(['parent-uri'], ['uri' => $item['thr-parent']]);
4094 if (!DBA::isResult($parent)) {
4098 $item['parent-uri'] = $parent['parent-uri'];
4100 $message = self::constructComment($item, $owner);
4101 if ($message === false) {
4105 $message["author_signature"] = self::signature($owner, $message);