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
20 * This class contains all contact related functions that are called using AJAX (jQuery)
22 class CRM_Contact_Page_AJAX
{
24 * When a user chooses a username, CHECK_USERNAME_TTL
25 * is the time window in which they can check usernames
26 * (without reloading the overall form).
29 const CHECK_USERNAME_TTL
= 10800;
32 const AUTOCOMPLETE_TTL
= 21600;
35 * Ajax callback for custom fields of type ContactReference
37 * Todo: Migrate contact reference fields to use EntityRef
39 public static function contactReference() {
40 $name = CRM_Utils_Array
::value('term', $_GET);
41 $name = CRM_Utils_Type
::escape($name, 'String');
42 $cfID = CRM_Utils_Type
::escape($_GET['id'], 'Positive');
44 // check that this is a valid, active custom field of Contact Reference type
45 $params = ['id' => $cfID];
46 $returnProperties = ['filter', 'data_type', 'is_active'];
48 CRM_Core_DAO
::commonRetrieve('CRM_Core_DAO_CustomField', $params, $cf, $returnProperties);
49 if (!$cf['id'] ||
!$cf['is_active'] ||
$cf['data_type'] != 'ContactReference') {
50 CRM_Utils_System
::civiExit(1);
53 if (!empty($cf['filter'])) {
55 parse_str($cf['filter'], $filterParams);
57 $action = CRM_Utils_Array
::value('action', $filterParams);
58 if (!empty($action) && !in_array($action, ['get', 'lookup'])) {
59 CRM_Utils_System
::civiExit(1);
62 if (!empty($filterParams['group'])) {
63 $filterParams['group'] = explode(',', $filterParams['group']);
67 $list = array_keys(CRM_Core_BAO_Setting
::valueOptions(CRM_Core_BAO_Setting
::SYSTEM_PREFERENCES_NAME
,
68 'contact_reference_options'
71 $return = array_unique(array_merge(['sort_name'], $list));
73 $limit = Civi
::settings()->get('search_autocomplete_count');
75 $params = ['offset' => 0, 'rowCount' => $limit, 'version' => 3];
76 foreach ($return as $fld) {
77 $params["return.{$fld}"] = 1;
80 if (!empty($action)) {
96 foreach ($_GET as $param => $val) {
98 in_array($param, $excludeGet) ||
99 strpos($param, 'return.') !== FALSE ||
100 strpos($param, 'api.') !== FALSE
104 $params[$param] = $val;
109 $params['sort_name'] = $name;
112 $params['sort'] = 'sort_name';
114 // tell api to skip permission chk. dgg
115 $params['check_permissions'] = 0;
117 // add filter variable to params
118 if (!empty($filterParams)) {
119 $params = array_merge($params, $filterParams);
122 $contact = civicrm_api('Contact', 'Get', $params);
124 if (!empty($contact['is_error'])) {
125 CRM_Utils_System
::civiExit(1);
129 foreach ($contact['values'] as $value) {
131 foreach ($return as $fld) {
132 if (!empty($value[$fld])) {
133 $view[] = $value[$fld];
136 $contactList[] = ['id' => $value['id'], 'text' => implode(' :: ', $view)];
139 if (!empty($_GET['is_unit_test'])) {
142 CRM_Utils_JSON
::output($contactList);
146 * Fetch PCP ID by PCP Supporter sort_name, also displays PCP title and associated Contribution Page title
148 public static function getPCPList() {
149 $name = CRM_Utils_Array
::value('term', $_GET);
150 $name = CRM_Utils_Type
::escape($name, 'String');
151 $limit = $max = Civi
::settings()->get('search_autocomplete_count');
153 $where = ' AND pcp.page_id = cp.id AND pcp.contact_id = cc.id';
155 $config = CRM_Core_Config
::singleton();
156 if ($config->includeWildCardInName
) {
157 $strSearch = "%$name%";
160 $strSearch = "$name%";
162 $includeEmailFrom = $includeNickName = '';
163 if ($config->includeNickNameInName
) {
164 $includeNickName = " OR nick_name LIKE '$strSearch'";
166 if ($config->includeEmailInName
) {
167 $includeEmailFrom = "LEFT JOIN civicrm_email eml ON ( cc.id = eml.contact_id AND eml.is_primary = 1 )";
168 $whereClause = " WHERE ( email LIKE '$strSearch' OR sort_name LIKE '$strSearch' $includeNickName ) {$where} ";
171 $whereClause = " WHERE ( sort_name LIKE '$strSearch' $includeNickName ) {$where} ";
174 $offset = $count = 0;
175 if (!empty($_GET['page_num'])) {
176 $page = (int) $_GET['page_num'];
177 $offset = $limit * ($page - 1);
181 $select = 'cc.sort_name, pcp.title, cp.title';
185 SELECT pcp.id as id, CONCAT_WS( ' :: ', {$select} ) as data, sort_name
186 FROM civicrm_pcp pcp, civicrm_contribution_page cp, civicrm_contact cc
188 {$whereClause} AND pcp.page_type = 'contribute'
190 SELECT pcp.id as id, CONCAT_WS( ' :: ', {$select} ) as data, sort_name
191 FROM civicrm_pcp pcp, civicrm_event cp, civicrm_contact cc
193 {$whereClause} AND pcp.page_type = 'event'
196 LIMIT $offset, $limit
199 $dao = CRM_Core_DAO
::executeQuery($query);
200 $output = ['results' => [], 'more' => FALSE];
201 while ($dao->fetch()) {
202 if (++
$count > $max) {
203 $output['more'] = TRUE;
206 $output['results'][] = ['id' => $dao->id
, 'text' => $dao->data
];
209 CRM_Utils_JSON
::output($output);
212 public static function relationship() {
213 $relType = CRM_Utils_Request
::retrieve('rel_type', 'String', CRM_Core_DAO
::$_nullObject, TRUE);
214 $relContactID = CRM_Utils_Request
::retrieve('rel_contact', 'Positive', CRM_Core_DAO
::$_nullObject, TRUE);
215 $originalCid = CRM_Utils_Request
::retrieve('cid', 'Positive');
216 $relationshipID = CRM_Utils_Request
::retrieve('rel_id', 'Positive');
217 $caseID = CRM_Utils_Request
::retrieve('case_id', 'Positive', CRM_Core_DAO
::$_nullObject, TRUE);
219 if (!CRM_Case_BAO_Case
::accessCase($caseID)) {
220 CRM_Utils_System
::permissionDenied();
223 $ret = ['is_error' => 0];
225 list($relTypeId, $b, $a) = explode('_', $relType);
227 if ($relationshipID && $originalCid) {
228 CRM_Case_BAO_Case
::endCaseRole($caseID, $a, $originalCid, $relTypeId);
231 $clientList = CRM_Case_BAO_Case
::getCaseClients($caseID);
233 // Loop through multiple case clients
234 foreach ($clientList as $i => $sourceContactID) {
237 'case_id' => $caseID,
238 'relationship_type_id' => $relTypeId,
239 "contact_id_$a" => $relContactID,
240 "contact_id_$b" => $sourceContactID,
241 'sequential' => TRUE,
243 // first check if there is any existing relationship present with same parameters.
244 // If yes then update the relationship by setting active and start date to current time
245 $relationship = civicrm_api3('Relationship', 'get', $params)['values'];
246 $params = array_merge(CRM_Utils_Array
::value(0, $relationship, $params), [
247 'start_date' => 'now',
251 $result = civicrm_api3('relationship', 'create', $params);
253 catch (CiviCRM_API3_Exception
$e) {
254 $ret['is_error'] = 1;
255 $ret['error_message'] = $e->getMessage();
257 // Save activity only for the primary (first) client
258 if ($i == 0 && empty($result['is_error'])) {
259 CRM_Case_BAO_Case
::createCaseRoleActivity($caseID, $result['id'], $relContactID, $sourceContactID);
262 if (!empty($_REQUEST['is_unit_test'])) {
266 CRM_Utils_JSON
::output($ret);
270 * Fetch the custom field help.
272 public static function customField() {
273 $fieldId = CRM_Utils_Type
::escape($_REQUEST['id'], 'Integer');
274 $params = ['id' => $fieldId];
275 $returnProperties = ['help_pre', 'help_post'];
278 CRM_Core_DAO
::commonRetrieve('CRM_Core_DAO_CustomField', $params, $values, $returnProperties);
279 CRM_Utils_JSON
::output($values);
282 public static function groupTree() {
283 CRM_Utils_System
::setHttpHeader('Content-Type', 'application/json');
284 $gids = CRM_Utils_Type
::escape($_GET['gids'], 'String');
285 echo CRM_Contact_BAO_GroupNestingCache
::json($gids);
286 CRM_Utils_System
::civiExit();
290 * Delete custom value.
292 public static function deleteCustomValue() {
293 CRM_Utils_System
::setHttpHeader('Content-Type', 'text/plain');
294 $customValueID = CRM_Utils_Type
::escape($_REQUEST['valueID'], 'Positive');
295 $customGroupID = CRM_Utils_Type
::escape($_REQUEST['groupID'], 'Positive');
296 $contactId = CRM_Utils_Request
::retrieve('contactId', 'Positive');
297 CRM_Core_BAO_CustomValue
::deleteCustomValue($customValueID, $customGroupID);
299 echo CRM_Contact_BAO_Contact
::getCountComponent('custom_' . $customGroupID, $contactId);
302 CRM_Contact_BAO_GroupContactCache
::opportunisticCacheFlush();
303 CRM_Utils_System
::civiExit();
307 * check the CMS username.
309 public static function checkUserName() {
310 $signer = new CRM_Utils_Signer(CRM_Core_Key
::privateKey(), ['for', 'ts']);
311 $sig = CRM_Utils_Request
::retrieve('sig', 'String');
312 $for = CRM_Utils_Request
::retrieve('for', 'String');
314 CRM_Utils_Time
::getTimeRaw() > $_REQUEST['ts'] + self
::CHECK_USERNAME_TTL
315 ||
$for != 'civicrm/ajax/cmsuser'
316 ||
!$signer->validate($sig, $_REQUEST)
318 $user = ['name' => 'error'];
319 CRM_Utils_JSON
::output($user);
322 $config = CRM_Core_Config
::singleton();
323 $username = trim(CRM_Utils_Array
::value('cms_name', $_REQUEST));
325 $params = ['name' => $username];
328 $config->userSystem
->checkUserNameEmailExists($params, $errors);
330 if (isset($errors['cms_name']) ||
isset($errors['name'])) {
331 //user name is not available
332 $user = ['name' => 'no'];
333 CRM_Utils_JSON
::output($user);
336 //user name is available
337 $user = ['name' => 'yes'];
338 CRM_Utils_JSON
::output($user);
341 // Not reachable: JSON::output() above exits.
342 CRM_Utils_System
::civiExit();
346 * Function to get email address of a contact.
348 public static function getContactEmail() {
350 $name = CRM_Utils_Array
::value('name', $_GET);
352 $name = CRM_Utils_Type
::escape($name, 'String');
353 $wildCard = Civi
::settings()->get('includeWildCardInName') ?
'%' : '';
354 foreach (['cc.sort_name', 'ce.email'] as $column) {
355 $queryStrings[] = "{$column} LIKE '{$wildCard}{$name}%'";
358 $rowCount = Civi
::settings()->get('search_autocomplete_count');
360 // add acl clause here
361 list($aclFrom, $aclWhere) = CRM_Contact_BAO_Contact_Permission
::cacheClause('cc');
363 $aclWhere = "AND {$aclWhere}";
365 foreach ($queryStrings as &$queryString) {
367 SELECT sort_name name, ce.email, cc.id
368 FROM civicrm_email ce INNER JOIN civicrm_contact cc ON cc.id = ce.contact_id
370 WHERE ce.on_hold = 0 AND cc.is_deceased = 0 AND cc.do_not_email = 0 AND {$queryString}
375 $query = implode(' UNION ', $queryStrings) . " LIMIT {$rowCount}";
377 // send query to hook to be modified if needed
378 CRM_Utils_Hook
::contactListQuery($query,
380 CRM_Utils_Request
::retrieve('context', 'Alphanumeric'),
381 CRM_Utils_Request
::retrieve('cid', 'Positive')
384 $dao = CRM_Core_DAO
::executeQuery($query);
386 while ($dao->fetch()) {
389 'text' => '"' . $dao->name
. '" <' . $dao->email
. '>',
390 'id' => (CRM_Utils_Array
::value('id', $_GET)) ?
"{$dao->id}::{$dao->email}" : '"' . $dao->name
. '" <' . $dao->email
. '>',
393 CRM_Utils_JSON
::output($result);
395 CRM_Utils_System
::civiExit();
398 public static function getContactPhone() {
402 //check for mobile type
403 $phoneTypes = CRM_Core_OptionGroup
::values('phone_type', TRUE, FALSE, FALSE, NULL, 'name');
404 $mobileType = CRM_Utils_Array
::value('Mobile', $phoneTypes);
406 $name = CRM_Utils_Request
::retrieveValue('name', 'String', NULL, FALSE, 'GET');
408 $key = (int) count(array_keys($sqlParmas)) +
1;
409 $queryString = " ( cc.sort_name LIKE %{$key} OR cp.phone LIKE %{$key} ) ";
410 $sqlParams[$key] = ['%' . $name . '%', 'String'];
413 $cid = CRM_Utils_Request
::retrieveValue('cid', 'CommaSeparatedIntegers', NULL, FALSE, 'GET');
415 $queryString = " cc.id IN ( $cid )";
421 $offset = (int) CRM_Utils_Request
::retrieveValue('offset', 'Integer', 0, FALSE, 'GET');
422 $rowCount = (int) CRM_Utils_Request
::retrieveValue('rowcount', 'Integer', 20, FALSE, 'GET');
424 // add acl clause here
425 list($aclFrom, $aclWhere) = CRM_Contact_BAO_Contact_Permission
::cacheClause('cc');
427 $aclWhere = " AND $aclWhere";
431 SELECT sort_name name, cp.phone, cc.id
432 FROM civicrm_phone cp INNER JOIN civicrm_contact cc ON cc.id = cp.contact_id
434 WHERE cc.is_deceased = 0 AND cc.do_not_sms = 0 AND cp.phone_type_id = {$mobileType} AND {$queryString}
436 LIMIT {$offset}, {$rowCount}
439 // send query to hook to be modified if needed
440 CRM_Utils_Hook
::contactListQuery($query,
442 CRM_Utils_Request
::retrieve('context', 'Alphanumeric'),
443 CRM_Utils_Request
::retrieve('cid', 'Positive')
446 $dao = CRM_Core_DAO
::executeQuery($query, $sqlParams);
448 while ($dao->fetch()) {
450 'text' => '"' . $dao->name
. '" (' . $dao->phone
. ')',
451 'id' => (CRM_Utils_Array
::value('id', $_GET)) ?
"{$dao->id}::{$dao->phone}" : '"' . $dao->name
. '" <' . $dao->phone
. '>',
454 CRM_Utils_JSON
::output($result);
456 CRM_Utils_System
::civiExit();
459 public static function buildSubTypes() {
460 $parent = CRM_Utils_Request
::retrieve('parentId', 'Positive');
464 $contactType = 'Individual';
468 $contactType = 'Household';
472 $contactType = 'Organization';
476 $subTypes = CRM_Contact_BAO_ContactType
::subTypePairs($contactType, FALSE, NULL);
478 CRM_Utils_JSON
::output($subTypes);
481 public static function buildDedupeRules() {
482 $parent = CRM_Utils_Request
::retrieve('parentId', 'Positive');
486 $contactType = 'Individual';
490 $contactType = 'Household';
494 $contactType = 'Organization';
498 $dedupeRules = CRM_Dedupe_BAO_RuleGroup
::getByType($contactType);
500 CRM_Utils_JSON
::output($dedupeRules);
504 * Function used for CiviCRM dashboard operations.
506 public static function dashboard() {
507 switch ($_REQUEST['op']) {
509 CRM_Core_BAO_Dashboard
::saveDashletChanges($_REQUEST['columns']);
512 case 'delete_dashlet':
513 $dashletID = CRM_Utils_Type
::escape($_REQUEST['dashlet_id'], 'Positive');
514 CRM_Core_BAO_Dashboard
::deleteDashlet($dashletID);
517 CRM_Utils_System
::civiExit();
521 * Retrieve signature based on email id.
523 public static function getSignature() {
524 $emailID = CRM_Utils_Type
::escape($_REQUEST['emailID'], 'Positive');
525 $query = "SELECT signature_text, signature_html FROM civicrm_email WHERE id = {$emailID}";
526 $dao = CRM_Core_DAO
::executeQuery($query);
529 while ($dao->fetch()) {
531 'signature_text' => $dao->signature_text
,
532 'signature_html' => $dao->signature_html
,
536 CRM_Utils_JSON
::output($signatures);
542 public static function processDupes() {
543 $oper = CRM_Utils_Type
::escape($_REQUEST['op'], 'String');
544 $cid = CRM_Utils_Type
::escape($_REQUEST['cid'], 'Positive');
545 $oid = CRM_Utils_Type
::escape($_REQUEST['oid'], 'Positive');
547 if (!$oper ||
!$cid ||
!$oid) {
551 $status = self
::markNonDuplicates($cid, $oid, $oper);
553 CRM_Utils_JSON
::output(['status' => ($status) ?
$oper : $status]);
557 * Retrieve list of duplicate pairs from cache table.
559 public static function getDedupes() {
560 $offset = isset($_REQUEST['start']) ? CRM_Utils_Type
::escape($_REQUEST['start'], 'Integer') : 0;
561 $rowCount = isset($_REQUEST['length']) ? CRM_Utils_Type
::escape($_REQUEST['length'], 'Integer') : 25;
563 $gid = CRM_Utils_Request
::retrieve('gid', 'Positive');
564 $rgid = CRM_Utils_Request
::retrieve('rgid', 'Positive');
565 $limit = CRM_Utils_Request
::retrieveValue('limit', 'Positive', 0);
567 $criteria = CRM_Utils_Request
::retrieve('criteria', 'Json', $null, FALSE, '{}');
568 $selected = CRM_Utils_Request
::retrieveValue('selected', 'Boolean');
573 $whereClause = $orderByClause = '';
574 $cacheKeyString = CRM_Dedupe_Merger
::getMergeCacheKeyString($rgid, $gid, json_decode($criteria, TRUE), TRUE, $limit);
578 $searchParams = self
::getSearchOptionsFromRequest();
584 $isOrQuery = self
::isOrQuery();
588 'dst' => 'cc1.display_name',
589 'src' => 'cc2.display_name',
590 'dst_email' => 'ce1.email',
591 'src_email' => 'ce2.email',
592 'dst_postcode' => 'ca1.postal_code',
593 'src_postcode' => 'ca2.postal_code',
594 'dst_street' => 'ca1.street',
595 'src_street' => 'ca2.street',
598 foreach ($mappings as $key => $dbName) {
599 if (!empty($searchParams[$key])) {
601 $wildcard = strstr($key, 'postcode') ?
'' : '%';
602 $queryParams[$nextParamKey] = [$wildcard . $searchParams[$key] . '%', 'String'];
603 $where[] = $dbName . " LIKE %{$nextParamKey} ";
609 $whereClause = ' ( ' . implode(' OR ', $where) . ' ) ';
612 if (!empty($where)) {
613 $whereClause = implode(' AND ', $where);
616 $whereClause .= $whereClause ?
' AND de.id IS NULL' : ' de.id IS NULL';
619 $whereClause .= ' AND pn.is_selected = 1';
621 $join .= CRM_Dedupe_Merger
::getJoinOnDedupeTable();
624 'cc1.contact_type' => 'dst_contact_type',
625 'cc1.display_name' => 'dst_display_name',
626 'cc1.contact_sub_type' => 'dst_contact_sub_type',
627 'cc2.contact_type' => 'src_contact_type',
628 'cc2.display_name' => 'src_display_name',
629 'cc2.contact_sub_type' => 'src_contact_sub_type',
630 'ce1.email' => 'dst_email',
631 'ce2.email' => 'src_email',
632 'ca1.postal_code' => 'dst_postcode',
633 'ca2.postal_code' => 'src_postcode',
634 'ca1.street_address' => 'dst_street',
635 'ca2.street_address' => 'src_street',
639 $join .= " INNER JOIN civicrm_contact cc1 ON cc1.id = pn.entity_id1";
640 $join .= " INNER JOIN civicrm_contact cc2 ON cc2.id = pn.entity_id2";
641 $join .= " LEFT JOIN civicrm_email ce1 ON (ce1.contact_id = pn.entity_id1 AND ce1.is_primary = 1 )";
642 $join .= " LEFT JOIN civicrm_email ce2 ON (ce2.contact_id = pn.entity_id2 AND ce2.is_primary = 1 )";
643 $join .= " LEFT JOIN civicrm_address ca1 ON (ca1.contact_id = pn.entity_id1 AND ca1.is_primary = 1 )";
644 $join .= " LEFT JOIN civicrm_address ca2 ON (ca2.contact_id = pn.entity_id2 AND ca2.is_primary = 1 )";
646 $iTotal = CRM_Core_BAO_PrevNextCache
::getCount($cacheKeyString, $join, $whereClause, '=', $queryParams);
647 if (!empty($_REQUEST['order'])) {
648 foreach ($_REQUEST['order'] as $orderInfo) {
649 if (!empty($orderInfo['column'])) {
650 $orderColumnNumber = $orderInfo['column'];
651 $dir = CRM_Utils_Type
::escape($orderInfo['dir'], 'MysqlOrderByDirection', FALSE);
654 $columnDetails = CRM_Utils_Array
::value($orderColumnNumber, $_REQUEST['columns']);
656 if (!empty($columnDetails)) {
657 switch ($columnDetails['data']) {
659 $orderByClause = " ORDER BY cc2.display_name {$dir}";
663 $orderByClause = " ORDER BY ce2.email {$dir}";
667 $orderByClause = " ORDER BY ca2.street_address {$dir}";
671 $orderByClause = " ORDER BY ca2.postal_code {$dir}";
675 $orderByClause = " ORDER BY cc1.display_name {$dir}";
679 $orderByClause = " ORDER BY ce1.email {$dir}";
683 $orderByClause = " ORDER BY ca1.street_address {$dir}";
687 $orderByClause = " ORDER BY ca1.postal_code {$dir}";
691 $orderByClause = " ORDER BY cc1.display_name ASC";
696 $dupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, $join, $whereClause, $offset, $rowCount, $select, $orderByClause, TRUE, $queryParams);
697 $iFilteredTotal = CRM_Core_DAO
::singleValueQuery("SELECT FOUND_ROWS()");
700 foreach ($dupePairs as $key => $pairInfo) {
701 $pair = $pairInfo['data'];
702 $srcContactSubType = CRM_Utils_Array
::value('src_contact_sub_type', $pairInfo);
703 $dstContactSubType = CRM_Utils_Array
::value('dst_contact_sub_type', $pairInfo);
704 $srcTypeImage = CRM_Contact_BAO_Contact_Utils
::getImage($srcContactSubType ?
705 $srcContactSubType : $pairInfo['src_contact_type'],
707 $pairInfo['entity_id2']
709 $dstTypeImage = CRM_Contact_BAO_Contact_Utils
::getImage($dstContactSubType ?
710 $dstContactSubType : $pairInfo['dst_contact_type'],
712 $pairInfo['entity_id1']
715 $searchRows[$count]['is_selected'] = $pairInfo['is_selected'];
716 $searchRows[$count]['is_selected_input'] = "<input type='checkbox' class='crm-dedupe-select' name='pnid_{$pairInfo['prevnext_id']}' value='{$pairInfo['is_selected']}' onclick='toggleDedupeSelect(this)'>";
717 $searchRows[$count]['src_image'] = $srcTypeImage;
718 $searchRows[$count]['src'] = CRM_Utils_System
::href($pair['srcName'], 'civicrm/contact/view', "reset=1&cid={$pairInfo['entity_id2']}");
719 $searchRows[$count]['src_email'] = CRM_Utils_Array
::value('src_email', $pairInfo);
720 $searchRows[$count]['src_street'] = CRM_Utils_Array
::value('src_street', $pairInfo);
721 $searchRows[$count]['src_postcode'] = CRM_Utils_Array
::value('src_postcode', $pairInfo);
722 $searchRows[$count]['dst_image'] = $dstTypeImage;
723 $searchRows[$count]['dst'] = CRM_Utils_System
::href($pair['dstName'], 'civicrm/contact/view', "reset=1&cid={$pairInfo['entity_id1']}");
724 $searchRows[$count]['dst_email'] = CRM_Utils_Array
::value('dst_email', $pairInfo);
725 $searchRows[$count]['dst_street'] = CRM_Utils_Array
::value('dst_street', $pairInfo);
726 $searchRows[$count]['dst_postcode'] = CRM_Utils_Array
::value('dst_postcode', $pairInfo);
727 $searchRows[$count]['conflicts'] = str_replace("',", "',<br/>", CRM_Utils_Array
::value('conflicts', $pair));
728 $searchRows[$count]['weight'] = CRM_Utils_Array
::value('weight', $pair);
730 if (!empty($pairInfo['data']['canMerge'])) {
733 'cid' => $pairInfo['entity_id1'],
734 'oid' => $pairInfo['entity_id2'],
735 'action' => 'update',
737 'criteria' => $criteria,
738 'limit' => CRM_Utils_Request
::retrieve('limit', 'Integer'),
741 $mergeParams['gid'] = $gid;
744 $searchRows[$count]['actions'] = "<a class='crm-dedupe-flip' href='#' data-pnid={$pairInfo['prevnext_id']}>" . ts('flip') . "</a> | ";
745 $searchRows[$count]['actions'] .= CRM_Utils_System
::href(ts('merge'), 'civicrm/contact/merge', $mergeParams);
746 $searchRows[$count]['actions'] .= " | <a id='notDuplicate' href='#' onClick=\"processDupes( {$pairInfo['entity_id1']}, {$pairInfo['entity_id2']}, 'dupe-nondupe', 'dupe-listing'); return false;\">" . ts('not a duplicate') . "</a>";
749 $searchRows[$count]['actions'] = '<em>' . ts('Insufficient access rights - cannot merge') . '</em>';
755 'data' => $searchRows,
756 'recordsTotal' => $iTotal,
757 'recordsFiltered' => $iFilteredTotal,
759 if (!empty($_REQUEST['is_unit_test'])) {
762 CRM_Utils_JSON
::output($dupePairs);
766 * Get the searchable options from the request.
770 public static function getSearchOptionsFromRequest() {
772 $searchData = CRM_Utils_Array
::value('search', $_REQUEST);
773 $searchData['value'] = CRM_Utils_Type
::escape($searchData['value'], 'String');
774 $selectorElements = [
791 $columns = $_REQUEST['columns'];
793 foreach ($columns as $column) {
794 if (!empty($column['search']['value']) && in_array($column['data'], $selectorElements)) {
795 $searchParams[$column['data']] = CRM_Utils_Type
::escape($column['search']['value'], 'String');
797 elseif (!empty($searchData['value'])) {
798 $searchParams[$column['data']] = $searchData['value'];
801 return $searchParams;
805 * Is the query an OR query.
807 * If a generic search value is passed in - ie. $_REQUEST['search']['value'] = 'abc'
808 * then all fields are searched for this.
810 * It is unclear if there is any code that still passes this in or whether is is just legacy. It
811 * could cause a server-killing query on a large site so it probably is NOT in use if we haven't
816 public static function isOrQuery() {
817 $searchData = CRM_Utils_Array
::value('search', $_REQUEST);
818 return !empty($searchData['value']);
822 * Mark not duplicates.
824 * Note this function would sensibly be replaced by an api-call but extracting here to add a test first.
826 * I would have like to make it private but test class accesses it & it doesn't warrant being a BAO class
827 * as it should feel very endangered.
831 * @param "dupe-nondupe|nondupe-dupe" $oper
833 * @return \CRM_Core_DAO|mixed|null
835 public static function markNonDuplicates($cid, $oid, $oper) {
836 if ($oper == 'dupe-nondupe') {
838 civicrm_api3('Exception', 'create', ['contact_id1' => $cid, 'contact_id2' => $oid]);
841 catch (CiviCRM_API3_Exception
$e) {
846 $exception = new CRM_Dedupe_DAO_Exception();
847 $exception->contact_id1
= $cid;
848 $exception->contact_id2
= $oid;
849 //make sure contact2 > contact1.
851 $exception->contact_id1
= $oid;
852 $exception->contact_id2
= $cid;
854 $exception->find(TRUE);
857 if ($oper == 'nondupe-dupe') {
858 $status = $exception->delete();
864 * Retrieve a PDF Page Format for the PDF Letter form.
866 public function pdfFormat() {
867 $formatId = CRM_Utils_Type
::escape($_REQUEST['formatId'], 'Integer');
869 $pdfFormat = CRM_Core_BAO_PdfFormat
::getById($formatId);
871 CRM_Utils_JSON
::output($pdfFormat);
875 * Retrieve Paper Size dimensions.
877 public static function paperSize() {
878 $paperSizeName = CRM_Utils_Type
::escape($_REQUEST['paperSizeName'], 'String');
880 $paperSize = CRM_Core_BAO_PaperSize
::getByName($paperSizeName);
882 CRM_Utils_JSON
::output($paperSize);
886 * Swap contacts in a dupe pair i.e main with duplicate contact.
888 * @param int $prevNextId
890 public static function flipDupePairs($prevNextId = NULL) {
892 // @todo figure out if this is always POST & specify that rather than inexact GET
894 // We cannot use CRM_Utils_Request::retrieve() because it might be an array.
895 // It later gets validated in escapeAll below.
896 $prevNextId = $_REQUEST['pnid'];
899 $onlySelected = FALSE;
900 if (is_array($prevNextId) && !CRM_Utils_Array
::crmIsEmptyArray($prevNextId)) {
901 $onlySelected = TRUE;
903 $prevNextId = CRM_Utils_Type
::escapeAll((array) $prevNextId, 'Positive');
904 CRM_Core_BAO_PrevNextCache
::flipPair($prevNextId, $onlySelected);
905 CRM_Utils_System
::civiExit();
909 * Used to store selected contacts across multiple pages in advanced search.
911 public static function selectUnselectContacts() {
912 $name = CRM_Utils_Array
::value('name', $_REQUEST);
913 $cacheKey = CRM_Utils_Array
::value('qfKey', $_REQUEST);
914 $state = CRM_Utils_Array
::value('state', $_REQUEST, 'checked');
915 $variableType = CRM_Utils_Array
::value('variableType', $_REQUEST, 'single');
917 $actionToPerform = CRM_Utils_Array
::value('action', $_REQUEST, 'select');
919 if ($variableType == 'multiple') {
920 // action post value only works with multiple type variable
922 //multiple names like mark_x_1-mark_x_2 where 1,2 are cids
923 $elements = explode('-', $name);
924 foreach ($elements as $key => $element) {
925 $elements[$key] = self
::_convertToId($element);
927 CRM_Utils_Type
::escapeAll($elements, 'Integer');
928 Civi
::service('prevnext')->markSelection($cacheKey, $actionToPerform, $elements);
931 Civi
::service('prevnext')->markSelection($cacheKey, $actionToPerform);
934 elseif ($variableType == 'single') {
935 $cId = self
::_convertToId($name);
936 CRM_Utils_Type
::escape($cId, 'Integer');
937 $action = ($state == 'checked') ?
'select' : 'unselect';
938 Civi
::service('prevnext')->markSelection($cacheKey, $action, $cId);
940 $contactIds = Civi
::service('prevnext')->getSelection($cacheKey);
941 $countSelectionCids = count($contactIds[$cacheKey]);
943 $arrRet = ['getCount' => $countSelectionCids];
944 CRM_Utils_JSON
::output($arrRet);
948 * @param string $name
952 public static function _convertToId($name) {
953 if (substr($name, 0, CRM_Core_Form
::CB_PREFIX_LEN
) == CRM_Core_Form
::CB_PREFIX
) {
954 $cId = substr($name, CRM_Core_Form
::CB_PREFIX_LEN
);
959 public static function getAddressDisplay() {
960 $contactId = CRM_Utils_Request
::retrieve('contact_id', 'Positive');
962 $addressVal["error_message"] = "no contact id found";
966 'contact_id' => $contactId,
967 'entity_id' => $contactId,
969 $addressVal = CRM_Core_BAO_Address
::getValues($entityBlock);
972 CRM_Utils_JSON
::output($addressVal);
976 * Mark dupe pairs as selected from un-selected state or vice-versa, in dupe cache table.
978 public static function toggleDedupeSelect() {
979 $pnid = $_REQUEST['pnid'];
980 $isSelected = CRM_Utils_Type
::escape($_REQUEST['is_selected'], 'Boolean');
981 $cacheKeyString = CRM_Utils_Request
::retrieve('cacheKey', 'Alphanumeric', $null, FALSE);
984 1 => [$isSelected, 'Boolean'],
985 // using % to address rows with conflicts as well
986 3 => ["$cacheKeyString%", 'String'],
989 //check pnid is_array or integer
991 if (is_array($pnid) && !CRM_Utils_Array
::crmIsEmptyArray($pnid)) {
992 CRM_Utils_Type
::escapeAll($pnid, 'Positive');
993 $pnid = implode(', ', $pnid);
994 $whereClause = " id IN ( {$pnid} ) ";
997 $pnid = CRM_Utils_Type
::escape($pnid, 'Integer');
998 $whereClause = " id = %2";
999 $params[2] = [$pnid, 'Integer'];
1002 $sql = "UPDATE civicrm_prevnext_cache SET is_selected = %1 WHERE {$whereClause} AND cachekey LIKE %3";
1003 CRM_Core_DAO
::executeQuery($sql, $params);
1005 CRM_Utils_System
::civiExit();
1009 * Retrieve contact relationships.
1011 public static function getContactRelationships() {
1012 $contactID = CRM_Utils_Type
::escape($_GET['cid'], 'Integer');
1013 $context = CRM_Utils_Request
::retrieve('context', 'Alphanumeric');
1014 $relationship_type_id = CRM_Utils_Type
::escape(CRM_Utils_Array
::value('relationship_type_id', $_GET), 'Integer', FALSE);
1016 if (!CRM_Contact_BAO_Contact_Permission
::allow($contactID)) {
1017 return CRM_Utils_System
::permissionDenied();
1020 $params = CRM_Core_Page_AJAX
::defaultSortAndPagerParams();
1022 $params['contact_id'] = $contactID;
1023 $params['context'] = $context;
1024 if ($relationship_type_id) {
1025 $params['relationship_type_id'] = $relationship_type_id;
1028 // get the contact relationships
1029 $relationships = CRM_Contact_BAO_Relationship
::getContactRelationshipSelector($params);
1031 CRM_Utils_JSON
::output($relationships);