Merge pull request #3883 from eileenmcnaughton/CRM-14398
[civicrm-core.git] / CRM / Contact / Form / Search.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
9 | |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
13 | |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
18 | |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
26 */
27
28 /**
29 *
30 * @package CRM
31 * @copyright CiviCRM LLC (c) 2004-2013
32 * $Id$
33 *
34 */
35
36 /**
37 * Files required
38 */
39
40 /**
41 * Base Search / View form for *all* listing of multiple
42 * contacts
43 */
44 class CRM_Contact_Form_Search extends CRM_Core_Form {
45
46 /*
47 * list of valid contexts
48 *
49 * @var array
50 * @static
51 */
52 static $_validContext = NULL;
53
54 /**
55 * list of values used when we want to display other objects
56 *
57 * @var array
58 * @static
59 */
60 static $_modeValues = NULL;
61
62 /**
63 * The context that we are working on
64 *
65 * @var string
66 * @access protected
67 */
68 protected $_context;
69
70 /**
71 * The contextMenu
72 *
73 * @var array
74 * @access protected
75 */
76 protected $_contextMenu;
77
78 /**
79 * the groupId retrieved from the GET vars
80 *
81 * @var int
82 * @access public
83 */
84 public $_groupID;
85
86 /**
87 * the Group ID belonging to Add Member to group ID
88 * retrieved from the GET vars
89 *
90 * @var int
91 * @access protected
92 */
93 protected $_amtgID;
94
95 /**
96 * the saved search ID retrieved from the GET vars
97 *
98 * @var int
99 * @access protected
100 */
101 protected $_ssID;
102
103 /**
104 * Are we forced to run a search
105 *
106 * @var int
107 * @access protected
108 */
109 protected $_force;
110
111 /**
112 * name of search button
113 *
114 * @var string
115 * @access protected
116 */
117 protected $_searchButtonName;
118
119 /**
120 * name of print button
121 *
122 * @var string
123 * @access protected
124 */
125 protected $_printButtonName;
126
127 /**
128 * name of action button
129 *
130 * @var string
131 * @access protected
132 */
133 protected $_actionButtonName;
134
135 /**
136 * the group elements
137 *
138 * @var array
139 * @access public
140 */
141 public $_group;
142 public $_groupElement;
143 public $_groupIterator;
144
145 /**
146 * the tag elements
147 *
148 * @var array
149 * @access protected
150 */
151 public $_tag;
152 public $_tagElement;
153
154 /**
155 * form values that we will be using
156 *
157 * @var array
158 * @access protected
159 */
160 public $_formValues;
161
162 /**
163 * The params used for search
164 *
165 * @var array
166 * @access protected
167 */
168 protected $_params;
169
170 /**
171 * The return properties used for search
172 *
173 * @var array
174 * @access protected
175 */
176 protected $_returnProperties;
177
178 /**
179 * The sort by character
180 *
181 * @var string
182 * @access protected
183 */
184 protected $_sortByCharacter;
185
186 /**
187 * The profile group id used for display
188 *
189 * @var integer
190 * @access protected
191 */
192 protected $_ufGroupID;
193
194 /*
195 * csv - common search values
196 *
197 * @var array
198 * @access protected
199 * @static
200 */
201
202 static $csv = array('contact_type', 'group', 'tag');
203
204 /**
205 * @var string how to display the results. Should we display as
206 * contributons, members, cases etc
207 */
208 protected $_componentMode;
209
210 /**
211 * @var string what operator should we use, AND or OR
212 */
213 protected $_operator;
214
215 protected $_modeValue;
216
217 /**
218 * have we already done this search
219 *
220 * @access protected
221 * @var boolean
222 */
223 protected $_done;
224
225 /**
226 * name of the selector to use
227 */
228 static $_selectorName = 'CRM_Contact_Selector';
229 protected $_customSearchID = NULL;
230 protected $_customSearchClass = NULL;
231
232 protected $_openedPanes = array();
233
234 /**
235 * define the set of valid contexts that the search form operates on
236 *
237 * @return array the valid context set and the titles
238 * @access protected
239 * @static
240 */
241 static function &validContext() {
242 if (!(self::$_validContext)) {
243 self::$_validContext = array(
244 'smog' => 'Show members of group',
245 'amtg' => 'Add members to group',
246 'basic' => 'Basic Search',
247 'search' => 'Search',
248 'builder' => 'Search Builder',
249 'advanced' => 'Advanced Search',
250 'custom' => 'Custom Search',
251 );
252 }
253 return self::$_validContext;
254 }
255
256 static function isSearchContext($context) {
257 $searchContext = CRM_Utils_Array::value($context, self::validContext());
258 return $searchContext ? TRUE : FALSE;
259 }
260
261 static function setModeValues() {
262 if (!self::$_modeValues) {
263 self::$_modeValues = array(
264 1 => array(
265 'selectorName' => self::$_selectorName,
266 'selectorLabel' => ts('Contacts'),
267 'taskFile' => 'CRM/Contact/Form/Search/ResultTasks.tpl',
268 'taskContext' => NULL,
269 'resultFile' => 'CRM/Contact/Form/Selector.tpl',
270 'resultContext' => NULL,
271 'taskClassName' => 'CRM_Contact_Task',
272 ),
273 2 => array(
274 'selectorName' => 'CRM_Contribute_Selector_Search',
275 'selectorLabel' => ts('Contributions'),
276 'taskFile' => 'CRM/common/searchResultTasks.tpl',
277 'taskContext' => 'Contribution',
278 'resultFile' => 'CRM/Contribute/Form/Selector.tpl',
279 'resultContext' => 'Search',
280 'taskClassName' => 'CRM_Contribute_Task',
281 ),
282 3 => array(
283 'selectorName' => 'CRM_Event_Selector_Search',
284 'selectorLabel' => ts('Event Participants'),
285 'taskFile' => 'CRM/common/searchResultTasks.tpl',
286 'taskContext' => NULL,
287 'resultFile' => 'CRM/Event/Form/Selector.tpl',
288 'resultContext' => 'Search',
289 'taskClassName' => 'CRM_Event_Task',
290 ),
291 4 => array(
292 'selectorName' => 'CRM_Activity_Selector_Search',
293 'selectorLabel' => ts('Activities'),
294 'taskFile' => 'CRM/common/searchResultTasks.tpl',
295 'taskContext' => NULL,
296 'resultFile' => 'CRM/Activity/Form/Selector.tpl',
297 'resultContext' => 'Search',
298 'taskClassName' => 'CRM_Activity_Task',
299 ),
300 5 => array(
301 'selectorName' => 'CRM_Member_Selector_Search',
302 'selectorLabel' => ts('Memberships'),
303 'taskFile' => "CRM/common/searchResultTasks.tpl",
304 'taskContext' => NULL,
305 'resultFile' => 'CRM/Member/Form/Selector.tpl',
306 'resultContext' => 'Search',
307 'taskClassName' => 'CRM_Member_Task',
308 ),
309 6 => array(
310 'selectorName' => 'CRM_Case_Selector_Search',
311 'selectorLabel' => ts('Cases'),
312 'taskFile' => "CRM/common/searchResultTasks.tpl",
313 'taskContext' => NULL,
314 'resultFile' => 'CRM/Case/Form/Selector.tpl',
315 'resultContext' => 'Search',
316 'taskClassName' => 'CRM_Case_Task',
317 ),
318 7 => array(
319 'selectorName' => self::$_selectorName,
320 'selectorLabel' => ts('Related Contacts'),
321 'taskFile' => 'CRM/Contact/Form/Search/ResultTasks.tpl',
322 'taskContext' => NULL,
323 'resultFile' => 'CRM/Contact/Form/Selector.tpl',
324 'resultContext' => NULL,
325 'taskClassName' => 'CRM_Contact_Task',
326 ),
327 8 => array(
328 'selectorName' => 'CRM_Mailing_Selector_Search',
329 'selectorLabel' => ts('Mailings'),
330 'taskFile' => "CRM/common/searchResultTasks.tpl",
331 'taskContext' => NULL,
332 'resultFile' => 'CRM/Mailing/Form/Selector.tpl',
333 'resultContext' => 'Search',
334 'taskClassName' => 'CRM_Mailing_Task',
335 ),
336 );
337 }
338 }
339
340 static function getModeValue($mode = 1) {
341 self::setModeValues();
342
343 if (!array_key_exists($mode, self::$_modeValues)) {
344 $mode = 1;
345 }
346
347 return self::$_modeValues[$mode];
348 }
349
350 static function getModeSelect() {
351 self::setModeValues();
352
353 $select = array();
354 foreach (self::$_modeValues as $id => & $value) {
355 $select[$id] = $value['selectorLabel'];
356 }
357
358 // unset contributions or participants if user does not have
359 // permission on them
360 if (!CRM_Core_Permission::access('CiviContribute')) {
361 unset($select['2']);
362 }
363
364 if (!CRM_Core_Permission::access('CiviEvent')) {
365 unset($select['3']);
366 }
367
368 if (!CRM_Core_Permission::check('view all activities')) {
369 unset($select['4']);
370 }
371 return $select;
372 }
373
374 /**
375 * Build the common elements between the search/advanced form
376 *
377 * @access public
378 *
379 * @return void
380 */
381 function buildQuickForm() {
382 $permission = CRM_Core_Permission::getPermission();
383 // some tasks.. what do we want to do with the selected contacts ?
384 $tasks = array('' => ts('- actions -'));
385 if ($this->_componentMode == 1 || $this->_componentMode == 7) {
386 $tasks += CRM_Contact_Task::permissionedTaskTitles($permission,
387 CRM_Utils_Array::value('deleted_contacts', $this->_formValues)
388 );
389 }
390 else {
391 $className = $this->_modeValue['taskClassName'];
392 $tasks += $className::permissionedTaskTitles($permission, false);
393 }
394
395 if (isset($this->_ssID)) {
396 if ($permission == CRM_Core_Permission::EDIT) {
397 $tasks = $tasks + CRM_Contact_Task::optionalTaskTitle();
398 }
399
400 $search_custom_id =
401 CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_SavedSearch', $this->_ssID, 'search_custom_id');
402
403 $savedSearchValues = array(
404 'id' => $this->_ssID,
405 'name' => CRM_Contact_BAO_SavedSearch::getName($this->_ssID, 'title'),
406 'search_custom_id' => $search_custom_id,
407 );
408 $this->assign_by_ref('savedSearch', $savedSearchValues);
409 $this->assign('ssID', $this->_ssID);
410 }
411
412 if ($this->_context === 'smog') {
413 // CRM-11788, we might want to do this for all of search where force=1
414 $formQFKey = CRM_Utils_Array::value('qfKey', $this->_formValues);
415 $getQFKey = CRM_Utils_Array::value('qfKey', $_GET);
416 $postQFKey = CRM_Utils_Array::value('qfKey', $_POST);
417 if ($formQFKey && empty($getQFKey) && empty($postQFKey)) {
418 $url = CRM_Utils_System::makeURL('qfKey') . $formQFKey;
419 CRM_Utils_System::redirect($url);
420 }
421 $permissionForGroup = FALSE;
422
423 if (!empty($this->_groupID)) {
424 // check if user has permission to edit members of this group
425 $permission = CRM_Contact_BAO_Group::checkPermission($this->_groupID);
426 if ($permission && in_array(CRM_Core_Permission::EDIT, $permission)) {
427 $permissionForGroup = TRUE;
428 }
429
430 // check if _groupID exists, it might not if
431 // we are displaying a hidden group
432 if (!isset($this->_group[$this->_groupID])) {
433 $this->_group[$this->_groupID] =
434 CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID, 'title');
435 }
436
437 // set the group title
438 $groupValues = array('id' => $this->_groupID, 'title' => $this->_group[$this->_groupID]);
439 $this->assign_by_ref('group', $groupValues);
440
441 // also set ssID if this is a saved search
442 $ssID = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID, 'saved_search_id');
443 $this->assign('ssID', $ssID);
444
445 //get the saved search mapping id
446 if ($ssID) {
447 $this->_ssID = $ssID;
448 $ssMappingId = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_SavedSearch', $ssID, 'mapping_id');
449 $this->assign('ssMappingID', $ssMappingId);
450 }
451
452 // Set dynamic page title for 'Show Members of Group'
453 CRM_Utils_System::setTitle(ts('Contacts in Group: %1', array(1 => $this->_group[$this->_groupID])));
454 }
455
456 $group_contact_status = array();
457 foreach (CRM_Core_SelectValues::groupContactStatus() as $k => $v) {
458 if (!empty($k)) {
459 $group_contact_status[] = $this->createElement('checkbox', $k, NULL, $v);
460 }
461 }
462 $this->addGroup($group_contact_status,
463 'group_contact_status', ts('Group Status')
464 );
465
466 $this->assign('permissionedForGroup', $permissionForGroup);
467 }
468
469 // add the go button for the action form, note it is of type 'next' rather than of type 'submit'
470 if ($this->_context === 'amtg') {
471 // check if _groupID exists, it might not if
472 // we are displaying a hidden group
473 if (!isset($this->_group[$this->_amtgID])) {
474 $this->assign('permissionedForGroup', FALSE);
475 $this->_group[$this->_amtgID] =
476 CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Group', $this->_amtgID, 'title');
477 }
478
479 // Set dynamic page title for 'Add Members Group'
480 CRM_Utils_System::setTitle(ts('Add to Group: %1', array(1 => $this->_group[$this->_amtgID])));
481 // also set the group title and freeze the action task with Add Members to Group
482 $groupValues = array('id' => $this->_amtgID, 'title' => $this->_group[$this->_amtgID]);
483 $this->assign_by_ref('group', $groupValues);
484 $this->add('submit', $this->_actionButtonName, ts('Add Contacts to %1', array(1 => $this->_group[$this->_amtgID])),
485 array(
486 'class' => 'form-submit',
487 'onclick' => "return checkPerformAction('mark_x', '" . $this->getName() . "', 1);",
488 )
489 );
490 $this->add('hidden', 'task', CRM_Contact_Task::GROUP_CONTACTS);
491 }
492 else {
493 $this->add('select', 'task', ts('Actions:') . ' ', $tasks);
494 $this->add('submit', $this->_actionButtonName, ts('Go'),
495 array(
496 'class' => 'form-submit',
497 'id' => 'Go',
498 'onclick' => "return checkPerformAction('mark_x', '" . $this->getName() . "', 0, 1);",
499 )
500 );
501 }
502
503 // need to perform tasks on all or selected items ? using radio_ts(task selection) for it
504 $selectedRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_sel', array(
505 'checked' => 'checked',
506 'onclick' => 'toggleTaskAction( true );',
507 ));
508 $this->assign('ts_sel_id', $selectedRowsRadio->_attributes['id']);
509
510
511 if ($qfKeyParam = CRM_Utils_Array::value('qfKey', $this->_formValues)) {
512 $qfKeyParam = "civicrm search {$qfKeyParam}";
513 $selectedContactIdsArr = CRM_Core_BAO_PrevNextCache::getSelection($qfKeyParam);
514 $selectedContactIds = array_keys($selectedContactIdsArr[$qfKeyParam]);
515 }
516
517 $this->assign_by_ref('selectedContactIds', $selectedContactIds);
518
519 $allRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_all', array('onclick' => $this->getName() . ".toggleSelect.checked = false; toggleCheckboxVals('mark_x_', this);toggleTaskAction( true );toggleContactSelection( 'resetSel', '{$qfKeyParam}', 'reset' );"));
520 $this->assign('ts_all_id', $allRowsRadio->_attributes['id']);
521
522 /*
523 * add form checkboxes for each row. This is needed out here to conform to QF protocol
524 * of all elements being declared in builQuickForm
525 */
526
527 $rows = $this->get('rows');
528
529 if (is_array($rows)) {
530 $this->addElement('checkbox', 'toggleSelect', NULL, NULL, array('onclick' => "toggleTaskAction( true ); toggleCheckboxVals('mark_x_',this);return toggleContactSelection( 'toggleSelect', '" . $qfKeyParam . "' , 'multiple' );"));
531
532 $unselectedContactIds = array();
533 foreach ($rows as $row) {
534 $this->addElement('checkbox', $row['checkbox'],
535 NULL, NULL,
536 array('onclick' => "toggleContactSelection( '" . $row['checkbox'] . "', '" . $qfKeyParam . "' , 'single' );toggleTaskAction( true ); return checkSelectedBox('" . $row['checkbox'] . "');")
537 );
538
539 if (!in_array($row['contact_id'], $selectedContactIds)) {
540 $unselectedContactIds[] = $row['contact_id'];
541 }
542 }
543 $this->assign_by_ref('unselectedContactIds', $unselectedContactIds);
544 }
545
546 // add buttons
547 $this->addButtons(array(
548 array(
549 'type' => 'refresh',
550 'name' => ts('Search'),
551 'isDefault' => TRUE,
552 ),
553 )
554 );
555
556 $this->add('submit', $this->_printButtonName, ts('Print'),
557 array(
558 'class' => 'form-submit',
559 'id' => 'Print',
560 'onclick' => "return checkPerformAction('mark_x', '" . $this->getName() . "', 1, 1);",
561 )
562 );
563
564 $this->setDefaultAction('refresh');
565 }
566
567 /**
568 * processing needed for buildForm and later
569 *
570 * @return void
571 * @access public
572 */
573 function preProcess() {
574 // set the various class variables
575
576 $this->_group = CRM_Core_PseudoConstant::group();
577
578 $this->_groupIterator = CRM_Core_PseudoConstant::groupIterator();
579 $this->_tag = CRM_Core_BAO_Tag::getTags();
580 $this->_done = FALSE;
581
582 /*
583 * we allow the controller to set force/reset externally, useful when we are being
584 * driven by the wizard framework
585 */
586
587 $this->_reset = CRM_Utils_Request::retrieve('reset', 'Boolean',
588 CRM_Core_DAO::$_nullObject
589 );
590
591 $this->_force = CRM_Utils_Request::retrieve('force', 'Boolean', CRM_Core_DAO::$_nullObject);
592 $this->_groupID = CRM_Utils_Request::retrieve('gid', 'Positive', $this);
593 $this->_amtgID = CRM_Utils_Request::retrieve('amtgID', 'Positive', $this);
594 $this->_ssID = CRM_Utils_Request::retrieve('ssID', 'Positive', $this);
595 $this->_sortByCharacter = CRM_Utils_Request::retrieve('sortByCharacter', 'String', $this);
596 $this->_ufGroupID = CRM_Utils_Request::retrieve('id', 'Positive', $this);
597 $this->_componentMode = CRM_Utils_Request::retrieve('component_mode', 'Positive', $this, FALSE, 1, $_REQUEST);
598 $this->_operator = CRM_Utils_Request::retrieve('operator', 'String', $this, FALSE, 1, $_REQUEST, 'AND');
599
600 /**
601 * set the button names
602 */
603 $this->_searchButtonName = $this->getButtonName('refresh');
604 $this->_printButtonName = $this->getButtonName('next', 'print');
605 $this->_actionButtonName = $this->getButtonName('next', 'action');
606
607 $this->assign('printButtonName', $this->_printButtonName);
608
609 $this->assign('actionButtonName', $this->_actionButtonName);
610
611 // reset from session, CRM-3526
612 $session = CRM_Core_Session::singleton();
613 if ($this->_force && $session->get('selectedSearchContactIds')) {
614 $session->resetScope('selectedSearchContactIds');
615 }
616
617 // if we dont get this from the url, use default if one exsts
618 $config = CRM_Core_Config::singleton();
619 if ($this->_ufGroupID == NULL &&
620 $config->defaultSearchProfileID != NULL
621 ) {
622 $this->_ufGroupID = $config->defaultSearchProfileID;
623 }
624
625 // assign context to drive the template display, make sure context is valid
626 $this->_context = CRM_Utils_Request::retrieve('context', 'String', $this, FALSE, 'search');
627 if (!CRM_Utils_Array::value($this->_context, self::validContext())) {
628 $this->_context = 'search';
629 }
630 $this->set('context', $this->_context);
631 $this->assign('context', $this->_context);
632
633 $this->_modeValue = self::getModeValue($this->_componentMode);
634 $this->assign($this->_modeValue);
635
636 $this->set('selectorName', self::$_selectorName);
637
638 // get user submitted values
639 // get it from controller only if form has been submitted, else preProcess has set this
640 // $this->controller->isModal( ) returns true if page is
641 // valid, i.e all the validations are true
642
643 if (!empty($_POST) && !$this->controller->isModal()) {
644 $this->_formValues = $this->controller->exportValues($this->_name);
645
646 $this->normalizeFormValues();
647 $this->_params = CRM_Contact_BAO_Query::convertFormValues($this->_formValues);
648 $this->_returnProperties = &$this->returnProperties();
649
650 // also get the uf group id directly from the post value
651 $this->_ufGroupID = CRM_Utils_Array::value('uf_group_id', $_POST, $this->_ufGroupID);
652 $this->_formValues['uf_group_id'] = $this->_ufGroupID;
653 $this->set('id', $this->_ufGroupID);
654
655 // also get the object mode directly from the post value
656 $this->_componentMode = CRM_Utils_Array::value('component_mode', $_POST, $this->_componentMode);
657
658 // also get the operator from the post value if set
659 $this->_operator = CRM_Utils_Array::value('operator', $_POST, $this->_operator);
660 $this->_formValues['operator'] = $this->_operator;
661 $this->set('operator', $this->_operator);
662 }
663 else {
664 $this->_formValues = $this->get('formValues');
665 $this->_params = CRM_Contact_BAO_Query::convertFormValues($this->_formValues);
666 $this->_returnProperties = &$this->returnProperties();
667 if (!empty($this->_ufGroupID)) {
668 $this->set('id', $this->_ufGroupID);
669 }
670 }
671
672 if (empty($this->_formValues)) {
673 //check if group is a smart group (fix for CRM-1255)
674 if ($this->_groupID) {
675 if ($ssId = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Group', $this->_groupID, 'saved_search_id')) {
676 $this->_ssID = $ssId;
677 }
678 }
679
680 // fix for CRM-1907
681 if (isset($this->_ssID) && $this->_context != 'smog') {
682 // we only retrieve the saved search values if out current values are null
683 $this->_formValues = CRM_Contact_BAO_SavedSearch::getFormValues($this->_ssID);
684
685 //fix for CRM-1505
686 if (CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_SavedSearch', $this->_ssID, 'mapping_id')) {
687 $this->_params = CRM_Contact_BAO_SavedSearch::getSearchParams($this->_ssID);
688 }
689 else {
690 $this->_params = CRM_Contact_BAO_Query::convertFormValues($this->_formValues);
691 }
692 $this->_returnProperties = &$this->returnProperties();
693 }
694 else {
695 if (isset($this->_ufGroupID)) {
696 // also set the uf group id if not already present
697 $this->_formValues['uf_group_id'] = $this->_ufGroupID;
698 }
699 if (isset($this->_componentMode)) {
700 $this->_formValues['component_mode'] = $this->_componentMode;
701 }
702 if (isset($this->_operator)) {
703 $this->_formValues['operator'] = $this->_operator;
704 }
705
706 // FIXME: we should generalise in a way that components could inject url-filters
707 // just like they build their own form elements
708 foreach (array(
709 'mailing_id', 'mailing_delivery_status', 'mailing_open_status',
710 'mailing_click_status', 'mailing_reply_status', 'mailing_optout',
711 'mailing_forward', 'mailing_unsubscribe', 'mailing_date_low',
712 'mailing_date_high',
713 ) as $mailingFilter) {
714 $type = 'String';
715 if ($mailingFilter == 'mailing_id' &&
716 $filterVal = CRM_Utils_Request::retrieve('mailing_id', 'Positive', $this)
717 ) {
718 $this->_formValues[$mailingFilter] = array($filterVal);
719 }
720 elseif ($filterVal = CRM_Utils_Request::retrieve($mailingFilter, $type, $this)) {
721 $this->_formValues[$mailingFilter] = $filterVal;
722 }
723 if ($filterVal) {
724 $this->_openedPanes['Mailings'] = 1;
725 $this->_formValues['hidden_CiviMail'] = 1;
726 }
727 }
728 }
729 }
730 $this->assign('id',
731 CRM_Utils_Array::value('uf_group_id', $this->_formValues)
732 );
733 $operator = CRM_Utils_Array::value('operator', $this->_formValues, 'AND');
734 $this->set('queryOperator', $operator);
735 if ($operator == 'OR') {
736 $this->assign('operator', ts('OR'));
737 }
738 else {
739 $this->assign('operator', ts('AND'));
740 }
741
742 // show the context menu only when we’re not searching for deleted contacts; CRM-5673
743 if (!CRM_Utils_Array::value('deleted_contacts', $this->_formValues)) {
744 $menuItems = CRM_Contact_BAO_Contact::contextMenu();
745 $primaryActions = CRM_Utils_Array::value('primaryActions', $menuItems, array());
746 $this->_contextMenu = CRM_Utils_Array::value('moreActions', $menuItems, array());
747 $this->assign('contextMenu', $primaryActions + $this->_contextMenu);
748 }
749
750 if (!isset($this->_componentMode)) {
751 $this->_componentMode = CRM_Contact_BAO_Query::MODE_CONTACTS;
752 }
753 $modeValues = self::getModeValue($this->_componentMode);
754
755 self::$_selectorName = $this->_modeValue['selectorName'];
756
757 $setDynamic = FALSE;
758 if (strpos(self::$_selectorName, 'CRM_Contact_Selector') !== FALSE) {
759 $selector = new self::$_selectorName(
760 $this->_customSearchClass,
761 $this->_formValues,
762 $this->_params,
763 $this->_returnProperties,
764 $this->_action,
765 false, true,
766 $this->_context,
767 $this->_contextMenu
768 );
769 $setDynamic = TRUE;
770 }
771 else {
772 $selector = new self::$_selectorName(
773 $this->_params,
774 $this->_action,
775 null, false, null,
776 "search", "advanced"
777 );
778 }
779
780 $selector->setKey($this->controller->_key);
781
782 $controller = new CRM_Contact_Selector_Controller($selector,
783 $this->get(CRM_Utils_Pager::PAGE_ID),
784 $this->get(CRM_Utils_Sort::SORT_ID),
785 CRM_Core_Action::VIEW,
786 $this,
787 CRM_Core_Selector_Controller::TRANSFER
788 );
789 $controller->setEmbedded(TRUE);
790 $controller->setDynamicAction($setDynamic);
791
792 if ($this->_force) {
793
794 $this->postProcess();
795
796 /*
797 * Note that we repeat this, since the search creates and stores
798 * values that potentially change the controller behavior. i.e. things
799 * like totalCount etc
800 */
801 $sortID = NULL;
802 if ($this->get(CRM_Utils_Sort::SORT_ID)) {
803 $sortID = CRM_Utils_Sort::sortIDValue($this->get(CRM_Utils_Sort::SORT_ID),
804 $this->get(CRM_Utils_Sort::SORT_DIRECTION)
805 );
806 }
807 $controller = new CRM_Contact_Selector_Controller($selector,
808 $this->get(CRM_Utils_Pager::PAGE_ID),
809 $sortID,
810 CRM_Core_Action::VIEW, $this, CRM_Core_Selector_Controller::TRANSFER
811 );
812 $controller->setEmbedded(TRUE);
813 $controller->setDynamicAction($setDynamic);
814 }
815
816 $controller->moveFromSessionToTemplate();
817 }
818
819 function &getFormValues() {
820 return $this->_formValues;
821 }
822
823 /**
824 * Common post processing
825 *
826 * @return void
827 * @access public
828 */
829 function postProcess() {
830 /*
831 * sometime we do a postProcess early on, so we dont need to repeat it
832 * this will most likely introduce some more bugs :(
833 */
834
835 if ($this->_done) {
836 return;
837 }
838 $this->_done = TRUE;
839
840 //for prev/next pagination
841 $crmPID = CRM_Utils_Request::retrieve('crmPID', 'Integer', CRM_Core_DAO::$_nullObject);
842
843 if (array_key_exists($this->_searchButtonName, $_POST) ||
844 ($this->_force && !$crmPID)) {
845 //reset the cache table for new search
846 $cacheKey = "civicrm search {$this->controller->_key}";
847 CRM_Core_BAO_PrevNextCache::deleteItem(NULL, $cacheKey);
848 }
849
850 //get the button name
851 $buttonName = $this->controller->getButtonName();
852
853 if (isset($this->_ufGroupID) &&
854 !CRM_Utils_Array::value('uf_group_id', $this->_formValues)
855 ) {
856 $this->_formValues['uf_group_id'] = $this->_ufGroupID;
857 }
858
859 if (isset($this->_componentMode) &&
860 !CRM_Utils_Array::value('component_mode', $this->_formValues)
861 ) {
862 $this->_formValues['component_mode'] = $this->_componentMode;
863 }
864
865 if (isset($this->_operator) &&
866 !CRM_Utils_Array::value('operator', $this->_formValues)
867 ) {
868 $this->_formValues['operator'] = $this->_operator;
869 }
870
871 if (!CRM_Utils_Array::value('qfKey', $this->_formValues)) {
872 $this->_formValues['qfKey'] = $this->controller->_key;
873 }
874
875 if (!CRM_Core_Permission::check('access deleted contacts')) {
876 unset($this->_formValues['deleted_contacts']);
877 }
878
879 $this->set('type', $this->_action);
880 $this->set('formValues', $this->_formValues);
881 $this->set('queryParams', $this->_params);
882 $this->set('returnProperties', $this->_returnProperties);
883
884 if ($buttonName == $this->_actionButtonName || $buttonName == $this->_printButtonName) {
885 // check actionName and if next, then do not repeat a search, since we are going to the next page
886 // hack, make sure we reset the task values
887 $stateMachine = $this->controller->getStateMachine();
888 $formName = $stateMachine->getTaskFormName();
889 $this->controller->resetPage($formName);
890 return;
891 }
892 else {
893 $output = CRM_Core_Selector_Controller::SESSION;
894
895 // create the selector, controller and run - store results in session
896 $searchChildGroups = TRUE;
897 if ($this->get('isAdvanced')) {
898 $searchChildGroups = FALSE;
899 }
900
901 $setDynamic = FALSE;
902
903 if (strpos(self::$_selectorName, 'CRM_Contact_Selector') !== FALSE) {
904 $selector = new self::$_selectorName (
905 $this->_customSearchClass,
906 $this->_formValues,
907 $this->_params,
908 $this->_returnProperties,
909 $this->_action,
910 false,
911 $searchChildGroups,
912 $this->_context,
913 $this->_contextMenu
914 );
915 $setDynamic = TRUE;
916 }
917 else {
918 $selector = new self::$_selectorName (
919 $this->_params,
920 $this->_action,
921 null,
922 false,
923 null,
924 "search",
925 "advanced"
926 );
927 }
928
929 $selector->setKey($this->controller->_key);
930
931 // added the sorting character to the form array
932 $config = CRM_Core_Config::singleton();
933 // do this only for contact search
934 if ($setDynamic && $config->includeAlphabeticalPager) {
935 // Don't recompute if we are just paging/sorting
936 if ($this->_reset || (empty($_GET['crmPID']) && empty($_GET['crmSID']) && !$this->_sortByCharacter)) {
937 $aToZBar = CRM_Utils_PagerAToZ::getAToZBar($selector, $this->_sortByCharacter);
938 $this->set('AToZBar', $aToZBar);
939 }
940 }
941
942 $sortID = NULL;
943 if ($this->get(CRM_Utils_Sort::SORT_ID)) {
944 $sortID = CRM_Utils_Sort::sortIDValue($this->get(CRM_Utils_Sort::SORT_ID),
945 $this->get(CRM_Utils_Sort::SORT_DIRECTION)
946 );
947 }
948 $controller = new CRM_Contact_Selector_Controller($selector,
949 $this->get(CRM_Utils_Pager::PAGE_ID),
950 $sortID,
951 CRM_Core_Action::VIEW,
952 $this,
953 $output
954 );
955 $controller->setEmbedded(TRUE);
956 $controller->setDynamicAction($setDynamic);
957 $controller->run();
958 }
959 }
960
961 function &returnProperties() {
962 return CRM_Core_DAO::$_nullObject;
963 }
964
965 /**
966 * Return a descriptive name for the page, used in wizard header
967 *
968 * @return string
969 * @access public
970 */
971 function getTitle() {
972 return ts('Search');
973 }
974 }
975