Merge pull request #4893 from colemanw/INFRA-132
[civicrm-core.git] / CRM / Core / BAO / UFField.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
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-2014
32 * $Id$
33 *
34 */
35
36 /**
37 * This class contains function for UFField
38 *
39 */
40 class CRM_Core_BAO_UFField extends CRM_Core_DAO_UFField {
41
42 /**
43 * Batch entry fields
44 */
45 private static $_contriBatchEntryFields = NULL;
46 private static $_memberBatchEntryFields = NULL;
47
48
49 /**
50 * Fetch object based on array of properties
51 *
52 * @param array $params
53 * (reference ) an assoc array of name/value pairs.
54 * @param array $defaults
55 * (reference ) an assoc array to hold the flattened values.
56 *
57 * @return CRM_Core_BAO_UFField object
58 * @static
59 */
60 public static function retrieve(&$params, &$defaults) {
61 return CRM_Core_DAO::commonRetrieve('CRM_Core_DAO_UFField', $params, $defaults);
62 }
63
64 /**
65 * Get the form title.
66 *
67 * @param int $id
68 * Id of uf_form.
69 *
70 * @return string
71 * title
72 *
73 * @static
74 */
75 public static function getTitle($id) {
76 return CRM_Core_DAO::getFieldValue('CRM_Core_DAO_UFField', $groupId, 'title');
77 }
78
79 /**
80 * Update the is_active flag in the db
81 *
82 * @param int $id
83 * Id of the database record.
84 * @param bool $is_active
85 * Value we want to set the is_active field.
86 *
87 * @return Object
88 * DAO object on sucess, null otherwise
89 * @static
90 */
91 public static function setIsActive($id, $is_active) {
92 //check if custom data profile field is disabled
93 if ($is_active) {
94 if (CRM_Core_BAO_UFField::checkUFStatus($id)) {
95 return CRM_Core_DAO::setFieldValue('CRM_Core_DAO_UFField', $id, 'is_active', $is_active);
96 }
97 else {
98 CRM_Core_Session::setStatus(ts('Cannot enable this UF field since the used custom field is disabled.'), ts('Check Custom Field'), 'error');
99 }
100 }
101 else {
102 return CRM_Core_DAO::setFieldValue('CRM_Core_DAO_UFField', $id, 'is_active', $is_active);
103 }
104 }
105
106 /**
107 * Delete the profile Field.
108 *
109 * @param int $id
110 * Field Id.
111 *
112 * @return boolean
113 *
114 * @static
115 */
116 public static function del($id) {
117 //delete field field
118 $field = new CRM_Core_DAO_UFField();
119 $field->id = $id;
120 $field->delete();
121 return TRUE;
122 }
123
124 /**
125 * Check duplicate for duplicate field in a group
126 *
127 * @param array $params
128 * An associative array with field and values.
129 * @param $ids
130 *
131 * @return mixed
132 * @ids array $ids array that containd ids
133 *
134 * @static
135 */
136 public static function duplicateField($params, $ids) {
137 $ufField = new CRM_Core_DAO_UFField();
138 $ufField->uf_group_id = CRM_Utils_Array::value('uf_group', $ids);
139 $ufField->field_type = $params['field_name'][0];
140 $ufField->field_name = $params['field_name'][1];
141 if ($params['field_name'][1] == 'url') {
142 $ufField->website_type_id = CRM_Utils_Array::value(2, $params['field_name'], NULL);
143 }
144 else {
145 $ufField->location_type_id = (CRM_Utils_Array::value(2, $params['field_name'])) ? $params['field_name'][2] : 'NULL';
146 }
147 $ufField->phone_type_id = CRM_Utils_Array::value(3, $params['field_name']);
148
149 if (!empty($ids['uf_field'])) {
150 $ufField->whereAdd("id <> " . CRM_Utils_Array::value('uf_field', $ids));
151 }
152
153 return $ufField->find(TRUE);
154 }
155
156 /**
157 * Does profile consists of a multi-record custom field
158 */
159 public static function checkMultiRecordFieldExists($gId) {
160 $queryString = "SELECT f.field_name
161 FROM civicrm_uf_field f, civicrm_uf_group g
162 WHERE f.uf_group_id = g.id
163 AND g.id = %1 AND f.field_name LIKE 'custom%'";
164 $p = array(1 => array($gId, 'Integer'));
165 $dao = CRM_Core_DAO::executeQuery($queryString, $p);
166 $customFieldIds = array();
167 $isMultiRecordFieldPresent = FALSE;
168 while ($dao->fetch()) {
169 if ($customId = CRM_Core_BAO_CustomField::getKeyID($dao->field_name)) {
170 if (is_numeric($customId)) {
171 $customFieldIds[] = $customId;
172 }
173 }
174 }
175
176 if (!empty($customFieldIds) && count($customFieldIds) == 1) {
177 $customFieldId = array_pop($customFieldIds);
178 $isMultiRecordFieldPresent = CRM_Core_BAO_CustomField::isMultiRecordField($customFieldId);
179 }
180 elseif (count($customFieldIds) > 1) {
181 $customFieldIds = implode(", ", $customFieldIds);
182 $queryString = "
183 SELECT cg.id as cgId
184 FROM civicrm_custom_group cg
185 INNER JOIN civicrm_custom_field cf
186 ON cg.id = cf.custom_group_id
187 WHERE cf.id IN (" . $customFieldIds . ") AND is_multiple = 1 LIMIT 0,1";
188
189 $dao = CRM_Core_DAO::executeQuery($queryString);
190 if ($dao->fetch()) {
191 $isMultiRecordFieldPresent = ($dao->cgId) ? $dao->cgId : FALSE;
192 }
193 }
194
195 return $isMultiRecordFieldPresent;
196 }
197
198 /**
199 * Add the UF Field
200 *
201 * @param array $params
202 * (reference) array containing the values submitted by the form.
203 * @param array $ids
204 * Array containing the id.
205 *
206 * @return CRM_Core_BAO_UFField object
207 *
208 * @static
209 */
210 public static function add(&$params, $ids = array()) {
211 // set values for uf field properties and save
212 $ufField = new CRM_Core_DAO_UFField();
213 $ufField->field_type = $params['field_name'][0];
214 $ufField->field_name = $params['field_name'][1];
215
216 //should not set location type id for Primary
217 $locationTypeId = NULL;
218 if ($params['field_name'][1] == 'url') {
219 $ufField->website_type_id = CRM_Utils_Array::value(2, $params['field_name']);
220 }
221 else {
222 $locationTypeId = CRM_Utils_Array::value(2, $params['field_name']);
223 $ufField->website_type_id = NULL;
224 }
225 if ($locationTypeId) {
226 $ufField->location_type_id = $locationTypeId;
227 }
228 else {
229 $ufField->location_type_id = 'null';
230 }
231
232 $ufField->phone_type_id = CRM_Utils_Array::value(3, $params['field_name'], 'NULL');
233 $ufField->listings_title = CRM_Utils_Array::value('listings_title', $params);
234 $ufField->visibility = CRM_Utils_Array::value('visibility', $params);
235 $ufField->help_pre = CRM_Utils_Array::value('help_pre', $params);
236 $ufField->help_post = CRM_Utils_Array::value('help_post', $params);
237 $ufField->label = CRM_Utils_Array::value('label', $params);
238 $ufField->is_required = CRM_Utils_Array::value('is_required', $params, FALSE);
239 $ufField->is_active = CRM_Utils_Array::value('is_active', $params, FALSE);
240 $ufField->in_selector = CRM_Utils_Array::value('in_selector', $params, FALSE);
241 $ufField->is_view = CRM_Utils_Array::value('is_view', $params, FALSE);
242 $ufField->is_registration = CRM_Utils_Array::value('is_registration', $params, FALSE);
243 $ufField->is_match = CRM_Utils_Array::value('is_match', $params, FALSE);
244 $ufField->is_searchable = CRM_Utils_Array::value('is_searchable', $params, FALSE);
245 $ufField->is_multi_summary = CRM_Utils_Array::value('is_multi_summary', $params, FALSE);
246 $ufField->weight = CRM_Utils_Array::value('weight', $params, 0);
247
248 // need the FKEY - uf group id
249 $ufField->uf_group_id = CRM_Utils_Array::value('uf_group', $ids, FALSE);
250 $ufField->id = CRM_Utils_Array::value('uf_field', $ids, FALSE);
251
252 return $ufField->save();
253 }
254
255 /**
256 * Automatically determine one weight and modify others
257 *
258 * @param array $params
259 * UFField record, e.g. with 'weight', 'uf_group_id', and 'field_id'.
260 * @return int
261 */
262 public static function autoWeight($params) {
263 // fix for CRM-316
264 $oldWeight = NULL;
265
266 if (!empty($params['field_id'])) {
267 $oldWeight = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_UFField', $params['field_id'], 'weight', 'id');
268 }
269 $fieldValues = array('uf_group_id' => $params['group_id']);
270 return CRM_Utils_Weight::updateOtherWeights('CRM_Core_DAO_UFField', $oldWeight, CRM_Utils_Array::value('weight', $params, 0), $fieldValues);
271 }
272
273 /**
274 * Enable/disable profile field given a custom field id
275 *
276 * @param int $customFieldId
277 * Custom field id.
278 * @param bool $is_active
279 * Set the is_active field.
280 *
281 * @return void
282 * @static
283 */
284 public static function setUFField($customFieldId, $is_active) {
285 //find the profile id given custom field
286 $ufField = new CRM_Core_DAO_UFField();
287 $ufField->field_name = "custom_" . $customFieldId;
288
289 $ufField->find();
290 while ($ufField->fetch()) {
291 //enable/ disable profile
292 CRM_Core_BAO_UFField::setIsActive($ufField->id, $is_active);
293 }
294 }
295
296 /**
297 * Copy existing profile fields to
298 * new profile from the already built profile
299 *
300 * @param int $old_id
301 * From which we need to copy.
302 * @param bool $new_id
303 * In which to copy.
304 *
305 * @return void
306 * @static
307 */
308 public static function copy($old_id, $new_id) {
309 $ufField = new CRM_Core_DAO_UFField();
310 $ufField->uf_group_id = $old_id;
311 $ufField->find();
312 while ($ufField->fetch()) {
313 //copy the field records as it is on new ufgroup id
314 $ufField->uf_group_id = $new_id;
315 $ufField->id = NULL;
316 $ufField->save();
317 }
318 }
319
320 /**
321 * Delete profile field given a custom field
322 *
323 * @param int $customFieldId
324 * ID of the custom field to be deleted.
325 *
326 * @return void
327 *
328 * @static
329 */
330 public static function delUFField($customFieldId) {
331 //find the profile id given custom field id
332 $ufField = new CRM_Core_DAO_UFField();
333 $ufField->field_name = "custom_" . $customFieldId;
334
335 $ufField->find();
336 while ($ufField->fetch()) {
337 //enable/ disable profile
338 CRM_Core_BAO_UFField::del($ufField->id);
339 }
340 }
341
342 /**
343 * Enable/disable profile field given a custom group id
344 *
345 * @param int $customGroupId
346 * Custom group id.
347 * @param bool $is_active
348 * Value we want to set the is_active field.
349 *
350 * @return void
351 * @static
352 */
353 public static function setUFFieldStatus($customGroupId, $is_active) {
354 //find the profile id given custom group id
355 $queryString = "SELECT civicrm_custom_field.id as custom_field_id
356 FROM civicrm_custom_field, civicrm_custom_group
357 WHERE civicrm_custom_field.custom_group_id = civicrm_custom_group.id
358 AND civicrm_custom_group.id = %1";
359 $p = array(1 => array($customGroupId, 'Integer'));
360 $dao = CRM_Core_DAO::executeQuery($queryString, $p);
361
362 while ($dao->fetch()) {
363 //enable/ disable profile
364 CRM_Core_BAO_UFField::setUFField($dao->custom_field_id, $is_active);
365 }
366 }
367
368 /**
369 * Check the status of custom field used in uf fields
370 *
371 * @param int $UFFieldId
372 *
373 * @return boolean
374 * false if custom field are disabled else true
375 * @static
376 */
377 public static function checkUFStatus($UFFieldId) {
378 $fieldName = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_UFField', $UFFieldId, 'field_name');
379 // return if field is not a custom field
380 if (!$customFieldId = CRM_Core_BAO_CustomField::getKeyID($fieldName)) {
381 return TRUE;
382 }
383
384 $customField = new CRM_Core_DAO_CustomField();
385 $customField->id = $customFieldId;
386 // if uf field is custom field
387 if ($customField->find(TRUE)) {
388 if (!$customField->is_active) {
389 return FALSE;
390 }
391 else {
392 return TRUE;
393 }
394 }
395 }
396
397 /**
398 * Find out whether given profile group using Activity
399 * Profile fields with contact fields
400 */
401 public static function checkContactActivityProfileType($ufGroupId) {
402 $ufGroup = new CRM_Core_DAO_UFGroup();
403 $ufGroup->id = $ufGroupId;
404 $ufGroup->find(TRUE);
405
406 return self::checkContactActivityProfileTypeByGroupType($ufGroup->group_type);
407 }
408
409 /**
410 * FIXME say 10 ha
411 * @param $ufGroupType
412 * @return bool
413 */
414 public static function checkContactActivityProfileTypeByGroupType($ufGroupType) {
415 $profileTypes = array();
416 if ($ufGroupType) {
417 $typeParts = explode(CRM_Core_DAO::VALUE_SEPARATOR, $ufGroupType);
418 $profileTypes = explode(',', $typeParts[0]);
419 }
420
421 if (empty($profileTypes)) {
422 return FALSE;
423 }
424 $components = array('Contribution', 'Participant', 'Membership');
425 if (!in_array('Activity', $profileTypes)) {
426 return FALSE;
427 }
428 elseif (count($profileTypes) == 1) {
429 return FALSE;
430 }
431
432 if ($index = array_search('Contact', $profileTypes)) {
433 unset($profileTypes[$index]);
434 if (count($profileTypes) == 1) {
435 return TRUE;
436 }
437 }
438
439 $contactTypes = array('Individual', 'Household', 'Organization');
440 $subTypes = CRM_Contact_BAO_ContactType::subTypes();
441
442 $profileTypeComponent = array_intersect($components, $profileTypes);
443 if (!empty($profileTypeComponent) ||
444 count(array_intersect($contactTypes, $profileTypes)) > 1 ||
445 count(array_intersect($subTypes, $profileTypes)) > 1
446 ) {
447 return FALSE;
448 }
449
450 return TRUE;
451 }
452
453 /**
454 * Find out whether given profile group uses $required
455 * and/or $optional profile types
456 *
457 * @param int $ufGroupId
458 * Profile id.
459 * @param array $required
460 * Array of types those are required.
461 * @param array $optional
462 * Array of types those are optional.
463 *
464 * @return boolean
465 * @static
466 */
467 public static function checkValidProfileType($ufGroupId, $required, $optional = NULL) {
468 if (!is_array($required) || empty($required)) {
469 return;
470 }
471
472 $ufGroup = new CRM_Core_DAO_UFGroup();
473 $ufGroup->id = $ufGroupId;
474 $ufGroup->find(TRUE);
475
476 $profileTypes = array();
477 if ($ufGroup->group_type) {
478 $typeParts = explode(CRM_Core_DAO::VALUE_SEPARATOR, $ufGroup->group_type);
479 $profileTypes = explode(',', $typeParts[0]);
480 }
481
482 if (empty($profileTypes)) {
483 return FALSE;
484 }
485
486 $valid = TRUE;
487 foreach ($required as $key => $val) {
488 if (!in_array($val, $profileTypes)) {
489 $valid = FALSE;
490 break;
491 }
492 }
493
494 if ($valid && is_array($optional)) {
495 foreach ($optional as $key => $val) {
496 if (in_array($val, $profileTypes)) {
497 $valid = TRUE;
498 break;
499 }
500 }
501 }
502
503 return $valid;
504 }
505
506 /**
507 * Check for mix profile fields (eg: individual + other contact types)
508 *
509 * @param int $ufGroupId
510 *
511 * @return true for mix profile else false
512 * @static
513 */
514 public static function checkProfileType($ufGroupId) {
515 $ufGroup = new CRM_Core_DAO_UFGroup();
516 $ufGroup->id = $ufGroupId;
517 $ufGroup->find(TRUE);
518
519 $profileTypes = array();
520 if ($ufGroup->group_type) {
521 $typeParts = explode(CRM_Core_DAO::VALUE_SEPARATOR, $ufGroup->group_type);
522 $profileTypes = explode(',', $typeParts[0]);
523 }
524
525 //early return if new profile.
526 if (empty($profileTypes)) {
527 return FALSE;
528 }
529
530 //we need to unset Contact
531 if (count($profileTypes) > 1) {
532 $index = array_search('Contact', $profileTypes);
533 if ($index !== FALSE) {
534 unset($profileTypes[$index]);
535 }
536 }
537
538 // suppress any subtypes if present
539 CRM_Contact_BAO_ContactType::suppressSubTypes($profileTypes);
540
541 $contactTypes = array('Contact', 'Individual', 'Household', 'Organization');
542 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
543 $fields = array();
544
545 // check for mix profile condition
546 if (count($profileTypes) > 1) {
547 //check the there are any components include in profile
548 foreach ($components as $value) {
549 if (in_array($value, $profileTypes)) {
550 return TRUE;
551 }
552 }
553 //check if there are more than one contact types included in profile
554 if (count($profileTypes) > 1) {
555 return TRUE;
556 }
557 }
558 elseif (count($profileTypes) == 1) {
559 // note for subtype case count would be zero
560 $profileTypes = array_values($profileTypes);
561 if (!in_array($profileTypes[0], $contactTypes)) {
562 return TRUE;
563 }
564 }
565
566 return FALSE;
567 }
568
569 /**
570 * Get the profile type (eg: individual/organization/household)
571 *
572 * @param int $ufGroupId
573 * Uf group id.
574 * @param bool $returnMixType
575 * This is true, then field type of mix profile field is returned.
576 * @param bool $onlyPure
577 * True if only pure profiles are required.
578 *
579 * @param bool $skipComponentType
580 *
581 * @return string
582 * profile group_type
583 * @static
584 *
585 * TODO Why is this function in this class? It seems to be about the UFGroup.
586 */
587 public static function getProfileType($ufGroupId, $returnMixType = TRUE, $onlyPure = FALSE, $skipComponentType = FALSE) {
588 $ufGroup = new CRM_Core_DAO_UFGroup();
589 $ufGroup->id = $ufGroupId;
590 $ufGroup->is_active = 1;
591
592 $ufGroup->find(TRUE);
593 return self::calculateProfileType($ufGroup->group_type, $returnMixType, $onlyPure, $skipComponentType);
594 }
595
596 /**
597 * Get the profile type (eg: individual/organization/household)
598 *
599 * @param string $ufGroupType
600 * @param bool $returnMixType
601 * This is true, then field type of mix profile field is returned.
602 * @param bool $onlyPure
603 * True if only pure profiles are required.
604 * @param bool $skipComponentType
605 *
606 * @return string
607 * profile group_type
608 * @static
609 *
610 * TODO Why is this function in this class? It seems to be about the UFGroup.
611 */
612 public static function calculateProfileType($ufGroupType, $returnMixType = TRUE, $onlyPure = FALSE, $skipComponentType = FALSE) {
613 // profile types
614 $contactTypes = array('Contact', 'Individual', 'Household', 'Organization');
615 $subTypes = CRM_Contact_BAO_ContactType::subTypes();
616 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
617
618 $profileTypes = array();
619 if ($ufGroupType) {
620 $typeParts = explode(CRM_Core_DAO::VALUE_SEPARATOR, $ufGroupType);
621 $profileTypes = explode(',', $typeParts[0]);
622 }
623
624 if ($onlyPure) {
625 if (count($profileTypes) == 1) {
626 return $profileTypes[0];
627 }
628 else {
629 return NULL;
630 }
631 }
632
633 //we need to unset Contact
634 if (count($profileTypes) > 1) {
635 $index = array_search('Contact', $profileTypes);
636 if ($index !== FALSE) {
637 unset($profileTypes[$index]);
638 }
639 }
640
641 $profileType = $mixProfileType = NULL;
642
643 // this case handles pure profile
644 if (count($profileTypes) == 1) {
645 $profileType = array_pop($profileTypes);
646 }
647 else {
648 //check the there are any components include in profile
649 $componentCount = array();
650 foreach ($components as $value) {
651 if (in_array($value, $profileTypes)) {
652 $componentCount[] = $value;
653 }
654 }
655
656 //check contact type included in profile
657 $contactTypeCount = array();
658 foreach ($contactTypes as $value) {
659 if (in_array($value, $profileTypes)) {
660 $contactTypeCount[] = $value;
661 }
662 }
663 // subtype counter
664 $subTypeCount = array();
665 foreach ($subTypes as $value) {
666 if (in_array($value, $profileTypes)) {
667 $subTypeCount[] = $value;
668 }
669 }
670 if (!$skipComponentType && count($componentCount) == 1) {
671 $profileType = $componentCount[0];
672 }
673 elseif (count($componentCount) > 1) {
674 $mixProfileType = $componentCount[1];
675 }
676 elseif (count($subTypeCount) == 1) {
677 $profileType = $subTypeCount[0];
678 }
679 elseif (count($contactTypeCount) == 1) {
680 $profileType = $contactTypeCount[0];
681 }
682 elseif (count($subTypeCount) > 1) {
683 // this is mix subtype profiles
684 $mixProfileType = $subTypeCount[1];
685 }
686 elseif (count($contactTypeCount) > 1) {
687 // this is mix contact profiles
688 $mixProfileType = $contactTypeCount[1];
689 }
690 }
691
692 if ($mixProfileType) {
693 if ($returnMixType) {
694 return $mixProfileType;
695 }
696 else {
697 return 'Mixed';
698 }
699 }
700 else {
701 return $profileType;
702 }
703 }
704
705 /**
706 * Check for mix profiles groups (eg: individual + other contact types)
707 *
708 * @param $ctype
709 *
710 * @return true for mix profile group else false
711 * @static
712 */
713 public static function checkProfileGroupType($ctype) {
714 $ufGroup = new CRM_Core_DAO_UFGroup();
715
716 $query = "
717 SELECT ufg.id as id
718 FROM civicrm_uf_group as ufg, civicrm_uf_join as ufj
719 WHERE ufg.id = ufj.uf_group_id
720 AND ufj.module = 'User Registration'
721 AND ufg.is_active = 1 ";
722
723 $ufGroup = CRM_Core_DAO::executeQuery($query);
724
725 $fields = array();
726 $validProfiles = array('Individual', 'Organization', 'Household', 'Contribution');
727 while ($ufGroup->fetch()) {
728 $profileType = self::getProfileType($ufGroup->id);
729 if (in_array($profileType, $validProfiles)) {
730 continue;
731 }
732 elseif ($profileType) {
733 return FALSE;
734 }
735 }
736
737 return TRUE;
738 }
739
740 /**
741 * Check for searchable or in selector field for given profile.
742 *
743 * @param int $profileID
744 *
745 * @return boolean
746 */
747 public static function checkSearchableORInSelector($profileID) {
748 $result = FALSE;
749 if (!$profileID) {
750 return $result;
751 }
752
753 $query = "
754 SELECT id
755 From civicrm_uf_field
756 WHERE (in_selector = 1 OR is_searchable = 1)
757 AND uf_group_id = {$profileID}";
758
759 $ufFields = CRM_Core_DAO::executeQuery($query);
760 while ($ufFields->fetch()) {
761 $result = TRUE;
762 break;
763 }
764
765 return $result;
766 }
767
768 /**
769 * Reset In selector and is searchable values for given $profileID.
770 *
771 * @param int $profileID
772 *
773 * @return void
774 */
775 public function resetInSelectorANDSearchable($profileID) {
776 if (!$profileID) {
777 return;
778 }
779 $query = "UPDATE civicrm_uf_field SET in_selector = 0, is_searchable = 0 WHERE uf_group_id = {$profileID}";
780 CRM_Core_DAO::executeQuery($query);
781 }
782
783 /**
784 * Add fields to $profileAddressFields as appropriate.
785 * profileAddressFields is assigned to the template to tell it
786 * what fields are in the profile address
787 * that potentially should be copied to the Billing fields
788 * we want to give precedence to
789 * 1) Billing &
790 * 2) then Primary designated as 'Primary
791 * 3) location_type is primary
792 * 4) if none of these apply then it just uses the first one
793 *
794 * as this will be used to
795 * transfer profile address data to billing fields
796 * http://issues.civicrm.org/jira/browse/CRM-5869
797 *
798 * @param string $key
799 * Field key - e.g. street_address-Primary, first_name.
800 * @param array $profileAddressFields
801 * Array of profile fields that relate to address fields.
802 * @param array $profileFilter
803 * Filter to apply to profile fields - expected usage is to only fill based on.
804 * the bottom profile per CRM-13726
805 *
806 * @return bool
807 * Can the address block be hidden safe in the knowledge all fields are elsewhere collected (see CRM-15118)
808 */
809 public static function assignAddressField($key, &$profileAddressFields, $profileFilter) {
810 $billing_id = CRM_Core_BAO_LocationType::getBilling();
811 list($prefixName, $index) = CRM_Utils_System::explode('-', $key, 2);
812
813 $profileFields = civicrm_api3('uf_field', 'get', array_merge($profileFilter,
814 array(
815 'is_active' => 1,
816 'return' => 'field_name, is_required',
817 'options' => array(
818 'limit' => 0,
819 ))
820 ));
821 //check for valid fields ( fields that are present in billing block )
822 $validBillingFields = array(
823 'first_name',
824 'middle_name',
825 'last_name',
826 'street_address',
827 'supplemental_address_1',
828 'city',
829 'state_province',
830 'postal_code',
831 'country',
832 );
833 $requiredBillingFields = array_diff($validBillingFields, array('middle_name', 'supplemental_address_1'));
834 $validProfileFields = array();
835 $requiredProfileFields = array();
836
837 foreach ($profileFields['values'] as $field) {
838 if (in_array($field['field_name'], $validBillingFields)) {
839 $validProfileFields[] = $field['field_name'];
840 }
841 if ($field['is_required']) {
842 $requiredProfileFields[] = $field['field_name'];
843 }
844 }
845
846 if (!in_array($prefixName, $validProfileFields)) {
847 return;
848 }
849
850 if (!empty($index) && (
851 // it's empty so we set it OR
852 !CRM_Utils_array::value($prefixName, $profileAddressFields)
853 //we are dealing with billing id (precedence)
854 || $index == $billing_id
855 // we are dealing with primary & billing not set
856 || ($index == 'Primary' && $profileAddressFields[$prefixName] != $billing_id)
857 || ($index == CRM_Core_BAO_LocationType::getDefault()->id
858 && $profileAddressFields[$prefixName] != $billing_id
859 && $profileAddressFields[$prefixName] != 'Primary'
860 )
861 )
862 ) {
863 $profileAddressFields[$prefixName] = $index;
864 }
865
866 $potentiallyMissingRequiredFields = array_diff($requiredBillingFields, $requiredProfileFields);
867 CRM_Core_Resources::singleton()->addSetting(array('billing' => array('billingProfileIsHideable' => empty($potentiallyMissingRequiredFields))));
868 }
869
870 /**
871 * Get a list of fields which can be added to profiles
872 *
873 * @param int $gid: UF group ID
874 * @param array $defaults: Form defaults
875 * @return array, multidimensional; e.g. $result['FieldGroup']['field_name']['label']
876 * @static
877 */
878 public static function getAvailableFields($gid = NULL, $defaults = array()) {
879 $fields = array(
880 'Contact' => array(),
881 'Individual' => CRM_Contact_BAO_Contact::importableFields('Individual', FALSE, FALSE, TRUE, TRUE, TRUE),
882 'Household' => CRM_Contact_BAO_Contact::importableFields('Household', FALSE, FALSE, TRUE, TRUE, TRUE),
883 'Organization' => CRM_Contact_BAO_Contact::importableFields('Organization', FALSE, FALSE, TRUE, TRUE, TRUE),
884 );
885
886 // include hook injected fields
887 $fields['Contact'] = array_merge($fields['Contact'], CRM_Contact_BAO_Query_Hook::singleton()->getFields());
888
889 // add current employer for individuals
890 $fields['Individual']['current_employer'] = array(
891 'name' => 'organization_name',
892 'title' => ts('Current Employer'),
893 );
894
895 $addressOptions = CRM_Core_BAO_Setting::valueOptions(CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME,
896 'address_options', TRUE, NULL, TRUE
897 );
898
899 if (!$addressOptions['county']) {
900 unset($fields['Individual']['county'], $fields['Household']['county'], $fields['Organization']['county']);
901 }
902
903 // break out common contact fields array CRM-3037.
904 // from a UI perspective this makes very little sense
905 foreach ($fields['Individual'] as $key => $value) {
906 if (!empty($fields['Household'][$key]) && !empty($fields['Organization'][$key])) {
907 $fields['Contact'][$key] = $value;
908 unset($fields['Individual'][$key], $fields['Household'][$key], $fields['Organization'][$key]);
909 }
910 }
911
912 // Internal field not exposed to forms
913 unset($fields['Contact']['contact_type']);
914 unset($fields['Contact']['master_id']);
915
916 // convert phone extension in to psedo-field phone + phone extension
917 //unset extension
918 unset($fields['Contact']['phone_ext']);
919 //add psedo field
920 $fields['Contact']['phone_and_ext'] = array(
921 'name' => 'phone_and_ext',
922 'title' => ts('Phone and Extension'),
923 'hasLocationType' => 1,
924 );
925
926 // include Subtypes For Profile
927 $subTypes = CRM_Contact_BAO_ContactType::subTypeInfo();
928 foreach ($subTypes as $name => $val) {
929 //custom fields for sub type
930 $subTypeFields = CRM_Core_BAO_CustomField::getFieldsForImport($name, FALSE, FALSE, FALSE, TRUE, TRUE);
931 if (array_key_exists($val['parent'], $fields)) {
932 $fields[$name] = $fields[$val['parent']] + $subTypeFields;
933 }
934 else {
935 $fields[$name] = $subTypeFields;
936 }
937 }
938
939 if (CRM_Core_Permission::access('CiviContribute')) {
940 $contribFields = CRM_Contribute_BAO_Contribution::getContributionFields(FALSE);
941 if (!empty($contribFields)) {
942 unset($contribFields['is_test']);
943 unset($contribFields['is_pay_later']);
944 unset($contribFields['contribution_id']);
945 $contribFields['contribution_note'] = array(
946 'name' => 'contribution_note',
947 'title' => ts('Contribution Note'),
948 );
949 $fields['Contribution'] = array_merge($contribFields, self::getContribBatchEntryFields());
950 }
951 }
952
953 if (CRM_Core_Permission::access('CiviEvent')) {
954 $participantFields = CRM_Event_BAO_Query::getParticipantFields();
955 if ($participantFields) {
956 // Remove fields not supported by profiles
957 CRM_Utils_Array::remove($participantFields,
958 'external_identifier',
959 'event_id',
960 'participant_contact_id',
961 'participant_role_id',
962 'participant_status_id',
963 'participant_is_test',
964 'participant_fee_level',
965 'participant_id',
966 'participant_is_pay_later',
967 'participant_campaign'
968 );
969 if (isset($participantFields['participant_campaign_id'])) {
970 $participantFields['participant_campaign_id']['title'] = ts('Campaign');
971 }
972 $fields['Participant'] = $participantFields;
973 }
974 }
975
976 if (CRM_Core_Permission::access('CiviMember')) {
977 $membershipFields = CRM_Member_BAO_Membership::getMembershipFields();
978 // Remove fields not supported by profiles
979 CRM_Utils_Array::remove($membershipFields,
980 'membership_id',
981 'membership_type_id',
982 'member_is_test',
983 'is_override',
984 'status_id',
985 'member_is_pay_later'
986 );
987 if ($gid && CRM_Core_DAO::getFieldValue('CRM_Core_DAO_UFGroup', $gid, 'name') == 'membership_batch_entry') {
988 $fields['Membership'] = array_merge($membershipFields, self::getMemberBatchEntryFields());
989 }
990 else {
991 $fields['Membership'] = $membershipFields;
992 }
993 }
994
995 if (CRM_Core_Permission::access('CiviCase')) {
996 $caseFields = CRM_Case_BAO_Query::getFields(TRUE);
997 $caseFields = array_merge($caseFields, CRM_Core_BAO_CustomField::getFieldsForImport('Case'));
998 if ($caseFields) {
999 // Remove fields not supported by profiles
1000 CRM_Utils_Array::remove($caseFields,
1001 'case_id',
1002 'case_type',
1003 'case_start_date',
1004 'case_end_date',
1005 'case_role',
1006 'case_status',
1007 'case_deleted'
1008 );
1009 }
1010 $fields['Case'] = $caseFields;
1011 }
1012
1013 $activityFields = CRM_Activity_BAO_Activity::getProfileFields();
1014 if ($activityFields) {
1015 // campaign related fields.
1016 if (isset($activityFields['activity_campaign_id'])) {
1017 $activityFields['activity_campaign_id']['title'] = ts('Campaign');
1018 }
1019 $fields['Activity'] = $activityFields;
1020 }
1021
1022 $fields['Formatting']['format_free_html_' . rand(1000, 9999)] = array(
1023 'name' => 'free_html',
1024 'import' => FALSE,
1025 'export' => FALSE,
1026 'title' => 'Free HTML',
1027 );
1028
1029 // Sort by title
1030 foreach ($fields as &$values) {
1031 $values = CRM_Utils_Array::crmArraySortByField($values, 'title');
1032 }
1033
1034 //group selected and unwanted fields list
1035 $ufFields = $gid ? CRM_Core_BAO_UFGroup::getFields($gid, FALSE, NULL, NULL, NULL, TRUE, NULL, TRUE) : array();
1036 $groupFieldList = array_merge($ufFields, array(
1037 'note',
1038 'email_greeting_custom',
1039 'postal_greeting_custom',
1040 'addressee_custom',
1041 'id',
1042 ));
1043 //unset selected fields
1044 foreach ($groupFieldList as $key => $value) {
1045 if (is_integer($key)) {
1046 unset($fields['Individual'][$value], $fields['Household'][$value], $fields['Organization'][$value]);
1047 continue;
1048 }
1049 if (!empty($defaults['field_name'])
1050 && $defaults['field_name']['0'] == $value['field_type']
1051 && $defaults['field_name']['1'] == $key
1052 ) {
1053 continue;
1054 }
1055 unset($fields[$value['field_type']][$key]);
1056 }
1057
1058 return $fields;
1059 }
1060
1061 /**
1062 * Get a list of fields which can be added to profiles
1063 *
1064 * @param bool $force
1065 *
1066 * @return array, multidimensional; e.g. $result['field_name']['label']
1067 * @static
1068 */
1069 public static function getAvailableFieldsFlat($force = FALSE) {
1070 // FIXME reset when data model changes
1071 static $result = NULL;
1072 if ($result === NULL || $force) {
1073 $fieldTree = self::getAvailableFields();
1074 $result = array();
1075 foreach ($fieldTree as $field_type => $fields) {
1076 foreach ($fields as $field_name => $field) {
1077 if (!isset($result[$field_name])) {
1078 $field['field_type'] = $field_type;
1079 $result[$field_name] = $field;
1080 }
1081 }
1082 }
1083 }
1084 return $result;
1085 }
1086
1087 /**
1088 * Determine whether the given field_name is valid
1089 *
1090 * @param string $fieldName
1091 * @return bool
1092 */
1093 public static function isValidFieldName($fieldName) {
1094 $availableFields = CRM_Core_BAO_UFField::getAvailableFieldsFlat();
1095 return isset($availableFields[$fieldName]);
1096 }
1097
1098 /**
1099 * @return array|null
1100 */
1101 public static function getContribBatchEntryFields() {
1102 if (self::$_contriBatchEntryFields === NULL) {
1103 self::$_contriBatchEntryFields = array(
1104 'send_receipt' => array(
1105 'name' => 'send_receipt',
1106 'title' => ts('Send Receipt'),
1107 ),
1108 'soft_credit' => array(
1109 'name' => 'soft_credit',
1110 'title' => ts('Soft Credit'),
1111 ),
1112 'soft_credit_type' => array(
1113 'name' => 'soft_credit_type',
1114 'title' => ts('Soft Credit Type'),
1115 ),
1116 'product_name' => array(
1117 'name' => 'product_name',
1118 'title' => ts('Premiums'),
1119 ),
1120 'contribution_note' => array(
1121 'name' => 'contribution_note',
1122 'title' => ts('Contribution Note'),
1123 ),
1124 );
1125 }
1126 return self::$_contriBatchEntryFields;
1127 }
1128
1129 /**
1130 * @return array|null
1131 */
1132 public static function getMemberBatchEntryFields() {
1133 if (self::$_memberBatchEntryFields === NULL) {
1134 self::$_memberBatchEntryFields = array(
1135 'send_receipt' => array(
1136 'name' => 'send_receipt',
1137 'title' => ts('Send Receipt'),
1138 ),
1139 'soft_credit' => array(
1140 'name' => 'soft_credit',
1141 'title' => ts('Soft Credit'),
1142 ),
1143 'product_name' => array(
1144 'name' => 'product_name',
1145 'title' => ts('Premiums'),
1146 ),
1147 'financial_type' => array(
1148 'name' => 'financial_type',
1149 'title' => ts('Financial Type'),
1150 ),
1151 'total_amount' => array(
1152 'name' => 'total_amount',
1153 'title' => ts('Total Amount'),
1154 ),
1155 'receive_date' => array(
1156 'name' => 'receive_date',
1157 'title' => ts('Receive Date'),
1158 ),
1159 'payment_instrument' => array(
1160 'name' => 'payment_instrument',
1161 'title' => ts('Payment Instrument'),
1162 ),
1163 'contribution_status_id' => array(
1164 'name' => 'contribution_status_id',
1165 'title' => ts('Contribution Status'),
1166 ),
1167 );
1168 }
1169 return self::$_memberBatchEntryFields;
1170 }
1171 }