]> git.mxchange.org Git - friendica.git/blob - include/notifier.php
17eb578d18a0b80d485a2e36ea506cf0987f1215
[friendica.git] / include / notifier.php
1 <?php
2
3 use Friendica\App;
4 use Friendica\Core\Config;
5
6 require_once 'include/queue_fn.php';
7 require_once 'include/html2plain.php';
8 require_once 'include/probe.php';
9 require_once 'include/diaspora.php';
10 require_once 'include/ostatus.php';
11 require_once 'include/salmon.php';
12
13 /*
14  * This file was at one time responsible for doing all deliveries, but this caused
15  * big problems when the process was killed or stalled during the delivery process.
16  * It now invokes separate queues that are delivering via delivery.php and pubsubpublish.php.
17  */
18
19 /*
20  * The notifier is typically called with:
21  *
22  *              proc_run(PRIORITY_HIGH, "include/notifier.php", COMMAND, ITEM_ID);
23  *
24  * where COMMAND is one of the following:
25  *
26  *              activity                                (in diaspora.php, dfrn_confirm.php, profiles.php)
27  *              comment-import                  (in diaspora.php, items.php)
28  *              comment-new                             (in item.php)
29  *              drop                                    (in diaspora.php, items.php, photos.php)
30  *              edit_post                               (in item.php)
31  *              event                                   (in events.php)
32  *              expire                                  (in items.php)
33  *              like                                    (in like.php, poke.php)
34  *              mail                                    (in message.php)
35  *              suggest                                 (in fsuggest.php)
36  *              tag                                             (in photos.php, poke.php, tagger.php)
37  *              tgroup                                  (in items.php)
38  *              wall-new                                (in photos.php, item.php)
39  *              removeme                                (in Contact.php)
40  *              relocate                                (in uimport.php)
41  *
42  * and ITEM_ID is the id of the item in the database that needs to be sent to others.
43  */
44
45
46 function notifier_run(&$argv, &$argc){
47         global $a;
48
49         require_once 'include/datetime.php';
50         require_once 'include/items.php';
51         require_once 'include/bbcode.php';
52         require_once 'include/email.php';
53
54         if ($argc < 3) {
55                 return;
56         }
57
58         logger('notifier: invoked: ' . print_r($argv,true), LOGGER_DEBUG);
59
60         $cmd = $argv[1];
61
62         switch($cmd) {
63                 case 'mail':
64                 default:
65                         $item_id = intval($argv[2]);
66                         if (! $item_id) {
67                                 return;
68                         }
69                         break;
70         }
71
72         $expire = false;
73         $mail = false;
74         $fsuggest = false;
75         $relocate = false;
76         $top_level = false;
77         $recipients = array();
78         $url_recipients = array();
79
80         $normal_mode = true;
81
82         if ($cmd === 'mail') {
83                 $normal_mode = false;
84                 $mail = true;
85                 $message = q("SELECT * FROM `mail` WHERE `id` = %d LIMIT 1",
86                                 intval($item_id)
87                 );
88                 if (! count($message)) {
89                         return;
90                 }
91                 $uid = $message[0]['uid'];
92                 $recipients[] = $message[0]['contact-id'];
93                 $item = $message[0];
94
95         } elseif ($cmd === 'expire') {
96                 $normal_mode = false;
97                 $expire = true;
98                 $items = q("SELECT * FROM `item` WHERE `uid` = %d AND `wall` = 1
99                         AND `deleted` = 1 AND `changed` > UTC_TIMESTAMP() - INTERVAL 10 MINUTE",
100                         intval($item_id)
101                 );
102                 $uid = $item_id;
103                 $item_id = 0;
104                 if (! count($items)) {
105                         return;
106                 }
107         } elseif ($cmd === 'suggest') {
108                 $normal_mode = false;
109                 $fsuggest = true;
110
111                 $suggest = q("SELECT * FROM `fsuggest` WHERE `id` = %d LIMIT 1",
112                         intval($item_id)
113                 );
114                 if (! count($suggest)) {
115                         return;
116                 }
117                 $uid = $suggest[0]['uid'];
118                 $recipients[] = $suggest[0]['cid'];
119                 $item = $suggest[0];
120         } elseif ($cmd === 'removeme') {
121                 $r = q("SELECT `contact`.*, `user`.`pubkey` AS `upubkey`, `user`.`prvkey` AS `uprvkey`,
122                                 `user`.`timezone`, `user`.`nickname`, `user`.`sprvkey`, `user`.`spubkey`,
123                                 `user`.`page-flags`, `user`.`prvnets`, `user`.`account-type`, `user`.`guid`
124                         FROM `contact` INNER JOIN `user` ON `user`.`uid` = `contact`.`uid`
125                                 WHERE `contact`.`uid` = %d AND `contact`.`self` LIMIT 1",
126                                 intval($item_id));
127                 if (!$r)
128                         return;
129
130                 $user = $r[0];
131
132                 $r = q("SELECT * FROM `contact` WHERE `uid` = %d AND `self` LIMIT 1", intval($item_id));
133                 if (!$r)
134                         return;
135
136                 $self = $r[0];
137
138                 $r = q("SELECT * FROM `contact` WHERE NOT `self` AND `uid` = %d", intval($item_id));
139                 if (!$r) {
140                         return;
141                 }
142                 require_once 'include/Contact.php';
143                 foreach ($r as $contact) {
144                         terminate_friendship($user, $self, $contact);
145                 }
146                 return;
147         } elseif ($cmd === 'relocate') {
148                 $normal_mode = false;
149                 $relocate = true;
150                 $uid = $item_id;
151
152                 $recipients_relocate = q("SELECT * FROM `contact` WHERE `uid` = %d AND NOT `self` AND `network` IN ('%s', '%s')",
153                                         intval($uid), NETWORK_DFRN, NETWORK_DIASPORA);
154         } else {
155                 // find ancestors
156                 $r = q("SELECT * FROM `item` WHERE `id` = %d AND visible = 1 AND moderated = 0 LIMIT 1",
157                         intval($item_id)
158                 );
159
160                 if ((! dbm::is_result($r)) || (! intval($r[0]['parent']))) {
161                         return;
162                 }
163
164                 $target_item = $r[0];
165                 $parent_id = intval($r[0]['parent']);
166                 $uid = $r[0]['uid'];
167                 $updated = $r[0]['edited'];
168
169                 $items = q("SELECT `item`.*, `sign`.`signed_text`,`sign`.`signature`,`sign`.`signer`
170                         FROM `item` LEFT JOIN `sign` ON `sign`.`iid` = `item`.`id` WHERE `parent` = %d AND visible = 1 AND moderated = 0 ORDER BY `id` ASC",
171                         intval($parent_id)
172                 );
173
174                 if (! count($items)) {
175                         return;
176                 }
177
178                 // avoid race condition with deleting entries
179
180                 if ($items[0]['deleted']) {
181                         foreach ($items as $item) {
182                                 $item['deleted'] = 1;
183                         }
184                 }
185
186                 if ((count($items) == 1) && ($items[0]['id'] === $target_item['id']) && ($items[0]['uri'] === $items[0]['parent-uri'])) {
187                         logger('notifier: top level post');
188                         $top_level = true;
189                 }
190
191         }
192
193         $r = q("SELECT `contact`.*, `user`.`pubkey` AS `upubkey`, `user`.`prvkey` AS `uprvkey`,
194                 `user`.`timezone`, `user`.`nickname`, `user`.`sprvkey`, `user`.`spubkey`,
195                 `user`.`page-flags`, `user`.`prvnets`, `user`.`account-type`
196                 FROM `contact` INNER JOIN `user` ON `user`.`uid` = `contact`.`uid`
197                 WHERE `contact`.`uid` = %d AND `contact`.`self` = 1 LIMIT 1",
198                 intval($uid)
199         );
200
201         if (! dbm::is_result($r)) {
202                 return;
203         }
204
205         $owner = $r[0];
206
207         $walltowall = ((($top_level) && ($owner['id'] != $items[0]['contact-id'])) ? true : false);
208
209         // Should the post be transmitted to Diaspora?
210         $diaspora_delivery = true;
211
212         // If this is a public conversation, notify the feed hub
213         $public_message = true;
214
215         // Do a PuSH
216         $push_notify = false;
217
218         // fill this in with a single salmon slap if applicable
219         $slap = '';
220
221         if (! ($mail || $fsuggest || $relocate)) {
222
223                 $slap = ostatus::salmon($target_item,$owner);
224
225                 require_once 'include/group.php';
226
227                 $parent = $items[0];
228
229                 $thr_parent = q("SELECT `network`, `author-link`, `owner-link` FROM `item` WHERE `uri` = '%s' AND `uid` = %d",
230                         dbesc($target_item["thr-parent"]), intval($target_item["uid"]));
231
232                 logger('GUID: '.$target_item["guid"].': Parent is '.$parent['network'].'. Thread parent is '.$thr_parent[0]['network'], LOGGER_DEBUG);
233
234                 // This is IMPORTANT!!!!
235
236                 // We will only send a "notify owner to relay" or followup message if the referenced post
237                 // originated on our system by virtue of having our hostname somewhere
238                 // in the URI, AND it was a comment (not top_level) AND the parent originated elsewhere.
239
240                 // if $parent['wall'] == 1 we will already have the parent message in our array
241                 // and we will relay the whole lot.
242
243                 // expire sends an entire group of expire messages and cannot be forwarded.
244                 // However the conversation owner will be a part of the conversation and will
245                 // be notified during this run.
246                 // Other DFRN conversation members will be alerted during polled updates.
247
248
249
250                 // Diaspora members currently are not notified of expirations, and other networks have
251                 // either limited or no ability to process deletions. We should at least fix Diaspora
252                 // by stringing togther an array of retractions and sending them onward.
253
254
255                 $localhost = str_replace('www.','',$a->get_hostname());
256                 if (strpos($localhost,':')) {
257                         $localhost = substr($localhost,0,strpos($localhost,':'));
258                 }
259                 /**
260                  *
261                  * Be VERY CAREFUL if you make any changes to the following several lines. Seemingly innocuous changes
262                  * have been known to cause runaway conditions which affected several servers, along with
263                  * permissions issues.
264                  *
265                  */
266
267                 $relay_to_owner = false;
268
269                 if (!$top_level && ($parent['wall'] == 0) && !$expire && (stristr($target_item['uri'],$localhost))) {
270                         $relay_to_owner = true;
271                 }
272
273
274                 if (($cmd === 'uplink') && (intval($parent['forum_mode']) == 1) && !$top_level) {
275                         $relay_to_owner = true;
276                 }
277
278                 // until the 'origin' flag has been in use for several months
279                 // we will just use it as a fallback test
280                 // later we will be able to use it as the primary test of whether or not to relay.
281
282                 if (! $target_item['origin']) {
283                         $relay_to_owner = false;
284                 }
285                 if ($parent['origin']) {
286                         $relay_to_owner = false;
287                 }
288
289                 // Special treatment for forum posts
290                 if (($target_item['author-link'] != $target_item['owner-link']) &&
291                         ($owner['id'] != $target_item['contact-id']) &&
292                         ($target_item['uri'] === $target_item['parent-uri'])) {
293
294                         $fields = array('forum', 'prv');
295                         $condition = array('id' => $target_item['contact-id']);
296                         $contact = dba::select('contact', $fields, $condition, array('limit' => 1));
297                         if (!dbm::is_result($contact)) {
298                                 // Should never happen
299                                 return false;
300                         }
301
302                         // Is the post from a forum?
303                         if ($contact['forum'] || $contact['prv']) {
304                                 $relay_to_owner = true;
305                         }
306                 }
307                 if ($relay_to_owner) {
308                         logger('notifier: followup '.$target_item["guid"], LOGGER_DEBUG);
309                         // local followup to remote post
310                         $followup = true;
311                         $public_message = false; // not public
312                         $conversant_str = dbesc($parent['contact-id']);
313                         $recipients = array($parent['contact-id']);
314                         $recipients_followup  = array($parent['contact-id']);
315
316                         //if (!$target_item['private'] && $target_item['wall'] &&
317                         if (!$target_item['private'] &&
318                                 (strlen($target_item['allow_cid'].$target_item['allow_gid'].
319                                         $target_item['deny_cid'].$target_item['deny_gid']) == 0))
320                                 $push_notify = true;
321
322                         if (($thr_parent && ($thr_parent[0]['network'] == NETWORK_OSTATUS)) || ($parent['network'] == NETWORK_OSTATUS)) {
323
324                                 $push_notify = true;
325
326                                 if ($parent["network"] == NETWORK_OSTATUS) {
327                                         // Distribute the message to the DFRN contacts as if this wasn't a followup since OStatus can't relay comments
328                                         // Currently it is work at progress
329                                         $r = q("SELECT `id` FROM `contact` WHERE `uid` = %d AND `network` = '%s' AND NOT `blocked` AND NOT `pending` AND NOT `archive`",
330                                                 intval($uid),
331                                                 dbesc(NETWORK_DFRN)
332                                         );
333                                         if (dbm::is_result($r)) {
334                                                 foreach ($r as $rr) {
335                                                         $recipients_followup[] = $rr['id'];
336                                                 }
337                                         }
338                                 }
339                         }
340                         logger("Notify ".$target_item["guid"]." via PuSH: ".($push_notify?"Yes":"No"), LOGGER_DEBUG);
341                 } else {
342                         $followup = false;
343
344                         logger('Distributing directly '.$target_item["guid"], LOGGER_DEBUG);
345
346                         // don't send deletions onward for other people's stuff
347
348                         if ($target_item['deleted'] && (! intval($target_item['wall']))) {
349                                 logger('notifier: ignoring delete notification for non-wall item');
350                                 return;
351                         }
352
353                         if ((strlen($parent['allow_cid']))
354                                 || (strlen($parent['allow_gid']))
355                                 || (strlen($parent['deny_cid']))
356                                 || (strlen($parent['deny_gid']))) {
357                                 $public_message = false; // private recipients, not public
358                         }
359
360                         $allow_people = expand_acl($parent['allow_cid']);
361                         $allow_groups = expand_groups(expand_acl($parent['allow_gid']),true);
362                         $deny_people  = expand_acl($parent['deny_cid']);
363                         $deny_groups  = expand_groups(expand_acl($parent['deny_gid']));
364
365                         // if our parent is a public forum (forum_mode == 1), uplink to the origional author causing
366                         // a delivery fork. private groups (forum_mode == 2) do not uplink
367
368                         if ((intval($parent['forum_mode']) == 1) && (! $top_level) && ($cmd !== 'uplink')) {
369                                 proc_run($a->queue['priority'], 'include/notifier.php', 'uplink', $item_id);
370                         }
371
372                         $conversants = array();
373
374                         foreach ($items as $item) {
375                                 $recipients[] = $item['contact-id'];
376                                 $conversants[] = $item['contact-id'];
377                                 // pull out additional tagged people to notify (if public message)
378                                 if ($public_message && strlen($item['inform'])) {
379                                         $people = explode(',',$item['inform']);
380                                         foreach ($people as $person) {
381                                                 if (substr($person,0,4) === 'cid:') {
382                                                         $recipients[] = intval(substr($person,4));
383                                                         $conversants[] = intval(substr($person,4));
384                                                 } else {
385                                                         $url_recipients[] = substr($person,4);
386                                                 }
387                                         }
388                                 }
389                         }
390
391                         if (count($url_recipients))
392                                 logger('notifier: '.$target_item["guid"].' url_recipients ' . print_r($url_recipients,true));
393
394                         $conversants = array_unique($conversants);
395
396
397                         $recipients = array_unique(array_merge($recipients,$allow_people,$allow_groups));
398                         $deny = array_unique(array_merge($deny_people,$deny_groups));
399                         $recipients = array_diff($recipients,$deny);
400
401                         $conversant_str = dbesc(implode(', ',$conversants));
402                 }
403
404                 // If the thread parent is OStatus then do some magic to distribute the messages.
405                 // We have not only to look at the parent, since it could be a Friendica thread.
406                 if (($thr_parent && ($thr_parent[0]['network'] == NETWORK_OSTATUS)) || ($parent['network'] == NETWORK_OSTATUS)) {
407
408                         $diaspora_delivery = false;
409
410                         logger('Some parent is OStatus for '.$target_item["guid"]." - Author: ".$thr_parent[0]['author-link']." - Owner: ".$thr_parent[0]['owner-link'], LOGGER_DEBUG);
411
412                         // Send a salmon to the parent author
413                         $r = q("SELECT `url`, `notify` FROM `contact` WHERE `nurl`='%s' AND `uid` IN (0, %d) AND `notify` != ''",
414                                 dbesc(normalise_link($thr_parent[0]['author-link'])),
415                                 intval($uid));
416                         if (dbm::is_result($r)) {
417                                 $probed_contact = $r[0];
418                         } else {
419                                 $probed_contact = probe_url($thr_parent[0]['author-link']);
420                         }
421
422                         if ($probed_contact["notify"] != "") {
423                                 logger('Notify parent author '.$probed_contact["url"].': '.$probed_contact["notify"]);
424                                 $url_recipients[$probed_contact["notify"]] = $probed_contact["notify"];
425                         }
426
427                         // Send a salmon to the parent owner
428                         $r = q("SELECT `url`, `notify` FROM `contact` WHERE `nurl`='%s' AND `uid` IN (0, %d) AND `notify` != ''",
429                                 dbesc(normalise_link($thr_parent[0]['owner-link'])),
430                                 intval($uid));
431                         if (dbm::is_result($r)) {
432                                 $probed_contact = $r[0];
433                         } else {
434                                 $probed_contact = probe_url($thr_parent[0]['owner-link']);
435                         }
436
437                         if ($probed_contact["notify"] != "") {
438                                 logger('Notify parent owner '.$probed_contact["url"].': '.$probed_contact["notify"]);
439                                 $url_recipients[$probed_contact["notify"]] = $probed_contact["notify"];
440                         }
441
442                         // Send a salmon notification to every person we mentioned in the post
443                         $arr = explode(',',$target_item['tag']);
444                         foreach ($arr as $x) {
445                                 //logger('Checking tag '.$x, LOGGER_DEBUG);
446                                 $matches = null;
447                                 if (preg_match('/@\[url=([^\]]*)\]/',$x,$matches)) {
448                                                 $probed_contact = probe_url($matches[1]);
449                                         if ($probed_contact["notify"] != "") {
450                                                 logger('Notify mentioned user '.$probed_contact["url"].': '.$probed_contact["notify"]);
451                                                 $url_recipients[$probed_contact["notify"]] = $probed_contact["notify"];
452                                         }
453                                 }
454                         }
455
456                         // It only makes sense to distribute answers to OStatus messages to Friendica and OStatus - but not Diaspora
457                         $sql_extra = " AND `network` IN ('".NETWORK_OSTATUS."', '".NETWORK_DFRN."')";
458                 } else {
459                         $sql_extra = " AND `network` IN ('".NETWORK_OSTATUS."', '".NETWORK_DFRN."', '".NETWORK_DIASPORA."', '".NETWORK_MAIL."', '".NETWORK_MAIL2."')";
460                 }
461         } else {
462                 $public_message = false;
463         }
464
465         // If this is a public message and pubmail is set on the parent, include all your email contacts
466
467         $mail_disabled = ((function_exists('imap_open') && (! get_config('system','imap_disabled'))) ? 0 : 1);
468
469         if (! $mail_disabled) {
470                 if ((! strlen($target_item['allow_cid'])) && (! strlen($target_item['allow_gid']))
471                         && (! strlen($target_item['deny_cid'])) && (! strlen($target_item['deny_gid']))
472                         && (intval($target_item['pubmail']))) {
473                         $r = q("SELECT `id` FROM `contact` WHERE `uid` = %d AND `network` = '%s'",
474                                 intval($uid),
475                                 dbesc(NETWORK_MAIL)
476                         );
477                         if (dbm::is_result($r)) {
478                                 foreach ($r as $rr) {
479                                         $recipients[] = $rr['id'];
480                                 }
481                         }
482                 }
483         }
484
485         if ($followup) {
486                 $recip_str = implode(', ', $recipients_followup);
487         } else {
488                 $recip_str = implode(', ', $recipients);
489         }
490         if ($relocate) {
491                 $r = $recipients_relocate;
492         } else {
493                 $r = q("SELECT `id`, `url`, `network`, `self` FROM `contact`
494                         WHERE `id` IN (%s) AND NOT `blocked` AND NOT `pending` AND NOT `archive`".$sql_extra,
495                         dbesc($recip_str)
496                 );
497         }
498
499         // delivery loop
500
501         if (dbm::is_result($r)) {
502                 foreach ($r as $contact) {
503                         if ($contact['self']) {
504                                 continue;
505                         }
506                         logger("Deliver ".$target_item["guid"]." to ".$contact['url']." via network ".$contact['network'], LOGGER_DEBUG);
507
508                         proc_run(array('priority' => $a->queue['priority'], 'created' => $a->queue['created'], 'dont_fork' => true),
509                                         'include/delivery.php', $cmd, $item_id, (int)$contact['id']);
510                 }
511         }
512
513         // send salmon slaps to mentioned remote tags (@foo@example.com) in OStatus posts
514         // They are especially used for notifications to OStatus users that don't follow us.
515
516         if ($slap && count($url_recipients) && ($public_message || $push_notify) && $normal_mode) {
517                 if (!get_config('system','dfrn_only')) {
518                         foreach ($url_recipients as $url) {
519                                 if ($url) {
520                                         logger('notifier: urldelivery: ' . $url);
521                                         $deliver_status = slapper($owner,$url,$slap);
522                                         /// @TODO Redeliver/queue these items on failure, though there is no contact record
523                                 }
524                         }
525                 }
526         }
527
528
529         if ($public_message) {
530
531                 $r0 = array();
532                 $r1 = array();
533
534                 if ($diaspora_delivery) {
535                         if (!$followup) {
536                                 $r0 = Diaspora::relay_list();
537                         }
538
539                         $r1 = q("SELECT `batch`, ANY_VALUE(`id`) AS `id`, ANY_VALUE(`name`) AS `name`, ANY_VALUE(`network`) AS `network`
540                                 FROM `contact` WHERE `network` = '%s' AND `batch` != ''
541                                 AND `uid` = %d AND `rel` != %d AND NOT `blocked` AND NOT `pending` AND NOT `archive` GROUP BY `batch`",
542                                 dbesc(NETWORK_DIASPORA),
543                                 intval($owner['uid']),
544                                 intval(CONTACT_IS_SHARING)
545                         );
546                 }
547
548                 $r2 = q("SELECT `id`, `name`,`network` FROM `contact`
549                         WHERE `network` in ('%s', '%s') AND `uid` = %d AND NOT `blocked` AND NOT `pending` AND NOT `archive` AND `rel` != %d",
550                         dbesc(NETWORK_DFRN),
551                         dbesc(NETWORK_MAIL2),
552                         intval($owner['uid']),
553                         intval(CONTACT_IS_SHARING)
554                 );
555
556                 $r = array_merge($r2,$r1,$r0);
557
558                 if (dbm::is_result($r)) {
559                         logger('pubdeliver '.$target_item["guid"].': '.print_r($r,true), LOGGER_DEBUG);
560
561                         foreach ($r as $rr) {
562
563                                 // except for Diaspora batch jobs
564                                 // Don't deliver to folks who have already been delivered to
565
566                                 if (($rr['network'] !== NETWORK_DIASPORA) && (in_array($rr['id'],$conversants))) {
567                                         logger('notifier: already delivered id=' . $rr['id']);
568                                         continue;
569                                 }
570
571                                 if ((! $mail) && (! $fsuggest) && (! $followup)) {
572                                         logger('notifier: delivery agent: '.$rr['name'].' '.$rr['id'].' '.$rr['network'].' '.$target_item["guid"]);
573                                         proc_run(array('priority' => $a->queue['priority'], 'created' => $a->queue['created'], 'dont_fork' => true),
574                                                         'include/delivery.php', $cmd, $item_id, (int)$rr['id']);
575                                 }
576                         }
577                 }
578
579                 $push_notify = true;
580
581         }
582
583         // Notify PuSH subscribers (Used for OStatus distribution of regular posts)
584         if ($push_notify) {
585                 // Set push flag for PuSH subscribers to this topic,
586                 // they will be notified in queue.php
587                 q("UPDATE `push_subscriber` SET `push` = 1 ".
588                   "WHERE `nickname` = '%s' AND `push` = 0", dbesc($owner['nickname']));
589
590                 logger('Activating internal PuSH for item '.$item_id, LOGGER_DEBUG);
591
592                 // Handling the pubsubhubbub requests
593                 proc_run(array('priority' => PRIORITY_HIGH, 'created' => $a->queue['created'], 'dont_fork' => true),
594                                 'include/pubsubpublish.php');
595         }
596
597         logger('notifier: calling hooks', LOGGER_DEBUG);
598
599         if ($normal_mode) {
600                 call_hooks('notifier_normal',$target_item);
601         }
602
603         call_hooks('notifier_end',$target_item);
604
605         return;
606 }