]> git.mxchange.org Git - friendica.git/blob - src/Protocol/DFRN.php
ef7eb0f481570816ffdda6819c7b72216d7d5955
[friendica.git] / src / Protocol / DFRN.php
1 <?php
2 /**
3  * @copyright Copyright (C) 2020, Friendica
4  *
5  * @license GNU AGPL version 3 or any later version
6  *
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.
11  *
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.
16  *
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/>.
19  *
20  */
21
22 namespace Friendica\Protocol;
23
24 use DOMDocument;
25 use DOMXPath;
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;
32 use Friendica\DI;
33 use Friendica\Model\Contact;
34 use Friendica\Model\Conversation;
35 use Friendica\Model\Event;
36 use Friendica\Model\GContact;
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\Category;
43 use Friendica\Model\Profile;
44 use Friendica\Model\Tag;
45 use Friendica\Model\User;
46 use Friendica\Network\HTTPRequest;
47 use Friendica\Network\Probe;
48 use Friendica\Util\Crypto;
49 use Friendica\Util\DateTimeFormat;
50 use Friendica\Util\Images;
51 use Friendica\Util\Network;
52 use Friendica\Util\Strings;
53 use Friendica\Util\XML;
54
55 /**
56  * This class contain functions to create and send DFRN XML files
57  */
58 class DFRN
59 {
60
61         const TOP_LEVEL = 0;    // Top level posting
62         const REPLY = 1;                // Regular reply that is stored locally
63         const REPLY_RC = 2;     // Reply that will be relayed
64
65         /**
66          * Generates an array of contact and user for DFRN imports
67          *
68          * This array contains not only the receiver but also the sender of the message.
69          *
70          * @param integer $cid Contact id
71          * @param integer $uid User id
72          *
73          * @return array importer
74          * @throws \Exception
75          */
76         public static function getImporter($cid, $uid = 0)
77         {
78                 $condition = ['id' => $cid, 'blocked' => false, 'pending' => false];
79                 $contact = DBA::selectFirst('contact', [], $condition);
80                 if (!DBA::isResult($contact)) {
81                         return [];
82                 }
83
84                 $contact['cpubkey'] = $contact['pubkey'];
85                 $contact['cprvkey'] = $contact['prvkey'];
86                 $contact['senderName'] = $contact['name'];
87
88                 if ($uid != 0) {
89                         $condition = ['uid' => $uid, 'account_expired' => false, 'account_removed' => false];
90                         $user = DBA::selectFirst('user', [], $condition);
91                         if (!DBA::isResult($user)) {
92                                 return [];
93                         }
94
95                         $user['importer_uid'] = $user['uid'];
96                         $user['uprvkey'] = $user['prvkey'];
97                 } else {
98                         $user = ['importer_uid' => 0, 'uprvkey' => '', 'timezone' => 'UTC',
99                                 'nickname' => '', 'sprvkey' => '', 'spubkey' => '',
100                                 'page-flags' => 0, 'account-type' => 0, 'prvnets' => 0];
101                 }
102
103                 return array_merge($contact, $user);
104         }
105
106         /**
107          * Generates the atom entries for delivery.php
108          *
109          * This function is used whenever content is transmitted via DFRN.
110          *
111          * @param array $items Item elements
112          * @param array $owner Owner record
113          *
114          * @return string DFRN entries
115          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
116          * @throws \ImagickException
117          * @todo  Find proper type-hints
118          */
119         public static function entries($items, $owner)
120         {
121                 $doc = new DOMDocument('1.0', 'utf-8');
122                 $doc->formatOutput = true;
123
124                 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
125
126                 if (! count($items)) {
127                         return trim($doc->saveXML());
128                 }
129
130                 foreach ($items as $item) {
131                         // These values aren't sent when sending from the queue.
132                         /// @todo Check if we can set these values from the queue or if they are needed at all.
133                         $item["entry:comment-allow"] = ($item["entry:comment-allow"] ?? '') ?: true;
134                         $item["entry:cid"] = $item["entry:cid"] ?? 0;
135
136                         $entry = self::entry($doc, "text", $item, $owner, $item["entry:comment-allow"], $item["entry:cid"]);
137                         if (isset($entry)) {
138                                 $root->appendChild($entry);
139                         }
140                 }
141
142                 return trim($doc->saveXML());
143         }
144
145         /**
146          * Generate an atom feed for the given user
147          *
148          * This function is called when another server is pulling data from the user feed.
149          *
150          * @param string  $dfrn_id     DFRN ID from the requesting party
151          * @param string  $owner_nick  Owner nick name
152          * @param string  $last_update Date of the last update
153          * @param int     $direction   Can be -1, 0 or 1.
154          * @param boolean $onlyheader  Output only the header without content? (Default is "no")
155          *
156          * @return string DFRN feed entries
157          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
158          * @throws \ImagickException
159          */
160         public static function feed($dfrn_id, $owner_nick, $last_update, $direction = 0, $onlyheader = false)
161         {
162                 $a = DI::app();
163
164                 $sitefeed    = ((strlen($owner_nick)) ? false : true); // not yet implemented, need to rewrite huge chunks of following logic
165                 $public_feed = (($dfrn_id) ? false : true);
166                 $starred     = false;   // not yet implemented, possible security issues
167                 $converse    = false;
168
169                 if ($public_feed && $a->argc > 2) {
170                         for ($x = 2; $x < $a->argc; $x++) {
171                                 if ($a->argv[$x] == 'converse') {
172                                         $converse = true;
173                                 }
174                                 if ($a->argv[$x] == 'starred') {
175                                         $starred = true;
176                                 }
177                                 if ($a->argv[$x] == 'category' && $a->argc > ($x + 1) && strlen($a->argv[$x+1])) {
178                                         $category = $a->argv[$x+1];
179                                 }
180                         }
181                 }
182
183                 // default permissions - anonymous user
184
185                 $sql_extra = sprintf(" AND `item`.`private` != %s ", Item::PRIVATE);
186
187                 $owner = DBA::selectFirst('owner-view', [], ['nickname' => $owner_nick]);
188                 if (!DBA::isResult($owner)) {
189                         Logger::log(sprintf('No contact found for nickname=%d', $owner_nick), Logger::WARNING);
190                         exit();
191                 }
192
193                 $owner_id = $owner['uid'];
194
195                 $sql_post_table = "";
196
197                 if (! $public_feed) {
198                         switch ($direction) {
199                                 case (-1):
200                                         $sql_extra = sprintf(" AND `issued-id` = '%s' ", DBA::escape($dfrn_id));
201                                         break;
202                                 case 0:
203                                         $sql_extra = sprintf(" AND `issued-id` = '%s' AND `duplex` = 1 ", DBA::escape($dfrn_id));
204                                         break;
205                                 case 1:
206                                         $sql_extra = sprintf(" AND `dfrn-id` = '%s' AND `duplex` = 1 ", DBA::escape($dfrn_id));
207                                         break;
208                                 default:
209                                         return false;
210                                         break; // NOTREACHED
211                         }
212
213                         $r = q(
214                                 "SELECT * FROM `contact` WHERE NOT `blocked` AND `contact`.`uid` = %d $sql_extra LIMIT 1",
215                                 intval($owner_id)
216                         );
217
218                         if (! DBA::isResult($r)) {
219                                 Logger::log(sprintf('No contact found for uid=%d', $owner_id), Logger::WARNING);
220                                 exit();
221                         }
222
223                         $contact = $r[0];
224
225                         $set = PermissionSet::get($owner_id, $contact['id']);
226
227                         if (!empty($set)) {
228                                 $sql_extra = " AND `item`.`psid` IN (" . implode(',', $set) .")";
229                         } else {
230                                 $sql_extra = sprintf(" AND `item`.`private` != %s", Item::PRIVATE);
231                         }
232                 }
233
234                 if ($public_feed) {
235                         $sort = 'DESC';
236                 } else {
237                         $sort = 'ASC';
238                 }
239
240                 if (! strlen($last_update)) {
241                         $last_update = 'now -30 days';
242                 }
243
244                 if (isset($category)) {
245                         $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` ",
246                                 DBA::escape(Strings::protectSprintf($category)), intval(Category::CATEGORY), intval($owner_id));
247                 }
248
249                 if ($public_feed && ! $converse) {
250                         $sql_extra .= " AND `contact`.`self` = 1 ";
251                 }
252
253                 $check_date = DateTimeFormat::utc($last_update);
254
255                 $r = q(
256                         "SELECT `item`.`id`
257                         FROM `item` USE INDEX (`uid_wall_changed`) $sql_post_table
258                         STRAIGHT_JOIN `contact` ON `contact`.`id` = `item`.`contact-id`
259                         WHERE `item`.`uid` = %d AND `item`.`wall` AND `item`.`changed` > '%s'
260                         AND `item`.`visible` $sql_extra
261                         ORDER BY `item`.`parent` ".$sort.", `item`.`received` ASC LIMIT 0, 300",
262                         intval($owner_id),
263                         DBA::escape($check_date),
264                         DBA::escape($sort)
265                 );
266
267                 $ids = [];
268                 foreach ($r as $item) {
269                         $ids[] = $item['id'];
270                 }
271
272                 if (!empty($ids)) {
273                         $ret = Item::select(Item::DELIVER_FIELDLIST, ['id' => $ids]);
274                         $items = Item::inArray($ret);
275                 } else {
276                         $items = [];
277                 }
278
279                 /*
280                  * Will check further below if this actually returned results.
281                  * We will provide an empty feed if that is the case.
282                  */
283
284                 $doc = new DOMDocument('1.0', 'utf-8');
285                 $doc->formatOutput = true;
286
287                 $alternatelink = $owner['url'];
288
289                 if (isset($category)) {
290                         $alternatelink .= "/category/".$category;
291                 }
292
293                 if ($public_feed) {
294                         $author = "dfrn:owner";
295                 } else {
296                         $author = "author";
297                 }
298
299                 $root = self::addHeader($doc, $owner, $author, $alternatelink, true);
300
301                 /// @TODO This hook can't work anymore
302                 //      \Friendica\Core\Hook::callAll('atom_feed', $atom);
303
304                 if (!DBA::isResult($items) || $onlyheader) {
305                         $atom = trim($doc->saveXML());
306
307                         Hook::callAll('atom_feed_end', $atom);
308
309                         return $atom;
310                 }
311
312                 foreach ($items as $item) {
313                         // prevent private email from leaking.
314                         if ($item['network'] == Protocol::MAIL) {
315                                 continue;
316                         }
317
318                         // public feeds get html, our own nodes use bbcode
319
320                         if ($public_feed) {
321                                 $type = 'html';
322                                 // catch any email that's in a public conversation and make sure it doesn't leak
323                                 if ($item['private'] == Item::PRIVATE) {
324                                         continue;
325                                 }
326                         } else {
327                                 $type = 'text';
328                         }
329
330                         $entry = self::entry($doc, $type, $item, $owner, true);
331                         if (isset($entry)) {
332                                 $root->appendChild($entry);
333                         }
334                 }
335
336                 $atom = trim($doc->saveXML());
337
338                 Hook::callAll('atom_feed_end', $atom);
339
340                 return $atom;
341         }
342
343         /**
344          * Generate an atom entry for a given item id
345          *
346          * @param int     $item_id      The item id
347          * @param boolean $conversation Show the conversation. If false show the single post.
348          *
349          * @return string DFRN feed entry
350          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
351          * @throws \ImagickException
352          */
353         public static function itemFeed($item_id, $conversation = false)
354         {
355                 if ($conversation) {
356                         $condition = ['parent' => $item_id];
357                 } else {
358                         $condition = ['id' => $item_id];
359                 }
360
361                 $ret = Item::select(Item::DELIVER_FIELDLIST, $condition);
362                 $items = Item::inArray($ret);
363                 if (!DBA::isResult($items)) {
364                         return '';
365                 }
366
367                 $item = $items[0];
368
369                 if ($item['uid'] != 0) {
370                         $owner = User::getOwnerDataById($item['uid']);
371                         if (!$owner) {
372                                 return '';
373                         }
374                 } else {
375                         $owner = ['uid' => 0, 'nick' => 'feed-item'];
376                 }
377
378                 $doc = new DOMDocument('1.0', 'utf-8');
379                 $doc->formatOutput = true;
380                 $type = 'html';
381
382                 if ($conversation) {
383                         $root = $doc->createElementNS(ActivityNamespace::ATOM1, 'feed');
384                         $doc->appendChild($root);
385
386                         $root->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
387                         $root->setAttribute("xmlns:at", ActivityNamespace::TOMB);
388                         $root->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
389                         $root->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
390                         $root->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
391                         $root->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
392                         $root->setAttribute("xmlns:poco", ActivityNamespace::POCO);
393                         $root->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
394                         $root->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
395
396                         //$root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
397
398                         foreach ($items as $item) {
399                                 $entry = self::entry($doc, $type, $item, $owner, true, 0);
400                                 if (isset($entry)) {
401                                         $root->appendChild($entry);
402                                 }
403                         }
404                 } else {
405                         self::entry($doc, $type, $item, $owner, true, 0, true);
406                 }
407
408                 $atom = trim($doc->saveXML());
409                 return $atom;
410         }
411
412         /**
413          * Create XML text for DFRN mails
414          *
415          * @param array $item  message elements
416          * @param array $owner Owner record
417          *
418          * @return string DFRN mail
419          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
420          * @todo  Find proper type-hints
421          */
422         public static function mail($item, $owner)
423         {
424                 $doc = new DOMDocument('1.0', 'utf-8');
425                 $doc->formatOutput = true;
426
427                 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
428
429                 $mail = $doc->createElement("dfrn:mail");
430                 $sender = $doc->createElement("dfrn:sender");
431
432                 XML::addElement($doc, $sender, "dfrn:name", $owner['name']);
433                 XML::addElement($doc, $sender, "dfrn:uri", $owner['url']);
434                 XML::addElement($doc, $sender, "dfrn:avatar", $owner['thumb']);
435
436                 $mail->appendChild($sender);
437
438                 XML::addElement($doc, $mail, "dfrn:id", $item['uri']);
439                 XML::addElement($doc, $mail, "dfrn:in-reply-to", $item['parent-uri']);
440                 XML::addElement($doc, $mail, "dfrn:sentdate", DateTimeFormat::utc($item['created'] . '+00:00', DateTimeFormat::ATOM));
441                 XML::addElement($doc, $mail, "dfrn:subject", $item['title']);
442                 XML::addElement($doc, $mail, "dfrn:content", $item['body']);
443
444                 $root->appendChild($mail);
445
446                 return trim($doc->saveXML());
447         }
448
449         /**
450          * Create XML text for DFRN friend suggestions
451          *
452          * @param array $item  suggestion elements
453          * @param array $owner Owner record
454          *
455          * @return string DFRN suggestions
456          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
457          * @todo  Find proper type-hints
458          */
459         public static function fsuggest($item, $owner)
460         {
461                 $doc = new DOMDocument('1.0', 'utf-8');
462                 $doc->formatOutput = true;
463
464                 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
465
466                 $suggest = $doc->createElement("dfrn:suggest");
467
468                 XML::addElement($doc, $suggest, "dfrn:url", $item['url']);
469                 XML::addElement($doc, $suggest, "dfrn:name", $item['name']);
470                 XML::addElement($doc, $suggest, "dfrn:photo", $item['photo']);
471                 XML::addElement($doc, $suggest, "dfrn:request", $item['request']);
472                 XML::addElement($doc, $suggest, "dfrn:note", $item['note']);
473
474                 $root->appendChild($suggest);
475
476                 return trim($doc->saveXML());
477         }
478
479         /**
480          * Create XML text for DFRN relocations
481          *
482          * @param array $owner Owner record
483          * @param int   $uid   User ID
484          *
485          * @return string DFRN relocations
486          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
487          * @todo  Find proper type-hints
488          */
489         public static function relocate($owner, $uid)
490         {
491
492                 /* get site pubkey. this could be a new installation with no site keys*/
493                 $pubkey = DI::config()->get('system', 'site_pubkey');
494                 if (! $pubkey) {
495                         $res = Crypto::newKeypair(1024);
496                         DI::config()->set('system', 'site_prvkey', $res['prvkey']);
497                         DI::config()->set('system', 'site_pubkey', $res['pubkey']);
498                 }
499
500                 $rp = q(
501                         "SELECT `resource-id` , `scale`, type FROM `photo`
502                                 WHERE `profile` = 1 AND `uid` = %d ORDER BY scale;",
503                         $uid
504                 );
505                 $photos = [];
506                 $ext = Images::supportedTypes();
507
508                 foreach ($rp as $p) {
509                         $photos[$p['scale']] = DI::baseUrl().'/photo/'.$p['resource-id'].'-'.$p['scale'].'.'.$ext[$p['type']];
510                 }
511
512
513                 $doc = new DOMDocument('1.0', 'utf-8');
514                 $doc->formatOutput = true;
515
516                 $root = self::addHeader($doc, $owner, "dfrn:owner", "", false);
517
518                 $relocate = $doc->createElement("dfrn:relocate");
519
520                 XML::addElement($doc, $relocate, "dfrn:url", $owner['url']);
521                 XML::addElement($doc, $relocate, "dfrn:name", $owner['name']);
522                 XML::addElement($doc, $relocate, "dfrn:addr", $owner['addr']);
523                 XML::addElement($doc, $relocate, "dfrn:avatar", $owner['avatar']);
524                 XML::addElement($doc, $relocate, "dfrn:photo", $photos[4]);
525                 XML::addElement($doc, $relocate, "dfrn:thumb", $photos[5]);
526                 XML::addElement($doc, $relocate, "dfrn:micro", $photos[6]);
527                 XML::addElement($doc, $relocate, "dfrn:request", $owner['request']);
528                 XML::addElement($doc, $relocate, "dfrn:confirm", $owner['confirm']);
529                 XML::addElement($doc, $relocate, "dfrn:notify", $owner['notify']);
530                 XML::addElement($doc, $relocate, "dfrn:poll", $owner['poll']);
531                 XML::addElement($doc, $relocate, "dfrn:sitepubkey", DI::config()->get('system', 'site_pubkey'));
532
533                 $root->appendChild($relocate);
534
535                 return trim($doc->saveXML());
536         }
537
538         /**
539          * Adds the header elements for the DFRN protocol
540          *
541          * @param DOMDocument $doc           XML document
542          * @param array       $owner         Owner record
543          * @param string      $authorelement Element name for the author
544          * @param string      $alternatelink link to profile or category
545          * @param bool        $public        Is it a header for public posts?
546          *
547          * @return object XML root object
548          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
549          * @todo  Find proper type-hints
550          */
551         private static function addHeader(DOMDocument $doc, $owner, $authorelement, $alternatelink = "", $public = false)
552         {
553
554                 if ($alternatelink == "") {
555                         $alternatelink = $owner['url'];
556                 }
557
558                 $root = $doc->createElementNS(ActivityNamespace::ATOM1, 'feed');
559                 $doc->appendChild($root);
560
561                 $root->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
562                 $root->setAttribute("xmlns:at", ActivityNamespace::TOMB);
563                 $root->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
564                 $root->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
565                 $root->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
566                 $root->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
567                 $root->setAttribute("xmlns:poco", ActivityNamespace::POCO);
568                 $root->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
569                 $root->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
570
571                 XML::addElement($doc, $root, "id", DI::baseUrl()."/profile/".$owner["nick"]);
572                 XML::addElement($doc, $root, "title", $owner["name"]);
573
574                 $attributes = ["uri" => "https://friendi.ca", "version" => FRIENDICA_VERSION."-".DB_UPDATE_VERSION];
575                 XML::addElement($doc, $root, "generator", FRIENDICA_PLATFORM, $attributes);
576
577                 $attributes = ["rel" => "license", "href" => "http://creativecommons.org/licenses/by/3.0/"];
578                 XML::addElement($doc, $root, "link", "", $attributes);
579
580                 $attributes = ["rel" => "alternate", "type" => "text/html", "href" => $alternatelink];
581                 XML::addElement($doc, $root, "link", "", $attributes);
582
583
584                 if ($public) {
585                         // DFRN itself doesn't uses this. But maybe someone else wants to subscribe to the public feed.
586                         OStatus::hublinks($doc, $root, $owner["nick"]);
587
588                         $attributes = ["rel" => "salmon", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
589                         XML::addElement($doc, $root, "link", "", $attributes);
590
591                         $attributes = ["rel" => "http://salmon-protocol.org/ns/salmon-replies", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
592                         XML::addElement($doc, $root, "link", "", $attributes);
593
594                         $attributes = ["rel" => "http://salmon-protocol.org/ns/salmon-mention", "href" => DI::baseUrl()."/salmon/".$owner["nick"]];
595                         XML::addElement($doc, $root, "link", "", $attributes);
596                 }
597
598                 // For backward compatibility we keep this element
599                 if ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY) {
600                         XML::addElement($doc, $root, "dfrn:community", 1);
601                 }
602
603                 // The former element is replaced by this one
604                 XML::addElement($doc, $root, "dfrn:account_type", $owner["account-type"]);
605
606                 /// @todo We need a way to transmit the different page flags like "User::PAGE_FLAGS_PRVGROUP"
607
608                 XML::addElement($doc, $root, "updated", DateTimeFormat::utcNow(DateTimeFormat::ATOM));
609
610                 $author = self::addAuthor($doc, $owner, $authorelement, $public);
611                 $root->appendChild($author);
612
613                 return $root;
614         }
615
616         /**
617          * Adds the author element in the header for the DFRN protocol
618          *
619          * @param DOMDocument $doc           XML document
620          * @param array       $owner         Owner record
621          * @param string      $authorelement Element name for the author
622          * @param boolean     $public        boolean
623          *
624          * @return \DOMElement XML author object
625          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
626          * @todo  Find proper type-hints
627          */
628         private static function addAuthor(DOMDocument $doc, array $owner, $authorelement, $public)
629         {
630                 // Should the profile be "unsearchable" in the net? Then add the "hide" element
631                 $hide = DBA::exists('profile', ['uid' => $owner['uid'], 'net-publish' => false]);
632
633                 $author = $doc->createElement($authorelement);
634
635                 $namdate = DateTimeFormat::utc($owner['name-date'].'+00:00', DateTimeFormat::ATOM);
636                 $picdate = DateTimeFormat::utc($owner['avatar-date'].'+00:00', DateTimeFormat::ATOM);
637
638                 $attributes = [];
639
640                 if (!$public || !$hide) {
641                         $attributes = ["dfrn:updated" => $namdate];
642                 }
643
644                 XML::addElement($doc, $author, "name", $owner["name"], $attributes);
645                 XML::addElement($doc, $author, "uri", DI::baseUrl().'/profile/'.$owner["nickname"], $attributes);
646                 XML::addElement($doc, $author, "dfrn:handle", $owner["addr"], $attributes);
647
648                 $attributes = ["rel" => "photo", "type" => "image/jpeg",
649                                         "media:width" => 300, "media:height" => 300, "href" => $owner['photo']];
650
651                 if (!$public || !$hide) {
652                         $attributes["dfrn:updated"] = $picdate;
653                 }
654
655                 XML::addElement($doc, $author, "link", "", $attributes);
656
657                 $attributes["rel"] = "avatar";
658                 XML::addElement($doc, $author, "link", "", $attributes);
659
660                 if ($hide) {
661                         XML::addElement($doc, $author, "dfrn:hide", "true");
662                 }
663
664                 // The following fields will only be generated if the data isn't meant for a public feed
665                 if ($public) {
666                         return $author;
667                 }
668
669                 $birthday = feed_birthday($owner['uid'], $owner['timezone']);
670
671                 if ($birthday) {
672                         XML::addElement($doc, $author, "dfrn:birthday", $birthday);
673                 }
674
675                 // Only show contact details when we are allowed to
676                 $profile = DBA::selectFirst('owner-view',
677                         ['about', 'name', 'homepage', 'nickname', 'timezone', 'locality', 'region', 'country-name', 'pub_keywords', 'xmpp', 'dob'],
678                         ['uid' => $owner['uid'], 'hidewall' => false]);
679                 if (DBA::isResult($profile)) {
680                         XML::addElement($doc, $author, "poco:displayName", $profile["name"]);
681                         XML::addElement($doc, $author, "poco:updated", $namdate);
682
683                         if (trim($profile["dob"]) > DBA::NULL_DATE) {
684                                 XML::addElement($doc, $author, "poco:birthday", "0000-".date("m-d", strtotime($profile["dob"])));
685                         }
686
687                         XML::addElement($doc, $author, "poco:note", $profile["about"]);
688                         XML::addElement($doc, $author, "poco:preferredUsername", $profile["nickname"]);
689
690                         $savetz = date_default_timezone_get();
691                         date_default_timezone_set($profile["timezone"]);
692                         XML::addElement($doc, $author, "poco:utcOffset", date("P"));
693                         date_default_timezone_set($savetz);
694
695                         if (trim($profile["homepage"]) != "") {
696                                 $urls = $doc->createElement("poco:urls");
697                                 XML::addElement($doc, $urls, "poco:type", "homepage");
698                                 XML::addElement($doc, $urls, "poco:value", $profile["homepage"]);
699                                 XML::addElement($doc, $urls, "poco:primary", "true");
700                                 $author->appendChild($urls);
701                         }
702
703                         if (trim($profile["pub_keywords"]) != "") {
704                                 $keywords = explode(",", $profile["pub_keywords"]);
705
706                                 foreach ($keywords as $keyword) {
707                                         XML::addElement($doc, $author, "poco:tags", trim($keyword));
708                                 }
709                         }
710
711                         if (trim($profile["xmpp"]) != "") {
712                                 $ims = $doc->createElement("poco:ims");
713                                 XML::addElement($doc, $ims, "poco:type", "xmpp");
714                                 XML::addElement($doc, $ims, "poco:value", $profile["xmpp"]);
715                                 XML::addElement($doc, $ims, "poco:primary", "true");
716                                 $author->appendChild($ims);
717                         }
718
719                         if (trim($profile["locality"].$profile["region"].$profile["country-name"]) != "") {
720                                 $element = $doc->createElement("poco:address");
721
722                                 XML::addElement($doc, $element, "poco:formatted", Profile::formatLocation($profile));
723
724                                 if (trim($profile["locality"]) != "") {
725                                         XML::addElement($doc, $element, "poco:locality", $profile["locality"]);
726                                 }
727
728                                 if (trim($profile["region"]) != "") {
729                                         XML::addElement($doc, $element, "poco:region", $profile["region"]);
730                                 }
731
732                                 if (trim($profile["country-name"]) != "") {
733                                         XML::addElement($doc, $element, "poco:country", $profile["country-name"]);
734                                 }
735
736                                 $author->appendChild($element);
737                         }
738                 }
739
740                 return $author;
741         }
742
743         /**
744          * Adds the author elements in the "entry" elements of the DFRN protocol
745          *
746          * @param DOMDocument $doc         XML document
747          * @param string $element     Element name for the author
748          * @param string $contact_url Link of the contact
749          * @param array  $item        Item elements
750          *
751          * @return \DOMElement XML author object
752          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
753          * @todo  Find proper type-hints
754          */
755         private static function addEntryAuthor(DOMDocument $doc, $element, $contact_url, $item)
756         {
757                 $author = $doc->createElement($element);
758
759                 $contact = Contact::getByURLForUser($contact_url, $item["uid"], false, ['url', 'name', 'addr', 'photo']);
760                 if (!empty($contact)) {
761                         XML::addElement($doc, $author, "name", $contact["name"]);
762                         XML::addElement($doc, $author, "uri", $contact["url"]);
763                         XML::addElement($doc, $author, "dfrn:handle", $contact["addr"]);
764
765                         /// @Todo
766                         /// - Check real image type and image size
767                         /// - Check which of these boths elements we should use
768                         $attributes = [
769                                 "rel" => "photo",
770                                 "type" => "image/jpeg",
771                                 "media:width" => 80,
772                                 "media:height" => 80,
773                                 "href" => $contact["photo"]];
774                         XML::addElement($doc, $author, "link", "", $attributes);
775
776                         $attributes = [
777                                 "rel" => "avatar",
778                                 "type" => "image/jpeg",
779                                 "media:width" => 80,
780                                 "media:height" => 80,
781                                 "href" => $contact["photo"]];
782                         XML::addElement($doc, $author, "link", "", $attributes);
783                 }
784
785                 return $author;
786         }
787
788         /**
789          * Adds the activity elements
790          *
791          * @param DOMDocument $doc      XML document
792          * @param string      $element  Element name for the activity
793          * @param string      $activity activity value
794          *
795          * @return \DOMElement XML activity object
796          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
797          * @todo  Find proper type-hints
798          */
799         private static function createActivity(DOMDocument $doc, $element, $activity)
800         {
801                 if ($activity) {
802                         $entry = $doc->createElement($element);
803
804                         $r = XML::parseString($activity);
805                         if (!$r) {
806                                 return false;
807                         }
808
809                         if ($r->type) {
810                                 XML::addElement($doc, $entry, "activity:object-type", $r->type);
811                         }
812
813                         if ($r->id) {
814                                 XML::addElement($doc, $entry, "id", $r->id);
815                         }
816
817                         if ($r->title) {
818                                 XML::addElement($doc, $entry, "title", $r->title);
819                         }
820
821                         if ($r->link) {
822                                 if (substr($r->link, 0, 1) == '<') {
823                                         if (strstr($r->link, '&') && (! strstr($r->link, '&amp;'))) {
824                                                 $r->link = str_replace('&', '&amp;', $r->link);
825                                         }
826
827                                         $r->link = preg_replace('/\<link(.*?)\"\>/', '<link$1"/>', $r->link);
828
829                                         // XML does need a single element as root element so we add a dummy element here
830                                         $data = XML::parseString("<dummy>" . $r->link . "</dummy>");
831                                         if (is_object($data)) {
832                                                 foreach ($data->link as $link) {
833                                                         $attributes = [];
834                                                         foreach ($link->attributes() as $parameter => $value) {
835                                                                 $attributes[$parameter] = $value;
836                                                         }
837                                                         XML::addElement($doc, $entry, "link", "", $attributes);
838                                                 }
839                                         }
840                                 } else {
841                                         $attributes = ["rel" => "alternate", "type" => "text/html", "href" => $r->link];
842                                         XML::addElement($doc, $entry, "link", "", $attributes);
843                                 }
844                         }
845                         if ($r->content) {
846                                 XML::addElement($doc, $entry, "content", BBCode::convert($r->content), ["type" => "html"]);
847                         }
848
849                         return $entry;
850                 }
851
852                 return false;
853         }
854
855         /**
856          * Adds the elements for attachments
857          *
858          * @param object $doc  XML document
859          * @param object $root XML root
860          * @param array  $item Item element
861          *
862          * @return void XML attachment object
863          * @todo  Find proper type-hints
864          */
865         private static function getAttachment($doc, $root, $item)
866         {
867                 $arr = explode('[/attach],', $item['attach']);
868                 if (count($arr)) {
869                         foreach ($arr as $r) {
870                                 $matches = false;
871                                 $cnt = preg_match('|\[attach\]href=\"(.*?)\" length=\"(.*?)\" type=\"(.*?)\" title=\"(.*?)\"|', $r, $matches);
872                                 if ($cnt) {
873                                         $attributes = ["rel" => "enclosure",
874                                                         "href" => $matches[1],
875                                                         "type" => $matches[3]];
876
877                                         if (intval($matches[2])) {
878                                                 $attributes["length"] = intval($matches[2]);
879                                         }
880
881                                         if (trim($matches[4]) != "") {
882                                                 $attributes["title"] = trim($matches[4]);
883                                         }
884
885                                         XML::addElement($doc, $root, "link", "", $attributes);
886                                 }
887                         }
888                 }
889         }
890
891         /**
892          * Adds the "entry" elements for the DFRN protocol
893          *
894          * @param DOMDocument $doc     XML document
895          * @param string      $type    "text" or "html"
896          * @param array       $item    Item element
897          * @param array       $owner   Owner record
898          * @param bool        $comment Trigger the sending of the "comment" element
899          * @param int         $cid     Contact ID of the recipient
900          * @param bool        $single  If set, the entry is created as an XML document with a single "entry" element
901          *
902          * @return null|\DOMElement XML entry object
903          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
904          * @throws \ImagickException
905          * @todo  Find proper type-hints
906          */
907         private static function entry(DOMDocument $doc, $type, array $item, array $owner, $comment = false, $cid = 0, $single = false)
908         {
909                 $mentioned = [];
910
911                 if (!$item['parent']) {
912                         Logger::notice('Item without parent found.', ['type' => $type, 'item' => $item]);
913                         return null;
914                 }
915
916                 if ($item['deleted']) {
917                         $attributes = ["ref" => $item['uri'], "when" => DateTimeFormat::utc($item['edited'] . '+00:00', DateTimeFormat::ATOM)];
918                         return XML::createElement($doc, "at:deleted-entry", "", $attributes);
919                 }
920
921                 if (!$single) {
922                         $entry = $doc->createElement("entry");
923                 } else {
924                         $entry = $doc->createElementNS(ActivityNamespace::ATOM1, 'entry');
925                         $doc->appendChild($entry);
926
927                         $entry->setAttribute("xmlns:thr", ActivityNamespace::THREAD);
928                         $entry->setAttribute("xmlns:at", ActivityNamespace::TOMB);
929                         $entry->setAttribute("xmlns:media", ActivityNamespace::MEDIA);
930                         $entry->setAttribute("xmlns:dfrn", ActivityNamespace::DFRN);
931                         $entry->setAttribute("xmlns:activity", ActivityNamespace::ACTIVITY);
932                         $entry->setAttribute("xmlns:georss", ActivityNamespace::GEORSS);
933                         $entry->setAttribute("xmlns:poco", ActivityNamespace::POCO);
934                         $entry->setAttribute("xmlns:ostatus", ActivityNamespace::OSTATUS);
935                         $entry->setAttribute("xmlns:statusnet", ActivityNamespace::STATUSNET);
936                 }
937
938                 if ($item['private'] == Item::PRIVATE) {
939                         $body = Item::fixPrivatePhotos($item['body'], $owner['uid'], $item, $cid);
940                 } else {
941                         $body = $item['body'];
942                 }
943
944                 // Remove the abstract element. It is only locally important.
945                 $body = BBCode::stripAbstract($body);
946
947                 $htmlbody = '';
948                 if ($type == 'html') {
949                         $htmlbody = $body;
950
951                         if ($item['title'] != "") {
952                                 $htmlbody = "[b]" . $item['title'] . "[/b]\n\n" . $htmlbody;
953                         }
954
955                         $htmlbody = BBCode::convert($htmlbody, false, BBCode::OSTATUS);
956                 }
957
958                 $author = self::addEntryAuthor($doc, "author", $item["author-link"], $item);
959                 $entry->appendChild($author);
960
961                 $dfrnowner = self::addEntryAuthor($doc, "dfrn:owner", $item["owner-link"], $item);
962                 $entry->appendChild($dfrnowner);
963
964                 if ($item['gravity'] != GRAVITY_PARENT) {
965                         $parent_item = (($item['thr-parent']) ? $item['thr-parent'] : $item['parent-uri']);
966                         $parent = Item::selectFirst(['guid', 'plink'], ['uri' => $parent_item, 'uid' => $item['uid']]);
967                         $attributes = ["ref" => $parent_item, "type" => "text/html",
968                                                 "href" => $parent['plink'],
969                                                 "dfrn:diaspora_guid" => $parent['guid']];
970                         XML::addElement($doc, $entry, "thr:in-reply-to", "", $attributes);
971                 }
972
973                 // Add conversation data. This is used for OStatus
974                 $conversation_href = DI::baseUrl()."/display/".$item["parent-guid"];
975                 $conversation_uri = $conversation_href;
976
977                 if (isset($parent_item)) {
978                         $conversation = DBA::selectFirst('conversation', ['conversation-uri', 'conversation-href'], ['item-uri' => $item['parent-uri']]);
979                         if (DBA::isResult($conversation)) {
980                                 if ($conversation['conversation-uri'] != '') {
981                                         $conversation_uri = $conversation['conversation-uri'];
982                                 }
983                                 if ($conversation['conversation-href'] != '') {
984                                         $conversation_href = $conversation['conversation-href'];
985                                 }
986                         }
987                 }
988
989                 $attributes = [
990                                 "href" => $conversation_href,
991                                 "ref" => $conversation_uri];
992
993                 XML::addElement($doc, $entry, "ostatus:conversation", $conversation_uri, $attributes);
994
995                 XML::addElement($doc, $entry, "id", $item["uri"]);
996                 XML::addElement($doc, $entry, "title", $item["title"]);
997
998                 XML::addElement($doc, $entry, "published", DateTimeFormat::utc($item["created"] . "+00:00", DateTimeFormat::ATOM));
999                 XML::addElement($doc, $entry, "updated", DateTimeFormat::utc($item["edited"] . "+00:00", DateTimeFormat::ATOM));
1000
1001                 // "dfrn:env" is used to read the content
1002                 XML::addElement($doc, $entry, "dfrn:env", Strings::base64UrlEncode($body, true));
1003
1004                 // The "content" field is not read by the receiver. We could remove it when the type is "text"
1005                 // We keep it at the moment, maybe there is some old version that doesn't read "dfrn:env"
1006                 XML::addElement($doc, $entry, "content", (($type == 'html') ? $htmlbody : $body), ["type" => $type]);
1007
1008                 // We save this value in "plink". Maybe we should read it from there as well?
1009                 XML::addElement(
1010                         $doc,
1011                         $entry,
1012                         "link",
1013                         "",
1014                         ["rel" => "alternate", "type" => "text/html",
1015                                  "href" => DI::baseUrl() . "/display/" . $item["guid"]]
1016                 );
1017
1018                 // "comment-allow" is some old fashioned stuff for old Friendica versions.
1019                 // It is included in the rewritten code for completeness
1020                 if ($comment) {
1021                         XML::addElement($doc, $entry, "dfrn:comment-allow", 1);
1022                 }
1023
1024                 if ($item['location']) {
1025                         XML::addElement($doc, $entry, "dfrn:location", $item['location']);
1026                 }
1027
1028                 if ($item['coord']) {
1029                         XML::addElement($doc, $entry, "georss:point", $item['coord']);
1030                 }
1031
1032                 if ($item['private']) {
1033                         // Friendica versions prior to 2020.3 can't handle "unlisted" properly. So we can only transmit public and private
1034                         XML::addElement($doc, $entry, "dfrn:private", ($item['private'] == Item::PRIVATE ? Item::PRIVATE : Item::PUBLIC));
1035                         XML::addElement($doc, $entry, "dfrn:unlisted", $item['private'] == Item::UNLISTED);
1036                 }
1037
1038                 if ($item['extid']) {
1039                         XML::addElement($doc, $entry, "dfrn:extid", $item['extid']);
1040                 }
1041
1042                 if ($item['post-type'] == Item::PT_PAGE) {
1043                         XML::addElement($doc, $entry, "dfrn:bookmark", "true");
1044                 }
1045
1046                 if ($item['app']) {
1047                         XML::addElement($doc, $entry, "statusnet:notice_info", "", ["local_id" => $item['id'], "source" => $item['app']]);
1048                 }
1049
1050                 XML::addElement($doc, $entry, "dfrn:diaspora_guid", $item["guid"]);
1051
1052                 // The signed text contains the content in Markdown, the sender handle and the signatur for the content
1053                 // It is needed for relayed comments to Diaspora.
1054                 if ($item['signed_text']) {
1055                         $sign = base64_encode(json_encode(['signed_text' => $item['signed_text'],'signature' => '','signer' => '']));
1056                         XML::addElement($doc, $entry, "dfrn:diaspora_signature", $sign);
1057                 }
1058
1059                 XML::addElement($doc, $entry, "activity:verb", self::constructVerb($item));
1060
1061                 if ($item['object-type'] != "") {
1062                         XML::addElement($doc, $entry, "activity:object-type", $item['object-type']);
1063                 } elseif ($item['gravity'] == GRAVITY_PARENT) {
1064                         XML::addElement($doc, $entry, "activity:object-type", Activity\ObjectType::NOTE);
1065                 } else {
1066                         XML::addElement($doc, $entry, "activity:object-type", Activity\ObjectType::COMMENT);
1067                 }
1068
1069                 $actobj = self::createActivity($doc, "activity:object", $item['object']);
1070                 if ($actobj) {
1071                         $entry->appendChild($actobj);
1072                 }
1073
1074                 $actarg = self::createActivity($doc, "activity:target", $item['target']);
1075                 if ($actarg) {
1076                         $entry->appendChild($actarg);
1077                 }
1078
1079                 $tags = Tag::getByURIId($item['uri-id']);
1080
1081                 if (count($tags)) {
1082                         foreach ($tags as $tag) {
1083                                 if (($type != 'html') || ($tag['type'] == Tag::HASHTAG)) {
1084                                         XML::addElement($doc, $entry, "category", "", ["scheme" => "X-DFRN:" . Tag::TAG_CHARACTER[$tag['type']] . ":" . $tag['url'], "term" => $tag['name']]);
1085                                 }
1086                                 if ($tag['type'] != Tag::HASHTAG) {
1087                                         $mentioned[$tag['url']] = $tag['url'];
1088                                 }
1089                         }
1090                 }
1091
1092                 foreach ($mentioned as $mention) {
1093                         $condition = ['uid' => $owner["uid"], 'nurl' => Strings::normaliseLink($mention)];
1094                         $contact = DBA::selectFirst('contact', ['forum', 'prv'], $condition);
1095
1096                         if (DBA::isResult($contact) && ($contact["forum"] || $contact["prv"])) {
1097                                 XML::addElement(
1098                                         $doc,
1099                                         $entry,
1100                                         "link",
1101                                         "",
1102                                         ["rel" => "mentioned",
1103                                                         "ostatus:object-type" => Activity\ObjectType::GROUP,
1104                                                         "href" => $mention]
1105                                 );
1106                         } else {
1107                                 XML::addElement(
1108                                         $doc,
1109                                         $entry,
1110                                         "link",
1111                                         "",
1112                                         ["rel" => "mentioned",
1113                                                         "ostatus:object-type" => Activity\ObjectType::PERSON,
1114                                                         "href" => $mention]
1115                                 );
1116                         }
1117                 }
1118
1119                 self::getAttachment($doc, $entry, $item);
1120
1121                 return $entry;
1122         }
1123
1124         /**
1125          * encrypts data via AES
1126          *
1127          * @param string $data The data that is to be encrypted
1128          * @param string $key  The AES key
1129          *
1130          * @return string encrypted data
1131          */
1132         private static function aesEncrypt($data, $key)
1133         {
1134                 return openssl_encrypt($data, 'aes-128-ecb', $key, OPENSSL_RAW_DATA);
1135         }
1136
1137         /**
1138          * decrypts data via AES
1139          *
1140          * @param string $encrypted The encrypted data
1141          * @param string $key       The AES key
1142          *
1143          * @return string decrypted data
1144          */
1145         public static function aesDecrypt($encrypted, $key)
1146         {
1147                 return openssl_decrypt($encrypted, 'aes-128-ecb', $key, OPENSSL_RAW_DATA);
1148         }
1149
1150         /**
1151          * Delivers the atom content to the contacts
1152          *
1153          * @param array  $owner    Owner record
1154          * @param array  $contact  Contact record of the receiver
1155          * @param string $atom     Content that will be transmitted
1156          * @param bool   $dissolve (to be documented)
1157          *
1158          * @return int Deliver status. Negative values mean an error.
1159          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1160          * @throws \ImagickException
1161          * @todo  Add array type-hint for $owner, $contact
1162          */
1163         public static function deliver($owner, $contact, $atom, $dissolve = false)
1164         {
1165                 $idtosend = $orig_id = (($contact['dfrn-id']) ? $contact['dfrn-id'] : $contact['issued-id']);
1166
1167                 if ($contact['duplex'] && $contact['dfrn-id']) {
1168                         $idtosend = '0:' . $orig_id;
1169                 }
1170                 if ($contact['duplex'] && $contact['issued-id']) {
1171                         $idtosend = '1:' . $orig_id;
1172                 }
1173
1174                 $rino = DI::config()->get('system', 'rino_encrypt');
1175                 $rino = intval($rino);
1176
1177                 Logger::log("Local rino version: ". $rino, Logger::DEBUG);
1178
1179                 $ssl_val = intval(DI::config()->get('system', 'ssl_policy'));
1180
1181                 switch ($ssl_val) {
1182                         case BaseURL::SSL_POLICY_FULL:
1183                                 $ssl_policy = 'full';
1184                                 break;
1185                         case BaseURL::SSL_POLICY_SELFSIGN:
1186                                 $ssl_policy = 'self';
1187                                 break;
1188                         case BaseURL::SSL_POLICY_NONE:
1189                         default:
1190                                 $ssl_policy = 'none';
1191                                 break;
1192                 }
1193
1194                 $url = $contact['notify'] . '&dfrn_id=' . $idtosend . '&dfrn_version=' . DFRN_PROTOCOL_VERSION . (($rino) ? '&rino='.$rino : '');
1195
1196                 Logger::log('dfrn_deliver: ' . $url);
1197
1198                 $curlResult = DI::httpRequest()->curl($url);
1199
1200                 if ($curlResult->isTimeout()) {
1201                         return -2; // timed out
1202                 }
1203
1204                 $xml = $curlResult->getBody();
1205
1206                 $curl_stat = $curlResult->getReturnCode();
1207                 if (empty($curl_stat)) {
1208                         return -3; // timed out
1209                 }
1210
1211                 Logger::log('dfrn_deliver: ' . $xml, Logger::DATA);
1212
1213                 if (empty($xml)) {
1214                         return 3;
1215                 }
1216
1217                 if (strpos($xml, '<?xml') === false) {
1218                         Logger::log('dfrn_deliver: no valid XML returned');
1219                         Logger::log('dfrn_deliver: returned XML: ' . $xml, Logger::DATA);
1220                         return 3;
1221                 }
1222
1223                 $res = XML::parseString($xml);
1224
1225                 if (!is_object($res) || (intval($res->status) != 0) || !strlen($res->challenge) || !strlen($res->dfrn_id)) {
1226                         if (empty($res->status)) {
1227                                 $status = 3;
1228                         } else {
1229                                 $status = $res->status;
1230                         }
1231
1232                         return $status;
1233                 }
1234
1235                 $postvars     = [];
1236                 $sent_dfrn_id = hex2bin((string) $res->dfrn_id);
1237                 $challenge    = hex2bin((string) $res->challenge);
1238                 $perm         = (($res->perm) ? $res->perm : null);
1239                 $dfrn_version = floatval($res->dfrn_version ?: 2.0);
1240                 $rino_remote_version = intval($res->rino);
1241                 $page         = (($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY) ? 1 : 0);
1242
1243                 Logger::log("Remote rino version: ".$rino_remote_version." for ".$contact["url"], Logger::DEBUG);
1244
1245                 if ($owner['page-flags'] == User::PAGE_FLAGS_PRVGROUP) {
1246                         $page = 2;
1247                 }
1248
1249                 $final_dfrn_id = '';
1250
1251                 if ($perm) {
1252                         if ((($perm == 'rw') && !intval($contact['writable']))
1253                                 || (($perm == 'r') && intval($contact['writable']))
1254                         ) {
1255                                 DBA::update('contact', ['writable' => ($perm == 'rw')], ['id' => $contact['id']]);
1256
1257                                 $contact['writable'] = (string) 1 - intval($contact['writable']);
1258                         }
1259                 }
1260
1261                 if (($contact['duplex'] && strlen($contact['pubkey']))
1262                         || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY && strlen($contact['pubkey']))
1263                         || ($contact['rel'] == Contact::SHARING && strlen($contact['pubkey']))
1264                 ) {
1265                         openssl_public_decrypt($sent_dfrn_id, $final_dfrn_id, $contact['pubkey']);
1266                         openssl_public_decrypt($challenge, $postvars['challenge'], $contact['pubkey']);
1267                 } else {
1268                         openssl_private_decrypt($sent_dfrn_id, $final_dfrn_id, $contact['prvkey']);
1269                         openssl_private_decrypt($challenge, $postvars['challenge'], $contact['prvkey']);
1270                 }
1271
1272                 $final_dfrn_id = substr($final_dfrn_id, 0, strpos($final_dfrn_id, '.'));
1273
1274                 if (strpos($final_dfrn_id, ':') == 1) {
1275                         $final_dfrn_id = substr($final_dfrn_id, 2);
1276                 }
1277
1278                 if ($final_dfrn_id != $orig_id) {
1279                         Logger::log('dfrn_deliver: wrong dfrn_id.');
1280                         // did not decode properly - cannot trust this site
1281                         return 3;
1282                 }
1283
1284                 $postvars['dfrn_id']      = $idtosend;
1285                 $postvars['dfrn_version'] = DFRN_PROTOCOL_VERSION;
1286                 if ($dissolve) {
1287                         $postvars['dissolve'] = '1';
1288                 }
1289
1290                 if ((($contact['rel']) && ($contact['rel'] != Contact::SHARING) && (! $contact['blocked'])) || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY)) {
1291                         $postvars['data'] = $atom;
1292                         $postvars['perm'] = 'rw';
1293                 } else {
1294                         $postvars['data'] = str_replace('<dfrn:comment-allow>1', '<dfrn:comment-allow>0', $atom);
1295                         $postvars['perm'] = 'r';
1296                 }
1297
1298                 $postvars['ssl_policy'] = $ssl_policy;
1299
1300                 if ($page) {
1301                         $postvars['page'] = $page;
1302                 }
1303
1304
1305                 if ($rino > 0 && $rino_remote_version > 0 && (! $dissolve)) {
1306                         Logger::log('rino version: '. $rino_remote_version);
1307
1308                         switch ($rino_remote_version) {
1309                                 case 1:
1310                                         $key = openssl_random_pseudo_bytes(16);
1311                                         $data = self::aesEncrypt($postvars['data'], $key);
1312                                         break;
1313
1314                                 default:
1315                                         Logger::log("rino: invalid requested version '$rino_remote_version'");
1316                                         return -8;
1317                         }
1318
1319                         $postvars['rino'] = $rino_remote_version;
1320                         $postvars['data'] = bin2hex($data);
1321
1322                         if ($dfrn_version >= 2.1) {
1323                                 if (($contact['duplex'] && strlen($contact['pubkey']))
1324                                         || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY && strlen($contact['pubkey']))
1325                                         || ($contact['rel'] == Contact::SHARING && strlen($contact['pubkey']))
1326                                 ) {
1327                                         openssl_public_encrypt($key, $postvars['key'], $contact['pubkey']);
1328                                 } else {
1329                                         openssl_private_encrypt($key, $postvars['key'], $contact['prvkey']);
1330                                 }
1331                         } else {
1332                                 if (($contact['duplex'] && strlen($contact['prvkey'])) || ($owner['page-flags'] == User::PAGE_FLAGS_COMMUNITY)) {
1333                                         openssl_private_encrypt($key, $postvars['key'], $contact['prvkey']);
1334                                 } else {
1335                                         openssl_public_encrypt($key, $postvars['key'], $contact['pubkey']);
1336                                 }
1337                         }
1338
1339                         Logger::log('md5 rawkey ' . md5($postvars['key']));
1340
1341                         $postvars['key'] = bin2hex($postvars['key']);
1342                 }
1343
1344
1345                 Logger::debug('dfrn_deliver', ['post' => $postvars]);
1346
1347                 $postResult = HTTPRequest::post($contact['notify'], $postvars);
1348
1349                 $xml = $postResult->getBody();
1350
1351                 Logger::log('dfrn_deliver: ' . "RECEIVED: " . $xml, Logger::DATA);
1352
1353                 $curl_stat = $postResult->getReturnCode();
1354                 if (empty($curl_stat) || empty($xml)) {
1355                         return -9; // timed out
1356                 }
1357
1358                 if (($curl_stat == 503) && stristr($postResult->getHeader(), 'retry-after')) {
1359                         return -10;
1360                 }
1361
1362                 if (strpos($xml, '<?xml') === false) {
1363                         Logger::log('dfrn_deliver: phase 2: no valid XML returned');
1364                         Logger::log('dfrn_deliver: phase 2: returned XML: ' . $xml, Logger::DATA);
1365                         return 3;
1366                 }
1367
1368                 $res = XML::parseString($xml);
1369
1370                 if (!isset($res->status)) {
1371                         return -11;
1372                 }
1373
1374                 // Possibly old servers had returned an empty value when everything was okay
1375                 if (empty($res->status)) {
1376                         $res->status = 200;
1377                 }
1378
1379                 if (!empty($res->message)) {
1380                         Logger::log('Delivery returned status '.$res->status.' - '.$res->message, Logger::DEBUG);
1381                 }
1382
1383                 return intval($res->status);
1384         }
1385
1386         /**
1387          * Transmits atom content to the contacts via the Diaspora transport layer
1388          *
1389          * @param array  $owner   Owner record
1390          * @param array  $contact Contact record of the receiver
1391          * @param string $atom    Content that will be transmitted
1392          *
1393          * @param bool   $public_batch
1394          * @return int Deliver status. Negative values mean an error.
1395          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1396          * @throws \ImagickException
1397          */
1398         public static function transmit($owner, $contact, $atom, $public_batch = false)
1399         {
1400                 if (!$public_batch) {
1401                         if (empty($contact['addr'])) {
1402                                 Logger::log('Empty contact handle for ' . $contact['id'] . ' - ' . $contact['url'] . ' - trying to update it.');
1403                                 if (Contact::updateFromProbe($contact['id'])) {
1404                                         $new_contact = DBA::selectFirst('contact', ['addr'], ['id' => $contact['id']]);
1405                                         $contact['addr'] = $new_contact['addr'];
1406                                 }
1407
1408                                 if (empty($contact['addr'])) {
1409                                         Logger::log('Unable to find contact handle for ' . $contact['id'] . ' - ' . $contact['url']);
1410                                         return -21;
1411                                 }
1412                         }
1413
1414                         $fcontact = Diaspora::personByHandle($contact['addr']);
1415                         if (empty($fcontact)) {
1416                                 Logger::log('Unable to find contact details for ' . $contact['id'] . ' - ' . $contact['addr']);
1417                                 return -22;
1418                         }
1419                         $pubkey = $fcontact['pubkey'];
1420                 } else {
1421                         $pubkey = '';
1422                 }
1423
1424                 $envelope = Diaspora::buildMessage($atom, $owner, $contact, $owner['uprvkey'], $pubkey, $public_batch);
1425
1426                 // Create the endpoint for public posts. This is some WIP and should later be added to the probing
1427                 if ($public_batch && empty($contact["batch"])) {
1428                         $parts = parse_url($contact["notify"]);
1429                         $path_parts = explode('/', $parts['path']);
1430                         array_pop($path_parts);
1431                         $parts['path'] =  implode('/', $path_parts);
1432                         $contact["batch"] = Network::unparseURL($parts);
1433                 }
1434
1435                 $dest_url = ($public_batch ? $contact["batch"] : $contact["notify"]);
1436
1437                 if (empty($dest_url)) {
1438                         Logger::info('Empty destination', ['public' => $public_batch, 'contact' => $contact]);
1439                         return -24;
1440                 }
1441
1442                 $content_type = ($public_batch ? "application/magic-envelope+xml" : "application/json");
1443
1444                 $postResult = HTTPRequest::post($dest_url, $envelope, ["Content-Type: " . $content_type]);
1445                 $xml = $postResult->getBody();
1446
1447                 $curl_stat = $postResult->getReturnCode();
1448                 if (empty($curl_stat) || empty($xml)) {
1449                         Logger::log('Empty answer from ' . $contact['id'] . ' - ' . $dest_url);
1450                         return -9; // timed out
1451                 }
1452
1453                 if (($curl_stat == 503) && (stristr($postResult->getHeader(), 'retry-after'))) {
1454                         return -10;
1455                 }
1456
1457                 if (strpos($xml, '<?xml') === false) {
1458                         Logger::log('No valid XML returned from ' . $contact['id'] . ' - ' . $dest_url);
1459                         Logger::log('Returned XML: ' . $xml, Logger::DATA);
1460                         return 3;
1461                 }
1462
1463                 $res = XML::parseString($xml);
1464
1465                 if (empty($res->status)) {
1466                         return -23;
1467                 }
1468
1469                 if (!empty($res->message)) {
1470                         Logger::log('Transmit to ' . $dest_url . ' returned status '.$res->status.' - '.$res->message, Logger::DEBUG);
1471                 }
1472
1473                 return intval($res->status);
1474         }
1475
1476         /**
1477          * Fetch the author data from head or entry items
1478          *
1479          * @param object $xpath     XPath object
1480          * @param object $context   In which context should the data be searched
1481          * @param array  $importer  Record of the importer user mixed with contact of the content
1482          * @param string $element   Element name from which the data is fetched
1483          * @param bool   $onlyfetch Should the data only be fetched or should it update the contact record as well
1484          * @param string $xml       optional, default empty
1485          *
1486          * @return array Relevant data of the author
1487          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1488          * @throws \ImagickException
1489          * @todo  Find good type-hints for all parameter
1490          */
1491         private static function fetchauthor($xpath, $context, $importer, $element, $onlyfetch, $xml = "")
1492         {
1493                 $author = [];
1494                 $author["name"] = XML::getFirstNodeValue($xpath, $element."/atom:name/text()", $context);
1495                 $author["link"] = XML::getFirstNodeValue($xpath, $element."/atom:uri/text()", $context);
1496
1497                 $fields = ['id', 'uid', 'url', 'network', 'avatar-date', 'avatar', 'name-date', 'uri-date', 'addr',
1498                         'name', 'nick', 'about', 'location', 'keywords', 'xmpp', 'bdyear', 'bd', 'hidden', 'contact-type'];
1499                 $condition = ["`uid` = ? AND `nurl` = ? AND `network` != ?",
1500                         $importer["importer_uid"], Strings::normaliseLink($author["link"]), Protocol::STATUSNET];
1501                 $contact_old = DBA::selectFirst('contact', $fields, $condition);
1502
1503                 if (DBA::isResult($contact_old)) {
1504                         $author["contact-id"] = $contact_old["id"];
1505                         $author["network"] = $contact_old["network"];
1506                 } else {
1507                         if (!$onlyfetch) {
1508                                 Logger::debug("Contact ".$author["link"]." wasn't found for user ".$importer["importer_uid"]." XML: ".$xml);
1509                         }
1510
1511                         $author["contact-unknown"] = true;
1512                         $author["contact-id"] = $importer["id"];
1513                         $author["network"] = $importer["network"];
1514                         $onlyfetch = true;
1515                 }
1516
1517                 // Until now we aren't serving different sizes - but maybe later
1518                 $avatarlist = [];
1519                 /// @todo check if "avatar" or "photo" would be the best field in the specification
1520                 $avatars = $xpath->query($element . "/atom:link[@rel='avatar']", $context);
1521                 foreach ($avatars as $avatar) {
1522                         $href = "";
1523                         $width = 0;
1524                         foreach ($avatar->attributes as $attributes) {
1525                                 /// @TODO Rewrite these similar if() to one switch
1526                                 if ($attributes->name == "href") {
1527                                         $href = $attributes->textContent;
1528                                 }
1529                                 if ($attributes->name == "width") {
1530                                         $width = $attributes->textContent;
1531                                 }
1532                                 if ($attributes->name == "updated") {
1533                                         $author["avatar-date"] = $attributes->textContent;
1534                                 }
1535                         }
1536                         if (($width > 0) && ($href != "")) {
1537                                 $avatarlist[$width] = $href;
1538                         }
1539                 }
1540
1541                 if (count($avatarlist) > 0) {
1542                         krsort($avatarlist);
1543                         $author["avatar"] = current($avatarlist);
1544                 }
1545
1546                 if (empty($author['avatar']) && !empty($author['link'])) {
1547                         $cid = Contact::getIdForURL($author['link'], 0);
1548                         if (!empty($cid)) {
1549                                 $contact = DBA::selectFirst('contact', ['avatar'], ['id' => $cid]);
1550                                 if (DBA::isResult($contact)) {
1551                                         $author['avatar'] = $contact['avatar'];
1552                                 }
1553                         }
1554                 }
1555
1556                 if (empty($author['avatar'])) {
1557                         Logger::log('Empty author: ' . $xml);
1558                         $author['avatar'] = '';
1559                 }
1560
1561                 if (DBA::isResult($contact_old) && !$onlyfetch) {
1562                         Logger::log("Check if contact details for contact " . $contact_old["id"] . " (" . $contact_old["nick"] . ") have to be updated.", Logger::DEBUG);
1563
1564                         $poco = ["url" => $contact_old["url"], "network" => $contact_old["network"]];
1565
1566                         // When was the last change to name or uri?
1567                         $name_element = $xpath->query($element . "/atom:name", $context)->item(0);
1568                         foreach ($name_element->attributes as $attributes) {
1569                                 if ($attributes->name == "updated") {
1570                                         $poco["name-date"] = $attributes->textContent;
1571                                 }
1572                         }
1573
1574                         $link_element = $xpath->query($element . "/atom:link", $context)->item(0);
1575                         foreach ($link_element->attributes as $attributes) {
1576                                 if ($attributes->name == "updated") {
1577                                         $poco["uri-date"] = $attributes->textContent;
1578                                 }
1579                         }
1580
1581                         // Update contact data
1582                         $value = XML::getFirstNodeValue($xpath, $element . "/dfrn:handle/text()", $context);
1583                         if ($value != "") {
1584                                 $poco["addr"] = $value;
1585                         }
1586
1587                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:displayName/text()", $context);
1588                         if ($value != "") {
1589                                 $poco["name"] = $value;
1590                         }
1591
1592                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:preferredUsername/text()", $context);
1593                         if ($value != "") {
1594                                 $poco["nick"] = $value;
1595                         }
1596
1597                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:note/text()", $context);
1598                         if ($value != "") {
1599                                 $poco["about"] = $value;
1600                         }
1601
1602                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:address/poco:formatted/text()", $context);
1603                         if ($value != "") {
1604                                 $poco["location"] = $value;
1605                         }
1606
1607                         /// @todo Only search for elements with "poco:type" = "xmpp"
1608                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:ims/poco:value/text()", $context);
1609                         if ($value != "") {
1610                                 $poco["xmpp"] = $value;
1611                         }
1612
1613                         /// @todo Add support for the following fields that we don't support by now in the contact table:
1614                         /// - poco:utcOffset
1615                         /// - poco:urls
1616                         /// - poco:locality
1617                         /// - poco:region
1618                         /// - poco:country
1619
1620                         // If the "hide" element is present then the profile isn't searchable.
1621                         $hide = intval(XML::getFirstNodeValue($xpath, $element . "/dfrn:hide/text()", $context) == "true");
1622
1623                         Logger::log("Hidden status for contact " . $contact_old["url"] . ": " . $hide, Logger::DEBUG);
1624
1625                         // If the contact isn't searchable then set the contact to "hidden".
1626                         // Problem: This can be manually overridden by the user.
1627                         if ($hide) {
1628                                 $contact_old["hidden"] = true;
1629                         }
1630
1631                         // Save the keywords into the contact table
1632                         $tags = [];
1633                         $tagelements = $xpath->evaluate($element . "/poco:tags/text()", $context);
1634                         foreach ($tagelements as $tag) {
1635                                 $tags[$tag->nodeValue] = $tag->nodeValue;
1636                         }
1637
1638                         if (count($tags)) {
1639                                 $poco["keywords"] = implode(", ", $tags);
1640                         }
1641
1642                         // "dfrn:birthday" contains the birthday converted to UTC
1643                         $birthday = XML::getFirstNodeValue($xpath, $element . "/poco:birthday/text()", $context);
1644
1645                         if (strtotime($birthday) > time()) {
1646                                 $bd_timestamp = strtotime($birthday);
1647
1648                                 $poco["bdyear"] = date("Y", $bd_timestamp);
1649                         }
1650
1651                         // "poco:birthday" is the birthday in the format "yyyy-mm-dd"
1652                         $value = XML::getFirstNodeValue($xpath, $element . "/poco:birthday/text()", $context);
1653
1654                         if (!in_array($value, ["", "0000-00-00", DBA::NULL_DATE])) {
1655                                 $bdyear = date("Y");
1656                                 $value = str_replace(["0000", "0001"], $bdyear, $value);
1657
1658                                 if (strtotime($value) < time()) {
1659                                         $value = str_replace($bdyear, $bdyear + 1, $value);
1660                                 }
1661
1662                                 $poco["bd"] = $value;
1663                         }
1664
1665                         $contact = array_merge($contact_old, $poco);
1666
1667                         if ($contact_old["bdyear"] != $contact["bdyear"]) {
1668                                 Event::createBirthday($contact, $birthday);
1669                         }
1670
1671                         $fields = ['name' => $contact['name'], 'nick' => $contact['nick'], 'about' => $contact['about'],
1672                                 'location' => $contact['location'], 'addr' => $contact['addr'], 'keywords' => $contact['keywords'],
1673                                 'bdyear' => $contact['bdyear'], 'bd' => $contact['bd'], 'hidden' => $contact['hidden'],
1674                                 'xmpp' => $contact['xmpp'], 'name-date' => DateTimeFormat::utc($contact['name-date']),
1675                                 'unsearchable' => $contact['hidden'], 'uri-date' => DateTimeFormat::utc($contact['uri-date'])];
1676
1677                         DBA::update('contact', $fields, ['id' => $contact['id'], 'network' => $contact['network']], $contact_old);
1678
1679                         // Update the public contact. Don't set the "hidden" value, this is used differently for public contacts
1680                         unset($fields['hidden']);
1681                         $condition = ['uid' => 0, 'nurl' => Strings::normaliseLink($contact_old['url'])];
1682                         DBA::update('contact', $fields, $condition, true);
1683
1684                         Contact::updateAvatar($author['avatar'], $importer['importer_uid'], $contact['id']);
1685
1686                         $pcid = Contact::getIdForURL($contact_old['url']);
1687                         if (!empty($pcid)) {
1688                                 Contact::updateAvatar($author['avatar'], 0, $pcid);
1689                         }
1690
1691                         /*
1692                          * The generation is a sign for the reliability of the provided data.
1693                          * It is used in the socgraph.php to prevent that old contact data
1694                          * that was relayed over several servers can overwrite contact
1695                          * data that we received directly.
1696                          */
1697
1698                         $poco["generation"] = 2;
1699                         $poco["photo"] = $author["avatar"];
1700                         $poco["hide"] = $hide;
1701                         $poco["contact-type"] = $contact["contact-type"];
1702                         $gcid = GContact::update($poco);
1703
1704                         GContact::link($gcid, $importer["importer_uid"], $contact["id"]);
1705                 }
1706
1707                 return $author;
1708         }
1709
1710         /**
1711          * Transforms activity objects into an XML string
1712          *
1713          * @param object $xpath    XPath object
1714          * @param object $activity Activity object
1715          * @param string $element  element name
1716          *
1717          * @return string XML string
1718          * @todo Find good type-hints for all parameter
1719          */
1720         private static function transformActivity($xpath, $activity, $element)
1721         {
1722                 if (!is_object($activity)) {
1723                         return "";
1724                 }
1725
1726                 $obj_doc = new DOMDocument("1.0", "utf-8");
1727                 $obj_doc->formatOutput = true;
1728
1729                 $obj_element = $obj_doc->createElementNS( ActivityNamespace::ATOM1, $element);
1730
1731                 $activity_type = $xpath->query("activity:object-type/text()", $activity)->item(0)->nodeValue;
1732                 XML::addElement($obj_doc, $obj_element, "type", $activity_type);
1733
1734                 $id = $xpath->query("atom:id", $activity)->item(0);
1735                 if (is_object($id)) {
1736                         $obj_element->appendChild($obj_doc->importNode($id, true));
1737                 }
1738
1739                 $title = $xpath->query("atom:title", $activity)->item(0);
1740                 if (is_object($title)) {
1741                         $obj_element->appendChild($obj_doc->importNode($title, true));
1742                 }
1743
1744                 $links = $xpath->query("atom:link", $activity);
1745                 if (is_object($links)) {
1746                         foreach ($links as $link) {
1747                                 $obj_element->appendChild($obj_doc->importNode($link, true));
1748                         }
1749                 }
1750
1751                 $content = $xpath->query("atom:content", $activity)->item(0);
1752                 if (is_object($content)) {
1753                         $obj_element->appendChild($obj_doc->importNode($content, true));
1754                 }
1755
1756                 $obj_doc->appendChild($obj_element);
1757
1758                 $objxml = $obj_doc->saveXML($obj_element);
1759
1760                 /// @todo This isn't totally clean. We should find a way to transform the namespaces
1761                 $objxml = str_replace("<".$element.' xmlns="http://www.w3.org/2005/Atom">', "<".$element.">", $objxml);
1762                 return($objxml);
1763         }
1764
1765         /**
1766          * Processes the mail elements
1767          *
1768          * @param object $xpath    XPath object
1769          * @param object $mail     mail elements
1770          * @param array  $importer Record of the importer user mixed with contact of the content
1771          * @return void
1772          * @throws \Exception
1773          * @todo  Find good type-hints for all parameter
1774          */
1775         private static function processMail($xpath, $mail, $importer)
1776         {
1777                 Logger::log("Processing mails");
1778
1779                 $msg = [];
1780                 $msg["uid"] = $importer["importer_uid"];
1781                 $msg["from-name"] = $xpath->query("dfrn:sender/dfrn:name/text()", $mail)->item(0)->nodeValue;
1782                 $msg["from-url"] = $xpath->query("dfrn:sender/dfrn:uri/text()", $mail)->item(0)->nodeValue;
1783                 $msg["from-photo"] = $xpath->query("dfrn:sender/dfrn:avatar/text()", $mail)->item(0)->nodeValue;
1784                 $msg["contact-id"] = $importer["id"];
1785                 $msg["uri"] = $xpath->query("dfrn:id/text()", $mail)->item(0)->nodeValue;
1786                 $msg["parent-uri"] = $xpath->query("dfrn:in-reply-to/text()", $mail)->item(0)->nodeValue;
1787                 $msg["created"] = DateTimeFormat::utc($xpath->query("dfrn:sentdate/text()", $mail)->item(0)->nodeValue);
1788                 $msg["title"] = $xpath->query("dfrn:subject/text()", $mail)->item(0)->nodeValue;
1789                 $msg["body"] = $xpath->query("dfrn:content/text()", $mail)->item(0)->nodeValue;
1790
1791                 Mail::insert($msg);
1792         }
1793
1794         /**
1795          * Processes the suggestion elements
1796          *
1797          * @param object $xpath      XPath object
1798          * @param object $suggestion suggestion elements
1799          * @param array  $importer   Record of the importer user mixed with contact of the content
1800          * @return boolean
1801          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1802          * @todo  Find good type-hints for all parameter
1803          */
1804         private static function processSuggestion($xpath, $suggestion, $importer)
1805         {
1806                 Logger::log('Processing suggestions');
1807
1808                 /// @TODO Rewrite this to one statement
1809                 $suggest = [];
1810                 $suggest['uid'] = $importer['importer_uid'];
1811                 $suggest['cid'] = $importer['id'];
1812                 $suggest['url'] = $xpath->query('dfrn:url/text()', $suggestion)->item(0)->nodeValue;
1813                 $suggest['name'] = $xpath->query('dfrn:name/text()', $suggestion)->item(0)->nodeValue;
1814                 $suggest['photo'] = $xpath->query('dfrn:photo/text()', $suggestion)->item(0)->nodeValue;
1815                 $suggest['request'] = $xpath->query('dfrn:request/text()', $suggestion)->item(0)->nodeValue;
1816                 $suggest['body'] = $xpath->query('dfrn:note/text()', $suggestion)->item(0)->nodeValue;
1817
1818                 // Does our member already have a friend matching this description?
1819
1820                 /*
1821                  * The valid result means the friend we're about to send a friend
1822                  * suggestion already has them in their contact, which means no further
1823                  * action is required.
1824                  *
1825                  * @see https://github.com/friendica/friendica/pull/3254#discussion_r107315246
1826                  */
1827                 $condition = ['nurl' => Strings::normaliseLink($suggest['url']), 'uid' => $suggest['uid']];
1828                 if (DBA::exists('contact', $condition)) {
1829                         return false;
1830                 }
1831                 // Do we already have an fcontact record for this person?
1832
1833                 $fid = 0;
1834                 $fcontact = DBA::selectFirst('fcontact', ['id'], ['url' => $suggest['url']]);
1835                 if (DBA::isResult($fcontact)) {
1836                         $fid = $fcontact['id'];
1837
1838                         // OK, we do. Do we already have an introduction for this person?
1839                         if (DBA::exists('intro', ['uid' => $suggest['uid'], 'fid' => $fid])) {
1840                                 /*
1841                                  * The valid result means the friend we're about to send a friend
1842                                  * suggestion already has them in their contact, which means no further
1843                                  * action is required.
1844                                  *
1845                                  * @see https://github.com/friendica/friendica/pull/3254#discussion_r107315246
1846                                  */
1847                                 return false;
1848                         }
1849                 }
1850
1851                 if (!$fid) {
1852                         $fields = ['name' => $suggest['name'], 'url' => $suggest['url'],
1853                                 'photo' => $suggest['photo'], 'request' => $suggest['request']];
1854                         DBA::insert('fcontact', $fields);
1855                         $fid = DBA::lastInsertId();
1856                 }
1857
1858                 /*
1859                  * If no record in fcontact is found, below INSERT statement will not
1860                  * link an introduction to it.
1861                  */
1862                 if (empty($fid)) {
1863                         // Database record did not get created. Quietly give up.
1864                         exit();
1865                 }
1866
1867                 $hash = Strings::getRandomHex();
1868
1869                 $fields = ['uid' => $suggest['uid'], 'fid' => $fid, 'contact-id' => $suggest['cid'],
1870                         'note' => $suggest['body'], 'hash' => $hash, 'datetime' => DateTimeFormat::utcNow(), 'blocked' => false];
1871                 DBA::insert('intro', $fields);
1872
1873                 notification(
1874                         [
1875                                 'type'         => Type::SUGGEST,
1876                                 'notify_flags' => $importer['notify-flags'],
1877                                 'language'     => $importer['language'],
1878                                 'to_name'      => $importer['username'],
1879                                 'to_email'     => $importer['email'],
1880                                 'uid'          => $importer['importer_uid'],
1881                                 'item'         => $suggest,
1882                                 'link'         => DI::baseUrl().'/notifications/intros',
1883                                 'source_name'  => $importer['name'],
1884                                 'source_link'  => $importer['url'],
1885                                 'source_photo' => $importer['photo'],
1886                                 'verb'         => Activity::REQ_FRIEND,
1887                                 'otype'        => 'intro']
1888                 );
1889
1890                 return true;
1891         }
1892
1893         /**
1894          * Processes the relocation elements
1895          *
1896          * @param object $xpath      XPath object
1897          * @param object $relocation relocation elements
1898          * @param array  $importer   Record of the importer user mixed with contact of the content
1899          * @return boolean
1900          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1901          * @throws \ImagickException
1902          * @todo  Find good type-hints for all parameter
1903          */
1904         private static function processRelocation($xpath, $relocation, $importer)
1905         {
1906                 Logger::log("Processing relocations");
1907
1908                 /// @TODO Rewrite this to one statement
1909                 $relocate = [];
1910                 $relocate["uid"] = $importer["importer_uid"];
1911                 $relocate["cid"] = $importer["id"];
1912                 $relocate["url"] = $xpath->query("dfrn:url/text()", $relocation)->item(0)->nodeValue;
1913                 $relocate["addr"] = $xpath->query("dfrn:addr/text()", $relocation)->item(0)->nodeValue;
1914                 $relocate["name"] = $xpath->query("dfrn:name/text()", $relocation)->item(0)->nodeValue;
1915                 $relocate["avatar"] = $xpath->query("dfrn:avatar/text()", $relocation)->item(0)->nodeValue;
1916                 $relocate["photo"] = $xpath->query("dfrn:photo/text()", $relocation)->item(0)->nodeValue;
1917                 $relocate["thumb"] = $xpath->query("dfrn:thumb/text()", $relocation)->item(0)->nodeValue;
1918                 $relocate["micro"] = $xpath->query("dfrn:micro/text()", $relocation)->item(0)->nodeValue;
1919                 $relocate["request"] = $xpath->query("dfrn:request/text()", $relocation)->item(0)->nodeValue;
1920                 $relocate["confirm"] = $xpath->query("dfrn:confirm/text()", $relocation)->item(0)->nodeValue;
1921                 $relocate["notify"] = $xpath->query("dfrn:notify/text()", $relocation)->item(0)->nodeValue;
1922                 $relocate["poll"] = $xpath->query("dfrn:poll/text()", $relocation)->item(0)->nodeValue;
1923                 $relocate["sitepubkey"] = $xpath->query("dfrn:sitepubkey/text()", $relocation)->item(0)->nodeValue;
1924
1925                 if (($relocate["avatar"] == "") && ($relocate["photo"] != "")) {
1926                         $relocate["avatar"] = $relocate["photo"];
1927                 }
1928
1929                 if ($relocate["addr"] == "") {
1930                         $relocate["addr"] = preg_replace("=(https?://)(.*)/profile/(.*)=ism", "$3@$2", $relocate["url"]);
1931                 }
1932
1933                 // update contact
1934                 $r = q(
1935                         "SELECT `photo`, `url` FROM `contact` WHERE `id` = %d AND `uid` = %d",
1936                         intval($importer["id"]),
1937                         intval($importer["importer_uid"])
1938                 );
1939
1940                 if (!DBA::isResult($r)) {
1941                         Logger::log("Query failed to execute, no result returned in " . __FUNCTION__);
1942                         return false;
1943                 }
1944
1945                 $old = $r[0];
1946
1947                 // Update the gcontact entry
1948                 $relocate["server_url"] = preg_replace("=(https?://)(.*)/profile/(.*)=ism", "$1$2", $relocate["url"]);
1949
1950                 $fields = ['name' => $relocate["name"], 'photo' => $relocate["avatar"],
1951                         'url' => $relocate["url"], 'nurl' => Strings::normaliseLink($relocate["url"]),
1952                         'addr' => $relocate["addr"], 'connect' => $relocate["addr"],
1953                         'notify' => $relocate["notify"], 'server_url' => $relocate["server_url"]];
1954                 DBA::update('gcontact', $fields, ['nurl' => Strings::normaliseLink($old["url"])]);
1955
1956                 // Update the contact table. We try to find every entry.
1957                 $fields = ['name' => $relocate["name"], 'avatar' => $relocate["avatar"],
1958                         'url' => $relocate["url"], 'nurl' => Strings::normaliseLink($relocate["url"]),
1959                         'addr' => $relocate["addr"], 'request' => $relocate["request"],
1960                         'confirm' => $relocate["confirm"], 'notify' => $relocate["notify"],
1961                         'poll' => $relocate["poll"], 'site-pubkey' => $relocate["sitepubkey"]];
1962                 $condition = ["(`id` = ?) OR (`nurl` = ?)", $importer["id"], Strings::normaliseLink($old["url"])];
1963
1964                 DBA::update('contact', $fields, $condition);
1965
1966                 Contact::updateAvatar($relocate["avatar"], $importer["importer_uid"], $importer["id"], true);
1967
1968                 Logger::log('Contacts are updated.');
1969
1970                 /// @TODO
1971                 /// merge with current record, current contents have priority
1972                 /// update record, set url-updated
1973                 /// update profile photos
1974                 /// schedule a scan?
1975                 return true;
1976         }
1977
1978         /**
1979          * Updates an item
1980          *
1981          * @param array $current   the current item record
1982          * @param array $item      the new item record
1983          * @param array $importer  Record of the importer user mixed with contact of the content
1984          * @param int   $entrytype Is it a toplevel entry, a comment or a relayed comment?
1985          * @return mixed
1986          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1987          * @todo  set proper type-hints (array?)
1988          */
1989         private static function updateContent($current, $item, $importer, $entrytype)
1990         {
1991                 $changed = false;
1992
1993                 if (self::isEditedTimestampNewer($current, $item)) {
1994                         // do not accept (ignore) an earlier edit than one we currently have.
1995                         if (DateTimeFormat::utc($item["edited"]) < $current["edited"]) {
1996                                 return false;
1997                         }
1998
1999                         $fields = ['title' => $item['title'] ?? '', 'body' => $item['body'] ?? '',
2000                                         'changed' => DateTimeFormat::utcNow(),
2001                                         'edited' => DateTimeFormat::utc($item["edited"])];
2002
2003                         $condition = ["`uri` = ? AND `uid` IN (0, ?)", $item["uri"], $importer["importer_uid"]];
2004                         Item::update($fields, $condition);
2005
2006                         $changed = true;
2007                 }
2008                 return $changed;
2009         }
2010
2011         /**
2012          * Detects the entry type of the item
2013          *
2014          * @param array $importer Record of the importer user mixed with contact of the content
2015          * @param array $item     the new item record
2016          *
2017          * @return int Is it a toplevel entry, a comment or a relayed comment?
2018          * @throws \Exception
2019          * @todo  set proper type-hints (array?)
2020          */
2021         private static function getEntryType($importer, $item)
2022         {
2023                 if ($item["parent-uri"] != $item["uri"]) {
2024                         $community = false;
2025
2026                         if ($importer["page-flags"] == User::PAGE_FLAGS_COMMUNITY || $importer["page-flags"] == User::PAGE_FLAGS_PRVGROUP) {
2027                                 $sql_extra = "";
2028                                 $community = true;
2029                                 Logger::log("possible community action");
2030                         } else {
2031                                 $sql_extra = " AND `contact`.`self` AND `item`.`wall` ";
2032                         }
2033
2034                         // was the top-level post for this action written by somebody on this site?
2035                         // Specifically, the recipient?
2036
2037                         $is_a_remote_action = false;
2038
2039                         $parent = Item::selectFirst(['parent-uri'], ['uri' => $item["parent-uri"]]);
2040                         if (DBA::isResult($parent)) {
2041                                 $r = q(
2042                                         "SELECT `item`.`forum_mode`, `item`.`wall` FROM `item`
2043                                         INNER JOIN `contact` ON `contact`.`id` = `item`.`contact-id`
2044                                         WHERE `item`.`uri` = '%s' AND (`item`.`parent-uri` = '%s' OR `item`.`thr-parent` = '%s')
2045                                         AND `item`.`uid` = %d
2046                                         $sql_extra
2047                                         LIMIT 1",
2048                                         DBA::escape($parent["parent-uri"]),
2049                                         DBA::escape($parent["parent-uri"]),
2050                                         DBA::escape($parent["parent-uri"]),
2051                                         intval($importer["importer_uid"])
2052                                 );
2053                                 if (DBA::isResult($r)) {
2054                                         $is_a_remote_action = true;
2055                                 }
2056                         }
2057
2058                         /*
2059                          * Does this have the characteristics of a community or private group action?
2060                          * If it's an action to a wall post on a community/prvgroup page it's a
2061                          * valid community action. Also forum_mode makes it valid for sure.
2062                          * If neither, it's not.
2063                          */
2064                         if ($is_a_remote_action && $community && (!$r[0]["forum_mode"]) && (!$r[0]["wall"])) {
2065                                 $is_a_remote_action = false;
2066                                 Logger::log("not a community action");
2067                         }
2068
2069                         if ($is_a_remote_action) {
2070                                 return DFRN::REPLY_RC;
2071                         } else {
2072                                 return DFRN::REPLY;
2073                         }
2074                 } else {
2075                         return DFRN::TOP_LEVEL;
2076                 }
2077         }
2078
2079         /**
2080          * Send a "poke"
2081          *
2082          * @param array $item      The new item record
2083          * @param array $importer  Record of the importer user mixed with contact of the content
2084          * @return void
2085          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2086          * @todo  set proper type-hints (array?)
2087          */
2088         private static function doPoke(array $item, array $importer)
2089         {
2090                 $verb = urldecode(substr($item["verb"], strpos($item["verb"], "#")+1));
2091                 if (!$verb) {
2092                         return;
2093                 }
2094                 $xo = XML::parseString($item["object"]);
2095
2096                 if (($xo->type == Activity\ObjectType::PERSON) && ($xo->id)) {
2097                         // somebody was poked/prodded. Was it me?
2098                         $Blink = '';
2099                         foreach ($xo->link as $l) {
2100                                 $atts = $l->attributes();
2101                                 switch ($atts["rel"]) {
2102                                         case "alternate":
2103                                                 $Blink = $atts["href"];
2104                                                 break;
2105                                         default:
2106                                                 break;
2107                                 }
2108                         }
2109
2110                         if ($Blink && Strings::compareLink($Blink, DI::baseUrl() . "/profile/" . $importer["nickname"])) {
2111                                 $author = DBA::selectFirst('contact', ['name', 'thumb', 'url'], ['id' => $item['author-id']]);
2112
2113                                 $parent = Item::selectFirst(['id'], ['uri' => $item['parent-uri'], 'uid' => $importer["importer_uid"]]);
2114                                 $item['parent'] = $parent['id'];
2115
2116                                 // send a notification
2117                                 notification(
2118                                         [
2119                                         "type"         => Type::POKE,
2120                                         "notify_flags" => $importer["notify-flags"],
2121                                         "language"     => $importer["language"],
2122                                         "to_name"      => $importer["username"],
2123                                         "to_email"     => $importer["email"],
2124                                         "uid"          => $importer["importer_uid"],
2125                                         "item"         => $item,
2126                                         "link"         => DI::baseUrl()."/display/".urlencode($item['guid']),
2127                                         "source_name"  => $author["name"],
2128                                         "source_link"  => $author["url"],
2129                                         "source_photo" => $author["thumb"],
2130                                         "verb"         => $item["verb"],
2131                                         "otype"        => "person",
2132                                         "activity"     => $verb,
2133                                         "parent"       => $item['parent']]
2134                                 );
2135                         }
2136                 }
2137         }
2138
2139         /**
2140          * Processes several actions, depending on the verb
2141          *
2142          * @param int   $entrytype Is it a toplevel entry, a comment or a relayed comment?
2143          * @param array $importer  Record of the importer user mixed with contact of the content
2144          * @param array $item      the new item record
2145          * @param bool  $is_like   Is the verb a "like"?
2146          *
2147          * @return bool Should the processing of the entries be continued?
2148          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2149          * @todo  set proper type-hints (array?)
2150          */
2151         private static function processVerbs($entrytype, $importer, &$item, &$is_like)
2152         {
2153                 Logger::log("Process verb ".$item["verb"]." and object-type ".$item["object-type"]." for entrytype ".$entrytype, Logger::DEBUG);
2154
2155                 if (($entrytype == DFRN::TOP_LEVEL) && !empty($importer['id'])) {
2156                         // The filling of the the "contact" variable is done for legcy reasons
2157                         // The functions below are partly used by ostatus.php as well - where we have this variable
2158                         $contact = Contact::selectFirst([], ['id' => $importer['id']]);
2159
2160                         $activity = DI::activity();
2161
2162                         // Big question: Do we need these functions? They were part of the "consume_feed" function.
2163                         // This function once was responsible for DFRN and OStatus.
2164                         if ($activity->match($item["verb"], Activity::FOLLOW)) {
2165                                 Logger::log("New follower");
2166                                 Contact::addRelationship($importer, $contact, $item);
2167                                 return false;
2168                         }
2169                         if ($activity->match($item["verb"], Activity::UNFOLLOW)) {
2170                                 Logger::log("Lost follower");
2171                                 Contact::removeFollower($importer, $contact, $item);
2172                                 return false;
2173                         }
2174                         if ($activity->match($item["verb"], Activity::REQ_FRIEND)) {
2175                                 Logger::log("New friend request");
2176                                 Contact::addRelationship($importer, $contact, $item, true);
2177                                 return false;
2178                         }
2179                         if ($activity->match($item["verb"], Activity::UNFRIEND)) {
2180                                 Logger::log("Lost sharer");
2181                                 Contact::removeSharer($importer, $contact, $item);
2182                                 return false;
2183                         }
2184                 } else {
2185                         if (($item["verb"] == Activity::LIKE)
2186                                 || ($item["verb"] == Activity::DISLIKE)
2187                                 || ($item["verb"] == Activity::ATTEND)
2188                                 || ($item["verb"] == Activity::ATTENDNO)
2189                                 || ($item["verb"] == Activity::ATTENDMAYBE)
2190                         ) {
2191                                 $is_like = true;
2192                                 $item["gravity"] = GRAVITY_ACTIVITY;
2193                                 // only one like or dislike per person
2194                                 // splitted into two queries for performance issues
2195                                 $condition = ['uid' => $item["uid"], 'author-id' => $item["author-id"], 'gravity' => GRAVITY_ACTIVITY,
2196                                         'verb' => $item["verb"], 'parent-uri' => $item["parent-uri"]];
2197                                 if (Item::exists($condition)) {
2198                                         return false;
2199                                 }
2200
2201                                 $condition = ['uid' => $item["uid"], 'author-id' => $item["author-id"], 'gravity' => GRAVITY_ACTIVITY,
2202                                         'verb' => $item["verb"], 'thr-parent' => $item["parent-uri"]];
2203                                 if (Item::exists($condition)) {
2204                                         return false;
2205                                 }
2206
2207                                 // The owner of an activity must be the author
2208                                 $item["owner-name"] = $item["author-name"];
2209                                 $item["owner-link"] = $item["author-link"];
2210                                 $item["owner-avatar"] = $item["author-avatar"];
2211                                 $item["owner-id"] = $item["author-id"];
2212                         } else {
2213                                 $is_like = false;
2214                         }
2215
2216                         if (($item["verb"] == Activity::TAG) && ($item["object-type"] == Activity\ObjectType::TAGTERM)) {
2217                                 $xo = XML::parseString($item["object"]);
2218                                 $xt = XML::parseString($item["target"]);
2219
2220                                 if ($xt->type == Activity\ObjectType::NOTE) {
2221                                         $item_tag = Item::selectFirst(['id', 'uri-id', 'tag'], ['uri' => $xt->id, 'uid' => $importer["importer_uid"]]);
2222
2223                                         if (!DBA::isResult($item_tag)) {
2224                                                 Logger::log("Query failed to execute, no result returned in " . __FUNCTION__);
2225                                                 return false;
2226                                         }
2227
2228                                         // extract tag, if not duplicate, add to parent item
2229                                         if ($xo->content) {
2230                                                 Tag::store($item_tag['uri-id'], Tag::HASHTAG, $xo->content);
2231                                         }
2232                                 }
2233                         }
2234                 }
2235                 return true;
2236         }
2237
2238         /**
2239          * Processes the link elements
2240          *
2241          * @param object $links link elements
2242          * @param array  $item  the item record
2243          * @return void
2244          * @todo set proper type-hints
2245          */
2246         private static function parseLinks($links, &$item)
2247         {
2248                 $rel = "";
2249                 $href = "";
2250                 $type = "";
2251                 $length = "0";
2252                 $title = "";
2253                 foreach ($links as $link) {
2254                         foreach ($link->attributes as $attributes) {
2255                                 switch ($attributes->name) {
2256                                         case "href"  : $href   = $attributes->textContent; break;
2257                                         case "rel"   : $rel    = $attributes->textContent; break;
2258                                         case "type"  : $type   = $attributes->textContent; break;
2259                                         case "length": $length = $attributes->textContent; break;
2260                                         case "title" : $title  = $attributes->textContent; break;
2261                                 }
2262                         }
2263                         if (($rel != "") && ($href != "")) {
2264                                 switch ($rel) {
2265                                         case "alternate":
2266                                                 $item["plink"] = $href;
2267                                                 break;
2268                                         case "enclosure":
2269                                                 if (!empty($item["attach"])) {
2270                                                         $item["attach"] .= ",";
2271                                                 } else {
2272                                                         $item["attach"] = "";
2273                                                 }
2274
2275                                                 $item["attach"] .= '[attach]href="' . $href . '" length="' . $length . '" type="' . $type . '" title="' . $title . '"[/attach]';
2276                                                 break;
2277                                 }
2278                         }
2279                 }
2280         }
2281
2282         /**
2283          * Processes the entry elements which contain the items and comments
2284          *
2285          * @param array  $header   Array of the header elements that always stay the same
2286          * @param object $xpath    XPath object
2287          * @param object $entry    entry elements
2288          * @param array  $importer Record of the importer user mixed with contact of the content
2289          * @param string $xml      xml
2290          * @return void
2291          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2292          * @throws \ImagickException
2293          * @todo  Add type-hints
2294          */
2295         private static function processEntry($header, $xpath, $entry, $importer, $xml)
2296         {
2297                 Logger::log("Processing entries");
2298
2299                 $item = $header;
2300
2301                 $item["protocol"] = Conversation::PARCEL_DFRN;
2302
2303                 $item["source"] = $xml;
2304
2305                 // Get the uri
2306                 $item["uri"] = XML::getFirstNodeValue($xpath, "atom:id/text()", $entry);
2307
2308                 $item["edited"] = XML::getFirstNodeValue($xpath, "atom:updated/text()", $entry);
2309
2310                 $current = Item::selectFirst(['id', 'uid', 'edited', 'body'],
2311                         ['uri' => $item["uri"], 'uid' => $importer["importer_uid"]]
2312                 );
2313                 // Is there an existing item?
2314                 if (DBA::isResult($current) && !self::isEditedTimestampNewer($current, $item)) {
2315                         Logger::log("Item ".$item["uri"]." (".$item['edited'].") already existed.", Logger::DEBUG);
2316                         return;
2317                 }
2318
2319                 // Fetch the owner
2320                 $owner = self::fetchauthor($xpath, $entry, $importer, "dfrn:owner", true, $xml);
2321
2322                 $owner_unknown = (isset($owner["contact-unknown"]) && $owner["contact-unknown"]);
2323
2324                 $item["owner-name"] = $owner["name"];
2325                 $item["owner-link"] = $owner["link"];
2326                 $item["owner-avatar"] = $owner["avatar"];
2327                 $item["owner-id"] = Contact::getIdForURL($owner["link"], 0);
2328
2329                 // fetch the author
2330                 $author = self::fetchauthor($xpath, $entry, $importer, "atom:author", true, $xml);
2331
2332                 $item["author-name"] = $author["name"];
2333                 $item["author-link"] = $author["link"];
2334                 $item["author-avatar"] = $author["avatar"];
2335                 $item["author-id"] = Contact::getIdForURL($author["link"], 0);
2336
2337                 $item["title"] = XML::getFirstNodeValue($xpath, "atom:title/text()", $entry);
2338
2339                 $item["created"] = XML::getFirstNodeValue($xpath, "atom:published/text()", $entry);
2340
2341                 $item["body"] = XML::getFirstNodeValue($xpath, "dfrn:env/text()", $entry);
2342                 $item["body"] = str_replace([' ',"\t","\r","\n"], ['','','',''], $item["body"]);
2343
2344                 $item["body"] = Strings::base64UrlDecode($item["body"]);
2345
2346                 $item["body"] = BBCode::limitBodySize($item["body"]);
2347
2348                 /// @todo We should check for a repeated post and if we know the repeated author.
2349
2350                 // We don't need the content element since "dfrn:env" is always present
2351                 //$item["body"] = $xpath->query("atom:content/text()", $entry)->item(0)->nodeValue;
2352
2353                 $item["location"] = XML::getFirstNodeValue($xpath, "dfrn:location/text()", $entry);
2354
2355                 $item["coord"] = XML::getFirstNodeValue($xpath, "georss:point", $entry);
2356
2357                 $item["private"] = XML::getFirstNodeValue($xpath, "dfrn:private/text()", $entry);
2358
2359                 $unlisted = XML::getFirstNodeValue($xpath, "dfrn:unlisted/text()", $entry);
2360                 if (!empty($unlisted) && ($item['private'] != Item::PRIVATE)) {
2361                         $item['private'] = Item::UNLISTED;
2362                 }
2363
2364                 $item["extid"] = XML::getFirstNodeValue($xpath, "dfrn:extid/text()", $entry);
2365
2366                 if (XML::getFirstNodeValue($xpath, "dfrn:bookmark/text()", $entry) == "true") {
2367                         $item["post-type"] = Item::PT_PAGE;
2368                 }
2369
2370                 $notice_info = $xpath->query("statusnet:notice_info", $entry);
2371                 if ($notice_info && ($notice_info->length > 0)) {
2372                         foreach ($notice_info->item(0)->attributes as $attributes) {
2373                                 if ($attributes->name == "source") {
2374                                         $item["app"] = strip_tags($attributes->textContent);
2375                                 }
2376                         }
2377                 }
2378
2379                 $item["guid"] = XML::getFirstNodeValue($xpath, "dfrn:diaspora_guid/text()", $entry);
2380
2381                 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
2382
2383                 Tag::storeFromBody($item['uri-id'], $item["body"]);
2384
2385                 // We store the data from "dfrn:diaspora_signature" in a different table, this is done in "Item::insert"
2386                 $dsprsig = XML::unescape(XML::getFirstNodeValue($xpath, "dfrn:diaspora_signature/text()", $entry));
2387                 if ($dsprsig != "") {
2388                         $signature = json_decode(base64_decode($dsprsig));
2389                         // We don't store the old style signatures anymore that also contained the "signature" and "signer"
2390                         if (!empty($signature->signed_text) && empty($signature->signature) && empty($signature->signer)) {
2391                                 $item["diaspora_signed_text"] = $signature->signed_text;
2392                         }
2393                 }
2394
2395                 $item["verb"] = XML::getFirstNodeValue($xpath, "activity:verb/text()", $entry);
2396
2397                 if (XML::getFirstNodeValue($xpath, "activity:object-type/text()", $entry) != "") {
2398                         $item["object-type"] = XML::getFirstNodeValue($xpath, "activity:object-type/text()", $entry);
2399                 }
2400
2401                 $object = $xpath->query("activity:object", $entry)->item(0);
2402                 $item["object"] = self::transformActivity($xpath, $object, "object");
2403
2404                 if (trim($item["object"]) != "") {
2405                         $r = XML::parseString($item["object"]);
2406                         if (isset($r->type)) {
2407                                 $item["object-type"] = $r->type;
2408                         }
2409                 }
2410
2411                 $target = $xpath->query("activity:target", $entry)->item(0);
2412                 $item["target"] = self::transformActivity($xpath, $target, "target");
2413
2414                 $categories = $xpath->query("atom:category", $entry);
2415                 if ($categories) {
2416                         foreach ($categories as $category) {
2417                                 $term = "";
2418                                 $scheme = "";
2419                                 foreach ($category->attributes as $attributes) {
2420                                         if ($attributes->name == "term") {
2421                                                 $term = $attributes->textContent;
2422                                         }
2423
2424                                         if ($attributes->name == "scheme") {
2425                                                 $scheme = $attributes->textContent;
2426                                         }
2427                                 }
2428
2429                                 if (($term != "") && ($scheme != "")) {
2430                                         $parts = explode(":", $scheme);
2431                                         if ((count($parts) >= 4) && (array_shift($parts) == "X-DFRN")) {
2432                                                 $termurl = array_pop($parts);
2433                                                 $termurl = array_pop($parts) . $termurl;
2434                                                 Tag::store($item['uri-id'], Tag::IMPLICIT_MENTION, $term, $termurl);
2435                                         }
2436                                 }
2437                         }
2438                 }
2439
2440                 $links = $xpath->query("atom:link", $entry);
2441                 if ($links) {
2442                         self::parseLinks($links, $item);
2443                 }
2444
2445                 $item['conversation-uri'] = XML::getFirstNodeValue($xpath, 'ostatus:conversation/text()', $entry);
2446
2447                 $conv = $xpath->query('ostatus:conversation', $entry);
2448                 if (is_object($conv->item(0))) {
2449                         foreach ($conv->item(0)->attributes as $attributes) {
2450                                 if ($attributes->name == "ref") {
2451                                         $item['conversation-uri'] = $attributes->textContent;
2452                                 }
2453                                 if ($attributes->name == "href") {
2454                                         $item['conversation-href'] = $attributes->textContent;
2455                                 }
2456                         }
2457                 }
2458
2459                 // Is it a reply or a top level posting?
2460                 $item["parent-uri"] = $item["uri"];
2461
2462                 $inreplyto = $xpath->query("thr:in-reply-to", $entry);
2463                 if (is_object($inreplyto->item(0))) {
2464                         foreach ($inreplyto->item(0)->attributes as $attributes) {
2465                                 if ($attributes->name == "ref") {
2466                                         $item["parent-uri"] = $attributes->textContent;
2467                                 }
2468                         }
2469                 }
2470
2471                 // Get the type of the item (Top level post, reply or remote reply)
2472                 $entrytype = self::getEntryType($importer, $item);
2473
2474                 // Now assign the rest of the values that depend on the type of the message
2475                 if (in_array($entrytype, [DFRN::REPLY, DFRN::REPLY_RC])) {
2476                         if (!isset($item["object-type"])) {
2477                                 $item["object-type"] = Activity\ObjectType::COMMENT;
2478                         }
2479
2480                         if ($item["contact-id"] != $owner["contact-id"]) {
2481                                 $item["contact-id"] = $owner["contact-id"];
2482                         }
2483
2484                         if (($item["network"] != $owner["network"]) && ($owner["network"] != "")) {
2485                                 $item["network"] = $owner["network"];
2486                         }
2487
2488                         if ($item["contact-id"] != $author["contact-id"]) {
2489                                 $item["contact-id"] = $author["contact-id"];
2490                         }
2491
2492                         if (($item["network"] != $author["network"]) && ($author["network"] != "")) {
2493                                 $item["network"] = $author["network"];
2494                         }
2495                 }
2496
2497                 // Ensure to have the correct share data
2498                 $item = Item::addShareDataFromOriginal($item);
2499
2500                 if ($entrytype == DFRN::REPLY_RC) {
2501                         $item["wall"] = 1;
2502                 } elseif ($entrytype == DFRN::TOP_LEVEL) {
2503                         if (!isset($item["object-type"])) {
2504                                 $item["object-type"] = Activity\ObjectType::NOTE;
2505                         }
2506
2507                         // Is it an event?
2508                         if (($item["object-type"] == Activity\ObjectType::EVENT) && !$owner_unknown) {
2509                                 Logger::log("Item ".$item["uri"]." seems to contain an event.", Logger::DEBUG);
2510                                 $ev = Event::fromBBCode($item["body"]);
2511                                 if ((!empty($ev['desc']) || !empty($ev['summary'])) && !empty($ev['start'])) {
2512                                         Logger::log("Event in item ".$item["uri"]." was found.", Logger::DEBUG);
2513                                         $ev["cid"]     = $importer["id"];
2514                                         $ev["uid"]     = $importer["importer_uid"];
2515                                         $ev["uri"]     = $item["uri"];
2516                                         $ev["edited"]  = $item["edited"];
2517                                         $ev["private"] = $item["private"];
2518                                         $ev["guid"]    = $item["guid"];
2519                                         $ev["plink"]   = $item["plink"];
2520
2521                                         $condition = ['uri' => $item["uri"], 'uid' => $importer["importer_uid"]];
2522                                         $event = DBA::selectFirst('event', ['id'], $condition);
2523                                         if (DBA::isResult($event)) {
2524                                                 $ev["id"] = $event["id"];
2525                                         }
2526
2527                                         $event_id = Event::store($ev);
2528                                         Logger::log("Event ".$event_id." was stored", Logger::DEBUG);
2529                                         return;
2530                                 }
2531                         }
2532                 }
2533
2534                 if (!self::processVerbs($entrytype, $importer, $item, $is_like)) {
2535                         Logger::log("Exiting because 'processVerbs' told us so", Logger::DEBUG);
2536                         return;
2537                 }
2538
2539                 // This check is done here to be able to receive connection requests in "processVerbs"
2540                 if (($entrytype == DFRN::TOP_LEVEL) && $owner_unknown) {
2541                         Logger::log("Item won't be stored because user " . $importer["importer_uid"] . " doesn't follow " . $item["owner-link"] . ".", Logger::DEBUG);
2542                         return;
2543                 }
2544
2545
2546                 // Update content if 'updated' changes
2547                 if (DBA::isResult($current)) {
2548                         if (self::updateContent($current, $item, $importer, $entrytype)) {
2549                                 Logger::log("Item ".$item["uri"]." was updated.", Logger::DEBUG);
2550                         } else {
2551                                 Logger::log("Item " . $item["uri"] . " already existed.", Logger::DEBUG);
2552                         }
2553                         return;
2554                 }
2555
2556                 if (in_array($entrytype, [DFRN::REPLY, DFRN::REPLY_RC])) {
2557                         $posted_id = Item::insert($item);
2558                         if ($posted_id) {
2559                                 Logger::log("Reply from contact ".$item["contact-id"]." was stored with id ".$posted_id, Logger::DEBUG);
2560
2561                                 if ($item['uid'] == 0) {
2562                                         Item::distribute($posted_id);
2563                                 }
2564
2565                                 return true;
2566                         }
2567                 } else { // $entrytype == DFRN::TOP_LEVEL
2568                         if (($importer["uid"] == 0) && ($importer["importer_uid"] != 0)) {
2569                                 Logger::log("Contact ".$importer["id"]." isn't known to user ".$importer["importer_uid"].". The post will be ignored.", Logger::DEBUG);
2570                                 return;
2571                         }
2572                         if (!Strings::compareLink($item["owner-link"], $importer["url"])) {
2573                                 /*
2574                                  * The item owner info is not our contact. It's OK and is to be expected if this is a tgroup delivery,
2575                                  * but otherwise there's a possible data mixup on the sender's system.
2576                                  * the tgroup delivery code called from Item::insert will correct it if it's a forum,
2577                                  * but we're going to unconditionally correct it here so that the post will always be owned by our contact.
2578                                  */
2579                                 Logger::log('Correcting item owner.', Logger::DEBUG);
2580                                 $item["owner-link"] = $importer["url"];
2581                                 $item["owner-id"] = Contact::getIdForURL($importer["url"], 0);
2582                         }
2583
2584                         if (($importer["rel"] == Contact::FOLLOWER) && (!self::tgroupCheck($importer["importer_uid"], $item))) {
2585                                 Logger::log("Contact ".$importer["id"]." is only follower and tgroup check was negative.", Logger::DEBUG);
2586                                 return;
2587                         }
2588
2589                         // This is my contact on another system, but it's really me.
2590                         // Turn this into a wall post.
2591                         $notify = Item::isRemoteSelf($importer, $item);
2592
2593                         $posted_id = Item::insert($item, $notify);
2594
2595                         if ($notify) {
2596                                 $posted_id = $notify;
2597                         }
2598
2599                         Logger::log("Item was stored with id ".$posted_id, Logger::DEBUG);
2600
2601                         if ($item['uid'] == 0) {
2602                                 Item::distribute($posted_id);
2603                         }
2604
2605                         if (stristr($item["verb"], Activity::POKE)) {
2606                                 $item['id'] = $posted_id;
2607                                 self::doPoke($item, $importer);
2608                         }
2609                 }
2610         }
2611
2612         /**
2613          * Deletes items
2614          *
2615          * @param object $xpath    XPath object
2616          * @param object $deletion deletion elements
2617          * @param array  $importer Record of the importer user mixed with contact of the content
2618          * @return void
2619          * @throws \Exception
2620          * @todo  set proper type-hints
2621          */
2622         private static function processDeletion($xpath, $deletion, $importer)
2623         {
2624                 Logger::log("Processing deletions");
2625                 $uri = null;
2626
2627                 foreach ($deletion->attributes as $attributes) {
2628                         if ($attributes->name == "ref") {
2629                                 $uri = $attributes->textContent;
2630                         }
2631                 }
2632
2633                 if (!$uri || !$importer["id"]) {
2634                         return false;
2635                 }
2636
2637                 $condition = ['uri' => $uri, 'uid' => $importer["importer_uid"]];
2638                 $item = Item::selectFirst(['id', 'parent', 'contact-id', 'file', 'deleted', 'gravity'], $condition);
2639                 if (!DBA::isResult($item)) {
2640                         Logger::log("Item with uri " . $uri . " for user " . $importer["importer_uid"] . " wasn't found.", Logger::DEBUG);
2641                         return;
2642                 }
2643
2644                 if (strstr($item['file'], '[')) {
2645                         Logger::log("Item with uri " . $uri . " for user " . $importer["importer_uid"] . " is filed. So it won't be deleted.", Logger::DEBUG);
2646                         return;
2647                 }
2648
2649                 // When it is a starting post it has to belong to the person that wants to delete it
2650                 if (($item['gravity'] == GRAVITY_PARENT) && ($item['contact-id'] != $importer["id"])) {
2651                         Logger::log("Item with uri " . $uri . " don't belong to contact " . $importer["id"] . " - ignoring deletion.", Logger::DEBUG);
2652                         return;
2653                 }
2654
2655                 // Comments can be deleted by the thread owner or comment owner
2656                 if (($item['gravity'] != GRAVITY_PARENT) && ($item['contact-id'] != $importer["id"])) {
2657                         $condition = ['id' => $item['parent'], 'contact-id' => $importer["id"]];
2658                         if (!Item::exists($condition)) {
2659                                 Logger::log("Item with uri " . $uri . " wasn't found or mustn't be deleted by contact " . $importer["id"] . " - ignoring deletion.", Logger::DEBUG);
2660                                 return;
2661                         }
2662                 }
2663
2664                 if ($item["deleted"]) {
2665                         return;
2666                 }
2667
2668                 Logger::log('deleting item '.$item['id'].' uri='.$uri, Logger::DEBUG);
2669
2670                 Item::markForDeletion(['id' => $item['id']]);
2671         }
2672
2673         /**
2674          * Imports a DFRN message
2675          *
2676          * @param string $xml          The DFRN message
2677          * @param array  $importer     Record of the importer user mixed with contact of the content
2678          * @param bool   $sort_by_date Is used when feeds are polled
2679          * @return integer Import status
2680          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2681          * @throws \ImagickException
2682          * @todo  set proper type-hints
2683          */
2684         public static function import($xml, $importer, $sort_by_date = false)
2685         {
2686                 if ($xml == "") {
2687                         return 400;
2688                 }
2689
2690                 $doc = new DOMDocument();
2691                 @$doc->loadXML($xml);
2692
2693                 $xpath = new DOMXPath($doc);
2694                 $xpath->registerNamespace("atom", ActivityNamespace::ATOM1);
2695                 $xpath->registerNamespace("thr", ActivityNamespace::THREAD);
2696                 $xpath->registerNamespace("at", ActivityNamespace::TOMB);
2697                 $xpath->registerNamespace("media", ActivityNamespace::MEDIA);
2698                 $xpath->registerNamespace("dfrn", ActivityNamespace::DFRN);
2699                 $xpath->registerNamespace("activity", ActivityNamespace::ACTIVITY);
2700                 $xpath->registerNamespace("georss", ActivityNamespace::GEORSS);
2701                 $xpath->registerNamespace("poco", ActivityNamespace::POCO);
2702                 $xpath->registerNamespace("ostatus", ActivityNamespace::OSTATUS);
2703                 $xpath->registerNamespace("statusnet", ActivityNamespace::STATUSNET);
2704
2705                 $header = [];
2706                 $header["uid"] = $importer["importer_uid"];
2707                 $header["network"] = Protocol::DFRN;
2708                 $header["wall"] = 0;
2709                 $header["origin"] = 0;
2710                 $header["contact-id"] = $importer["id"];
2711
2712                 // Update the contact table if the data has changed
2713
2714                 // The "atom:author" is only present in feeds
2715                 if ($xpath->query("/atom:feed/atom:author")->length > 0) {
2716                         self::fetchauthor($xpath, $doc->firstChild, $importer, "atom:author", false, $xml);
2717                 }
2718
2719                 // Only the "dfrn:owner" in the head section contains all data
2720                 if ($xpath->query("/atom:feed/dfrn:owner")->length > 0) {
2721                         self::fetchauthor($xpath, $doc->firstChild, $importer, "dfrn:owner", false, $xml);
2722                 }
2723
2724                 Logger::log("Import DFRN message for user " . $importer["importer_uid"] . " from contact " . $importer["id"], Logger::DEBUG);
2725
2726                 // is it a public forum? Private forums aren't exposed with this method
2727                 $forum = intval(XML::getFirstNodeValue($xpath, "/atom:feed/dfrn:community/text()"));
2728
2729                 // The account type is new since 3.5.1
2730                 if ($xpath->query("/atom:feed/dfrn:account_type")->length > 0) {
2731                         // Hint: We are using separate update calls for uid=0 and uid!=0 since a combined call is bad for the database performance
2732
2733                         $accounttype = intval(XML::getFirstNodeValue($xpath, "/atom:feed/dfrn:account_type/text()"));
2734
2735                         if ($accounttype != $importer["contact-type"]) {
2736                                 DBA::update('contact', ['contact-type' => $accounttype], ['id' => $importer['id']]);
2737
2738                                 // Updating the public contact as well
2739                                 DBA::update('contact', ['contact-type' => $accounttype], ['uid' => 0, 'nurl' => $importer['nurl']]);
2740                         }
2741                         // A forum contact can either have set "forum" or "prv" - but not both
2742                         if ($accounttype == User::ACCOUNT_TYPE_COMMUNITY) {
2743                                 // It's a forum, so either set the public or private forum flag
2744                                 $condition = ['(`forum` != ? OR `prv` != ?) AND `id` = ?', $forum, !$forum, $importer['id']];
2745                                 DBA::update('contact', ['forum' => $forum, 'prv' => !$forum], $condition);
2746
2747                                 // Updating the public contact as well
2748                                 $condition = ['(`forum` != ? OR `prv` != ?) AND `uid` = 0 AND `nurl` = ?', $forum, !$forum, $importer['nurl']];
2749                                 DBA::update('contact', ['forum' => $forum, 'prv' => !$forum], $condition);
2750                         } else {
2751                                 // It's not a forum, so remove the flags
2752                                 $condition = ['(`forum` OR `prv`) AND `id` = ?', $importer['id']];
2753                                 DBA::update('contact', ['forum' => false, 'prv' => false], $condition);
2754
2755                                 // Updating the public contact as well
2756                                 $condition = ['(`forum` OR `prv`) AND `uid` = 0 AND `nurl` = ?', $importer['nurl']];
2757                                 DBA::update('contact', ['forum' => false, 'prv' => false], $condition);
2758                         }
2759                 } elseif ($forum != $importer["forum"]) { // Deprecated since 3.5.1
2760                         $condition = ['`forum` != ? AND `id` = ?', $forum, $importer["id"]];
2761                         DBA::update('contact', ['forum' => $forum], $condition);
2762
2763                         // Updating the public contact as well
2764                         $condition = ['`forum` != ? AND `uid` = 0 AND `nurl` = ?', $forum, $importer['nurl']];
2765                         DBA::update('contact', ['forum' => $forum], $condition);
2766                 }
2767
2768
2769                 // We are processing relocations even if we are ignoring a contact
2770                 $relocations = $xpath->query("/atom:feed/dfrn:relocate");
2771                 foreach ($relocations as $relocation) {
2772                         self::processRelocation($xpath, $relocation, $importer);
2773                 }
2774
2775                 if (($importer["uid"] != 0) && !$importer["readonly"]) {
2776                         $mails = $xpath->query("/atom:feed/dfrn:mail");
2777                         foreach ($mails as $mail) {
2778                                 self::processMail($xpath, $mail, $importer);
2779                         }
2780
2781                         $suggestions = $xpath->query("/atom:feed/dfrn:suggest");
2782                         foreach ($suggestions as $suggestion) {
2783                                 self::processSuggestion($xpath, $suggestion, $importer);
2784                         }
2785                 }
2786
2787                 $deletions = $xpath->query("/atom:feed/at:deleted-entry");
2788                 foreach ($deletions as $deletion) {
2789                         self::processDeletion($xpath, $deletion, $importer);
2790                 }
2791
2792                 if (!$sort_by_date) {
2793                         $entries = $xpath->query("/atom:feed/atom:entry");
2794                         foreach ($entries as $entry) {
2795                                 self::processEntry($header, $xpath, $entry, $importer, $xml);
2796                         }
2797                 } else {
2798                         $newentries = [];
2799                         $entries = $xpath->query("/atom:feed/atom:entry");
2800                         foreach ($entries as $entry) {
2801                                 $created = XML::getFirstNodeValue($xpath, "atom:published/text()", $entry);
2802                                 $newentries[strtotime($created)] = $entry;
2803                         }
2804
2805                         // Now sort after the publishing date
2806                         ksort($newentries);
2807
2808                         foreach ($newentries as $entry) {
2809                                 self::processEntry($header, $xpath, $entry, $importer, $xml);
2810                         }
2811                 }
2812                 Logger::log("Import done for user " . $importer["importer_uid"] . " from contact " . $importer["id"], Logger::DEBUG);
2813                 return 200;
2814         }
2815
2816         /**
2817          * Returns the activity verb
2818          *
2819          * @param array $item Item array
2820          *
2821          * @return string activity verb
2822          */
2823         private static function constructVerb(array $item)
2824         {
2825                 if ($item['verb']) {
2826                         return $item['verb'];
2827                 }
2828                 return Activity::POST;
2829         }
2830
2831         private static function tgroupCheck($uid, $item)
2832         {
2833                 $mention = false;
2834
2835                 // check that the message originated elsewhere and is a top-level post
2836
2837                 if ($item['wall'] || $item['origin'] || ($item['uri'] != $item['parent-uri'])) {
2838                         return false;
2839                 }
2840
2841                 $user = DBA::selectFirst('user', ['page-flags', 'nickname'], ['uid' => $uid]);
2842                 if (!DBA::isResult($user)) {
2843                         return false;
2844                 }
2845
2846                 $community_page = ($user['page-flags'] == User::PAGE_FLAGS_COMMUNITY);
2847                 $prvgroup = ($user['page-flags'] == User::PAGE_FLAGS_PRVGROUP);
2848
2849                 $link = Strings::normaliseLink(DI::baseUrl() . '/profile/' . $user['nickname']);
2850
2851                 /*
2852                  * Diaspora uses their own hardwired link URL in @-tags
2853                  * instead of the one we supply with webfinger
2854                  */
2855                 $dlink = Strings::normaliseLink(DI::baseUrl() . '/u/' . $user['nickname']);
2856
2857                 $cnt = preg_match_all('/[\@\!]\[url\=(.*?)\](.*?)\[\/url\]/ism', $item['body'], $matches, PREG_SET_ORDER);
2858                 if ($cnt) {
2859                         foreach ($matches as $mtch) {
2860                                 if (Strings::compareLink($link, $mtch[1]) || Strings::compareLink($dlink, $mtch[1])) {
2861                                         $mention = true;
2862                                         Logger::log('mention found: ' . $mtch[2]);
2863                                 }
2864                         }
2865                 }
2866
2867                 if (!$mention) {
2868                         return false;
2869                 }
2870
2871                 return $community_page || $prvgroup;
2872         }
2873
2874         /**
2875          * This function returns true if $update has an edited timestamp newer
2876          * than $existing, i.e. $update contains new data which should override
2877          * what's already there.  If there is no timestamp yet, the update is
2878          * assumed to be newer.  If the update has no timestamp, the existing
2879          * item is assumed to be up-to-date.  If the timestamps are equal it
2880          * assumes the update has been seen before and should be ignored.
2881          *
2882          * @param $existing
2883          * @param $update
2884          * @return bool
2885          * @throws \Exception
2886          */
2887         private static function isEditedTimestampNewer($existing, $update)
2888         {
2889                 if (empty($existing['edited'])) {
2890                         return true;
2891                 }
2892                 if (empty($update['edited'])) {
2893                         return false;
2894                 }
2895
2896                 $existing_edited = DateTimeFormat::utc($existing['edited']);
2897                 $update_edited = DateTimeFormat::utc($update['edited']);
2898
2899                 return (strcmp($existing_edited, $update_edited) < 0);
2900         }
2901
2902         /**
2903          * Checks if the given contact url does support DFRN
2904          *
2905          * @param string  $url    profile url
2906          * @param boolean $update Update the profile
2907          * @return boolean
2908          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
2909          * @throws \ImagickException
2910          */
2911         public static function isSupportedByContactUrl($url, $update = false)
2912         {
2913                 $probe = Probe::uri($url, Protocol::DFRN, 0, !$update);
2914                 return $probe['network'] == Protocol::DFRN;
2915         }
2916 }