3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
39 class CRM_Core_BAO_UFGroup
extends CRM_Core_DAO_UFGroup
{
40 CONST PUBLIC_VISIBILITY
= 1,
42 LISTINGS_VISIBILITY
= 4;
45 * cache the match clause used in this transaction
49 static $_matchFields = NULL;
52 * Takes a bunch of params that are needed to match certain criteria and
53 * retrieves the relevant objects. Typically the valid params are only
54 * contact_id. We'll tweak this function to be more full featured over a period
55 * of time. This is the inverse function of create. It also stores all the retrieved
56 * values in the default array
58 * @param array $params (reference) an assoc array of name/value pairs
59 * @param array $defaults (reference) an assoc array to hold the flattened values
61 * @return object CRM_Core_DAO_UFGroup object
65 static function retrieve(&$params, &$defaults) {
66 return CRM_Core_DAO
::commonRetrieve('CRM_Core_DAO_UFGroup', $params, $defaults);
70 * Retrieve the first non-generic contact type
72 * @param int $id id of uf_group
74 * @return string contact type
76 static function getContactType($id) {
78 $validTypes = array_filter(array_keys(CRM_Core_SelectValues
::contactType()));
79 $validSubTypes = CRM_Contact_BAO_ContactType
::subTypeInfo();
81 $typesParts = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $id, 'group_type'));
82 $types = explode(',', $typesParts[0]);
85 foreach ($types as $type) {
86 if (in_array($type, $validTypes)) {
89 elseif (array_key_exists($type, $validSubTypes)) {
90 $cType = CRM_Utils_Array
::value('parent', $validSubTypes[$type]);
100 * Get the form title.
102 * @param int $id id of uf_form
104 * @return string title
110 public static function getTitle($id) {
111 return CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $id, 'title');
115 * update the is_active flag in the db
117 * @param int $id id of the database record
118 * @param boolean $is_active value we want to set the is_active field
120 * @return Object CRM_Core_DAO_UFGroup object on success, null otherwise
124 static function setIsActive($id, $is_active) {
125 return CRM_Core_DAO
::setFieldValue('CRM_Core_DAO_UFGroup', $id, 'is_active', $is_active);
129 * get all the registration fields
131 * @param int $action what action are we doing
132 * @param int $mode mode
134 * @return array the fields that are needed for registration
138 static function getRegistrationFields($action, $mode, $ctype = NULL) {
139 if ($mode & CRM_Profile_Form
::MODE_REGISTER
) {
140 $ufGroups = CRM_Core_BAO_UFGroup
::getModuleUFGroup('User Registration');
143 $ufGroups = CRM_Core_BAO_UFGroup
::getModuleUFGroup('Profile');
146 if (!is_array($ufGroups)) {
152 foreach ($ufGroups as $id => $title) {
154 $fieldType = CRM_Core_BAO_UFField
::getProfileType($id);
155 if (($fieldType != 'Contact') &&
156 ($fieldType != $ctype) &&
157 !CRM_Contact_BAO_ContactType
::isExtendsContactType($fieldType, $ctype)
161 if (CRM_Contact_BAO_ContactType
::isaSubType($fieldType)) {
162 $profileSubType = $fieldType;
166 $subset = self
::getFields($id, TRUE, $action,
167 NULL, NULL, FALSE, NULL, TRUE, $ctype
170 // we do not allow duplicates. the first field is the winner
171 foreach ($subset as $name => $field) {
172 if (!CRM_Utils_Array
::value($name, $fields)) {
173 $fields[$name] = $field;
182 * get all the listing fields
184 * @param int $action what action are we doing
185 * @param int $visibility visibility of fields we are interested in
186 * @param bool $considerSelector whether to consider the in_selector parameter
187 * @param array $ufGroupIds
188 * @param boolean $searchable
190 * @return array the fields that are listings related
194 static function getListingFields(
197 $considerSelector = FALSE,
201 $skipPermission = FALSE,
202 $permissionType = CRM_Core_Permission
::SEARCH
205 $subset = self
::getFields($ufGroupIds, FALSE, $action,
206 $visibility, $searchable,
212 if ($considerSelector) {
213 // drop the fields not meant for the selector
214 foreach ($subset as $name => $field) {
215 if (!$field['in_selector']) {
216 unset($subset[$name]);
223 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
226 foreach ($ufGroups as $id => $title) {
227 $subset = self
::getFields($id, FALSE, $action,
228 $visibility, $searchable,
234 if ($considerSelector) {
235 // drop the fields not meant for the selector
236 foreach ($subset as $name => $field) {
237 if (!$field['in_selector'])unset($subset[$name]);
240 $fields = array_merge($fields, $subset);
247 * Get all the fields that belong to the group with the name title,
248 * and format for use with buildProfile. This is the SQL analog of
251 * @param mix $id the id of the UF group or ids of ufgroup
252 * @param int $register are we interested in registration fields
253 * @param int $action what action are we doing
254 * @param int $visibility visibility of fields we are interested in
256 * @param boolean $showall
257 * @param string $restrict should we restrict based on a specified profile type
259 * @return array the fields that belong to this ufgroup(s)
263 static function getFields(
271 $skipPermission = FALSE,
273 $permissionType = CRM_Core_Permission
::CREATE
,
274 $orderBy = 'field_name',
275 $orderProfiles = NULL
277 if (!is_array($id)) {
278 $id = CRM_Utils_Type
::escape($id, 'Positive');
279 $profileIds = array($id);
285 $gids = implode(',', $profileIds);
288 $query = "SELECT g.* from civicrm_uf_group g, civicrm_uf_join j
289 WHERE g.id IN ( {$gids} )
290 AND j.uf_group_id IN ( {$gids} )
293 $params = array(1 => array($restrict, 'String'));
296 $query = "SELECT g.* from civicrm_uf_group g WHERE g.id IN ( {$gids} ) ";
300 $query .= " AND g.is_active = 1";
303 // add permissioning for profiles only if not registration
304 if (!$skipPermission) {
305 $permissionClause = CRM_Core_Permission
::ufGroupClause($permissionType, 'g.');
306 $query .= " AND $permissionClause ";
309 if ($orderProfiles AND count($profileIds) > 1) {
310 $query .= " ORDER BY FIELD( g.id, {$gids} )";
312 $group = CRM_Core_DAO
::executeQuery($query, $params);
316 while ($group->fetch()) {
318 $query = self
::createUFFieldQuery($group->id
, $searchable, $showAll, $visibility, $orderBy);
319 $field = CRM_Core_DAO
::executeQuery($query);
321 $profileType = CRM_Core_BAO_UFField
::getProfileType($group->id
);
322 $contactActivityProfile = CRM_Core_BAO_UFField
::checkContactActivityProfileType($group->id
);
323 $importableFields = self
::getImportableFields($showAll, $profileType, $contactActivityProfile);
324 list($customFields, $addressCustomFields) = self
::getCustomFields($ctype);
326 while ($field->fetch()) {
327 list($name, $formattedField) = self
::formatUFField($group, $field, $customFields, $addressCustomFields, $importableFields, $permissionType);
328 if ($formattedField !== NULL) {
329 $fields[$name] = $formattedField;
335 if (empty($fields) && !$validGroup) {
336 CRM_Core_Error
::fatal(ts('The requested Profile (gid=%1) is disabled OR it is not configured to be used for \'Profile\' listings in its Settings OR there is no Profile with that ID OR you do not have permission to access this profile. Please contact the site administrator if you need assistance.',
337 array(1 => implode(',', $profileIds))
341 self
::reformatProfileFields($fields);
348 * Format a list of UFFields for use with buildProfile. This is the in-memory analog
351 * @param array $groupArr (mimic CRM_UF_DAO_UFGroup)
352 * @param array $fieldArrs list of fields (each mimics CRM_UF_DAO_UFField)
353 * @param bool $visibility visibility of fields we are interested in
354 * @param bool $searchable
355 * @param bool $showall
359 public static function formatUFFields(
366 $permissionType = CRM_Core_Permission
::CREATE
368 // $group = new CRM_Core_DAO_UFGroup();
369 // $group->copyValues($groupArr); // no... converts string('') to string('null')
370 $group = (object) $groupArr;
372 // Refactoring note: The $fieldArrs here may be slightly different than the $ufFields
373 // used by calculateGroupType, but I don't think the missing fields matter, and -- if
374 // they did -- the obvious fix would produce mutual recursion.
375 $ufGroupType = self
::_calculateGroupType($fieldArrs);
376 $profileType = CRM_Core_BAO_UFField
::calculateProfileType(implode(',',$ufGroupType));
377 $contactActivityProfile = CRM_Core_BAO_UFField
::checkContactActivityProfileTypeByGroupType(implode(',',$ufGroupType));
378 $importableFields = self
::getImportableFields($showAll, $profileType, $contactActivityProfile);
379 list($customFields, $addressCustomFields) = self
::getCustomFields($ctype);
381 $formattedFields = array();
382 foreach ($fieldArrs as $fieldArr) {
383 $field = (object) $fieldArr;
384 if (!self
::filterUFField($field, $searchable, $showAll, $visibility)) {
388 list($name, $formattedField) = self
::formatUFField($group, $field, $customFields, $addressCustomFields, $importableFields, $permissionType);
389 if ($formattedField !== NULL) {
390 $formattedFields[$name] = $formattedField;
393 return $formattedFields;
397 * Prepare a field for rendering with CRM_Core_BAO_UFGroup::buildProfile.
399 * @param CRM_Core_DAO_UFGroup|CRM_Core_DAO $group
400 * @param CRM_Core_DAO_UFField|CRM_Core_DAO $field
401 * @param array $addressCustomFields
402 * @param array $importableFields
403 * @param array $customFields
404 * @param int $permissionType eg CRM_Core_Permission::CREATE
407 protected static function formatUFField(
411 $addressCustomFields,
413 $permissionType = CRM_Core_Permission
::CREATE
415 $name = $field->field_name
;
416 $title = $field->label
;
418 $addressCustom = FALSE;
419 if (in_array($permissionType, array(
420 CRM_Core_Permission
::CREATE
,
421 CRM_Core_Permission
::EDIT
,
423 in_array($field->field_name
, array_keys($addressCustomFields))
425 $addressCustom = TRUE;
426 $name = "address_{$name}";
429 if (!empty($field->location_type_id
)) {
430 $name .= "-{$field->location_type_id}";
433 $locationFields = self
::getLocationFields();
434 if (in_array($field->field_name
, $locationFields) ||
$addressCustom) {
439 if (isset($field->phone_type_id
)) {
440 $name .= "-{$field->phone_type_id}";
443 // No lie: this is bizarre; why do we need to mix so many UFGroup properties into UFFields?
444 // I guess to make field self sufficient with all the required data and avoid additional calls
445 $formattedField = array(
447 'groupTitle' => $group->title
,
448 'groupName' => $group->name
,
449 'groupHelpPre' => empty($group->help_pre
) ?
'' : $group->help_pre
,
450 'groupHelpPost' => empty($group->help_post
) ?
'' : $group->help_post
,
452 'where' => CRM_Utils_Array
::value('where', CRM_Utils_Array
::value($field->field_name
, $importableFields)),
453 'attributes' => CRM_Core_DAO
::makeAttribute(CRM_Utils_Array
::value($field->field_name
, $importableFields)),
454 'is_required' => $field->is_required
,
455 'is_view' => $field->is_view
,
456 'help_pre' => $field->help_pre
,
457 'help_post' => $field->help_post
,
458 'visibility' => $field->visibility
,
459 'in_selector' => $field->in_selector
,
460 'rule' => CRM_Utils_Array
::value('rule', CRM_Utils_Array
::value($field->field_name
, $importableFields)),
461 'location_type_id' => isset($field->location_type_id
) ?
$field->location_type_id
: NULL,
462 'phone_type_id' => isset($field->phone_type_id
) ?
$field->phone_type_id
: NULL,
463 'group_id' => $group->id
,
464 'add_to_group_id' => isset($group->add_to_group_id
) ?
$group->add_to_group_id
: NULL,
465 'add_captcha' => isset($group->add_captcha
) ?
$group->add_captcha
: NULL,
466 'field_type' => $field->field_type
,
467 'field_id' => $field->id
,
468 'pseudoconstant' => CRM_Utils_Array
::value(
470 CRM_Utils_Array
::value($field->field_name
, $importableFields)
472 // obsolete this when we remove the name / dbName discrepancy with gender/suffix/prefix
473 'dbName' => CRM_Utils_Array
::value(
475 CRM_Utils_Array
::value($field->field_name
, $importableFields)
480 //adding custom field property
481 if (substr($field->field_name
, 0, 6) == 'custom' ||
482 substr($field->field_name
, 0, 14) === 'address_custom'
484 // if field is not present in customFields, that means the user
485 // DOES NOT HAVE permission to access that field
486 if (array_key_exists($field->field_name
, $customFields)) {
487 $formattedField['is_search_range'] = $customFields[$field->field_name
]['is_search_range'];
489 $formattedField['options_per_line'] = $customFields[$field->field_name
]['options_per_line'];
490 $formattedField['data_type'] = $customFields[$field->field_name
]['data_type'];
491 $formattedField['html_type'] = $customFields[$field->field_name
]['html_type'];
493 if (CRM_Utils_Array
::value('html_type', $formattedField) == 'Select Date') {
494 $formattedField['date_format'] = $customFields[$field->field_name
]['date_format'];
495 $formattedField['time_format'] = $customFields[$field->field_name
]['time_format'];
498 $formattedField['is_multi_summary'] = $field->is_multi_summary
;
499 return array($name, $formattedField);
502 $formattedField = NULL;
503 return array($name, $formattedField);
506 return array($name, $formattedField);
510 * Create a query to find all visible UFFields in a UFGroup
512 * This is the SQL-variant of checkUFFieldDisplayable().
514 * @param int $groupId
515 * @param bool $searchable
516 * @param bool $showAll
517 * @param int $visibility
518 * @param string $orderBy comma-delimited list of SQL columns
521 protected static function createUFFieldQuery($groupId, $searchable, $showAll, $visibility, $orderBy) {
522 $where = " WHERE uf_group_id = {$groupId}";
525 $where .= " AND is_searchable = 1";
529 $where .= " AND is_active = 1";
534 if ($visibility & self
::PUBLIC_VISIBILITY
) {
535 $clause[] = 'visibility = "Public Pages"';
537 if ($visibility & self
::ADMIN_VISIBILITY
) {
538 $clause[] = 'visibility = "User and User Admin Only"';
540 if ($visibility & self
::LISTINGS_VISIBILITY
) {
541 $clause[] = 'visibility = "Public Pages and Listings"';
543 if (!empty($clause)) {
544 $where .= ' AND ( ' . implode(' OR ', $clause) . ' ) ';
548 $query = "SELECT * FROM civicrm_uf_field $where ORDER BY weight";
550 $query .= ", " . $orderBy;
557 * Create a query to find all visible UFFields in a UFGroup
559 * This is the PHP in-memory variant of createUFFieldQuery().
561 * @param CRM_Core_DAO_UFField|CRM_Core_DAO $field
562 * @param bool $searchable
563 * @param bool $showAll
564 * @param int $visibility
565 * @return bool TRUE if field is displayable
567 protected static function filterUFField($field, $searchable, $showAll, $visibility) {
568 if ($searchable && $field->is_searchable
!= 1) {
572 if (!$showAll && $field->is_active
!= 1) {
577 $allowedVisibilities = array();
578 if ($visibility & self
::PUBLIC_VISIBILITY
) {
579 $allowedVisibilities[] = 'Public Pages';
581 if ($visibility & self
::ADMIN_VISIBILITY
) {
582 $allowedVisibilities[] = 'User and User Admin Only';
584 if ($visibility & self
::LISTINGS_VISIBILITY
) {
585 $allowedVisibilities[] = 'Public Pages and Listings';
587 // !empty($allowedVisibilities) seems silly to me, but it is equivalent to the pre-existing SQL
588 if (!empty($allowedVisibilities) && !in_array($field->visibility
, $allowedVisibilities)) {
596 protected static function getImportableFields($showAll, $profileType, $contactActivityProfile) {
598 $importableFields = CRM_Contact_BAO_Contact
::importableFields('All', FALSE, FALSE, FALSE, TRUE, TRUE);
601 $importableFields = CRM_Contact_BAO_Contact
::importableFields('All', FALSE, TRUE, FALSE, TRUE, TRUE);
604 if ($profileType == 'Activity' ||
$contactActivityProfile) {
605 $componentFields = CRM_Activity_BAO_Activity
::getProfileFields();
608 $componentFields = CRM_Core_Component
::getQueryFields();
611 $importableFields = array_merge($importableFields, $componentFields);
613 $importableFields['group']['title'] = ts('Group(s)');
614 $importableFields['group']['where'] = NULL;
615 $importableFields['tag']['title'] = ts('Tag(s)');
616 $importableFields['tag']['where'] = NULL;
617 return $importableFields;
620 public static function getLocationFields() {
621 static $locationFields = array(
623 'supplemental_address_1',
624 'supplemental_address_2',
627 'postal_code_suffix',
640 return $locationFields;
643 protected static function getCustomFields($ctype) {
644 static $customFieldCache = array();
645 if (!isset($customFieldCache[$ctype])) {
646 $customFields = CRM_Core_BAO_CustomField
::getFieldsForImport($ctype, FALSE, FALSE, FALSE, TRUE, TRUE);
648 // hack to add custom data for components
649 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
650 foreach ($components as $value) {
651 $customFields = array_merge($customFields, CRM_Core_BAO_CustomField
::getFieldsForImport($value));
653 $addressCustomFields = CRM_Core_BAO_CustomField
::getFieldsForImport('Address');
654 $customFields = array_merge($customFields, $addressCustomFields);
655 $customFieldCache[$ctype] = array($customFields, $addressCustomFields);
657 return $customFieldCache[$ctype];
661 * check the data validity
663 * @param int $userID the user id that we are actually editing
664 * @param string $title the title of the group we are interested in
665 * @pram boolean $register is this the registrtion form
666 * @param int $action the action of the form
668 * @return boolean true if form is valid
672 static function isValid($userID, $title, $register = FALSE, $action = NULL) {
674 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
675 ts('Dynamic Form Creator'),
678 $controller->set('id', $userID);
679 $controller->set('register', 1);
680 $controller->process();
681 return $controller->validate();
684 // make sure we have a valid group
685 $group = new CRM_Core_DAO_UFGroup();
687 $group->title
= $title;
689 if ($group->find(TRUE) && $userID) {
690 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic', ts('Dynamic Form Creator'), $action);
691 $controller->set('gid', $group->id
);
692 $controller->set('id', $userID);
693 $controller->set('register', 0);
694 $controller->process();
695 return $controller->validate();
702 * get the html for the form that represents this particular group
704 * @param int $userID the user id that we are actually editing
705 * @param string $title the title of the group we are interested in
706 * @param int $action the action of the form
707 * @param boolean $register is this the registration form
708 * @param boolean $reset should we reset the form?
709 * @param int $profileID do we have the profile ID?
711 * @return string the html for the form on success, otherwise empty string
715 static function getEditHTML($userID,
721 $doNotProcess = FALSE,
726 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
727 ts('Dynamic Form Creator'),
730 if ($reset ||
$doNotProcess) {
731 // hack to make sure we do not process this form
732 $oldQFDefault = CRM_Utils_Array
::value('_qf_default',
735 unset($_POST['_qf_default']);
736 unset($_REQUEST['_qf_default']);
738 $controller->reset();
742 $controller->set('id', $userID);
743 $controller->set('register', 1);
744 $controller->set('skipPermission', 1);
745 $controller->set('ctype', $ctype);
746 $controller->process();
747 if ($doNotProcess ||
!empty($_POST)) {
748 $controller->validate();
750 $controller->setEmbedded(TRUE);
752 //CRM-5839 - though we want to process form, get the control back.
753 $controller->setSkipRedirection(($doNotProcess) ?
FALSE : TRUE);
757 // we are done processing so restore the POST/REQUEST vars
758 if (($reset ||
$doNotProcess) && $oldQFDefault) {
759 $_POST['_qf_default'] = $_REQUEST['_qf_default'] = $oldQFDefault;
762 $template = CRM_Core_Smarty
::singleton();
764 // Hide CRM error messages if they are displayed using drupal form_set_error.
765 if (!empty($_POST)) {
766 $template->assign('suppressForm', TRUE);
769 return trim($template->fetch('CRM/Profile/Form/Dynamic.tpl'));
773 // make sure we have a valid group
774 $group = new CRM_Core_DAO_UFGroup();
776 $group->title
= $title;
778 if ($group->find(TRUE)) {
779 $profileID = $group->id
;
784 // make sure profileID and ctype match if ctype exists
786 $profileType = CRM_Core_BAO_UFField
::getProfileType($profileID);
787 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
788 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
791 if (($profileType != 'Contact') && ($profileType != $ctype)) {
796 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
797 ts('Dynamic Form Creator'),
801 $controller->reset();
803 $controller->set('gid', $profileID);
804 $controller->set('id', $userID);
805 $controller->set('register', 0);
806 $controller->set('skipPermission', 1);
808 $controller->set('ctype', $ctype);
810 $controller->process();
811 $controller->setEmbedded(TRUE);
813 //CRM-5846 - give the control back to drupal.
814 $controller->setSkipRedirection(($doNotProcess) ?
FALSE : TRUE);
817 $template = CRM_Core_Smarty
::singleton();
819 // Hide CRM error messages if they are displayed using drupal form_set_error.
820 if (!empty($_POST) && CRM_Core_Config
::singleton()->userFramework
== 'Drupal') {
821 if (arg(0) == 'user' ||
(arg(0) == 'admin' && arg(1) == 'people')) {
822 $template->assign('suppressForm', TRUE);
826 $templateFile = "CRM/Profile/Form/{$profileID}/Dynamic.tpl";
827 if (!$template->template_exists($templateFile)) {
828 $templateFile = 'CRM/Profile/Form/Dynamic.tpl';
830 return trim($template->fetch($templateFile));
833 $userEmail = CRM_Contact_BAO_Contact_Location
::getEmailDetails($userID);
835 // if post not empty then only proceed
836 if (!empty($_POST)) {
838 $config = CRM_Core_Config
::singleton();
839 $email = CRM_Utils_Array
::value('mail', $_POST);
841 if (CRM_Utils_Rule
::email($email) && ($email != $userEmail[1])) {
842 CRM_Core_BAO_UFMatch
::updateContactEmail($userID, $email);
851 * searches for a contact in the db with similar attributes
853 * @param array $params the list of values to be used in the where clause
854 * @param int $id the current contact id (hence excluded from matching)
855 * @param boolean $flatten should we flatten the input params
857 * @return contact_id if found, null otherwise
861 public static function findContact(&$params, $id = NULL, $contactType = 'Individual') {
862 $dedupeParams = CRM_Dedupe_Finder
::formatParams($params, $contactType);
863 $dedupeParams['check_permission'] = CRM_Utils_Array
::value('check_permission', $params, TRUE);
864 $ids = CRM_Dedupe_Finder
::dupesByParams($dedupeParams, $contactType, 'Supervised', array($id));
866 return implode(',', $ids);
874 * Given a contact id and a field set, return the values from the db
877 * @param int $id the contact id
878 * @param array $fields the profile fields of interest
879 * @param array $values the values for the above fields
880 * @param boolean $searchable searchable or not
881 * @param array $componentWhere component condition
882 * @param boolean $absolute return urls in absolute form (useful when sending an email)
888 public static function getValues($cid, &$fields, &$values,
889 $searchable = TRUE, $componentWhere = NULL,
890 $absolute = FALSE, $additionalWhereClause = NULL
892 if (empty($cid) && empty($componentWhere)) {
896 // get the contact details (hier)
897 $returnProperties = CRM_Contact_BAO_Contact
::makeHierReturnProperties($fields);
898 $params = $cid ?
array(array('contact_id', '=', $cid, 0, 0)) : array();
900 // add conditions specified by components. eg partcipant_id etc
901 if (!empty($componentWhere)) {
902 $params = array_merge($params, $componentWhere);
905 $query = new CRM_Contact_BAO_Query($params, $returnProperties, $fields);
906 $options = &$query->_options
;
908 $details = $query->searchQuery( 0, 0, NULL, FALSE, FALSE,
909 FALSE, FALSE, FALSE, $additionalWhereClause);
910 if (!$details->fetch()) {
913 $query->convertToPseudoNames($details);
914 $config = CRM_Core_Config
::singleton();
916 $locationTypes = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Address', 'location_type_id');
917 $imProviders = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id');
918 $websiteTypes = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Website', 'website_type_id');
920 $multipleFields = array('url');
921 $nullIndex = $nullValueIndex = ' ';
923 //start of code to set the default values
924 foreach ($fields as $name => $field) {
927 $name = 'contact_id';
930 // skip fields that should not be displayed separately
931 if (CRM_Utils_Array
::value('skipDisplay', $field)) {
935 $index = $field['title'];
936 //handle for the label not set for the field
937 if (empty($field['title'])) {
939 $nullIndex .= $nullIndex;
942 //handle the case to avoid re-write where the profile field labels are the same
943 if (CRM_Utils_Array
::value($index, $values)) {
944 $index .= $nullValueIndex;
945 $nullValueIndex .= $nullValueIndex;
947 $params[$index] = $values[$index] = '';
948 $customFieldName = NULL;
950 if (isset($details->$name) ||
$name == 'group' ||
$name == 'tag') {
951 // to handle gender / suffix / prefix
952 if (in_array(substr($name, 0, -3), array('gender', 'prefix', 'suffix'))) {
953 $values[$index] = CRM_Core_PseudoConstant
::getLabel('CRM_Contact_DAO_Contact', $name, $details->$name);
954 $params[$index] = $details->$name;
956 elseif (in_array($name, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
957 $dname = $name . '_display';
958 $values[$index] = $details->$dname;
959 $name = $name . '_id';
960 $params[$index] = $details->$name;
962 elseif (in_array($name, array(
963 'state_province', 'country', 'county'))) {
964 $values[$index] = $details->$name;
965 $idx = $name . '_id';
966 $params[$index] = $details->$idx;
968 elseif ($name === 'preferred_communication_method') {
969 $communicationFields = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'preferred_communication_method');
971 $pref = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details->$name);
973 foreach ($pref as $k) {
975 $compref[] = $communicationFields[$k];
978 $params[$index] = $details->$name;
979 $values[$index] = implode(',', $compref);
981 elseif ($name === 'preferred_language') {
982 $params[$index] = $details->$name;
983 $values[$index] = CRM_Core_PseudoConstant
::getLabel('CRM_Contact_DAO_Contact', 'preferred_language', $details->$name);
985 elseif ($name == 'group') {
986 $groups = CRM_Contact_BAO_GroupContact
::getContactGroup($cid, 'Added', NULL, FALSE, TRUE);
987 $title = $ids = array();
989 foreach ($groups as $g) {
990 // CRM-8362: User and User Admin visibility groups should be included in display if user has
991 // VIEW permission on that group
992 $groupPerm = CRM_Contact_BAO_Group
::checkPermission($g['group_id'], $g['title']);
994 if ($g['visibility'] != 'User and User Admin Only' ||
995 CRM_Utils_Array
::key(CRM_Core_Permission
::VIEW
, $groupPerm)
997 $title[] = $g['title'];
998 if ($g['visibility'] == 'Public Pages') {
999 $ids[] = $g['group_id'];
1003 $values[$index] = implode(', ', $title);
1004 $params[$index] = implode(',', $ids);
1006 elseif ($name == 'tag') {
1007 $entityTags = CRM_Core_BAO_EntityTag
::getTag($cid);
1008 $allTags = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_EntityTag', 'tag_id', array('onlyActive' => FALSE));
1010 foreach ($entityTags as $tagId) {
1011 $title[] = $allTags[$tagId];
1013 $values[$index] = implode(', ', $title);
1014 $params[$index] = implode(',', $entityTags);
1016 elseif ($name == 'activity_status_id') {
1017 $activityStatus = CRM_Core_PseudoConstant
::activityStatus();
1018 $values[$index] = $activityStatus[$details->$name];
1019 $params[$index] = $details->$name;
1021 elseif ($name == 'activity_date_time') {
1022 $values[$index] = CRM_Utils_Date
::customFormat($details->$name);
1023 $params[$index] = $details->$name;
1025 elseif ($name == 'contact_sub_type') {
1026 $contactSubTypeNames = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details->$name);
1027 if (!empty($contactSubTypeNames)) {
1028 $contactSubTypeLabels = array();
1029 // get all contact subtypes
1030 $allContactSubTypes = CRM_Contact_BAO_ContactType
::subTypeInfo();
1031 // build contact subtype labels array
1032 foreach( $contactSubTypeNames as $cstName ) {
1034 $contactSubTypeLabels[] = $allContactSubTypes[$cstName]['label'];
1037 $values[$index] = implode(',', $contactSubTypeLabels);
1040 $params[$index] = $details->$name;
1043 if (substr($name, 0, 7) === 'do_not_' ||
substr($name, 0, 3) === 'is_') {
1044 if ($details->$name) {
1045 $values[$index] = '[ x ]';
1049 if ($cfID = CRM_Core_BAO_CustomField
::getKeyID($name)) {
1050 $htmlType = $field['html_type'];
1052 // field_type is only set when we are retrieving profile values
1053 // when sending email, we call the same function to get custom field
1054 // values etc, i.e. emulating a profile
1055 $fieldType = CRM_Utils_Array
::value('field_type', $field);
1057 if ($htmlType == 'File') {
1060 $fieldType == 'Activity' &&
1061 CRM_Utils_Array
::value(2, $componentWhere[0])
1063 $entityId = $componentWhere[0][2];
1066 $fileURL = CRM_Core_BAO_CustomField
::getFileURL($entityId,
1071 $params[$index] = $values[$index] = $fileURL['file_url'];
1075 if (isset($dao) && property_exists($dao, 'data_type') &&
1076 ($dao->data_type
== 'Int' ||
1077 $dao->data_type
== 'Boolean'
1080 $customVal = (int )($details->{$name});
1082 elseif (isset($dao) && property_exists($dao, 'data_type')
1083 && $dao->data_type
== 'Float'
1085 $customVal = (float )($details->{$name});
1087 elseif (!CRM_Utils_System
::isNull(explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
1090 $customVal = $details->{$name};
1094 if (CRM_Utils_System
::isNull($customVal)) {
1098 $params[$index] = $customVal;
1099 $values[$index] = CRM_Core_BAO_CustomField
::getDisplayValue($customVal,
1103 if ($htmlType == 'Autocomplete-Select') {
1104 $params[$index] = $values[$index];
1106 if (CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_CustomField',
1107 $cfID, 'is_search_range'
1109 $customFieldName = "{$name}_from";
1113 elseif ($name == 'image_URL') {
1114 list($width, $height) = getimagesize($details->$name);
1115 list($thumbWidth, $thumbHeight) = CRM_Contact_BAO_Contact
::getThumbSize($width, $height);
1117 $image_URL = '<img src="' . $details->$name . '" height= ' . $thumbHeight . ' width= ' . $thumbWidth . ' />';
1118 $values[$index] = "<a href='#' onclick='contactImagePopUp(\"{$details->$name}\", {$width}, {$height});'>{$image_URL}</a>";
1120 elseif (in_array($name, array(
1121 'birth_date', 'deceased_date', 'membership_start_date', 'membership_end_date', 'join_date'))) {
1122 $values[$index] = CRM_Utils_Date
::customFormat($details->$name);
1123 $params[$index] = CRM_Utils_Date
::isoToMysql($details->$name);
1127 if ($index == 'Campaign') {
1128 $dao = 'CRM_Campaign_DAO_Campaign';
1130 elseif ($index == 'Contribution Page') {
1131 $dao = 'CRM_Contribute_DAO_ContributionPage';
1134 $value = CRM_Core_DAO
::getFieldValue($dao, $details->$name, 'title');
1137 $value = $details->$name;
1139 $values[$index] = $value;
1144 elseif (strpos($name, '-') !== FALSE) {
1145 list($fieldName, $id, $type) = CRM_Utils_System
::explode('-', $name, 3);
1147 if (!in_array($fieldName, $multipleFields)) {
1148 if ($id == 'Primary') {
1150 // not sure why we'd every use Primary location type id
1151 // we need to fix the source if we are using it
1152 // $locationTypeName = CRM_Contact_BAO_Contact::getPrimaryLocationType( $cid );
1153 $locationTypeName = 1;
1156 $locationTypeName = CRM_Utils_Array
::value($id, $locationTypes);
1159 if (!$locationTypeName) {
1163 $detailName = "{$locationTypeName}-{$fieldName}";
1164 $detailName = str_replace(' ', '_', $detailName);
1166 if (in_array($fieldName, array(
1167 'phone', 'im', 'email', 'openid'))) {
1169 $detailName .= "-{$type}";
1173 if (in_array($fieldName, array(
1174 'state_province', 'country', 'county'))) {
1175 $values[$index] = $details->$detailName;
1176 $idx = $detailName . '_id';
1177 $params[$index] = $details->$idx;
1179 elseif ($fieldName == 'im') {
1180 $providerId = $detailName . '-provider_id';
1181 if (isset($imProviders[$details->$providerId])) {
1182 $values[$index] = $details->$detailName . " (" . $imProviders[$details->$providerId] . ")";
1185 $values[$index] = $details->$detailName;
1187 $params[$index] = $details->$detailName;
1189 elseif ($fieldName == 'phone') {
1190 $phoneExtField = str_replace('phone', 'phone_ext', $detailName);
1191 if (isset($details->$phoneExtField)) {
1192 $values[$index] = $details->$detailName . " (" . $details->$phoneExtField . ")";
1195 $values[$index] = $details->$detailName;
1197 $params[$index] = $details->$detailName;
1200 $values[$index] = $params[$index] = $details->$detailName;
1204 $detailName = "website-{$id}-{$fieldName}";
1205 $url = CRM_Utils_System
::fixURL($details->$detailName);
1206 if ($details->$detailName) {
1207 $websiteTypeId = "website-{$id}-website_type_id";
1208 $websiteType = $websiteTypes[$details->$websiteTypeId];
1209 $values[$index] = "<a href=\"$url\">{$details->$detailName} ( {$websiteType} )</a>";
1212 $values[$index] = '';
1217 if ((CRM_Utils_Array
::value('visibility', $field) == 'Public Pages and Listings') &&
1218 CRM_Core_Permission
::check('profile listings and forms')
1221 if (CRM_Utils_System
::isNull($params[$index])) {
1222 $params[$index] = $values[$index];
1224 if (!isset($params[$index])) {
1227 if (!$customFieldName) {
1228 $fieldName = $field['name'];
1231 $fieldName = $customFieldName;
1235 if (CRM_Core_BAO_CustomField
::getKeyID($field['name'])) {
1236 $htmlType = $field['html_type'];
1237 if ($htmlType == 'Link') {
1238 $url = $params[$index];
1240 elseif (in_array($htmlType, array(
1241 'CheckBox', 'Multi-Select', 'AdvMulti-Select',
1242 'Multi-Select State/Province', 'Multi-Select Country',
1244 $valSeperator = CRM_Core_DAO
::VALUE_SEPARATOR
;
1245 $selectedOptions = explode($valSeperator, $params[$index]);
1247 foreach ($selectedOptions as $key => $multiOption) {
1249 $url[] = CRM_Utils_System
::url('civicrm/profile',
1250 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1251 urlencode($fieldName) .
1253 urlencode($multiOption)
1259 $url = CRM_Utils_System
::url('civicrm/profile',
1260 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1261 urlencode($fieldName) .
1263 urlencode($params[$index])
1268 $url = CRM_Utils_System
::url('civicrm/profile',
1269 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1270 urlencode($fieldName) .
1272 urlencode($params[$index])
1277 !empty($values[$index]) &&
1281 if (is_array($url) && !empty($url)) {
1283 $eachMultiValue = explode(', ', $values[$index]);
1284 foreach ($eachMultiValue as $key => $valueLabel) {
1285 $links[] = '<a href="' . $url[$key] . '">' . $valueLabel . '</a>';
1287 $values[$index] = implode(', ', $links);
1290 $values[$index] = '<a href="' . $url . '">' . $values[$index] . '</a>';
1298 * Check if profile Group used by any module.
1300 * @param int $id profile Id
1308 public static function usedByModule($id) {
1309 //check whether this group is used by any module(check uf join records)
1311 FROM civicrm_uf_join
1312 WHERE civicrm_uf_join.uf_group_id=$id";
1314 $dao = new CRM_Core_DAO();
1316 if ($dao->fetch()) {
1325 * Delete the profile Group.
1327 * @param int $id profile Id
1335 public static function del($id) {
1336 //check whether this group contains any profile fields
1337 $profileField = new CRM_Core_DAO_UFField();
1338 $profileField->uf_group_id
= $id;
1339 $profileField->find();
1340 while ($profileField->fetch()) {
1341 CRM_Core_BAO_UFField
::del($profileField->id
);
1344 //delete records from uf join table
1345 $ufJoin = new CRM_Core_DAO_UFJoin();
1346 $ufJoin->uf_group_id
= $id;
1349 //delete profile group
1350 $group = new CRM_Core_DAO_UFGroup();
1357 * function to add the UF Group
1359 * @param array $params reference array contains the values submitted by the form
1360 * @param array $ids reference array contains the id
1367 static function add(&$params, $ids = array()) {
1368 $fields = array('is_active', 'add_captcha', 'is_map', 'is_update_dupe', 'is_edit_link', 'is_uf_link', 'is_cms_user');
1369 foreach ($fields as $field) {
1370 $params[$field] = CRM_Utils_Array
::value($field, $params, FALSE);
1373 $params['limit_listings_group_id'] = CRM_Utils_Array
::value('group', $params);
1374 $params['add_to_group_id'] = CRM_Utils_Array
::value('add_contact_to_group', $params);
1376 $ufGroup = new CRM_Core_DAO_UFGroup();
1377 $ufGroup->copyValues($params);
1379 $ufGroupID = CRM_Utils_Array
::value('ufgroup', $ids, CRM_Utils_Array
::value('id', $params));
1381 $ufGroup->name
= CRM_Utils_String
::munge($ufGroup->title
, '_', 56);
1383 $ufGroup->id
= $ufGroupID;
1388 $ufGroup->name
= $ufGroup->name
. "_{$ufGroup->id}";
1396 * Function to make uf join entries for an uf group
1398 * @param array $params (reference) an assoc array of name/value pairs
1399 * @param int $ufGroupId ufgroup id
1405 static function createUFJoin(&$params, $ufGroupId) {
1406 $groupTypes = CRM_Utils_Array
::value('uf_group_type', $params);
1408 // get ufjoin records for uf group
1409 $ufGroupRecord = CRM_Core_BAO_UFGroup
::getUFJoinRecord($ufGroupId);
1411 // get the list of all ufgroup types
1412 $allUFGroupType = CRM_Core_SelectValues
::ufGroupTypes();
1414 // this fix is done to prevent warning generated by array_key_exits incase of empty array is given as input
1415 if (!is_array($groupTypes)) {
1416 $groupTypes = array();
1419 // this fix is done to prevent warning generated by array_key_exits incase of empty array is given as input
1420 if (!is_array($ufGroupRecord)) {
1421 $ufGroupRecord = array();
1424 // check which values has to be inserted/deleted for contact
1425 $menuRebuild = FALSE;
1426 foreach ($allUFGroupType as $key => $value) {
1427 $joinParams = array();
1428 $joinParams['uf_group_id'] = $ufGroupId;
1429 $joinParams['module'] = $key;
1430 if ($key == 'User Account') {
1431 $menuRebuild = TRUE;
1433 if (array_key_exists($key, $groupTypes) && !in_array($key, $ufGroupRecord)) {
1434 // insert a new record
1435 CRM_Core_BAO_UFGroup
::addUFJoin($joinParams);
1437 elseif (!array_key_exists($key, $groupTypes) && in_array($key, $ufGroupRecord)) {
1438 // delete a record for existing ufgroup
1439 CRM_Core_BAO_UFGroup
::delUFJoin($joinParams);
1445 UPDATE civicrm_uf_join
1447 WHERE uf_group_id = %2
1448 AND ( entity_id IS NULL OR entity_id <= 0 )
1450 $p = array(1 => array($params['weight'], 'Integer'),
1451 2 => array($ufGroupId, 'Integer'),
1453 CRM_Core_DAO
::executeQuery($query, $p);
1455 // do a menu rebuild if we are on drupal, so it gets all the new menu entries
1457 $config = CRM_Core_Config
::singleton();
1459 $config->userSystem
->is_drupal
1466 * Function to get the UF Join records for an ufgroup id
1468 * @params int $ufGroupId uf group id
1469 * @params int $displayName if set return display name in array
1470 * @params int $status if set return module other than default modules (User Account/User registration/Profile)
1472 * @return array $ufGroupJoinRecords
1477 public static function getUFJoinRecord($ufGroupId = NULL, $displayName = NULL, $status = NULL) {
1479 $UFGroupType = array();
1480 $UFGroupType = CRM_Core_SelectValues
::ufGroupTypes();
1484 $dao = new CRM_Core_DAO_UFJoin();
1487 $dao->uf_group_id
= $ufGroupId;
1493 while ($dao->fetch()) {
1494 if (!$displayName) {
1495 $ufJoin[$dao->id
] = $dao->module
;
1498 if (isset($UFGroupType[$dao->module
])) {
1499 // skip the default modules
1501 $ufJoin[$dao->id
] = $UFGroupType[$dao->module
];
1503 // added for CRM-1475
1505 elseif (!CRM_Utils_Array
::key($dao->module
, $ufJoin)) {
1506 $ufJoin[$dao->id
] = $dao->module
;
1514 * Function takes an associative array and creates a ufjoin record for ufgroup
1516 * @param array $params (reference) an assoc array of name/value pairs
1518 * @return object CRM_Core_BAO_UFJoin object
1522 static function addUFJoin(&$params) {
1523 $ufJoin = new CRM_Core_DAO_UFJoin();
1524 $ufJoin->copyValues($params);
1530 * Function to delete the uf join record for an uf group
1532 * @param array $params (reference) an assoc array of name/value pairs
1538 static function delUFJoin(&$params) {
1539 $ufJoin = new CRM_Core_DAO_UFJoin();
1540 $ufJoin->copyValues($params);
1545 * Function to get the weight for ufjoin record
1547 * @param int $ufGroupId if $ufGroupId get update weight or add weight
1549 * @return int weight of the UFGroup
1553 static function getWeight($ufGroupId = NULL) {
1554 //calculate the weight
1557 $queryString = "SELECT ( MAX(civicrm_uf_join.weight)+1) as new_weight
1558 FROM civicrm_uf_join
1559 WHERE module = 'User Registration' OR module = 'User Account' OR module = 'Profile'";
1562 $queryString = "SELECT MAX(civicrm_uf_join.weight) as new_weight
1563 FROM civicrm_uf_join
1564 WHERE civicrm_uf_join.uf_group_id = %1
1565 AND ( entity_id IS NULL OR entity_id <= 0 )";
1566 $p[1] = array($ufGroupId, 'Integer');
1569 $dao = CRM_Core_DAO
::executeQuery($queryString, $p);
1571 return ($dao->new_weight
) ?
$dao->new_weight
: 1;
1575 * Function to get the uf group for a module
1577 * @param string $moduleName module name
1578 * @param int $count no to increment the weight
1579 * @param bool $skipPermision - whether to add permission clause
1580 * @param int $op - which operation (view, edit, create, etc) to check permission for
1581 * @param array|NULL $returnFields list of UFGroup fields to return; NULL for default
1583 * @return array $ufGroups array of ufgroups for a module
1587 public static function getModuleUFGroup($moduleName = NULL, $count = 0, $skipPermission = TRUE, $op = CRM_Core_Permission
::VIEW
, $returnFields = NULL) {
1588 $selectFields = array('id', 'title', 'created_id', 'is_active', 'is_reserved', 'group_type');
1590 if (!CRM_Core_Config
::isUpgradeMode()) {
1591 // CRM-13555, since description field was added later (4.4), and to avoid any problems with upgrade
1592 $selectFields[] = 'description';
1595 if (!empty($returnFields)) {
1596 $selectFields = array_merge($returnFields, array_diff($selectFields, $returnFields));
1599 $queryString = 'SELECT civicrm_uf_group.' . implode(', civicrm_uf_group.', $selectFields) . '
1600 FROM civicrm_uf_group
1601 LEFT JOIN civicrm_uf_join ON (civicrm_uf_group.id = uf_group_id)';
1604 $queryString .= ' AND civicrm_uf_group.is_active = 1
1605 WHERE civicrm_uf_join.module = %2';
1606 $p[2] = array($moduleName, 'String');
1610 // add permissioning for profiles only if not registration
1611 if (!$skipPermission) {
1612 $permissionClause = CRM_Core_Permission
::ufGroupClause($op, 'civicrm_uf_group.');
1613 if (strpos($queryString, 'WHERE') !== FALSE) {
1614 $queryString .= " AND $permissionClause ";
1617 $queryString .= " $permissionClause ";
1621 $queryString .= ' ORDER BY civicrm_uf_join.weight, civicrm_uf_group.title';
1622 $dao = CRM_Core_DAO
::executeQuery($queryString, $p);
1624 $ufGroups = array();
1625 while ($dao->fetch()) {
1626 //skip mix profiles in user Registration / User Account
1627 if (($moduleName == 'User Registration' ||
$moduleName == 'User Account') &&
1628 CRM_Core_BAO_UFField
::checkProfileType($dao->id
)
1632 foreach ($selectFields as $key => $field) {
1633 if($field == 'id') {
1636 elseif ($field == 'name') {
1637 $ufGroups[$dao->id
][$field] = $dao->title
;
1640 $ufGroups[$dao->id
][$field] = $dao->$field;
1644 // Allow other modules to alter/override the UFGroups.
1645 CRM_Utils_Hook
::buildUFGroupsForModule($moduleName, $ufGroups);
1651 * Function to filter ufgroups based on logged in user contact type
1653 * @params int $ufGroupId uf group id (profile id)
1655 * @return boolean true or false
1659 static function filterUFGroups($ufGroupId, $contactID = NULL) {
1661 $session = CRM_Core_Session
::singleton();
1662 $contactID = $session->get('userID');
1666 //get the contact type
1667 $contactType = CRM_Contact_BAO_Contact
::getContactType($contactID);
1669 //match if exixting contact type is same as profile contact type
1670 $profileType = CRM_Core_BAO_UFField
::getProfileType($ufGroupId);
1672 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1673 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1676 //allow special mix profiles for Contribution and Participant
1677 $specialProfiles = array('Contribution', 'Participant', 'Membership');
1679 if (in_array($profileType, $specialProfiles)) {
1683 if (($contactType == $profileType) ||
$profileType == 'Contact') {
1692 * Function to build profile form
1694 * @params object $form form object
1695 * @params array $field array field properties
1696 * @params int $mode profile mode
1697 * @params int $contactID contact id
1703 static function buildProfile(
1713 $defaultValues = array();
1714 $fieldName = $field['name'];
1715 $title = $field['title'];
1716 $attributes = $field['attributes'];
1717 $rule = $field['rule'];
1718 $view = $field['is_view'];
1719 $required = ($mode == CRM_Profile_Form
::MODE_SEARCH
) ?
FALSE : $field['is_required'];
1720 $search = ($mode == CRM_Profile_Form
::MODE_SEARCH
) ?
TRUE : FALSE;
1721 $isShared = CRM_Utils_Array
::value('is_shared', $field, 0);
1723 // do not display view fields in drupal registration form
1725 if ($view && $mode == CRM_Profile_Form
::MODE_REGISTER
) {
1730 $name = "onbehalf[$fieldName]";
1732 elseif ($contactId && !$online) {
1733 $name = "field[$contactId][$fieldName]";
1735 elseif ($rowNumber) {
1736 $name = "field[$rowNumber][$fieldName]";
1738 elseif (!empty($prefix)) {
1739 $name = $prefix ."[$fieldName]";
1745 if ($fieldName == 'image_URL' && $mode == CRM_Profile_Form
::MODE_EDIT
) {
1746 $deleteExtra = ts('Are you sure you want to delete contact image.');
1748 CRM_Core_Action
::DELETE
=>
1750 'name' => ts('Delete Contact Image'),
1751 'url' => 'civicrm/contact/image',
1752 'qs' => 'reset=1&id=%%id%%&gid=%%gid%%&action=delete',
1754 'onclick = "if (confirm( \'' . $deleteExtra . '\' ) ) this.href+=\'&confirmed=1\'; else return false;"',
1757 $deleteURL = CRM_Core_Action
::formLink($deleteURL,
1758 CRM_Core_Action
::DELETE
,
1759 array('id' => $form->get('id'),
1760 'gid' => $form->get('gid'),
1764 'contact.profileimage.delete',
1768 $form->assign('deleteURL', $deleteURL);
1770 $addressOptions = CRM_Core_BAO_Setting
::valueOptions(CRM_Core_BAO_Setting
::SYSTEM_PREFERENCES_NAME
,
1771 'address_options', TRUE, NULL, TRUE
1774 if (substr($fieldName, 0, 14) === 'state_province') {
1775 $form->add('select', $name, $title,
1777 '' => ts('- select -')) + CRM_Core_PseudoConstant
::stateProvince(), $required
1779 $config = CRM_Core_Config
::singleton();
1780 if (!in_array($mode, array(
1781 CRM_Profile_Form
::MODE_EDIT
, CRM_Profile_Form
::MODE_SEARCH
)) &&
1782 $config->defaultContactStateProvince
1784 $defaultValues[$name] = $config->defaultContactStateProvince
;
1785 $form->setDefaults($defaultValues);
1788 elseif (substr($fieldName, 0, 7) === 'country') {
1789 $form->add('select', $name, $title,
1791 '' => ts('- select -')) + CRM_Core_PseudoConstant
::country(), $required
1793 $config = CRM_Core_Config
::singleton();
1794 if (!in_array($mode, array(
1795 CRM_Profile_Form
::MODE_EDIT
, CRM_Profile_Form
::MODE_SEARCH
)) &&
1796 $config->defaultContactCountry
1798 $defaultValues[$name] = $config->defaultContactCountry
;
1799 $form->setDefaults($defaultValues);
1802 elseif (substr($fieldName, 0, 6) === 'county') {
1803 if ($addressOptions['county']) {
1804 $form->add('select', $name, $title,
1806 '' => ts('(choose state first)')), $required
1810 elseif (substr($fieldName, 0, 9) === 'image_URL') {
1811 $form->add('file', $name, $title, $attributes, $required);
1812 $form->addUploadElement($name);
1814 elseif (substr($fieldName, 0, 2) === 'im') {
1815 $form->add('text', $name, $title, $attributes, $required);
1818 if (substr($name, -1) == ']') {
1819 $providerName = substr($name, 0, -1) . '-provider_id]';
1821 $form->add('select', $providerName, NULL,
1823 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id'), $required
1827 $form->add('select', $name . '-provider_id', $title,
1829 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id'), $required
1833 if ($view && $mode != CRM_Profile_Form
::MODE_SEARCH
) {
1834 $form->freeze($name . '-provider_id');
1838 elseif (($fieldName === 'birth_date') ||
($fieldName === 'deceased_date')) {
1839 $form->addDate($name, $title, $required, array('formatType' => 'birth'));
1841 elseif (in_array($fieldName, array(
1842 'membership_start_date', 'membership_end_date', 'join_date'))) {
1843 $form->addDate($name, $title, $required, array('formatType' => 'custom'));
1845 elseif (CRM_Utils_Array
::value('name',$field) == 'membership_type') {
1846 list($orgInfo, $types) = CRM_Member_BAO_MembershipType
::getMembershipTypeInfo();
1847 $sel = &$form->addElement('hierselect', $name, $title);
1848 $select = array('' => ts('- select -') );
1849 if(count($orgInfo) == 1 && $field['is_required']) {
1850 // we only have one org - so we should default to it. Not sure about defaulting to first type
1851 // as it could be missed - so adding a select
1852 // however, possibly that is more similar to the membership form
1853 if(count($types[1]) > 1) {
1854 $types[1] = $select +
$types[1];
1858 $orgInfo = $select +
$orgInfo;
1860 $sel->setOptions(array($orgInfo, $types));
1862 elseif (CRM_Utils_Array
::value('name',$field) == 'membership_status') {
1863 $form->add('select', $name, $title,
1865 '' => ts('- select -')) + CRM_Member_PseudoConstant
::membershipStatus(NULL, NULL, 'label'), $required
1868 elseif ($fieldName === 'gender_id') {
1869 $genderOptions = array();
1870 $gender = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'gender_id');
1871 foreach ($gender as $key => $var) {
1872 $genderOptions[$key] = $form->createElement('radio', NULL, ts('Gender'), $var, $key);
1874 $form->addGroup($genderOptions, $name, $title);
1876 $form->addRule($name, ts('%1 is a required field.', array(1 => $title)), 'required');
1879 elseif ($fieldName === 'prefix_id' ||
$fieldName === 'suffix_id') {
1880 $form->add('select', $name, $title,
1882 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Contact_BAO_Contact', $fieldName), $required
1885 elseif ($fieldName === 'contact_sub_type') {
1886 $gId = $form->get('gid') ?
$form->get('gid') : CRM_Utils_Array
::value('group_id', $field);
1888 $profileType = 'Organization';
1891 $profileType = $gId ? CRM_Core_BAO_UFField
::getProfileType($gId) : NULL;
1892 if ($profileType == 'Contact') {
1893 $profileType = 'Individual';
1897 $setSubtype = FALSE;
1898 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1899 $setSubtype = $profileType;
1900 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1903 $subtypes = $profileType ? CRM_Contact_BAO_ContactType
::subTypePairs($profileType) : array();
1906 $subtypeList = array();
1907 $subtypeList[$setSubtype] = $subtypes[$setSubtype];
1910 $subtypeList = $subtypes;
1913 $sel = $form->add('select', $name, $title, $subtypeList, $required);
1914 $sel->setMultiple(TRUE);
1916 elseif (in_array($fieldName, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
1917 //add email greeting, postal greeting, addressee, CRM-4575
1918 $gId = $form->get('gid') ?
$form->get('gid') : CRM_Utils_Array
::value('group_id', $field);
1919 $profileType = CRM_Core_BAO_UFField
::getProfileType($gId, TRUE, FALSE, TRUE);
1921 if (empty($profileType) ||
in_array($profileType, array(
1922 'Contact', 'Contribution', 'Participant', 'Membership'))) {
1923 $profileType = 'Individual';
1925 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1926 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1929 'contact_type' => $profileType,
1930 'greeting_type' => $fieldName,
1932 $form->add('select', $name, $title,
1934 '' => ts('- select -')) + CRM_Core_PseudoConstant
::greeting($greeting), $required
1936 // add custom greeting element
1937 $form->add('text', $fieldName . '_custom', ts('Custom %1', array(1 => ucwords(str_replace('_', ' ', $fieldName)))),
1941 elseif ($fieldName === 'preferred_communication_method') {
1942 $communicationFields = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'preferred_communication_method');
1943 foreach ($communicationFields as $key => $var) {
1947 $communicationOptions[] = $form->createElement('checkbox', $key, NULL, $var);
1949 $form->addGroup($communicationOptions, $name, $title, '<br/>');
1951 elseif ($fieldName === 'preferred_mail_format') {
1952 $form->add('select', $name, $title, CRM_Core_SelectValues
::pmf());
1954 elseif ($fieldName === 'preferred_language') {
1955 $form->add('select', $name, $title, array('' => ts('- select -')) + CRM_Contact_BAO_Contact
::buildOptions('preferred_language'));
1957 elseif ($fieldName == 'external_identifier') {
1958 $form->add('text', $name, $title, $attributes, $required);
1959 $contID = $contactId;
1961 $contID = $form->get('id');
1963 $form->addRule($name,
1964 ts('External ID already exists in Database.'),
1966 array('CRM_Contact_DAO_Contact', $contID, 'external_identifier')
1969 elseif ($fieldName === 'group') {
1970 CRM_Contact_Form_Edit_TagsAndGroups
::buildQuickForm($form, $contactId,
1971 CRM_Contact_Form_Edit_TagsAndGroups
::GROUP
,
1976 elseif ($fieldName === 'tag') {
1977 CRM_Contact_Form_Edit_TagsAndGroups
::buildQuickForm($form, $contactId,
1978 CRM_Contact_Form_Edit_TagsAndGroups
::TAG
,
1983 elseif (substr($fieldName, 0, 4) === 'url-') {
1984 $form->add('text', $name, $title,
1985 array_merge(CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Website', 'url'),
1987 'onfocus' => "if (!this.value) { this.value='http://';} else return false",
1988 'onblur' => "if ( this.value == 'http://') { this.value='';} else return false",
1993 $form->addRule($name, ts('Enter a valid Website.'), 'url');
1995 //Website type select
1997 if (substr($name, -1) == ']') {
1998 $websiteTypeName = substr($name, 0, -1) . '-website_type_id]';
2000 $form->addElement('select', $websiteTypeName, NULL, CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Website', 'website_type_id'));
2003 $form->addElement('select', $name . '-website_type_id', NULL, CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Website', 'website_type_id'));
2006 // Note should be rendered as textarea
2007 elseif (substr($fieldName, -4) == 'note') {
2008 $form->add('textarea', $name, $title, $attributes, $required);
2010 elseif (substr($fieldName, 0, 6) === 'custom') {
2011 $customFieldID = CRM_Core_BAO_CustomField
::getKeyID($fieldName);
2012 if ($customFieldID) {
2013 CRM_Core_BAO_CustomField
::addQuickFormElement($form, $name, $customFieldID, FALSE, $required, $search, $title);
2016 elseif (substr($fieldName, 0, 14) === 'address_custom') {
2017 list($fName, $locTypeId) = CRM_Utils_System
::explode('-', $fieldName, 2);
2018 $customFieldID = CRM_Core_BAO_CustomField
::getKeyID(substr($fName, 8));
2019 if ($customFieldID) {
2020 CRM_Core_BAO_CustomField
::addQuickFormElement($form, $name, $customFieldID, FALSE, $required, $search, $title);
2023 elseif (in_array($fieldName, array(
2024 'receive_date', 'receipt_date', 'thankyou_date', 'cancel_date'))) {
2025 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2027 elseif ($fieldName == 'send_receipt') {
2028 $form->addElement('checkbox', $name, $title);
2030 elseif ($fieldName == 'soft_credit') {
2031 CRM_Contact_Form_NewContact
::buildQuickForm($form, $rowNumber, NULL, FALSE, 'soft_credit_');
2032 $form->addMoney("soft_credit_amount[{$rowNumber}]", ts('Amount'), FALSE, NULL, FALSE);
2034 elseif ($fieldName == 'product_name') {
2035 list($products, $options) = CRM_Contribute_BAO_Premium
::getPremiumProductInfo();
2036 $sel = &$form->addElement('hierselect', $name, $title);
2038 '0' => ts('- select -')) +
$products;
2039 $sel->setOptions(array($products, $options));
2041 elseif ($fieldName == 'payment_instrument') {
2042 $form->add('select', $name, $title,
2043 array(''=>ts( '- select -' )) + CRM_Contribute_PseudoConstant
::paymentInstrument( ), $required );
2045 else if ($fieldName == 'financial_type' ) {
2046 $form->add('select', $name, $title,
2048 '' => ts('- select -')) + CRM_Contribute_PseudoConstant
::financialType(), $required
2051 elseif ($fieldName == 'contribution_status_id') {
2052 $contributionStatuses = CRM_Contribute_PseudoConstant
::contributionStatus();
2053 $statusName = CRM_Contribute_PseudoConstant
::contributionStatus(NULL, 'name');
2059 unset($contributionStatuses[CRM_Utils_Array
::key($suppress, $statusName)]);
2062 $form->add('select', $name, $title,
2064 '' => ts('- select -')) +
$contributionStatuses, $required
2067 elseif ($fieldName == 'soft_credit_type') {
2068 $form->add('select', $name, $title,
2070 '' => ts('- select -')) + CRM_Core_OptionGroup
::values("soft_credit_type")
2072 $form->addElement('hidden', 'sct_default_id',
2073 CRM_Core_OptionGroup
::getDefaultValue("soft_credit_type"),
2074 array('id' => 'sct_default_id')
2077 elseif ($fieldName == 'currency') {
2078 $form->addCurrency($name, $title, $required);
2080 elseif ($fieldName == 'contribution_page_id') {
2081 $form->add('select', $name, $title,
2083 '' => ts('- select -')) + CRM_Contribute_PseudoConstant
::contributionPage(), $required, 'class="big"'
2086 elseif ($fieldName == 'participant_register_date') {
2087 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2089 elseif ($fieldName == 'activity_status_id') {
2090 $form->add('select', $name, $title,
2092 '' => ts('- select -')) + CRM_Core_PseudoConstant
::activityStatus(), $required
2095 elseif ($fieldName == 'activity_engagement_level') {
2096 $form->add('select', $name, $title,
2098 '' => ts('- select -')) + CRM_Campaign_PseudoConstant
::engagementLevel(), $required
2101 elseif ($fieldName == 'activity_date_time') {
2102 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2104 elseif ($fieldName == 'participant_status') {
2106 if ($online == TRUE) {
2107 $cond = 'visibility_id = 1';
2109 $form->add('select', $name, $title,
2111 '' => ts('- select -')) + CRM_Event_PseudoConstant
::participantStatus(NULL, $cond, 'label'), $required
2114 elseif ($fieldName == 'participant_role') {
2115 if (CRM_Utils_Array
::value('is_multiple', $field)) {
2116 $form->addCheckBox($name, $title, CRM_Event_PseudoConstant
::participantRole(), NULL, NULL, NULL, NULL, ' ', TRUE);
2119 $form->add('select', $name, $title,
2121 '' => ts('- select -')) + CRM_Event_PseudoConstant
::participantRole(), $required
2125 elseif ($fieldName == 'world_region') {
2126 $form->add('select', $name, $title,
2128 '' => ts('- select -')) + CRM_Core_PseudoConstant
::worldRegion(), $required
2131 elseif ($fieldName == 'signature_html') {
2132 $form->addWysiwyg($name, $title, CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Email', $fieldName));
2134 elseif ($fieldName == 'signature_text') {
2135 $form->add('textarea', $name, $title, CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Email', $fieldName));
2137 elseif (substr($fieldName, -11) == 'campaign_id') {
2138 if (CRM_Campaign_BAO_Campaign
::isCampaignEnable()) {
2139 $campaigns = CRM_Campaign_BAO_Campaign
::getCampaigns(CRM_Utils_Array
::value($contactId,
2140 $form->_componentCampaigns
2142 $form->add('select', $name, $title,
2144 '' => ts('- select -')) +
$campaigns, $required, 'class="big"'
2148 elseif ($fieldName == 'activity_details') {
2149 $form->addWysiwyg($fieldName, $title, array('rows' => 4, 'cols' => 60), $required);
2151 elseif ($fieldName == 'activity_duration') {
2152 $form->add('text', $name, $title, $attributes, $required);
2153 $form->addRule($name, ts('Please enter the duration as number of minutes (integers only).'), 'positiveInteger');
2156 if (substr($fieldName, 0, 3) === 'is_' or substr($fieldName, 0, 7) === 'do_not_') {
2157 $form->add('advcheckbox', $name, $title, $attributes, $required);
2160 $form->add('text', $name, $title, $attributes, $required);
2164 static $hiddenSubtype = FALSE;
2165 if (!$hiddenSubtype && CRM_Contact_BAO_ContactType
::isaSubType($field['field_type'])) {
2166 // In registration mode params are submitted via POST and we don't have any clue
2167 // about profile-id or the profile-type (which could be a subtype)
2168 // To generalize the behavior and simplify the process,
2169 // lets always add the hidden
2170 //subtype value if there is any, and we won't have to
2171 // compute it while processing.
2173 $form->addElement('hidden', 'onbehalf[contact_sub_type]', $field['field_type']);
2176 $form->addElement('hidden', 'contact_sub_type_hidden', $field['field_type']);
2178 $hiddenSubtype = TRUE;
2181 if (($view && $mode != CRM_Profile_Form
::MODE_SEARCH
) ||
$isShared) {
2182 $form->freeze($name);
2186 if (in_array($fieldName, array(
2187 'non_deductible_amount', 'total_amount', 'fee_amount', 'net_amount'))) {
2188 $form->addRule($name, ts('Please enter a valid amount.'), 'money');
2190 $stateCountryMap = array();
2191 if (!empty($form->_stateCountryMap
['state_province']) && !empty($form->_stateCountryMap
['country'])) {
2192 foreach ($form->_stateCountryMap
['state_province'] as $key => $value) {
2193 $stateCountryMap[$key]['state_province'] = $value;
2194 $stateCountryMap[$key]['country'] = $form->_stateCountryMap
['country'][$key];
2196 CRM_Core_BAO_Address
::addStateCountryMap($stateCountryMap);
2199 if (!($rule == 'email' && $mode == CRM_Profile_Form
::MODE_SEARCH
)) {
2200 $form->addRule($name, ts('Please enter a valid %1', array(1 => $title)), $rule);
2206 * Function to set profile defaults
2208 * @params int $contactId contact id
2209 * @params array $fields associative array of fields
2210 * @params array $defaults defaults array
2211 * @params boolean $singleProfile true for single profile else false(batch update)
2212 * @params int $componentId id for specific components like contribute, event etc
2218 static function setProfileDefaults($contactId, &$fields, &$defaults,
2219 $singleProfile = TRUE, $componentId = NULL, $component = NULL
2221 if (!$componentId) {
2222 //get the contact details
2223 list($contactDetails, $options) = CRM_Contact_BAO_Contact
::getHierContactDetails($contactId, $fields);
2224 $details = CRM_Utils_Array
::value($contactId, $contactDetails);
2225 $multipleFields = array('website' => 'url');
2227 //start of code to set the default values
2228 foreach ($fields as $name => $field) {
2229 // skip pseudo fields
2230 if (substr($name, 0, 9) == 'phone_ext') {
2234 //set the field name depending upon the profile mode(single/batch)
2235 if ($singleProfile) {
2239 $fldName = "field[$contactId][$name]";
2242 if ($name == 'group') {
2243 CRM_Contact_Form_Edit_TagsAndGroups
::setDefaults($contactId, $defaults, CRM_Contact_Form_Edit_TagsAndGroups
::GROUP
, $fldName);
2245 if ($name == 'tag') {
2246 CRM_Contact_Form_Edit_TagsAndGroups
::setDefaults($contactId, $defaults, CRM_Contact_Form_Edit_TagsAndGroups
::TAG
, $fldName);
2249 if (CRM_Utils_Array
::value($name, $details) ||
isset($details[$name])) {
2250 //to handle custom data (checkbox) to be written
2251 // to handle birth/deceased date, greeting_type and few other fields
2252 if (($name == 'birth_date') ||
($name == 'deceased_date')) {
2253 list($defaults[$fldName]) = CRM_Utils_Date
::setDateDefaults($details[$name], 'birth');
2255 elseif (in_array($name, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
2256 $defaults[$fldName] = $details[$name . '_id'];
2257 $defaults[$name . '_custom'] = $details[$name . '_custom'];
2259 elseif ($name == 'preferred_communication_method') {
2260 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2261 foreach ($v as $item) {
2263 $defaults[$fldName . "[$item]"] = 1;
2267 elseif ($name == 'world_region') {
2268 $defaults[$fldName] = $details['worldregion_id'];
2270 elseif ($customFieldId = CRM_Core_BAO_CustomField
::getKeyID($name)) {
2271 //fix for custom fields
2272 $customFields = CRM_Core_BAO_CustomField
::getFields(CRM_Utils_Array
::value('contact_type', $details));
2274 // hack to add custom data for components
2275 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
2276 foreach ($components as $value) {
2277 $customFields = CRM_Utils_Array
::crmArrayMerge($customFields,
2278 CRM_Core_BAO_CustomField
::getFieldsForImport($value)
2282 switch ($customFields[$customFieldId]['html_type']) {
2283 case 'Multi-Select State/Province':
2284 case 'Multi-Select Country':
2285 case 'AdvMulti-Select':
2286 case 'Multi-Select':
2287 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2288 foreach ($v as $item) {
2290 $defaults[$fldName][$item] = $item;
2296 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2297 foreach ($v as $item) {
2299 $defaults[$fldName][$item] = 1;
2300 // seems like we need this for QF style checkboxes in profile where its multiindexed
2302 $defaults["{$fldName}[{$item}]"] = 1;
2307 case 'Autocomplete-Select':
2308 if ($customFields[$customFieldId]['data_type'] == 'ContactReference') {
2309 if (is_numeric($details[$name])) {
2310 $defaults[$fldName . '_id'] = $details[$name];
2311 $defaults[$fldName] = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Contact', $details[$name], 'sort_name');
2315 $label = CRM_Core_BAO_CustomOption
::getOptionLabel($customFieldId, $details[$name]);
2316 $defaults[$fldName . '_id'] = $details[$name];
2317 $defaults[$fldName] = $label;
2322 // CRM-6681, set defult values according to date and time format (if any).
2324 if (CRM_Utils_Array
::value('date_format', $customFields[$customFieldId])) {
2325 $dateFormat = $customFields[$customFieldId]['date_format'];
2328 if (!CRM_Utils_Array
::value('time_format', $customFields[$customFieldId])) {
2329 list($defaults[$fldName]) = CRM_Utils_Date
::setDateDefaults($details[$name], NULL,
2334 $timeElement = $fldName . '_time';
2335 if (substr($fldName, -1) == ']') {
2336 $timeElement = substr($fldName, 0, -1) . '_time]';
2338 list($defaults[$fldName], $defaults[$timeElement]) = CRM_Utils_Date
::setDateDefaults($details[$name],
2339 NULL, $dateFormat, $customFields[$customFieldId]['time_format']);
2344 $defaults[$fldName] = $details[$name];
2349 $defaults[$fldName] = $details[$name];
2353 $blocks = array('email', 'phone', 'im', 'openid');
2354 list($fieldName, $locTypeId, $phoneTypeId) = CRM_Utils_System
::explode('-', $name, 3);
2355 if (!in_array($fieldName, $multipleFields)) {
2356 if (is_array($details)) {
2357 foreach ($details as $key => $value) {
2358 // when we fixed CRM-5319 - get primary loc
2359 // type as per loc field and removed below code.
2360 $primaryLocationType = FALSE;
2361 if ($locTypeId == 'Primary') {
2362 if (is_array($value) && array_key_exists($fieldName, $value)){
2363 $primaryLocationType = TRUE;
2364 if (in_array($fieldName, $blocks)){
2365 $locTypeId = CRM_Contact_BAO_Contact
::getPrimaryLocationType($contactId, FALSE, $fieldName);
2368 $locTypeId = CRM_Contact_BAO_Contact
::getPrimaryLocationType($contactId, FALSE, 'address');
2373 // fixed for CRM-665
2374 if (is_numeric($locTypeId)) {
2375 if ($primaryLocationType ||
$locTypeId == CRM_Utils_Array
::value('location_type_id', $value)) {
2376 if (CRM_Utils_Array
::value($fieldName, $value)) {
2377 //to handle stateprovince and country
2378 if ($fieldName == 'state_province') {
2379 $defaults[$fldName] = $value['state_province_id'];
2381 elseif ($fieldName == 'county') {
2382 $defaults[$fldName] = $value['county_id'];
2384 elseif ($fieldName == 'country') {
2385 if (!isset($value['country_id']) ||
!$value['country_id']) {
2386 $config = CRM_Core_Config
::singleton();
2387 if ($config->defaultContactCountry
) {
2388 $defaults[$fldName] = $config->defaultContactCountry
;
2392 $defaults[$fldName] = $value['country_id'];
2395 elseif ($fieldName == 'phone') {
2397 if (isset($value['phone'][$phoneTypeId])) {
2398 $defaults[$fldName] = $value['phone'][$phoneTypeId];
2400 if (isset($value['phone_ext'][$phoneTypeId])) {
2401 $defaults[str_replace('phone', 'phone_ext', $fldName)] = $value['phone_ext'][$phoneTypeId];
2405 $phoneDefault = CRM_Utils_Array
::value('phone', $value);
2407 if (!is_array($phoneDefault)) {
2408 $defaults[$fldName] = $phoneDefault;
2412 elseif ($fieldName == 'email') {
2413 //adding the first email (currently we don't support multiple emails of same location type)
2414 $defaults[$fldName] = $value['email'];
2416 elseif ($fieldName == 'im') {
2417 //adding the first im (currently we don't support multiple ims of same location type)
2418 $defaults[$fldName] = $value['im'];
2419 $defaults[$fldName . '-provider_id'] = $value['im_provider_id'];
2422 $defaults[$fldName] = $value[$fieldName];
2425 elseif (substr($fieldName, 0, 14) === 'address_custom' &&
2426 CRM_Utils_Array
::value(substr($fieldName, 8), $value)
2428 $defaults[$fldName] = $value[substr($fieldName, 8)];
2436 if (is_array($details)) {
2437 if ($fieldName === 'url') {
2438 if (!empty($details['website'])) {
2439 foreach ($details['website'] as $val) {
2440 $defaults[$fldName] = CRM_Utils_Array
::value('url', $val);
2441 $defaults[$fldName . '-website_type_id'] = $val['website_type_id'];
2451 //Handling Contribution Part of the batch profile
2452 if (CRM_Core_Permission
::access('CiviContribute') && $component == 'Contribute') {
2453 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2456 //Handling Event Participation Part of the batch profile
2457 if (CRM_Core_Permission
::access('CiviEvent') && $component == 'Event') {
2458 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2461 //Handling membership Part of the batch profile
2462 if (CRM_Core_Permission
::access('CiviMember') && $component == 'Membership') {
2463 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2466 //Handling Activity Part of the batch profile
2467 if ($component == 'Activity') {
2468 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2473 * Function to get profiles by type eg: pure Individual etc
2475 * @param array $types associative array of types eg: types('Individual')
2476 * @param boolean $onlyPure true if only pure profiles are required
2478 * @return array $profiles associative array of profiles
2482 static function getProfiles($types, $onlyPure = FALSE) {
2483 $profiles = array();
2484 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
2486 CRM_Utils_Hook
::aclGroup(CRM_Core_Permission
::ADMIN
, NULL, 'civicrm_uf_group', $ufGroups, $ufGroups);
2488 // Exclude Batch Data Entry profiles - CRM-10901
2489 $batchProfiles = CRM_Core_BAO_UFGroup
::getBatchProfiles();
2491 foreach ($ufGroups as $id => $title) {
2492 $ptype = CRM_Core_BAO_UFField
::getProfileType($id, FALSE, $onlyPure);
2493 if (in_array($ptype, $types) && !array_key_exists($id, $batchProfiles)) {
2494 $profiles[$id] = $title;
2501 * Function to check whether a profile is valid combination of
2502 * required and/or optional profile types
2504 * @param array $required array of types those are required
2505 * @param array $optional array of types those are optional
2507 * @return array $profiles associative array of profiles
2511 static function getValidProfiles($required, $optional = NULL) {
2512 if (!is_array($required) ||
empty($required)) {
2516 $profiles = array();
2517 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
2519 CRM_Utils_Hook
::aclGroup(CRM_Core_Permission
::ADMIN
, NULL, 'civicrm_uf_group', $ufGroups, $ufGroups);
2521 foreach ($ufGroups as $id => $title) {
2522 $type = CRM_Core_BAO_UFField
::checkValidProfileType($id, $required, $optional);
2524 $profiles[$id] = $title;
2532 * Function to check whether a profile is valid combination of
2533 * required profile fields
2535 * @param array $ufId integer id of the profile
2536 * @param array $required array of fields those are required in the profile
2538 * @return array $profiles associative array of profiles
2542 static function checkValidProfile($ufId, $required = NULL) {
2543 $validProfile = FALSE;
2545 return $validProfile;
2548 if (!CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $ufId, 'is_active')) {
2549 return $validProfile;
2552 $profileFields = self
::getFields($ufId, FALSE, CRM_Core_Action
::VIEW
, NULL,
2553 NULL, FALSE, NULL, FALSE, NULL,
2554 CRM_Core_Permission
::CREATE
, NULL
2557 $validProfile = array();
2558 if (!empty($profileFields)) {
2559 $fields = array_keys($profileFields);
2560 foreach ($fields as $val) {
2561 foreach ($required as $key => $field) {
2562 if (strpos($val, $field) === 0) {
2563 unset($required[$key]);
2568 $validProfile = (empty($required)) ?
TRUE : FALSE;
2571 return $validProfile;
2575 * Function to get default value for Register.
2581 static function setRegisterDefaults(&$fields, &$defaults) {
2582 $config = CRM_Core_Config
::singleton();
2583 foreach ($fields as $name => $field) {
2584 if (substr($name, 0, 8) == 'country-') {
2585 if (!empty($config->defaultContactCountry
)) {
2586 $defaults[$name] = $config->defaultContactCountry
;
2589 elseif (substr($name, 0, 15) == 'state_province-') {
2590 if (!empty($config->defaultContactStateProvince
)) {
2591 $defaults[$name] = $config->defaultContactStateProvince
;
2599 * This function is to make a copy of a profile, including
2600 * all the fields in the profile
2602 * @param int $id the profile id to copy
2607 static function copy($id) {
2608 $fieldsFix = array('prefix' => array('title' => ts('Copy of ')));
2609 $copy = &CRM_Core_DAO
::copyGeneric('CRM_Core_DAO_UFGroup',
2615 if ($pos = strrpos($copy->name
, "_{$id}")) {
2616 $copy->name
= substr_replace($copy->name
, '', $pos);
2618 $copy->name
= CRM_Utils_String
::munge($copy->name
, '_', 56) . "_{$copy->id}";
2621 $copyUFJoin = &CRM_Core_DAO
::copyGeneric('CRM_Core_DAO_UFJoin',
2622 array('uf_group_id' => $id),
2623 array('uf_group_id' => $copy->id
),
2628 $copyUFField = &CRM_Core_DAO
::copyGeneric('CRM_Core_BAO_UFField',
2629 array('uf_group_id' => $id),
2630 array('uf_group_id' => $copy->id
)
2633 $maxWeight = CRM_Utils_Weight
::getMax('CRM_Core_DAO_UFJoin', NULL, 'weight');
2637 UPDATE civicrm_uf_join
2639 WHERE uf_group_id = %2
2640 AND ( entity_id IS NULL OR entity_id <= 0 )
2642 $p = array(1 => array($maxWeight +
1, 'Integer'),
2643 2 => array($copy->id
, 'Integer'),
2645 CRM_Core_DAO
::executeQuery($query, $p);
2646 if ($copy->is_reserved
) {
2647 $query = "UPDATE civicrm_uf_group SET is_reserved = 0 WHERE id = %1";
2648 $params = array(1 => array($copy->id
, 'Integer'));
2649 CRM_Core_DAO
::executeQuery($query, $params);
2651 CRM_Utils_Hook
::copy('UFGroup', $copy);
2657 * Process that send notification e-mails
2659 * @params int $contactId contact id
2660 * @params array $values associative array of name/value pair
2666 static function commonSendMail($contactID, &$values) {
2667 if (!$contactID ||
!$values) {
2671 $template = CRM_Core_Smarty
::singleton();
2673 $displayName = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Contact',
2678 self
::profileDisplay($values['id'], $values['values'], $template);
2679 $emailList = explode(',', $values['email']);
2681 $contactLink = CRM_Utils_System
::url('civicrm/contact/view',
2682 "reset=1&cid=$contactID",
2683 TRUE, NULL, FALSE, FALSE, TRUE
2686 //get the default domain email address.
2687 list($domainEmailName, $domainEmailAddress) = CRM_Core_BAO_Domain
::getNameAndEmail();
2689 if (!$domainEmailAddress ||
$domainEmailAddress == 'info@EXAMPLE.ORG') {
2690 $fixUrl = CRM_Utils_System
::url('civicrm/admin/domain', 'action=update&reset=1');
2691 CRM_Core_Error
::fatal(ts('The site administrator needs to enter a valid \'FROM Email Address\' in <a href="%1">Administer CiviCRM » Communications » FROM Email Addresses</a>. The email address used may need to be a valid mail account with your email service provider.', array(1 => $fixUrl)));
2694 foreach ($emailList as $emailTo) {
2695 // FIXME: take the below out of the foreach loop
2696 CRM_Core_BAO_MessageTemplate
::sendTemplate(
2698 'groupName' => 'msg_tpl_workflow_uf',
2699 'valueName' => 'uf_notify',
2700 'contactId' => $contactID,
2701 'tplParams' => array(
2702 'displayName' => $displayName,
2703 'currentDate' => date('r'),
2704 'contactLink' => $contactLink,
2706 'from' => "$domainEmailName <$domainEmailAddress>",
2707 'toEmail' => $emailTo,
2714 * Given a contact id and a group id, returns the field values from the db
2715 * for this group and notify email only if group's notify field is
2716 * set and field values are not empty
2718 * @params $gid group id
2719 * @params $cid contact id
2720 * @params $params associative array
2725 function checkFieldsEmptyValues($gid, $cid, $params, $skipCheck = FALSE) {
2727 if (CRM_Core_BAO_UFGroup
::filterUFGroups($gid, $cid) ||
$skipCheck) {
2729 $fields = CRM_Core_BAO_UFGroup
::getFields($gid, FALSE, CRM_Core_Action
::VIEW
);
2730 CRM_Core_BAO_UFGroup
::getValues($cid, $fields, $values, FALSE, $params, TRUE);
2732 $email = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $gid, 'notify');
2734 if (!empty($values) &&
2739 'values' => $values,
2750 * Function to assign uf fields to template
2752 * @params int $gid group id
2753 * @params array $values associative array of fields
2758 function profileDisplay($gid, $values, $template) {
2759 $groupTitle = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $gid, 'title');
2760 $template->assign('grouptitle', $groupTitle);
2761 if (count($values)) {
2762 $template->assign('values', $values);
2767 * Format fields for dupe Contact Matching
2769 * @param array $params associated array
2771 * @return array $data assoicated formatted array
2775 static function formatFields($params, $contactId = NULL) {
2777 // get the primary location type id and email
2778 list($name, $primaryEmail, $primaryLocationType) = CRM_Contact_BAO_Contact_Location
::getEmailDetails($contactId);
2781 $defaultLocationType = CRM_Core_BAO_LocationType
::getDefault();
2782 $primaryLocationType = $defaultLocationType->id
;
2786 $locationType = array();
2788 $primaryLocation = 0;
2789 foreach ($params as $key => $value) {
2790 list($fieldName, $locTypeId, $phoneTypeId) = explode('-', $key);
2792 if ($locTypeId == 'Primary') {
2793 $locTypeId = $primaryLocationType;
2796 if (is_numeric($locTypeId)) {
2797 if (!in_array($locTypeId, $locationType)) {
2798 $locationType[$count] = $locTypeId;
2801 $loc = CRM_Utils_Array
::key($locTypeId, $locationType);
2803 $data['location'][$loc]['location_type_id'] = $locTypeId;
2805 // if we are getting in a new primary email, dont overwrite the new one
2806 if ($locTypeId == $primaryLocationType) {
2807 if (CRM_Utils_Array
::value('email-' . $primaryLocationType, $params)) {
2808 $data['location'][$loc]['email'][$loc]['email'] = $fields['email-' . $primaryLocationType];
2810 elseif (isset($primaryEmail)) {
2811 $data['location'][$loc]['email'][$loc]['email'] = $primaryEmail;
2817 $data['location'][$loc]['is_primary'] = 1;
2819 if ($fieldName == 'phone') {
2821 $data['location'][$loc]['phone'][$loc]['phone_type_id'] = $phoneTypeId;
2824 $data['location'][$loc]['phone'][$loc]['phone_type_id'] = '';
2826 $data['location'][$loc]['phone'][$loc]['phone'] = $value;
2828 elseif ($fieldName == 'email') {
2829 $data['location'][$loc]['email'][$loc]['email'] = $value;
2831 elseif ($fieldName == 'im') {
2832 $data['location'][$loc]['im'][$loc]['name'] = $value;
2835 if ($fieldName === 'state_province') {
2836 $data['location'][$loc]['address']['state_province_id'] = $value;
2838 elseif ($fieldName === 'country') {
2839 $data['location'][$loc]['address']['country_id'] = $value;
2842 $data['location'][$loc]['address'][$fieldName] = $value;
2847 // TODO: prefix, suffix and gender translation may no longer be necessary - check inputs
2848 if ($key === 'individual_suffix') {
2849 $data['suffix_id'] = $value;
2851 elseif ($key === 'individual_prefix') {
2852 $data['prefix_id'] = $value;
2854 elseif ($key === 'gender') {
2855 $data['gender_id'] = $value;
2857 elseif (substr($key, 0, 6) === 'custom') {
2858 if ($customFieldID = CRM_Core_BAO_CustomField
::getKeyID($key)) {
2860 if ($customFields[$customFieldID]['html_type'] == 'CheckBox') {
2861 $value = implode(CRM_Core_DAO
::VALUE_SEPARATOR
, array_keys($value));
2863 // fix the date field
2864 if ($customFields[$customFieldID]['data_type'] == 'Date') {
2865 $date = CRM_Utils_Date
::format($value);
2872 $data['custom'][$customFieldID] = array(
2875 'extends' => $customFields[$customFieldID]['extends'],
2876 'type' => $customFields[$customFieldID]['data_type'],
2877 'custom_field_id' => $customFieldID,
2881 elseif ($key == 'edit') {
2885 $data[$key] = $value;
2890 if (!$primaryLocation) {
2892 $data['location'][$loc]['email'][$loc]['email'] = $primaryEmail;
2900 * calculate the profile type 'group_type' as per profile fields.
2902 * @param int $gid profile id
2903 * @param int $ignoreFieldId ignore particular profile field
2905 * @return array list of calculated group type
2907 static function calculateGroupType($gId, $includeTypeValues = FALSE, $ignoreFieldId = NULL) {
2908 //get the profile fields.
2909 $ufFields = self
::getFields($gId, FALSE, NULL, NULL, NULL, TRUE, NULL, TRUE);
2910 return self
::_calculateGroupType($ufFields, $includeTypeValues, $ignoreFieldId);
2914 * calculate the profile type 'group_type' as per profile fields.
2916 * @param int $gid profile id
2917 * @param int $ignoreFieldId ignore perticular profile field
2919 * @return array list of calculated group type
2921 static function _calculateGroupType($ufFields, $includeTypeValues = FALSE, $ignoreFieldId = NULL) {
2922 $groupType = $groupTypeValues = $customFieldIds = array();
2923 if (!empty($ufFields)) {
2924 foreach ($ufFields as $fieldName => $fieldValue) {
2925 //ignore field from group type when provided.
2926 //in case of update profile field.
2927 if ($ignoreFieldId && ($ignoreFieldId == $fieldValue['field_id'])) {
2930 if (!in_array($fieldValue['field_type'], $groupType)) {
2931 $groupType[$fieldValue['field_type']] = $fieldValue['field_type'];
2934 if ($includeTypeValues && ($fldId = CRM_Core_BAO_CustomField
::getKeyID($fieldName))) {
2935 $customFieldIds[$fldId] = $fldId;
2940 if (!empty($customFieldIds)) {
2941 $query = 'SELECT DISTINCT(cg.id), cg.extends, cg.extends_entity_column_id, cg.extends_entity_column_value FROM civicrm_custom_group cg LEFT JOIN civicrm_custom_field cf ON cf.custom_group_id = cg.id WHERE cg.extends_entity_column_value IS NOT NULL AND cf.id IN (' . implode(',', $customFieldIds) . ')';
2943 $customGroups = CRM_Core_DAO
::executeQuery($query);
2944 while ($customGroups->fetch()) {
2945 if (!$customGroups->extends_entity_column_value
) {
2949 $groupTypeName = "{$customGroups->extends}Type";
2950 if ($customGroups->extends == 'Participant' && $customGroups->extends_entity_column_id
) {
2951 $groupTypeName = CRM_Core_OptionGroup
::getValue('custom_data_type', $customGroups->extends_entity_column_id
, 'value', 'String', 'name');
2954 foreach (explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $customGroups->extends_entity_column_value
) as $val) {
2956 $groupTypeValues[$groupTypeName][$val] = $val;
2961 if (!empty($groupTypeValues)) {
2962 $groupType = array_merge($groupType, $groupTypeValues);
2970 * Update the profile type 'group_type' as per profile fields including group types and group subtype values.
2971 * Build and store string like: group_type1,group_type2[VALUE_SEPERATOR]group_type1Type:1:2:3,group_type2Type:1:2
2974 * BirthDate + Email Individual,Contact
2975 * BirthDate + Subject Individual,Activity
2976 * BirthDate + Subject + SurveyOnlyField Individual,Activity\0ActivityType:28
2977 * BirthDate + Subject + SurveyOnlyField + PhoneOnlyField (Not allowed)
2978 * BirthDate + SurveyOnlyField Individual,Activity\0ActivityType:28
2979 * BirthDate + Subject + SurveyOrPhoneField Individual,Activity\0ActivityType:2:28
2980 * BirthDate + SurveyOrPhoneField Individual,Activity\0ActivityType:2:28
2981 * BirthDate + SurveyOrPhoneField + SurveyOnlyField Individual,Activity\0ActivityType:2:28
2982 * BirthDate + StudentField + Subject + SurveyOnlyField Individual,Activity,Student\0ActivityType:28
2984 * @param Integer $gid profile id
2985 * @param Array $groupTypes With key having group type names
2989 static function updateGroupTypes($gId, $groupTypes = array(
2991 if (!is_array($groupTypes) ||
!$gId) {
2995 // If empty group types set group_type as 'null'
2996 if (empty($groupTypes)) {
2997 return CRM_Core_DAO
::setFieldValue('CRM_Core_DAO_UFGroup', $gId, 'group_type', 'null');
3000 $componentGroupTypes = array('Contribution', 'Participant', 'Membership', 'Activity');
3001 $validGroupTypes = array_merge(array('Contact', 'Individual', 'Organization', 'Household'), $componentGroupTypes, CRM_Contact_BAO_ContactType
::subTypes());
3003 $gTypes = $gTypeValues = array();
3005 $participantExtends = array('ParticipantRole', 'ParticipantEventName', 'ParticipantEventType');
3006 // Get valid group type and group subtypes
3007 foreach ($groupTypes as $groupType => $value) {
3008 if (in_array($groupType, $validGroupTypes) && !in_array($groupType, $gTypes)) {
3009 $gTypes[] = $groupType;
3014 if (in_array($groupType, $participantExtends)) {
3015 $subTypesOf = $groupType;
3017 elseif (strpos($groupType, 'Type') > 0) {
3018 $subTypesOf = substr($groupType, 0, strpos($groupType, 'Type'));
3024 if (!empty($value) &&
3025 (in_array($subTypesOf, $componentGroupTypes) ||
3026 in_array($subTypesOf, $participantExtends)
3029 $gTypeValues[$subTypesOf] = $groupType . ":" . implode(':', $value);
3033 if (empty($gTypes)) {
3037 // Build String to store group types and group subtypes
3038 $groupTypeString = implode(',', $gTypes);
3039 if (!empty($gTypeValues)) {
3040 $groupTypeString .= CRM_Core_DAO
::VALUE_SEPARATOR
. implode(',', $gTypeValues);
3043 return CRM_Core_DAO
::setFieldValue('CRM_Core_DAO_UFGroup', $gId, 'group_type', $groupTypeString);
3047 * Create a "group_type" string
3049 * @param array $coreTypes e.g. array('Individual','Contact','Student')
3050 * @param array $subTypes e.g. array('ActivityType' => array(7, 11))
3051 * @param string $delim
3052 * @throws CRM_Core_Exception
3054 static function encodeGroupType($coreTypes, $subTypes, $delim = CRM_Core_DAO
::VALUE_SEPARATOR
) {
3055 $groupTypeExpr = '';
3057 $groupTypeExpr .= implode(',', $coreTypes);
3060 if (count($subTypes) > 1) {
3061 throw new CRM_Core_Exception("Multiple subtype filtering is not currently supported by widget.");
3063 foreach ($subTypes as $subType => $subTypeIds) {
3064 $groupTypeExpr .= $delim . $subType . ':' . implode(':', $subTypeIds);
3067 return $groupTypeExpr;
3071 * This function is used to setDefault componet specific profile fields.
3073 * @param array $fields profile fields.
3074 * @param int $componentId componetID
3075 * @param string $component component name
3076 * @param array $defaults an array of default values.
3080 public static function setComponentDefaults(&$fields, $componentId, $component, &$defaults, $isStandalone = FALSE) {
3081 if (!$componentId ||
3082 !in_array($component, array('Contribute', 'Membership', 'Event', 'Activity'))
3087 $componentBAO = $componentSubType = NULL;
3088 switch ($component) {
3090 $componentBAO = 'CRM_Member_BAO_Membership';
3091 $componentBAOName = 'Membership';
3092 $componentSubType = array('membership_type_id');
3096 $componentBAO = 'CRM_Contribute_BAO_Contribution';
3097 $componentBAOName = 'Contribution';
3098 $componentSubType = array( 'financial_type_id' );
3102 $componentBAO = 'CRM_Event_BAO_Participant';
3103 $componentBAOName = 'Participant';
3104 $componentSubType = array('role_id', 'event_id');
3108 $componentBAO = 'CRM_Activity_BAO_Activity';
3109 $componentBAOName = 'Activity';
3110 $componentSubType = array('activity_type_id');
3115 $params = array('id' => $componentId);
3117 //get the component values.
3118 CRM_Core_DAO
::commonRetrieve($componentBAO, $params, $values);
3120 $formattedGroupTree = array();
3121 $dateTimeFields = array('participant_register_date', 'activity_date_time', 'receive_date', 'receipt_date', 'cancel_date', 'thankyou_date', 'membership_start_date', 'membership_end_date', 'join_date');
3122 foreach ($fields as $name => $field) {
3123 $fldName = $isStandalone ?
$name : "field[$componentId][$name]";
3124 if (in_array($name, $dateTimeFields)) {
3125 $timefldName = $isStandalone ?
"{$name}_time" : "field[$componentId][{$name}_time]";
3126 if (CRM_Utils_Array
::value($name, $values)) {
3127 list($defaults[$fldName], $defaults[$timefldName]) = CRM_Utils_Date
::setDateDefaults($values[$name]);
3130 elseif (array_key_exists($name, $values)) {
3131 $defaults[$fldName] = $values[$name];
3133 elseif ($name == 'participant_note') {
3134 $noteDetails = CRM_Core_BAO_Note
::getNote($componentId, 'civicrm_participant');
3135 $defaults[$fldName] = array_pop($noteDetails);
3137 elseif (in_array($name, array(
3138 'financial_type', 'payment_instrument', 'participant_status', 'participant_role'))) {
3139 $defaults[$fldName] = $values["{$name}_id"];
3141 elseif ($name == 'membership_type') {
3142 // since membership_type field is a hierselect -
3143 $defaults[$fldName][0] =
3144 CRM_Core_DAO
::getFieldValue('CRM_Member_DAO_MembershipType',$values['membership_type_id'],'member_of_contact_id','id');
3145 $defaults[$fldName][1] = $values['membership_type_id'];
3147 elseif ($name == 'membership_status') {
3148 $defaults[$fldName] = $values['status_id'];
3150 elseif ($customFieldInfo = CRM_Core_BAO_CustomField
::getKeyID($name, TRUE)) {
3151 if (empty($formattedGroupTree)) {
3152 //get the groupTree as per subTypes.
3153 $groupTree = array();
3154 foreach ($componentSubType as $subType) {
3155 $subTree = CRM_Core_BAO_CustomGroup
::getTree($componentBAOName, CRM_Core_DAO
::$_nullObject,
3156 $componentId, 0, $values[$subType]
3158 $groupTree = CRM_Utils_Array
::crmArrayMerge($groupTree, $subTree);
3160 $formattedGroupTree = CRM_Core_BAO_CustomGroup
::formatGroupTree($groupTree, 1, CRM_Core_DAO
::$_nullObject);
3161 CRM_Core_BAO_CustomGroup
::setDefaults($formattedGroupTree, $defaults);
3164 //FIX ME: We need to loop defaults, but once we move to custom_1_x convention this code can be simplified.
3165 foreach ($defaults as $customKey => $customValue) {
3166 if ($customFieldDetails = CRM_Core_BAO_CustomField
::getKeyID($customKey, TRUE)) {
3167 if ($name == 'custom_' . $customFieldDetails[0]) {
3169 //hack to set default for checkbox
3170 //basically this is for weired field name like field[33][custom_19]
3171 //we are converting this field name to array structure and assign value.
3174 foreach ($formattedGroupTree as $tree) {
3175 if ('CheckBox' == CRM_Utils_Array
::value('html_type', $tree['fields'][$customFieldDetails[0]])) {
3177 $defaults['field'][$componentId][$name] = $customValue;
3180 elseif (CRM_Utils_Array
::value('data_type', $tree['fields'][$customFieldDetails[0]]) == 'Date') {
3183 // CRM-6681, $default contains formatted date, time values.
3184 $defaults[$fldName] = $customValue;
3185 if (CRM_Utils_Array
::value($customKey . '_time', $defaults)) {
3186 $defaults['field'][$componentId][$name . '_time'] = $defaults[$customKey . '_time'];
3191 if (!$skipValue ||
$isStandalone) {
3192 $defaults[$fldName] = $customValue;
3194 unset($defaults[$customKey]);
3204 * Function to retrieve reserved profiles
3206 * @param string $name name if the reserve profile
3207 * @param array $extraProfiles associated array of profile id's that needs to merge
3209 * @return array $reservedProfiles returns associated array
3212 static function getReservedProfiles($type = 'Contact', $extraProfiles = NULL) {
3213 $reservedProfiles = array();
3214 $profileNames = array();
3215 if ($type == 'Contact') {
3216 $whereClause = 'name IN ( "new_individual", "new_organization", "new_household" )';
3217 if (CRM_Contact_BAO_ContactType
::isActive('Individual')) {
3218 $profileNames[] = '"new_individual"';
3220 if (CRM_Contact_BAO_ContactType
::isActive('Household')) {
3221 $profileNames[] = '"new_household"';
3223 if (CRM_Contact_BAO_ContactType
::isActive('Organization')) {
3224 $profileNames[] = '"new_organization"';
3227 if (!empty($profileNames)) {
3228 $whereClause = 'name IN ( ' . implode(',', $profileNames) . ' ) AND is_reserved = 1';
3231 $whereClause = 'is_reserved = 1';
3234 $query = "SELECT id, title FROM civicrm_uf_group WHERE {$whereClause}";
3236 $dao = CRM_Core_DAO
::executeQuery($query);
3237 while ($dao->fetch()) {
3239 if ($extraProfiles) {
3240 $key .= ',' . implode(',', $extraProfiles);
3242 $reservedProfiles[$key] = $dao->title
;
3244 return $reservedProfiles;
3248 * Function to retrieve groups of profiles
3250 * @param integer $profileID id of the profile
3252 * @return array returns array
3255 static function profileGroups($profileID) {
3256 $groupTypes = array();
3257 $profileTypes = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $profileID, 'group_type');
3258 if ($profileTypes) {
3259 $groupTypeParts = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $profileTypes);
3260 $groupTypes = explode(',', $groupTypeParts[0]);
3266 * Function to alter contact params by filtering existing subscribed groups and returns
3267 * unsubscribed groups array for subscription.
3269 * @param array $params contact params
3270 * @param int $contactId user contact id
3272 * @return array $subscribeGroupIds This contains array of groups for subscription
3274 static function getDoubleOptInGroupIds(&$params, $contactId = NULL) {
3275 $config = CRM_Core_Config
::singleton();
3276 $subscribeGroupIds = array();
3278 // process further only if profileDoubleOptIn enabled and if groups exist
3279 if (!array_key_exists('group', $params) ||
3280 !self
::isProfileDoubleOptin() ||
3281 CRM_Utils_System
::isNull($params['group'])
3283 return $subscribeGroupIds;
3286 //check if contact email exist.
3288 foreach ($params as $name => $value) {
3289 if (strpos($name, 'email-') !== FALSE) {
3295 //Proceed furthur only if email present
3297 return $subscribeGroupIds;
3300 //do check for already subscriptions.
3301 $contactGroups = array();
3305 FROM civicrm_group_contact
3306 WHERE status = 'Added'
3307 AND contact_id = %1";
3309 $dao = CRM_Core_DAO
::executeQuery($query, array(1 => array($contactId, 'Integer')));
3310 while ($dao->fetch()) {
3311 $contactGroups[$dao->group_id
] = $dao->group_id
;
3315 //since we don't have names, compare w/ label.
3316 $mailingListGroupType = array_search('Mailing List', CRM_Core_OptionGroup
::values('group_type'));
3318 //actual processing start.
3319 foreach ($params['group'] as $groupId => $isSelected) {
3320 //unset group those are not selected.
3322 unset($params['group'][$groupId]);
3326 $groupTypes = explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
3327 CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $groupId, 'group_type', 'id')
3329 //get only mailing type group and unset it from params
3330 if (in_array($mailingListGroupType, $groupTypes) && !in_array($groupId, $contactGroups)) {
3331 $subscribeGroupIds[$groupId] = $groupId;
3332 unset($params['group'][$groupId]);
3336 return $subscribeGroupIds;
3340 * Function to check if we are rendering mixed profiles
3342 * @param array $profileIds associated array of profile ids
3344 * @return boolean $mixProfile true if profile is mixed
3348 static function checkForMixProfiles($profileIds) {
3349 $mixProfile = FALSE;
3351 $contactTypes = array('Individual', 'Household', 'Organization');
3352 $subTypes = CRM_Contact_BAO_ContactType
::subTypes();
3354 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
3356 $typeCount = array('ctype' => array(), 'subtype' => array());
3357 foreach ($profileIds as $gid) {
3358 $profileType = CRM_Core_BAO_UFField
::getProfileType($gid);
3359 // ignore profile of type Contact
3360 if ($profileType == 'Contact') {
3363 if (in_array($profileType, $contactTypes)) {
3364 if (!isset($typeCount['ctype'][$profileType])) {
3365 $typeCount['ctype'][$profileType] = 1;
3368 // check if we are rendering profile of different contact types
3369 if (count($typeCount['ctype']) == 2) {
3374 elseif (in_array($profileType, $components)) {
3379 if (!isset($typeCount['subtype'][$profileType])) {
3380 $typeCount['subtype'][$profileType] = 1;
3382 // check if we are rendering profile of different contact sub types
3383 if (count($typeCount['subtype']) == 2) {
3393 * Funtion to determine of we show overlay profile or not
3395 * @return boolean true if profile should be shown else false
3399 static function showOverlayProfile() {
3400 $showOverlay = TRUE;
3402 // get the id of overlay profile
3403 $overlayProfileId = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', 'summary_overlay', 'id', 'name');
3404 $query = "SELECT count(id) FROM civicrm_uf_field WHERE uf_group_id = {$overlayProfileId} AND visibility IN ('Public Pages', 'Public Pages and Listings') ";
3406 $count = CRM_Core_DAO
::singleValueQuery($query);
3408 //check if there are no public fields and use is anonymous
3409 $session = CRM_Core_Session
::singleton();
3410 if (!$count && !$session->get('userID')) {
3411 $showOverlay = FALSE;
3414 return $showOverlay;
3418 * function to get group type values of the profile
3420 * @params Integer $profileId Profile Id
3421 * @params String $groupType Group Type
3423 * @return Array group type values
3427 static function groupTypeValues($profileId, $groupType = NULL) {
3428 $groupTypeValue = array();
3429 $groupTypes = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $profileId, 'group_type');
3431 $groupTypeParts = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $groupTypes);
3432 if (!CRM_Utils_Array
::value(1, $groupTypeParts)) {
3433 return $groupTypeValue;
3435 $participantExtends = array('ParticipantRole', 'ParticipantEventName', 'ParticipantEventType');
3437 foreach (explode(',', $groupTypeParts[1]) as $groupTypeValues) {
3439 $valueParts = explode(':', $groupTypeValues);
3441 ($valueParts[0] != "{$groupType}Type" ||
3442 ($groupType == 'Participant' &&
3443 !in_array($valueParts[0], $participantExtends)
3449 foreach ($valueParts as $val) {
3450 if (CRM_Utils_Rule
::integer($val)) {
3451 $values[$val] = $val;
3454 if (!empty($values)) {
3455 $typeName = substr($valueParts[0], 0, -4);
3456 if (in_array($valueParts[0], $participantExtends)) {
3457 $typeName = $valueParts[0];
3459 $groupTypeValue[$typeName] = $values;
3463 return $groupTypeValue;
3466 static function isProfileDoubleOptin() {
3467 // check for double optin
3468 $config = CRM_Core_Config
::singleton();
3469 if (in_array('CiviMail', $config->enableComponents
)) {
3470 return CRM_Core_BAO_Setting
::getItem(CRM_Core_BAO_Setting
::MAILING_PREFERENCES_NAME
,
3471 'profile_double_optin', NULL, FALSE
3477 static function isProfileAddToGroupDoubleOptin() {
3478 // check for add to group double optin
3479 $config = CRM_Core_Config
::singleton();
3480 if (in_array('CiviMail', $config->enableComponents
)) {
3481 return CRM_Core_BAO_Setting
::getItem(CRM_Core_BAO_Setting
::MAILING_PREFERENCES_NAME
,
3482 'profile_add_to_group_double_optin', NULL, FALSE
3489 * get profiles used for batch entry
3491 * @return array profileIds profile ids
3494 static function getBatchProfiles() {
3496 FROM civicrm_uf_group
3497 WHERE name IN ('contribution_batch_entry', 'membership_batch_entry')";
3498 $dao = CRM_Core_DAO
::executeQuery( $query );
3499 $profileIds = array();
3500 while( $dao->fetch() ) {
3501 $profileIds[$dao->id
] = $dao->id
;
3506 static function shiftMultiRecordFields(&$source, &$destination, $returnMultiSummaryFields = FALSE) {
3507 $multiSummaryFields = $returnMultiSummaryFields ?
array( ) : NULL;
3508 foreach ($source as $field => $properties) {
3509 if (!CRM_Core_BAO_CustomField
::getKeyID($field)) {
3512 if (CRM_Core_BAO_CustomField
::isMultiRecordField($field)) {
3513 $destination[$field] = $properties;
3514 if ($returnMultiSummaryFields) {
3515 if ($properties['is_multi_summary']) {
3516 $multiSummaryFields[$field] = $properties;
3519 unset($source[$field]);
3522 return $multiSummaryFields;
3526 * This is function is used to format pseudo fields
3528 * @param array $fields associated array of profile fields
3532 static function reformatProfileFields(&$fields) {
3533 //reformat fields array
3534 foreach ($fields as $name => $field) {
3535 //reformat phone and extension field
3536 if ( substr($field['name'], 0, 13) == 'phone_and_ext') {
3537 $fieldSuffix = str_replace('phone_and_ext-', '', $field['name']);
3539 // retain existing element properties and just update and replace key
3540 CRM_Utils_Array
::crmReplaceKey($fields, $name, "phone-{$fieldSuffix}");
3541 $fields["phone-{$fieldSuffix}"]['name'] = "phone-{$fieldSuffix}";
3542 $fields["phone-{$fieldSuffix}"]['where'] = 'civicrm_phone.phone';
3544 // add additional phone extension field
3545 $fields["phone_ext-{$fieldSuffix}"] = $field;
3546 $fields["phone_ext-{$fieldSuffix}"]['title'] = $field['title'] .' - '.ts('Ext.');
3547 $fields["phone_ext-{$fieldSuffix}"]['name'] = "phone_ext-{$fieldSuffix}";
3548 $fields["phone_ext-{$fieldSuffix}"]['where'] = 'civicrm_phone.phone_ext';
3549 $fields["phone_ext-{$fieldSuffix}"]['skipDisplay'] = 1;
3550 //ignore required for extension field
3551 $fields["phone_ext-{$fieldSuffix}"]['is_required'] = 0;