ILIAS  release_8 Revision v8.24
class.ilRepositorySearchGUI.php
Go to the documentation of this file.
1<?php
2
19declare(strict_types=1);
20
24use ILIAS\Refinery\Factory as RefineryFactory;
25
38{
39 private array $search_results = [];
40
41 protected array $add_options = [];
42 protected string $default_option = '';
43 protected bool $object_selection = false;
44
45 protected bool $searchable_check = true;
46 protected string $search_title = '';
47
48 private string $search_type = 'usr';
49 private string $string = '';
50 protected bool $user_limitations = true;
51
52 protected bool $stored = false;
53 protected array $callback = [];
54 protected array $role_callback = [];
55
58 protected ?ilPropertyFormGUI $form = null;
59
63 protected $user_filter = null;
64
66
67 protected ilTree $tree;
70 protected ilCtrl $ctrl;
72 protected ?ilObjUser $user = null;
74 protected ilTabsGUI $tabs;
75 protected ilLanguage $lng;
77 private RefineryFactory $refinery;
78
79 public function __construct()
80 {
81 global $DIC;
82
83
84
85 $this->ctrl = $DIC->ctrl();
86 $this->tpl = $DIC->ui()->mainTemplate();
87 $this->tree = $DIC->repositoryTree();
88 $this->ui_renderer = $DIC->ui()->renderer();
89 $this->ui_factory = $DIC->ui()->factory();
90 $this->lng = $DIC->language();
91 $this->rbacreview = $DIC->rbac()->review();
92 $this->refinery = $DIC->refinery();
93 $this->http = $DIC->http();
94 $this->user = $DIC->user();
95 $this->tabs = $DIC->tabs();
96
97 $this->lng->loadLanguageModule('search');
98 $this->lng->loadLanguageModule('crs');
99
100 $this->setTitle($this->lng->txt('add_members_header'));
101
102 $this->__setSearchType();
103 $this->__loadQueries();
104
105 $this->result_obj = new ilSearchResult();
106 $this->result_obj->setMaxHits(1000000);
107 $this->settings = new ilSearchSettings();
108 }
109
110 protected function initUserTypeFromQuery(): string
111 {
112 if ($this->http->wrapper()->query()->has('user_type')) {
113 return $this->http->wrapper()->query()->retrieve(
114 'user_type',
115 $this->refinery->kindlyTo()->string()
116 );
117 }
118 return '';
119 }
120
121 protected function initUserTypeFromPost(): string
122 {
123 if ($this->http->wrapper()->post()->has('user_type')) {
124 return $this->http->wrapper()->post()->retrieve(
125 'user_type',
126 $this->refinery->kindlyTo()->string()
127 );
128 }
129 return '';
130 }
131
140 public function addUserAccessFilterCallable(callable $user_filter): void
141 {
142 $this->user_filter = $user_filter;
143 }
144
145 public function setTitle(string $a_title): void
146 {
147 $this->search_title = $a_title;
148 }
149
150 public function getTitle(): string
151 {
152 return $this->search_title;
153 }
154
155 public function enableSearchableCheck(bool $a_status): void
156 {
157 $this->searchable_check = $a_status;
158 }
159
160 public function isSearchableCheckEnabled(): bool
161 {
163 }
164
165 public function setPrivacyMode(int $privacy_mode): void
166 {
167 $this->privacy_mode = $privacy_mode;
168 }
169
170 public function getPrivacyMode(): int
171 {
172 return $this->privacy_mode;
173 }
174
175 public function getSearchType(): string
176 {
177 return $this->search_type;
178 }
179
180 public function getRoleCallback(): array
181 {
183 }
184
185
194 public static function fillAutoCompleteToolbar(
195 object $parent_object,
196 ilToolbarGUI $toolbar = null,
197 array $a_options = [],
198 bool $a_sticky = false
199 ): ilToolbarGUI {
200 global $DIC;
201
202 $ilToolbar = $DIC->toolbar();
203 $lng = $DIC->language();
204 $ilCtrl = $DIC->ctrl();
205 $tree = $DIC->repositoryTree();
206 $user = $DIC->user();
207
208 if (!$toolbar instanceof ilToolbarGUI) {
209 $toolbar = $ilToolbar;
210 }
211
212 // Fill default options
213 if (!isset($a_options['auto_complete_name'])) {
214 $a_options['auto_complete_name'] = $lng->txt('obj_user');
215 }
216 if (!isset($a_options['auto_complete_size'])) {
217 $a_options['auto_complete_size'] = 15;
218 }
219 if (!isset($a_options['submit_name'])) {
220 $a_options['submit_name'] = $lng->txt('btn_add');
221 }
222 if (!isset($a_options['user_type_default'])) {
223 $a_options['user_type_default'] = null;
224 }
225
226 if (!isset($a_options['add_search'])) {
227 $a_options['add_search'] = false;
228 }
229 if (!isset($a_options['add_from_container'])) {
230 $a_options['add_from_container'] = null;
231 }
232
233 $ajax_url = $ilCtrl->getLinkTargetByClass(
234 array(get_class($parent_object),'ilRepositorySearchGUI'),
235 'doUserAutoComplete',
236 '',
237 true,
238 false
239 );
240
241 $ul = new ilTextInputGUI($a_options['auto_complete_name'], 'user_login');
242 $ul->setDataSource($ajax_url);
243 $ul->setSize($a_options['auto_complete_size']);
244 if (!$a_sticky) {
245 $toolbar->addInputItem($ul, true);
246 } else {
247 $toolbar->addStickyItem($ul, true);
248 }
249
250 if (isset($a_options['user_type']) && count((array) $a_options['user_type'])) {
251 $si = new ilSelectInputGUI("", "user_type");
252 $si->setOptions($a_options['user_type']);
253 $si->setValue($a_options['user_type_default']);
254 if (!$a_sticky) {
255 $toolbar->addInputItem($si);
256 } else {
257 $toolbar->addStickyItem($si);
258 }
259 }
260
262 if ($clip->hasContent()) {
263 $action_button = ilSplitButtonGUI::getInstance();
264
265 $add_button = ilSubmitButton::getInstance();
266 $add_button->setCaption($a_options['submit_name'], false);
267 $add_button->setCommand('addUserFromAutoComplete');
268
269 $action_button->setDefaultButton($add_button);
270
271 $clip_button = ilSubmitButton::getInstance();
272 $clip_button->addCSSClass('btn btndefault');
273 $lng->loadLanguageModule('user');
274 $clip_button->setCaption($lng->txt('clipboard_add_from_btn'), false);
275 $clip_button->setCommand('showClipboard');
276
277 $action_button->addMenuItem(new ilButtonToSplitButtonMenuItemAdapter($clip_button));
278
279 $toolbar->addButtonInstance($action_button);
280 } else {
281 $button = ilSubmitButton::getInstance();
282 $button->setCaption($a_options['submit_name'], false);
283 $button->setCommand('addUserFromAutoComplete');
284 if (!$a_sticky) {
285 $toolbar->addButtonInstance($button);
286 } else {
287 $toolbar->addStickyItem($button);
288 }
289 }
290
291 if ($a_options['add_search'] ||
292 is_numeric($a_options['add_from_container'])) {
293 $lng->loadLanguageModule("search");
294
295 $toolbar->addSeparator();
296
297 if ($a_options['add_search']) {
298 $button = ilLinkButton::getInstance();
299 $button->setCaption("search_users");
300 $button->setUrl($ilCtrl->getLinkTargetByClass('ilRepositorySearchGUI', ''));
301 $toolbar->addButtonInstance($button);
302 }
303
304 if (is_numeric($a_options['add_from_container'])) {
305 $parent_ref_id = (int) $a_options['add_from_container'];
306 $parent_container_ref_id = $tree->checkForParentType($parent_ref_id, "grp");
307 $parent_container_type = "grp";
308 if (!$parent_container_ref_id) {
309 $parent_container_ref_id = $tree->checkForParentType($parent_ref_id, "crs");
310 $parent_container_type = "crs";
311 }
312 if ($parent_container_ref_id) {
313 if ($a_options['add_search']) {
314 $toolbar->addSpacer();
315 }
316
317 $ilCtrl->setParameterByClass('ilRepositorySearchGUI', "list_obj", ilObject::_lookupObjId($parent_container_ref_id));
318
319 $button = ilLinkButton::getInstance();
320 $button->setCaption("search_add_members_from_container_" . $parent_container_type);
321 $button->setUrl($ilCtrl->getLinkTargetByClass(array(get_class($parent_object),'ilRepositorySearchGUI'), 'listUsers'));
322 $toolbar->addButtonInstance($button);
323 }
324 }
325 }
326
327 $toolbar->setFormAction(
328 $ilCtrl->getFormActionByClass(
329 array(
330 get_class($parent_object),
331 'ilRepositorySearchGUI')
332 )
333 );
334 return $toolbar;
335 }
336
337 protected function doUserAutoComplete(): ?string
338 {
339 // hide anonymout request
340 if ($this->user->getId() == ANONYMOUS_USER_ID) {
341 echo json_encode(new stdClass(), JSON_THROW_ON_ERROR);
342 exit;
343 }
344 if (!$this->http->wrapper()->query()->has('autoCompleteField')) {
345 $a_fields = [
346 'login',
347 'firstname',
348 'lastname',
349 'email'
350 ];
351 $result_field = 'login';
352 } else {
353 $auto_complete_field = $this->http->wrapper()->query()->retrieve(
354 'autoCompleteField',
355 $this->refinery->kindlyTo()->string()
356 );
357 $a_fields = [$auto_complete_field];
358 $result_field = $auto_complete_field;
359 }
360 $auto = new ilUserAutoComplete();
361 $auto->setPrivacyMode($this->getPrivacyMode());
362
363 if ($this->http->wrapper()->query()->has('fetchall')) {
364 $auto->setLimit(ilUserAutoComplete::MAX_ENTRIES);
365 }
366
367 $auto->setMoreLinkAvailable(true);
368 $auto->setSearchFields($a_fields);
369 $auto->setResultField($result_field);
370 $auto->enableFieldSearchableCheck(true);
371 $auto->setUserLimitations($this->getUserLimitations());
372 if (is_callable($this->user_filter)) { // #0024249
373 $auto->addUserAccessFilterCallable(Closure::fromCallable($this->user_filter));
374 }
375
376 $query = '';
377 if ($this->http->wrapper()->post()->has('term')) {
378 $query = $this->http->wrapper()->post()->retrieve(
379 'term',
380 $this->refinery->kindlyTo()->string()
381 );
382 }
383 if ($query === "") {
384 if ($this->http->wrapper()->query()->has('term')) {
385 $query = $this->http->wrapper()->query()->retrieve(
386 'term',
387 $this->refinery->kindlyTo()->string()
388 );
389 }
390 }
391 echo $auto->getList($query);
392 exit;
393 }
394
395
396 public function setString(string $a_str): void
397 {
398 $search = ilSession::get('search');
399 $search['string'] = $this->string = $a_str;
400 ilSession::set('search', $search);
401 }
402 public function getString(): string
403 {
404 return $this->string;
405 }
406
407 public function executeCommand(): bool
408 {
409 $next_class = $this->ctrl->getNextClass($this);
410 $cmd = $this->ctrl->getCmd();
411 switch ($next_class) {
412 default:
413 if (!$cmd) {
414 $cmd = "showSearch";
415 }
416 $this->$cmd();
417 break;
418 }
419 return true;
420 }
421
422 public function __clearSession(): void
423 {
424 ilSession::clear('rep_search');
425 ilSession::clear('append_results');
426 ilSession::clear('rep_query');
427 ilSession::clear('rep_search_type');
428 }
429
430 public function cancel(): void
431 {
432 $this->ctrl->returnToParent($this);
433 }
434
435 public function start(): bool
436 {
437 // delete all session info
438 $this->__clearSession();
439 $this->showSearch();
440
441 return true;
442 }
443
444
445 public function addRole(): void
446 {
447 $class = $this->role_callback['class'];
448 $method = $this->role_callback['method'];
449
450 // call callback if that function does give a return value => show error message
451 // listener redirects if everything is ok.
452 $obj_ids = [];
453 if ($this->http->wrapper()->post()->has('obj')) {
454 $obj_ids = $this->http->wrapper()->post()->retrieve(
455 'obj',
456 $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
457 );
458 }
459 $role_ids = array();
460 foreach ($obj_ids as $id) {
461 $obj_type = ilObject::_lookupType($id);
462 if ($obj_type == "crs" || $obj_type == "grp") {
464 $ref_id = end($refs);
466 $role_ids[] = $mem_role;
467 } else {
468 $role_ids[] = $id;
469 }
470 }
471 $class->$method($role_ids);
472
473 $this->showSearchResults();
474 }
475
476 public function addUser(): void
477 {
478 $class = $this->callback['class'];
479 $method = $this->callback['method'];
480
481 $users = [];
482 if ($this->http->wrapper()->post()->has('user')) {
483 $users = $this->http->wrapper()->post()->retrieve(
484 'user',
485 $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
486 );
487 }
488
489 // call callback if that function does give a return value => show error message
490 // listener redirects if everything is ok.
491 $class->$method($users);
492
493 $this->showSearchResults();
494 }
495
496
497 protected function addUserFromAutoComplete(): void
498 {
499 $class = $this->callback['class'];
500 $method = $this->callback['method'];
501
502 $post_users = '';
503 if ($this->http->wrapper()->post()->has('user_login')) {
504 $post_users = $this->http->wrapper()->post()->retrieve(
505 'user_login',
506 $this->refinery->kindlyTo()->string()
507 );
508 }
509
510 $users = explode(',', $post_users);
511 $user_ids = array();
512 foreach ($users as $user) {
513 $user_id = ilObjUser::_lookupId($user);
514 if ($user_id) {
515 $user_ids[] = $user_id;
516 }
517 }
518
519 $user_type = $this->initUserTypeFromPost();
520 if (!$class->$method($user_ids, $user_type)) {
521 $this->ctrl->returnToParent($this);
522 }
523 }
524
525 protected function showClipboard(): void
526 {
527 $user_type = $this->initUserTypeFromQuery();
528 if ($user_type === '') {
529 $user_type = $this->initUserTypeFromPost();
530 }
531 $this->ctrl->setParameter($this, 'user_type', $user_type);
532 $this->tabs->clearTargets();
533 $this->tabs->setBackTarget(
534 $this->lng->txt('back'),
535 $this->ctrl->getParentReturn($this)
536 );
537
538 $clip = new ilUserClipboardTableGUI($this, 'showClipboard', $this->user->getId());
539 $clip->setFormAction($this->ctrl->getFormAction($this));
540 $clip->init();
541 $clip->parse();
542
543 $this->tpl->setContent($clip->getHTML());
544 }
545
546
547 protected function addFromClipboard(): void
548 {
549 $user_type = $this->initUserTypeFromPost();
550 if ($user_type === '') {
551 $user_type = $this->initUserTypeFromQuery();
552 }
553 $this->ctrl->setParameter($this, 'user_type', $user_type);
554
555 $users = [];
556 if ($this->http->wrapper()->post()->has('uids')) {
557 $users = $this->http->wrapper()->post()->retrieve(
558 'uids',
559 $this->refinery->kindlyTo()->dictOf(
560 $this->refinery->kindlyTo()->int()
561 )
562 );
563 }
564 if (!count($users)) {
565 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('select_one'), true);
566 $this->ctrl->redirect($this, 'showClipboard');
567 }
568 $class = $this->callback['class'];
569 $method = $this->callback['method'];
570 if (!$class->$method($users, $user_type)) {
571 $this->ctrl->returnToParent($this);
572 }
573 }
574
575
576 protected function removeFromClipboard(): void
577 {
578 $users = [];
579 if ($this->http->wrapper()->post()->has('uids')) {
580 $users = $this->http->wrapper()->post()->retrieve(
581 'uids',
582 $this->refinery->kindlyTo()->listOf(
583 $this->refinery->kindlyTo()->int()
584 )
585 );
586 }
587
588 $this->ctrl->setParameter($this, 'user_type', $this->initUserTypeFromQuery());
589 if (!count($users)) {
590 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('select_one'), true);
591 $this->ctrl->redirect($this, 'showClipboard');
592 }
593
594 $clip = ilUserClipboard::getInstance($this->user->getId());
595 $clip->delete($users);
596 $clip->save();
597
598 $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
599 $this->ctrl->redirect($this, 'showClipboard');
600 }
601
602
603 protected function emptyClipboard(): void
604 {
605 $clip = ilUserClipboard::getInstance($this->user->getId());
606 $clip->clear();
607 $clip->save();
608
609 $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
610 $this->ctrl->returnToParent($this);
611 }
612
613
614 protected function handleMultiCommand(): void
615 {
616 $class = $this->callback['class'];
617 $method = $this->callback['method'];
618
619 $post_user = (array) ($this->http->request()->getParsedBody()['user'] ?? []);
620 $post_selected_command = '';
621 if (
622 $this->http->wrapper()->post()->has('table_top_cmd') &&
623 $this->http->wrapper()->post()->has('selectedCommand_2')
624 ) {
625 $post_selected_command = $this->http->wrapper()->post()->retrieve(
626 'selectedCommand_2',
627 $this->refinery->kindlyTo()->string()
628 );
629 } elseif ($this->http->wrapper()->post()->has('selectedCommand')) {
630 $post_selected_command = $this->http->wrapper()->post()->retrieve(
631 'selectedCommand',
632 $this->refinery->kindlyTo()->string()
633 );
634 }
635 // Redirects if everything is ok
636 if (!$class->$method($post_user, $post_selected_command)) {
637 $this->showSearchResults();
638 }
639 }
640
644 public function setCallback(
645 object $class,
646 string $method,
647 array $a_add_options = [],
648 string $default_option = ''
649 ): void {
650 $this->callback = array('class' => $class,'method' => $method);
651 $this->add_options = $a_add_options;
652 $this->default_option = $default_option;
653 }
654
658 public function setRoleCallback(
659 object $class,
660 string $method,
661 array $a_add_options = [],
662 string $default_option = ''
663 ): void {
664 $this->role_callback = array('class' => $class,'method' => $method);
665 $this->add_options = $a_add_options;
666 $this->default_option = $default_option;
667 }
668
669
670 public function setPermissionQueryCallback(object $class, string $method): void
671 {
672 }
673
674 public function showSearch(): void
675 {
676 // only autocomplete input field, no search form if user privay should be respected
677 // see bug 25481
678 if ($this->getPrivacyMode() == ilUserAutoComplete::PRIVACY_MODE_RESPECT_USER_SETTING) {
679 return;
680 }
681 $this->initFormSearch();
682 $this->tpl->setContent($this->form->getHTML());
683 }
684
685 public function showSearchSelected(): void
686 {
687 $selected = [];
688 if ($this->http->wrapper()->query()->has('selected_id')) {
689 $selected = $this->http->wrapper()->query()->retrieve(
690 'selected_id',
691 $this->refinery->kindlyTo()->int()
692 );
693 }
694 $this->tpl->addBlockFile('ADM_CONTENT', 'adm_content', 'tpl.rep_search_result.html', 'Services/Search');
695 $this->addNewSearchButton();
696 $this->showSearchUserTable([$selected], 'showSearchResults');
697 }
698
699 public function initFormSearch(ilObjUser $user = null): void
700 {
701 $this->form = new ilPropertyFormGUI();
702 $this->form->setFormAction($this->ctrl->getFormAction($this, 'showSearch'));
703 $this->form->setTitle($this->getTitle());
704 $this->form->addCommandButton('performSearch', $this->lng->txt('search'));
705 $this->form->addCommandButton('cancel', $this->lng->txt('cancel'));
706
707
708 $kind = new ilRadioGroupInputGUI($this->lng->txt('search_type'), 'search_for');
709 $kind->setValue($this->search_type);
710 $this->form->addItem($kind);
711
712 // Users
713 $users = new ilRadioOption($this->lng->txt('search_for_users'), 'usr');
714
715 // UDF
716 foreach (ilUserSearchOptions::_getSearchableFieldsInfo(!$this->isSearchableCheckEnabled()) as $info) {
717 switch ($info['type'] ?? ilUserSearchOptions::FIELD_TYPE_UDF_UNDEFINED) {
720
721 $sel = new ilSelectInputGUI($info['lang'], "rep_query[usr][" . $info['db'] . "]");
722 $sel->setOptions($info['values']);
723 $users->addSubItem($sel);
724 break;
725
729
730 if (isset($info['autoComplete']) and $info['autoComplete']) {
731 $this->ctrl->setParameterByClass(get_class($this), 'autoCompleteField', $info['db']);
732 $ul = new ilTextInputGUI($info['lang'], "rep_query[usr][" . $info['db'] . "]");
733 $ul->setDataSourceSubmitOnSelection(true);
734 $ul->setDataSourceSubmitUrl(
735 $this->ctrl->getLinkTarget(
736 $this,
737 'showSearchSelected',
738 '',
739 false,
740 false
741 )
742 );
743 $ul->setDataSource($this->ctrl->getLinkTarget(
744 $this,
745 "doUserAutoComplete",
746 "",
747 true
748 ));
749 $ul->setSize(30);
750 $ul->setMaxLength(120);
751
752 if ($user instanceof ilObjUser) {
753 switch ($info['db']) {
754 case 'firstname':
755 $ul->setValue($user->getFirstname());
756 break;
757 case 'lastname':
758 $ul->setValue($user->getLastname());
759 break;
760 case 'login':
761 $ul->setValue($user->getLogin());
762 break;
763 }
764 }
765
766
767
768 $users->addSubItem($ul);
769 } else {
770 $txt = new ilTextInputGUI($info['lang'], "rep_query[usr][" . $info['db'] . "]");
771 $txt->setSize(30);
772 $txt->setMaxLength(120);
773 $users->addSubItem($txt);
774 }
775 break;
776 }
777 }
778 $kind->addOption($users);
779
780
781
782 // Role
783 $roles = new ilRadioOption($this->lng->txt('search_for_role_members'), 'role');
784 $role = new ilTextInputGUI($this->lng->txt('search_role_title'), 'rep_query[role][title]');
785 $role->setSize(30);
786 $role->setMaxLength(120);
787 $roles->addSubItem($role);
788 $kind->addOption($roles);
789
790 // Course
791 $groups = new ilRadioOption($this->lng->txt('search_for_crs_members'), 'crs');
792 $group = new ilTextInputGUI($this->lng->txt('search_crs_title'), 'rep_query[crs][title]');
793 $group->setSize(30);
794 $group->setMaxLength(120);
795 $groups->addSubItem($group);
796 $kind->addOption($groups);
797
798 // Group
799 $groups = new ilRadioOption($this->lng->txt('search_for_grp_members'), 'grp');
800 $group = new ilTextInputGUI($this->lng->txt('search_grp_title'), 'rep_query[grp][title]');
801 $group->setSize(30);
802 $group->setMaxLength(120);
803 $groups->addSubItem($group);
804 $kind->addOption($groups);
805
806 // Orgus
807 if (ilUserSearchOptions::_isEnabled("org_units")) {
808 $orgus = new ilRadioOption($this->lng->txt('search_for_orgu_members'), 'orgu');
810 $this->lng->txt('select_orgu'),
811 'rep_query_orgu',
812 true,
813 $this->form
814 );
815 $orgu->getExplorerGUI()->setSelectableTypes(["orgu"]);
816 $orgu->getExplorerGUI()->setTypeWhiteList(["root", "orgu"]);
817 $orgu->getExplorerGUI()->setRootId(ilObjOrgUnit::getRootOrgRefId());
818 $orgu->getExplorerGUI()->setAjax(false);
819 $orgus->addSubItem($orgu);
820 $kind->addOption($orgus);
821 }
822 }
823
824
825 public function show(): void
826 {
827 $this->showSearchResults();
828 }
829
830 public function appendSearch(): void
831 {
832 ilSession::set('search_append', true);
833 $this->performSearch();
834 }
835
836 public function performSearch(): bool
837 {
838 // only autocomplete input field, no search form if user privay should be respected
839 // see bug 25481
840 if ($this->getPrivacyMode() == ilUserAutoComplete::PRIVACY_MODE_RESPECT_USER_SETTING) {
841 return false;
842 }
843 $found_query = false;
844
845 $post_rep_query = (array) ($this->http->request()->getParsedBody()['rep_query'] ?? []);
846 $post_search_for = (string) ($this->http->request()->getParsedBody()['search_for'] ?? '');
847 if (isset($post_rep_query[$post_search_for])) {
848 foreach ((array) $post_rep_query[$post_search_for] as $field => $value) {
849 if (trim(ilUtil::stripSlashes($value))) {
850 $found_query = true;
851 break;
852 }
853 }
854 }
855 if ($this->http->wrapper()->post()->has('rep_query_orgu')) {
856 $found_query = true;
857 }
858 if (!$found_query) {
859 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_search_string'));
860 $this->start();
861 return false;
862 }
863
864 $post_cmd = (array) ($this->http->request()->getParsedBody()['cmd'] ?? []);
865 // unset search_append if called directly
866 if (isset($post_cmd['performSearch'])) {
867 ilSession::clear('search_append');
868 }
869
870 switch ($this->search_type) {
871 case 'usr':
872 $this->__performUserSearch();
873 break;
874
875 case 'grp':
876 $this->__performGroupSearch();
877 break;
878
879 case 'crs':
880 $this->__performCourseSearch();
881 break;
882
883 case 'role':
884 $this->__performRoleSearch();
885 break;
886 case 'orgu':
887 $post_rep_query_orgu = (array) ($this->http->request()->getParsedBody()['rep_query_orgu'] ?? []);
888 $selected_objects = array_map(
889 function ($ref_id) {
890 return ilObject::_lookupObjId((int) $ref_id);
891 },
892 $post_rep_query_orgu
893 );
894 return $this->listUsers($selected_objects);
895 default:
896 echo 'not defined';
897 }
898
899 $this->result_obj->setRequiredPermission('read');
900 $this->result_obj->addObserver($this, 'searchResultFilterListener');
901 $this->result_obj->filter(ROOT_FOLDER_ID, true);
902
903 // User access filter
904 if ($this->search_type == 'usr') {
905 $callable_name = '';
906 if (is_callable($this->user_filter, true, $callable_name)) {
907 $result_ids = call_user_func_array($this->user_filter, [$this->result_obj->getResultIds()]);
908 } else {
909 $result_ids = $this->result_obj->getResultIds();
910 }
911
912 $this->search_results = array_intersect(
913 $result_ids,
914 ilUserFilter::getInstance()->filter($result_ids)
915 );
916 } else {
917 $this->search_results = array();
918 foreach ($this->result_obj->getResults() as $res) {
919 $this->search_results[] = $res['obj_id'];
920 }
921 }
922
923 if (!count($this->search_results)) {
924 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('search_no_match'));
925 $this->showSearch();
926 return true;
927 }
928 $this->__updateResults();
929 if ($this->result_obj->isLimitReached()) {
930 $message = sprintf($this->lng->txt('search_limit_reached'), $this->settings->getMaxHits());
931 $this->tpl->setOnScreenMessage('info', $message);
932 return true;
933 }
934 // show results
935 $this->show();
936 return true;
937 }
938
939 public function __performUserSearch(): bool
940 {
941 foreach (ilUserSearchOptions::_getSearchableFieldsInfo(!$this->isSearchableCheckEnabled()) as $info) {
942 $name = $info['db'];
943
944 $rep_query = ilSession::get('rep_query');
945 $query_string = $rep_query['usr'][$name] ?? '';
946 // continue if no query string is given
947 if (!$query_string) {
948 continue;
949 }
950
951 if (!is_object($query_parser = $this->__parseQueryString($query_string, true, ($info['type'] == ilUserSearchOptions::FIELD_TYPE_SELECT)))) {
952 $this->tpl->setOnScreenMessage('info', $query_parser);
953 return false;
954 }
955 switch ($info['type']) {
957 $query_parser = $this->__parseQueryString($query_string);
958
959 // no break
962 $udf_search->setFields(array($name));
963 $result_obj = $udf_search->performSearch();
964
965 // Store entries
966 $this->__storeEntries($result_obj);
967 break;
968
970
971 if ($info['db'] == 'org_units') {
973 $result_obj = $user_search->performSearch();
974 $this->__storeEntries($result_obj);
975 break;
976 }
977 $query_parser = $this->__parseQueryString($query_string, true, true);
978
979 // no break
981 $user_search = ilObjectSearchFactory::_getUserSearchInstance($query_parser);
982 $user_search->setFields(array($name));
983 $result_obj = $user_search->performSearch();
984
985 // store entries
986 $this->__storeEntries($result_obj);
987 break;
988
990 $multi_search = ilObjectSearchFactory::getUserMultiFieldSearchInstance($query_parser);
991 $multi_search->setFields(array($name));
992 $result_obj = $multi_search->performSearch();
993 $this->__storeEntries($result_obj);
994 break;
995
996 }
997 }
998 return true;
999 }
1000
1001 public function __performGroupSearch(): bool
1002 {
1003 $rep_query = ilSession::get('rep_query');
1004 $query_string = $rep_query['grp']['title'] ?? '';
1005 if (!is_object($query_parser = $this->__parseQueryString($query_string))) {
1006 $this->tpl->setOnScreenMessage('info', $query_parser, true);
1007 return false;
1008 }
1009
1010 $object_search = new ilLikeObjectSearch($query_parser);
1011 $object_search->setFilter(array('grp'));
1012 $this->__storeEntries($object_search->performSearch());
1013
1014 return true;
1015 }
1016
1017 protected function __performCourseSearch(): bool
1018 {
1019 $rep_query = ilSession::get('rep_query');
1020 $query_string = $rep_query['crs']['title'] ?? '';
1021 if (!is_object($query_parser = $this->__parseQueryString($query_string))) {
1022 $this->tpl->setOnScreenMessage('info', $query_parser, true);
1023 return false;
1024 }
1025
1026 $object_search = new ilLikeObjectSearch($query_parser);
1027 $object_search->setFilter(array('crs'));
1028 $this->__storeEntries($object_search->performSearch());
1029
1030 return true;
1031 }
1032
1033 public function __performRoleSearch(): bool
1034 {
1035 $rep_query = ilSession::get('rep_query');
1036 $query_string = $rep_query['role']['title'] ?? '';
1037 if (!is_object($query_parser = $this->__parseQueryString($query_string))) {
1038 $this->tpl->setOnScreenMessage('info', $query_parser, true);
1039 return false;
1040 }
1041
1042 // Perform like search
1043 $object_search = new ilLikeObjectSearch($query_parser);
1044 $object_search->setFilter(array('role'));
1045 $this->__storeEntries($object_search->performSearch());
1046
1047 return true;
1048 }
1049
1053 public function __parseQueryString(string $a_string, bool $a_combination_or = true, bool $a_ignore_length = false)
1054 {
1055 $query_parser = new ilQueryParser(ilUtil::stripSlashes($a_string));
1056 $query_parser->setCombination($a_combination_or ? ilQueryParser::QP_COMBINATION_OR : ilQueryParser::QP_COMBINATION_AND);
1057 $query_parser->setMinWordLength(1);
1058
1059 // #17502
1060 if (!$a_ignore_length) {
1061 $query_parser->setGlobalMinLength(3); // #14768
1062 }
1063
1064 $query_parser->parse();
1065
1066 if (!$query_parser->validate()) {
1067 return $query_parser->getMessage();
1068 }
1069 return $query_parser;
1070 }
1071
1072 // Private
1073 public function __loadQueries(): void
1074 {
1075 if ($this->http->wrapper()->post()->has('rep_query')) {
1077 'rep_query',
1078 $this->http->request()->getParsedBody()['rep_query']
1079 );
1080 }
1081 }
1082
1083
1084 public function __setSearchType(): bool
1085 {
1086 // Update search type. Default to user search
1087 if ($this->http->wrapper()->post()->has('search_for')) {
1089 'rep_search_type',
1090 $this->http->request()->getParsedBody()['search_for']
1091 );
1092 } elseif (!ilSession::get('rep_search_type')) {
1093 ilSession::set('rep_search_type', 'usr');
1094 }
1095 $this->search_type = (string) ilSession::get('rep_search_type');
1096 return true;
1097 }
1098
1099
1100 public function __updateResults(): bool
1101 {
1102 if (!ilSession::get('search_append')) {
1103 ilSession::set('rep_search', []);
1104 }
1105 $rep_search = ilSession::get('rep_search') ?? [];
1106 foreach ($this->search_results as $result) {
1107 $rep_search[$this->search_type][] = $result;
1108 }
1109 if (!$rep_search[$this->search_type]) {
1110 $rep_search[$this->search_type] = [];
1111 } else {
1112 $rep_search[$this->search_type] = array_unique($rep_search[$this->search_type]);
1113 }
1114 ilSession::set('rep_search', $rep_search);
1115 return true;
1116 }
1117
1121 public function __appendToStoredResults(array $a_usr_ids): array
1122 {
1123 if (!ilSession::get('search_append')) {
1124 $rep_search = ilSession::get('rep_search') ?? [];
1125 $rep_search['usr'] = $a_usr_ids;
1126 ilSession::set('rep_search', $rep_search);
1127 return $a_usr_ids;
1128 }
1129 $rep_search = ilSession::get('rep_search') ?? [];
1130 foreach ($a_usr_ids as $usr_id) {
1131 $rep_search['usr'][] = $usr_id;
1132 }
1133 $rep_search['usr'] = array_unique($rep_search['usr'] ?? []);
1134 ilSession::set('rep_search', $rep_search);
1135 return $rep_search['usr'];
1136 }
1137
1138 public function __storeEntries(ilSearchResult $new_res): bool
1139 {
1140 if ($this->stored == false) {
1141 $this->result_obj->mergeEntries($new_res);
1142 $this->stored = true;
1143 return true;
1144 } else {
1145 $this->result_obj->intersectEntries($new_res);
1146 return true;
1147 }
1148 }
1149
1150 protected function addNewSearchButton(): void
1151 {
1152 $toolbar = new ilToolbarGUI();
1153 $toolbar->addButton(
1154 $this->lng->txt('search_new'),
1155 $this->ctrl->getLinkTarget($this, 'showSearch')
1156 );
1157 $this->tpl->setVariable('ACTION_BUTTONS', $toolbar->getHTML());
1158 }
1159
1160 public function showSearchResults(): void
1161 {
1162 $counter = 0;
1163 $f_result = array();
1164
1165 $this->tpl->addBlockFile('ADM_CONTENT', 'adm_content', 'tpl.rep_search_result.html', 'Services/Search');
1166 $this->addNewSearchButton();
1167
1168 $rep_search = ilSession::get('rep_search');
1169
1170 switch ($this->search_type) {
1171 case "usr":
1172 $this->showSearchUserTable($rep_search['usr'] ?? [], 'showSearchResults');
1173 break;
1174
1175 case 'grp':
1176 $this->showSearchGroupTable($rep_search['grp'] ?? []);
1177 break;
1178
1179 case 'crs':
1180 $this->showSearchCourseTable($rep_search['crs'] ?? []);
1181 break;
1182
1183 case 'role':
1184 $this->showSearchRoleTable($rep_search['role'] ?? []);
1185 break;
1186 }
1187 }
1188
1189 protected function showSearchUserTable(array $a_usr_ids, string $a_parent_cmd): void
1190 {
1191 $base_class = '';
1192 if ($this->http->wrapper()->query()->has('baseClass')) {
1193 $base_class = $this->http->wrapper()->query()->retrieve(
1194 'baseClass',
1195 $this->refinery->kindlyTo()->string()
1196 );
1197 }
1198
1199 // String value of 'baseClass' is in lower case
1200 $is_in_admin = ($base_class === strtolower(ilAdministrationGUI::class));
1201
1202 if ($is_in_admin) {
1203 // remember link target to admin search gui (this)
1204 ilSession::set('usr_search_link', $this->ctrl->getLinkTarget($this, 'show'));
1205 }
1206
1207 $table = new ilRepositoryUserResultTableGUI($this, $a_parent_cmd, $is_in_admin);
1208 if (count($this->add_options)) {
1209 $table->addMultiItemSelectionButton(
1210 'selectedCommand',
1211 $this->add_options,
1212 'handleMultiCommand',
1213 $this->lng->txt('execute'),
1214 $this->default_option
1215 );
1216 } else {
1217 $table->addMultiCommand('addUser', $this->lng->txt('btn_add'));
1218 }
1219 $table->setUserLimitations($this->getUserLimitations());
1220 $table->parseUserIds($a_usr_ids);
1221
1222 $this->tpl->setVariable('RES_TABLE', $table->getHTML());
1223 }
1224
1225 protected function showSearchRoleTable(array $a_obj_ids): void
1226 {
1227 $table = new ilRepositoryObjectResultTableGUI($this, 'showSearchResults', $this->object_selection);
1228 $table->parseObjectIds($a_obj_ids);
1229
1230 $this->tpl->setVariable('RES_TABLE', $table->getHTML());
1231 }
1232
1233 protected function showSearchGroupTable(array $a_obj_ids): void
1234 {
1235 $table = new ilRepositoryObjectResultTableGUI($this, 'showSearchResults', $this->object_selection);
1236 $table->parseObjectIds($a_obj_ids);
1237
1238 $this->tpl->setVariable('RES_TABLE', $table->getHTML());
1239 }
1240
1241 protected function showSearchCourseTable(array $a_obj_ids): void
1242 {
1243 $table = new ilRepositoryObjectResultTableGUI($this, 'showSearchResults', $this->object_selection);
1244 $table->parseObjectIds($a_obj_ids);
1245
1246 $this->tpl->setVariable('RES_TABLE', $table->getHTML());
1247 }
1248
1249 protected function listUsers(array $selected_entries = []): bool
1250 {
1251 // get parameter is used e.g. in exercises to provide
1252 // "add members of course" link
1253 if (
1254 $this->http->wrapper()->post()->has('obj') &&
1255 !count($selected_entries)
1256 ) {
1257 $selected_entries = $this->http->wrapper()->post()->retrieve(
1258 'obj',
1259 $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
1260 );
1261 }
1262 if (
1263 $this->http->wrapper()->query()->has('list_obj') &&
1264 !count($selected_entries)
1265 ) {
1266 $selected_entries[] = $this->http->wrapper()->query()->retrieve(
1267 'list_obj',
1268 $this->refinery->kindlyTo()->int()
1269 );
1270 }
1271 if (!count($selected_entries)) {
1272 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('select_one'));
1273 $this->showSearchResults();
1274 return false;
1275 }
1276 $rep_search = ilSession::get('rep_search') ?? [];
1277 $rep_search['objs'] = $selected_entries;
1278 ilSession::set('rep_search', $rep_search);
1279
1280 // Get all members
1281 $members = array();
1282 foreach ($selected_entries as $obj_id) {
1283 $type = ilObject::_lookupType($obj_id);
1284 switch ($type) {
1285 case 'crs':
1286 case 'grp':
1288 $part = [];
1289 if (is_callable($this->user_filter)) {
1290 $part = call_user_func_array(
1291 $this->user_filter,
1292 [
1293 ilParticipants::getInstanceByObjId($obj_id)->getParticipants()
1294 ]
1295 );
1296 } else {
1297 $part = ilParticipants::getInstanceByObjId($obj_id)->getParticipants();
1298 }
1299
1300 $members = array_merge((array) $members, $part);
1301 }
1302 break;
1303
1304 case 'role':
1305 $assigned = [];
1306 if (is_callable($this->user_filter)) {
1307 $assigned = call_user_func_array(
1308 $this->user_filter,
1309 [
1310 $this->rbacreview->assignedUsers($obj_id)
1311 ]
1312 );
1313 } else {
1314 $assigned = $this->rbacreview->assignedUsers($obj_id);
1315 }
1316
1317 $members = array_merge($members, ilUserFilter::getInstance()->filter($assigned));
1318 break;
1319 case 'orgu':
1320 if ($ref_ids = ilObject::_getAllReferences($obj_id)) {
1322 ->getUserIdsOfOrgUnit(array_shift($ref_ids));
1323 if (is_callable($this->user_filter)) {
1324 $assigned = call_user_func_array(
1325 $this->user_filter,
1326 [$assigned]
1327 );
1328 }
1329
1330 $members = array_merge(
1331 $members,
1332 $assigned
1333 );
1334 }
1335 break;
1336 }
1337 }
1338 $members = array_unique($members);
1339 $this->__appendToStoredResults($members);
1340
1341 $this->tpl->addBlockFile('ADM_CONTENT', 'adm_content', 'tpl.rep_search_result.html', 'Services/Search');
1342
1343 $this->addNewSearchButton();
1344 $rep_search = ilSession::get('rep_search');
1345 $this->showSearchUserTable($rep_search['usr'] ?? [], 'storedUserList');
1346 return true;
1347 }
1348
1349 protected function storedUserList(): bool
1350 {
1351 $rep_search = ilSession::get('rep_search');
1352 $objects = $rep_search['objs'] ?? [];
1353 $this->listUsers($objects);
1354 return true;
1355 }
1356
1362 public function searchResultFilterListener(int $a_ref_id, array $a_data): bool
1363 {
1364 if ($a_data['type'] == 'usr') {
1365 if ($a_data['obj_id'] == ANONYMOUS_USER_ID) {
1366 return false;
1367 }
1368 }
1369 return true;
1370 }
1371
1372 public function allowObjectSelection(bool $a_value = false): void
1373 {
1374 $this->object_selection = $a_value;
1375 }
1376
1380 protected function selectObject(): bool
1381 {
1382 // get parameter is used e.g. in exercises to provide
1383 // "add members of course"
1384 $selected_entries = [];
1385 if ($this->http->wrapper()->post()->has('obj')) {
1386 $selected_entries = $this->http->wrapper()->post()->retrieve(
1387 'obj',
1388 $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
1389 );
1390 }
1391 if (
1392 $this->http->wrapper()->query()->has('list_obj') &&
1393 !count($selected_entries)
1394 ) {
1395 $selected_entries[] = $this->http->wrapper()->query()->retrieve(
1396 'list_obj',
1397 $this->refinery->kindlyTo()->int()
1398 );
1399 }
1400
1401 if (!count($selected_entries)) {
1402 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('select_one'));
1403 $this->showSearchResults();
1404 return false;
1405 }
1406 $this->ctrl->setParameter($this->callback["class"], "obj", implode(";", $selected_entries));
1407 $this->ctrl->redirect($this->callback["class"], $this->callback["method"]);
1408 return true;
1409 }
1410
1414 public function setUserLimitations(bool $a_limitations): void
1415 {
1416 $this->user_limitations = $a_limitations;
1417 }
1418
1422 public function getUserLimitations(): bool
1423 {
1424 return $this->user_limitations;
1425 }
1426}
$id
plugin.php for ilComponentBuildPluginInfoObjectiveTest::testAddPlugins
Definition: plugin.php:23
Builds data types.
Definition: Factory.php:21
show()
returns the content of IniFile
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Class ilCtrl provides processing control methods.
language handling
loadLanguageModule(string $a_module)
Load language module.
txt(string $a_topic, string $a_default_lang_fallback_mod="")
gets the text for a given topic if the topic is not in the list, the topic itself with "-" will be re...
static getRootOrgRefId()
User class.
static _lookupId($a_user_str)
static _getUserDefinedFieldSearchInstance(ilQueryParser $query_parser)
static getUserOrgUnitAssignmentInstance(ilQueryParser $query_parser)
static _getUserSearchInstance(ilQueryParser $query_parser)
static getUserMultiFieldSearchInstance(ilQueryParser $query_parser)
static _lookupType(int $id, bool $reference=false)
static _getAllReferences(int $id)
get all reference ids for object ID
static _lookupObjId(int $ref_id)
static getInstanceByObjId(int $a_obj_id)
Get instance by obj type.
static hasParticipantListAccess(int $a_obj_id, int $a_usr_id=null)
Check if (current) user has access to the participant list.
static getDefaultMemberRole(int $a_ref_id)
This class represents a property form user interface.
This class represents a property in a property form.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
class ilRbacReview Contains Review functions of core Rbac.
TableGUI class object (course,group and role) search results Used in member search.
selectObject()
Return selection of course/group/roles to calling script.
setPermissionQueryCallback(object $class, string $method)
static fillAutoCompleteToolbar(object $parent_object, ilToolbarGUI $toolbar=null, array $a_options=[], bool $a_sticky=false)
array( auto_complete_name = $lng->txt('user'), auto_complete_size = 15, user_type = array(ilCoursePar...
initFormSearch(ilObjUser $user=null)
showSearchUserTable(array $a_usr_ids, string $a_parent_cmd)
listUsers(array $selected_entries=[])
setRoleCallback(object $class, string $method, array $a_add_options=[], string $default_option='')
allowObjectSelection(bool $a_value=false)
searchResultFilterListener(int $a_ref_id, array $a_data)
Listener called from ilSearchResult Id is obj_id for role, usr Id is ref_id for crs grp.
addUserAccessFilterCallable(callable $user_filter)
Closure for filtering users e.g $rep_search_gui->addUserAccessFilterCallable(function($user_ids) use(...
ilGlobalTemplateInterface $tpl
__storeEntries(ilSearchResult $new_res)
setCallback(object $class, string $method, array $a_add_options=[], string $default_option='')
getUserLimitations()
allow user limitations like inactive and access limitations
setUserLimitations(bool $a_limitations)
allow user limitations like inactive and access limitations
__parseQueryString(string $a_string, bool $a_combination_or=true, bool $a_ignore_length=false)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This class represents a selection list property in a property form.
static get(string $a_var)
static clear(string $a_var)
static set(string $a_var, $a_val)
Set a value.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This class represents a text property in a property form.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
checkForParentType(int $a_ref_id, string $a_type, bool $a_exclude_source_check=false)
Check for parent type e.g check if a folder (ref_id 3) is in a parent course obj => checkForParentTyp...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static getInstance(int $a_usr_id)
static _getSearchableFieldsInfo(bool $a_admin=false)
static stripSlashes(string $a_str, bool $a_strip_html=true, string $a_allow="")
const ANONYMOUS_USER_ID
Definition: constants.php:27
const ROOT_FOLDER_ID
Definition: constants.php:32
$txt
Definition: error.php:13
global $DIC
Definition: feed.php:28
Interface GlobalHttpState.
This is how the factory for UI elements looks.
Definition: Factory.php:38
An entity that renders components to a string output.
Definition: Renderer.php:31
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
exit
Definition: login.php:28
$ref_id
Definition: ltiauth.php:67
$res
Definition: ltiservices.php:69
if($format !==null) $name
Definition: metadata.php:247
static http()
Fetches the global http state from ILIAS.
form( $class_path, string $cmd)
$query
$type
$message
Definition: xapiexit.php:32