]> git.mxchange.org Git - friendica.git/blob - src/Model/Item.php
Add 'addon' folder as 'Friendica\Addon' namespace for autoload
[friendica.git] / src / Model / Item.php
1 <?php
2
3 /**
4  * @file src/Model/Item.php
5  */
6
7 namespace Friendica\Model;
8
9 use Friendica\BaseObject;
10 use Friendica\Content\Text\BBCode;
11 use Friendica\Content\Text\HTML;
12 use Friendica\Core\Addon;
13 use Friendica\Core\Config;
14 use Friendica\Core\Lock;
15 use Friendica\Core\Logger;
16 use Friendica\Core\L10n;
17 use Friendica\Core\PConfig;
18 use Friendica\Core\Protocol;
19 use Friendica\Core\Renderer;
20 use Friendica\Core\System;
21 use Friendica\Core\Worker;
22 use Friendica\Database\DBA;
23 use Friendica\Model\Contact;
24 use Friendica\Model\Event;
25 use Friendica\Model\FileTag;
26 use Friendica\Model\PermissionSet;
27 use Friendica\Model\Term;
28 use Friendica\Model\ItemURI;
29 use Friendica\Object\Image;
30 use Friendica\Protocol\Diaspora;
31 use Friendica\Protocol\OStatus;
32 use Friendica\Util\DateTimeFormat;
33 use Friendica\Util\Map;
34 use Friendica\Util\XML;
35 use Friendica\Util\Security;
36 use Friendica\Util\Strings;
37 use Text_LanguageDetect;
38
39 class Item extends BaseObject
40 {
41         // Posting types, inspired by https://www.w3.org/TR/activitystreams-vocabulary/#object-types
42         const PT_ARTICLE = 0;
43         const PT_NOTE = 1;
44         const PT_PAGE = 2;
45         const PT_IMAGE = 16;
46         const PT_AUDIO = 17;
47         const PT_VIDEO = 18;
48         const PT_DOCUMENT = 19;
49         const PT_EVENT = 32;
50         const PT_PERSONAL_NOTE = 128;
51
52         // Field list that is used to display the items
53         const DISPLAY_FIELDLIST = ['uid', 'id', 'parent', 'uri', 'thr-parent', 'parent-uri', 'guid', 'network',
54                         'commented', 'created', 'edited', 'received', 'verb', 'object-type', 'postopts', 'plink',
55                         'wall', 'private', 'starred', 'origin', 'title', 'body', 'file', 'attach', 'language',
56                         'content-warning', 'location', 'coord', 'app', 'rendered-hash', 'rendered-html', 'object',
57                         'allow_cid', 'allow_gid', 'deny_cid', 'deny_gid', 'item_id',
58                         'author-id', 'author-link', 'author-name', 'author-avatar', 'author-network',
59                         'owner-id', 'owner-link', 'owner-name', 'owner-avatar', 'owner-network',
60                         'contact-id', 'contact-link', 'contact-name', 'contact-avatar',
61                         'writable', 'self', 'cid', 'alias',
62                         'event-id', 'event-created', 'event-edited', 'event-start', 'event-finish',
63                         'event-summary', 'event-desc', 'event-location', 'event-type',
64                         'event-nofinish', 'event-adjust', 'event-ignore', 'event-id'];
65
66         // Field list that is used to deliver items via the protocols
67         const DELIVER_FIELDLIST = ['uid', 'id', 'parent', 'uri', 'thr-parent', 'parent-uri', 'guid',
68                         'created', 'edited', 'verb', 'object-type', 'object', 'target',
69                         'private', 'title', 'body', 'location', 'coord', 'app',
70                         'attach', 'tag', 'deleted', 'extid', 'post-type',
71                         'allow_cid', 'allow_gid', 'deny_cid', 'deny_gid',
72                         'author-id', 'author-link', 'owner-link', 'contact-uid',
73                         'signed_text', 'signature', 'signer', 'network'];
74
75         // Field list for "item-content" table that is mixed with the item table
76         const MIXED_CONTENT_FIELDLIST = ['title', 'content-warning', 'body', 'location',
77                         'coord', 'app', 'rendered-hash', 'rendered-html', 'verb',
78                         'object-type', 'object', 'target-type', 'target', 'plink'];
79
80         // Field list for "item-content" table that is not present in the "item" table
81         const CONTENT_FIELDLIST = ['language'];
82
83         // Field list for additional delivery data
84         const DELIVERY_DATA_FIELDLIST = ['postopts', 'inform'];
85
86         // All fields in the item table
87         const ITEM_FIELDLIST = ['id', 'uid', 'parent', 'uri', 'parent-uri', 'thr-parent', 'guid',
88                         'contact-id', 'type', 'wall', 'gravity', 'extid', 'icid', 'iaid', 'psid',
89                         'created', 'edited', 'commented', 'received', 'changed', 'verb',
90                         'postopts', 'plink', 'resource-id', 'event-id', 'tag', 'attach', 'inform',
91                         'file', 'allow_cid', 'allow_gid', 'deny_cid', 'deny_gid', 'post-type',
92                         'private', 'pubmail', 'moderated', 'visible', 'starred', 'bookmark',
93                         'unseen', 'deleted', 'origin', 'forum_mode', 'mention', 'global', 'network',
94                         'title', 'content-warning', 'body', 'location', 'coord', 'app',
95                         'rendered-hash', 'rendered-html', 'object-type', 'object', 'target-type', 'target',
96                         'author-id', 'author-link', 'author-name', 'author-avatar',
97                         'owner-id', 'owner-link', 'owner-name', 'owner-avatar'];
98
99         // Never reorder or remove entries from this list. Just add new ones at the end, if needed.
100         // The item-activity table only stores the index and needs this array to know the matching activity.
101         const ACTIVITIES = [ACTIVITY_LIKE, ACTIVITY_DISLIKE, ACTIVITY_ATTEND, ACTIVITY_ATTENDNO, ACTIVITY_ATTENDMAYBE];
102
103         private static $legacy_mode = null;
104
105         public static function isLegacyMode()
106         {
107                 if (is_null(self::$legacy_mode)) {
108                         self::$legacy_mode = (Config::get("system", "post_update_version") < 1279);
109                 }
110
111                 return self::$legacy_mode;
112         }
113
114         /**
115          * @brief returns an activity index from an activity string
116          *
117          * @param string $activity activity string
118          * @return integer Activity index
119          */
120         public static function activityToIndex($activity)
121         {
122                 $index = array_search($activity, self::ACTIVITIES);
123
124                 if (is_bool($index)) {
125                         $index = -1;
126                 }
127
128                 return $index;
129         }
130
131         /**
132          * @brief returns an activity string from an activity index
133          *
134          * @param integer $index activity index
135          * @return string Activity string
136          */
137         private static function indexToActivity($index)
138         {
139                 if (is_null($index) || !array_key_exists($index, self::ACTIVITIES)) {
140                         return '';
141                 }
142
143                 return self::ACTIVITIES[$index];
144         }
145
146         /**
147          * @brief Fetch a single item row
148          *
149          * @param mixed $stmt statement object
150          * @return array current row
151          */
152         public static function fetch($stmt)
153         {
154                 $row = DBA::fetch($stmt);
155
156                 if (is_bool($row)) {
157                         return $row;
158                 }
159
160                 // ---------------------- Transform item structure data ----------------------
161
162                 // We prefer the data from the user's contact over the public one
163                 if (!empty($row['author-link']) && !empty($row['contact-link']) &&
164                         ($row['author-link'] == $row['contact-link'])) {
165                         if (isset($row['author-avatar']) && !empty($row['contact-avatar'])) {
166                                 $row['author-avatar'] = $row['contact-avatar'];
167                         }
168                         if (isset($row['author-name']) && !empty($row['contact-name'])) {
169                                 $row['author-name'] = $row['contact-name'];
170                         }
171                 }
172
173                 if (!empty($row['owner-link']) && !empty($row['contact-link']) &&
174                         ($row['owner-link'] == $row['contact-link'])) {
175                         if (isset($row['owner-avatar']) && !empty($row['contact-avatar'])) {
176                                 $row['owner-avatar'] = $row['contact-avatar'];
177                         }
178                         if (isset($row['owner-name']) && !empty($row['contact-name'])) {
179                                 $row['owner-name'] = $row['contact-name'];
180                         }
181                 }
182
183                 // We can always comment on posts from these networks
184                 if (array_key_exists('writable', $row) &&
185                         in_array($row['internal-network'], [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::DIASPORA, Protocol::OSTATUS])) {
186                         $row['writable'] = true;
187                 }
188
189                 // ---------------------- Transform item content data ----------------------
190
191                 // Fetch data from the item-content table whenever there is content there
192                 if (self::isLegacyMode()) {
193                         $legacy_fields = array_merge(self::DELIVERY_DATA_FIELDLIST, self::MIXED_CONTENT_FIELDLIST);
194                         foreach ($legacy_fields as $field) {
195                                 if (empty($row[$field]) && !empty($row['internal-item-' . $field])) {
196                                         $row[$field] = $row['internal-item-' . $field];
197                                 }
198                                 unset($row['internal-item-' . $field]);
199                         }
200                 }
201
202                 if (!empty($row['internal-iaid']) && array_key_exists('verb', $row)) {
203                         $row['verb'] = self::indexToActivity($row['internal-activity']);
204                         if (array_key_exists('title', $row)) {
205                                 $row['title'] = '';
206                         }
207                         if (array_key_exists('body', $row)) {
208                                 $row['body'] = $row['verb'];
209                         }
210                         if (array_key_exists('object', $row)) {
211                                 $row['object'] = '';
212                         }
213                         if (array_key_exists('object-type', $row)) {
214                                 $row['object-type'] = ACTIVITY_OBJ_NOTE;
215                         }
216                 } elseif (array_key_exists('verb', $row) && in_array($row['verb'], ['', ACTIVITY_POST, ACTIVITY_SHARE])) {
217                         // Posts don't have an object or target - but having tags or files.
218                         // We safe some performance by building tag and file strings only here.
219                         // We remove object and target since they aren't used for this type.
220                         if (array_key_exists('object', $row)) {
221                                 $row['object'] = '';
222                         }
223                         if (array_key_exists('target', $row)) {
224                                 $row['target'] = '';
225                         }
226                 }
227
228                 if (!array_key_exists('verb', $row) || in_array($row['verb'], ['', ACTIVITY_POST, ACTIVITY_SHARE])) {
229                         // Build the tag string out of the term entries
230                         if (array_key_exists('tag', $row) && empty($row['tag'])) {
231                                 $row['tag'] = Term::tagTextFromItemId($row['internal-iid']);
232                         }
233
234                         // Build the file string out of the term entries
235                         if (array_key_exists('file', $row) && empty($row['file'])) {
236                                 $row['file'] = Term::fileTextFromItemId($row['internal-iid']);
237                         }
238                 }
239
240                 if (array_key_exists('signed_text', $row) && array_key_exists('interaction', $row) && !is_null($row['interaction'])) {
241                         $row['signed_text'] = $row['interaction'];
242                 }
243
244                 if (array_key_exists('ignored', $row) && array_key_exists('internal-user-ignored', $row) && !is_null($row['internal-user-ignored'])) {
245                         $row['ignored'] = $row['internal-user-ignored'];
246                 }
247
248                 // Remove internal fields
249                 unset($row['internal-activity']);
250                 unset($row['internal-network']);
251                 unset($row['internal-iid']);
252                 unset($row['internal-iaid']);
253                 unset($row['internal-icid']);
254                 unset($row['internal-user-ignored']);
255                 unset($row['interaction']);
256
257                 return $row;
258         }
259
260         /**
261          * @brief Fills an array with data from an item query
262          *
263          * @param object $stmt statement object
264          * @return array Data array
265          */
266         public static function inArray($stmt, $do_close = true) {
267                 if (is_bool($stmt)) {
268                         return $stmt;
269                 }
270
271                 $data = [];
272                 while ($row = self::fetch($stmt)) {
273                         $data[] = $row;
274                 }
275                 if ($do_close) {
276                         DBA::close($stmt);
277                 }
278                 return $data;
279         }
280
281         /**
282          * @brief Check if item data exists
283          *
284          * @param array $condition array of fields for condition
285          *
286          * @return boolean Are there rows for that condition?
287          */
288         public static function exists($condition) {
289                 $stmt = self::select(['id'], $condition, ['limit' => 1]);
290
291                 if (is_bool($stmt)) {
292                         $retval = $stmt;
293                 } else {
294                         $retval = (DBA::numRows($stmt) > 0);
295                 }
296
297                 DBA::close($stmt);
298
299                 return $retval;
300         }
301
302         /**
303          * Retrieve a single record from the item table for a given user and returns it in an associative array
304          *
305          * @brief Retrieve a single record from a table
306          * @param integer $uid User ID
307          * @param array  $fields
308          * @param array  $condition
309          * @param array  $params
310          * @return bool|array
311          * @see DBA::select
312          */
313         public static function selectFirstForUser($uid, array $selected = [], array $condition = [], $params = [])
314         {
315                 $params['uid'] = $uid;
316
317                 if (empty($selected)) {
318                         $selected = Item::DISPLAY_FIELDLIST;
319                 }
320
321                 return self::selectFirst($selected, $condition, $params);
322         }
323
324         /**
325          * @brief Select rows from the item table for a given user
326          *
327          * @param integer $uid User ID
328          * @param array  $selected  Array of selected fields, empty for all
329          * @param array  $condition Array of fields for condition
330          * @param array  $params    Array of several parameters
331          *
332          * @return boolean|object
333          */
334         public static function selectForUser($uid, array $selected = [], array $condition = [], $params = [])
335         {
336                 $params['uid'] = $uid;
337
338                 if (empty($selected)) {
339                         $selected = Item::DISPLAY_FIELDLIST;
340                 }
341
342                 return self::select($selected, $condition, $params);
343         }
344
345         /**
346          * Retrieve a single record from the item table and returns it in an associative array
347          *
348          * @brief Retrieve a single record from a table
349          * @param array  $fields
350          * @param array  $condition
351          * @param array  $params
352          * @return bool|array
353          * @see DBA::select
354          */
355         public static function selectFirst(array $fields = [], array $condition = [], $params = [])
356         {
357                 $params['limit'] = 1;
358
359                 $result = self::select($fields, $condition, $params);
360
361                 if (is_bool($result)) {
362                         return $result;
363                 } else {
364                         $row = self::fetch($result);
365                         DBA::close($result);
366                         return $row;
367                 }
368         }
369
370         /**
371          * @brief Select rows from the item table
372          *
373          * @param array  $selected  Array of selected fields, empty for all
374          * @param array  $condition Array of fields for condition
375          * @param array  $params    Array of several parameters
376          *
377          * @return boolean|object
378          */
379         public static function select(array $selected = [], array $condition = [], $params = [])
380         {
381                 $uid = 0;
382                 $usermode = false;
383
384                 if (isset($params['uid'])) {
385                         $uid = $params['uid'];
386                         $usermode = true;
387                 }
388
389                 $fields = self::fieldlist($usermode);
390
391                 $select_fields = self::constructSelectFields($fields, $selected);
392
393                 $condition_string = DBA::buildCondition($condition);
394
395                 $condition_string = self::addTablesToFields($condition_string, $fields);
396
397                 if ($usermode) {
398                         $condition_string = $condition_string . ' AND ' . self::condition(false);
399                 }
400
401                 $param_string = self::addTablesToFields(DBA::buildParameter($params), $fields);
402
403                 $table = "`item` " . self::constructJoins($uid, $select_fields . $condition_string . $param_string, false, $usermode);
404
405                 $sql = "SELECT " . $select_fields . " FROM " . $table . $condition_string . $param_string;
406
407                 return DBA::p($sql, $condition);
408         }
409
410         /**
411          * @brief Select rows from the starting post in the item table
412          *
413          * @param integer $uid User ID
414          * @param array  $fields    Array of selected fields, empty for all
415          * @param array  $condition Array of fields for condition
416          * @param array  $params    Array of several parameters
417          *
418          * @return boolean|object
419          */
420         public static function selectThreadForUser($uid, array $selected = [], array $condition = [], $params = [])
421         {
422                 $params['uid'] = $uid;
423
424                 if (empty($selected)) {
425                         $selected = Item::DISPLAY_FIELDLIST;
426                 }
427
428                 return self::selectThread($selected, $condition, $params);
429         }
430
431         /**
432          * Retrieve a single record from the starting post in the item table and returns it in an associative array
433          *
434          * @brief Retrieve a single record from a table
435          * @param integer $uid User ID
436          * @param array  $selected
437          * @param array  $condition
438          * @param array  $params
439          * @return bool|array
440          * @see DBA::select
441          */
442         public static function selectFirstThreadForUser($uid, array $selected = [], array $condition = [], $params = [])
443         {
444                 $params['uid'] = $uid;
445
446                 if (empty($selected)) {
447                         $selected = Item::DISPLAY_FIELDLIST;
448                 }
449
450                 return self::selectFirstThread($selected, $condition, $params);
451         }
452
453         /**
454          * Retrieve a single record from the starting post in the item table and returns it in an associative array
455          *
456          * @brief Retrieve a single record from a table
457          * @param array  $fields
458          * @param array  $condition
459          * @param array  $params
460          * @return bool|array
461          * @see DBA::select
462          */
463         public static function selectFirstThread(array $fields = [], array $condition = [], $params = [])
464         {
465                 $params['limit'] = 1;
466                 $result = self::selectThread($fields, $condition, $params);
467
468                 if (is_bool($result)) {
469                         return $result;
470                 } else {
471                         $row = self::fetch($result);
472                         DBA::close($result);
473                         return $row;
474                 }
475         }
476
477         /**
478          * @brief Select rows from the starting post in the item table
479          *
480          * @param array  $selected  Array of selected fields, empty for all
481          * @param array  $condition Array of fields for condition
482          * @param array  $params    Array of several parameters
483          *
484          * @return boolean|object
485          */
486         public static function selectThread(array $selected = [], array $condition = [], $params = [])
487         {
488                 $uid = 0;
489                 $usermode = false;
490
491                 if (isset($params['uid'])) {
492                         $uid = $params['uid'];
493                         $usermode = true;
494                 }
495
496                 $fields = self::fieldlist($usermode);
497
498                 $fields['thread'] = ['mention', 'ignored', 'iid'];
499
500                 $threadfields = ['thread' => ['iid', 'uid', 'contact-id', 'owner-id', 'author-id',
501                         'created', 'edited', 'commented', 'received', 'changed', 'wall', 'private',
502                         'pubmail', 'moderated', 'visible', 'starred', 'ignored', 'post-type',
503                         'unseen', 'deleted', 'origin', 'forum_mode', 'mention', 'network']];
504
505                 $select_fields = self::constructSelectFields($fields, $selected);
506
507                 $condition_string = DBA::buildCondition($condition);
508
509                 $condition_string = self::addTablesToFields($condition_string, $threadfields);
510                 $condition_string = self::addTablesToFields($condition_string, $fields);
511
512                 if ($usermode) {
513                         $condition_string = $condition_string . ' AND ' . self::condition(true);
514                 }
515
516                 $param_string = DBA::buildParameter($params);
517                 $param_string = self::addTablesToFields($param_string, $threadfields);
518                 $param_string = self::addTablesToFields($param_string, $fields);
519
520                 $table = "`thread` " . self::constructJoins($uid, $select_fields . $condition_string . $param_string, true, $usermode);
521
522                 $sql = "SELECT " . $select_fields . " FROM " . $table . $condition_string . $param_string;
523
524                 return DBA::p($sql, $condition);
525         }
526
527         /**
528          * @brief Returns a list of fields that are associated with the item table
529          *
530          * @return array field list
531          */
532         private static function fieldlist($usermode)
533         {
534                 $fields = [];
535
536                 $fields['item'] = ['id', 'uid', 'parent', 'uri', 'parent-uri', 'thr-parent', 'guid',
537                         'contact-id', 'owner-id', 'author-id', 'type', 'wall', 'gravity', 'extid',
538                         'created', 'edited', 'commented', 'received', 'changed', 'psid',
539                         'resource-id', 'event-id', 'tag', 'attach', 'post-type', 'file',
540                         'private', 'pubmail', 'moderated', 'visible', 'starred', 'bookmark',
541                         'unseen', 'deleted', 'origin', 'forum_mode', 'mention', 'global',
542                         'id' => 'item_id', 'network', 'icid', 'iaid', 'id' => 'internal-iid',
543                         'network' => 'internal-network', 'icid' => 'internal-icid',
544                         'iaid' => 'internal-iaid'];
545
546                 if ($usermode) {
547                         $fields['user-item'] = ['ignored' => 'internal-user-ignored'];
548                 }
549
550                 $fields['item-activity'] = ['activity', 'activity' => 'internal-activity'];
551
552                 $fields['item-content'] = array_merge(self::CONTENT_FIELDLIST, self::MIXED_CONTENT_FIELDLIST);
553
554                 $fields['item-delivery-data'] = self::DELIVERY_DATA_FIELDLIST;
555
556                 $fields['permissionset'] = ['allow_cid', 'allow_gid', 'deny_cid', 'deny_gid'];
557
558                 $fields['author'] = ['url' => 'author-link', 'name' => 'author-name',
559                         'thumb' => 'author-avatar', 'nick' => 'author-nick', 'network' => 'author-network'];
560
561                 $fields['owner'] = ['url' => 'owner-link', 'name' => 'owner-name',
562                         'thumb' => 'owner-avatar', 'nick' => 'owner-nick', 'network' => 'owner-network'];
563
564                 $fields['contact'] = ['url' => 'contact-link', 'name' => 'contact-name', 'thumb' => 'contact-avatar',
565                         'writable', 'self', 'id' => 'cid', 'alias', 'uid' => 'contact-uid',
566                         'photo', 'name-date', 'uri-date', 'avatar-date', 'thumb', 'dfrn-id'];
567
568                 $fields['parent-item'] = ['guid' => 'parent-guid', 'network' => 'parent-network'];
569
570                 $fields['parent-item-author'] = ['url' => 'parent-author-link', 'name' => 'parent-author-name'];
571
572                 $fields['event'] = ['created' => 'event-created', 'edited' => 'event-edited',
573                         'start' => 'event-start','finish' => 'event-finish',
574                         'summary' => 'event-summary','desc' => 'event-desc',
575                         'location' => 'event-location', 'type' => 'event-type',
576                         'nofinish' => 'event-nofinish','adjust' => 'event-adjust',
577                         'ignore' => 'event-ignore', 'id' => 'event-id'];
578
579                 $fields['sign'] = ['signed_text', 'signature', 'signer'];
580
581                 $fields['diaspora-interaction'] = ['interaction'];
582
583                 return $fields;
584         }
585
586         /**
587          * @brief Returns SQL condition for the "select" functions
588          *
589          * @param boolean $thread_mode Called for the items (false) or for the threads (true)
590          *
591          * @return string SQL condition
592          */
593         private static function condition($thread_mode)
594         {
595                 if ($thread_mode) {
596                         $master_table = "`thread`";
597                 } else {
598                         $master_table = "`item`";
599                 }
600                 return sprintf("$master_table.`visible` AND NOT $master_table.`deleted` AND NOT $master_table.`moderated`
601                         AND (`user-item`.`hidden` IS NULL OR NOT `user-item`.`hidden`)
602                         AND (`user-author`.`blocked` IS NULL OR NOT `user-author`.`blocked`)
603                         AND (`user-author`.`ignored` IS NULL OR NOT `user-author`.`ignored` OR `item`.`gravity` != %d)
604                         AND (`user-owner`.`blocked` IS NULL OR NOT `user-owner`.`blocked`)
605                         AND (`user-owner`.`ignored` IS NULL OR NOT `user-owner`.`ignored` OR `item`.`gravity` != %d) ",
606                         GRAVITY_PARENT, GRAVITY_PARENT);
607         }
608
609         /**
610          * @brief Returns all needed "JOIN" commands for the "select" functions
611          *
612          * @param integer $uid User ID
613          * @param string $sql_commands The parts of the built SQL commands in the "select" functions
614          * @param boolean $thread_mode Called for the items (false) or for the threads (true)
615          *
616          * @return string The SQL joins for the "select" functions
617          */
618         private static function constructJoins($uid, $sql_commands, $thread_mode, $user_mode)
619         {
620                 if ($thread_mode) {
621                         $master_table = "`thread`";
622                         $master_table_key = "`thread`.`iid`";
623                         $joins = "STRAIGHT_JOIN `item` ON `item`.`id` = `thread`.`iid` ";
624                 } else {
625                         $master_table = "`item`";
626                         $master_table_key = "`item`.`id`";
627                         $joins = '';
628                 }
629
630                 if ($user_mode) {
631                         $joins .= sprintf("STRAIGHT_JOIN `contact` ON `contact`.`id` = $master_table.`contact-id`
632                                 AND NOT `contact`.`blocked`
633                                 AND ((NOT `contact`.`readonly` AND NOT `contact`.`pending` AND (`contact`.`rel` IN (%s, %s)))
634                                 OR `contact`.`self` OR `item`.`gravity` != %d OR `contact`.`uid` = 0)
635                                 STRAIGHT_JOIN `contact` AS `author` ON `author`.`id` = $master_table.`author-id` AND NOT `author`.`blocked`
636                                 STRAIGHT_JOIN `contact` AS `owner` ON `owner`.`id` = $master_table.`owner-id` AND NOT `owner`.`blocked`
637                                 LEFT JOIN `user-item` ON `user-item`.`iid` = $master_table_key AND `user-item`.`uid` = %d
638                                 LEFT JOIN `user-contact` AS `user-author` ON `user-author`.`cid` = $master_table.`author-id` AND `user-author`.`uid` = %d
639                                 LEFT JOIN `user-contact` AS `user-owner` ON `user-owner`.`cid` = $master_table.`owner-id` AND `user-owner`.`uid` = %d",
640                                 Contact::SHARING, Contact::FRIEND, GRAVITY_PARENT, intval($uid), intval($uid), intval($uid));
641                 } else {
642                         if (strpos($sql_commands, "`contact`.") !== false) {
643                                 $joins .= "LEFT JOIN `contact` ON `contact`.`id` = $master_table.`contact-id`";
644                         }
645                         if (strpos($sql_commands, "`author`.") !== false) {
646                                 $joins .= " LEFT JOIN `contact` AS `author` ON `author`.`id` = $master_table.`author-id`";
647                         }
648                         if (strpos($sql_commands, "`owner`.") !== false) {
649                                 $joins .= " LEFT JOIN `contact` AS `owner` ON `owner`.`id` = $master_table.`owner-id`";
650                         }
651                 }
652
653                 if (strpos($sql_commands, "`group_member`.") !== false) {
654                         $joins .= " STRAIGHT_JOIN `group_member` ON `group_member`.`contact-id` = $master_table.`contact-id`";
655                 }
656
657                 if (strpos($sql_commands, "`user`.") !== false) {
658                         $joins .= " STRAIGHT_JOIN `user` ON `user`.`uid` = $master_table.`uid`";
659                 }
660
661                 if (strpos($sql_commands, "`event`.") !== false) {
662                         $joins .= " LEFT JOIN `event` ON `event-id` = `event`.`id`";
663                 }
664
665                 if (strpos($sql_commands, "`sign`.") !== false) {
666                         $joins .= " LEFT JOIN `sign` ON `sign`.`iid` = `item`.`id`";
667                 }
668
669                 if (strpos($sql_commands, "`diaspora-interaction`.") !== false) {
670                         $joins .= " LEFT JOIN `diaspora-interaction` ON `diaspora-interaction`.`uri-id` = `item`.`uri-id`";
671                 }
672
673                 if (strpos($sql_commands, "`item-activity`.") !== false) {
674                         $joins .= " LEFT JOIN `item-activity` ON `item-activity`.`uri-id` = `item`.`uri-id`";
675                 }
676
677                 if (strpos($sql_commands, "`item-content`.") !== false) {
678                         $joins .= " LEFT JOIN `item-content` ON `item-content`.`uri-id` = `item`.`uri-id`";
679                 }
680
681                 if (strpos($sql_commands, "`item-delivery-data`.") !== false) {
682                         $joins .= " LEFT JOIN `item-delivery-data` ON `item-delivery-data`.`iid` = `item`.`id`";
683                 }
684
685                 if (strpos($sql_commands, "`permissionset`.") !== false) {
686                         $joins .= " LEFT JOIN `permissionset` ON `permissionset`.`id` = `item`.`psid`";
687                 }
688
689                 if ((strpos($sql_commands, "`parent-item`.") !== false) || (strpos($sql_commands, "`parent-author`.") !== false)) {
690                         $joins .= " STRAIGHT_JOIN `item` AS `parent-item` ON `parent-item`.`id` = `item`.`parent`";
691                 }
692
693                 if (strpos($sql_commands, "`parent-item-author`.") !== false) {
694                         $joins .= " STRAIGHT_JOIN `contact` AS `parent-item-author` ON `parent-item-author`.`id` = `parent-item`.`author-id`";
695                 }
696
697                 return $joins;
698         }
699
700         /**
701          * @brief Add the field list for the "select" functions
702          *
703          * @param array $fields The field definition array
704          * @param array $selected The array with the selected fields from the "select" functions
705          *
706          * @return string The field list
707          */
708         private static function constructSelectFields($fields, $selected)
709         {
710                 if (!empty($selected)) {
711                         $selected[] = 'internal-iid';
712                         $selected[] = 'internal-iaid';
713                         $selected[] = 'internal-icid';
714                         $selected[] = 'internal-network';
715                 }
716
717                 if (in_array('verb', $selected)) {
718                         $selected[] = 'internal-activity';
719                 }
720
721                 if (in_array('ignored', $selected)) {
722                         $selected[] = 'internal-user-ignored';
723                 }
724
725                 if (in_array('signed_text', $selected)) {
726                         $selected[] = 'interaction';
727                 }
728
729                 $selection = [];
730                 foreach ($fields as $table => $table_fields) {
731                         foreach ($table_fields as $field => $select) {
732                                 if (empty($selected) || in_array($select, $selected)) {
733                                         $legacy_fields = array_merge(self::DELIVERY_DATA_FIELDLIST, self::MIXED_CONTENT_FIELDLIST);
734                                         if (self::isLegacyMode() && in_array($select, $legacy_fields)) {
735                                                 $selection[] = "`item`.`".$select."` AS `internal-item-" . $select . "`";
736                                         }
737                                         if (is_int($field)) {
738                                                 $selection[] = "`" . $table . "`.`" . $select . "`";
739                                         } else {
740                                                 $selection[] = "`" . $table . "`.`" . $field . "` AS `" . $select . "`";
741                                         }
742                                 }
743                         }
744                 }
745                 return implode(", ", $selection);
746         }
747
748         /**
749          * @brief add table definition to fields in an SQL query
750          *
751          * @param string $query SQL query
752          * @param array $fields The field definition array
753          *
754          * @return string the changed SQL query
755          */
756         private static function addTablesToFields($query, $fields)
757         {
758                 foreach ($fields as $table => $table_fields) {
759                         foreach ($table_fields as $alias => $field) {
760                                 if (is_int($alias)) {
761                                         $replace_field = $field;
762                                 } else {
763                                         $replace_field = $alias;
764                                 }
765
766                                 $search = "/([^\.])`" . $field . "`/i";
767                                 $replace = "$1`" . $table . "`.`" . $replace_field . "`";
768                                 $query = preg_replace($search, $replace, $query);
769                         }
770                 }
771                 return $query;
772         }
773
774         /**
775          * @brief Update existing item entries
776          *
777          * @param array $fields The fields that are to be changed
778          * @param array $condition The condition for finding the item entries
779          *
780          * In the future we may have to change permissions as well.
781          * Then we had to add the user id as third parameter.
782          *
783          * A return value of "0" doesn't mean an error - but that 0 rows had been changed.
784          *
785          * @return integer|boolean number of affected rows - or "false" if there was an error
786          */
787         public static function update(array $fields, array $condition)
788         {
789                 if (empty($condition) || empty($fields)) {
790                         return false;
791                 }
792
793                 // To ensure the data integrity we do it in an transaction
794                 DBA::transaction();
795
796                 // We cannot simply expand the condition to check for origin entries
797                 // The condition needn't to be a simple array but could be a complex condition.
798                 // And we have to execute this query before the update to ensure to fetch the same data.
799                 $items = DBA::select('item', ['id', 'origin', 'uri', 'uri-id', 'iaid', 'icid', 'tag', 'file'], $condition);
800
801                 $content_fields = [];
802                 foreach (array_merge(self::CONTENT_FIELDLIST, self::MIXED_CONTENT_FIELDLIST) as $field) {
803                         if (isset($fields[$field])) {
804                                 $content_fields[$field] = $fields[$field];
805                                 if (in_array($field, self::CONTENT_FIELDLIST) || !self::isLegacyMode()) {
806                                         unset($fields[$field]);
807                                 } else {
808                                         $fields[$field] = null;
809                                 }
810                         }
811                 }
812
813                 $clear_fields = ['bookmark', 'type', 'author-name', 'author-avatar', 'author-link', 'owner-name', 'owner-avatar', 'owner-link'];
814                 foreach ($clear_fields as $field) {
815                         if (array_key_exists($field, $fields)) {
816                                 $fields[$field] = null;
817                         }
818                 }
819
820                 if (array_key_exists('tag', $fields)) {
821                         $tags = $fields['tag'];
822                         $fields['tag'] = null;
823                 } else {
824                         $tags = null;
825                 }
826
827                 if (array_key_exists('file', $fields)) {
828                         $files = $fields['file'];
829                         $fields['file'] = null;
830                 } else {
831                         $files = null;
832                 }
833
834                 $delivery_data = ['postopts' => defaults($fields, 'postopts', ''),
835                         'inform' => defaults($fields, 'inform', '')];
836
837                 $fields['postopts'] = null;
838                 $fields['inform'] = null;
839
840                 if (!empty($fields)) {
841                         $success = DBA::update('item', $fields, $condition);
842
843                         if (!$success) {
844                                 DBA::close($items);
845                                 DBA::rollback();
846                                 return false;
847                         }
848                 }
849
850                 // When there is no content for the "old" item table, this will count the fetched items
851                 $rows = DBA::affectedRows();
852
853                 while ($item = DBA::fetch($items)) {
854                         if (!empty($item['iaid']) || (!empty($content_fields['verb']) && (self::activityToIndex($content_fields['verb']) >= 0))) {
855                                 self::updateActivity($content_fields, ['uri-id' => $item['uri-id']]);
856
857                                 if (empty($item['iaid'])) {
858                                         $item_activity = DBA::selectFirst('item-activity', ['id'], ['uri-id' => $item['uri-id']]);
859                                         if (DBA::isResult($item_activity)) {
860                                                 $item_fields = ['iaid' => $item_activity['id'], 'icid' => null];
861                                                 foreach (self::MIXED_CONTENT_FIELDLIST as $field) {
862                                                         if (self::isLegacyMode()) {
863                                                                 $item_fields[$field] = null;
864                                                         } else {
865                                                                 unset($item_fields[$field]);
866                                                         }
867                                                 }
868                                                 DBA::update('item', $item_fields, ['id' => $item['id']]);
869
870                                                 if (!empty($item['icid']) && !DBA::exists('item', ['icid' => $item['icid']])) {
871                                                         DBA::delete('item-content', ['id' => $item['icid']]);
872                                                 }
873                                         }
874                                 } elseif (!empty($item['icid'])) {
875                                         DBA::update('item', ['icid' => null], ['id' => $item['id']]);
876
877                                         if (!DBA::exists('item', ['icid' => $item['icid']])) {
878                                                 DBA::delete('item-content', ['id' => $item['icid']]);
879                                         }
880                                 }
881                         } else {
882                                 self::updateContent($content_fields, ['uri-id' => $item['uri-id']]);
883
884                                 if (empty($item['icid'])) {
885                                         $item_content = DBA::selectFirst('item-content', [], ['uri-id' => $item['uri-id']]);
886                                         if (DBA::isResult($item_content)) {
887                                                 $item_fields = ['icid' => $item_content['id']];
888                                                 // Clear all fields in the item table that have a content in the item-content table
889                                                 foreach ($item_content as $field => $content) {
890                                                         if (in_array($field, self::MIXED_CONTENT_FIELDLIST) && !empty($item_content[$field])) {
891                                                                 if (self::isLegacyMode()) {
892                                                                         $item_fields[$field] = null;
893                                                                 } else {
894                                                                         unset($item_fields[$field]);
895                                                                 }
896                                                         }
897                                                 }
898                                                 DBA::update('item', $item_fields, ['id' => $item['id']]);
899                                         }
900                                 }
901                         }
902
903                         if (!is_null($tags)) {
904                                 Term::insertFromTagFieldByItemId($item['id'], $tags);
905                                 if (!empty($item['tag'])) {
906                                         DBA::update('item', ['tag' => ''], ['id' => $item['id']]);
907                                 }
908                         }
909
910                         if (!is_null($files)) {
911                                 Term::insertFromFileFieldByItemId($item['id'], $files);
912                                 if (!empty($item['file'])) {
913                                         DBA::update('item', ['file' => ''], ['id' => $item['id']]);
914                                 }
915                         }
916
917                         self::updateDeliveryData($item['id'], $delivery_data);
918
919                         self::updateThread($item['id']);
920
921                         // We only need to notfiy others when it is an original entry from us.
922                         // Only call the notifier when the item has some content relevant change.
923                         if ($item['origin'] && in_array('edited', array_keys($fields))) {
924                                 Worker::add(PRIORITY_HIGH, "Notifier", 'edit_post', $item['id']);
925                         }
926                 }
927
928                 DBA::close($items);
929                 DBA::commit();
930                 return $rows;
931         }
932
933         /**
934          * @brief Delete an item and notify others about it - if it was ours
935          *
936          * @param array $condition The condition for finding the item entries
937          * @param integer $priority Priority for the notification
938          */
939         public static function delete($condition, $priority = PRIORITY_HIGH)
940         {
941                 $items = self::select(['id'], $condition);
942                 while ($item = self::fetch($items)) {
943                         self::deleteById($item['id'], $priority);
944                 }
945                 DBA::close($items);
946         }
947
948         /**
949          * @brief Delete an item for an user and notify others about it - if it was ours
950          *
951          * @param array $condition The condition for finding the item entries
952          * @param integer $uid User who wants to delete this item
953          */
954         public static function deleteForUser($condition, $uid)
955         {
956                 if ($uid == 0) {
957                         return;
958                 }
959
960                 $items = self::select(['id', 'uid'], $condition);
961                 while ($item = self::fetch($items)) {
962                         // "Deleting" global items just means hiding them
963                         if ($item['uid'] == 0) {
964                                 DBA::update('user-item', ['hidden' => true], ['iid' => $item['id'], 'uid' => $uid], true);
965                         } elseif ($item['uid'] == $uid) {
966                                 self::deleteById($item['id'], PRIORITY_HIGH);
967                         } else {
968                                 Logger::log('Wrong ownership. Not deleting item ' . $item['id']);
969                         }
970                 }
971                 DBA::close($items);
972         }
973
974         /**
975          * @brief Delete an item and notify others about it - if it was ours
976          *
977          * @param integer $item_id Item ID that should be delete
978          * @param integer $priority Priority for the notification
979          *
980          * @return boolean success
981          */
982         public static function deleteById($item_id, $priority = PRIORITY_HIGH)
983         {
984                 // locate item to be deleted
985                 $fields = ['id', 'uri', 'uid', 'parent', 'parent-uri', 'origin',
986                         'deleted', 'file', 'resource-id', 'event-id', 'attach',
987                         'verb', 'object-type', 'object', 'target', 'contact-id',
988                         'icid', 'iaid', 'psid'];
989                 $item = self::selectFirst($fields, ['id' => $item_id]);
990                 if (!DBA::isResult($item)) {
991                         Logger::log('Item with ID ' . $item_id . " hasn't been found.", Logger::DEBUG);
992                         return false;
993                 }
994
995                 if ($item['deleted']) {
996                         Logger::log('Item with ID ' . $item_id . ' has already been deleted.', Logger::DEBUG);
997                         return false;
998                 }
999
1000                 $parent = self::selectFirst(['origin'], ['id' => $item['parent']]);
1001                 if (!DBA::isResult($parent)) {
1002                         $parent = ['origin' => false];
1003                 }
1004
1005                 // clean up categories and tags so they don't end up as orphans
1006
1007                 $matches = false;
1008                 $cnt = preg_match_all('/<(.*?)>/', $item['file'], $matches, PREG_SET_ORDER);
1009
1010                 if ($cnt) {
1011                         foreach ($matches as $mtch) {
1012                                 FileTag::unsaveFile($item['uid'], $item['id'], $mtch[1],true);
1013                         }
1014                 }
1015
1016                 $matches = false;
1017
1018                 $cnt = preg_match_all('/\[(.*?)\]/', $item['file'], $matches, PREG_SET_ORDER);
1019
1020                 if ($cnt) {
1021                         foreach ($matches as $mtch) {
1022                                 FileTag::unsaveFile($item['uid'], $item['id'], $mtch[1],false);
1023                         }
1024                 }
1025
1026                 /*
1027                  * If item is a link to a photo resource, nuke all the associated photos
1028                  * (visitors will not have photo resources)
1029                  * This only applies to photos uploaded from the photos page. Photos inserted into a post do not
1030                  * generate a resource-id and therefore aren't intimately linked to the item.
1031                  */
1032                 if (strlen($item['resource-id'])) {
1033                         DBA::delete('photo', ['resource-id' => $item['resource-id'], 'uid' => $item['uid']]);
1034                 }
1035
1036                 // If item is a link to an event, delete the event.
1037                 if (intval($item['event-id'])) {
1038                         Event::delete($item['event-id']);
1039                 }
1040
1041                 // If item has attachments, drop them
1042                 foreach (explode(", ", $item['attach']) as $attach) {
1043                         preg_match("|attach/(\d+)|", $attach, $matches);
1044                         if (is_array($matches) && count($matches) > 1) {
1045                                 DBA::delete('attach', ['id' => $matches[1], 'uid' => $item['uid']]);
1046                         }
1047                 }
1048
1049                 // Delete tags that had been attached to other items
1050                 self::deleteTagsFromItem($item);
1051
1052                 // Set the item to "deleted"
1053                 $item_fields = ['deleted' => true, 'edited' => DateTimeFormat::utcNow(), 'changed' => DateTimeFormat::utcNow()];
1054                 DBA::update('item', $item_fields, ['id' => $item['id']]);
1055
1056                 Term::insertFromTagFieldByItemId($item['id'], '');
1057                 Term::insertFromFileFieldByItemId($item['id'], '');
1058                 self::deleteThread($item['id'], $item['parent-uri']);
1059
1060                 if (!self::exists(["`uri` = ? AND `uid` != 0 AND NOT `deleted`", $item['uri']])) {
1061                         self::delete(['uri' => $item['uri'], 'uid' => 0, 'deleted' => false], $priority);
1062                 }
1063
1064                 DBA::delete('item-delivery-data', ['iid' => $item['id']]);
1065
1066                 // We don't delete the item-activity here, since we need some of the data for ActivityPub
1067
1068                 if (!empty($item['icid']) && !self::exists(['icid' => $item['icid'], 'deleted' => false])) {
1069                         DBA::delete('item-content', ['id' => $item['icid']], ['cascade' => false]);
1070                 }
1071                 // When the permission set will be used in photo and events as well,
1072                 // this query here needs to be extended.
1073                 if (!empty($item['psid']) && !self::exists(['psid' => $item['psid'], 'deleted' => false])) {
1074                         DBA::delete('permissionset', ['id' => $item['psid']], ['cascade' => false]);
1075                 }
1076
1077                 // If it's the parent of a comment thread, kill all the kids
1078                 if ($item['id'] == $item['parent']) {
1079                         self::delete(['parent' => $item['parent'], 'deleted' => false], $priority);
1080                 }
1081
1082                 // Is it our comment and/or our thread?
1083                 if ($item['origin'] || $parent['origin']) {
1084
1085                         // When we delete the original post we will delete all existing copies on the server as well
1086                         self::delete(['uri' => $item['uri'], 'deleted' => false], $priority);
1087
1088                         // send the notification upstream/downstream
1089                         Worker::add(['priority' => $priority, 'dont_fork' => true], "Notifier", "drop", intval($item['id']));
1090                 } elseif ($item['uid'] != 0) {
1091
1092                         // When we delete just our local user copy of an item, we have to set a marker to hide it
1093                         $global_item = self::selectFirst(['id'], ['uri' => $item['uri'], 'uid' => 0, 'deleted' => false]);
1094                         if (DBA::isResult($global_item)) {
1095                                 DBA::update('user-item', ['hidden' => true], ['iid' => $global_item['id'], 'uid' => $item['uid']], true);
1096                         }
1097                 }
1098
1099                 Logger::log('Item with ID ' . $item_id . " has been deleted.", Logger::DEBUG);
1100
1101                 return true;
1102         }
1103
1104         private static function deleteTagsFromItem($item)
1105         {
1106                 if (($item["verb"] != ACTIVITY_TAG) || ($item["object-type"] != ACTIVITY_OBJ_TAGTERM)) {
1107                         return;
1108                 }
1109
1110                 $xo = XML::parseString($item["object"], false);
1111                 $xt = XML::parseString($item["target"], false);
1112
1113                 if ($xt->type != ACTIVITY_OBJ_NOTE) {
1114                         return;
1115                 }
1116
1117                 $i = self::selectFirst(['id', 'contact-id', 'tag'], ['uri' => $xt->id, 'uid' => $item['uid']]);
1118                 if (!DBA::isResult($i)) {
1119                         return;
1120                 }
1121
1122                 // For tags, the owner cannot remove the tag on the author's copy of the post.
1123                 $owner_remove = ($item["contact-id"] == $i["contact-id"]);
1124                 $author_copy = $item["origin"];
1125
1126                 if (($owner_remove && $author_copy) || !$owner_remove) {
1127                         return;
1128                 }
1129
1130                 $tags = explode(',', $i["tag"]);
1131                 $newtags = [];
1132                 if (count($tags)) {
1133                         foreach ($tags as $tag) {
1134                                 if (trim($tag) !== trim($xo->body)) {
1135                                        $newtags[] = trim($tag);
1136                                 }
1137                         }
1138                 }
1139                 self::update(['tag' => implode(',', $newtags)], ['id' => $i["id"]]);
1140         }
1141
1142         private static function guid($item, $notify)
1143         {
1144                 if (!empty($item['guid'])) {
1145                         return Strings::escapeTags(trim($item['guid']));
1146                 }
1147
1148                 if ($notify) {
1149                         // We have to avoid duplicates. So we create the GUID in form of a hash of the plink or uri.
1150                         // We add the hash of our own host because our host is the original creator of the post.
1151                         $prefix_host = \get_app()->getHostName();
1152                 } else {
1153                         $prefix_host = '';
1154
1155                         // We are only storing the post so we create a GUID from the original hostname.
1156                         if (!empty($item['author-link'])) {
1157                                 $parsed = parse_url($item['author-link']);
1158                                 if (!empty($parsed['host'])) {
1159                                         $prefix_host = $parsed['host'];
1160                                 }
1161                         }
1162
1163                         if (empty($prefix_host) && !empty($item['plink'])) {
1164                                 $parsed = parse_url($item['plink']);
1165                                 if (!empty($parsed['host'])) {
1166                                         $prefix_host = $parsed['host'];
1167                                 }
1168                         }
1169
1170                         if (empty($prefix_host) && !empty($item['uri'])) {
1171                                 $parsed = parse_url($item['uri']);
1172                                 if (!empty($parsed['host'])) {
1173                                         $prefix_host = $parsed['host'];
1174                                 }
1175                         }
1176
1177                         // Is it in the format data@host.tld? - Used for mail contacts
1178                         if (empty($prefix_host) && !empty($item['author-link']) && strstr($item['author-link'], '@')) {
1179                                 $mailparts = explode('@', $item['author-link']);
1180                                 $prefix_host = array_pop($mailparts);
1181                         }
1182                 }
1183
1184                 if (!empty($item['plink'])) {
1185                         $guid = self::guidFromUri($item['plink'], $prefix_host);
1186                 } elseif (!empty($item['uri'])) {
1187                         $guid = self::guidFromUri($item['uri'], $prefix_host);
1188                 } else {
1189                         $guid = System::createUUID(hash('crc32', $prefix_host));
1190                 }
1191
1192                 return $guid;
1193         }
1194
1195         private static function contactId($item)
1196         {
1197                 $contact_id = (int)$item["contact-id"];
1198
1199                 if (!empty($contact_id)) {
1200                         return $contact_id;
1201                 }
1202                 Logger::log('Missing contact-id. Called by: '.System::callstack(), Logger::DEBUG);
1203                 /*
1204                  * First we are looking for a suitable contact that matches with the author of the post
1205                  * This is done only for comments
1206                  */
1207                 if ($item['parent-uri'] != $item['uri']) {
1208                         $contact_id = Contact::getIdForURL($item['author-link'], $item['uid']);
1209                 }
1210
1211                 // If not present then maybe the owner was found
1212                 if ($contact_id == 0) {
1213                         $contact_id = Contact::getIdForURL($item['owner-link'], $item['uid']);
1214                 }
1215
1216                 // Still missing? Then use the "self" contact of the current user
1217                 if ($contact_id == 0) {
1218                         $self = DBA::selectFirst('contact', ['id'], ['self' => true, 'uid' => $item['uid']]);
1219                         if (DBA::isResult($self)) {
1220                                 $contact_id = $self["id"];
1221                         }
1222                 }
1223                 Logger::log("Contact-id was missing for post ".$item['guid']." from user id ".$item['uid']." - now set to ".$contact_id, Logger::DEBUG);
1224
1225                 return $contact_id;
1226         }
1227
1228         // This function will finally cover most of the preparation functionality in mod/item.php
1229         public static function prepare(&$item)
1230         {
1231                 $data = BBCode::getAttachmentData($item['body']);
1232                 if ((preg_match_all("/\[bookmark\=([^\]]*)\](.*?)\[\/bookmark\]/ism", $item['body'], $match, PREG_SET_ORDER) || isset($data["type"]))
1233                         && ($posttype != Item::PT_PERSONAL_NOTE)) {
1234                         $posttype = Item::PT_PAGE;
1235                         $objecttype = ACTIVITY_OBJ_BOOKMARK;
1236                 }
1237         }
1238
1239         public static function insert($item, $force_parent = false, $notify = false, $dontcache = false)
1240         {
1241                 $a = \get_app();
1242
1243                 // If it is a posting where users should get notifications, then define it as wall posting
1244                 if ($notify) {
1245                         $item['wall'] = 1;
1246                         $item['origin'] = 1;
1247                         $item['network'] = Protocol::DFRN;
1248                         $item['protocol'] = Conversation::PARCEL_DFRN;
1249
1250                         if (is_int($notify)) {
1251                                 $priority = $notify;
1252                         } else {
1253                                 $priority = PRIORITY_HIGH;
1254                         }
1255                 } else {
1256                         $item['network'] = trim(defaults($item, 'network', Protocol::PHANTOM));
1257                 }
1258
1259                 $item['guid'] = self::guid($item, $notify);
1260                 $item['uri'] = Strings::escapeTags(trim(defaults($item, 'uri', self::newURI($item['uid'], $item['guid']))));
1261
1262                 // Store URI data
1263                 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
1264
1265                 // Store conversation data
1266                 $item = Conversation::insert($item);
1267
1268                 /*
1269                  * If a Diaspora signature structure was passed in, pull it out of the
1270                  * item array and set it aside for later storage.
1271                  */
1272
1273                 $dsprsig = null;
1274                 if (isset($item['dsprsig'])) {
1275                         $encoded_signature = $item['dsprsig'];
1276                         $dsprsig = json_decode(base64_decode($item['dsprsig']));
1277                         unset($item['dsprsig']);
1278                 }
1279
1280                 $diaspora_signed_text = '';
1281                 if (isset($item['diaspora_signed_text'])) {
1282                         $diaspora_signed_text = $item['diaspora_signed_text'];
1283                         unset($item['diaspora_signed_text']);
1284                 }
1285
1286                 // Converting the plink
1287                 /// @TODO Check if this is really still needed
1288                 if ($item['network'] == Protocol::OSTATUS) {
1289                         if (isset($item['plink'])) {
1290                                 $item['plink'] = OStatus::convertHref($item['plink']);
1291                         } elseif (isset($item['uri'])) {
1292                                 $item['plink'] = OStatus::convertHref($item['uri']);
1293                         }
1294                 }
1295
1296                 if (!empty($item['thr-parent'])) {
1297                         $item['parent-uri'] = $item['thr-parent'];
1298                 }
1299
1300                 if (isset($item['gravity'])) {
1301                         $item['gravity'] = intval($item['gravity']);
1302                 } elseif ($item['parent-uri'] === $item['uri']) {
1303                         $item['gravity'] = GRAVITY_PARENT;
1304                 } elseif (activity_match($item['verb'], ACTIVITY_POST)) {
1305                         $item['gravity'] = GRAVITY_COMMENT;
1306                 } else {
1307                         $item['gravity'] = GRAVITY_UNKNOWN;   // Should not happen
1308                         Logger::log('Unknown gravity for verb: ' . $item['verb'], Logger::DEBUG);
1309                 }
1310
1311                 $uid = intval($item['uid']);
1312
1313                 // check for create date and expire time
1314                 $expire_interval = Config::get('system', 'dbclean-expire-days', 0);
1315
1316                 $user = DBA::selectFirst('user', ['expire'], ['uid' => $uid]);
1317                 if (DBA::isResult($user) && ($user['expire'] > 0) && (($user['expire'] < $expire_interval) || ($expire_interval == 0))) {
1318                         $expire_interval = $user['expire'];
1319                 }
1320
1321                 if (($expire_interval > 0) && !empty($item['created'])) {
1322                         $expire_date = time() - ($expire_interval * 86400);
1323                         $created_date = strtotime($item['created']);
1324                         if ($created_date < $expire_date) {
1325                                 Logger::log('item-store: item created ('.date('c', $created_date).') before expiration time ('.date('c', $expire_date).'). ignored. ' . print_r($item,true), Logger::DEBUG);
1326                                 return 0;
1327                         }
1328                 }
1329
1330                 /*
1331                  * Do we already have this item?
1332                  * We have to check several networks since Friendica posts could be repeated
1333                  * via OStatus (maybe Diasporsa as well)
1334                  */
1335                 if (in_array($item['network'], [Protocol::ACTIVITYPUB, Protocol::DIASPORA, Protocol::DFRN, Protocol::OSTATUS, ""])) {
1336                         $condition = ["`uri` = ? AND `uid` = ? AND `network` IN (?, ?, ?)",
1337                                 trim($item['uri']), $item['uid'],
1338                                 Protocol::DIASPORA, Protocol::DFRN, Protocol::OSTATUS];
1339                         $existing = self::selectFirst(['id', 'network'], $condition);
1340                         if (DBA::isResult($existing)) {
1341                                 // We only log the entries with a different user id than 0. Otherwise we would have too many false positives
1342                                 if ($uid != 0) {
1343                                         Logger::log("Item with uri ".$item['uri']." already existed for user ".$uid." with id ".$existing["id"]." target network ".$existing["network"]." - new network: ".$item['network']);
1344                                 }
1345
1346                                 return $existing["id"];
1347                         }
1348                 }
1349
1350                 $item['wall']          = intval(defaults($item, 'wall', 0));
1351                 $item['extid']         = trim(defaults($item, 'extid', ''));
1352                 $item['author-name']   = trim(defaults($item, 'author-name', ''));
1353                 $item['author-link']   = trim(defaults($item, 'author-link', ''));
1354                 $item['author-avatar'] = trim(defaults($item, 'author-avatar', ''));
1355                 $item['owner-name']    = trim(defaults($item, 'owner-name', ''));
1356                 $item['owner-link']    = trim(defaults($item, 'owner-link', ''));
1357                 $item['owner-avatar']  = trim(defaults($item, 'owner-avatar', ''));
1358                 $item['received']      = (isset($item['received'])  ? DateTimeFormat::utc($item['received'])  : DateTimeFormat::utcNow());
1359                 $item['created']       = (isset($item['created'])   ? DateTimeFormat::utc($item['created'])   : $item['received']);
1360                 $item['edited']        = (isset($item['edited'])    ? DateTimeFormat::utc($item['edited'])    : $item['created']);
1361                 $item['changed']       = (isset($item['changed'])   ? DateTimeFormat::utc($item['changed'])   : $item['created']);
1362                 $item['commented']     = (isset($item['commented']) ? DateTimeFormat::utc($item['commented']) : $item['created']);
1363                 $item['title']         = trim(defaults($item, 'title', ''));
1364                 $item['location']      = trim(defaults($item, 'location', ''));
1365                 $item['coord']         = trim(defaults($item, 'coord', ''));
1366                 $item['visible']       = (isset($item['visible']) ? intval($item['visible']) : 1);
1367                 $item['deleted']       = 0;
1368                 $item['parent-uri']    = trim(defaults($item, 'parent-uri', $item['uri']));
1369                 $item['post-type']     = defaults($item, 'post-type', self::PT_ARTICLE);
1370                 $item['verb']          = trim(defaults($item, 'verb', ''));
1371                 $item['object-type']   = trim(defaults($item, 'object-type', ''));
1372                 $item['object']        = trim(defaults($item, 'object', ''));
1373                 $item['target-type']   = trim(defaults($item, 'target-type', ''));
1374                 $item['target']        = trim(defaults($item, 'target', ''));
1375                 $item['plink']         = trim(defaults($item, 'plink', ''));
1376                 $item['allow_cid']     = trim(defaults($item, 'allow_cid', ''));
1377                 $item['allow_gid']     = trim(defaults($item, 'allow_gid', ''));
1378                 $item['deny_cid']      = trim(defaults($item, 'deny_cid', ''));
1379                 $item['deny_gid']      = trim(defaults($item, 'deny_gid', ''));
1380                 $item['private']       = intval(defaults($item, 'private', 0));
1381                 $item['body']          = trim(defaults($item, 'body', ''));
1382                 $item['tag']           = trim(defaults($item, 'tag', ''));
1383                 $item['attach']        = trim(defaults($item, 'attach', ''));
1384                 $item['app']           = trim(defaults($item, 'app', ''));
1385                 $item['origin']        = intval(defaults($item, 'origin', 0));
1386                 $item['postopts']      = trim(defaults($item, 'postopts', ''));
1387                 $item['resource-id']   = trim(defaults($item, 'resource-id', ''));
1388                 $item['event-id']      = intval(defaults($item, 'event-id', 0));
1389                 $item['inform']        = trim(defaults($item, 'inform', ''));
1390                 $item['file']          = trim(defaults($item, 'file', ''));
1391
1392                 // When there is no content then we don't post it
1393                 if ($item['body'].$item['title'] == '') {
1394                         Logger::log('No body, no title.');
1395                         return 0;
1396                 }
1397
1398                 self::addLanguageToItemArray($item);
1399
1400                 // Items cannot be stored before they happen ...
1401                 if ($item['created'] > DateTimeFormat::utcNow()) {
1402                         $item['created'] = DateTimeFormat::utcNow();
1403                 }
1404
1405                 // We haven't invented time travel by now.
1406                 if ($item['edited'] > DateTimeFormat::utcNow()) {
1407                         $item['edited'] = DateTimeFormat::utcNow();
1408                 }
1409
1410                 $item['plink'] = defaults($item, 'plink', System::baseUrl() . '/display/' . urlencode($item['guid']));
1411
1412                 // The contact-id should be set before "self::insert" was called - but there seems to be issues sometimes
1413                 $item["contact-id"] = self::contactId($item);
1414
1415                 $default = ['url' => $item['author-link'], 'name' => $item['author-name'],
1416                         'photo' => $item['author-avatar'], 'network' => $item['network']];
1417
1418                 $item['author-id'] = defaults($item, 'author-id', Contact::getIdForURL($item["author-link"], 0, false, $default));
1419
1420                 if (Contact::isBlocked($item["author-id"])) {
1421                         Logger::log('Contact '.$item["author-id"].' is blocked, item '.$item["uri"].' will not be stored');
1422                         return 0;
1423                 }
1424
1425                 $default = ['url' => $item['owner-link'], 'name' => $item['owner-name'],
1426                         'photo' => $item['owner-avatar'], 'network' => $item['network']];
1427
1428                 $item['owner-id'] = defaults($item, 'owner-id', Contact::getIdForURL($item["owner-link"], 0, false, $default));
1429
1430                 if (Contact::isBlocked($item["owner-id"])) {
1431                         Logger::log('Contact '.$item["owner-id"].' is blocked, item '.$item["uri"].' will not be stored');
1432                         return 0;
1433                 }
1434
1435                 if ($item['network'] == Protocol::PHANTOM) {
1436                         Logger::log('Missing network. Called by: '.System::callstack(), Logger::DEBUG);
1437
1438                         $item['network'] = Protocol::DFRN;
1439                         Logger::log("Set network to " . $item["network"] . " for " . $item["uri"], Logger::DEBUG);
1440                 }
1441
1442                 // Checking if there is already an item with the same guid
1443                 Logger::log('Checking for an item for user '.$item['uid'].' on network '.$item['network'].' with the guid '.$item['guid'], Logger::DEBUG);
1444                 $condition = ['guid' => $item['guid'], 'network' => $item['network'], 'uid' => $item['uid']];
1445                 if (self::exists($condition)) {
1446                         Logger::log('found item with guid '.$item['guid'].' for user '.$item['uid'].' on network '.$item['network'], Logger::DEBUG);
1447                         return 0;
1448                 }
1449
1450                 // Check for hashtags in the body and repair or add hashtag links
1451                 self::setHashtags($item);
1452
1453                 $item['thr-parent'] = $item['parent-uri'];
1454
1455                 $notify_type = '';
1456                 $allow_cid = '';
1457                 $allow_gid = '';
1458                 $deny_cid  = '';
1459                 $deny_gid  = '';
1460
1461                 if ($item['parent-uri'] === $item['uri']) {
1462                         $parent_id = 0;
1463                         $parent_deleted = 0;
1464                         $allow_cid = $item['allow_cid'];
1465                         $allow_gid = $item['allow_gid'];
1466                         $deny_cid  = $item['deny_cid'];
1467                         $deny_gid  = $item['deny_gid'];
1468                         $notify_type = 'wall-new';
1469                 } else {
1470                         // find the parent and snarf the item id and ACLs
1471                         // and anything else we need to inherit
1472
1473                         $fields = ['uri', 'parent-uri', 'id', 'deleted',
1474                                 'allow_cid', 'allow_gid', 'deny_cid', 'deny_gid',
1475                                 'wall', 'private', 'forum_mode', 'origin'];
1476                         $condition = ['uri' => $item['parent-uri'], 'uid' => $item['uid']];
1477                         $params = ['order' => ['id' => false]];
1478                         $parent = self::selectFirst($fields, $condition, $params);
1479
1480                         if (DBA::isResult($parent)) {
1481                                 // is the new message multi-level threaded?
1482                                 // even though we don't support it now, preserve the info
1483                                 // and re-attach to the conversation parent.
1484
1485                                 if ($parent['uri'] != $parent['parent-uri']) {
1486                                         $item['parent-uri'] = $parent['parent-uri'];
1487
1488                                         $condition = ['uri' => $item['parent-uri'],
1489                                                 'parent-uri' => $item['parent-uri'],
1490                                                 'uid' => $item['uid']];
1491                                         $params = ['order' => ['id' => false]];
1492                                         $toplevel_parent = self::selectFirst($fields, $condition, $params);
1493
1494                                         if (DBA::isResult($toplevel_parent)) {
1495                                                 $parent = $toplevel_parent;
1496                                         }
1497                                 }
1498
1499                                 $parent_id      = $parent['id'];
1500                                 $parent_deleted = $parent['deleted'];
1501                                 $allow_cid      = $parent['allow_cid'];
1502                                 $allow_gid      = $parent['allow_gid'];
1503                                 $deny_cid       = $parent['deny_cid'];
1504                                 $deny_gid       = $parent['deny_gid'];
1505                                 $item['wall']    = $parent['wall'];
1506                                 $notify_type    = 'comment-new';
1507
1508                                 /*
1509                                  * If the parent is private, force privacy for the entire conversation
1510                                  * This differs from the above settings as it subtly allows comments from
1511                                  * email correspondents to be private even if the overall thread is not.
1512                                  */
1513                                 if ($parent['private']) {
1514                                         $item['private'] = $parent['private'];
1515                                 }
1516
1517                                 /*
1518                                  * Edge case. We host a public forum that was originally posted to privately.
1519                                  * The original author commented, but as this is a comment, the permissions
1520                                  * weren't fixed up so it will still show the comment as private unless we fix it here.
1521                                  */
1522                                 if ((intval($parent['forum_mode']) == 1) && $parent['private']) {
1523                                         $item['private'] = 0;
1524                                 }
1525
1526                                 // If its a post from myself then tag the thread as "mention"
1527                                 Logger::log("Checking if parent ".$parent_id." has to be tagged as mention for user ".$item['uid'], Logger::DEBUG);
1528                                 $user = DBA::selectFirst('user', ['nickname'], ['uid' => $item['uid']]);
1529                                 if (DBA::isResult($user)) {
1530                                         $self = Strings::normaliseLink(System::baseUrl() . '/profile/' . $user['nickname']);
1531                                         $self_id = Contact::getIdForURL($self, 0, true);
1532                                         Logger::log("'myself' is ".$self_id." for parent ".$parent_id." checking against ".$item['author-id']." and ".$item['owner-id'], Logger::DEBUG);
1533                                         if (($item['author-id'] == $self_id) || ($item['owner-id'] == $self_id)) {
1534                                                 DBA::update('thread', ['mention' => true], ['iid' => $parent_id]);
1535                                                 Logger::log("tagged thread ".$parent_id." as mention for user ".$self, Logger::DEBUG);
1536                                         }
1537                                 }
1538                         } else {
1539                                 /*
1540                                  * Allow one to see reply tweets from status.net even when
1541                                  * we don't have or can't see the original post.
1542                                  */
1543                                 if ($force_parent) {
1544                                         Logger::log('$force_parent=true, reply converted to top-level post.');
1545                                         $parent_id = 0;
1546                                         $item['parent-uri'] = $item['uri'];
1547                                         $item['gravity'] = GRAVITY_PARENT;
1548                                 } else {
1549                                         Logger::log('item parent '.$item['parent-uri'].' for '.$item['uid'].' was not found - ignoring item');
1550                                         return 0;
1551                                 }
1552
1553                                 $parent_deleted = 0;
1554                         }
1555                 }
1556
1557                 $item['parent-uri-id'] = ItemURI::getIdByURI($item['parent-uri']);
1558                 $item['thr-parent-id'] = ItemURI::getIdByURI($item['thr-parent']);
1559
1560                 $condition = ["`uri` = ? AND `network` IN (?, ?) AND `uid` = ?",
1561                         $item['uri'], $item['network'], Protocol::DFRN, $item['uid']];
1562                 if (self::exists($condition)) {
1563                         Logger::log('duplicated item with the same uri found. '.print_r($item,true));
1564                         return 0;
1565                 }
1566
1567                 // On Friendica and Diaspora the GUID is unique
1568                 if (in_array($item['network'], [Protocol::DFRN, Protocol::DIASPORA])) {
1569                         $condition = ['guid' => $item['guid'], 'uid' => $item['uid']];
1570                         if (self::exists($condition)) {
1571                                 Logger::log('duplicated item with the same guid found. '.print_r($item,true));
1572                                 return 0;
1573                         }
1574                 } else {
1575                         // Check for an existing post with the same content. There seems to be a problem with OStatus.
1576                         $condition = ["`body` = ? AND `network` = ? AND `created` = ? AND `contact-id` = ? AND `uid` = ?",
1577                                         $item['body'], $item['network'], $item['created'], $item['contact-id'], $item['uid']];
1578                         if (self::exists($condition)) {
1579                                 Logger::log('duplicated item with the same body found. '.print_r($item,true));
1580                                 return 0;
1581                         }
1582                 }
1583
1584                 // Is this item available in the global items (with uid=0)?
1585                 if ($item["uid"] == 0) {
1586                         $item["global"] = true;
1587
1588                         // Set the global flag on all items if this was a global item entry
1589                         self::update(['global' => true], ['uri' => $item["uri"]]);
1590                 } else {
1591                         $item["global"] = self::exists(['uid' => 0, 'uri' => $item["uri"]]);
1592                 }
1593
1594                 // ACL settings
1595                 if (strlen($allow_cid) || strlen($allow_gid) || strlen($deny_cid) || strlen($deny_gid)) {
1596                         $private = 1;
1597                 } else {
1598                         $private = $item['private'];
1599                 }
1600
1601                 $item["allow_cid"] = $allow_cid;
1602                 $item["allow_gid"] = $allow_gid;
1603                 $item["deny_cid"] = $deny_cid;
1604                 $item["deny_gid"] = $deny_gid;
1605                 $item["private"] = $private;
1606                 $item["deleted"] = $parent_deleted;
1607
1608                 // Fill the cache field
1609                 self::putInCache($item);
1610
1611                 if ($notify) {
1612                         $item['edit'] = false;
1613                         $item['parent'] = $parent_id;
1614                         Addon::callHooks('post_local', $item);
1615                         unset($item['edit']);
1616                         unset($item['parent']);
1617                 } else {
1618                         Addon::callHooks('post_remote', $item);
1619                 }
1620
1621                 // This array field is used to trigger some automatic reactions
1622                 // It is mainly used in the "post_local" hook.
1623                 unset($item['api_source']);
1624
1625                 if (!empty($item['cancel'])) {
1626                         Logger::log('post cancelled by addon.');
1627                         return 0;
1628                 }
1629
1630                 /*
1631                  * Check for already added items.
1632                  * There is a timing issue here that sometimes creates double postings.
1633                  * An unique index would help - but the limitations of MySQL (maximum size of index values) prevent this.
1634                  */
1635                 if ($item["uid"] == 0) {
1636                         if (self::exists(['uri' => trim($item['uri']), 'uid' => 0])) {
1637                                 Logger::log('Global item already stored. URI: '.$item['uri'].' on network '.$item['network'], Logger::DEBUG);
1638                                 return 0;
1639                         }
1640                 }
1641
1642                 Logger::log('' . print_r($item,true), Logger::DATA);
1643
1644                 if (array_key_exists('tag', $item)) {
1645                         $tags = $item['tag'];
1646                         unset($item['tag']);
1647                 } else {
1648                         $tags = '';
1649                 }
1650
1651                 if (array_key_exists('file', $item)) {
1652                         $files = $item['file'];
1653                         unset($item['file']);
1654                 } else {
1655                         $files = '';
1656                 }
1657
1658                 // Creates or assigns the permission set
1659                 $item['psid'] = PermissionSet::fetchIDForPost($item);
1660
1661                 // We are doing this outside of the transaction to avoid timing problems
1662                 if (!self::insertActivity($item)) {
1663                         self::insertContent($item);
1664                 }
1665
1666                 $delivery_data = ['postopts' => defaults($item, 'postopts', ''),
1667                         'inform' => defaults($item, 'inform', '')];
1668
1669                 unset($item['postopts']);
1670                 unset($item['inform']);
1671
1672                 // These fields aren't stored anymore in the item table, they are fetched upon request
1673                 unset($item['author-link']);
1674                 unset($item['author-name']);
1675                 unset($item['author-avatar']);
1676
1677                 unset($item['owner-link']);
1678                 unset($item['owner-name']);
1679                 unset($item['owner-avatar']);
1680
1681                 DBA::transaction();
1682                 $ret = DBA::insert('item', $item);
1683
1684                 // When the item was successfully stored we fetch the ID of the item.
1685                 if (DBA::isResult($ret)) {
1686                         $current_post = DBA::lastInsertId();
1687                 } else {
1688                         // This can happen - for example - if there are locking timeouts.
1689                         DBA::rollback();
1690
1691                         // Store the data into a spool file so that we can try again later.
1692
1693                         // At first we restore the Diaspora signature that we removed above.
1694                         if (isset($encoded_signature)) {
1695                                 $item['dsprsig'] = $encoded_signature;
1696                         }
1697
1698                         // Now we store the data in the spool directory
1699                         // We use "microtime" to keep the arrival order and "mt_rand" to avoid duplicates
1700                         $file = 'item-'.round(microtime(true) * 10000).'-'.mt_rand().'.msg';
1701
1702                         $spoolpath = get_spoolpath();
1703                         if ($spoolpath != "") {
1704                                 $spool = $spoolpath.'/'.$file;
1705
1706                                 // Ensure to have the removed data from above again in the item array
1707                                 $item = array_merge($item, $delivery_data);
1708
1709                                 file_put_contents($spool, json_encode($item));
1710                                 Logger::log("Item wasn't stored - Item was spooled into file ".$file, Logger::DEBUG);
1711                         }
1712                         return 0;
1713                 }
1714
1715                 if ($current_post == 0) {
1716                         // This is one of these error messages that never should occur.
1717                         Logger::log("couldn't find created item - we better quit now.");
1718                         DBA::rollback();
1719                         return 0;
1720                 }
1721
1722                 // How much entries have we created?
1723                 // We wouldn't need this query when we could use an unique index - but MySQL has length problems with them.
1724                 $entries = DBA::count('item', ['uri' => $item['uri'], 'uid' => $item['uid'], 'network' => $item['network']]);
1725
1726                 if ($entries > 1) {
1727                         // There are duplicates. We delete our just created entry.
1728                         Logger::log('Duplicated post occurred. uri = ' . $item['uri'] . ' uid = ' . $item['uid']);
1729
1730                         // Yes, we could do a rollback here - but we are having many users with MyISAM.
1731                         DBA::delete('item', ['id' => $current_post]);
1732                         DBA::commit();
1733                         return 0;
1734                 } elseif ($entries == 0) {
1735                         // This really should never happen since we quit earlier if there were problems.
1736                         Logger::log("Something is terribly wrong. We haven't found our created entry.");
1737                         DBA::rollback();
1738                         return 0;
1739                 }
1740
1741                 Logger::log('created item '.$current_post);
1742                 self::updateContact($item);
1743
1744                 if (!$parent_id || ($item['parent-uri'] === $item['uri'])) {
1745                         $parent_id = $current_post;
1746                 }
1747
1748                 // Set parent id
1749                 self::update(['parent' => $parent_id], ['id' => $current_post]);
1750
1751                 $item['id'] = $current_post;
1752                 $item['parent'] = $parent_id;
1753
1754                 // update the commented timestamp on the parent
1755                 // Only update "commented" if it is really a comment
1756                 if (($item['gravity'] != GRAVITY_ACTIVITY) || !Config::get("system", "like_no_comment")) {
1757                         self::update(['commented' => DateTimeFormat::utcNow(), 'changed' => DateTimeFormat::utcNow()], ['id' => $parent_id]);
1758                 } else {
1759                         self::update(['changed' => DateTimeFormat::utcNow()], ['id' => $parent_id]);
1760                 }
1761
1762                 if ($dsprsig) {
1763                         /*
1764                          * Friendica servers lower than 3.4.3-2 had double encoded the signature ...
1765                          * We can check for this condition when we decode and encode the stuff again.
1766                          */
1767                         if (base64_encode(base64_decode(base64_decode($dsprsig->signature))) == base64_decode($dsprsig->signature)) {
1768                                 $dsprsig->signature = base64_decode($dsprsig->signature);
1769                                 Logger::log("Repaired double encoded signature from handle ".$dsprsig->signer, Logger::DEBUG);
1770                         }
1771
1772                         if (!empty($dsprsig->signed_text) && empty($dsprsig->signature) && empty($dsprsig->signer)) {
1773                                 DBA::insert('diaspora-interaction', ['uri-id' => $item['uri-id'], 'interaction' => $dsprsig->signed_text], true);
1774                         } else {
1775                                 // The other fields are used by very old Friendica servers, so we currently store them differently
1776                                 DBA::insert('sign', ['iid' => $current_post, 'signed_text' => $dsprsig->signed_text,
1777                                         'signature' => $dsprsig->signature, 'signer' => $dsprsig->signer]);
1778                         }
1779                 }
1780
1781                 if (!empty($diaspora_signed_text)) {
1782                         DBA::insert('diaspora-interaction', ['uri-id' => $item['uri-id'], 'interaction' => $diaspora_signed_text], true);
1783                 }
1784
1785                 $deleted = self::tagDeliver($item['uid'], $current_post);
1786
1787                 /*
1788                  * current post can be deleted if is for a community page and no mention are
1789                  * in it.
1790                  */
1791                 if (!$deleted && !$dontcache) {
1792                         $posted_item = self::selectFirst(self::ITEM_FIELDLIST, ['id' => $current_post]);
1793                         if (DBA::isResult($posted_item)) {
1794                                 if ($notify) {
1795                                         Addon::callHooks('post_local_end', $posted_item);
1796                                 } else {
1797                                         Addon::callHooks('post_remote_end', $posted_item);
1798                                 }
1799                         } else {
1800                                 Logger::log('new item not found in DB, id ' . $current_post);
1801                         }
1802                 }
1803
1804                 if ($item['parent-uri'] === $item['uri']) {
1805                         self::addThread($current_post);
1806                 } else {
1807                         self::updateThread($parent_id);
1808                 }
1809
1810                 $delivery_data['iid'] = $current_post;
1811
1812                 self::insertDeliveryData($delivery_data);
1813
1814                 DBA::commit();
1815
1816                 /*
1817                  * Due to deadlock issues with the "term" table we are doing these steps after the commit.
1818                  * This is not perfect - but a workable solution until we found the reason for the problem.
1819                  */
1820                 if (!empty($tags)) {
1821                         Term::insertFromTagFieldByItemId($current_post, $tags);
1822                 }
1823
1824                 if (!empty($files)) {
1825                         Term::insertFromFileFieldByItemId($current_post, $files);
1826                 }
1827
1828                 if ($item['parent-uri'] === $item['uri']) {
1829                         self::addShadow($current_post);
1830                 } else {
1831                         self::addShadowPost($current_post);
1832                 }
1833
1834                 check_user_notification($current_post);
1835
1836                 if ($notify) {
1837                         Worker::add(['priority' => $priority, 'dont_fork' => true], 'Notifier', $notify_type, $current_post);
1838                 } elseif ($item['visible'] && ((!empty($parent) && $parent['origin']) || $item['origin'])) {
1839                         if ($item['gravity'] == GRAVITY_ACTIVITY) {
1840                                 $cmd = $item['origin'] ? 'activity-new' : 'activity-import';
1841                         } elseif ($item['gravity'] == GRAVITY_COMMENT) {
1842                                 $cmd = $item['origin'] ? 'comment-new' : 'comment-import';
1843                         } else {
1844                                 $cmd = 'wall-new';
1845                         }
1846
1847                         Worker::add(['priority' => PRIORITY_HIGH, 'dont_fork' => true], 'Notifier', $cmd, $current_post);
1848                 }
1849
1850                 return $current_post;
1851         }
1852
1853         /**
1854          * @brief Insert a new item delivery data entry
1855          *
1856          * @param array $item The item fields that are to be inserted
1857          */
1858         private static function insertDeliveryData($delivery_data)
1859         {
1860                 if (empty($delivery_data['iid']) || (empty($delivery_data['postopts']) && empty($delivery_data['inform']))) {
1861                         return;
1862                 }
1863
1864                 DBA::insert('item-delivery-data', $delivery_data);
1865         }
1866
1867         /**
1868          * @brief Update an existing item delivery data entry
1869          *
1870          * @param integer $id The item id that is to be updated
1871          * @param array $item The item fields that are to be inserted
1872          */
1873         private static function updateDeliveryData($id, $delivery_data)
1874         {
1875                 if (empty($id) || (empty($delivery_data['postopts']) && empty($delivery_data['inform']))) {
1876                         return;
1877                 }
1878
1879                 DBA::update('item-delivery-data', $delivery_data, ['iid' => $id], true);
1880         }
1881
1882         /**
1883          * @brief Insert a new item content entry
1884          *
1885          * @param array $item The item fields that are to be inserted
1886          */
1887         private static function insertActivity(&$item)
1888         {
1889                 $activity_index = self::activityToIndex($item['verb']);
1890
1891                 if ($activity_index < 0) {
1892                         return false;
1893                 }
1894
1895                 $fields = ['activity' => $activity_index, 'uri-hash' => (string)$item['uri-id'], 'uri-id' => $item['uri-id']];
1896
1897                 // We just remove everything that is content
1898                 foreach (array_merge(self::CONTENT_FIELDLIST, self::MIXED_CONTENT_FIELDLIST) as $field) {
1899                         unset($item[$field]);
1900                 }
1901
1902                 // To avoid timing problems, we are using locks.
1903                 $locked = Lock::acquire('item_insert_activity');
1904                 if (!$locked) {
1905                         Logger::log("Couldn't acquire lock for URI " . $item['uri'] . " - proceeding anyway.");
1906                 }
1907
1908                 // Do we already have this content?
1909                 $item_activity = DBA::selectFirst('item-activity', ['id'], ['uri-id' => $item['uri-id']]);
1910                 if (DBA::isResult($item_activity)) {
1911                         $item['iaid'] = $item_activity['id'];
1912                         Logger::log('Fetched activity for URI ' . $item['uri'] . ' (' . $item['iaid'] . ')');
1913                 } elseif (DBA::insert('item-activity', $fields)) {
1914                         $item['iaid'] = DBA::lastInsertId();
1915                         Logger::log('Inserted activity for URI ' . $item['uri'] . ' (' . $item['iaid'] . ')');
1916                 } else {
1917                         // This shouldn't happen.
1918                         Logger::log('Could not insert activity for URI ' . $item['uri'] . ' - should not happen');
1919                         Lock::release('item_insert_activity');
1920                         return false;
1921                 }
1922                 if ($locked) {
1923                         Lock::release('item_insert_activity');
1924                 }
1925                 return true;
1926         }
1927
1928         /**
1929          * @brief Insert a new item content entry
1930          *
1931          * @param array $item The item fields that are to be inserted
1932          */
1933         private static function insertContent(&$item)
1934         {
1935                 $fields = ['uri-plink-hash' => (string)$item['uri-id'], 'uri-id' => $item['uri-id']];
1936
1937                 foreach (array_merge(self::CONTENT_FIELDLIST, self::MIXED_CONTENT_FIELDLIST) as $field) {
1938                         if (isset($item[$field])) {
1939                                 $fields[$field] = $item[$field];
1940                                 unset($item[$field]);
1941                         }
1942                 }
1943
1944                 // To avoid timing problems, we are using locks.
1945                 $locked = Lock::acquire('item_insert_content');
1946                 if (!$locked) {
1947                         Logger::log("Couldn't acquire lock for URI " . $item['uri'] . " - proceeding anyway.");
1948                 }
1949
1950                 // Do we already have this content?
1951                 $item_content = DBA::selectFirst('item-content', ['id'], ['uri-id' => $item['uri-id']]);
1952                 if (DBA::isResult($item_content)) {
1953                         $item['icid'] = $item_content['id'];
1954                         Logger::log('Fetched content for URI ' . $item['uri'] . ' (' . $item['icid'] . ')');
1955                 } elseif (DBA::insert('item-content', $fields)) {
1956                         $item['icid'] = DBA::lastInsertId();
1957                         Logger::log('Inserted content for URI ' . $item['uri'] . ' (' . $item['icid'] . ')');
1958                 } else {
1959                         // This shouldn't happen.
1960                         Logger::log('Could not insert content for URI ' . $item['uri'] . ' - should not happen');
1961                 }
1962                 if ($locked) {
1963                         Lock::release('item_insert_content');
1964                 }
1965         }
1966
1967         /**
1968          * @brief Update existing item content entries
1969          *
1970          * @param array $item The item fields that are to be changed
1971          * @param array $condition The condition for finding the item content entries
1972          */
1973         private static function updateActivity($item, $condition)
1974         {
1975                 if (empty($item['verb'])) {
1976                         return false;
1977                 }
1978                 $activity_index = self::activityToIndex($item['verb']);
1979
1980                 if ($activity_index < 0) {
1981                         return false;
1982                 }
1983
1984                 $fields = ['activity' => $activity_index];
1985
1986                 Logger::log('Update activity for ' . json_encode($condition));
1987
1988                 DBA::update('item-activity', $fields, $condition, true);
1989
1990                 return true;
1991         }
1992
1993         /**
1994          * @brief Update existing item content entries
1995          *
1996          * @param array $item The item fields that are to be changed
1997          * @param array $condition The condition for finding the item content entries
1998          */
1999         private static function updateContent($item, $condition)
2000         {
2001                 // We have to select only the fields from the "item-content" table
2002                 $fields = [];
2003                 foreach (array_merge(self::CONTENT_FIELDLIST, self::MIXED_CONTENT_FIELDLIST) as $field) {
2004                         if (isset($item[$field])) {
2005                                 $fields[$field] = $item[$field];
2006                         }
2007                 }
2008
2009                 if (empty($fields)) {
2010                         // when there are no fields at all, just use the condition
2011                         // This is to ensure that we always store content.
2012                         $fields = $condition;
2013                 }
2014
2015                 Logger::log('Update content for ' . json_encode($condition));
2016
2017                 DBA::update('item-content', $fields, $condition, true);
2018         }
2019
2020         /**
2021          * @brief Distributes public items to the receivers
2022          *
2023          * @param integer $itemid      Item ID that should be added
2024          * @param string  $signed_text Original text (for Diaspora signatures), JSON encoded.
2025          */
2026         public static function distribute($itemid, $signed_text = '')
2027         {
2028                 $condition = ["`id` IN (SELECT `parent` FROM `item` WHERE `id` = ?)", $itemid];
2029                 $parent = self::selectFirst(['owner-id'], $condition);
2030                 if (!DBA::isResult($parent)) {
2031                         return;
2032                 }
2033
2034                 // Only distribute public items from native networks
2035                 $condition = ['id' => $itemid, 'uid' => 0,
2036                         'network' => [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::DIASPORA, Protocol::OSTATUS, ""],
2037                         'visible' => true, 'deleted' => false, 'moderated' => false, 'private' => false];
2038                 $item = self::selectFirst(self::ITEM_FIELDLIST, ['id' => $itemid]);
2039                 if (!DBA::isResult($item)) {
2040                         return;
2041                 }
2042
2043                 $origin = $item['origin'];
2044
2045                 unset($item['id']);
2046                 unset($item['parent']);
2047                 unset($item['mention']);
2048                 unset($item['wall']);
2049                 unset($item['origin']);
2050                 unset($item['starred']);
2051
2052                 $users = [];
2053
2054                 /// @todo add a field "pcid" in the contact table that referrs to the public contact id.
2055                 $owner = DBA::selectFirst('contact', ['url', 'nurl', 'alias'], ['id' => $parent['owner-id']]);
2056                 if (!DBA::isResult($owner)) {
2057                         return;
2058                 }
2059
2060                 $condition = ['nurl' => $owner['nurl'], 'rel' => [Contact::SHARING, Contact::FRIEND]];
2061                 $contacts = DBA::select('contact', ['uid'], $condition);
2062                 while ($contact = DBA::fetch($contacts)) {
2063                         if ($contact['uid'] == 0) {
2064                                 continue;
2065                         }
2066
2067                         $users[$contact['uid']] = $contact['uid'];
2068                 }
2069                 DBA::close($contacts);
2070
2071                 $condition = ['alias' => $owner['url'], 'rel' => [Contact::SHARING, Contact::FRIEND]];
2072                 $contacts = DBA::select('contact', ['uid'], $condition);
2073                 while ($contact = DBA::fetch($contacts)) {
2074                         if ($contact['uid'] == 0) {
2075                                 continue;
2076                         }
2077
2078                         $users[$contact['uid']] = $contact['uid'];
2079                 }
2080                 DBA::close($contacts);
2081
2082                 if (!empty($owner['alias'])) {
2083                         $condition = ['url' => $owner['alias'], 'rel' => [Contact::SHARING, Contact::FRIEND]];
2084                         $contacts = DBA::select('contact', ['uid'], $condition);
2085                         while ($contact = DBA::fetch($contacts)) {
2086                                 if ($contact['uid'] == 0) {
2087                                         continue;
2088                                 }
2089
2090                                 $users[$contact['uid']] = $contact['uid'];
2091                         }
2092                         DBA::close($contacts);
2093                 }
2094
2095                 $origin_uid = 0;
2096
2097                 if ($item['uri'] != $item['parent-uri']) {
2098                         $parents = self::select(['uid', 'origin'], ["`uri` = ? AND `uid` != 0", $item['parent-uri']]);
2099                         while ($parent = self::fetch($parents)) {
2100                                 $users[$parent['uid']] = $parent['uid'];
2101                                 if ($parent['origin'] && !$origin) {
2102                                         $origin_uid = $parent['uid'];
2103                                 }
2104                         }
2105                 }
2106
2107                 foreach ($users as $uid) {
2108                         if ($origin_uid == $uid) {
2109                                 $item['diaspora_signed_text'] = $signed_text;
2110                         }
2111                         self::storeForUser($itemid, $item, $uid);
2112                 }
2113         }
2114
2115         /**
2116          * @brief Store public items for the receivers
2117          *
2118          * @param integer $itemid Item ID that should be added
2119          * @param array   $item   The item entry that will be stored
2120          * @param integer $uid    The user that will receive the item entry
2121          */
2122         private static function storeForUser($itemid, $item, $uid)
2123         {
2124                 $item['uid'] = $uid;
2125                 $item['origin'] = 0;
2126                 $item['wall'] = 0;
2127                 if ($item['uri'] == $item['parent-uri']) {
2128                         $item['contact-id'] = Contact::getIdForURL($item['owner-link'], $uid);
2129                 } else {
2130                         $item['contact-id'] = Contact::getIdForURL($item['author-link'], $uid);
2131                 }
2132
2133                 if (empty($item['contact-id'])) {
2134                         $self = DBA::selectFirst('contact', ['id'], ['self' => true, 'uid' => $uid]);
2135                         if (!DBA::isResult($self)) {
2136                                 return;
2137                         }
2138                         $item['contact-id'] = $self['id'];
2139                 }
2140
2141                 /// @todo Handling of "event-id"
2142
2143                 $notify = false;
2144                 if ($item['uri'] == $item['parent-uri']) {
2145                         $contact = DBA::selectFirst('contact', [], ['id' => $item['contact-id'], 'self' => false]);
2146                         if (DBA::isResult($contact)) {
2147                                 $notify = self::isRemoteSelf($contact, $item);
2148                         }
2149                 }
2150
2151                 $distributed = self::insert($item, false, $notify, true);
2152
2153                 if (!$distributed) {
2154                         Logger::log("Distributed public item " . $itemid . " for user " . $uid . " wasn't stored", Logger::DEBUG);
2155                 } else {
2156                         Logger::log("Distributed public item " . $itemid . " for user " . $uid . " with id " . $distributed, Logger::DEBUG);
2157                 }
2158         }
2159
2160         /**
2161          * @brief Add a shadow entry for a given item id that is a thread starter
2162          *
2163          * We store every public item entry additionally with the user id "0".
2164          * This is used for the community page and for the search.
2165          * It is planned that in the future we will store public item entries only once.
2166          *
2167          * @param integer $itemid Item ID that should be added
2168          */
2169         public static function addShadow($itemid)
2170         {
2171                 $fields = ['uid', 'private', 'moderated', 'visible', 'deleted', 'network', 'uri'];
2172                 $condition = ['id' => $itemid, 'parent' => [0, $itemid]];
2173                 $item = self::selectFirst($fields, $condition);
2174
2175                 if (!DBA::isResult($item)) {
2176                         return;
2177                 }
2178
2179                 // is it already a copy?
2180                 if (($itemid == 0) || ($item['uid'] == 0)) {
2181                         return;
2182                 }
2183
2184                 // Is it a visible public post?
2185                 if (!$item["visible"] || $item["deleted"] || $item["moderated"] || $item["private"]) {
2186                         return;
2187                 }
2188
2189                 // is it an entry from a connector? Only add an entry for natively connected networks
2190                 if (!in_array($item["network"], [Protocol::ACTIVITYPUB, Protocol::DFRN, Protocol::DIASPORA, Protocol::OSTATUS, ""])) {
2191                         return;
2192                 }
2193
2194                 if (self::exists(['uri' => $item['uri'], 'uid' => 0])) {
2195                         return;
2196                 }
2197
2198                 $item = self::selectFirst(self::ITEM_FIELDLIST, ['id' => $itemid]);
2199
2200                 if (DBA::isResult($item)) {
2201                         // Preparing public shadow (removing user specific data)
2202                         $item['uid'] = 0;
2203                         unset($item['id']);
2204                         unset($item['parent']);
2205                         unset($item['wall']);
2206                         unset($item['mention']);
2207                         unset($item['origin']);
2208                         unset($item['starred']);
2209                         unset($item['postopts']);
2210                         unset($item['inform']);
2211                         if ($item['uri'] == $item['parent-uri']) {
2212                                 $item['contact-id'] = $item['owner-id'];
2213                         } else {
2214                                 $item['contact-id'] = $item['author-id'];
2215                         }
2216
2217                         $public_shadow = self::insert($item, false, false, true);
2218
2219                         Logger::log("Stored public shadow for thread ".$itemid." under id ".$public_shadow, Logger::DEBUG);
2220                 }
2221         }
2222
2223         /**
2224          * @brief Add a shadow entry for a given item id that is a comment
2225          *
2226          * This function does the same like the function above - but for comments
2227          *
2228          * @param integer $itemid Item ID that should be added
2229          */
2230         public static function addShadowPost($itemid)
2231         {
2232                 $item = self::selectFirst(self::ITEM_FIELDLIST, ['id' => $itemid]);
2233                 if (!DBA::isResult($item)) {
2234                         return;
2235                 }
2236
2237                 // Is it a toplevel post?
2238                 if ($item['id'] == $item['parent']) {
2239                         self::addShadow($itemid);
2240                         return;
2241                 }
2242
2243                 // Is this a shadow entry?
2244                 if ($item['uid'] == 0) {
2245                         return;
2246                 }
2247
2248                 // Is there a shadow parent?
2249                 if (!self::exists(['uri' => $item['parent-uri'], 'uid' => 0])) {
2250                         return;
2251                 }
2252
2253                 // Is there already a shadow entry?
2254                 if (self::exists(['uri' => $item['uri'], 'uid' => 0])) {
2255                         return;
2256                 }
2257
2258                 // Save "origin" and "parent" state
2259                 $origin = $item['origin'];
2260                 $parent = $item['parent'];
2261
2262                 // Preparing public shadow (removing user specific data)
2263                 $item['uid'] = 0;
2264                 unset($item['id']);
2265                 unset($item['parent']);
2266                 unset($item['wall']);
2267                 unset($item['mention']);
2268                 unset($item['origin']);
2269                 unset($item['starred']);
2270                 unset($item['postopts']);
2271                 unset($item['inform']);
2272                 $item['contact-id'] = Contact::getIdForURL($item['author-link']);
2273
2274                 $public_shadow = self::insert($item, false, false, true);
2275
2276                 Logger::log("Stored public shadow for comment ".$item['uri']." under id ".$public_shadow, Logger::DEBUG);
2277
2278                 // If this was a comment to a Diaspora post we don't get our comment back.
2279                 // This means that we have to distribute the comment by ourselves.
2280                 if ($origin && self::exists(['id' => $parent, 'network' => Protocol::DIASPORA])) {
2281                         self::distribute($public_shadow);
2282                 }
2283         }
2284
2285          /**
2286          * Adds a language specification in a "language" element of given $arr.
2287          * Expects "body" element to exist in $arr.
2288          */
2289         private static function addLanguageToItemArray(&$item)
2290         {
2291                 $naked_body = BBCode::toPlaintext($item['body'], false);
2292
2293                 $ld = new Text_LanguageDetect();
2294                 $ld->setNameMode(2);
2295                 $languages = $ld->detect($naked_body, 3);
2296
2297                 if (is_array($languages)) {
2298                         $item['language'] = json_encode($languages);
2299                 }
2300         }
2301
2302         /**
2303          * @brief Creates an unique guid out of a given uri
2304          *
2305          * @param string $uri uri of an item entry
2306          * @param string $host hostname for the GUID prefix
2307          * @return string unique guid
2308          */
2309         public static function guidFromUri($uri, $host)
2310         {
2311                 // Our regular guid routine is using this kind of prefix as well
2312                 // We have to avoid that different routines could accidentally create the same value
2313                 $parsed = parse_url($uri);
2314
2315                 // We use a hash of the hostname as prefix for the guid
2316                 $guid_prefix = hash("crc32", $host);
2317
2318                 // Remove the scheme to make sure that "https" and "http" doesn't make a difference
2319                 unset($parsed["scheme"]);
2320
2321                 // Glue it together to be able to make a hash from it
2322                 $host_id = implode("/", $parsed);
2323
2324                 // We could use any hash algorithm since it isn't a security issue
2325                 $host_hash = hash("ripemd128", $host_id);
2326
2327                 return $guid_prefix.$host_hash;
2328         }
2329
2330         /**
2331          * generate an unique URI
2332          *
2333          * @param integer $uid User id
2334          * @param string $guid An existing GUID (Otherwise it will be generated)
2335          *
2336          * @return string
2337          */
2338         public static function newURI($uid, $guid = "")
2339         {
2340                 if ($guid == "") {
2341                         $guid = System::createUUID();
2342                 }
2343
2344                 return self::getApp()->getBaseURL() . '/objects/' . $guid;
2345         }
2346
2347         /**
2348          * @brief Set "success_update" and "last-item" to the date of the last time we heard from this contact
2349          *
2350          * This can be used to filter for inactive contacts.
2351          * Only do this for public postings to avoid privacy problems, since poco data is public.
2352          * Don't set this value if it isn't from the owner (could be an author that we don't know)
2353          *
2354          * @param array $arr Contains the just posted item record
2355          */
2356         private static function updateContact($arr)
2357         {
2358                 // Unarchive the author
2359                 $contact = DBA::selectFirst('contact', [], ['id' => $arr["author-id"]]);
2360                 if (DBA::isResult($contact)) {
2361                         Contact::unmarkForArchival($contact);
2362                 }
2363
2364                 // Unarchive the contact if it's not our own contact
2365                 $contact = DBA::selectFirst('contact', [], ['id' => $arr["contact-id"], 'self' => false]);
2366                 if (DBA::isResult($contact)) {
2367                         Contact::unmarkForArchival($contact);
2368                 }
2369
2370                 $update = (!$arr['private'] && ((defaults($arr, 'author-link', '') === defaults($arr, 'owner-link', '')) || ($arr["parent-uri"] === $arr["uri"])));
2371
2372                 // Is it a forum? Then we don't care about the rules from above
2373                 if (!$update && in_array($arr["network"], [Protocol::ACTIVITYPUB, Protocol::DFRN]) && ($arr["parent-uri"] === $arr["uri"])) {
2374                         if (DBA::exists('contact', ['id' => $arr['contact-id'], 'forum' => true])) {
2375                                 $update = true;
2376                         }
2377                 }
2378
2379                 if ($update) {
2380                         DBA::update('contact', ['success_update' => $arr['received'], 'last-item' => $arr['received']],
2381                                 ['id' => $arr['contact-id']]);
2382                 }
2383                 // Now do the same for the system wide contacts with uid=0
2384                 if (!$arr['private']) {
2385                         DBA::update('contact', ['success_update' => $arr['received'], 'last-item' => $arr['received']],
2386                                 ['id' => $arr['owner-id']]);
2387
2388                         if ($arr['owner-id'] != $arr['author-id']) {
2389                                 DBA::update('contact', ['success_update' => $arr['received'], 'last-item' => $arr['received']],
2390                                         ['id' => $arr['author-id']]);
2391                         }
2392                 }
2393         }
2394
2395         public static function setHashtags(&$item)
2396         {
2397
2398                 $tags = BBCode::getTags($item["body"]);
2399
2400                 // No hashtags?
2401                 if (!count($tags)) {
2402                         return false;
2403                 }
2404
2405                 // This sorting is important when there are hashtags that are part of other hashtags
2406                 // Otherwise there could be problems with hashtags like #test and #test2
2407                 rsort($tags);
2408
2409                 $URLSearchString = "^\[\]";
2410
2411                 // All hashtags should point to the home server if "local_tags" is activated
2412                 if (Config::get('system', 'local_tags')) {
2413                         $item["body"] = preg_replace("/#\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism",
2414                                         "#[url=".System::baseUrl()."/search?tag=$2]$2[/url]", $item["body"]);
2415
2416                         $item["tag"] = preg_replace("/#\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism",
2417                                         "#[url=".System::baseUrl()."/search?tag=$2]$2[/url]", $item["tag"]);
2418                 }
2419
2420                 // mask hashtags inside of url, bookmarks and attachments to avoid urls in urls
2421                 $item["body"] = preg_replace_callback("/\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism",
2422                         function ($match) {
2423                                 return ("[url=" . str_replace("#", "&num;", $match[1]) . "]" . str_replace("#", "&num;", $match[2]) . "[/url]");
2424                         }, $item["body"]);
2425
2426                 $item["body"] = preg_replace_callback("/\[bookmark\=([$URLSearchString]*)\](.*?)\[\/bookmark\]/ism",
2427                         function ($match) {
2428                                 return ("[bookmark=" . str_replace("#", "&num;", $match[1]) . "]" . str_replace("#", "&num;", $match[2]) . "[/bookmark]");
2429                         }, $item["body"]);
2430
2431                 $item["body"] = preg_replace_callback("/\[attachment (.*)\](.*?)\[\/attachment\]/ism",
2432                         function ($match) {
2433                                 return ("[attachment " . str_replace("#", "&num;", $match[1]) . "]" . $match[2] . "[/attachment]");
2434                         }, $item["body"]);
2435
2436                 // Repair recursive urls
2437                 $item["body"] = preg_replace("/&num;\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism",
2438                                 "&num;$2", $item["body"]);
2439
2440                 foreach ($tags as $tag) {
2441                         if ((strpos($tag, '#') !== 0) || strpos($tag, '[url=')) {
2442                                 continue;
2443                         }
2444
2445                         $basetag = str_replace('_',' ',substr($tag,1));
2446
2447                         $newtag = '#[url=' . System::baseUrl() . '/search?tag=' . $basetag . ']' . $basetag . '[/url]';
2448
2449                         $item["body"] = str_replace($tag, $newtag, $item["body"]);
2450
2451                         if (!stristr($item["tag"], "/search?tag=" . $basetag . "]" . $basetag . "[/url]")) {
2452                                 if (strlen($item["tag"])) {
2453                                         $item["tag"] = ',' . $item["tag"];
2454                                 }
2455                                 $item["tag"] = $newtag . $item["tag"];
2456                         }
2457                 }
2458
2459                 // Convert back the masked hashtags
2460                 $item["body"] = str_replace("&num;", "#", $item["body"]);
2461         }
2462
2463         public static function getGuidById($id)
2464         {
2465                 $item = self::selectFirst(['guid'], ['id' => $id]);
2466                 if (DBA::isResult($item)) {
2467                         return $item['guid'];
2468                 } else {
2469                         return '';
2470                 }
2471         }
2472
2473         /**
2474          * This function is only used for the old Friendica app on Android that doesn't like paths with guid
2475          * @param string $guid item guid
2476          * @param int    $uid  user id
2477          * @return array with id and nick of the item with the given guid
2478          */
2479         public static function getIdAndNickByGuid($guid, $uid = 0)
2480         {
2481                 $nick = "";
2482                 $id = 0;
2483
2484                 if ($uid == 0) {
2485                         $uid == local_user();
2486                 }
2487
2488                 // Does the given user have this item?
2489                 if ($uid) {
2490                         $item = self::selectFirst(['id'], ['guid' => $guid, 'uid' => $uid]);
2491                         if (DBA::isResult($item)) {
2492                                 $user = DBA::selectFirst('user', ['nickname'], ['uid' => $uid]);
2493                                 if (!DBA::isResult($user)) {
2494                                         return;
2495                                 }
2496                                 $id = $item['id'];
2497                                 $nick = $user['nickname'];
2498                         }
2499                 }
2500
2501                 // Or is it anywhere on the server?
2502                 if ($nick == "") {
2503                         $condition = ["`guid` = ? AND `uid` != 0", $guid];
2504                         $item = self::selectFirst(['id', 'uid'], $condition);
2505                         if (DBA::isResult($item)) {
2506                                 $user = DBA::selectFirst('user', ['nickname'], ['uid' => $item['uid']]);
2507                                 if (!DBA::isResult($user)) {
2508                                         return;
2509                                 }
2510                                 $id = $item['id'];
2511                                 $nick = $user['nickname'];
2512                         }
2513                 }
2514                 return ["nick" => $nick, "id" => $id];
2515         }
2516
2517         /**
2518          * look for mention tags and setup a second delivery chain for forum/community posts if appropriate
2519          * @param int $uid
2520          * @param int $item_id
2521          * @return bool true if item was deleted, else false
2522          */
2523         private static function tagDeliver($uid, $item_id)
2524         {
2525                 $mention = false;
2526
2527                 $user = DBA::selectFirst('user', [], ['uid' => $uid]);
2528                 if (!DBA::isResult($user)) {
2529                         return;
2530                 }
2531
2532                 $community_page = (($user['page-flags'] == Contact::PAGE_COMMUNITY) ? true : false);
2533                 $prvgroup = (($user['page-flags'] == Contact::PAGE_PRVGROUP) ? true : false);
2534
2535                 $item = self::selectFirst(self::ITEM_FIELDLIST, ['id' => $item_id]);
2536                 if (!DBA::isResult($item)) {
2537                         return;
2538                 }
2539
2540                 $link = Strings::normaliseLink(System::baseUrl() . '/profile/' . $user['nickname']);
2541
2542                 /*
2543                  * Diaspora uses their own hardwired link URL in @-tags
2544                  * instead of the one we supply with webfinger
2545                  */
2546                 $dlink = Strings::normaliseLink(System::baseUrl() . '/u/' . $user['nickname']);
2547
2548                 $cnt = preg_match_all('/[\@\!]\[url\=(.*?)\](.*?)\[\/url\]/ism', $item['body'], $matches, PREG_SET_ORDER);
2549                 if ($cnt) {
2550                         foreach ($matches as $mtch) {
2551                                 if (Strings::compareLink($link, $mtch[1]) || Strings::compareLink($dlink, $mtch[1])) {
2552                                         $mention = true;
2553                                         Logger::log('mention found: ' . $mtch[2]);
2554                                 }
2555                         }
2556                 }
2557
2558                 if (!$mention) {
2559                         if (($community_page || $prvgroup) &&
2560                                   !$item['wall'] && !$item['origin'] && ($item['id'] == $item['parent'])) {
2561                                 // mmh.. no mention.. community page or private group... no wall.. no origin.. top-post (not a comment)
2562                                 // delete it!
2563                                 Logger::log("no-mention top-level post to community or private group. delete.");
2564                                 DBA::delete('item', ['id' => $item_id]);
2565                                 return true;
2566                         }
2567                         return;
2568                 }
2569
2570                 $arr = ['item' => $item, 'user' => $user];
2571
2572                 Addon::callHooks('tagged', $arr);
2573
2574                 if (!$community_page && !$prvgroup) {
2575                         return;
2576                 }
2577
2578                 /*
2579                  * tgroup delivery - setup a second delivery chain
2580                  * prevent delivery looping - only proceed
2581                  * if the message originated elsewhere and is a top-level post
2582                  */
2583                 if ($item['wall'] || $item['origin'] || ($item['id'] != $item['parent'])) {
2584                         return;
2585                 }
2586
2587                 // now change this copy of the post to a forum head message and deliver to all the tgroup members
2588                 $self = DBA::selectFirst('contact', ['id', 'name', 'url', 'thumb'], ['uid' => $uid, 'self' => true]);
2589                 if (!DBA::isResult($self)) {
2590                         return;
2591                 }
2592
2593                 $owner_id = Contact::getIdForURL($self['url']);
2594
2595                 // also reset all the privacy bits to the forum default permissions
2596
2597                 $private = ($user['allow_cid'] || $user['allow_gid'] || $user['deny_cid'] || $user['deny_gid']) ? 1 : 0;
2598
2599                 $psid = PermissionSet::fetchIDForPost($user);
2600
2601                 $forum_mode = ($prvgroup ? 2 : 1);
2602
2603                 $fields = ['wall' => true, 'origin' => true, 'forum_mode' => $forum_mode, 'contact-id' => $self['id'],
2604                         'owner-id' => $owner_id, 'private' => $private, 'psid' => $psid];
2605                 self::update($fields, ['id' => $item_id]);
2606
2607                 self::updateThread($item_id);
2608
2609                 Worker::add(['priority' => PRIORITY_HIGH, 'dont_fork' => true], 'Notifier', 'tgroup', $item_id);
2610         }
2611
2612         public static function isRemoteSelf($contact, &$datarray)
2613         {
2614                 $a = \get_app();
2615
2616                 if (!$contact['remote_self']) {
2617                         return false;
2618                 }
2619
2620                 // Prevent the forwarding of posts that are forwarded
2621                 if (!empty($datarray["extid"]) && ($datarray["extid"] == Protocol::DFRN)) {
2622                         Logger::log('Already forwarded', Logger::DEBUG);
2623                         return false;
2624                 }
2625
2626                 // Prevent to forward already forwarded posts
2627                 if ($datarray["app"] == $a->getHostName()) {
2628                         Logger::log('Already forwarded (second test)', Logger::DEBUG);
2629                         return false;
2630                 }
2631
2632                 // Only forward posts
2633                 if ($datarray["verb"] != ACTIVITY_POST) {
2634                         Logger::log('No post', Logger::DEBUG);
2635                         return false;
2636                 }
2637
2638                 if (($contact['network'] != Protocol::FEED) && $datarray['private']) {
2639                         Logger::log('Not public', Logger::DEBUG);
2640                         return false;
2641                 }
2642
2643                 $datarray2 = $datarray;
2644                 Logger::log('remote-self start - Contact '.$contact['url'].' - '.$contact['remote_self'].' Item '.print_r($datarray, true), Logger::DEBUG);
2645                 if ($contact['remote_self'] == 2) {
2646                         $self = DBA::selectFirst('contact', ['id', 'name', 'url', 'thumb'],
2647                                         ['uid' => $contact['uid'], 'self' => true]);
2648                         if (DBA::isResult($self)) {
2649                                 $datarray['contact-id'] = $self["id"];
2650
2651                                 $datarray['owner-name'] = $self["name"];
2652                                 $datarray['owner-link'] = $self["url"];
2653                                 $datarray['owner-avatar'] = $self["thumb"];
2654
2655                                 $datarray['author-name']   = $datarray['owner-name'];
2656                                 $datarray['author-link']   = $datarray['owner-link'];
2657                                 $datarray['author-avatar'] = $datarray['owner-avatar'];
2658
2659                                 unset($datarray['created']);
2660                                 unset($datarray['edited']);
2661
2662                                 unset($datarray['network']);
2663                                 unset($datarray['owner-id']);
2664                                 unset($datarray['author-id']);
2665                         }
2666
2667                         if ($contact['network'] != Protocol::FEED) {
2668                                 $datarray["guid"] = System::createUUID();
2669                                 unset($datarray["plink"]);
2670                                 $datarray["uri"] = self::newURI($contact['uid'], $datarray["guid"]);
2671                                 $datarray["parent-uri"] = $datarray["uri"];
2672                                 $datarray["thr-parent"] = $datarray["uri"];
2673                                 $datarray["extid"] = Protocol::DFRN;
2674                                 $urlpart = parse_url($datarray2['author-link']);
2675                                 $datarray["app"] = $urlpart["host"];
2676                         } else {
2677                                 $datarray['private'] = 0;
2678                         }
2679                 }
2680
2681                 if ($contact['network'] != Protocol::FEED) {
2682                         // Store the original post
2683                         $result = self::insert($datarray2, false, false);
2684                         Logger::log('remote-self post original item - Contact '.$contact['url'].' return '.$result.' Item '.print_r($datarray2, true), Logger::DEBUG);
2685                 } else {
2686                         $datarray["app"] = "Feed";
2687                         $result = true;
2688                 }
2689
2690                 // Trigger automatic reactions for addons
2691                 $datarray['api_source'] = true;
2692
2693                 // We have to tell the hooks who we are - this really should be improved
2694                 $_SESSION["authenticated"] = true;
2695                 $_SESSION["uid"] = $contact['uid'];
2696
2697                 return $result;
2698         }
2699
2700         /**
2701          *
2702          * @param string $s
2703          * @param int    $uid
2704          * @param array  $item
2705          * @param int    $cid
2706          * @return string
2707          */
2708         public static function fixPrivatePhotos($s, $uid, $item = null, $cid = 0)
2709         {
2710                 if (Config::get('system', 'disable_embedded')) {
2711                         return $s;
2712                 }
2713
2714                 Logger::log('check for photos', Logger::DEBUG);
2715                 $site = substr(System::baseUrl(), strpos(System::baseUrl(), '://'));
2716
2717                 $orig_body = $s;
2718                 $new_body = '';
2719
2720                 $img_start = strpos($orig_body, '[img');
2721                 $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
2722                 $img_len = ($img_start !== false ? strpos(substr($orig_body, $img_start + $img_st_close + 1), '[/img]') : false);
2723
2724                 while (($img_st_close !== false) && ($img_len !== false)) {
2725                         $img_st_close++; // make it point to AFTER the closing bracket
2726                         $image = substr($orig_body, $img_start + $img_st_close, $img_len);
2727
2728                         Logger::log('found photo ' . $image, Logger::DEBUG);
2729
2730                         if (stristr($image, $site . '/photo/')) {
2731                                 // Only embed locally hosted photos
2732                                 $replace = false;
2733                                 $i = basename($image);
2734                                 $i = str_replace(['.jpg', '.png', '.gif'], ['', '', ''], $i);
2735                                 $x = strpos($i, '-');
2736
2737                                 if ($x) {
2738                                         $res = substr($i, $x + 1);
2739                                         $i = substr($i, 0, $x);
2740                                         $fields = ['data', 'type', 'allow_cid', 'allow_gid', 'deny_cid', 'deny_gid'];
2741                                         $photo = DBA::selectFirst('photo', $fields, ['resource-id' => $i, 'scale' => $res, 'uid' => $uid]);
2742                                         if (DBA::isResult($photo)) {
2743                                                 /*
2744                                                  * Check to see if we should replace this photo link with an embedded image
2745                                                  * 1. No need to do so if the photo is public
2746                                                  * 2. If there's a contact-id provided, see if they're in the access list
2747                                                  *    for the photo. If so, embed it.
2748                                                  * 3. Otherwise, if we have an item, see if the item permissions match the photo
2749                                                  *    permissions, regardless of order but first check to see if they're an exact
2750                                                  *    match to save some processing overhead.
2751                                                  */
2752                                                 if (self::hasPermissions($photo)) {
2753                                                         if ($cid) {
2754                                                                 $recips = self::enumeratePermissions($photo);
2755                                                                 if (in_array($cid, $recips)) {
2756                                                                         $replace = true;
2757                                                                 }
2758                                                         } elseif ($item) {
2759                                                                 if (self::samePermissions($item, $photo)) {
2760                                                                         $replace = true;
2761                                                                 }
2762                                                         }
2763                                                 }
2764                                                 if ($replace) {
2765                                                         $data = $photo['data'];
2766                                                         $type = $photo['type'];
2767
2768                                                         // If a custom width and height were specified, apply before embedding
2769                                                         if (preg_match("/\[img\=([0-9]*)x([0-9]*)\]/is", substr($orig_body, $img_start, $img_st_close), $match)) {
2770                                                                 Logger::log('scaling photo', Logger::DEBUG);
2771
2772                                                                 $width = intval($match[1]);
2773                                                                 $height = intval($match[2]);
2774
2775                                                                 $Image = new Image($data, $type);
2776                                                                 if ($Image->isValid()) {
2777                                                                         $Image->scaleDown(max($width, $height));
2778                                                                         $data = $Image->asString();
2779                                                                         $type = $Image->getType();
2780                                                                 }
2781                                                         }
2782
2783                                                         Logger::log('replacing photo', Logger::DEBUG);
2784                                                         $image = 'data:' . $type . ';base64,' . base64_encode($data);
2785                                                         Logger::log('replaced: ' . $image, Logger::DATA);
2786                                                 }
2787                                         }
2788                                 }
2789                         }
2790
2791                         $new_body = $new_body . substr($orig_body, 0, $img_start + $img_st_close) . $image . '[/img]';
2792                         $orig_body = substr($orig_body, $img_start + $img_st_close + $img_len + strlen('[/img]'));
2793                         if ($orig_body === false) {
2794                                 $orig_body = '';
2795                         }
2796
2797                         $img_start = strpos($orig_body, '[img');
2798                         $img_st_close = ($img_start !== false ? strpos(substr($orig_body, $img_start), ']') : false);
2799                         $img_len = ($img_start !== false ? strpos(substr($orig_body, $img_start + $img_st_close + 1), '[/img]') : false);
2800                 }
2801
2802                 $new_body = $new_body . $orig_body;
2803
2804                 return $new_body;
2805         }
2806
2807         private static function hasPermissions($obj)
2808         {
2809                 return !empty($obj['allow_cid']) || !empty($obj['allow_gid']) ||
2810                         !empty($obj['deny_cid']) || !empty($obj['deny_gid']);
2811         }
2812
2813         private static function samePermissions($obj1, $obj2)
2814         {
2815                 // first part is easy. Check that these are exactly the same.
2816                 if (($obj1['allow_cid'] == $obj2['allow_cid'])
2817                         && ($obj1['allow_gid'] == $obj2['allow_gid'])
2818                         && ($obj1['deny_cid'] == $obj2['deny_cid'])
2819                         && ($obj1['deny_gid'] == $obj2['deny_gid'])) {
2820                         return true;
2821                 }
2822
2823                 // This is harder. Parse all the permissions and compare the resulting set.
2824                 $recipients1 = self::enumeratePermissions($obj1);
2825                 $recipients2 = self::enumeratePermissions($obj2);
2826                 sort($recipients1);
2827                 sort($recipients2);
2828
2829                 /// @TODO Comparison of arrays, maybe use array_diff_assoc() here?
2830                 return ($recipients1 == $recipients2);
2831         }
2832
2833         // returns an array of contact-ids that are allowed to see this object
2834         public static function enumeratePermissions($obj)
2835         {
2836                 $allow_people = expand_acl($obj['allow_cid']);
2837                 $allow_groups = Group::expand(expand_acl($obj['allow_gid']));
2838                 $deny_people  = expand_acl($obj['deny_cid']);
2839                 $deny_groups  = Group::expand(expand_acl($obj['deny_gid']));
2840                 $recipients   = array_unique(array_merge($allow_people, $allow_groups));
2841                 $deny         = array_unique(array_merge($deny_people, $deny_groups));
2842                 $recipients   = array_diff($recipients, $deny);
2843                 return $recipients;
2844         }
2845
2846         public static function getFeedTags($item)
2847         {
2848                 $ret = [];
2849                 $matches = false;
2850                 $cnt = preg_match_all('|\#\[url\=(.*?)\](.*?)\[\/url\]|', $item['tag'], $matches);
2851                 if ($cnt) {
2852                         for ($x = 0; $x < $cnt; $x ++) {
2853                                 if ($matches[1][$x]) {
2854                                         $ret[$matches[2][$x]] = ['#', $matches[1][$x], $matches[2][$x]];
2855                                 }
2856                         }
2857                 }
2858                 $matches = false;
2859                 $cnt = preg_match_all('|\@\[url\=(.*?)\](.*?)\[\/url\]|', $item['tag'], $matches);
2860                 if ($cnt) {
2861                         for ($x = 0; $x < $cnt; $x ++) {
2862                                 if ($matches[1][$x]) {
2863                                         $ret[] = ['@', $matches[1][$x], $matches[2][$x]];
2864                                 }
2865                         }
2866                 }
2867                 return $ret;
2868         }
2869
2870         public static function expire($uid, $days, $network = "", $force = false)
2871         {
2872                 if (!$uid || ($days < 1)) {
2873                         return;
2874                 }
2875
2876                 $condition = ["`uid` = ? AND NOT `deleted` AND `id` = `parent` AND `gravity` = ?",
2877                         $uid, GRAVITY_PARENT];
2878
2879                 /*
2880                  * $expire_network_only = save your own wall posts
2881                  * and just expire conversations started by others
2882                  */
2883                 $expire_network_only = PConfig::get($uid, 'expire', 'network_only', false);
2884
2885                 if ($expire_network_only) {
2886                         $condition[0] .= " AND NOT `wall`";
2887                 }
2888
2889                 if ($network != "") {
2890                         $condition[0] .= " AND `network` = ?";
2891                         $condition[] = $network;
2892
2893                         /*
2894                          * There is an index "uid_network_received" but not "uid_network_created"
2895                          * This avoids the creation of another index just for one purpose.
2896                          * And it doesn't really matter wether to look at "received" or "created"
2897                          */
2898                         $condition[0] .= " AND `received` < UTC_TIMESTAMP() - INTERVAL ? DAY";
2899                         $condition[] = $days;
2900                 } else {
2901                         $condition[0] .= " AND `created` < UTC_TIMESTAMP() - INTERVAL ? DAY";
2902                         $condition[] = $days;
2903                 }
2904
2905                 $items = self::select(['file', 'resource-id', 'starred', 'type', 'id', 'post-type'], $condition);
2906
2907                 if (!DBA::isResult($items)) {
2908                         return;
2909                 }
2910
2911                 $expire_items = PConfig::get($uid, 'expire', 'items', true);
2912
2913                 // Forcing expiring of items - but not notes and marked items
2914                 if ($force) {
2915                         $expire_items = true;
2916                 }
2917
2918                 $expire_notes = PConfig::get($uid, 'expire', 'notes', true);
2919                 $expire_starred = PConfig::get($uid, 'expire', 'starred', true);
2920                 $expire_photos = PConfig::get($uid, 'expire', 'photos', false);
2921
2922                 $expired = 0;
2923
2924                 while ($item = Item::fetch($items)) {
2925                         // don't expire filed items
2926
2927                         if (strpos($item['file'], '[') !== false) {
2928                                 continue;
2929                         }
2930
2931                         // Only expire posts, not photos and photo comments
2932
2933                         if (!$expire_photos && strlen($item['resource-id'])) {
2934                                 continue;
2935                         } elseif (!$expire_starred && intval($item['starred'])) {
2936                                 continue;
2937                         } elseif (!$expire_notes && (($item['type'] == 'note') || ($item['post-type'] == Item::PT_PERSONAL_NOTE))) {
2938                                 continue;
2939                         } elseif (!$expire_items && ($item['type'] != 'note') && ($item['post-type'] != Item::PT_PERSONAL_NOTE)) {
2940                                 continue;
2941                         }
2942
2943                         self::deleteById($item['id'], PRIORITY_LOW);
2944
2945                         ++$expired;
2946                 }
2947                 DBA::close($items);
2948                 Logger::log('User ' . $uid . ": expired $expired items; expire items: $expire_items, expire notes: $expire_notes, expire starred: $expire_starred, expire photos: $expire_photos");
2949         }
2950
2951         public static function firstPostDate($uid, $wall = false)
2952         {
2953                 $condition = ['uid' => $uid, 'wall' => $wall, 'deleted' => false, 'visible' => true, 'moderated' => false];
2954                 $params = ['order' => ['created' => false]];
2955                 $thread = DBA::selectFirst('thread', ['created'], $condition, $params);
2956                 if (DBA::isResult($thread)) {
2957                         return substr(DateTimeFormat::local($thread['created']), 0, 10);
2958                 }
2959                 return false;
2960         }
2961
2962         /**
2963          * @brief add/remove activity to an item
2964          *
2965          * Toggle activities as like,dislike,attend of an item
2966          *
2967          * @param string $item_id
2968          * @param string $verb
2969          *              Activity verb. One of
2970          *                      like, unlike, dislike, undislike, attendyes, unattendyes,
2971          *                      attendno, unattendno, attendmaybe, unattendmaybe
2972          * @hook 'post_local_end'
2973          *              array $arr
2974          *                      'post_id' => ID of posted item
2975          */
2976         public static function performLike($item_id, $verb)
2977         {
2978                 if (!local_user() && !remote_user()) {
2979                         return false;
2980                 }
2981
2982                 switch ($verb) {
2983                         case 'like':
2984                         case 'unlike':
2985                                 $activity = ACTIVITY_LIKE;
2986                                 break;
2987                         case 'dislike':
2988                         case 'undislike':
2989                                 $activity = ACTIVITY_DISLIKE;
2990                                 break;
2991                         case 'attendyes':
2992                         case 'unattendyes':
2993                                 $activity = ACTIVITY_ATTEND;
2994                                 break;
2995                         case 'attendno':
2996                         case 'unattendno':
2997                                 $activity = ACTIVITY_ATTENDNO;
2998                                 break;
2999                         case 'attendmaybe':
3000                         case 'unattendmaybe':
3001                                 $activity = ACTIVITY_ATTENDMAYBE;
3002                                 break;
3003                         default:
3004                                 Logger::log('like: unknown verb ' . $verb . ' for item ' . $item_id);
3005                                 return false;
3006                 }
3007
3008                 // Enable activity toggling instead of on/off
3009                 $event_verb_flag = $activity === ACTIVITY_ATTEND || $activity === ACTIVITY_ATTENDNO || $activity === ACTIVITY_ATTENDMAYBE;
3010
3011                 Logger::log('like: verb ' . $verb . ' item ' . $item_id);
3012
3013                 $item = self::selectFirst(self::ITEM_FIELDLIST, ['`id` = ? OR `uri` = ?', $item_id, $item_id]);
3014                 if (!DBA::isResult($item)) {
3015                         Logger::log('like: unknown item ' . $item_id);
3016                         return false;
3017                 }
3018
3019                 $item_uri = $item['uri'];
3020
3021                 $uid = $item['uid'];
3022                 if (($uid == 0) && local_user()) {
3023                         $uid = local_user();
3024                 }
3025
3026                 if (!Security::canWriteToUserWall($uid)) {
3027                         Logger::log('like: unable to write on wall ' . $uid);
3028                         return false;
3029                 }
3030
3031                 // Retrieves the local post owner
3032                 $owner_self_contact = DBA::selectFirst('contact', [], ['uid' => $uid, 'self' => true]);
3033                 if (!DBA::isResult($owner_self_contact)) {
3034                         Logger::log('like: unknown owner ' . $uid);
3035                         return false;
3036                 }
3037
3038                 // Retrieve the current logged in user's public contact
3039                 $author_id = public_contact();
3040
3041                 $author_contact = DBA::selectFirst('contact', ['url'], ['id' => $author_id]);
3042                 if (!DBA::isResult($author_contact)) {
3043                         Logger::log('like: unknown author ' . $author_id);
3044                         return false;
3045                 }
3046
3047                 // Contact-id is the uid-dependant author contact
3048                 if (local_user() == $uid) {
3049                         $item_contact_id = $owner_self_contact['id'];
3050                         $item_contact = $owner_self_contact;
3051                 } else {
3052                         $item_contact_id = Contact::getIdForURL($author_contact['url'], $uid, true);
3053                         $item_contact = DBA::selectFirst('contact', [], ['id' => $item_contact_id]);
3054                         if (!DBA::isResult($item_contact)) {
3055                                 Logger::log('like: unknown item contact ' . $item_contact_id);
3056                                 return false;
3057                         }
3058                 }
3059
3060                 // Look for an existing verb row
3061                 // event participation are essentially radio toggles. If you make a subsequent choice,
3062                 // we need to eradicate your first choice.
3063                 if ($event_verb_flag) {
3064                         $verbs = [ACTIVITY_ATTEND, ACTIVITY_ATTENDNO, ACTIVITY_ATTENDMAYBE];
3065
3066                         // Translate to the index based activity index
3067                         $activities = [];
3068                         foreach ($verbs as $verb) {
3069                                 $activities[] = self::activityToIndex($verb);
3070                         }
3071                 } else {
3072                         $activities = self::activityToIndex($activity);
3073                 }
3074
3075                 $condition = ['activity' => $activities, 'deleted' => false, 'gravity' => GRAVITY_ACTIVITY,
3076                         'author-id' => $author_id, 'uid' => $item['uid'], 'thr-parent' => $item_uri];
3077
3078                 $like_item = self::selectFirst(['id', 'guid', 'verb'], $condition);
3079
3080                 // If it exists, mark it as deleted
3081                 if (DBA::isResult($like_item)) {
3082                         self::deleteById($like_item['id']);
3083
3084                         if (!$event_verb_flag || $like_item['verb'] == $activity) {
3085                                 return true;
3086                         }
3087                 }
3088
3089                 // Verb is "un-something", just trying to delete existing entries
3090                 if (strpos($verb, 'un') === 0) {
3091                         return true;
3092                 }
3093
3094                 $objtype = $item['resource-id'] ? ACTIVITY_OBJ_IMAGE : ACTIVITY_OBJ_NOTE;
3095
3096                 $new_item = [
3097                         'guid'          => System::createUUID(),
3098                         'uri'           => self::newURI($item['uid']),
3099                         'uid'           => $item['uid'],
3100                         'contact-id'    => $item_contact_id,
3101                         'wall'          => $item['wall'],
3102                         'origin'        => 1,
3103                         'network'       => Protocol::DFRN,
3104                         'gravity'       => GRAVITY_ACTIVITY,
3105                         'parent'        => $item['id'],
3106                         'parent-uri'    => $item['uri'],
3107                         'thr-parent'    => $item['uri'],
3108                         'owner-id'      => $author_id,
3109                         'author-id'     => $author_id,
3110                         'body'          => $activity,
3111                         'verb'          => $activity,
3112                         'object-type'   => $objtype,
3113                         'allow_cid'     => $item['allow_cid'],
3114                         'allow_gid'     => $item['allow_gid'],
3115                         'deny_cid'      => $item['deny_cid'],
3116                         'deny_gid'      => $item['deny_gid'],
3117                         'visible'       => 1,
3118                         'unseen'        => 1,
3119                 ];
3120
3121                 $signed = Diaspora::createLikeSignature($uid, $new_item);
3122                 if (!empty($signed)) {
3123                         $new_item['diaspora_signed_text'] = json_encode($signed);
3124                 }
3125
3126                 $new_item_id = self::insert($new_item);
3127
3128                 // If the parent item isn't visible then set it to visible
3129                 if (!$item['visible']) {
3130                         self::update(['visible' => true], ['id' => $item['id']]);
3131                 }
3132
3133                 $new_item['id'] = $new_item_id;
3134
3135                 Addon::callHooks('post_local_end', $new_item);
3136
3137                 return true;
3138         }
3139
3140         private static function addThread($itemid, $onlyshadow = false)
3141         {
3142                 $fields = ['uid', 'created', 'edited', 'commented', 'received', 'changed', 'wall', 'private', 'pubmail',
3143                         'moderated', 'visible', 'starred', 'contact-id', 'post-type',
3144                         'deleted', 'origin', 'forum_mode', 'mention', 'network', 'author-id', 'owner-id'];
3145                 $condition = ["`id` = ? AND (`parent` = ? OR `parent` = 0)", $itemid, $itemid];
3146                 $item = self::selectFirst($fields, $condition);
3147
3148                 if (!DBA::isResult($item)) {
3149                         return;
3150                 }
3151
3152                 $item['iid'] = $itemid;
3153
3154                 if (!$onlyshadow) {
3155                         $result = DBA::insert('thread', $item);
3156
3157                         Logger::log("Add thread for item ".$itemid." - ".print_r($result, true), Logger::DEBUG);
3158                 }
3159         }
3160
3161         private static function updateThread($itemid, $setmention = false)
3162         {
3163                 $fields = ['uid', 'guid', 'created', 'edited', 'commented', 'received', 'changed', 'post-type',
3164                         'wall', 'private', 'pubmail', 'moderated', 'visible', 'starred', 'contact-id',
3165                         'deleted', 'origin', 'forum_mode', 'network', 'author-id', 'owner-id'];
3166                 $condition = ["`id` = ? AND (`parent` = ? OR `parent` = 0)", $itemid, $itemid];
3167
3168                 $item = self::selectFirst($fields, $condition);
3169                 if (!DBA::isResult($item)) {
3170                         return;
3171                 }
3172
3173                 if ($setmention) {
3174                         $item["mention"] = 1;
3175                 }
3176
3177                 $sql = "";
3178
3179                 $fields = [];
3180
3181                 foreach ($item as $field => $data) {
3182                         if (!in_array($field, ["guid"])) {
3183                                 $fields[$field] = $data;
3184                         }
3185                 }
3186
3187                 $result = DBA::update('thread', $fields, ['iid' => $itemid]);
3188
3189                 Logger::log("Update thread for item ".$itemid." - guid ".$item["guid"]." - ".(int)$result, Logger::DEBUG);
3190         }
3191
3192         private static function deleteThread($itemid, $itemuri = "")
3193         {
3194                 $item = DBA::selectFirst('thread', ['uid'], ['iid' => $itemid]);
3195                 if (!DBA::isResult($item)) {
3196                         Logger::log('No thread found for id '.$itemid, Logger::DEBUG);
3197                         return;
3198                 }
3199
3200                 $result = DBA::delete('thread', ['iid' => $itemid], ['cascade' => false]);
3201
3202                 Logger::log("deleteThread: Deleted thread for item ".$itemid." - ".print_r($result, true), Logger::DEBUG);
3203
3204                 if ($itemuri != "") {
3205                         $condition = ["`uri` = ? AND NOT `deleted` AND NOT (`uid` IN (?, 0))", $itemuri, $item["uid"]];
3206                         if (!self::exists($condition)) {
3207                                 DBA::delete('item', ['uri' => $itemuri, 'uid' => 0]);
3208                                 Logger::log("deleteThread: Deleted shadow for item ".$itemuri, Logger::DEBUG);
3209                         }
3210                 }
3211         }
3212
3213         public static function getPermissionsSQLByUserId($owner_id, $remote_verified = false, $groups = null, $remote_cid = null)
3214         {
3215                 $local_user = local_user();
3216                 $remote_user = remote_user();
3217
3218                 /*
3219                  * Construct permissions
3220                  *
3221                  * default permissions - anonymous user
3222                  */
3223                 $sql = " AND NOT `item`.`private`";
3224
3225                 // Profile owner - everything is visible
3226                 if ($local_user && ($local_user == $owner_id)) {
3227                         $sql = '';
3228                 } elseif ($remote_user) {
3229                         /*
3230                          * Authenticated visitor. Unless pre-verified,
3231                          * check that the contact belongs to this $owner_id
3232                          * and load the groups the visitor belongs to.
3233                          * If pre-verified, the caller is expected to have already
3234                          * done this and passed the groups into this function.
3235                          */
3236                         $set = PermissionSet::get($owner_id, $remote_cid, $groups);
3237
3238                         if (!empty($set)) {
3239                                 $sql_set = " OR (`item`.`private` IN (1,2) AND `item`.`wall` AND `item`.`psid` IN (" . implode(',', $set) . "))";
3240                         } else {
3241                                 $sql_set = '';
3242                         }
3243
3244                         $sql = " AND (NOT `item`.`private`" . $sql_set . ")";
3245                 }
3246
3247                 return $sql;
3248         }
3249
3250         /**
3251          * get translated item type
3252          *
3253          * @param array $itme
3254          * @return string
3255          */
3256         public static function postType($item)
3257         {
3258                 if (!empty($item['event-id'])) {
3259                         return L10n::t('event');
3260                 } elseif (!empty($item['resource-id'])) {
3261                         return L10n::t('photo');
3262                 } elseif (!empty($item['verb']) && $item['verb'] !== ACTIVITY_POST) {
3263                         return L10n::t('activity');
3264                 } elseif ($item['id'] != $item['parent']) {
3265                         return L10n::t('comment');
3266                 }
3267
3268                 return L10n::t('post');
3269         }
3270
3271         /**
3272          * Sets the "rendered-html" field of the provided item
3273          *
3274          * Body is preserved to avoid side-effects as we modify it just-in-time for spoilers and private image links
3275          *
3276          * @param array $item
3277          * @param bool  $update
3278          *
3279          * @todo Remove reference, simply return "rendered-html" and "rendered-hash"
3280          */
3281         public static function putInCache(&$item, $update = false)
3282         {
3283                 $body = $item["body"];
3284
3285                 $rendered_hash = defaults($item, 'rendered-hash', '');
3286                 $rendered_html = defaults($item, 'rendered-html', '');
3287
3288                 if ($rendered_hash == ''
3289                         || $rendered_html == ""
3290                         || $rendered_hash != hash("md5", $item["body"])
3291                         || Config::get("system", "ignore_cache")
3292                 ) {
3293                         $a = self::getApp();
3294                         redir_private_images($a, $item);
3295
3296                         $item["rendered-html"] = prepare_text($item["body"]);
3297                         $item["rendered-hash"] = hash("md5", $item["body"]);
3298
3299                         $hook_data = ['item' => $item, 'rendered-html' => $item['rendered-html'], 'rendered-hash' => $item['rendered-hash']];
3300                         Addon::callHooks('put_item_in_cache', $hook_data);
3301                         $item['rendered-html'] = $hook_data['rendered-html'];
3302                         $item['rendered-hash'] = $hook_data['rendered-hash'];
3303                         unset($hook_data);
3304
3305                         // Force an update if the generated values differ from the existing ones
3306                         if ($rendered_hash != $item["rendered-hash"]) {
3307                                 $update = true;
3308                         }
3309
3310                         // Only compare the HTML when we forcefully ignore the cache
3311                         if (Config::get("system", "ignore_cache") && ($rendered_html != $item["rendered-html"])) {
3312                                 $update = true;
3313                         }
3314
3315                         if ($update && !empty($item["id"])) {
3316                                 self::update(
3317                                         [
3318                                                 'rendered-html' => $item["rendered-html"],
3319                                                 'rendered-hash' => $item["rendered-hash"]
3320                                         ],
3321                                         ['id' => $item["id"]]
3322                                 );
3323                         }
3324                 }
3325
3326                 $item["body"] = $body;
3327         }
3328
3329         /**
3330          * @brief Given an item array, convert the body element from bbcode to html and add smilie icons.
3331          * If attach is true, also add icons for item attachments.
3332          *
3333          * @param array   $item
3334          * @param boolean $attach
3335          * @param boolean $is_preview
3336          * @return string item body html
3337          * @hook prepare_body_init item array before any work
3338          * @hook prepare_body_content_filter ('item'=>item array, 'filter_reasons'=>string array) before first bbcode to html
3339          * @hook prepare_body ('item'=>item array, 'html'=>body string, 'is_preview'=>boolean, 'filter_reasons'=>string array) after first bbcode to html
3340          * @hook prepare_body_final ('item'=>item array, 'html'=>body string) after attach icons and blockquote special case handling (spoiler, author)
3341          */
3342         public static function prepareBody(array &$item, $attach = false, $is_preview = false)
3343         {
3344                 $a = self::getApp();
3345                 Addon::callHooks('prepare_body_init', $item);
3346
3347                 // In order to provide theme developers more possibilities, event items
3348                 // are treated differently.
3349                 if ($item['object-type'] === ACTIVITY_OBJ_EVENT && isset($item['event-id'])) {
3350                         $ev = Event::getItemHTML($item);
3351                         return $ev;
3352                 }
3353
3354                 $tags = Term::populateTagsFromItem($item);
3355
3356                 $item['tags'] = $tags['tags'];
3357                 $item['hashtags'] = $tags['hashtags'];
3358                 $item['mentions'] = $tags['mentions'];
3359
3360                 // Compile eventual content filter reasons
3361                 $filter_reasons = [];
3362                 if (!$is_preview && public_contact() != $item['author-id']) {
3363                         if (!empty($item['content-warning']) && (!local_user() || !PConfig::get(local_user(), 'system', 'disable_cw', false))) {
3364                                 $filter_reasons[] = L10n::t('Content warning: %s', $item['content-warning']);
3365                         }
3366
3367                         $hook_data = [
3368                                 'item' => $item,
3369                                 'filter_reasons' => $filter_reasons
3370                         ];
3371                         Addon::callHooks('prepare_body_content_filter', $hook_data);
3372                         $filter_reasons = $hook_data['filter_reasons'];
3373                         unset($hook_data);
3374                 }
3375
3376                 // Update the cached values if there is no "zrl=..." on the links.
3377                 $update = (!local_user() && !remote_user() && ($item["uid"] == 0));
3378
3379                 // Or update it if the current viewer is the intented viewer.
3380                 if (($item["uid"] == local_user()) && ($item["uid"] != 0)) {
3381                         $update = true;
3382                 }
3383
3384                 self::putInCache($item, $update);
3385                 $s = $item["rendered-html"];
3386
3387                 $hook_data = [
3388                         'item' => $item,
3389                         'html' => $s,
3390                         'preview' => $is_preview,
3391                         'filter_reasons' => $filter_reasons
3392                 ];
3393                 Addon::callHooks('prepare_body', $hook_data);
3394                 $s = $hook_data['html'];
3395                 unset($hook_data);
3396
3397                 if (!$attach) {
3398                         // Replace the blockquotes with quotes that are used in mails.
3399                         $mailquote = '<blockquote type="cite" class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">';
3400                         $s = str_replace(['<blockquote>', '<blockquote class="spoiler">', '<blockquote class="author">'], [$mailquote, $mailquote, $mailquote], $s);
3401                         return $s;
3402                 }
3403
3404                 $as = '';
3405                 $vhead = false;
3406                 $matches = [];
3407                 preg_match_all('|\[attach\]href=\"(.*?)\" length=\"(.*?)\" type=\"(.*?)\"(?: title=\"(.*?)\")?|', $item['attach'], $matches, PREG_SET_ORDER);
3408                 foreach ($matches as $mtch) {
3409                         $mime = $mtch[3];
3410
3411                         $the_url = Contact::magicLinkById($item['author-id'], $mtch[1]);
3412
3413                         if (strpos($mime, 'video') !== false) {
3414                                 if (!$vhead) {
3415                                         $vhead = true;
3416                                         $a->page['htmlhead'] .= Renderer::replaceMacros(Renderer::getMarkupTemplate('videos_head.tpl'), [
3417                                                 '$baseurl' => System::baseUrl(),
3418                                         ]);
3419                                 }
3420
3421                                 $url_parts = explode('/', $the_url);
3422                                 $id = end($url_parts);
3423                                 $as .= Renderer::replaceMacros(Renderer::getMarkupTemplate('video_top.tpl'), [
3424                                         '$video' => [
3425                                                 'id'     => $id,
3426                                                 'title'  => L10n::t('View Video'),
3427                                                 'src'    => $the_url,
3428                                                 'mime'   => $mime,
3429                                         ],
3430                                 ]);
3431                         }
3432
3433                         $filetype = strtolower(substr($mime, 0, strpos($mime, '/')));
3434                         if ($filetype) {
3435                                 $filesubtype = strtolower(substr($mime, strpos($mime, '/') + 1));
3436                                 $filesubtype = str_replace('.', '-', $filesubtype);
3437                         } else {
3438                                 $filetype = 'unkn';
3439                                 $filesubtype = 'unkn';
3440                         }
3441
3442                         $title = Strings::escapeHtml(trim(defaults($mtch, 4, $mtch[1])));
3443                         $title .= ' ' . $mtch[2] . ' ' . L10n::t('bytes');
3444
3445                         $icon = '<div class="attachtype icon s22 type-' . $filetype . ' subtype-' . $filesubtype . '"></div>';
3446                         $as .= '<a href="' . strip_tags($the_url) . '" title="' . $title . '" class="attachlink" target="_blank" >' . $icon . '</a>';
3447                 }
3448
3449                 if ($as != '') {
3450                         $s .= '<div class="body-attach">'.$as.'<div class="clear"></div></div>';
3451                 }
3452
3453                 // Map.
3454                 if (strpos($s, '<div class="map">') !== false && !empty($item['coord'])) {
3455                         $x = Map::byCoordinates(trim($item['coord']));
3456                         if ($x) {
3457                                 $s = preg_replace('/\<div class\=\"map\"\>/', '$0' . $x, $s);
3458                         }
3459                 }
3460
3461
3462                 // Look for spoiler.
3463                 $spoilersearch = '<blockquote class="spoiler">';
3464
3465                 // Remove line breaks before the spoiler.
3466                 while ((strpos($s, "\n" . $spoilersearch) !== false)) {
3467                         $s = str_replace("\n" . $spoilersearch, $spoilersearch, $s);
3468                 }
3469                 while ((strpos($s, "<br />" . $spoilersearch) !== false)) {
3470                         $s = str_replace("<br />" . $spoilersearch, $spoilersearch, $s);
3471                 }
3472
3473                 while ((strpos($s, $spoilersearch) !== false)) {
3474                         $pos = strpos($s, $spoilersearch);
3475                         $rnd = Strings::getRandomHex(8);
3476                         $spoilerreplace = '<br /> <span id="spoiler-wrap-' . $rnd . '" class="spoiler-wrap fakelink" onclick="openClose(\'spoiler-' . $rnd . '\');">' . L10n::t('Click to open/close') . '</span>'.
3477                                                 '<blockquote class="spoiler" id="spoiler-' . $rnd . '" style="display: none;">';
3478                         $s = substr($s, 0, $pos) . $spoilerreplace . substr($s, $pos + strlen($spoilersearch));
3479                 }
3480
3481                 // Look for quote with author.
3482                 $authorsearch = '<blockquote class="author">';
3483
3484                 while ((strpos($s, $authorsearch) !== false)) {
3485                         $pos = strpos($s, $authorsearch);
3486                         $rnd = Strings::getRandomHex(8);
3487                         $authorreplace = '<br /> <span id="author-wrap-' . $rnd . '" class="author-wrap fakelink" onclick="openClose(\'author-' . $rnd . '\');">' . L10n::t('Click to open/close') . '</span>'.
3488                                                 '<blockquote class="author" id="author-' . $rnd . '" style="display: block;">';
3489                         $s = substr($s, 0, $pos) . $authorreplace . substr($s, $pos + strlen($authorsearch));
3490                 }
3491
3492                 // Replace friendica image url size with theme preference.
3493                 if (!empty($a->theme_info['item_image_size'])) {
3494                         $ps = $a->theme_info['item_image_size'];
3495                         $s = preg_replace('|(<img[^>]+src="[^"]+/photo/[0-9a-f]+)-[0-9]|', "$1-" . $ps, $s);
3496                 }
3497
3498                 $s = HTML::applyContentFilter($s, $filter_reasons);
3499
3500                 $hook_data = ['item' => $item, 'html' => $s];
3501                 Addon::callHooks('prepare_body_final', $hook_data);
3502
3503                 return $hook_data['html'];
3504         }
3505
3506         /**
3507          * get private link for item
3508          * @param array $item
3509          * @return boolean|array False if item has not plink, otherwise array('href'=>plink url, 'title'=>translated title)
3510          */
3511         public static function getPlink($item)
3512         {
3513                 $a = self::getApp();
3514
3515                 if ($a->user['nickname'] != "") {
3516                         $ret = [
3517                                 'href' => "display/" . $item['guid'],
3518                                 'orig' => "display/" . $item['guid'],
3519                                 'title' => L10n::t('View on separate page'),
3520                                 'orig_title' => L10n::t('view on separate page'),
3521                         ];
3522
3523                         if (!empty($item['plink'])) {
3524                                 $ret["href"] = $a->removeBaseURL($item['plink']);
3525                                 $ret["title"] = L10n::t('link to source');
3526                         }
3527
3528                 } elseif (!empty($item['plink']) && ($item['private'] != 1)) {
3529                         $ret = [
3530                                 'href' => $item['plink'],
3531                                 'orig' => $item['plink'],
3532                                 'title' => L10n::t('link to source'),
3533                         ];
3534                 } else {
3535                         $ret = [];
3536                 }
3537
3538                 return $ret;
3539         }
3540 }