3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
15 * @copyright CiviCRM LLC https://civicrm.org/licensing
19 * Base Search / View form for *all* listing of multiple
22 class CRM_Contact_Form_Search
extends CRM_Core_Form_Search
{
25 * list of valid contexts.
29 public static $_validContext = NULL;
32 * List of values used when we want to display other objects.
36 public static $_modeValues = NULL;
43 protected $_contextMenu;
46 * The groupId retrieved from the GET vars.
53 * The Group ID belonging to Add Member to group ID.
54 * retrieved from the GET vars
61 * The saved search ID retrieved from the GET vars.
73 public $_groupElement;
84 * The params used for search.
91 * The return properties used for search.
95 protected $_returnProperties;
98 * The sort by character.
102 protected $_sortByCharacter;
105 * The profile group id used for display.
109 protected $_ufGroupID;
112 * Csv - common search values
116 public static $csv = ['contact_type', 'group', 'tag'];
119 * How to display the results. Should we display as contributons, members, cases etc.
123 protected $_componentMode;
126 * What operator should we use, AND or OR.
130 protected $_operator;
132 protected $_modeValue;
135 * Declare entity reference fields as they will need to be converted to using 'IN'.
139 protected $entityReferenceFields = ['event_id', 'membership_type_id'];
142 * Name of the selector to use.
145 public static $_selectorName = 'CRM_Contact_Selector';
146 protected $_customSearchID = NULL;
147 protected $_customSearchClass = NULL;
149 protected $_openedPanes = [];
152 * Explicitly declare the entity api name.
154 public function getDefaultEntity() {
159 * Define the set of valid contexts that the search form operates on.
162 * the valid context set and the titles
164 public static function &validContext() {
165 if (!(self
::$_validContext)) {
166 self
::$_validContext = [
167 'smog' => 'Show members of group',
168 'amtg' => 'Add members to group',
169 'basic' => 'Basic Search',
170 'search' => 'Search',
171 'builder' => 'Search Builder',
172 'advanced' => 'Advanced Search',
173 'custom' => 'Custom Search',
176 return self
::$_validContext;
184 public static function isSearchContext($context) {
185 $searchContext = CRM_Utils_Array
::value($context, self
::validContext());
186 return (bool) $searchContext;
189 public static function setModeValues() {
190 self
::$_modeValues = [
191 CRM_Contact_BAO_Query
::MODE_CONTACTS
=> [
192 'selectorName' => self
::$_selectorName,
193 'selectorLabel' => ts('Contacts'),
194 'taskFile' => 'CRM/Contact/Form/Search/ResultTasks.tpl',
195 'taskContext' => NULL,
196 'resultFile' => 'CRM/Contact/Form/Selector.tpl',
197 'resultContext' => NULL,
198 'taskClassName' => 'CRM_Contact_Task',
201 CRM_Contact_BAO_Query
::MODE_CONTRIBUTE
=> [
202 'selectorName' => 'CRM_Contribute_Selector_Search',
203 'selectorLabel' => ts('Contributions'),
204 'taskFile' => 'CRM/common/searchResultTasks.tpl',
205 'taskContext' => 'Contribution',
206 'resultFile' => 'CRM/Contribute/Form/Selector.tpl',
207 'resultContext' => 'Search',
208 'taskClassName' => 'CRM_Contribute_Task',
209 'component' => 'CiviContribute',
211 CRM_Contact_BAO_Query
::MODE_EVENT
=> [
212 'selectorName' => 'CRM_Event_Selector_Search',
213 'selectorLabel' => ts('Event Participants'),
214 'taskFile' => 'CRM/common/searchResultTasks.tpl',
215 'taskContext' => NULL,
216 'resultFile' => 'CRM/Event/Form/Selector.tpl',
217 'resultContext' => 'Search',
218 'taskClassName' => 'CRM_Event_Task',
219 'component' => 'CiviEvent',
221 CRM_Contact_BAO_Query
::MODE_ACTIVITY
=> [
222 'selectorName' => 'CRM_Activity_Selector_Search',
223 'selectorLabel' => ts('Activities'),
224 'taskFile' => 'CRM/common/searchResultTasks.tpl',
225 'taskContext' => NULL,
226 'resultFile' => 'CRM/Activity/Form/Selector.tpl',
227 'resultContext' => 'Search',
228 'taskClassName' => 'CRM_Activity_Task',
229 'component' => 'activity',
231 CRM_Contact_BAO_Query
::MODE_MEMBER
=> [
232 'selectorName' => 'CRM_Member_Selector_Search',
233 'selectorLabel' => ts('Memberships'),
234 'taskFile' => "CRM/common/searchResultTasks.tpl",
235 'taskContext' => NULL,
236 'resultFile' => 'CRM/Member/Form/Selector.tpl',
237 'resultContext' => 'Search',
238 'taskClassName' => 'CRM_Member_Task',
239 'component' => 'CiviMember',
241 CRM_Contact_BAO_Query
::MODE_CASE
=> [
242 'selectorName' => 'CRM_Case_Selector_Search',
243 'selectorLabel' => ts('Cases'),
244 'taskFile' => "CRM/common/searchResultTasks.tpl",
245 'taskContext' => NULL,
246 'resultFile' => 'CRM/Case/Form/Selector.tpl',
247 'resultContext' => 'Search',
248 'taskClassName' => 'CRM_Case_Task',
249 'component' => 'CiviCase',
251 CRM_Contact_BAO_Query
::MODE_CONTACTSRELATED
=> [
252 'selectorName' => self
::$_selectorName,
253 'selectorLabel' => ts('Related Contacts'),
254 'taskFile' => 'CRM/Contact/Form/Search/ResultTasks.tpl',
255 'taskContext' => NULL,
256 'resultFile' => 'CRM/Contact/Form/Selector.tpl',
257 'resultContext' => NULL,
258 'taskClassName' => 'CRM_Contact_Task',
259 'component' => 'related_contact',
261 CRM_Contact_BAO_Query
::MODE_MAILING
=> [
262 'selectorName' => 'CRM_Mailing_Selector_Search',
263 'selectorLabel' => ts('Mailings'),
264 'taskFile' => "CRM/common/searchResultTasks.tpl",
265 'taskContext' => NULL,
266 'resultFile' => 'CRM/Mailing/Form/Selector.tpl',
267 'resultContext' => 'Search',
268 'taskClassName' => 'CRM_Mailing_Task',
269 'component' => 'CiviMail',
275 * Get the metadata for the query mode (this includes task class names)
280 * @throws \CRM_Core_Exception
282 public static function getModeValue($mode = CRM_Contact_BAO_Query
::MODE_CONTACTS
) {
283 $searchPane = CRM_Utils_Request
::retrieve('searchPane', 'String');
284 if (!empty($searchPane)) {
285 $mode = array_search($searchPane, self
::getModeToComponentMapping());
288 self
::setModeValues();
289 // Note $mode might === FALSE because array_search above failed, e.g. for searchPane='location'
290 if (empty(self
::$_modeValues[$mode])) {
291 $mode = CRM_Contact_BAO_Query
::MODE_CONTACTS
;
294 return self
::$_modeValues[$mode];
298 * Get a mapping of modes to components.
300 * This will map the integers to the components. Contact has an empty component
301 * an pseudo-components exist for activity & related_contact.
305 public static function getModeToComponentMapping() {
307 self
::setModeValues();
309 foreach (self
::$_modeValues as $id => $metadata) {
310 $mapping[$id] = $metadata['component'];
318 public static function getModeSelect() {
319 self
::setModeValues();
321 $enabledComponents = CRM_Core_Component
::getEnabledComponents();
322 $componentModes = [];
323 foreach (self
::$_modeValues as $id => & $value) {
324 if (strpos($value['component'], 'Civi') !== FALSE
325 && !array_key_exists($value['component'], $enabledComponents)
329 $componentModes[$id] = $value['selectorLabel'];
332 // unset disabled components
333 if (!array_key_exists('CiviMail', $enabledComponents)) {
334 unset($componentModes[CRM_Contact_BAO_Query
::MODE_MAILING
]);
337 // unset contributions or participants if user does not have permission on them
338 if (!CRM_Core_Permission
::access('CiviContribute')) {
339 unset($componentModes[CRM_Contact_BAO_Query
::MODE_CONTRIBUTE
]);
342 if (!CRM_Core_Permission
::access('CiviEvent')) {
343 unset($componentModes[CRM_Contact_BAO_Query
::MODE_EVENT
]);
346 if (!CRM_Core_Permission
::access('CiviMember')) {
347 unset($componentModes[CRM_Contact_BAO_Query
::MODE_MEMBER
]);
350 if (!CRM_Core_Permission
::check('view all activities')) {
351 unset($componentModes[CRM_Contact_BAO_Query
::MODE_ACTIVITY
]);
354 return $componentModes;
358 * Builds the list of tasks or actions that a searcher can perform on a result set.
362 public function buildTaskList() {
363 // amtg = 'Add members to group'
364 if ($this->_context
!== 'amtg') {
365 $taskParams['deletedContacts'] = FALSE;
366 if ($this->_componentMode
== CRM_Contact_BAO_Query
::MODE_CONTACTS ||
$this->_componentMode
== CRM_Contact_BAO_Query
::MODE_CONTACTSRELATED
) {
367 $taskParams['deletedContacts'] = $this->_formValues
['deleted_contacts'] ??
NULL;
369 $className = $this->_modeValue
['taskClassName'];
370 $taskParams['ssID'] = $this->_ssID ??
NULL;
371 $this->_taskList +
= $className::permissionedTaskTitles(CRM_Core_Permission
::getPermission(), $taskParams);
374 return $this->_taskList
;
378 * Build the common elements between the search/advanced form.
380 public function buildQuickForm() {
381 parent
::buildQuickForm();
383 // some tasks.. what do we want to do with the selected contacts ?
384 $this->_taskList
= $this->buildTaskList();
386 if (isset($this->_ssID
)) {
388 = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_SavedSearch', $this->_ssID
, 'search_custom_id');
390 $savedSearchValues = [
391 'id' => $this->_ssID
,
392 'name' => CRM_Contact_BAO_SavedSearch
::getName($this->_ssID
, 'title'),
393 'search_custom_id' => $search_custom_id,
395 $this->assign_by_ref('savedSearch', $savedSearchValues);
396 $this->assign('ssID', $this->_ssID
);
399 if ($this->_context
=== 'smog') {
400 // CRM-11788, we might want to do this for all of search where force=1
401 $formQFKey = $this->_formValues
['qfKey'] ??
NULL;
402 $getQFKey = $_GET['qfKey'] ??
NULL;
403 $postQFKey = $_POST['qfKey'] ??
NULL;
404 if ($formQFKey && empty($getQFKey) && empty($postQFKey)) {
405 $url = CRM_Utils_System
::makeURL('qfKey') . $formQFKey;
406 CRM_Utils_System
::redirect($url);
408 $permissionForGroup = FALSE;
410 if (!empty($this->_groupID
)) {
411 // check if user has permission to edit members of this group
412 $permission = CRM_Contact_BAO_Group
::checkPermission($this->_groupID
);
413 if ($permission && in_array(CRM_Core_Permission
::EDIT
, $permission)) {
414 $permissionForGroup = TRUE;
417 // check if _groupID exists, it might not if
418 // we are displaying a hidden group
419 if (!isset($this->_group
[$this->_groupID
])) {
420 $this->_group
[$this->_groupID
]
421 = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID
, 'title');
424 // set the group title
425 $groupValues = ['id' => $this->_groupID
, 'title' => $this->_group
[$this->_groupID
]];
426 $this->assign_by_ref('group', $groupValues);
428 // also set ssID if this is a saved search
429 $ssID = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID
, 'saved_search_id');
430 $this->assign('ssID', $ssID);
432 //get the saved search mapping id
434 $this->_ssID
= $ssID;
435 $ssMappingId = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_SavedSearch', $ssID, 'mapping_id');
436 $this->assign('ssMappingID', $ssMappingId);
439 // Set dynamic page title for 'Show Members of Group'
440 CRM_Utils_System
::setTitle(ts('Contacts in Group: %1', [1 => $this->_group
[$this->_groupID
]]));
443 $group_contact_status = [];
444 foreach (CRM_Core_SelectValues
::groupContactStatus() as $k => $v) {
446 $group_contact_status[] = $this->createElement('checkbox', $k, NULL, $v);
449 $this->addGroup($group_contact_status,
450 'group_contact_status', ts('Group Status')
453 $this->assign('permissionEditSmartGroup', CRM_Core_Permission
::check('edit groups'));
454 $this->assign('permissionedForGroup', $permissionForGroup);
457 // add the go button for the action form, note it is of type 'next' rather than of type 'submit'
458 if ($this->_context
=== 'amtg') {
459 // check if _groupID exists, it might not if
460 // we are displaying a hidden group
461 if (!isset($this->_group
[$this->_amtgID
])) {
462 $this->assign('permissionedForGroup', FALSE);
463 $this->_group
[$this->_amtgID
]
464 = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $this->_amtgID
, 'title');
467 // Set dynamic page title for 'Add Members Group'
468 CRM_Utils_System
::setTitle(ts('Add to Group: %1', [1 => $this->_group
[$this->_amtgID
]]));
469 // also set the group title and freeze the action task with Add Members to Group
470 $groupValues = ['id' => $this->_amtgID
, 'title' => $this->_group
[$this->_amtgID
]];
471 $this->assign_by_ref('group', $groupValues);
472 $this->add('submit', $this->_actionButtonName
, ts('Add Contacts to %1', [1 => $this->_group
[$this->_amtgID
]]),
474 'class' => 'crm-form-submit',
477 $this->add('hidden', 'task', CRM_Contact_Task
::GROUP_ADD
);
478 $selectedRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_sel', ['checked' => 'checked']);
479 $allRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_all');
480 $this->assign('ts_sel_id', $selectedRowsRadio->_attributes
['id']);
481 $this->assign('ts_all_id', $allRowsRadio->_attributes
['id']);
484 $selectedContactIds = [];
485 $qfKeyParam = $this->_formValues
['qfKey'] ??
NULL;
486 // We use ajax to handle selections only if the search results component_mode is set to "contacts"
487 if ($qfKeyParam && ($this->get('component_mode') <= CRM_Contact_BAO_Query
::MODE_CONTACTS ||
$this->get('component_mode') == CRM_Contact_BAO_Query
::MODE_CONTACTSRELATED
)) {
488 $this->addClass('crm-ajax-selection-form');
489 $qfKeyParam = "civicrm search {$qfKeyParam}";
490 $selectedContactIdsArr = Civi
::service('prevnext')->getSelection($qfKeyParam);
491 $selectedContactIds = array_keys($selectedContactIdsArr[$qfKeyParam]);
494 $this->assign_by_ref('selectedContactIds', $selectedContactIds);
496 $rows = $this->get('rows');
498 if (is_array($rows)) {
499 $this->addRowSelectors($rows);
505 * Processing needed for buildForm and later.
507 * @throws \CRM_Core_Exception
509 public function preProcess() {
510 // set the various class variables
512 $this->_group
= CRM_Core_PseudoConstant
::group();
514 $this->_tag
= CRM_Core_BAO_Tag
::getTags();
515 $this->_done
= FALSE;
518 * we allow the controller to set force/reset externally, useful when we are being
519 * driven by the wizard framework
522 $this->_reset
= CRM_Utils_Request
::retrieve('reset', 'Boolean');
524 $this->_force
= CRM_Utils_Request
::retrieve('force', 'Boolean');
525 $this->_groupID
= CRM_Utils_Request
::retrieve('gid', 'Positive', $this);
526 $this->_amtgID
= CRM_Utils_Request
::retrieve('amtgID', 'Positive', $this);
527 $this->_ssID
= CRM_Utils_Request
::retrieve('ssID', 'Positive', $this);
528 $this->_sortByCharacter
= CRM_Utils_Request
::retrieve('sortByCharacter', 'String', $this);
529 $this->_ufGroupID
= CRM_Utils_Request
::retrieve('id', 'Positive', $this);
530 $this->_componentMode
= CRM_Utils_Request
::retrieve('component_mode', 'Positive', $this, FALSE, CRM_Contact_BAO_Query
::MODE_CONTACTS
, $_REQUEST);
531 $this->_operator
= CRM_Utils_Request
::retrieve('operator', 'String', $this, FALSE, CRM_Contact_BAO_Query
::SEARCH_OPERATOR_AND
, 'REQUEST');
533 if (!empty($this->_ssID
) && !CRM_Core_Permission
::check('edit groups')) {
534 CRM_Core_Error
::statusBounce(ts('You do not have permission to modify smart groups'));
538 * set the button names
540 $this->_actionButtonName
= $this->getButtonName('next', 'action');
542 $this->assign('actionButtonName', $this->_actionButtonName
);
544 // if we dont get this from the url, use default if one exsts
545 $config = CRM_Core_Config
::singleton();
546 if ($this->_ufGroupID
== NULL &&
547 $config->defaultSearchProfileID
!= NULL
549 $this->_ufGroupID
= $config->defaultSearchProfileID
;
552 // assign context to drive the template display, make sure context is valid
553 $this->_context
= CRM_Utils_Request
::retrieve('context', 'Alphanumeric', $this, FALSE, 'search');
554 if (!array_key_exists($this->_context
, self
::validContext())) {
555 $this->_context
= 'search';
557 $this->set('context', $this->_context
);
558 $this->assign('context', $this->_context
);
560 $this->_modeValue
= self
::getModeValue($this->_componentMode
);
561 $this->assign($this->_modeValue
);
563 $this->set('selectorName', self
::$_selectorName);
565 // get user submitted values
566 // get it from controller only if form has been submitted, else preProcess has set this
567 // $this->controller->isModal( ) returns TRUE if page is
568 // valid, i.e all the validations are TRUE
570 if (!empty($_POST) && !$this->controller
->isModal()) {
571 $this->_formValues
= $this->controller
->exportValues($this->_name
);
573 $this->normalizeFormValues();
574 $this->_params
= CRM_Contact_BAO_Query
::convertFormValues($this->_formValues
, 0, FALSE, NULL, $this->entityReferenceFields
);
575 $this->_returnProperties
= &$this->returnProperties();
577 // also get the uf group id directly from the post value
578 $this->_ufGroupID
= CRM_Utils_Array
::value('uf_group_id', $_POST, $this->_ufGroupID
);
579 $this->_formValues
['uf_group_id'] = $this->_ufGroupID
;
580 $this->set('id', $this->_ufGroupID
);
582 // also get the object mode directly from the post value
583 $this->_componentMode
= CRM_Utils_Array
::value('component_mode', $_POST, $this->_componentMode
);
585 // also get the operator from the post value if set
586 $this->_operator
= CRM_Utils_Array
::value('operator', $_POST, $this->_operator
);
587 $this->_formValues
['operator'] = $this->_operator
;
588 $this->set('operator', $this->_operator
);
591 $this->_formValues
= $this->get('formValues');
592 $this->_params
= CRM_Contact_BAO_Query
::convertFormValues($this->_formValues
, 0, FALSE, NULL, $this->entityReferenceFields
);
593 $this->_returnProperties
= &$this->returnProperties();
594 if (!empty($this->_ufGroupID
)) {
595 $this->set('id', $this->_ufGroupID
);
599 if (empty($this->_formValues
)) {
600 //check if group is a smart group (fix for CRM-1255)
601 if ($this->_groupID
) {
602 if ($ssId = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID
, 'saved_search_id')) {
603 $this->_ssID
= $ssId;
608 if (isset($this->_ssID
) && $this->_context
!== 'smog') {
609 // we only retrieve the saved search values if out current values are null
610 $this->_formValues
= CRM_Contact_BAO_SavedSearch
::getFormValues($this->_ssID
);
613 if (CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_SavedSearch', $this->_ssID
, 'mapping_id')) {
614 $this->_params
= CRM_Contact_BAO_SavedSearch
::getSearchParams($this->_ssID
);
617 $this->_params
= CRM_Contact_BAO_Query
::convertFormValues($this->_formValues
);
619 $this->_returnProperties
= &$this->returnProperties();
622 if (isset($this->_ufGroupID
)) {
623 // also set the uf group id if not already present
624 $this->_formValues
['uf_group_id'] = $this->_ufGroupID
;
626 if (isset($this->_componentMode
)) {
627 $this->_formValues
['component_mode'] = $this->_componentMode
;
629 if (isset($this->_operator
)) {
630 $this->_formValues
['operator'] = $this->_operator
;
633 // FIXME: we should generalise in a way that components could inject url-filters
634 // just like they build their own form elements
637 'mailing_delivery_status',
638 'mailing_open_status',
639 'mailing_click_status',
640 'mailing_reply_status',
643 'mailing_unsubscribe',
646 'mailing_job_start_date_low',
647 'mailing_job_start_date_high',
648 'mailing_job_start_date_relative',
649 ] as $mailingFilter) {
651 if ($mailingFilter == 'mailing_id' &&
652 $filterVal = CRM_Utils_Request
::retrieve('mailing_id', 'Positive', $this)
654 $this->_formValues
[$mailingFilter] = [$filterVal];
656 elseif ($filterVal = CRM_Utils_Request
::retrieve($mailingFilter, $type, $this)) {
657 $this->_formValues
[$mailingFilter] = $filterVal;
660 $this->_openedPanes
['Mailings'] = 1;
661 $this->_formValues
['hidden_CiviMail'] = 1;
667 CRM_Utils_Array
::value('uf_group_id', $this->_formValues
)
669 $operator = CRM_Utils_Array
::value('operator', $this->_formValues
, CRM_Contact_BAO_Query
::SEARCH_OPERATOR_AND
);
670 $this->set('queryOperator', $operator);
671 if ($operator == CRM_Contact_BAO_Query
::SEARCH_OPERATOR_OR
) {
672 $this->assign('operator', ts('OR'));
675 $this->assign('operator', ts('AND'));
678 // show the context menu only when we’re not searching for deleted contacts; CRM-5673
679 if (empty($this->_formValues
['deleted_contacts'])) {
680 $menuItems = CRM_Contact_BAO_Contact
::contextMenu();
681 $primaryActions = CRM_Utils_Array
::value('primaryActions', $menuItems, []);
682 $this->_contextMenu
= CRM_Utils_Array
::value('moreActions', $menuItems, []);
683 $this->assign('contextMenu', $primaryActions +
$this->_contextMenu
);
686 if (!isset($this->_componentMode
)) {
687 $this->_componentMode
= CRM_Contact_BAO_Query
::MODE_CONTACTS
;
689 self
::$_selectorName = $this->_modeValue
['selectorName'];
690 self
::setModeValues();
693 if (strpos(self
::$_selectorName, 'CRM_Contact_Selector') !== FALSE) {
694 $selector = new self
::$_selectorName(
695 $this->_customSearchClass
,
698 $this->_returnProperties
,
707 $selector = new self
::$_selectorName(
715 $selector->setKey($this->controller
->_key
);
717 $controller = new CRM_Contact_Selector_Controller($selector,
718 $this->get(CRM_Utils_Pager
::PAGE_ID
),
719 $this->get(CRM_Utils_Sort
::SORT_ID
),
720 CRM_Core_Action
::VIEW
,
722 CRM_Core_Selector_Controller
::TRANSFER
724 $controller->setEmbedded(TRUE);
725 $controller->setDynamicAction($setDynamic);
728 $this->loadMetadata();
729 $this->postProcess();
732 * Note that we repeat this, since the search creates and stores
733 * values that potentially change the controller behavior. i.e. things
734 * like totalCount etc
736 $controller = new CRM_Contact_Selector_Controller($selector,
737 $this->get(CRM_Utils_Pager
::PAGE_ID
),
739 CRM_Core_Action
::VIEW
, $this, CRM_Core_Selector_Controller
::TRANSFER
741 $controller->setEmbedded(TRUE);
742 $controller->setDynamicAction($setDynamic);
745 $controller->moveFromSessionToTemplate();
749 * Common post processing.
751 public function postProcess() {
753 * sometime we do a postProcess early on, so we dont need to repeat it
754 * this will most likely introduce some more bugs :(
762 //for prev/next pagination
763 $crmPID = CRM_Utils_Request
::retrieve('crmPID', 'Integer');
765 //get the button name
766 $buttonName = $this->controller
->getButtonName();
768 if (isset($this->_ufGroupID
) && empty($this->_formValues
['uf_group_id'])) {
769 $this->_formValues
['uf_group_id'] = $this->_ufGroupID
;
772 if (isset($this->_componentMode
) && empty($this->_formValues
['component_mode'])) {
773 $this->_formValues
['component_mode'] = $this->_componentMode
;
776 if (isset($this->_operator
) && empty($this->_formValues
['operator'])) {
777 $this->_formValues
['operator'] = $this->_operator
;
780 if (empty($this->_formValues
['qfKey'])) {
781 $this->_formValues
['qfKey'] = $this->controller
->_key
;
784 if (!CRM_Core_Permission
::check('access deleted contacts')) {
785 unset($this->_formValues
['deleted_contacts']);
788 $this->set('type', $this->_action
);
789 $this->set('formValues', $this->_formValues
);
790 $this->set('queryParams', $this->_params
);
791 $this->set('returnProperties', $this->_returnProperties
);
793 if ($buttonName == $this->_actionButtonName
) {
794 // check actionName and if next, then do not repeat a search, since we are going to the next page
795 // hack, make sure we reset the task values
796 $stateMachine = $this->controller
->getStateMachine();
797 $formName = $stateMachine->getTaskFormName();
798 $this->controller
->resetPage($formName);
802 if (array_key_exists($this->getButtonName('refresh'), $_POST) ||
803 ($this->_force
&& !$crmPID)
805 //reset the cache table for new search
806 $cacheKey = "civicrm search {$this->controller->_key}";
807 Civi
::service('prevnext')->deleteItem(NULL, $cacheKey);
809 $output = CRM_Core_Selector_Controller
::SESSION
;
811 // create the selector, controller and run - store results in session
812 $searchChildGroups = TRUE;
813 if ($this->get('isAdvanced')) {
814 $searchChildGroups = FALSE;
819 if (strpos(self
::$_selectorName, 'CRM_Contact_Selector') !== FALSE) {
820 $selector = new self
::$_selectorName(
821 $this->_customSearchClass
,
824 $this->_returnProperties
,
834 $selector = new self
::$_selectorName(
845 $selector->setKey($this->controller
->_key
);
847 // added the sorting character to the form array
848 $config = CRM_Core_Config
::singleton();
849 // do this only for contact search
850 if ($setDynamic && $config->includeAlphabeticalPager
) {
851 // Don't recompute if we are just paging/sorting
852 if ($this->_reset ||
(empty($_GET['crmPID']) && empty($_GET['crmSID']) && !$this->_sortByCharacter
)) {
853 $aToZBar = CRM_Utils_PagerAToZ
::getAToZBar($selector, $this->_sortByCharacter
);
854 $this->set('AToZBar', $aToZBar);
858 $controller = new CRM_Contact_Selector_Controller($selector,
859 $this->get(CRM_Utils_Pager
::PAGE_ID
),
861 CRM_Core_Action
::VIEW
,
865 $controller->setEmbedded(TRUE);
866 $controller->setDynamicAction($setDynamic);
874 public function &returnProperties() {
875 return CRM_Core_DAO
::$_nullObject;
879 * Return a descriptive name for the page, used in wizard header
883 public function getTitle() {
888 * Check Access for a component
889 * @param string $component
892 protected static function checkComponentAccess($component) {
893 $enabledComponents = CRM_Core_Component
::getEnabledComponents();
894 if (!array_key_exists($component, $enabledComponents)) {
897 return CRM_Core_Permission
::access($component);
901 * Load metadata for fields on the form.
903 * @throws \CiviCRM_API3_Exception
905 protected function loadMetadata() {
906 // can't by pass acls by passing search criteria in the url.
907 if (self
::checkComponentAccess('CiviContribute')) {
908 $this->addSearchFieldMetadata(['Contribution' => CRM_Contribute_BAO_Query
::getSearchFieldMetadata()]);
909 $this->addSearchFieldMetadata(['ContributionRecur' => CRM_Contribute_BAO_ContributionRecur
::getContributionRecurSearchFieldMetadata()]);
911 if (self
::checkComponentAccess('CiviPledge')) {
912 $this->addSearchFieldMetadata(['Pledge' => CRM_Pledge_BAO_Query
::getSearchFieldMetadata()]);
913 $this->addSearchFieldMetadata(['PledgePayment' => CRM_Pledge_BAO_Query
::getPledgePaymentSearchFieldMetadata()]);
915 if (self
::checkComponentAccess('CiviEvent')) {
916 $this->addSearchFieldMetadata(['Participant' => CRM_Event_BAO_Query
::getSearchFieldMetadata()]);
918 if (self
::checkComponentAccess('CiviMember')) {
919 $this->addSearchFieldMetadata(['Membership' => CRM_Member_BAO_Query
::getSearchFieldMetadata()]);
921 if (self
::checkComponentAccess('CiviGrant')) {
922 $this->addSearchFieldMetadata(['Grant' => CRM_Grant_BAO_Query
::getSearchFieldMetadata()]);
924 if (self
::checkComponentAccess('CiviCase')) {
925 $this->addSearchFieldMetadata(['Case' => CRM_Case_BAO_Query
::getSearchFieldMetadata()]);