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;
26 use Friendica\App\BaseURL;
27 use Friendica\Content\Text\BBCode;
28 use Friendica\Core\Hook;
29 use Friendica\Core\Logger;
30 use Friendica\Core\Protocol;
31 use Friendica\Database\DBA;
33 use Friendica\Model\Contact;
34 use Friendica\Model\Conversation;
35 use Friendica\Model\Event;
36 use Friendica\Model\FContact;
37 use Friendica\Model\Item;
38 use Friendica\Model\ItemURI;
39 use Friendica\Model\Mail;
40 use Friendica\Model\Notify\Type;
41 use Friendica\Model\PermissionSet;
42 use Friendica\Model\Post;
43 use Friendica\Model\Post\Category;
44 use Friendica\Model\Profile;
45 use Friendica\Model\Tag;
46 use Friendica\Model\User;
47 use Friendica\Model\Verb;
48 use Friendica\Network\Probe;
49 use Friendica\Util\Crypto;
50 use Friendica\Util\DateTimeFormat;
51 use Friendica\Util\Images;
52 use Friendica\Util\Network;
53 use Friendica\Util\Strings;
54 use Friendica\Util\XML;
57 * This class contain functions to create and send DFRN XML files
62 const TOP_LEVEL = 0; // Top level posting
63 const REPLY = 1; // Regular reply that is stored locally
64 const REPLY_RC = 2; // Reply that will be relayed
67 * Generates an array of contact and user for DFRN imports
69 * This array contains not only the receiver but also the sender of the message.
71 * @param integer $cid Contact id
72 * @param integer $uid User id
74 * @return array importer
77 public static function getImporter($cid, $uid = 0)
79 $condition = ['id' => $cid, 'blocked' => false, 'pending' => false];
80 $contact = DBA::selectFirst('contact', [], $condition);
81 if (!DBA::isResult($contact)) {
85 $contact['cpubkey'] = $contact['pubkey'];
86 $contact['cprvkey'] = $contact['prvkey'];
87 $contact['senderName'] = $contact['name'];
90 $condition = ['uid' => $uid, 'account_expired' => false, 'account_removed' => false];
91 $user = DBA::selectFirst('user', [], $condition);
92 if (!DBA::isResult($user)) {
96 $user['importer_uid'] = $user['uid'];
97 $user['uprvkey'] = $user['prvkey'];
99 $user = ['importer_uid' => 0, 'uprvkey' => '', 'timezone' => 'UTC',
100 'nickname' => '', 'sprvkey' => '', 'spubkey' => '',
101 'page-flags' => 0, 'account-type' => 0, 'prvnets' => 0];
104 return array_merge($contact, $user);
108 * Generates the atom entries for delivery.php
110 * This function is used whenever content is transmitted via DFRN.
112 * @param array $items Item elements
113 * @param array $owner Owner record
115 * @return string DFRN entries
116 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
117 * @throws \ImagickException
118 * @todo Find proper type-hints
120 public static function entries($items, $owner)
122 $doc = new DOMDocument('1.0', 'utf-8');
123 $doc->formatOutput = true;
125 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
127 if (! count($items)) {
128 return trim($doc->saveXML());
131 foreach ($items as $item) {
132 // These values aren't sent when sending from the queue.
133 /// @todo Check if we can set these values from the queue or if they are needed at all.
134 $item["entry:comment-allow"] = ($item["entry:comment-allow"] ?? '') ?: true;
135 $item["entry:cid"] = $item["entry:cid"] ?? 0;
137 $entry = self::entry($doc, "text", $item, $owner, $item["entry:comment-allow"], $item["entry:cid"]);
139 $root->appendChild($entry);
143 return trim($doc->saveXML());
147 * Generate an atom feed for the given user
149 * This function is called when another server is pulling data from the user feed.
151 * @param string $dfrn_id DFRN ID from the requesting party
152 * @param string $owner_nick Owner nick name
153 * @param string $last_update Date of the last update
154 * @param int $direction Can be -1, 0 or 1.
155 * @param boolean $onlyheader Output only the header without content? (Default is "no")
157 * @return string DFRN feed entries
158 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
159 * @throws \ImagickException
161 public static function feed($dfrn_id, $owner_nick, $last_update, $direction = 0, $onlyheader = false)
165 $sitefeed = ((strlen($owner_nick)) ? false : true); // not yet implemented, need to rewrite huge chunks of following logic
166 $public_feed = (($dfrn_id) ? false : true);
167 $starred = false; // not yet implemented, possible security issues
170 if ($public_feed && $a->argc > 2) {
171 for ($x = 2; $x < $a->argc; $x++) {
172 if ($a->argv[$x] == 'converse') {
175 if ($a->argv[$x] == 'starred') {
178 if ($a->argv[$x] == 'category' && $a->argc > ($x + 1) && strlen($a->argv[$x+1])) {
179 $category = $a->argv[$x+1];
184 // default permissions - anonymous user
186 $sql_extra = sprintf(" AND `item`.`private` != %s ", Item::PRIVATE);
188 $owner = DBA::selectFirst('owner-view', [], ['nickname' => $owner_nick]);
189 if (!DBA::isResult($owner)) {
190 Logger::log(sprintf('No contact found for nickname=%d', $owner_nick), Logger::WARNING);
194 $owner_id = $owner['uid'];
196 $sql_post_table = "";
198 if (! $public_feed) {
199 switch ($direction) {
201 $sql_extra = sprintf(" AND `issued-id` = '%s' ", DBA::escape($dfrn_id));
204 $sql_extra = sprintf(" AND `issued-id` = '%s' AND `duplex` = 1 ", DBA::escape($dfrn_id));
207 $sql_extra = sprintf(" AND `dfrn-id` = '%s' AND `duplex` = 1 ", DBA::escape($dfrn_id));
215 "SELECT * FROM `contact` WHERE NOT `blocked` AND `contact`.`uid` = %d $sql_extra LIMIT 1",
219 if (! DBA::isResult($r)) {
220 Logger::log(sprintf('No contact found for uid=%d', $owner_id), Logger::WARNING);
226 $set = PermissionSet::get($owner_id, $contact['id']);
229 $sql_extra = " AND `item`.`psid` IN (" . implode(',', $set) .")";
231 $sql_extra = sprintf(" AND `item`.`private` != %s", Item::PRIVATE);
241 if (! strlen($last_update)) {
242 $last_update = 'now -30 days';
245 if (isset($category)) {
246 $sql_post_table = sprintf("INNER JOIN (SELECT `uri-id` FROM `category-view` WHERE `name` = '%s' AND `type` = %d AND `uid` = %d ORDER BY `uri-id` DESC) AS `category` ON `item`.`uri-id` = `category`.`uri-id` ",
247 DBA::escape(Strings::protectSprintf($category)), intval(Category::CATEGORY), intval($owner_id));
250 if ($public_feed && ! $converse) {
251 $sql_extra .= " AND `contact`.`self` = 1 ";
254 $check_date = DateTimeFormat::utc($last_update);
258 FROM `item` USE INDEX (`uid_wall_changed`) $sql_post_table
259 STRAIGHT_JOIN `contact` ON `contact`.`id` = `item`.`contact-id`
260 WHERE `item`.`uid` = %d AND `item`.`wall` AND `item`.`changed` > '%s'
261 AND `vid` != %d AND `item`.`visible` $sql_extra
262 ORDER BY `item`.`parent` ".$sort.", `item`.`received` ASC LIMIT 0, 300",
264 DBA::escape($check_date),
265 Verb::getID(Activity::ANNOUNCE),
270 foreach ($r as $item) {
271 $ids[] = $item['id'];
275 $ret = Item::select(Item::DELIVER_FIELDLIST, ['id' => $ids]);
276 $items = Item::inArray($ret);
282 * Will check further below if this actually returned results.
283 * We will provide an empty feed if that is the case.
286 $doc = new DOMDocument('1.0', 'utf-8');
287 $doc->formatOutput = true;
289 $alternatelink = $owner['url'];
291 if (isset($category)) {
292 $alternatelink .= "/category/".$category;
296 $author = "dfrn:owner";
301 $root = self::addHeader($doc, $owner, $author, $alternatelink, true);
303 /// @TODO This hook can't work anymore
304 // \Friendica\Core\Hook::callAll('atom_feed', $atom);
306 if (!DBA::isResult($items) || $onlyheader) {
307 $atom = trim($doc->saveXML());
309 Hook::callAll('atom_feed_end', $atom);
314 foreach ($items as $item) {
315 // prevent private email from leaking.
316 if ($item['network'] == Protocol::MAIL) {
320 // public feeds get html, our own nodes use bbcode
324 // catch any email that's in a public conversation and make sure it doesn't leak
325 if ($item['private'] == Item::PRIVATE) {
332 $entry = self::entry($doc, $type, $item, $owner, true);
334 $root->appendChild($entry);
338 $atom = trim($doc->saveXML());
340 Hook::callAll('atom_feed_end', $atom);
346 * Generate an atom entry for a given item id
348 * @param int $item_id The item id
349 * @param boolean $conversation Show the conversation. If false show the single post.
351 * @return string DFRN feed entry
352 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
353 * @throws \ImagickException
355 public static function itemFeed($item_id, $conversation = false)
358 $condition = ['parent' => $item_id];
360 $condition = ['id' => $item_id];
363 $ret = Item::select(Item::DELIVER_FIELDLIST, $condition);
364 $items = Item::inArray($ret);
365 if (!DBA::isResult($items)) {
371 if ($item['uid'] != 0) {
372 $owner = User::getOwnerDataById($item['uid']);
377 $owner = ['uid' => 0, 'nick' => 'feed-item'];
380 $doc = new DOMDocument('1.0', 'utf-8');
381 $doc->formatOutput = true;
385 $root = $doc->createElementNS(ActivityNamespace::ATOM1, 'feed');
386 $doc->appendChild($root);
388 $root->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
389 $root->setAttribute("xmlns:at", ActivityNamespace::TOMB);
390 $root->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
391 $root->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
392 $root->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
393 $root->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
394 $root->setAttribute("xmlns:poco", ActivityNamespace::POCO);
395 $root->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
396 $root->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
398 //$root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
400 foreach ($items as $item) {
401 $entry = self::entry($doc, $type, $item, $owner, true, 0);
403 $root->appendChild($entry);
407 self::entry($doc, $type, $item, $owner, true, 0, true);
410 $atom = trim($doc->saveXML());
415 * Create XML text for DFRN mails
417 * @param array $item message elements
418 * @param array $owner Owner record
420 * @return string DFRN mail
421 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
422 * @todo Find proper type-hints
424 public static function mail($item, $owner)
426 $doc = new DOMDocument('1.0', 'utf-8');
427 $doc->formatOutput = true;
429 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
431 $mail = $doc->createElement("dfrn:mail");
432 $sender = $doc->createElement("dfrn:sender");
434 XML::addElement($doc, $sender, "dfrn:name", $owner['name']);
435 XML::addElement($doc, $sender, "dfrn:uri", $owner['url']);
436 XML::addElement($doc, $sender, "dfrn:avatar", $owner['thumb']);
438 $mail->appendChild($sender);
440 XML::addElement($doc, $mail, "dfrn:id", $item['uri']);
441 XML::addElement($doc, $mail, "dfrn:in-reply-to", $item['parent-uri']);
442 XML::addElement($doc, $mail, "dfrn:sentdate", DateTimeFormat::utc($item['created'] . '+00:00', DateTimeFormat::ATOM));
443 XML::addElement($doc, $mail, "dfrn:subject", $item['title']);
444 XML::addElement($doc, $mail, "dfrn:content", $item['body']);
446 $root->appendChild($mail);
448 return trim($doc->saveXML());
452 * Create XML text for DFRN friend suggestions
454 * @param array $item suggestion elements
455 * @param array $owner Owner record
457 * @return string DFRN suggestions
458 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
459 * @todo Find proper type-hints
461 public static function fsuggest($item, $owner)
463 $doc = new DOMDocument('1.0', 'utf-8');
464 $doc->formatOutput = true;
466 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
468 $suggest = $doc->createElement("dfrn:suggest");
470 XML::addElement($doc, $suggest, "dfrn:url", $item['url']);
471 XML::addElement($doc, $suggest, "dfrn:name", $item['name']);
472 XML::addElement($doc, $suggest, "dfrn:photo", $item['photo']);
473 XML::addElement($doc, $suggest, "dfrn:request", $item['request']);
474 XML::addElement($doc, $suggest, "dfrn:note", $item['note']);
476 $root->appendChild($suggest);
478 return trim($doc->saveXML());
482 * Create XML text for DFRN relocations
484 * @param array $owner Owner record
485 * @param int $uid User ID
487 * @return string DFRN relocations
488 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
489 * @todo Find proper type-hints
491 public static function relocate($owner, $uid)
494 /* get site pubkey. this could be a new installation with no site keys*/
495 $pubkey = DI::config()->get('system', 'site_pubkey');
497 $res = Crypto::newKeypair(1024);
498 DI::config()->set('system', 'site_prvkey', $res['prvkey']);
499 DI::config()->set('system', 'site_pubkey', $res['pubkey']);
503 "SELECT `resource-id` , `scale`, type FROM `photo`
504 WHERE `profile` = 1 AND `uid` = %d ORDER BY scale;",
508 $ext = Images::supportedTypes();
510 foreach ($rp as $p) {
511 $photos[$p['scale']] = DI::baseUrl().'/photo/'.$p['resource-id'].'-'.$p['scale'].'.'.$ext[$p['type']];
515 $doc = new DOMDocument('1.0', 'utf-8');
516 $doc->formatOutput = true;
518 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
520 $relocate = $doc->createElement("dfrn:relocate");
522 XML::addElement($doc, $relocate, "dfrn:url", $owner['url']);
523 XML::addElement($doc, $relocate, "dfrn:name", $owner['name']);
524 XML::addElement($doc, $relocate, "dfrn:addr", $owner['addr']);
525 XML::addElement($doc, $relocate, "dfrn:avatar", $owner['avatar']);
526 XML::addElement($doc, $relocate, "dfrn:photo", $photos[4]);
527 XML::addElement($doc, $relocate, "dfrn:thumb", $photos[5]);
528 XML::addElement($doc, $relocate, "dfrn:micro", $photos[6]);
529 XML::addElement($doc, $relocate, "dfrn:request", $owner['request']);
530 XML::addElement($doc, $relocate, "dfrn:confirm", $owner['confirm']);
531 XML::addElement($doc, $relocate, "dfrn:notify", $owner['notify']);
532 XML::addElement($doc, $relocate, "dfrn:poll", $owner['poll']);
533 XML::addElement($doc, $relocate, "dfrn:sitepubkey", DI::config()->get('system', 'site_pubkey'));
535 $root->appendChild($relocate);
537 return trim($doc->saveXML());
541 * Adds the header elements for the DFRN protocol
543 * @param DOMDocument $doc XML document
544 * @param array $owner Owner record
545 * @param string $authorelement Element name for the author
546 * @param string $alternatelink link to profile or category
547 * @param bool $public Is it a header for public posts?
549 * @return object XML root object
550 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
551 * @todo Find proper type-hints
553 private static function addHeader(DOMDocument $doc, $owner, $authorelement, $alternatelink = "", $public = false)
556 if ($alternatelink == "") {
557 $alternatelink = $owner['url'];
560 $root = $doc->createElementNS(ActivityNamespace::ATOM1, 'feed');
561 $doc->appendChild($root);
563 $root->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
564 $root->setAttribute("xmlns:at", ActivityNamespace::TOMB);
565 $root->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
566 $root->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
567 $root->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
568 $root->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
569 $root->setAttribute("xmlns:poco", ActivityNamespace::POCO);
570 $root->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
571 $root->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
573 XML::addElement($doc, $root, "id", DI::baseUrl()."/profile/".$owner["nick"]);
574 XML::addElement($doc, $root, "title", $owner["name"]);
576 $attributes = ["uri" => "https://friendi.ca", "version" => FRIENDICA_VERSION."-".DB_UPDATE_VERSION];
577 XML::addElement($doc, $root, "generator", FRIENDICA_PLATFORM, $attributes);
579 $attributes = ["rel" => "license", "href" => "http://creativecommons.org/licenses/by/3.0/"];
580 XML::addElement($doc, $root, "link", "", $attributes);
582 $attributes = ["rel" => "alternate", "type" => "text/html", "href" => $alternatelink];
583 XML::addElement($doc, $root, "link", "", $attributes);
587 // DFRN itself doesn't uses this. But maybe someone else wants to subscribe to the public feed.
588 OStatus::hublinks($doc, $root, $owner["nick"]);
590 $attributes = ["rel" => "salmon", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
591 XML::addElement($doc, $root, "link", "", $attributes);
593 $attributes = ["rel" => "http://salmon-protocol.org/ns/salmon-replies", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
594 XML::addElement($doc, $root, "link", "", $attributes);
596 $attributes = ["rel" => "http://salmon-protocol.org/ns/salmon-mention", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
597 XML::addElement($doc, $root, "link", "", $attributes);
600 // For backward compatibility we keep this element
601 if ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY) {
602 XML::addElement($doc, $root, "dfrn:community", 1);
605 // The former element is replaced by this one
606 XML::addElement($doc, $root, "dfrn:account_type", $owner["account-type"]);
608 /// @todo We need a way to transmit the different page flags like "User::PAGE_FLAGS_PRVGROUP"
610 XML::addElement($doc, $root, "updated", DateTimeFormat::utcNow(DateTimeFormat::ATOM));
612 $author = self::addAuthor($doc, $owner, $authorelement, $public);
613 $root->appendChild($author);
619 * Adds the author element in the header for the DFRN protocol
621 * @param DOMDocument $doc XML document
622 * @param array $owner Owner record
623 * @param string $authorelement Element name for the author
624 * @param boolean $public boolean
626 * @return \DOMElement XML author object
627 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
628 * @todo Find proper type-hints
630 private static function addAuthor(DOMDocument $doc, array $owner, $authorelement, $public)
632 // Should the profile be "unsearchable" in the net? Then add the "hide" element
633 $hide = DBA::exists('profile', ['uid' => $owner['uid'], 'net-publish' => false]);
635 $author = $doc->createElement($authorelement);
637 $namdate = DateTimeFormat::utc($owner['name-date'].'+00:00', DateTimeFormat::ATOM);
638 $picdate = DateTimeFormat::utc($owner['avatar-date'].'+00:00', DateTimeFormat::ATOM);
642 if (!$public || !$hide) {
643 $attributes = ["dfrn:updated" => $namdate];
646 XML::addElement($doc, $author, "name", $owner["name"], $attributes);
647 XML::addElement($doc, $author, "uri", DI::baseUrl().'/profile/'.$owner["nickname"], $attributes);
648 XML::addElement($doc, $author, "dfrn:handle", $owner["addr"], $attributes);
650 $attributes = ["rel" => "photo", "type" => "image/jpeg",
651 "media:width" => 300, "media:height" => 300, "href" => $owner['photo']];
653 if (!$public || !$hide) {
654 $attributes["dfrn:updated"] = $picdate;
657 XML::addElement($doc, $author, "link", "", $attributes);
659 $attributes["rel"] = "avatar";
660 XML::addElement($doc, $author, "link", "", $attributes);
663 XML::addElement($doc, $author, "dfrn:hide", "true");
666 // The following fields will only be generated if the data isn't meant for a public feed
671 $birthday = feed_birthday($owner['uid'], $owner['timezone']);
674 XML::addElement($doc, $author, "dfrn:birthday", $birthday);
677 // Only show contact details when we are allowed to
678 $profile = DBA::selectFirst('owner-view',
679 ['about', 'name', 'homepage', 'nickname', 'timezone', 'locality', 'region', 'country-name', 'pub_keywords', 'xmpp', 'dob'],
680 ['uid' => $owner['uid'], 'hidewall' => false]);
681 if (DBA::isResult($profile)) {
682 XML::addElement($doc, $author, "poco:displayName", $profile["name"]);
683 XML::addElement($doc, $author, "poco:updated", $namdate);
685 if (trim($profile["dob"]) > DBA::NULL_DATE) {
686 XML::addElement($doc, $author, "poco:birthday", "0000-".date("m-d", strtotime($profile["dob"])));
689 XML::addElement($doc, $author, "poco:note", $profile["about"]);
690 XML::addElement($doc, $author, "poco:preferredUsername", $profile["nickname"]);
692 $savetz = date_default_timezone_get();
693 date_default_timezone_set($profile["timezone"]);
694 XML::addElement($doc, $author, "poco:utcOffset", date("P"));
695 date_default_timezone_set($savetz);
697 if (trim($profile["homepage"]) != "") {
698 $urls = $doc->createElement("poco:urls");
699 XML::addElement($doc, $urls, "poco:type", "homepage");
700 XML::addElement($doc, $urls, "poco:value", $profile["homepage"]);
701 XML::addElement($doc, $urls, "poco:primary", "true");
702 $author->appendChild($urls);
705 if (trim($profile["pub_keywords"]) != "") {
706 $keywords = explode(",", $profile["pub_keywords"]);
708 foreach ($keywords as $keyword) {
709 XML::addElement($doc, $author, "poco:tags", trim($keyword));
713 if (trim($profile["xmpp"]) != "") {
714 $ims = $doc->createElement("poco:ims");
715 XML::addElement($doc, $ims, "poco:type", "xmpp");
716 XML::addElement($doc, $ims, "poco:value", $profile["xmpp"]);
717 XML::addElement($doc, $ims, "poco:primary", "true");
718 $author->appendChild($ims);
721 if (trim($profile["locality"].$profile["region"].$profile["country-name"]) != "") {
722 $element = $doc->createElement("poco:address");
724 XML::addElement($doc, $element, "poco:formatted", Profile::formatLocation($profile));
726 if (trim($profile["locality"]) != "") {
727 XML::addElement($doc, $element, "poco:locality", $profile["locality"]);
730 if (trim($profile["region"]) != "") {
731 XML::addElement($doc, $element, "poco:region", $profile["region"]);
734 if (trim($profile["country-name"]) != "") {
735 XML::addElement($doc, $element, "poco:country", $profile["country-name"]);
738 $author->appendChild($element);
746 * Adds the author elements in the "entry" elements of the DFRN protocol
748 * @param DOMDocument $doc XML document
749 * @param string $element Element name for the author
750 * @param string $contact_url Link of the contact
751 * @param array $item Item elements
753 * @return \DOMElement XML author object
754 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
755 * @todo Find proper type-hints
757 private static function addEntryAuthor(DOMDocument $doc, $element, $contact_url, $item)
759 $author = $doc->createElement($element);
761 $contact = Contact::getByURLForUser($contact_url, $item["uid"], false, ['url', 'name', 'addr', 'photo']);
762 if (!empty($contact)) {
763 XML::addElement($doc, $author, "name", $contact["name"]);
764 XML::addElement($doc, $author, "uri", $contact["url"]);
765 XML::addElement($doc, $author, "dfrn:handle", $contact["addr"]);
768 /// - Check real image type and image size
769 /// - Check which of these boths elements we should use
772 "type" => "image/jpeg",
774 "media:height" => 80,
775 "href" => $contact["photo"]];
776 XML::addElement($doc, $author, "link", "", $attributes);
780 "type" => "image/jpeg",
782 "media:height" => 80,
783 "href" => $contact["photo"]];
784 XML::addElement($doc, $author, "link", "", $attributes);
791 * Adds the activity elements
793 * @param DOMDocument $doc XML document
794 * @param string $element Element name for the activity
795 * @param string $activity activity value
797 * @return \DOMElement XML activity object
798 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
799 * @todo Find proper type-hints
801 private static function createActivity(DOMDocument $doc, $element, $activity)
804 $entry = $doc->createElement($element);
806 $r = XML::parseString($activity);
812 XML::addElement($doc, $entry, "activity:object-type", $r->type);
816 XML::addElement($doc, $entry, "id", $r->id);
820 XML::addElement($doc, $entry, "title", $r->title);
824 if (substr($r->link, 0, 1) == '<') {
825 if (strstr($r->link, '&') && (! strstr($r->link, '&'))) {
826 $r->link = str_replace('&', '&', $r->link);
829 $r->link = preg_replace('/\<link(.*?)\"\>/', '<link$1"/>', $r->link);
831 // XML does need a single element as root element so we add a dummy element here
832 $data = XML::parseString("<dummy>" . $r->link . "</dummy>");
833 if (is_object($data)) {
834 foreach ($data->link as $link) {
836 foreach ($link->attributes() as $parameter => $value) {
837 $attributes[$parameter] = $value;
839 XML::addElement($doc, $entry, "link", "", $attributes);
843 $attributes = ["rel" => "alternate", "type" => "text/html", "href" => $r->link];
844 XML::addElement($doc, $entry, "link", "", $attributes);
848 XML::addElement($doc, $entry, "content", BBCode::convert($r->content), ["type" => "html"]);
858 * Adds the elements for attachments
860 * @param object $doc XML document
861 * @param object $root XML root
862 * @param array $item Item element
864 * @return void XML attachment object
865 * @todo Find proper type-hints
867 private static function getAttachment($doc, $root, $item)
869 $arr = explode('[/attach],', $item['attach']);
871 foreach ($arr as $r) {
873 $cnt = preg_match('|\[attach\]href=\"(.*?)\" length=\"(.*?)\" type=\"(.*?)\" title=\"(.*?)\"|', $r, $matches);
875 $attributes = ["rel" => "enclosure",
876 "href" => $matches[1],
877 "type" => $matches[3]];
879 if (intval($matches[2])) {
880 $attributes["length"] = intval($matches[2]);
883 if (trim($matches[4]) != "") {
884 $attributes["title"] = trim($matches[4]);
887 XML::addElement($doc, $root, "link", "", $attributes);
894 * Adds the "entry" elements for the DFRN protocol
896 * @param DOMDocument $doc XML document
897 * @param string $type "text" or "html"
898 * @param array $item Item element
899 * @param array $owner Owner record
900 * @param bool $comment Trigger the sending of the "comment" element
901 * @param int $cid Contact ID of the recipient
902 * @param bool $single If set, the entry is created as an XML document with a single "entry" element
904 * @return null|\DOMElement XML entry object
905 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
906 * @throws \ImagickException
907 * @todo Find proper type-hints
909 private static function entry(DOMDocument $doc, $type, array $item, array $owner, $comment = false, $cid = 0, $single = false)
913 if (!$item['parent']) {
914 Logger::notice('Item without parent found.', ['type' => $type, 'item' => $item]);
918 if ($item['deleted']) {
919 $attributes = ["ref" => $item['uri'], "when" => DateTimeFormat::utc($item['edited'] . '+00:00', DateTimeFormat::ATOM)];
920 return XML::createElement($doc, "at:deleted-entry", "", $attributes);
924 $entry = $doc->createElement("entry");
926 $entry = $doc->createElementNS(ActivityNamespace::ATOM1, 'entry');
927 $doc->appendChild($entry);
929 $entry->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
930 $entry->setAttribute("xmlns:at", ActivityNamespace::TOMB);
931 $entry->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
932 $entry->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
933 $entry->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
934 $entry->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
935 $entry->setAttribute("xmlns:poco", ActivityNamespace::POCO);
936 $entry->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
937 $entry->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
940 if ($item['private'] == Item::PRIVATE) {
941 $body = Item::fixPrivatePhotos($item['body'], $owner['uid'], $item, $cid);
943 $body = $item['body'];
946 // Remove the abstract element. It is only locally important.
947 $body = BBCode::stripAbstract($body);
950 if ($type == 'html') {
953 if ($item['title'] != "") {
954 $htmlbody = "[b]" . $item['title'] . "[/b]\n\n" . $htmlbody;
957 $htmlbody = BBCode::convert($htmlbody, false, BBCode::OSTATUS);
960 $author = self::addEntryAuthor($doc, "author", $item["author-link"], $item);
961 $entry->appendChild($author);
963 $dfrnowner = self::addEntryAuthor($doc, "dfrn:owner", $item["owner-link"], $item);
964 $entry->appendChild($dfrnowner);
966 if ($item['gravity'] != GRAVITY_PARENT) {
967 $parent_item = (($item['thr-parent']) ? $item['thr-parent'] : $item['parent-uri']);
968 $parent = Item::selectFirst(['guid', 'plink'], ['uri' => $parent_item, 'uid' => $item['uid']]);
969 if (DBA::isResult($parent)) {
970 $attributes = ["ref" => $parent_item, "type" => "text/html",
971 "href" => $parent['plink'],
972 "dfrn:diaspora_guid" => $parent['guid']];
973 XML::addElement($doc, $entry, "thr:in-reply-to", "", $attributes);
977 // Add conversation data. This is used for OStatus
978 $conversation_href = DI::baseUrl()."/display/".$item["parent-guid"];
979 $conversation_uri = $conversation_href;
981 if (isset($parent_item)) {
982 $conversation = DBA::selectFirst('conversation', ['conversation-uri', 'conversation-href'], ['item-uri' => $item['parent-uri']]);
983 if (DBA::isResult($conversation)) {
984 if ($conversation['conversation-uri'] != '') {
985 $conversation_uri = $conversation['conversation-uri'];
987 if ($conversation['conversation-href'] != '') {
988 $conversation_href = $conversation['conversation-href'];
994 "href" => $conversation_href,
995 "ref" => $conversation_uri];
997 XML::addElement($doc, $entry, "ostatus:conversation", $conversation_uri, $attributes);
999 XML::addElement($doc, $entry, "id", $item["uri"]);
1000 XML::addElement($doc, $entry, "title", $item["title"]);
1002 XML::addElement($doc, $entry, "published", DateTimeFormat::utc($item["created"] . "+00:00", DateTimeFormat::ATOM));
1003 XML::addElement($doc, $entry, "updated", DateTimeFormat::utc($item["edited"] . "+00:00", DateTimeFormat::ATOM));
1005 // "dfrn:env" is used to read the content
1006 XML::addElement($doc, $entry, "dfrn:env", Strings::base64UrlEncode($body, true));
1008 // The "content" field is not read by the receiver. We could remove it when the type is "text"
1009 // We keep it at the moment, maybe there is some old version that doesn't read "dfrn:env"
1010 XML::addElement($doc, $entry, "content", (($type == 'html') ? $htmlbody : $body), ["type" => $type]);
1012 // We save this value in "plink". Maybe we should read it from there as well?
1018 ["rel" => "alternate", "type" => "text/html",
1019 "href" => DI::baseUrl() . "/display/" . $item["guid"]]
1022 // "comment-allow" is some old fashioned stuff for old Friendica versions.
1023 // It is included in the rewritten code for completeness
1025 XML::addElement($doc, $entry, "dfrn:comment-allow", 1);
1028 if ($item['location']) {
1029 XML::addElement($doc, $entry, "dfrn:location", $item['location']);
1032 if ($item['coord']) {
1033 XML::addElement($doc, $entry, "georss:point", $item['coord']);
1036 if ($item['private']) {
1037 // Friendica versions prior to 2020.3 can't handle "unlisted" properly. So we can only transmit public and private
1038 XML::addElement($doc, $entry, "dfrn:private", ($item['private'] == Item::PRIVATE ? Item::PRIVATE : Item::PUBLIC));
1039 XML::addElement($doc, $entry, "dfrn:unlisted", $item['private'] == Item::UNLISTED);
1042 if ($item['extid']) {
1043 XML::addElement($doc, $entry, "dfrn:extid", $item['extid']);
1046 if ($item['post-type'] == Item::PT_PAGE) {
1047 XML::addElement($doc, $entry, "dfrn:bookmark", "true");
1051 XML::addElement($doc, $entry, "statusnet:notice_info", "", ["local_id" => $item['id'], "source" => $item['app']]);
1054 XML::addElement($doc, $entry, "dfrn:diaspora_guid", $item["guid"]);
1056 // The signed text contains the content in Markdown, the sender handle and the signatur for the content
1057 // It is needed for relayed comments to Diaspora.
1058 if ($item['signed_text']) {
1059 $sign = base64_encode(json_encode(['signed_text' => $item['signed_text'],'signature' => '','signer' => '']));
1060 XML::addElement($doc, $entry, "dfrn:diaspora_signature", $sign);
1063 XML::addElement($doc, $entry, "activity:verb", self::constructVerb($item));
1065 if ($item['object-type'] != "") {
1066 XML::addElement($doc, $entry, "activity:object-type", $item['object-type']);
1067 } elseif ($item['gravity'] == GRAVITY_PARENT) {
1068 XML::addElement($doc, $entry, "activity:object-type", Activity\ObjectType::NOTE);
1070 XML::addElement($doc, $entry, "activity:object-type", Activity\ObjectType::COMMENT);
1073 $actobj = self::createActivity($doc, "activity:object", $item['object']);
1075 $entry->appendChild($actobj);
1078 $actarg = self::createActivity($doc, "activity:target", $item['target']);
1080 $entry->appendChild($actarg);
1083 $tags = Tag::getByURIId($item['uri-id']);
1086 foreach ($tags as $tag) {
1087 if (($type != 'html') || ($tag['type'] == Tag::HASHTAG)) {
1088 XML::addElement($doc, $entry, "category", "", ["scheme" => "X-DFRN:" . Tag::TAG_CHARACTER[$tag['type']] . ":" . $tag['url'], "term" => $tag['name']]);
1090 if ($tag['type'] != Tag::HASHTAG) {
1091 $mentioned[$tag['url']] = $tag['url'];
1096 foreach ($mentioned as $mention) {
1097 $condition = ['uid' => $owner["uid"], 'nurl' => Strings::normaliseLink($mention)];
1098 $contact = DBA::selectFirst('contact', ['forum', 'prv'], $condition);
1100 if (DBA::isResult($contact) && ($contact["forum"] || $contact["prv"])) {
1106 ["rel" => "mentioned",
1107 "ostatus:object-type" => Activity\ObjectType::GROUP,
1116 ["rel" => "mentioned",
1117 "ostatus:object-type" => Activity\ObjectType::PERSON,
1123 self::getAttachment($doc, $entry, $item);
1129 * encrypts data via AES
1131 * @param string $data The data that is to be encrypted
1132 * @param string $key The AES key
1134 * @return string encrypted data
1136 private static function aesEncrypt($data, $key)
1138 return openssl_encrypt($data, 'aes-128-ecb', $key, OPENSSL_RAW_DATA);
1142 * decrypts data via AES
1144 * @param string $encrypted The encrypted data
1145 * @param string $key The AES key
1147 * @return string decrypted data
1149 public static function aesDecrypt($encrypted, $key)
1151 return openssl_decrypt($encrypted, 'aes-128-ecb', $key, OPENSSL_RAW_DATA);
1155 * Delivers the atom content to the contacts
1157 * @param array $owner Owner record
1158 * @param array $contact Contact record of the receiver
1159 * @param string $atom Content that will be transmitted
1160 * @param bool $dissolve (to be documented)
1162 * @return int Deliver status. Negative values mean an error.
1163 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1164 * @throws \ImagickException
1165 * @todo Add array type-hint for $owner, $contact
1167 public static function deliver($owner, $contact, $atom, $dissolve = false)
1169 $idtosend = $orig_id = (($contact['dfrn-id']) ? $contact['dfrn-id'] : $contact['issued-id']);
1171 if ($contact['duplex'] && $contact['dfrn-id']) {
1172 $idtosend = '0:' . $orig_id;
1174 if ($contact['duplex'] && $contact['issued-id']) {
1175 $idtosend = '1:' . $orig_id;
1178 $rino = DI::config()->get('system', 'rino_encrypt');
1179 $rino = intval($rino);
1181 Logger::log("Local rino version: ". $rino, Logger::DEBUG);
1183 $ssl_val = intval(DI::config()->get('system', 'ssl_policy'));
1186 case BaseURL::SSL_POLICY_FULL:
1187 $ssl_policy = 'full';
1189 case BaseURL::SSL_POLICY_SELFSIGN:
1190 $ssl_policy = 'self';
1192 case BaseURL::SSL_POLICY_NONE:
1194 $ssl_policy = 'none';
1198 $url = $contact['notify'] . '&dfrn_id=' . $idtosend . '&dfrn_version=' . DFRN_PROTOCOL_VERSION . (($rino) ? '&rino='.$rino : '');
1200 Logger::log('dfrn_deliver: ' . $url);
1202 $curlResult = DI::httpRequest()->get($url);
1204 if ($curlResult->isTimeout()) {
1205 return -2; // timed out
1208 $xml = $curlResult->getBody();
1210 $curl_stat = $curlResult->getReturnCode();
1211 if (empty($curl_stat)) {
1212 return -3; // timed out
1215 Logger::log('dfrn_deliver: ' . $xml, Logger::DATA);
1221 if (strpos($xml, '<?xml') === false) {
1222 Logger::log('dfrn_deliver: no valid XML returned');
1223 Logger::log('dfrn_deliver: returned XML: ' . $xml, Logger::DATA);
1227 $res = XML::parseString($xml);
1229 if (!is_object($res) || (intval($res->status) != 0) || !strlen($res->challenge) || !strlen($res->dfrn_id)) {
1230 if (empty($res->status)) {
1233 $status = $res->status;
1240 $sent_dfrn_id = hex2bin((string) $res->dfrn_id);
1241 $challenge = hex2bin((string) $res->challenge);
1242 $perm = (($res->perm) ? $res->perm : null);
1243 $dfrn_version = floatval($res->dfrn_version ?: 2.0);
1244 $rino_remote_version = intval($res->rino);
1245 $page = (($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY) ? 1 : 0);
1247 Logger::log("Remote rino version: ".$rino_remote_version." for ".$contact["url"], Logger::DEBUG);
1249 if ($owner['page-flags'] == User::PAGE_FLAGS_PRVGROUP) {
1253 $final_dfrn_id = '';
1256 if ((($perm == 'rw') && !intval($contact['writable']))
1257 || (($perm == 'r') && intval($contact['writable']))
1259 DBA::update('contact', ['writable' => ($perm == 'rw')], ['id' => $contact['id']]);
1261 $contact['writable'] = (string) 1 - intval($contact['writable']);
1265 if (($contact['duplex'] && strlen($contact['pubkey']))
1266 || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY && strlen($contact['pubkey']))
1267 || ($contact['rel'] == Contact::SHARING && strlen($contact['pubkey']))
1269 openssl_public_decrypt($sent_dfrn_id, $final_dfrn_id, $contact['pubkey']);
1270 openssl_public_decrypt($challenge, $postvars['challenge'], $contact['pubkey']);
1272 openssl_private_decrypt($sent_dfrn_id, $final_dfrn_id, $contact['prvkey']);
1273 openssl_private_decrypt($challenge, $postvars['challenge'], $contact['prvkey']);
1276 $final_dfrn_id = substr($final_dfrn_id, 0, strpos($final_dfrn_id, '.'));
1278 if (strpos($final_dfrn_id, ':') == 1) {
1279 $final_dfrn_id = substr($final_dfrn_id, 2);
1282 if ($final_dfrn_id != $orig_id) {
1283 Logger::log('dfrn_deliver: wrong dfrn_id.');
1284 // did not decode properly - cannot trust this site
1288 $postvars['dfrn_id'] = $idtosend;
1289 $postvars['dfrn_version'] = DFRN_PROTOCOL_VERSION;
1291 $postvars['dissolve'] = '1';
1294 if ((($contact['rel']) && ($contact['rel'] != Contact::SHARING) && (! $contact['blocked'])) || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY)) {
1295 $postvars['data'] = $atom;
1296 $postvars['perm'] = 'rw';
1298 $postvars['data'] = str_replace('<dfrn:comment-allow>1', '<dfrn:comment-allow>0', $atom);
1299 $postvars['perm'] = 'r';
1302 $postvars['ssl_policy'] = $ssl_policy;
1305 $postvars['page'] = $page;
1309 if ($rino > 0 && $rino_remote_version > 0 && (! $dissolve)) {
1310 Logger::log('rino version: '. $rino_remote_version);
1312 switch ($rino_remote_version) {
1314 $key = openssl_random_pseudo_bytes(16);
1315 $data = self::aesEncrypt($postvars['data'], $key);
1319 Logger::log("rino: invalid requested version '$rino_remote_version'");
1323 $postvars['rino'] = $rino_remote_version;
1324 $postvars['data'] = bin2hex($data);
1326 if ($dfrn_version >= 2.1) {
1327 if (($contact['duplex'] && strlen($contact['pubkey']))
1328 || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY && strlen($contact['pubkey']))
1329 || ($contact['rel'] == Contact::SHARING && strlen($contact['pubkey']))
1331 openssl_public_encrypt($key, $postvars['key'], $contact['pubkey']);
1333 openssl_private_encrypt($key, $postvars['key'], $contact['prvkey']);
1336 if (($contact['duplex'] && strlen($contact['prvkey'])) || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY)) {
1337 openssl_private_encrypt($key, $postvars['key'], $contact['prvkey']);
1339 openssl_public_encrypt($key, $postvars['key'], $contact['pubkey']);
1343 Logger::log('md5 rawkey ' . md5($postvars['key']));
1345 $postvars['key'] = bin2hex($postvars['key']);
1349 Logger::debug('dfrn_deliver', ['post' => $postvars]);
1351 $postResult = DI::httpRequest()->post($contact['notify'], $postvars);
1353 $xml = $postResult->getBody();
1355 Logger::log('dfrn_deliver: ' . "RECEIVED: " . $xml, Logger::DATA);
1357 $curl_stat = $postResult->getReturnCode();
1358 if (empty($curl_stat) || empty($xml)) {
1359 return -9; // timed out
1362 if (($curl_stat == 503) && stristr($postResult->getHeader(), 'retry-after')) {
1366 if (strpos($xml, '<?xml') === false) {
1367 Logger::log('dfrn_deliver: phase 2: no valid XML returned');
1368 Logger::log('dfrn_deliver: phase 2: returned XML: ' . $xml, Logger::DATA);
1372 $res = XML::parseString($xml);
1374 if (!isset($res->status)) {
1378 // Possibly old servers had returned an empty value when everything was okay
1379 if (empty($res->status)) {
1383 if (!empty($res->message)) {
1384 Logger::log('Delivery returned status '.$res->status.' - '.$res->message, Logger::DEBUG);
1387 return intval($res->status);
1391 * Transmits atom content to the contacts via the Diaspora transport layer
1393 * @param array $owner Owner record
1394 * @param array $contact Contact record of the receiver
1395 * @param string $atom Content that will be transmitted
1397 * @param bool $public_batch
1398 * @return int Deliver status. Negative values mean an error.
1399 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1400 * @throws \ImagickException
1402 public static function transmit($owner, $contact, $atom, $public_batch = false)
1404 if (!$public_batch) {
1405 if (empty($contact['addr'])) {
1406 Logger::log('Empty contact handle for ' . $contact['id'] . ' - ' . $contact['url'] . ' - trying to update it.');
1407 if (Contact::updateFromProbe($contact['id'])) {
1408 $new_contact = DBA::selectFirst('contact', ['addr'], ['id' => $contact['id']]);
1409 $contact['addr'] = $new_contact['addr'];
1412 if (empty($contact['addr'])) {
1413 Logger::log('Unable to find contact handle for ' . $contact['id'] . ' - ' . $contact['url']);
1418 $fcontact = FContact::getByURL($contact['addr']);
1419 if (empty($fcontact)) {
1420 Logger::log('Unable to find contact details for ' . $contact['id'] . ' - ' . $contact['addr']);
1423 $pubkey = $fcontact['pubkey'];
1428 $envelope = Diaspora::buildMessage($atom, $owner, $contact, $owner['uprvkey'], $pubkey, $public_batch);
1430 // Create the endpoint for public posts. This is some WIP and should later be added to the probing
1431 if ($public_batch && empty($contact["batch"])) {
1432 $parts = parse_url($contact["notify"]);
1433 $path_parts = explode('/', $parts['path']);
1434 array_pop($path_parts);
1435 $parts['path'] = implode('/', $path_parts);
1436 $contact["batch"] = Network::unparseURL($parts);
1439 $dest_url = ($public_batch ? $contact["batch"] : $contact["notify"]);
1441 if (empty($dest_url)) {
1442 Logger::info('Empty destination', ['public' => $public_batch, 'contact' => $contact]);
1446 $content_type = ($public_batch ? "application/magic-envelope+xml" : "application/json");
1448 $postResult = DI::httpRequest()->post($dest_url, $envelope, ["Content-Type: " . $content_type]);
1449 $xml = $postResult->getBody();
1451 $curl_stat = $postResult->getReturnCode();
1452 if (empty($curl_stat) || empty($xml)) {
1453 Logger::log('Empty answer from ' . $contact['id'] . ' - ' . $dest_url);
1454 return -9; // timed out
1457 if (($curl_stat == 503) && (stristr($postResult->getHeader(), 'retry-after'))) {
1461 if (strpos($xml, '<?xml') === false) {
1462 Logger::log('No valid XML returned from ' . $contact['id'] . ' - ' . $dest_url);
1463 Logger::log('Returned XML: ' . $xml, Logger::DATA);
1467 $res = XML::parseString($xml);
1469 if (empty($res->status)) {
1473 if (!empty($res->message)) {
1474 Logger::log('Transmit to ' . $dest_url . ' returned status '.$res->status.' - '.$res->message, Logger::DEBUG);
1477 return intval($res->status);
1481 * Fetch the author data from head or entry items
1483 * @param object $xpath XPath object
1484 * @param object $context In which context should the data be searched
1485 * @param array $importer Record of the importer user mixed with contact of the content
1486 * @param string $element Element name from which the data is fetched
1487 * @param bool $onlyfetch Should the data only be fetched or should it update the contact record as well
1488 * @param string $xml optional, default empty
1490 * @return array Relevant data of the author
1491 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1492 * @throws \ImagickException
1493 * @todo Find good type-hints for all parameter
1495 private static function fetchauthor($xpath, $context, $importer, $element, $onlyfetch, $xml = "")
1498 $author["name"] = XML::getFirstNodeValue($xpath, $element."/atom:name/text()", $context);
1499 $author["link"] = XML::getFirstNodeValue($xpath, $element."/atom:uri/text()", $context);
1501 $fields = ['id', 'uid', 'url', 'network', 'avatar-date', 'avatar', 'name-date', 'uri-date', 'addr',
1502 'name', 'nick', 'about', 'location', 'keywords', 'xmpp', 'bdyear', 'bd', 'hidden', 'contact-type'];
1503 $condition = ["`uid` = ? AND `nurl` = ? AND `network` != ? AND NOT `pending` AND NOT `blocked`",
1504 $importer["importer_uid"], Strings::normaliseLink($author["link"]), Protocol::STATUSNET];
1506 if ($importer['account-type'] != User::ACCOUNT_TYPE_COMMUNITY) {
1507 $condition = DBA::mergeConditions($condition, ['rel' => [Contact::SHARING, Contact::FRIEND]]);
1510 $contact_old = DBA::selectFirst('contact', $fields, $condition);
1512 if (DBA::isResult($contact_old)) {
1513 $author["contact-id"] = $contact_old["id"];
1514 $author["network"] = $contact_old["network"];
1516 Logger::info('Blubb', ['condition' => $condition]);
1518 Logger::debug("Contact ".$author["link"]." wasn't found for user ".$importer["importer_uid"]." XML: ".$xml);
1521 $author["contact-unknown"] = true;
1522 $contact = Contact::getByURL($author["link"], null, ["id", "network"]);
1523 $author["contact-id"] = $contact["id"] ?? $importer["id"];
1524 $author["network"] = $contact["network"] ?? $importer["network"];
1528 // Until now we aren't serving different sizes - but maybe later
1530 /// @todo check if "avatar" or "photo" would be the best field in the specification
1531 $avatars = $xpath->query($element . "/atom:link[@rel='avatar']", $context);
1532 foreach ($avatars as $avatar) {
1535 foreach ($avatar->attributes as $attributes) {
1536 /// @TODO Rewrite these similar if() to one switch
1537 if ($attributes->name == "href") {
1538 $href = $attributes->textContent;
1540 if ($attributes->name == "width") {
1541 $width = $attributes->textContent;
1543 if ($attributes->name == "updated") {
1544 $author["avatar-date"] = $attributes->textContent;
1547 if (($width > 0) && ($href != "")) {
1548 $avatarlist[$width] = $href;
1552 if (count($avatarlist) > 0) {
1553 krsort($avatarlist);
1554 $author["avatar"] = current($avatarlist);
1557 if (empty($author['avatar']) && !empty($author['link'])) {
1558 $cid = Contact::getIdForURL($author['link'], 0);
1560 $contact = DBA::selectFirst('contact', ['avatar'], ['id' => $cid]);
1561 if (DBA::isResult($contact)) {
1562 $author['avatar'] = $contact['avatar'];
1567 if (empty($author['avatar'])) {
1568 Logger::log('Empty author: ' . $xml);
1569 $author['avatar'] = '';
1572 if (DBA::isResult($contact_old) && !$onlyfetch) {
1573 Logger::log("Check if contact details for contact " . $contact_old["id"] . " (" . $contact_old["nick"] . ") have to be updated.", Logger::DEBUG);
1575 $poco = ["url" => $contact_old["url"], "network" => $contact_old["network"]];
1577 // When was the last change to name or uri?
1578 $name_element = $xpath->query($element . "/atom:name", $context)->item(0);
1579 foreach ($name_element->attributes as $attributes) {
1580 if ($attributes->name == "updated") {
1581 $poco["name-date"] = $attributes->textContent;
1585 $link_element = $xpath->query($element . "/atom:link", $context)->item(0);
1586 foreach ($link_element->attributes as $attributes) {
1587 if ($attributes->name == "updated") {
1588 $poco["uri-date"] = $attributes->textContent;
1592 // Update contact data
1593 $value = XML::getFirstNodeValue($xpath, $element . "/dfrn:handle/text()", $context);
1595 $poco["addr"] = $value;
1598 $value = XML::getFirstNodeValue($xpath, $element . "/poco:displayName/text()", $context);
1600 $poco["name"] = $value;
1603 $value = XML::getFirstNodeValue($xpath, $element . "/poco:preferredUsername/text()", $context);
1605 $poco["nick"] = $value;
1608 $value = XML::getFirstNodeValue($xpath, $element . "/poco:note/text()", $context);
1610 $poco["about"] = $value;
1613 $value = XML::getFirstNodeValue($xpath, $element . "/poco:address/poco:formatted/text()", $context);
1615 $poco["location"] = $value;
1618 /// @todo Only search for elements with "poco:type" = "xmpp"
1619 $value = XML::getFirstNodeValue($xpath, $element . "/poco:ims/poco:value/text()", $context);
1621 $poco["xmpp"] = $value;
1624 /// @todo Add support for the following fields that we don't support by now in the contact table:
1625 /// - poco:utcOffset
1631 // If the "hide" element is present then the profile isn't searchable.
1632 $hide = intval(XML::getFirstNodeValue($xpath, $element . "/dfrn:hide/text()", $context) == "true");
1634 Logger::log("Hidden status for contact " . $contact_old["url"] . ": " . $hide, Logger::DEBUG);
1636 // If the contact isn't searchable then set the contact to "hidden".
1637 // Problem: This can be manually overridden by the user.
1639 $contact_old["hidden"] = true;
1642 // Save the keywords into the contact table
1644 $tagelements = $xpath->evaluate($element . "/poco:tags/text()", $context);
1645 foreach ($tagelements as $tag) {
1646 $tags[$tag->nodeValue] = $tag->nodeValue;
1650 $poco["keywords"] = implode(", ", $tags);
1653 // "dfrn:birthday" contains the birthday converted to UTC
1654 $birthday = XML::getFirstNodeValue($xpath, $element . "/poco:birthday/text()", $context);
1656 if (strtotime($birthday) > time()) {
1657 $bd_timestamp = strtotime($birthday);
1659 $poco["bdyear"] = date("Y", $bd_timestamp);
1662 // "poco:birthday" is the birthday in the format "yyyy-mm-dd"
1663 $value = XML::getFirstNodeValue($xpath, $element . "/poco:birthday/text()", $context);
1665 if (!in_array($value, ["", "0000-00-00", DBA::NULL_DATE])) {
1666 $bdyear = date("Y");
1667 $value = str_replace(["0000", "0001"], $bdyear, $value);
1669 if (strtotime($value) < time()) {
1670 $value = str_replace($bdyear, $bdyear + 1, $value);
1673 $poco["bd"] = $value;
1676 $contact = array_merge($contact_old, $poco);
1678 if ($contact_old["bdyear"] != $contact["bdyear"]) {
1679 Event::createBirthday($contact, $birthday);
1682 $fields = ['name' => $contact['name'], 'nick' => $contact['nick'], 'about' => $contact['about'],
1683 'location' => $contact['location'], 'addr' => $contact['addr'], 'keywords' => $contact['keywords'],
1684 'bdyear' => $contact['bdyear'], 'bd' => $contact['bd'], 'hidden' => $contact['hidden'],
1685 'xmpp' => $contact['xmpp'], 'name-date' => DateTimeFormat::utc($contact['name-date']),
1686 'unsearchable' => $contact['hidden'], 'uri-date' => DateTimeFormat::utc($contact['uri-date'])];
1688 DBA::update('contact', $fields, ['id' => $contact['id'], 'network' => $contact['network']], $contact_old);
1690 // Update the public contact. Don't set the "hidden" value, this is used differently for public contacts
1691 unset($fields['hidden']);
1692 $condition = ['uid' => 0, 'nurl' => Strings::normaliseLink($contact_old['url'])];
1693 DBA::update('contact', $fields, $condition, true);
1695 Contact::updateAvatar($contact['id'], $author['avatar']);
1697 $pcid = Contact::getIdForURL($contact_old['url']);
1698 if (!empty($pcid)) {
1699 Contact::updateAvatar($pcid, $author['avatar']);
1707 * Transforms activity objects into an XML string
1709 * @param object $xpath XPath object
1710 * @param object $activity Activity object
1711 * @param string $element element name
1713 * @return string XML string
1714 * @todo Find good type-hints for all parameter
1716 private static function transformActivity($xpath, $activity, $element)
1718 if (!is_object($activity)) {
1722 $obj_doc = new DOMDocument("1.0", "utf-8");
1723 $obj_doc->formatOutput = true;
1725 $obj_element = $obj_doc->createElementNS( ActivityNamespace::ATOM1, $element);
1727 $activity_type = $xpath->query("activity:object-type/text()", $activity)->item(0)->nodeValue;
1728 XML::addElement($obj_doc, $obj_element, "type", $activity_type);
1730 $id = $xpath->query("atom:id", $activity)->item(0);
1731 if (is_object($id)) {
1732 $obj_element->appendChild($obj_doc->importNode($id, true));
1735 $title = $xpath->query("atom:title", $activity)->item(0);
1736 if (is_object($title)) {
1737 $obj_element->appendChild($obj_doc->importNode($title, true));
1740 $links = $xpath->query("atom:link", $activity);
1741 if (is_object($links)) {
1742 foreach ($links as $link) {
1743 $obj_element->appendChild($obj_doc->importNode($link, true));
1747 $content = $xpath->query("atom:content", $activity)->item(0);
1748 if (is_object($content)) {
1749 $obj_element->appendChild($obj_doc->importNode($content, true));
1752 $obj_doc->appendChild($obj_element);
1754 $objxml = $obj_doc->saveXML($obj_element);
1756 /// @todo This isn't totally clean. We should find a way to transform the namespaces
1757 $objxml = str_replace("<".$element.' xmlns="http://www.w3.org/2005/Atom">', "<".$element.">", $objxml);
1762 * Processes the mail elements
1764 * @param object $xpath XPath object
1765 * @param object $mail mail elements
1766 * @param array $importer Record of the importer user mixed with contact of the content
1768 * @throws \Exception
1769 * @todo Find good type-hints for all parameter
1771 private static function processMail($xpath, $mail, $importer)
1773 Logger::log("Processing mails");
1776 $msg["uid"] = $importer["importer_uid"];
1777 $msg["from-name"] = XML::getFirstValue($xpath, "dfrn:sender/dfrn:name/text()", $mail);
1778 $msg["from-url"] = XML::getFirstValue($xpath, "dfrn:sender/dfrn:uri/text()", $mail);
1779 $msg["from-photo"] = XML::getFirstValue($xpath, "dfrn:sender/dfrn:avatar/text()", $mail);
1780 $msg["contact-id"] = $importer["id"];
1781 $msg["uri"] = XML::getFirstValue($xpath, "dfrn:id/text()", $mail);
1782 $msg["parent-uri"] = XML::getFirstValue($xpath, "dfrn:in-reply-to/text()", $mail);
1783 $msg["created"] = DateTimeFormat::utc(XML::getFirstValue($xpath, "dfrn:sentdate/text()", $mail));
1784 $msg["title"] = XML::getFirstValue($xpath, "dfrn:subject/text()", $mail);
1785 $msg["body"] = XML::getFirstValue($xpath, "dfrn:content/text()", $mail);
1791 * Processes the suggestion elements
1793 * @param object $xpath XPath object
1794 * @param object $suggestion suggestion elements
1795 * @param array $importer Record of the importer user mixed with contact of the content
1797 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1798 * @todo Find good type-hints for all parameter
1800 private static function processSuggestion($xpath, $suggestion, $importer)
1802 Logger::notice('Processing suggestions');
1804 $url = $xpath->evaluate('string(dfrn:url[1]/text())', $suggestion);
1805 $cid = Contact::getIdForURL($url);
1806 $note = $xpath->evaluate('string(dfrn:note[1]/text())', $suggestion);
1808 return FContact::addSuggestion($importer['importer_uid'], $cid, $importer['id'], $note);
1812 * Processes the relocation elements
1814 * @param object $xpath XPath object
1815 * @param object $relocation relocation elements
1816 * @param array $importer Record of the importer user mixed with contact of the content
1818 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1819 * @throws \ImagickException
1820 * @todo Find good type-hints for all parameter
1822 private static function processRelocation($xpath, $relocation, $importer)
1824 Logger::log("Processing relocations");
1826 /// @TODO Rewrite this to one statement
1828 $relocate["uid"] = $importer["importer_uid"];
1829 $relocate["cid"] = $importer["id"];
1830 $relocate["url"] = $xpath->query("dfrn:url/text()", $relocation)->item(0)->nodeValue;
1831 $relocate["addr"] = $xpath->query("dfrn:addr/text()", $relocation)->item(0)->nodeValue;
1832 $relocate["name"] = $xpath->query("dfrn:name/text()", $relocation)->item(0)->nodeValue;
1833 $relocate["avatar"] = $xpath->query("dfrn:avatar/text()", $relocation)->item(0)->nodeValue;
1834 $relocate["photo"] = $xpath->query("dfrn:photo/text()", $relocation)->item(0)->nodeValue;
1835 $relocate["thumb"] = $xpath->query("dfrn:thumb/text()", $relocation)->item(0)->nodeValue;
1836 $relocate["micro"] = $xpath->query("dfrn:micro/text()", $relocation)->item(0)->nodeValue;
1837 $relocate["request"] = $xpath->query("dfrn:request/text()", $relocation)->item(0)->nodeValue;
1838 $relocate["confirm"] = $xpath->query("dfrn:confirm/text()", $relocation)->item(0)->nodeValue;
1839 $relocate["notify"] = $xpath->query("dfrn:notify/text()", $relocation)->item(0)->nodeValue;
1840 $relocate["poll"] = $xpath->query("dfrn:poll/text()", $relocation)->item(0)->nodeValue;
1841 $relocate["sitepubkey"] = $xpath->query("dfrn:sitepubkey/text()", $relocation)->item(0)->nodeValue;
1843 if (($relocate["avatar"] == "") && ($relocate["photo"] != "")) {
1844 $relocate["avatar"] = $relocate["photo"];
1847 if ($relocate["addr"] == "") {
1848 $relocate["addr"] = preg_replace("=(https?://)(.*)/profile/(.*)=ism", "$3@$2", $relocate["url"]);
1853 "SELECT `photo`, `url` FROM `contact` WHERE `id` = %d AND `uid` = %d",
1854 intval($importer["id"]),
1855 intval($importer["importer_uid"])
1858 if (!DBA::isResult($r)) {
1859 Logger::log("Query failed to execute, no result returned in " . __FUNCTION__);
1865 // Update the contact table. We try to find every entry.
1866 $fields = ['name' => $relocate["name"], 'avatar' => $relocate["avatar"],
1867 'url' => $relocate["url"], 'nurl' => Strings::normaliseLink($relocate["url"]),
1868 'addr' => $relocate["addr"], 'request' => $relocate["request"],
1869 'confirm' => $relocate["confirm"], 'notify' => $relocate["notify"],
1870 'poll' => $relocate["poll"], 'site-pubkey' => $relocate["sitepubkey"]];
1871 $condition = ["(`id` = ?) OR (`nurl` = ?)", $importer["id"], Strings::normaliseLink($old["url"])];
1873 DBA::update('contact', $fields, $condition);
1875 Contact::updateAvatar($importer["id"], $relocate["avatar"], true);
1877 Logger::log('Contacts are updated.');
1880 /// merge with current record, current contents have priority
1881 /// update record, set url-updated
1882 /// update profile photos
1883 /// schedule a scan?
1890 * @param array $current the current item record
1891 * @param array $item the new item record
1892 * @param array $importer Record of the importer user mixed with contact of the content
1893 * @param int $entrytype Is it a toplevel entry, a comment or a relayed comment?
1895 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1896 * @todo set proper type-hints (array?)
1898 private static function updateContent($current, $item, $importer, $entrytype)
1902 if (self::isEditedTimestampNewer($current, $item)) {
1903 // do not accept (ignore) an earlier edit than one we currently have.
1904 if (DateTimeFormat::utc($item["edited"]) < $current["edited"]) {
1908 $fields = ['title' => $item['title'] ?? '', 'body' => $item['body'] ?? '',
1909 'changed' => DateTimeFormat::utcNow(),
1910 'edited' => DateTimeFormat::utc($item["edited"])];
1912 $condition = ["`uri` = ? AND `uid` IN (0, ?)", $item["uri"], $importer["importer_uid"]];
1913 Item::update($fields, $condition);
1921 * Detects the entry type of the item
1923 * @param array $importer Record of the importer user mixed with contact of the content
1924 * @param array $item the new item record
1926 * @return int Is it a toplevel entry, a comment or a relayed comment?
1927 * @throws \Exception
1928 * @todo set proper type-hints (array?)
1930 private static function getEntryType($importer, $item)
1932 if ($item["parent-uri"] != $item["uri"]) {
1935 if ($importer["page-flags"] == User::PAGE_FLAGS_COMMUNITY || $importer["page-flags"] == User::PAGE_FLAGS_PRVGROUP) {
1938 Logger::log("possible community action");
1940 $sql_extra = " AND `contact`.`self` AND `item`.`wall` ";
1943 // was the top-level post for this action written by somebody on this site?
1944 // Specifically, the recipient?
1946 $is_a_remote_action = false;
1948 $parent = Item::selectFirst(['parent-uri'], ['uri' => $item["parent-uri"]]);
1949 if (DBA::isResult($parent)) {
1951 "SELECT `item`.`forum_mode`, `item`.`wall` FROM `item`
1952 INNER JOIN `contact` ON `contact`.`id` = `item`.`contact-id`
1953 WHERE `item`.`uri` = '%s' AND (`item`.`parent-uri` = '%s' OR `item`.`thr-parent` = '%s')
1954 AND `item`.`uid` = %d
1957 DBA::escape($parent["parent-uri"]),
1958 DBA::escape($parent["parent-uri"]),
1959 DBA::escape($parent["parent-uri"]),
1960 intval($importer["importer_uid"])
1962 if (DBA::isResult($r)) {
1963 $is_a_remote_action = true;
1968 * Does this have the characteristics of a community or private group action?
1969 * If it's an action to a wall post on a community/prvgroup page it's a
1970 * valid community action. Also forum_mode makes it valid for sure.
1971 * If neither, it's not.
1973 if ($is_a_remote_action && $community && (!$r[0]["forum_mode"]) && (!$r[0]["wall"])) {
1974 $is_a_remote_action = false;
1975 Logger::log("not a community action");
1978 if ($is_a_remote_action) {
1979 return DFRN::REPLY_RC;
1984 return DFRN::TOP_LEVEL;
1991 * @param array $item The new item record
1992 * @param array $importer Record of the importer user mixed with contact of the content
1994 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1995 * @todo set proper type-hints (array?)
1997 private static function doPoke(array $item, array $importer)
1999 $verb = urldecode(substr($item["verb"], strpos($item["verb"], "#")+1));
2003 $xo = XML::parseString($item["object"]);
2005 if (($xo->type == Activity\ObjectType::PERSON) && ($xo->id)) {
2006 // somebody was poked/prodded. Was it me?
2008 foreach ($xo->link as $l) {
2009 $atts = $l->attributes();
2010 switch ($atts["rel"]) {
2012 $Blink = $atts["href"];
2019 if ($Blink && Strings::compareLink($Blink, DI::baseUrl() . "/profile/" . $importer["nickname"])) {
2020 $author = DBA::selectFirst('contact', ['name', 'thumb', 'url'], ['id' => $item['author-id']]);
2022 $parent = Item::selectFirst(['id'], ['uri' => $item['parent-uri'], 'uid' => $importer["importer_uid"]]);
2023 $item['parent'] = $parent['id'];
2025 // send a notification
2028 "type" => Type::POKE,
2029 "notify_flags" => $importer["notify-flags"],
2030 "language" => $importer["language"],
2031 "to_name" => $importer["username"],
2032 "to_email" => $importer["email"],
2033 "uid" => $importer["importer_uid"],
2035 "link" => DI::baseUrl()."/display/".urlencode($item['guid']),
2036 "source_name" => $author["name"],
2037 "source_link" => $author["url"],
2038 "source_photo" => $author["thumb"],
2039 "verb" => $item["verb"],
2040 "otype" => "person",
2041 "activity" => $verb,
2042 "parent" => $item['parent']]
2049 * Processes several actions, depending on the verb
2051 * @param int $entrytype Is it a toplevel entry, a comment or a relayed comment?
2052 * @param array $importer Record of the importer user mixed with contact of the content
2053 * @param array $item the new item record
2054 * @param bool $is_like Is the verb a "like"?
2056 * @return bool Should the processing of the entries be continued?
2057 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2058 * @todo set proper type-hints (array?)
2060 private static function processVerbs($entrytype, $importer, &$item, &$is_like)
2062 Logger::log("Process verb ".$item["verb"]." and object-type ".$item["object-type"]." for entrytype ".$entrytype, Logger::DEBUG);
2064 if (($entrytype == DFRN::TOP_LEVEL) && !empty($importer['id'])) {
2065 // The filling of the the "contact" variable is done for legcy reasons
2066 // The functions below are partly used by ostatus.php as well - where we have this variable
2067 $contact = Contact::selectFirst([], ['id' => $importer['id']]);
2069 $activity = DI::activity();
2071 // Big question: Do we need these functions? They were part of the "consume_feed" function.
2072 // This function once was responsible for DFRN and OStatus.
2073 if ($activity->match($item["verb"], Activity::FOLLOW)) {
2074 Logger::log("New follower");
2075 Contact::addRelationship($importer, $contact, $item);
2078 if ($activity->match($item["verb"], Activity::UNFOLLOW)) {
2079 Logger::log("Lost follower");
2080 Contact::removeFollower($importer, $contact, $item);
2083 if ($activity->match($item["verb"], Activity::REQ_FRIEND)) {
2084 Logger::log("New friend request");
2085 Contact::addRelationship($importer, $contact, $item, true);
2088 if ($activity->match($item["verb"], Activity::UNFRIEND)) {
2089 Logger::log("Lost sharer");
2090 Contact::removeSharer($importer, $contact, $item);
2094 if (($item["verb"] == Activity::LIKE)
2095 || ($item["verb"] == Activity::DISLIKE)
2096 || ($item["verb"] == Activity::ATTEND)
2097 || ($item["verb"] == Activity::ATTENDNO)
2098 || ($item["verb"] == Activity::ATTENDMAYBE)
2099 || ($item["verb"] == Activity::ANNOUNCE)
2102 $item["gravity"] = GRAVITY_ACTIVITY;
2103 // only one like or dislike per person
2104 // splitted into two queries for performance issues
2105 $condition = ['uid' => $item["uid"], 'author-id' => $item["author-id"], 'gravity' => GRAVITY_ACTIVITY,
2106 'verb' => $item["verb"], 'parent-uri' => $item["parent-uri"]];
2107 if (Item::exists($condition)) {
2111 $condition = ['uid' => $item["uid"], 'author-id' => $item["author-id"], 'gravity' => GRAVITY_ACTIVITY,
2112 'verb' => $item["verb"], 'thr-parent' => $item["parent-uri"]];
2113 if (Item::exists($condition)) {
2117 // The owner of an activity must be the author
2118 $item["owner-name"] = $item["author-name"];
2119 $item["owner-link"] = $item["author-link"];
2120 $item["owner-avatar"] = $item["author-avatar"];
2121 $item["owner-id"] = $item["author-id"];
2126 if (($item["verb"] == Activity::TAG) && ($item["object-type"] == Activity\ObjectType::TAGTERM)) {
2127 $xo = XML::parseString($item["object"]);
2128 $xt = XML::parseString($item["target"]);
2130 if ($xt->type == Activity\ObjectType::NOTE) {
2131 $item_tag = Item::selectFirst(['id', 'uri-id', 'tag'], ['uri' => $xt->id, 'uid' => $importer["importer_uid"]]);
2133 if (!DBA::isResult($item_tag)) {
2134 Logger::log("Query failed to execute, no result returned in " . __FUNCTION__);
2138 // extract tag, if not duplicate, add to parent item
2140 Tag::store($item_tag['uri-id'], Tag::HASHTAG, $xo->content);
2149 * Processes the link elements
2151 * @param object $links link elements
2152 * @param array $item the item record
2154 * @todo set proper type-hints
2156 private static function parseLinks($links, &$item)
2163 foreach ($links as $link) {
2164 foreach ($link->attributes as $attributes) {
2165 switch ($attributes->name) {
2166 case "href" : $href = $attributes->textContent; break;
2167 case "rel" : $rel = $attributes->textContent; break;
2168 case "type" : $type = $attributes->textContent; break;
2169 case "length": $length = $attributes->textContent; break;
2170 case "title" : $title = $attributes->textContent; break;
2173 if (($rel != "") && ($href != "")) {
2176 $item["plink"] = $href;
2179 if (!empty($item["attach"])) {
2180 $item["attach"] .= ",";
2182 $item["attach"] = "";
2185 $item["attach"] .= Post\Media::getAttachElement($href, $length, $type, $title);
2193 * Checks if an incoming message is wanted
2195 * @param array $item
2196 * @return boolean Is the message wanted?
2198 private static function isSolicitedMessage(array $item)
2200 if (DBA::exists('contact', ["`nurl` = ? AND `uid` != ? AND `rel` IN (?, ?)",
2201 Strings::normaliseLink($item["author-link"]), 0, Contact::FRIEND, Contact::SHARING])) {
2202 Logger::info('Author has got followers - accepted', ['uri' => $item['uri'], 'author' => $item["author-link"]]);
2206 $taglist = Tag::getByURIId($item['uri-id'], [Tag::HASHTAG]);
2207 $tags = array_column($taglist, 'name');
2208 return Relay::isSolicitedPost($tags, $item['body'], $item['author-id'], $item['uri'], Protocol::DFRN);
2212 * Processes the entry elements which contain the items and comments
2214 * @param array $header Array of the header elements that always stay the same
2215 * @param object $xpath XPath object
2216 * @param object $entry entry elements
2217 * @param array $importer Record of the importer user mixed with contact of the content
2218 * @param string $xml xml
2220 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2221 * @throws \ImagickException
2222 * @todo Add type-hints
2224 private static function processEntry($header, $xpath, $entry, $importer, $xml)
2226 Logger::log("Processing entries");
2230 $item["protocol"] = Conversation::PARCEL_DFRN;
2232 $item["source"] = $xml;
2235 $item["uri"] = XML::getFirstNodeValue($xpath, "atom:id/text()", $entry);
2237 $item["edited"] = XML::getFirstNodeValue($xpath, "atom:updated/text()", $entry);
2239 $current = Item::selectFirst(['id', 'uid', 'edited', 'body'],
2240 ['uri' => $item["uri"], 'uid' => $importer["importer_uid"]]
2242 // Is there an existing item?
2243 if (DBA::isResult($current) && !self::isEditedTimestampNewer($current, $item)) {
2244 Logger::log("Item ".$item["uri"]." (".$item['edited'].") already existed.", Logger::DEBUG);
2249 $owner = self::fetchauthor($xpath, $entry, $importer, "dfrn:owner", true, $xml);
2251 $owner_unknown = (isset($owner["contact-unknown"]) && $owner["contact-unknown"]);
2253 $item["owner-name"] = $owner["name"];
2254 $item["owner-link"] = $owner["link"];
2255 $item["owner-avatar"] = $owner["avatar"];
2256 $item["owner-id"] = Contact::getIdForURL($owner["link"], 0);
2259 $author = self::fetchauthor($xpath, $entry, $importer, "atom:author", true, $xml);
2261 $item["author-name"] = $author["name"];
2262 $item["author-link"] = $author["link"];
2263 $item["author-avatar"] = $author["avatar"];
2264 $item["author-id"] = Contact::getIdForURL($author["link"], 0);
2266 $item["title"] = XML::getFirstNodeValue($xpath, "atom:title/text()", $entry);
2268 $item["created"] = XML::getFirstNodeValue($xpath, "atom:published/text()", $entry);
2270 $item["body"] = XML::getFirstNodeValue($xpath, "dfrn:env/text()", $entry);
2271 $item["body"] = str_replace([' ',"\t","\r","\n"], ['','','',''], $item["body"]);
2273 $item["body"] = Strings::base64UrlDecode($item["body"]);
2275 $item["body"] = BBCode::limitBodySize($item["body"]);
2277 /// @todo We should check for a repeated post and if we know the repeated author.
2279 // We don't need the content element since "dfrn:env" is always present
2280 //$item["body"] = $xpath->query("atom:content/text()", $entry)->item(0)->nodeValue;
2282 $item["location"] = XML::getFirstNodeValue($xpath, "dfrn:location/text()", $entry);
2284 $item["coord"] = XML::getFirstNodeValue($xpath, "georss:point", $entry);
2286 $item["private"] = XML::getFirstNodeValue($xpath, "dfrn:private/text()", $entry);
2288 $unlisted = XML::getFirstNodeValue($xpath, "dfrn:unlisted/text()", $entry);
2289 if (!empty($unlisted) && ($item['private'] != Item::PRIVATE)) {
2290 $item['private'] = Item::UNLISTED;
2293 $item["extid"] = XML::getFirstNodeValue($xpath, "dfrn:extid/text()", $entry);
2295 if (XML::getFirstNodeValue($xpath, "dfrn:bookmark/text()", $entry) == "true") {
2296 $item["post-type"] = Item::PT_PAGE;
2299 $notice_info = $xpath->query("statusnet:notice_info", $entry);
2300 if ($notice_info && ($notice_info->length > 0)) {
2301 foreach ($notice_info->item(0)->attributes as $attributes) {
2302 if ($attributes->name == "source") {
2303 $item["app"] = strip_tags($attributes->textContent);
2308 $item["guid"] = XML::getFirstNodeValue($xpath, "dfrn:diaspora_guid/text()", $entry);
2310 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
2312 Tag::storeFromBody($item['uri-id'], $item["body"]);
2314 // We store the data from "dfrn:diaspora_signature" in a different table, this is done in "Item::insert"
2315 $dsprsig = XML::unescape(XML::getFirstNodeValue($xpath, "dfrn:diaspora_signature/text()", $entry));
2316 if ($dsprsig != "") {
2317 $signature = json_decode(base64_decode($dsprsig));
2318 // We don't store the old style signatures anymore that also contained the "signature" and "signer"
2319 if (!empty($signature->signed_text) && empty($signature->signature) && empty($signature->signer)) {
2320 $item["diaspora_signed_text"] = $signature->signed_text;
2324 $item["verb"] = XML::getFirstNodeValue($xpath, "activity:verb/text()", $entry);
2326 if (XML::getFirstNodeValue($xpath, "activity:object-type/text()", $entry) != "") {
2327 $item["object-type"] = XML::getFirstNodeValue($xpath, "activity:object-type/text()", $entry);
2330 $object = $xpath->query("activity:object", $entry)->item(0);
2331 $item["object"] = self::transformActivity($xpath, $object, "object");
2333 if (trim($item["object"]) != "") {
2334 $r = XML::parseString($item["object"]);
2335 if (isset($r->type)) {
2336 $item["object-type"] = $r->type;
2340 $target = $xpath->query("activity:target", $entry)->item(0);
2341 $item["target"] = self::transformActivity($xpath, $target, "target");
2343 $categories = $xpath->query("atom:category", $entry);
2345 foreach ($categories as $category) {
2348 foreach ($category->attributes as $attributes) {
2349 if ($attributes->name == "term") {
2350 $term = $attributes->textContent;
2353 if ($attributes->name == "scheme") {
2354 $scheme = $attributes->textContent;
2358 if (($term != "") && ($scheme != "")) {
2359 $parts = explode(":", $scheme);
2360 if ((count($parts) >= 4) && (array_shift($parts) == "X-DFRN")) {
2361 $termurl = array_pop($parts);
2362 $termurl = array_pop($parts) . ':' . $termurl;
2363 Tag::store($item['uri-id'], Tag::IMPLICIT_MENTION, $term, $termurl);
2369 $links = $xpath->query("atom:link", $entry);
2371 self::parseLinks($links, $item);
2374 $item['conversation-uri'] = XML::getFirstNodeValue($xpath, 'ostatus:conversation/text()', $entry);
2376 $conv = $xpath->query('ostatus:conversation', $entry);
2377 if (is_object($conv->item(0))) {
2378 foreach ($conv->item(0)->attributes as $attributes) {
2379 if ($attributes->name == "ref") {
2380 $item['conversation-uri'] = $attributes->textContent;
2382 if ($attributes->name == "href") {
2383 $item['conversation-href'] = $attributes->textContent;
2388 // Is it a reply or a top level posting?
2389 $item["parent-uri"] = $item["uri"];
2391 $inreplyto = $xpath->query("thr:in-reply-to", $entry);
2392 if (is_object($inreplyto->item(0))) {
2393 foreach ($inreplyto->item(0)->attributes as $attributes) {
2394 if ($attributes->name == "ref") {
2395 $item["parent-uri"] = $attributes->textContent;
2400 // Check if the message is wanted
2401 if (($importer["importer_uid"] == 0) && ($item['uri'] == $item['parent-uri'])) {
2402 if (!self::isSolicitedMessage($item)) {
2403 DBA::delete('item-uri', ['uri' => $item['uri']]);
2408 // Get the type of the item (Top level post, reply or remote reply)
2409 $entrytype = self::getEntryType($importer, $item);
2411 // Now assign the rest of the values that depend on the type of the message
2412 if (in_array($entrytype, [DFRN::REPLY, DFRN::REPLY_RC])) {
2413 if (!isset($item["object-type"])) {
2414 $item["object-type"] = Activity\ObjectType::COMMENT;
2417 if ($item["contact-id"] != $owner["contact-id"]) {
2418 $item["contact-id"] = $owner["contact-id"];
2421 if (($item["network"] != $owner["network"]) && ($owner["network"] != "")) {
2422 $item["network"] = $owner["network"];
2425 if ($item["contact-id"] != $author["contact-id"]) {
2426 $item["contact-id"] = $author["contact-id"];
2429 if (($item["network"] != $author["network"]) && ($author["network"] != "")) {
2430 $item["network"] = $author["network"];
2434 // Ensure to have the correct share data
2435 $item = Item::addShareDataFromOriginal($item);
2437 if ($entrytype == DFRN::REPLY_RC) {
2439 } elseif ($entrytype == DFRN::TOP_LEVEL) {
2440 if (!isset($item["object-type"])) {
2441 $item["object-type"] = Activity\ObjectType::NOTE;
2445 if (($item["object-type"] == Activity\ObjectType::EVENT) && !$owner_unknown) {
2446 Logger::log("Item ".$item["uri"]." seems to contain an event.", Logger::DEBUG);
2447 $ev = Event::fromBBCode($item["body"]);
2448 if ((!empty($ev['desc']) || !empty($ev['summary'])) && !empty($ev['start'])) {
2449 Logger::log("Event in item ".$item["uri"]." was found.", Logger::DEBUG);
2450 $ev["cid"] = $importer["id"];
2451 $ev["uid"] = $importer["importer_uid"];
2452 $ev["uri"] = $item["uri"];
2453 $ev["edited"] = $item["edited"];
2454 $ev["private"] = $item["private"];
2455 $ev["guid"] = $item["guid"];
2456 $ev["plink"] = $item["plink"];
2458 $condition = ['uri' => $item["uri"], 'uid' => $importer["importer_uid"]];
2459 $event = DBA::selectFirst('event', ['id'], $condition);
2460 if (DBA::isResult($event)) {
2461 $ev["id"] = $event["id"];
2464 $event_id = Event::store($ev);
2465 Logger::log("Event ".$event_id." was stored", Logger::DEBUG);
2471 if (!self::processVerbs($entrytype, $importer, $item, $is_like)) {
2472 Logger::log("Exiting because 'processVerbs' told us so", Logger::DEBUG);
2476 // This check is done here to be able to receive connection requests in "processVerbs"
2477 if (($entrytype == DFRN::TOP_LEVEL) && $owner_unknown) {
2478 Logger::log("Item won't be stored because user " . $importer["importer_uid"] . " doesn't follow " . $item["owner-link"] . ".", Logger::DEBUG);
2483 // Update content if 'updated' changes
2484 if (DBA::isResult($current)) {
2485 if (self::updateContent($current, $item, $importer, $entrytype)) {
2486 Logger::log("Item ".$item["uri"]." was updated.", Logger::DEBUG);
2488 Logger::log("Item " . $item["uri"] . " already existed.", Logger::DEBUG);
2493 if (in_array($entrytype, [DFRN::REPLY, DFRN::REPLY_RC])) {
2494 // Will be overwritten for sharing accounts in Item::insert
2495 if (empty($item['post-type']) && ($entrytype == DFRN::REPLY)) {
2496 $item['post-type'] = Item::PT_COMMENT;
2499 $posted_id = Item::insert($item);
2501 Logger::log("Reply from contact ".$item["contact-id"]." was stored with id ".$posted_id, Logger::DEBUG);
2503 if ($item['uid'] == 0) {
2504 Item::distribute($posted_id);
2509 } else { // $entrytype == DFRN::TOP_LEVEL
2510 if (($importer["uid"] == 0) && ($importer["importer_uid"] != 0)) {
2511 Logger::log("Contact ".$importer["id"]." isn't known to user ".$importer["importer_uid"].". The post will be ignored.", Logger::DEBUG);
2514 if (!Strings::compareLink($item["owner-link"], $importer["url"])) {
2516 * The item owner info is not our contact. It's OK and is to be expected if this is a tgroup delivery,
2517 * but otherwise there's a possible data mixup on the sender's system.
2518 * the tgroup delivery code called from Item::insert will correct it if it's a forum,
2519 * but we're going to unconditionally correct it here so that the post will always be owned by our contact.
2521 Logger::log('Correcting item owner.', Logger::DEBUG);
2522 $item["owner-link"] = $importer["url"];
2523 $item["owner-id"] = Contact::getIdForURL($importer["url"], 0);
2526 if (($importer["rel"] == Contact::FOLLOWER) && (!self::tgroupCheck($importer["importer_uid"], $item))) {
2527 Logger::log("Contact ".$importer["id"]." is only follower and tgroup check was negative.", Logger::DEBUG);
2531 // This is my contact on another system, but it's really me.
2532 // Turn this into a wall post.
2533 $notify = Item::isRemoteSelf($importer, $item);
2535 $posted_id = Item::insert($item, $notify);
2538 $posted_id = $notify;
2541 Logger::log("Item was stored with id ".$posted_id, Logger::DEBUG);
2543 if ($item['uid'] == 0) {
2544 Item::distribute($posted_id);
2547 if (stristr($item["verb"], Activity::POKE)) {
2548 $item['id'] = $posted_id;
2549 self::doPoke($item, $importer);
2557 * @param object $xpath XPath object
2558 * @param object $deletion deletion elements
2559 * @param array $importer Record of the importer user mixed with contact of the content
2561 * @throws \Exception
2562 * @todo set proper type-hints
2564 private static function processDeletion($xpath, $deletion, $importer)
2566 Logger::log("Processing deletions");
2569 foreach ($deletion->attributes as $attributes) {
2570 if ($attributes->name == "ref") {
2571 $uri = $attributes->textContent;
2575 if (!$uri || !$importer["id"]) {
2579 $condition = ['uri' => $uri, 'uid' => $importer["importer_uid"]];
2580 $item = Item::selectFirst(['id', 'parent', 'contact-id', 'file', 'deleted', 'gravity'], $condition);
2581 if (!DBA::isResult($item)) {
2582 Logger::log("Item with uri " . $uri . " for user " . $importer["importer_uid"] . " wasn't found.", Logger::DEBUG);
2586 if (strstr($item['file'], '[')) {
2587 Logger::log("Item with uri " . $uri . " for user " . $importer["importer_uid"] . " is filed. So it won't be deleted.", Logger::DEBUG);
2591 // When it is a starting post it has to belong to the person that wants to delete it
2592 if (($item['gravity'] == GRAVITY_PARENT) && ($item['contact-id'] != $importer["id"])) {
2593 Logger::log("Item with uri " . $uri . " don't belong to contact " . $importer["id"] . " - ignoring deletion.", Logger::DEBUG);
2597 // Comments can be deleted by the thread owner or comment owner
2598 if (($item['gravity'] != GRAVITY_PARENT) && ($item['contact-id'] != $importer["id"])) {
2599 $condition = ['id' => $item['parent'], 'contact-id' => $importer["id"]];
2600 if (!Item::exists($condition)) {
2601 Logger::log("Item with uri " . $uri . " wasn't found or mustn't be deleted by contact " . $importer["id"] . " - ignoring deletion.", Logger::DEBUG);
2606 if ($item["deleted"]) {
2610 Logger::log('deleting item '.$item['id'].' uri='.$uri, Logger::DEBUG);
2612 Item::markForDeletion(['id' => $item['id']]);
2616 * Imports a DFRN message
2618 * @param string $xml The DFRN message
2619 * @param array $importer Record of the importer user mixed with contact of the content
2620 * @param bool $sort_by_date Is used when feeds are polled
2621 * @return integer Import status
2622 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2623 * @throws \ImagickException
2624 * @todo set proper type-hints
2626 public static function import($xml, $importer, $sort_by_date = false)
2632 $doc = new DOMDocument();
2633 @$doc->loadXML($xml);
2635 $xpath = new DOMXPath($doc);
2636 $xpath->registerNamespace("atom", ActivityNamespace::ATOM1);
2637 $xpath->registerNamespace("thr", ActivityNamespace::THREAD);
2638 $xpath->registerNamespace("at", ActivityNamespace::TOMB);
2639 $xpath->registerNamespace("media", ActivityNamespace::MEDIA);
2640 $xpath->registerNamespace("dfrn", ActivityNamespace::DFRN);
2641 $xpath->registerNamespace("activity", ActivityNamespace::ACTIVITY);
2642 $xpath->registerNamespace("georss", ActivityNamespace::GEORSS);
2643 $xpath->registerNamespace("poco", ActivityNamespace::POCO);
2644 $xpath->registerNamespace("ostatus", ActivityNamespace::OSTATUS);
2645 $xpath->registerNamespace("statusnet", ActivityNamespace::STATUSNET);
2648 $header["uid"] = $importer["importer_uid"];
2649 $header["network"] = Protocol::DFRN;
2650 $header["wall"] = 0;
2651 $header["origin"] = 0;
2652 $header["contact-id"] = $importer["id"];
2654 // Update the contact table if the data has changed
2656 // The "atom:author" is only present in feeds
2657 if ($xpath->query("/atom:feed/atom:author")->length > 0) {
2658 self::fetchauthor($xpath, $doc->firstChild, $importer, "atom:author", false, $xml);
2661 // Only the "dfrn:owner" in the head section contains all data
2662 if ($xpath->query("/atom:feed/dfrn:owner")->length > 0) {
2663 self::fetchauthor($xpath, $doc->firstChild, $importer, "dfrn:owner", false, $xml);
2666 Logger::log("Import DFRN message for user " . $importer["importer_uid"] . " from contact " . $importer["id"], Logger::DEBUG);
2668 // is it a public forum? Private forums aren't exposed with this method
2669 $forum = intval(XML::getFirstNodeValue($xpath, "/atom:feed/dfrn:community/text()"));
2671 // The account type is new since 3.5.1
2672 if ($xpath->query("/atom:feed/dfrn:account_type")->length > 0) {
2673 // Hint: We are using separate update calls for uid=0 and uid!=0 since a combined call is bad for the database performance
2675 $accounttype = intval(XML::getFirstNodeValue($xpath, "/atom:feed/dfrn:account_type/text()"));
2677 if ($accounttype != $importer["contact-type"]) {
2678 DBA::update('contact', ['contact-type' => $accounttype], ['id' => $importer['id']]);
2680 // Updating the public contact as well
2681 DBA::update('contact', ['contact-type' => $accounttype], ['uid' => 0, 'nurl' => $importer['nurl']]);
2683 // A forum contact can either have set "forum" or "prv" - but not both
2684 if ($accounttype == User::ACCOUNT_TYPE_COMMUNITY) {
2685 // It's a forum, so either set the public or private forum flag
2686 $condition = ['(`forum` != ? OR `prv` != ?) AND `id` = ?', $forum, !$forum, $importer['id']];
2687 DBA::update('contact', ['forum' => $forum, 'prv' => !$forum], $condition);
2689 // Updating the public contact as well
2690 $condition = ['(`forum` != ? OR `prv` != ?) AND `uid` = 0 AND `nurl` = ?', $forum, !$forum, $importer['nurl']];
2691 DBA::update('contact', ['forum' => $forum, 'prv' => !$forum], $condition);
2693 // It's not a forum, so remove the flags
2694 $condition = ['(`forum` OR `prv`) AND `id` = ?', $importer['id']];
2695 DBA::update('contact', ['forum' => false, 'prv' => false], $condition);
2697 // Updating the public contact as well
2698 $condition = ['(`forum` OR `prv`) AND `uid` = 0 AND `nurl` = ?', $importer['nurl']];
2699 DBA::update('contact', ['forum' => false, 'prv' => false], $condition);
2701 } elseif ($forum != $importer["forum"]) { // Deprecated since 3.5.1
2702 $condition = ['`forum` != ? AND `id` = ?', $forum, $importer["id"]];
2703 DBA::update('contact', ['forum' => $forum], $condition);
2705 // Updating the public contact as well
2706 $condition = ['`forum` != ? AND `uid` = 0 AND `nurl` = ?', $forum, $importer['nurl']];
2707 DBA::update('contact', ['forum' => $forum], $condition);
2711 // We are processing relocations even if we are ignoring a contact
2712 $relocations = $xpath->query("/atom:feed/dfrn:relocate");
2713 foreach ($relocations as $relocation) {
2714 self::processRelocation($xpath, $relocation, $importer);
2717 if (($importer["uid"] != 0) && !$importer["readonly"]) {
2718 $mails = $xpath->query("/atom:feed/dfrn:mail");
2719 foreach ($mails as $mail) {
2720 self::processMail($xpath, $mail, $importer);
2723 $suggestions = $xpath->query("/atom:feed/dfrn:suggest");
2724 foreach ($suggestions as $suggestion) {
2725 self::processSuggestion($xpath, $suggestion, $importer);
2729 $deletions = $xpath->query("/atom:feed/at:deleted-entry");
2730 foreach ($deletions as $deletion) {
2731 self::processDeletion($xpath, $deletion, $importer);
2734 if (!$sort_by_date) {
2735 $entries = $xpath->query("/atom:feed/atom:entry");
2736 foreach ($entries as $entry) {
2737 self::processEntry($header, $xpath, $entry, $importer, $xml);
2741 $entries = $xpath->query("/atom:feed/atom:entry");
2742 foreach ($entries as $entry) {
2743 $created = XML::getFirstNodeValue($xpath, "atom:published/text()", $entry);
2744 $newentries[strtotime($created)] = $entry;
2747 // Now sort after the publishing date
2750 foreach ($newentries as $entry) {
2751 self::processEntry($header, $xpath, $entry, $importer, $xml);
2754 Logger::log("Import done for user " . $importer["importer_uid"] . " from contact " . $importer["id"], Logger::DEBUG);
2759 * Returns the activity verb
2761 * @param array $item Item array
2763 * @return string activity verb
2765 private static function constructVerb(array $item)
2767 if ($item['verb']) {
2768 return $item['verb'];
2770 return Activity::POST;
2773 private static function tgroupCheck($uid, $item)
2777 // check that the message originated elsewhere and is a top-level post
2779 if ($item['wall'] || $item['origin'] || ($item['uri'] != $item['parent-uri'])) {
2783 $user = DBA::selectFirst('user', ['page-flags', 'nickname'], ['uid' => $uid]);
2784 if (!DBA::isResult($user)) {
2788 $community_page = ($user['page-flags'] == User::PAGE_FLAGS_COMMUNITY);
2789 $prvgroup = ($user['page-flags'] == User::PAGE_FLAGS_PRVGROUP);
2791 $link = Strings::normaliseLink(DI::baseUrl() . '/profile/' . $user['nickname']);
2794 * Diaspora uses their own hardwired link URL in @-tags
2795 * instead of the one we supply with webfinger
2797 $dlink = Strings::normaliseLink(DI::baseUrl() . '/u/' . $user['nickname']);
2799 $cnt = preg_match_all('/[\@\!]\[url\=(.*?)\](.*?)\[\/url\]/ism', $item['body'], $matches, PREG_SET_ORDER);
2801 foreach ($matches as $mtch) {
2802 if (Strings::compareLink($link, $mtch[1]) || Strings::compareLink($dlink, $mtch[1])) {
2804 Logger::log('mention found: ' . $mtch[2]);
2813 return $community_page || $prvgroup;
2817 * This function returns true if $update has an edited timestamp newer
2818 * than $existing, i.e. $update contains new data which should override
2819 * what's already there. If there is no timestamp yet, the update is
2820 * assumed to be newer. If the update has no timestamp, the existing
2821 * item is assumed to be up-to-date. If the timestamps are equal it
2822 * assumes the update has been seen before and should be ignored.
2827 * @throws \Exception
2829 private static function isEditedTimestampNewer($existing, $update)
2831 if (empty($existing['edited'])) {
2834 if (empty($update['edited'])) {
2838 $existing_edited = DateTimeFormat::utc($existing['edited']);
2839 $update_edited = DateTimeFormat::utc($update['edited']);
2841 return (strcmp($existing_edited, $update_edited) < 0);
2845 * Checks if the given contact url does support DFRN
2847 * @param string $url profile url
2849 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2850 * @throws \ImagickException
2852 public static function isSupportedByContactUrl($url)
2854 $probe = Probe::uri($url, Protocol::DFRN);
2855 return $probe['network'] == Protocol::DFRN;