3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.5 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
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-2014
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
136 * @return array the fields that are needed for registration
140 static function getRegistrationFields($action, $mode, $ctype = NULL) {
141 if ($mode & CRM_Profile_Form
::MODE_REGISTER
) {
142 $ufGroups = CRM_Core_BAO_UFGroup
::getModuleUFGroup('User Registration');
145 $ufGroups = CRM_Core_BAO_UFGroup
::getModuleUFGroup('Profile');
148 if (!is_array($ufGroups)) {
154 foreach ($ufGroups as $id => $title) {
156 $fieldType = CRM_Core_BAO_UFField
::getProfileType($id);
157 if (($fieldType != 'Contact') &&
158 ($fieldType != $ctype) &&
159 !CRM_Contact_BAO_ContactType
::isExtendsContactType($fieldType, $ctype)
163 if (CRM_Contact_BAO_ContactType
::isaSubType($fieldType)) {
164 $profileSubType = $fieldType;
168 $subset = self
::getFields($id, TRUE, $action,
169 NULL, NULL, FALSE, NULL, TRUE, $ctype
172 // we do not allow duplicates. the first field is the winner
173 foreach ($subset as $name => $field) {
174 if (empty($fields[$name])) {
175 $fields[$name] = $field;
184 * get all the listing fields
186 * @param int $action what action are we doing
187 * @param int $visibility visibility of fields we are interested in
188 * @param bool $considerSelector whether to consider the in_selector parameter
189 * @param array $ufGroupIds
190 * @param boolean $searchable
192 * @param null $restrict
193 * @param bool $skipPermission
194 * @param int $permissionType
195 * @return array the fields that are listings related
199 static function getListingFields(
202 $considerSelector = FALSE,
206 $skipPermission = FALSE,
207 $permissionType = CRM_Core_Permission
::SEARCH
210 $subset = self
::getFields($ufGroupIds, FALSE, $action,
211 $visibility, $searchable,
217 if ($considerSelector) {
218 // drop the fields not meant for the selector
219 foreach ($subset as $name => $field) {
220 if (!$field['in_selector']) {
221 unset($subset[$name]);
228 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
231 foreach ($ufGroups as $id => $title) {
232 $subset = self
::getFields($id, FALSE, $action,
233 $visibility, $searchable,
239 if ($considerSelector) {
240 // drop the fields not meant for the selector
241 foreach ($subset as $name => $field) {
242 if (!$field['in_selector'])unset($subset[$name]);
245 $fields = array_merge($fields, $subset);
252 * Get all the fields that belong to the group with the name title,
253 * and format for use with buildProfile. This is the SQL analog of
256 * @param mix $id the id of the UF group or ids of ufgroup
257 * @param bool|int $register are we interested in registration fields
258 * @param int $action what action are we doing
259 * @param int $visibility visibility of fields we are interested in
261 * @param bool $showAll
262 * @param string $restrict should we restrict based on a specified profile type
264 * @param bool $skipPermission
266 * @param int $permissionType
267 * @param string $orderBy
268 * @param null $orderProfiles
270 * @internal param bool $showall
271 * @return array the fields that belong to this ufgroup(s)
275 static function getFields(
283 $skipPermission = FALSE,
285 $permissionType = CRM_Core_Permission
::CREATE
,
286 $orderBy = 'field_name',
287 $orderProfiles = NULL
289 if (!is_array($id)) {
290 $id = CRM_Utils_Type
::escape($id, 'Positive');
291 $profileIds = array($id);
297 $gids = implode(',', $profileIds);
300 $query = "SELECT g.* from civicrm_uf_group g
301 LEFT JOIN civicrm_uf_join j ON (j.uf_group_id = g.id)
302 WHERE g.id IN ( {$gids} )
303 AND ((j.uf_group_id IN ( {$gids} ) AND j.module = %1) OR g.is_reserved = 1 )
305 $params = array(1 => array($restrict, 'String'));
308 $query = "SELECT g.* from civicrm_uf_group g WHERE g.id IN ( {$gids} ) ";
312 $query .= " AND g.is_active = 1";
315 // add permissioning for profiles only if not registration
316 if (!$skipPermission) {
317 $permissionClause = CRM_Core_Permission
::ufGroupClause($permissionType, 'g.');
318 $query .= " AND $permissionClause ";
321 if ($orderProfiles AND count($profileIds) > 1) {
322 $query .= " ORDER BY FIELD( g.id, {$gids} )";
324 $group = CRM_Core_DAO
::executeQuery($query, $params);
328 while ($group->fetch()) {
330 $query = self
::createUFFieldQuery($group->id
, $searchable, $showAll, $visibility, $orderBy);
331 $field = CRM_Core_DAO
::executeQuery($query);
333 $profileType = CRM_Core_BAO_UFField
::getProfileType($group->id
);
334 $contactActivityProfile = CRM_Core_BAO_UFField
::checkContactActivityProfileType($group->id
);
335 $importableFields = self
::getImportableFields($showAll, $profileType, $contactActivityProfile);
336 list($customFields, $addressCustomFields) = self
::getCustomFields($ctype);
338 while ($field->fetch()) {
339 list($name, $formattedField) = self
::formatUFField($group, $field, $customFields, $addressCustomFields, $importableFields, $permissionType);
340 if ($formattedField !== NULL) {
341 $fields[$name] = $formattedField;
347 if (empty($fields) && !$validGroup) {
348 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.',
349 array(1 => implode(',', $profileIds))
353 self
::reformatProfileFields($fields);
360 * Format a list of UFFields for use with buildProfile. This is the in-memory analog
363 * @param array $groupArr (mimic CRM_UF_DAO_UFGroup)
364 * @param array $fieldArrs list of fields (each mimics CRM_UF_DAO_UFField)
365 * @param bool $visibility visibility of fields we are interested in
366 * @param bool $searchable
367 * @param bool $showAll
369 * @param int $permissionType
371 * @internal param bool $showall
375 public static function formatUFFields(
382 $permissionType = CRM_Core_Permission
::CREATE
384 // $group = new CRM_Core_DAO_UFGroup();
385 // $group->copyValues($groupArr); // no... converts string('') to string('null')
386 $group = (object) $groupArr;
388 // Refactoring note: The $fieldArrs here may be slightly different than the $ufFields
389 // used by calculateGroupType, but I don't think the missing fields matter, and -- if
390 // they did -- the obvious fix would produce mutual recursion.
391 $ufGroupType = self
::_calculateGroupType($fieldArrs);
392 $profileType = CRM_Core_BAO_UFField
::calculateProfileType(implode(',',$ufGroupType));
393 $contactActivityProfile = CRM_Core_BAO_UFField
::checkContactActivityProfileTypeByGroupType(implode(',',$ufGroupType));
394 $importableFields = self
::getImportableFields($showAll, $profileType, $contactActivityProfile);
395 list($customFields, $addressCustomFields) = self
::getCustomFields($ctype);
397 $formattedFields = array();
398 foreach ($fieldArrs as $fieldArr) {
399 $field = (object) $fieldArr;
400 if (!self
::filterUFField($field, $searchable, $showAll, $visibility)) {
404 list($name, $formattedField) = self
::formatUFField($group, $field, $customFields, $addressCustomFields, $importableFields, $permissionType);
405 if ($formattedField !== NULL) {
406 $formattedFields[$name] = $formattedField;
409 return $formattedFields;
413 * Prepare a field for rendering with CRM_Core_BAO_UFGroup::buildProfile.
415 * @param CRM_Core_DAO_UFGroup|CRM_Core_DAO $group
416 * @param CRM_Core_DAO_UFField|CRM_Core_DAO $field
417 * @param array $addressCustomFields
418 * @param array $importableFields
419 * @param array $customFields
420 * @param int $permissionType eg CRM_Core_Permission::CREATE
423 protected static function formatUFField(
427 $addressCustomFields,
429 $permissionType = CRM_Core_Permission
::CREATE
431 $name = $field->field_name
;
432 $title = $field->label
;
434 $addressCustom = FALSE;
435 if (in_array($permissionType, array(
436 CRM_Core_Permission
::CREATE
,
437 CRM_Core_Permission
::EDIT
,
439 in_array($field->field_name
, array_keys($addressCustomFields))
441 $addressCustom = TRUE;
442 $name = "address_{$name}";
444 if ($field->field_name
== 'url') {
445 $name .= "-{$field->website_type_id}";
447 elseif (!empty($field->location_type_id
)) {
448 $name .= "-{$field->location_type_id}";
451 $locationFields = self
::getLocationFields();
452 if (in_array($field->field_name
, $locationFields) ||
$addressCustom) {
457 if (isset($field->phone_type_id
)) {
458 $name .= "-{$field->phone_type_id}";
461 // No lie: this is bizarre; why do we need to mix so many UFGroup properties into UFFields?
462 // I guess to make field self sufficient with all the required data and avoid additional calls
463 $formattedField = array(
465 'groupTitle' => $group->title
,
466 'groupName' => $group->name
,
467 'groupHelpPre' => empty($group->help_pre
) ?
'' : $group->help_pre
,
468 'groupHelpPost' => empty($group->help_post
) ?
'' : $group->help_post
,
470 'where' => CRM_Utils_Array
::value('where', CRM_Utils_Array
::value($field->field_name
, $importableFields)),
471 'attributes' => CRM_Core_DAO
::makeAttribute(CRM_Utils_Array
::value($field->field_name
, $importableFields)),
472 'is_required' => $field->is_required
,
473 'is_view' => $field->is_view
,
474 'help_pre' => $field->help_pre
,
475 'help_post' => $field->help_post
,
476 'visibility' => $field->visibility
,
477 'in_selector' => $field->in_selector
,
478 'rule' => CRM_Utils_Array
::value('rule', CRM_Utils_Array
::value($field->field_name
, $importableFields)),
479 'location_type_id' => isset($field->location_type_id
) ?
$field->location_type_id
: NULL,
480 'website_type_id' => isset($field->website_type_id
) ?
$field->website_type_id
: NULL,
481 'phone_type_id' => isset($field->phone_type_id
) ?
$field->phone_type_id
: NULL,
482 'group_id' => $group->id
,
483 'add_to_group_id' => isset($group->add_to_group_id
) ?
$group->add_to_group_id
: NULL,
484 'add_captcha' => isset($group->add_captcha
) ?
$group->add_captcha
: NULL,
485 'field_type' => $field->field_type
,
486 'field_id' => $field->id
,
487 'pseudoconstant' => CRM_Utils_Array
::value(
489 CRM_Utils_Array
::value($field->field_name
, $importableFields)
491 // obsolete this when we remove the name / dbName discrepancy with gender/suffix/prefix
492 'dbName' => CRM_Utils_Array
::value(
494 CRM_Utils_Array
::value($field->field_name
, $importableFields)
499 //adding custom field property
500 if (substr($field->field_name
, 0, 6) == 'custom' ||
501 substr($field->field_name
, 0, 14) === 'address_custom'
503 // if field is not present in customFields, that means the user
504 // DOES NOT HAVE permission to access that field
505 if (array_key_exists($field->field_name
, $customFields)) {
506 $formattedField['is_search_range'] = $customFields[$field->field_name
]['is_search_range'];
508 $formattedField['options_per_line'] = $customFields[$field->field_name
]['options_per_line'];
509 $formattedField['data_type'] = $customFields[$field->field_name
]['data_type'];
510 $formattedField['html_type'] = $customFields[$field->field_name
]['html_type'];
512 if (CRM_Utils_Array
::value('html_type', $formattedField) == 'Select Date') {
513 $formattedField['date_format'] = $customFields[$field->field_name
]['date_format'];
514 $formattedField['time_format'] = $customFields[$field->field_name
]['time_format'];
517 $formattedField['is_multi_summary'] = $field->is_multi_summary
;
518 return array($name, $formattedField);
521 $formattedField = NULL;
522 return array($name, $formattedField);
525 return array($name, $formattedField);
529 * Create a query to find all visible UFFields in a UFGroup
531 * This is the SQL-variant of checkUFFieldDisplayable().
533 * @param int $groupId
534 * @param bool $searchable
535 * @param bool $showAll
536 * @param int $visibility
537 * @param string $orderBy comma-delimited list of SQL columns
540 protected static function createUFFieldQuery($groupId, $searchable, $showAll, $visibility, $orderBy) {
541 $where = " WHERE uf_group_id = {$groupId}";
544 $where .= " AND is_searchable = 1";
548 $where .= " AND is_active = 1";
553 if ($visibility & self
::PUBLIC_VISIBILITY
) {
554 $clause[] = 'visibility = "Public Pages"';
556 if ($visibility & self
::ADMIN_VISIBILITY
) {
557 $clause[] = 'visibility = "User and User Admin Only"';
559 if ($visibility & self
::LISTINGS_VISIBILITY
) {
560 $clause[] = 'visibility = "Public Pages and Listings"';
562 if (!empty($clause)) {
563 $where .= ' AND ( ' . implode(' OR ', $clause) . ' ) ';
567 $query = "SELECT * FROM civicrm_uf_field $where ORDER BY weight";
569 $query .= ", " . $orderBy;
576 * Create a query to find all visible UFFields in a UFGroup
578 * This is the PHP in-memory variant of createUFFieldQuery().
580 * @param CRM_Core_DAO_UFField|CRM_Core_DAO $field
581 * @param bool $searchable
582 * @param bool $showAll
583 * @param int $visibility
584 * @return bool TRUE if field is displayable
586 protected static function filterUFField($field, $searchable, $showAll, $visibility) {
587 if ($searchable && $field->is_searchable
!= 1) {
591 if (!$showAll && $field->is_active
!= 1) {
596 $allowedVisibilities = array();
597 if ($visibility & self
::PUBLIC_VISIBILITY
) {
598 $allowedVisibilities[] = 'Public Pages';
600 if ($visibility & self
::ADMIN_VISIBILITY
) {
601 $allowedVisibilities[] = 'User and User Admin Only';
603 if ($visibility & self
::LISTINGS_VISIBILITY
) {
604 $allowedVisibilities[] = 'Public Pages and Listings';
606 // !empty($allowedVisibilities) seems silly to me, but it is equivalent to the pre-existing SQL
607 if (!empty($allowedVisibilities) && !in_array($field->visibility
, $allowedVisibilities)) {
617 * @param $profileType
618 * @param $contactActivityProfile
622 protected static function getImportableFields($showAll, $profileType, $contactActivityProfile) {
624 $importableFields = CRM_Contact_BAO_Contact
::importableFields('All', FALSE, FALSE, FALSE, TRUE, TRUE);
627 $importableFields = CRM_Contact_BAO_Contact
::importableFields('All', FALSE, TRUE, FALSE, TRUE, TRUE);
630 if ($profileType == 'Activity' ||
$contactActivityProfile) {
631 $componentFields = CRM_Activity_BAO_Activity
::getProfileFields();
634 $componentFields = CRM_Core_Component
::getQueryFields();
637 $importableFields = array_merge($importableFields, $componentFields);
639 $importableFields['group']['title'] = ts('Group(s)');
640 $importableFields['group']['where'] = NULL;
641 $importableFields['tag']['title'] = ts('Tag(s)');
642 $importableFields['tag']['where'] = NULL;
643 return $importableFields;
646 public static function getLocationFields() {
647 static $locationFields = array(
649 'supplemental_address_1',
650 'supplemental_address_2',
653 'postal_code_suffix',
666 return $locationFields;
674 protected static function getCustomFields($ctype) {
675 static $customFieldCache = array();
676 if (!isset($customFieldCache[$ctype])) {
677 $customFields = CRM_Core_BAO_CustomField
::getFieldsForImport($ctype, FALSE, FALSE, FALSE, TRUE, TRUE);
679 // hack to add custom data for components
680 $components = array('Contribution', 'Participant', 'Membership', 'Activity', 'Case');
681 foreach ($components as $value) {
682 $customFields = array_merge($customFields, CRM_Core_BAO_CustomField
::getFieldsForImport($value));
684 $addressCustomFields = CRM_Core_BAO_CustomField
::getFieldsForImport('Address');
685 $customFields = array_merge($customFields, $addressCustomFields);
686 $customFieldCache[$ctype] = array($customFields, $addressCustomFields);
688 return $customFieldCache[$ctype];
692 * check the data validity
694 * @param int $userID the user id that we are actually editing
695 * @param string $title the title of the group we are interested in
696 * @param bool $register
697 * @param int $action the action of the form
699 * @pram boolean $register is this the registrtion form
700 * @return boolean true if form is valid
704 static function isValid($userID, $title, $register = FALSE, $action = NULL) {
706 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
707 ts('Dynamic Form Creator'),
710 $controller->set('id', $userID);
711 $controller->set('register', 1);
712 $controller->process();
713 return $controller->validate();
716 // make sure we have a valid group
717 $group = new CRM_Core_DAO_UFGroup();
719 $group->title
= $title;
721 if ($group->find(TRUE) && $userID) {
722 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic', ts('Dynamic Form Creator'), $action);
723 $controller->set('gid', $group->id
);
724 $controller->set('id', $userID);
725 $controller->set('register', 0);
726 $controller->process();
727 return $controller->validate();
734 * get the html for the form that represents this particular group
736 * @param int $userID the user id that we are actually editing
737 * @param string $title the title of the group we are interested in
738 * @param int $action the action of the form
739 * @param boolean $register is this the registration form
740 * @param boolean $reset should we reset the form?
741 * @param int $profileID do we have the profile ID?
743 * @param bool $doNotProcess
746 * @return string the html for the form on success, otherwise empty string
750 static function getEditHTML($userID,
756 $doNotProcess = FALSE,
761 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
762 ts('Dynamic Form Creator'),
765 if ($reset ||
$doNotProcess) {
766 // hack to make sure we do not process this form
767 $oldQFDefault = CRM_Utils_Array
::value('_qf_default',
770 unset($_POST['_qf_default']);
771 unset($_REQUEST['_qf_default']);
773 $controller->reset();
777 $controller->set('id', $userID);
778 $controller->set('register', 1);
779 $controller->set('skipPermission', 1);
780 $controller->set('ctype', $ctype);
781 $controller->process();
782 if ($doNotProcess ||
!empty($_POST)) {
783 $controller->validate();
785 $controller->setEmbedded(TRUE);
787 //CRM-5839 - though we want to process form, get the control back.
788 $controller->setSkipRedirection(($doNotProcess) ?
FALSE : TRUE);
792 // we are done processing so restore the POST/REQUEST vars
793 if (($reset ||
$doNotProcess) && $oldQFDefault) {
794 $_POST['_qf_default'] = $_REQUEST['_qf_default'] = $oldQFDefault;
797 $template = CRM_Core_Smarty
::singleton();
799 // Hide CRM error messages if they are displayed using drupal form_set_error.
800 if (!empty($_POST)) {
801 $template->assign('suppressForm', TRUE);
804 return trim($template->fetch('CRM/Profile/Form/Dynamic.tpl'));
808 // make sure we have a valid group
809 $group = new CRM_Core_DAO_UFGroup();
811 $group->title
= $title;
813 if ($group->find(TRUE)) {
814 $profileID = $group->id
;
819 // make sure profileID and ctype match if ctype exists
821 $profileType = CRM_Core_BAO_UFField
::getProfileType($profileID);
822 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
823 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
826 if (($profileType != 'Contact') && ($profileType != $ctype)) {
831 $controller = new CRM_Core_Controller_Simple('CRM_Profile_Form_Dynamic',
832 ts('Dynamic Form Creator'),
836 $controller->reset();
838 $controller->set('gid', $profileID);
839 $controller->set('id', $userID);
840 $controller->set('register', 0);
841 $controller->set('skipPermission', 1);
843 $controller->set('ctype', $ctype);
845 $controller->process();
846 $controller->setEmbedded(TRUE);
848 //CRM-5846 - give the control back to drupal.
849 $controller->setSkipRedirection(($doNotProcess) ?
FALSE : TRUE);
852 $template = CRM_Core_Smarty
::singleton();
854 // Hide CRM error messages if they are displayed using drupal form_set_error.
855 if (!empty($_POST) && CRM_Core_Config
::singleton()->userFramework
== 'Drupal') {
856 if (arg(0) == 'user' ||
(arg(0) == 'admin' && arg(1) == 'people')) {
857 $template->assign('suppressForm', TRUE);
861 $templateFile = "CRM/Profile/Form/{$profileID}/Dynamic.tpl";
862 if (!$template->template_exists($templateFile)) {
863 $templateFile = 'CRM/Profile/Form/Dynamic.tpl';
865 return trim($template->fetch($templateFile));
868 $userEmail = CRM_Contact_BAO_Contact_Location
::getEmailDetails($userID);
870 // if post not empty then only proceed
871 if (!empty($_POST)) {
873 $config = CRM_Core_Config
::singleton();
874 $email = CRM_Utils_Array
::value('mail', $_POST);
876 if (CRM_Utils_Rule
::email($email) && ($email != $userEmail[1])) {
877 CRM_Core_BAO_UFMatch
::updateContactEmail($userID, $email);
886 * searches for a contact in the db with similar attributes
888 * @param array $params the list of values to be used in the where clause
889 * @param int $id the current contact id (hence excluded from matching)
890 * @param string $contactType
892 * @internal param bool $flatten should we flatten the input params
894 * @return contact_id if found, null otherwise
898 public static function findContact(&$params, $id = NULL, $contactType = 'Individual') {
899 $dedupeParams = CRM_Dedupe_Finder
::formatParams($params, $contactType);
900 $dedupeParams['check_permission'] = CRM_Utils_Array
::value('check_permission', $params, TRUE);
901 $ids = CRM_Dedupe_Finder
::dupesByParams($dedupeParams, $contactType, 'Supervised', array($id));
903 return implode(',', $ids);
911 * Given a contact id and a field set, return the values from the db
915 * @param array $fields the profile fields of interest
916 * @param array $values the values for the above fields
917 * @param boolean $searchable searchable or not
918 * @param array $componentWhere component condition
919 * @param boolean $absolute return urls in absolute form (useful when sending an email)
921 * @param null $additionalWhereClause
923 * @internal param int $id the contact id
928 public static function getValues($cid, &$fields, &$values,
929 $searchable = TRUE, $componentWhere = NULL,
930 $absolute = FALSE, $additionalWhereClause = NULL
932 if (empty($cid) && empty($componentWhere)) {
936 // get the contact details (hier)
937 $returnProperties = CRM_Contact_BAO_Contact
::makeHierReturnProperties($fields);
938 $params = $cid ?
array(array('contact_id', '=', $cid, 0, 0)) : array();
940 // add conditions specified by components. eg partcipant_id etc
941 if (!empty($componentWhere)) {
942 $params = array_merge($params, $componentWhere);
945 $query = new CRM_Contact_BAO_Query($params, $returnProperties, $fields);
946 $options = &$query->_options
;
948 $details = $query->searchQuery( 0, 0, NULL, FALSE, FALSE,
949 FALSE, FALSE, FALSE, $additionalWhereClause);
950 if (!$details->fetch()) {
953 $query->convertToPseudoNames($details);
954 $config = CRM_Core_Config
::singleton();
956 $locationTypes = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Address', 'location_type_id');
957 $imProviders = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id');
958 $websiteTypes = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Website', 'website_type_id');
960 $multipleFields = array('url');
962 //start of code to set the default values
963 foreach ($fields as $name => $field) {
966 $name = 'contact_id';
969 // skip fields that should not be displayed separately
970 if (!empty($field['skipDisplay'])) {
974 // Create a unique, non-empty index for each field.
975 $index = $field['title'];
976 if ($index === '') $index = ' ';
977 while (array_key_exists($index, $values))
980 $params[$index] = $values[$index] = '';
981 $customFieldName = NULL;
983 if (isset($details->$name) ||
$name == 'group' ||
$name == 'tag') {
984 // to handle gender / suffix / prefix
985 if (in_array(substr($name, 0, -3), array('gender', 'prefix', 'suffix'))) {
986 $params[$index] = $details->$name;
987 $values[$index] = $details->$name;
989 elseif (in_array($name, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
990 $dname = $name . '_display';
991 $values[$index] = $details->$dname;
992 $name = $name . '_id';
993 $params[$index] = $details->$name;
995 elseif (in_array($name, array(
996 'state_province', 'country', 'county'))) {
997 $values[$index] = $details->$name;
998 $idx = $name . '_id';
999 $params[$index] = $details->$idx;
1001 elseif ($name === 'preferred_communication_method') {
1002 $communicationFields = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'preferred_communication_method');
1004 $pref = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details->$name);
1006 foreach ($pref as $k) {
1008 $compref[] = $communicationFields[$k];
1011 $params[$index] = $details->$name;
1012 $values[$index] = implode(',', $compref);
1014 elseif ($name === 'preferred_language') {
1015 $params[$index] = $details->$name;
1016 $values[$index] = CRM_Core_PseudoConstant
::getLabel('CRM_Contact_DAO_Contact', 'preferred_language', $details->$name);
1018 elseif ($name == 'group') {
1019 $groups = CRM_Contact_BAO_GroupContact
::getContactGroup($cid, 'Added', NULL, FALSE, TRUE);
1020 $title = $ids = array();
1022 foreach ($groups as $g) {
1023 // CRM-8362: User and User Admin visibility groups should be included in display if user has
1024 // VIEW permission on that group
1025 $groupPerm = CRM_Contact_BAO_Group
::checkPermission($g['group_id'], $g['title']);
1027 if ($g['visibility'] != 'User and User Admin Only' ||
1028 CRM_Utils_Array
::key(CRM_Core_Permission
::VIEW
, $groupPerm)
1030 $title[] = $g['title'];
1031 if ($g['visibility'] == 'Public Pages') {
1032 $ids[] = $g['group_id'];
1036 $values[$index] = implode(', ', $title);
1037 $params[$index] = implode(',', $ids);
1039 elseif ($name == 'tag') {
1040 $entityTags = CRM_Core_BAO_EntityTag
::getTag($cid);
1041 $allTags = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_EntityTag', 'tag_id', array('onlyActive' => FALSE));
1043 foreach ($entityTags as $tagId) {
1044 $title[] = $allTags[$tagId];
1046 $values[$index] = implode(', ', $title);
1047 $params[$index] = implode(',', $entityTags);
1049 elseif ($name == 'activity_status_id') {
1050 $activityStatus = CRM_Core_PseudoConstant
::activityStatus();
1051 $values[$index] = $activityStatus[$details->$name];
1052 $params[$index] = $details->$name;
1054 elseif ($name == 'activity_date_time') {
1055 $values[$index] = CRM_Utils_Date
::customFormat($details->$name);
1056 $params[$index] = $details->$name;
1058 elseif ($name == 'contact_sub_type') {
1059 $contactSubTypeNames = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details->$name);
1060 if (!empty($contactSubTypeNames)) {
1061 $contactSubTypeLabels = array();
1062 // get all contact subtypes
1063 $allContactSubTypes = CRM_Contact_BAO_ContactType
::subTypeInfo();
1064 // build contact subtype labels array
1065 foreach( $contactSubTypeNames as $cstName ) {
1067 $contactSubTypeLabels[] = $allContactSubTypes[$cstName]['label'];
1070 $values[$index] = implode(',', $contactSubTypeLabels);
1073 $params[$index] = $details->$name;
1076 if (substr($name, 0, 7) === 'do_not_' ||
substr($name, 0, 3) === 'is_') {
1077 if ($details->$name) {
1078 $values[$index] = '[ x ]';
1082 if ($cfID = CRM_Core_BAO_CustomField
::getKeyID($name)) {
1083 $htmlType = $field['html_type'];
1085 // field_type is only set when we are retrieving profile values
1086 // when sending email, we call the same function to get custom field
1087 // values etc, i.e. emulating a profile
1088 $fieldType = CRM_Utils_Array
::value('field_type', $field);
1090 if ($htmlType == 'File') {
1093 $fieldType == 'Activity' && !empty($componentWhere[0][2])) {
1094 $entityId = $componentWhere[0][2];
1097 $fileURL = CRM_Core_BAO_CustomField
::getFileURL($entityId,
1102 $params[$index] = $values[$index] = $fileURL['file_url'];
1106 if (isset($dao) && property_exists($dao, 'data_type') &&
1107 ($dao->data_type
== 'Int' ||
1108 $dao->data_type
== 'Boolean'
1111 $customVal = (int )($details->{$name});
1113 elseif (isset($dao) && property_exists($dao, 'data_type')
1114 && $dao->data_type
== 'Float'
1116 $customVal = (float )($details->{$name});
1118 elseif (!CRM_Utils_System
::isNull(explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
1121 $customVal = $details->{$name};
1125 if (CRM_Utils_System
::isNull($customVal)) {
1129 $params[$index] = $customVal;
1130 $values[$index] = CRM_Core_BAO_CustomField
::getDisplayValue($customVal,
1134 if ($field['data_type'] == 'ContactReference') {
1135 $params[$index] = $values[$index];
1137 if (CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_CustomField',
1138 $cfID, 'is_search_range'
1140 $customFieldName = "{$name}_from";
1144 elseif ($name == 'image_URL') {
1145 list($width, $height) = getimagesize(CRM_Utils_String
::unstupifyUrl($details->$name));
1146 list($thumbWidth, $thumbHeight) = CRM_Contact_BAO_Contact
::getThumbSize($width, $height);
1148 $image_URL = '<img src="' . $details->$name . '" height= ' . $thumbHeight . ' width= ' . $thumbWidth . ' />';
1149 $values[$index] = "<a href='#' onclick='contactImagePopUp(\"{$details->$name}\", {$width}, {$height});'>{$image_URL}</a>";
1151 elseif (in_array($name, array(
1152 'birth_date', 'deceased_date', 'membership_start_date', 'membership_end_date', 'join_date'))) {
1153 $values[$index] = CRM_Utils_Date
::customFormat($details->$name);
1154 $params[$index] = CRM_Utils_Date
::isoToMysql($details->$name);
1158 if ($index == 'Campaign') {
1159 $dao = 'CRM_Campaign_DAO_Campaign';
1161 elseif ($index == 'Contribution Page') {
1162 $dao = 'CRM_Contribute_DAO_ContributionPage';
1165 $value = CRM_Core_DAO
::getFieldValue($dao, $details->$name, 'title');
1168 $value = $details->$name;
1170 $values[$index] = $value;
1175 elseif (strpos($name, '-') !== FALSE) {
1176 list($fieldName, $id, $type) = CRM_Utils_System
::explode('-', $name, 3);
1178 if (!in_array($fieldName, $multipleFields)) {
1179 if ($id == 'Primary') {
1181 // not sure why we'd every use Primary location type id
1182 // we need to fix the source if we are using it
1183 // $locationTypeName = CRM_Contact_BAO_Contact::getPrimaryLocationType( $cid );
1184 $locationTypeName = 1;
1187 $locationTypeName = CRM_Utils_Array
::value($id, $locationTypes);
1190 if (!$locationTypeName) {
1194 $detailName = "{$locationTypeName}-{$fieldName}";
1195 $detailName = str_replace(' ', '_', $detailName);
1197 if (in_array($fieldName, array(
1198 'phone', 'im', 'email', 'openid'))) {
1200 $detailName .= "-{$type}";
1204 if (in_array($fieldName, array(
1205 'state_province', 'country', 'county'))) {
1206 $values[$index] = $details->$detailName;
1207 $idx = $detailName . '_id';
1208 $params[$index] = $details->$idx;
1210 elseif ($fieldName == 'im') {
1211 $providerId = $detailName . '-provider_id';
1212 if (isset($imProviders[$details->$providerId])) {
1213 $values[$index] = $details->$detailName . " (" . $imProviders[$details->$providerId] . ")";
1216 $values[$index] = $details->$detailName;
1218 $params[$index] = $details->$detailName;
1220 elseif ($fieldName == 'phone') {
1221 $phoneExtField = str_replace('phone', 'phone_ext', $detailName);
1222 if (isset($details->$phoneExtField)) {
1223 $values[$index] = $details->$detailName . " (" . $details->$phoneExtField . ")";
1226 $values[$index] = $details->$detailName;
1228 $params[$index] = $details->$detailName;
1231 $values[$index] = $params[$index] = $details->$detailName;
1235 $detailName = "website-{$id}-{$fieldName}";
1236 $url = CRM_Utils_System
::fixURL($details->$detailName);
1237 if ($details->$detailName) {
1238 $websiteTypeId = "website-{$id}-website_type_id";
1239 $websiteType = $websiteTypes[$details->$websiteTypeId];
1240 $values[$index] = "<a href=\"$url\">{$details->$detailName} ( {$websiteType} )</a>";
1243 $values[$index] = '';
1248 if ((CRM_Utils_Array
::value('visibility', $field) == 'Public Pages and Listings') &&
1249 CRM_Core_Permission
::check('profile listings and forms')
1252 if (CRM_Utils_System
::isNull($params[$index])) {
1253 $params[$index] = $values[$index];
1255 if (!isset($params[$index])) {
1258 if (!$customFieldName) {
1259 $fieldName = $field['name'];
1262 $fieldName = $customFieldName;
1266 if (CRM_Core_BAO_CustomField
::getKeyID($field['name'])) {
1267 $htmlType = $field['html_type'];
1268 if ($htmlType == 'Link') {
1269 $url = $params[$index];
1271 elseif (in_array($htmlType, array(
1272 'CheckBox', 'Multi-Select', 'AdvMulti-Select',
1273 'Multi-Select State/Province', 'Multi-Select Country',
1275 $valSeperator = CRM_Core_DAO
::VALUE_SEPARATOR
;
1276 $selectedOptions = explode($valSeperator, $params[$index]);
1278 foreach ($selectedOptions as $key => $multiOption) {
1280 $url[] = CRM_Utils_System
::url('civicrm/profile',
1281 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1282 urlencode($fieldName) .
1284 urlencode($multiOption)
1290 $url = CRM_Utils_System
::url('civicrm/profile',
1291 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1292 urlencode($fieldName) .
1294 urlencode($params[$index])
1299 $url = CRM_Utils_System
::url('civicrm/profile',
1300 'reset=1&force=1&gid=' . $field['group_id'] . '&' .
1301 urlencode($fieldName) .
1303 urlencode($params[$index])
1308 !empty($values[$index]) &&
1312 if (is_array($url) && !empty($url)) {
1314 $eachMultiValue = explode(', ', $values[$index]);
1315 foreach ($eachMultiValue as $key => $valueLabel) {
1316 $links[] = '<a href="' . $url[$key] . '">' . $valueLabel . '</a>';
1318 $values[$index] = implode(', ', $links);
1321 $values[$index] = '<a href="' . $url . '">' . $values[$index] . '</a>';
1329 * Check if profile Group used by any module.
1331 * @param int $id profile Id
1339 public static function usedByModule($id) {
1340 //check whether this group is used by any module(check uf join records)
1342 FROM civicrm_uf_join
1343 WHERE civicrm_uf_join.uf_group_id=$id";
1345 $dao = new CRM_Core_DAO();
1347 if ($dao->fetch()) {
1356 * Delete the profile Group.
1358 * @param int $id profile Id
1366 public static function del($id) {
1367 //check whether this group contains any profile fields
1368 $profileField = new CRM_Core_DAO_UFField();
1369 $profileField->uf_group_id
= $id;
1370 $profileField->find();
1371 while ($profileField->fetch()) {
1372 CRM_Core_BAO_UFField
::del($profileField->id
);
1375 //delete records from uf join table
1376 $ufJoin = new CRM_Core_DAO_UFJoin();
1377 $ufJoin->uf_group_id
= $id;
1380 //delete profile group
1381 $group = new CRM_Core_DAO_UFGroup();
1388 * function to add the UF Group
1390 * @param array $params reference array contains the values submitted by the form
1391 * @param array $ids reference array contains the id
1398 static function add(&$params, $ids = array()) {
1399 $fields = array('is_active', 'add_captcha', 'is_map', 'is_update_dupe', 'is_edit_link', 'is_uf_link', 'is_cms_user');
1400 foreach ($fields as $field) {
1401 $params[$field] = CRM_Utils_Array
::value($field, $params, FALSE);
1404 $params['limit_listings_group_id'] = CRM_Utils_Array
::value('group', $params);
1405 $params['add_to_group_id'] = CRM_Utils_Array
::value('add_contact_to_group', $params);
1407 $ufGroup = new CRM_Core_DAO_UFGroup();
1408 $ufGroup->copyValues($params);
1410 $ufGroupID = CRM_Utils_Array
::value('ufgroup', $ids, CRM_Utils_Array
::value('id', $params));
1412 $ufGroup->name
= CRM_Utils_String
::munge($ufGroup->title
, '_', 56);
1414 $ufGroup->id
= $ufGroupID;
1419 $ufGroup->name
= $ufGroup->name
. "_{$ufGroup->id}";
1427 * Function to make uf join entries for an uf group
1429 * @param array $params (reference) an assoc array of name/value pairs
1430 * @param int $ufGroupId ufgroup id
1436 static function createUFJoin(&$params, $ufGroupId) {
1437 $groupTypes = CRM_Utils_Array
::value('uf_group_type', $params);
1439 // get ufjoin records for uf group
1440 $ufGroupRecord = CRM_Core_BAO_UFGroup
::getUFJoinRecord($ufGroupId);
1442 // get the list of all ufgroup types
1443 $allUFGroupType = CRM_Core_SelectValues
::ufGroupTypes();
1445 // this fix is done to prevent warning generated by array_key_exits incase of empty array is given as input
1446 if (!is_array($groupTypes)) {
1447 $groupTypes = array();
1450 // this fix is done to prevent warning generated by array_key_exits incase of empty array is given as input
1451 if (!is_array($ufGroupRecord)) {
1452 $ufGroupRecord = array();
1455 // check which values has to be inserted/deleted for contact
1456 $menuRebuild = FALSE;
1457 foreach ($allUFGroupType as $key => $value) {
1458 $joinParams = array();
1459 $joinParams['uf_group_id'] = $ufGroupId;
1460 $joinParams['module'] = $key;
1461 if ($key == 'User Account') {
1462 $menuRebuild = TRUE;
1464 if (array_key_exists($key, $groupTypes) && !in_array($key, $ufGroupRecord)) {
1465 // insert a new record
1466 CRM_Core_BAO_UFGroup
::addUFJoin($joinParams);
1468 elseif (!array_key_exists($key, $groupTypes) && in_array($key, $ufGroupRecord)) {
1469 // delete a record for existing ufgroup
1470 CRM_Core_BAO_UFGroup
::delUFJoin($joinParams);
1476 UPDATE civicrm_uf_join
1478 WHERE uf_group_id = %2
1479 AND ( entity_id IS NULL OR entity_id <= 0 )
1481 $p = array(1 => array($params['weight'], 'Integer'),
1482 2 => array($ufGroupId, 'Integer'),
1484 CRM_Core_DAO
::executeQuery($query, $p);
1486 // do a menu rebuild if we are on drupal, so it gets all the new menu entries
1488 $config = CRM_Core_Config
::singleton();
1490 $config->userSystem
->is_drupal
1497 * Function to get the UF Join records for an ufgroup id
1499 * @params int $ufGroupId uf group id
1500 * @params int $displayName if set return display name in array
1501 * @params int $status if set return module other than default modules (User Account/User registration/Profile)
1503 * @param null $ufGroupId
1504 * @param null $displayName
1505 * @param null $status
1507 * @return array $ufGroupJoinRecords
1512 public static function getUFJoinRecord($ufGroupId = NULL, $displayName = NULL, $status = NULL) {
1514 $UFGroupType = array();
1515 $UFGroupType = CRM_Core_SelectValues
::ufGroupTypes();
1519 $dao = new CRM_Core_DAO_UFJoin();
1522 $dao->uf_group_id
= $ufGroupId;
1528 while ($dao->fetch()) {
1529 if (!$displayName) {
1530 $ufJoin[$dao->id
] = $dao->module
;
1533 if (isset($UFGroupType[$dao->module
])) {
1534 // skip the default modules
1536 $ufJoin[$dao->id
] = $UFGroupType[$dao->module
];
1538 // added for CRM-1475
1540 elseif (!CRM_Utils_Array
::key($dao->module
, $ufJoin)) {
1541 $ufJoin[$dao->id
] = $dao->module
;
1549 * Function takes an associative array and creates a ufjoin record for ufgroup
1551 * @param array $params (reference) an assoc array of name/value pairs
1553 * @return object CRM_Core_BAO_UFJoin object
1557 static function addUFJoin(&$params) {
1558 $ufJoin = new CRM_Core_DAO_UFJoin();
1559 $ufJoin->copyValues($params);
1565 * Function to delete the uf join record for an uf group
1567 * @param array $params (reference) an assoc array of name/value pairs
1573 static function delUFJoin(&$params) {
1574 $ufJoin = new CRM_Core_DAO_UFJoin();
1575 $ufJoin->copyValues($params);
1580 * Function to get the weight for ufjoin record
1582 * @param int $ufGroupId if $ufGroupId get update weight or add weight
1584 * @return int weight of the UFGroup
1588 static function getWeight($ufGroupId = NULL) {
1589 //calculate the weight
1592 $queryString = "SELECT ( MAX(civicrm_uf_join.weight)+1) as new_weight
1593 FROM civicrm_uf_join
1594 WHERE module = 'User Registration' OR module = 'User Account' OR module = 'Profile'";
1597 $queryString = "SELECT MAX(civicrm_uf_join.weight) as new_weight
1598 FROM civicrm_uf_join
1599 WHERE civicrm_uf_join.uf_group_id = %1
1600 AND ( entity_id IS NULL OR entity_id <= 0 )";
1601 $p[1] = array($ufGroupId, 'Integer');
1604 $dao = CRM_Core_DAO
::executeQuery($queryString, $p);
1606 return ($dao->new_weight
) ?
$dao->new_weight
: 1;
1610 * Function to get the uf group for a module
1612 * @param string $moduleName module name
1613 * @param int $count no to increment the weight
1614 * @param bool $skipPermission
1615 * @param int $op - which operation (view, edit, create, etc) to check permission for
1616 * @param array|NULL $returnFields list of UFGroup fields to return; NULL for default
1618 * @internal param bool $skipPermision - whether to add permission clause
1619 * @return array $ufGroups array of ufgroups for a module
1623 public static function getModuleUFGroup($moduleName = NULL, $count = 0, $skipPermission = TRUE, $op = CRM_Core_Permission
::VIEW
, $returnFields = NULL) {
1624 $selectFields = array('id', 'title', 'created_id', 'is_active', 'is_reserved', 'group_type');
1626 if (!CRM_Core_Config
::isUpgradeMode()) {
1627 // CRM-13555, since description field was added later (4.4), and to avoid any problems with upgrade
1628 $selectFields[] = 'description';
1631 if (!empty($returnFields)) {
1632 $selectFields = array_merge($returnFields, array_diff($selectFields, $returnFields));
1635 $queryString = 'SELECT civicrm_uf_group.' . implode(', civicrm_uf_group.', $selectFields) . '
1636 FROM civicrm_uf_group
1637 LEFT JOIN civicrm_uf_join ON (civicrm_uf_group.id = uf_group_id)';
1640 $queryString .= ' AND civicrm_uf_group.is_active = 1
1641 WHERE civicrm_uf_join.module = %2';
1642 $p[2] = array($moduleName, 'String');
1646 // add permissioning for profiles only if not registration
1647 if (!$skipPermission) {
1648 $permissionClause = CRM_Core_Permission
::ufGroupClause($op, 'civicrm_uf_group.');
1649 if (strpos($queryString, 'WHERE') !== FALSE) {
1650 $queryString .= " AND $permissionClause ";
1653 $queryString .= " $permissionClause ";
1657 $queryString .= ' ORDER BY civicrm_uf_join.weight, civicrm_uf_group.title';
1658 $dao = CRM_Core_DAO
::executeQuery($queryString, $p);
1660 $ufGroups = array();
1661 while ($dao->fetch()) {
1662 //skip mix profiles in user Registration / User Account
1663 if (($moduleName == 'User Registration' ||
$moduleName == 'User Account') &&
1664 CRM_Core_BAO_UFField
::checkProfileType($dao->id
)
1668 foreach ($selectFields as $key => $field) {
1669 if($field == 'id') {
1672 elseif ($field == 'name') {
1673 $ufGroups[$dao->id
][$field] = $dao->title
;
1676 $ufGroups[$dao->id
][$field] = $dao->$field;
1680 // Allow other modules to alter/override the UFGroups.
1681 CRM_Utils_Hook
::buildUFGroupsForModule($moduleName, $ufGroups);
1687 * Function to filter ufgroups based on logged in user contact type
1689 * @params int $ufGroupId uf group id (profile id)
1692 * @param null $contactID
1694 * @return boolean true or false
1698 static function filterUFGroups($ufGroupId, $contactID = NULL) {
1700 $session = CRM_Core_Session
::singleton();
1701 $contactID = $session->get('userID');
1705 //get the contact type
1706 $contactType = CRM_Contact_BAO_Contact
::getContactType($contactID);
1708 //match if exixting contact type is same as profile contact type
1709 $profileType = CRM_Core_BAO_UFField
::getProfileType($ufGroupId);
1711 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1712 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1715 //allow special mix profiles for Contribution and Participant
1716 $specialProfiles = array('Contribution', 'Participant', 'Membership');
1718 if (in_array($profileType, $specialProfiles)) {
1722 if (($contactType == $profileType) ||
$profileType == 'Contact') {
1731 * Function to build profile form
1733 * @params object $form form object
1734 * @params array $field array field properties
1735 * @params int $mode profile mode
1736 * @params int $contactID contact id
1737 * @params string $usedFor for building up prefixed fieldname for special cases (e.g. onBehalf, Honor)
1742 * @param null $contactId
1743 * @param bool $online
1744 * @param null $usedFor
1745 * @param null $rowNumber
1746 * @param string $prefix
1752 static function buildProfile(
1762 $defaultValues = array();
1763 $fieldName = $field['name'];
1764 $title = $field['title'];
1765 $attributes = $field['attributes'];
1766 $rule = $field['rule'];
1767 $view = $field['is_view'];
1768 $required = ($mode == CRM_Profile_Form
::MODE_SEARCH
) ?
FALSE : $field['is_required'];
1769 $search = ($mode == CRM_Profile_Form
::MODE_SEARCH
) ?
TRUE : FALSE;
1770 $isShared = CRM_Utils_Array
::value('is_shared', $field, 0);
1772 // do not display view fields in drupal registration form
1774 if ($view && $mode == CRM_Profile_Form
::MODE_REGISTER
) {
1778 if ($usedFor == 'onbehalf') {
1779 $name = "onbehalf[$fieldName]";
1781 elseif ($usedFor == 'honor') {
1782 $name = "honor[$fieldName]";
1784 elseif ($contactId && !$online) {
1785 $name = "field[$contactId][$fieldName]";
1787 elseif ($rowNumber) {
1788 $name = "field[$rowNumber][$fieldName]";
1790 elseif (!empty($prefix)) {
1791 $name = $prefix ."[$fieldName]";
1797 if ($fieldName == 'image_URL' && $mode == CRM_Profile_Form
::MODE_EDIT
) {
1798 $deleteExtra = ts('Are you sure you want to delete contact image.');
1800 CRM_Core_Action
::DELETE
=>
1802 'name' => ts('Delete Contact Image'),
1803 'url' => 'civicrm/contact/image',
1804 'qs' => 'reset=1&id=%%id%%&gid=%%gid%%&action=delete',
1806 'onclick = "if (confirm( \'' . $deleteExtra . '\' ) ) this.href+=\'&confirmed=1\'; else return false;"',
1809 $deleteURL = CRM_Core_Action
::formLink($deleteURL,
1810 CRM_Core_Action
::DELETE
,
1811 array('id' => $form->get('id'),
1812 'gid' => $form->get('gid'),
1816 'contact.profileimage.delete',
1820 $form->assign('deleteURL', $deleteURL);
1822 $addressOptions = CRM_Core_BAO_Setting
::valueOptions(CRM_Core_BAO_Setting
::SYSTEM_PREFERENCES_NAME
,
1823 'address_options', TRUE, NULL, TRUE
1826 if (substr($fieldName, 0, 14) === 'state_province') {
1827 $form->add('select', $name, $title,
1829 '' => ts('- select -')) + CRM_Core_PseudoConstant
::stateProvince(), $required
1831 $config = CRM_Core_Config
::singleton();
1832 if (!in_array($mode, array(
1833 CRM_Profile_Form
::MODE_EDIT
, CRM_Profile_Form
::MODE_SEARCH
)) &&
1834 $config->defaultContactStateProvince
1836 $defaultValues[$name] = $config->defaultContactStateProvince
;
1837 $form->setDefaults($defaultValues);
1840 elseif (substr($fieldName, 0, 7) === 'country') {
1841 $form->add('select', $name, $title,
1843 '' => ts('- select -')) + CRM_Core_PseudoConstant
::country(), $required
1845 $config = CRM_Core_Config
::singleton();
1846 if (!in_array($mode, array(
1847 CRM_Profile_Form
::MODE_EDIT
, CRM_Profile_Form
::MODE_SEARCH
)) &&
1848 $config->defaultContactCountry
1850 $defaultValues[$name] = $config->defaultContactCountry
;
1851 $form->setDefaults($defaultValues);
1854 elseif (substr($fieldName, 0, 6) === 'county') {
1855 if ($addressOptions['county']) {
1856 $form->add('select', $name, $title,
1857 array('' => ts('Choose state first')), $required
1861 elseif (substr($fieldName, 0, 9) === 'image_URL') {
1862 $form->add('file', $name, $title, $attributes, $required);
1863 $form->addUploadElement($name);
1865 elseif (substr($fieldName, 0, 2) === 'im') {
1866 $form->add('text', $name, $title, $attributes, $required);
1869 if (substr($name, -1) == ']') {
1870 $providerName = substr($name, 0, -1) . '-provider_id]';
1872 $form->add('select', $providerName, NULL,
1874 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id'), $required
1878 $form->add('select', $name . '-provider_id', $title,
1880 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id'), $required
1884 if ($view && $mode != CRM_Profile_Form
::MODE_SEARCH
) {
1885 $form->freeze($name . '-provider_id');
1889 elseif (($fieldName === 'birth_date') ||
($fieldName === 'deceased_date')) {
1890 $form->addDate($name, $title, $required, array('formatType' => 'birth'));
1892 elseif (in_array($fieldName, array(
1893 'membership_start_date', 'membership_end_date', 'join_date'))) {
1894 $form->addDate($name, $title, $required, array('formatType' => 'custom'));
1896 elseif (CRM_Utils_Array
::value('name',$field) == 'membership_type') {
1897 list($orgInfo, $types) = CRM_Member_BAO_MembershipType
::getMembershipTypeInfo();
1898 $sel = &$form->addElement('hierselect', $name, $title);
1899 $select = array('' => ts('- select -') );
1900 if(count($orgInfo) == 1 && $field['is_required']) {
1901 // we only have one org - so we should default to it. Not sure about defaulting to first type
1902 // as it could be missed - so adding a select
1903 // however, possibly that is more similar to the membership form
1904 if(count($types[1]) > 1) {
1905 $types[1] = $select +
$types[1];
1909 $orgInfo = $select +
$orgInfo;
1911 $sel->setOptions(array($orgInfo, $types));
1913 elseif (CRM_Utils_Array
::value('name',$field) == 'membership_status') {
1914 $form->add('select', $name, $title,
1916 '' => ts('- select -')) + CRM_Member_PseudoConstant
::membershipStatus(NULL, NULL, 'label'), $required
1919 elseif ($fieldName === 'gender_id') {
1920 $genderOptions = array();
1921 $gender = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'gender_id');
1922 foreach ($gender as $key => $var) {
1923 $genderOptions[$key] = $form->createElement('radio', NULL, ts('Gender'), $var, $key);
1925 $group = $form->addGroup($genderOptions, $name, $title);
1927 $form->addRule($name, ts('%1 is a required field.', array(1 => $title)), 'required');
1930 $group->setAttribute('allowClear', TRUE);
1933 elseif ($fieldName === 'prefix_id' ||
$fieldName === 'suffix_id') {
1934 $form->add('select', $name, $title,
1936 '' => ts('- select -')) + CRM_Core_PseudoConstant
::get('CRM_Contact_BAO_Contact', $fieldName), $required
1939 elseif ($fieldName === 'contact_sub_type') {
1940 $gId = $form->get('gid') ?
$form->get('gid') : CRM_Utils_Array
::value('group_id', $field);
1941 if ($usedFor == 'onbehalf') {
1942 $profileType = 'Organization';
1944 elseif ($usedFor == 'honor') {
1945 $profileType = CRM_Core_BAO_UFField
::getProfileType($form->_params
['honoree_profile_id']);
1948 $profileType = $gId ? CRM_Core_BAO_UFField
::getProfileType($gId) : NULL;
1949 if ($profileType == 'Contact') {
1950 $profileType = 'Individual';
1954 $setSubtype = FALSE;
1955 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1956 $setSubtype = $profileType;
1957 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1960 $subtypes = $profileType ? CRM_Contact_BAO_ContactType
::subTypePairs($profileType) : array();
1963 $subtypeList = array();
1964 $subtypeList[$setSubtype] = $subtypes[$setSubtype];
1967 $subtypeList = $subtypes;
1970 $sel = $form->add('select', $name, $title, $subtypeList, $required);
1971 $sel->setMultiple(TRUE);
1973 elseif (in_array($fieldName, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
1974 //add email greeting, postal greeting, addressee, CRM-4575
1975 $gId = $form->get('gid') ?
$form->get('gid') : CRM_Utils_Array
::value('group_id', $field);
1976 $profileType = CRM_Core_BAO_UFField
::getProfileType($gId, TRUE, FALSE, TRUE);
1978 if (empty($profileType) ||
in_array($profileType, array(
1979 'Contact', 'Contribution', 'Participant', 'Membership'))) {
1980 $profileType = 'Individual';
1982 if (CRM_Contact_BAO_ContactType
::isaSubType($profileType)) {
1983 $profileType = CRM_Contact_BAO_ContactType
::getBasicType($profileType);
1986 'contact_type' => $profileType,
1987 'greeting_type' => $fieldName,
1989 $form->add('select', $name, $title,
1991 '' => ts('- select -')) + CRM_Core_PseudoConstant
::greeting($greeting), $required
1993 // add custom greeting element
1994 $form->add('text', $fieldName . '_custom', ts('Custom %1', array(1 => ucwords(str_replace('_', ' ', $fieldName)))),
1998 elseif ($fieldName === 'preferred_communication_method') {
1999 $communicationFields = CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'preferred_communication_method');
2000 foreach ($communicationFields as $key => $var) {
2004 $communicationOptions[] = $form->createElement('checkbox', $key, NULL, $var);
2006 $form->addGroup($communicationOptions, $name, $title, '<br/>');
2008 elseif ($fieldName === 'preferred_mail_format') {
2009 $form->add('select', $name, $title, CRM_Core_SelectValues
::pmf());
2011 elseif ($fieldName === 'preferred_language') {
2012 $form->add('select', $name, $title, array('' => ts('- select -')) + CRM_Contact_BAO_Contact
::buildOptions('preferred_language'));
2014 elseif ($fieldName == 'external_identifier') {
2015 $form->add('text', $name, $title, $attributes, $required);
2016 $contID = $contactId;
2018 $contID = $form->get('id');
2020 $form->addRule($name,
2021 ts('External ID already exists in Database.'),
2023 array('CRM_Contact_DAO_Contact', $contID, 'external_identifier')
2026 elseif ($fieldName === 'group') {
2027 CRM_Contact_Form_Edit_TagsAndGroups
::buildQuickForm($form, $contactId,
2028 CRM_Contact_Form_Edit_TagsAndGroups
::GROUP
,
2033 elseif ($fieldName === 'tag') {
2034 CRM_Contact_Form_Edit_TagsAndGroups
::buildQuickForm($form, $contactId,
2035 CRM_Contact_Form_Edit_TagsAndGroups
::TAG
,
2040 elseif (substr($fieldName, 0, 4) === 'url-') {
2041 $form->add('text', $name, $title,
2042 array_merge(CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Website', 'url'),
2044 'onfocus' => "if (!this.value) { this.value='http://';} else return false",
2045 'onblur' => "if ( this.value == 'http://') { this.value='';} else return false",
2050 $form->addRule($name, ts('Enter a valid Website.'), 'url');
2052 // Note should be rendered as textarea
2053 elseif (substr($fieldName, -4) == 'note') {
2054 $form->add('textarea', $name, $title, $attributes, $required);
2056 elseif (substr($fieldName, 0, 6) === 'custom') {
2057 $customFieldID = CRM_Core_BAO_CustomField
::getKeyID($fieldName);
2058 if ($customFieldID) {
2059 CRM_Core_BAO_CustomField
::addQuickFormElement($form, $name, $customFieldID, FALSE, $required, $search, $title);
2062 elseif (substr($fieldName, 0, 14) === 'address_custom') {
2063 list($fName, $locTypeId) = CRM_Utils_System
::explode('-', $fieldName, 2);
2064 $customFieldID = CRM_Core_BAO_CustomField
::getKeyID(substr($fName, 8));
2065 if ($customFieldID) {
2066 CRM_Core_BAO_CustomField
::addQuickFormElement($form, $name, $customFieldID, FALSE, $required, $search, $title);
2069 elseif (in_array($fieldName, array(
2070 'receive_date', 'receipt_date', 'thankyou_date', 'cancel_date'))) {
2071 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2073 elseif ($fieldName == 'send_receipt') {
2074 $form->addElement('checkbox', $name, $title);
2076 elseif ($fieldName == 'soft_credit') {
2077 $form->addEntityRef("soft_credit_contact_id[$rowNumber]", ts('Soft Credit To'), array('create' => TRUE));
2078 $form->addMoney("soft_credit_amount[{$rowNumber}]", ts('Amount'), FALSE, NULL, FALSE);
2080 elseif ($fieldName == 'product_name') {
2081 list($products, $options) = CRM_Contribute_BAO_Premium
::getPremiumProductInfo();
2082 $sel = &$form->addElement('hierselect', $name, $title);
2084 '0' => ts('- select -')) +
$products;
2085 $sel->setOptions(array($products, $options));
2087 elseif ($fieldName == 'payment_instrument') {
2088 $form->add('select', $name, $title,
2089 array(''=>ts( '- select -' )) + CRM_Contribute_PseudoConstant
::paymentInstrument( ), $required );
2091 else if ($fieldName == 'financial_type' ) {
2092 $form->add('select', $name, $title,
2094 '' => ts('- select -')) + CRM_Contribute_PseudoConstant
::financialType(), $required
2097 elseif ($fieldName == 'contribution_status_id') {
2098 $contributionStatuses = CRM_Contribute_PseudoConstant
::contributionStatus();
2099 $statusName = CRM_Contribute_PseudoConstant
::contributionStatus(NULL, 'name');
2105 unset($contributionStatuses[CRM_Utils_Array
::key($suppress, $statusName)]);
2108 $form->add('select', $name, $title,
2110 '' => ts('- select -')) +
$contributionStatuses, $required
2113 elseif ($fieldName == 'soft_credit_type') {
2114 $form->add('select', $name, $title,
2116 '' => ts('- select -')) + CRM_Core_OptionGroup
::values("soft_credit_type")
2118 $form->addElement('hidden', 'sct_default_id',
2119 CRM_Core_OptionGroup
::getDefaultValue("soft_credit_type"),
2120 array('id' => 'sct_default_id')
2123 elseif ($fieldName == 'currency') {
2124 $form->addCurrency($name, $title, $required);
2126 elseif ($fieldName == 'contribution_page_id') {
2127 $form->add('select', $name, $title,
2129 '' => ts('- select -')) + CRM_Contribute_PseudoConstant
::contributionPage(), $required, 'class="big"'
2132 elseif ($fieldName == 'participant_register_date') {
2133 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2135 elseif ($fieldName == 'activity_status_id') {
2136 $form->add('select', $name, $title,
2138 '' => ts('- select -')) + CRM_Core_PseudoConstant
::activityStatus(), $required
2141 elseif ($fieldName == 'activity_engagement_level') {
2142 $form->add('select', $name, $title,
2144 '' => ts('- select -')) + CRM_Campaign_PseudoConstant
::engagementLevel(), $required
2147 elseif ($fieldName == 'activity_date_time') {
2148 $form->addDateTime($name, $title, $required, array('formatType' => 'activityDateTime'));
2150 elseif ($fieldName == 'participant_status') {
2152 if ($online == TRUE) {
2153 $cond = 'visibility_id = 1';
2155 $form->add('select', $name, $title,
2157 '' => ts('- select -')) + CRM_Event_PseudoConstant
::participantStatus(NULL, $cond, 'label'), $required
2160 elseif ($fieldName == 'participant_role') {
2161 if (!empty($field['is_multiple'])) {
2162 $form->addCheckBox($name, $title, CRM_Event_PseudoConstant
::participantRole(), NULL, NULL, NULL, NULL, ' ', TRUE);
2165 $form->add('select', $name, $title,
2167 '' => ts('- select -')) + CRM_Event_PseudoConstant
::participantRole(), $required
2171 elseif ($fieldName == 'world_region') {
2172 $form->add('select', $name, $title,
2174 '' => ts('- select -')) + CRM_Core_PseudoConstant
::worldRegion(), $required
2177 elseif ($fieldName == 'signature_html') {
2178 $form->addWysiwyg($name, $title, CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Email', $fieldName));
2180 elseif ($fieldName == 'signature_text') {
2181 $form->add('textarea', $name, $title, CRM_Core_DAO
::getAttribute('CRM_Core_DAO_Email', $fieldName));
2183 elseif (substr($fieldName, -11) == 'campaign_id') {
2184 if (CRM_Campaign_BAO_Campaign
::isCampaignEnable()) {
2185 $campaigns = CRM_Campaign_BAO_Campaign
::getCampaigns(CRM_Utils_Array
::value($contactId,
2186 $form->_componentCampaigns
2188 $form->add('select', $name, $title,
2190 '' => ts('- select -')) +
$campaigns, $required, 'class="big"'
2194 elseif ($fieldName == 'activity_details') {
2195 $form->addWysiwyg($fieldName, $title, array('rows' => 4, 'cols' => 60), $required);
2197 elseif ($fieldName == 'activity_duration') {
2198 $form->add('text', $name, $title, $attributes, $required);
2199 $form->addRule($name, ts('Please enter the duration as number of minutes (integers only).'), 'positiveInteger');
2202 if (substr($fieldName, 0, 3) === 'is_' or substr($fieldName, 0, 7) === 'do_not_') {
2203 $form->add('advcheckbox', $name, $title, $attributes, $required);
2206 $form->add('text', $name, $title, $attributes, $required);
2210 static $hiddenSubtype = FALSE;
2211 if (!$hiddenSubtype && CRM_Contact_BAO_ContactType
::isaSubType($field['field_type'])) {
2212 // In registration mode params are submitted via POST and we don't have any clue
2213 // about profile-id or the profile-type (which could be a subtype)
2214 // To generalize the behavior and simplify the process,
2215 // lets always add the hidden
2216 //subtype value if there is any, and we won't have to
2217 // compute it while processing.
2219 $form->addElement('hidden', $usedFor . '[contact_sub_type]', $field['field_type']);
2222 $form->addElement('hidden', 'contact_sub_type_hidden', $field['field_type']);
2224 $hiddenSubtype = TRUE;
2227 if (($view && $mode != CRM_Profile_Form
::MODE_SEARCH
) ||
$isShared) {
2228 $form->freeze($name);
2232 if (in_array($fieldName, array(
2233 'non_deductible_amount', 'total_amount', 'fee_amount', 'net_amount'))) {
2234 $form->addRule($name, ts('Please enter a valid amount.'), 'money');
2236 $stateCountryMap = array();
2237 if (!empty($form->_stateCountryMap
['state_province']) && !empty($form->_stateCountryMap
['country'])) {
2238 foreach ($form->_stateCountryMap
['state_province'] as $key => $value) {
2239 $stateCountryMap[$key]['state_province'] = $value;
2240 $stateCountryMap[$key]['country'] = $form->_stateCountryMap
['country'][$key];
2242 CRM_Core_BAO_Address
::addStateCountryMap($stateCountryMap);
2245 if (!($rule == 'email' && $mode == CRM_Profile_Form
::MODE_SEARCH
)) {
2246 $form->addRule($name, ts('Please enter a valid %1', array(1 => $title)), $rule);
2252 * Function to set profile defaults
2254 * @params int $contactId contact id
2255 * @params array $fields associative array of fields
2256 * @params array $defaults defaults array
2257 * @params boolean $singleProfile true for single profile else false(batch update)
2258 * @params int $componentId id for specific components like contribute, event etc
2263 * @param bool $singleProfile
2264 * @param null $componentId
2265 * @param null $component
2271 static function setProfileDefaults($contactId, &$fields, &$defaults,
2272 $singleProfile = TRUE, $componentId = NULL, $component = NULL
2274 if (!$componentId) {
2275 //get the contact details
2276 list($contactDetails, $options) = CRM_Contact_BAO_Contact
::getHierContactDetails($contactId, $fields);
2277 $details = CRM_Utils_Array
::value($contactId, $contactDetails);
2278 $multipleFields = array('website' => 'url');
2280 //start of code to set the default values
2281 foreach ($fields as $name => $field) {
2282 // skip pseudo fields
2283 if (substr($name, 0, 9) == 'phone_ext') {
2287 //set the field name depending upon the profile mode(single/batch)
2288 if ($singleProfile) {
2292 $fldName = "field[$contactId][$name]";
2295 if ($name == 'group') {
2296 CRM_Contact_Form_Edit_TagsAndGroups
::setDefaults($contactId, $defaults, CRM_Contact_Form_Edit_TagsAndGroups
::GROUP
, $fldName);
2298 if ($name == 'tag') {
2299 CRM_Contact_Form_Edit_TagsAndGroups
::setDefaults($contactId, $defaults, CRM_Contact_Form_Edit_TagsAndGroups
::TAG
, $fldName);
2302 if (!empty($details[$name]) ||
isset($details[$name])) {
2303 //to handle custom data (checkbox) to be written
2304 // to handle birth/deceased date, greeting_type and few other fields
2305 if (($name == 'birth_date') ||
($name == 'deceased_date')) {
2306 list($defaults[$fldName]) = CRM_Utils_Date
::setDateDefaults($details[$name], 'birth');
2308 elseif (in_array($name, CRM_Contact_BAO_Contact
::$_greetingTypes)) {
2309 $defaults[$fldName] = $details[$name . '_id'];
2310 $defaults[$name . '_custom'] = $details[$name . '_custom'];
2312 elseif ($name == 'preferred_communication_method') {
2313 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2314 foreach ($v as $item) {
2316 $defaults[$fldName . "[$item]"] = 1;
2320 elseif ($name == 'contact_sub_type') {
2321 $defaults[$fldName] = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, trim($details[$name], CRM_Core_DAO
::VALUE_SEPARATOR
));
2323 elseif ($name == 'world_region') {
2324 $defaults[$fldName] = $details['worldregion_id'];
2326 elseif ($customFieldId = CRM_Core_BAO_CustomField
::getKeyID($name)) {
2327 //fix for custom fields
2328 $customFields = CRM_Core_BAO_CustomField
::getFields(CRM_Utils_Array
::value('contact_type', $details));
2330 // hack to add custom data for components
2331 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
2332 foreach ($components as $value) {
2333 $customFields = CRM_Utils_Array
::crmArrayMerge($customFields,
2334 CRM_Core_BAO_CustomField
::getFieldsForImport($value)
2338 switch ($customFields[$customFieldId]['html_type']) {
2339 case 'Multi-Select State/Province':
2340 case 'Multi-Select Country':
2341 case 'AdvMulti-Select':
2342 case 'Multi-Select':
2343 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2344 foreach ($v as $item) {
2346 $defaults[$fldName][$item] = $item;
2352 $v = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $details[$name]);
2353 foreach ($v as $item) {
2355 $defaults[$fldName][$item] = 1;
2356 // seems like we need this for QF style checkboxes in profile where its multiindexed
2358 $defaults["{$fldName}[{$item}]"] = 1;
2364 // CRM-6681, set defult values according to date and time format (if any).
2366 if (!empty($customFields[$customFieldId]['date_format'])) {
2367 $dateFormat = $customFields[$customFieldId]['date_format'];
2370 if (empty($customFields[$customFieldId]['time_format'])) {
2371 list($defaults[$fldName]) = CRM_Utils_Date
::setDateDefaults($details[$name], NULL,
2376 $timeElement = $fldName . '_time';
2377 if (substr($fldName, -1) == ']') {
2378 $timeElement = substr($fldName, 0, -1) . '_time]';
2380 list($defaults[$fldName], $defaults[$timeElement]) = CRM_Utils_Date
::setDateDefaults($details[$name],
2381 NULL, $dateFormat, $customFields[$customFieldId]['time_format']);
2386 $defaults[$fldName] = $details[$name];
2391 $defaults[$fldName] = $details[$name];
2395 $blocks = array('email', 'phone', 'im', 'openid');
2396 list($fieldName, $locTypeId, $phoneTypeId) = CRM_Utils_System
::explode('-', $name, 3);
2397 if (!in_array($fieldName, $multipleFields)) {
2398 if (is_array($details)) {
2399 foreach ($details as $key => $value) {
2400 // when we fixed CRM-5319 - get primary loc
2401 // type as per loc field and removed below code.
2402 $primaryLocationType = FALSE;
2403 if ($locTypeId == 'Primary') {
2404 if (is_array($value) && array_key_exists($fieldName, $value)){
2405 $primaryLocationType = TRUE;
2406 if (in_array($fieldName, $blocks)){
2407 $locTypeId = CRM_Contact_BAO_Contact
::getPrimaryLocationType($contactId, FALSE, $fieldName);
2410 $locTypeId = CRM_Contact_BAO_Contact
::getPrimaryLocationType($contactId, FALSE, 'address');
2415 // fixed for CRM-665
2416 if (is_numeric($locTypeId)) {
2417 if ($primaryLocationType ||
$locTypeId == CRM_Utils_Array
::value('location_type_id', $value)) {
2418 if (!empty($value[$fieldName])) {
2419 //to handle stateprovince and country
2420 if ($fieldName == 'state_province') {
2421 $defaults[$fldName] = $value['state_province_id'];
2423 elseif ($fieldName == 'county') {
2424 $defaults[$fldName] = $value['county_id'];
2426 elseif ($fieldName == 'country') {
2427 if (!isset($value['country_id']) ||
!$value['country_id']) {
2428 $config = CRM_Core_Config
::singleton();
2429 if ($config->defaultContactCountry
) {
2430 $defaults[$fldName] = $config->defaultContactCountry
;
2434 $defaults[$fldName] = $value['country_id'];
2437 elseif ($fieldName == 'phone') {
2439 if (isset($value['phone'][$phoneTypeId])) {
2440 $defaults[$fldName] = $value['phone'][$phoneTypeId];
2442 if (isset($value['phone_ext'][$phoneTypeId])) {
2443 $defaults[str_replace('phone', 'phone_ext', $fldName)] = $value['phone_ext'][$phoneTypeId];
2447 $phoneDefault = CRM_Utils_Array
::value('phone', $value);
2449 if (!is_array($phoneDefault)) {
2450 $defaults[$fldName] = $phoneDefault;
2454 elseif ($fieldName == 'email') {
2455 //adding the first email (currently we don't support multiple emails of same location type)
2456 $defaults[$fldName] = $value['email'];
2458 elseif ($fieldName == 'im') {
2459 //adding the first im (currently we don't support multiple ims of same location type)
2460 $defaults[$fldName] = $value['im'];
2461 $defaults[$fldName . '-provider_id'] = $value['im_provider_id'];
2464 $defaults[$fldName] = $value[$fieldName];
2467 elseif (substr($fieldName, 0, 14) === 'address_custom' &&
2468 CRM_Utils_Array
::value(substr($fieldName, 8), $value)
2470 $defaults[$fldName] = $value[substr($fieldName, 8)];
2478 if (is_array($details)) {
2479 if ($fieldName === 'url'
2480 && !empty($details['website'])
2481 && !empty($details['website'][$locTypeId])) {
2482 $defaults[$fldName] = CRM_Utils_Array
::value('url', $details['website'][$locTypeId]);
2490 //Handling Contribution Part of the batch profile
2491 if (CRM_Core_Permission
::access('CiviContribute') && $component == 'Contribute') {
2492 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2495 //Handling Event Participation Part of the batch profile
2496 if (CRM_Core_Permission
::access('CiviEvent') && $component == 'Event') {
2497 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2500 //Handling membership Part of the batch profile
2501 if (CRM_Core_Permission
::access('CiviMember') && $component == 'Membership') {
2502 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2505 //Handling Activity Part of the batch profile
2506 if ($component == 'Activity') {
2507 self
::setComponentDefaults($fields, $componentId, $component, $defaults);
2512 * Function to get profiles by type eg: pure Individual etc
2514 * @param array $types associative array of types eg: types('Individual')
2515 * @param boolean $onlyPure true if only pure profiles are required
2517 * @return array $profiles associative array of profiles
2521 static function getProfiles($types, $onlyPure = FALSE) {
2522 $profiles = array();
2523 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
2525 CRM_Utils_Hook
::aclGroup(CRM_Core_Permission
::ADMIN
, NULL, 'civicrm_uf_group', $ufGroups, $ufGroups);
2527 // Exclude Batch Data Entry profiles - CRM-10901
2528 $batchProfiles = CRM_Core_BAO_UFGroup
::getBatchProfiles();
2530 foreach ($ufGroups as $id => $title) {
2531 $ptype = CRM_Core_BAO_UFField
::getProfileType($id, FALSE, $onlyPure);
2532 if (in_array($ptype, $types) && !array_key_exists($id, $batchProfiles)) {
2533 $profiles[$id] = $title;
2540 * Function to check whether a profile is valid combination of
2541 * required and/or optional profile types
2543 * @param array $required array of types those are required
2544 * @param array $optional array of types those are optional
2546 * @return array $profiles associative array of profiles
2550 static function getValidProfiles($required, $optional = NULL) {
2551 if (!is_array($required) ||
empty($required)) {
2555 $profiles = array();
2556 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
2558 CRM_Utils_Hook
::aclGroup(CRM_Core_Permission
::ADMIN
, NULL, 'civicrm_uf_group', $ufGroups, $ufGroups);
2560 foreach ($ufGroups as $id => $title) {
2561 $type = CRM_Core_BAO_UFField
::checkValidProfileType($id, $required, $optional);
2563 $profiles[$id] = $title;
2571 * Function to check whether a profile is valid combination of
2572 * required profile fields
2574 * @param array $ufId integer id of the profile
2575 * @param array $required array of fields those are required in the profile
2577 * @return array $profiles associative array of profiles
2581 static function checkValidProfile($ufId, $required = NULL) {
2582 $validProfile = FALSE;
2584 return $validProfile;
2587 if (!CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $ufId, 'is_active')) {
2588 return $validProfile;
2591 $profileFields = self
::getFields($ufId, FALSE, CRM_Core_Action
::VIEW
, NULL,
2592 NULL, FALSE, NULL, FALSE, NULL,
2593 CRM_Core_Permission
::CREATE
, NULL
2596 $validProfile = array();
2597 if (!empty($profileFields)) {
2598 $fields = array_keys($profileFields);
2599 foreach ($fields as $val) {
2600 foreach ($required as $key => $field) {
2601 if (strpos($val, $field) === 0) {
2602 unset($required[$key]);
2607 $validProfile = (empty($required)) ?
TRUE : FALSE;
2610 return $validProfile;
2614 * Function to get default value for Register.
2619 * @return mixed $defaults@static
2622 static function setRegisterDefaults(&$fields, &$defaults) {
2623 $config = CRM_Core_Config
::singleton();
2624 foreach ($fields as $name => $field) {
2625 if (substr($name, 0, 8) == 'country-') {
2626 if (!empty($config->defaultContactCountry
)) {
2627 $defaults[$name] = $config->defaultContactCountry
;
2630 elseif (substr($name, 0, 15) == 'state_province-') {
2631 if (!empty($config->defaultContactStateProvince
)) {
2632 $defaults[$name] = $config->defaultContactStateProvince
;
2640 * This function is to make a copy of a profile, including
2641 * all the fields in the profile
2643 * @param int $id the profile id to copy
2648 static function copy($id) {
2649 $fieldsFix = array('prefix' => array('title' => ts('Copy of ')));
2650 $copy = &CRM_Core_DAO
::copyGeneric('CRM_Core_DAO_UFGroup',
2656 if ($pos = strrpos($copy->name
, "_{$id}")) {
2657 $copy->name
= substr_replace($copy->name
, '', $pos);
2659 $copy->name
= CRM_Utils_String
::munge($copy->name
, '_', 56) . "_{$copy->id}";
2662 $copyUFJoin = &CRM_Core_DAO
::copyGeneric('CRM_Core_DAO_UFJoin',
2663 array('uf_group_id' => $id),
2664 array('uf_group_id' => $copy->id
),
2669 $copyUFField = &CRM_Core_DAO
::copyGeneric('CRM_Core_BAO_UFField',
2670 array('uf_group_id' => $id),
2671 array('uf_group_id' => $copy->id
)
2674 $maxWeight = CRM_Utils_Weight
::getMax('CRM_Core_DAO_UFJoin', NULL, 'weight');
2678 UPDATE civicrm_uf_join
2680 WHERE uf_group_id = %2
2681 AND ( entity_id IS NULL OR entity_id <= 0 )
2683 $p = array(1 => array($maxWeight +
1, 'Integer'),
2684 2 => array($copy->id
, 'Integer'),
2686 CRM_Core_DAO
::executeQuery($query, $p);
2687 if ($copy->is_reserved
) {
2688 $query = "UPDATE civicrm_uf_group SET is_reserved = 0 WHERE id = %1";
2689 $params = array(1 => array($copy->id
, 'Integer'));
2690 CRM_Core_DAO
::executeQuery($query, $params);
2692 CRM_Utils_Hook
::copy('UFGroup', $copy);
2698 * Process that send notification e-mails
2700 * @params int $contactId contact id
2701 * @params array $values associative array of name/value pair
2710 static function commonSendMail($contactID, &$values) {
2711 if (!$contactID ||
!$values) {
2715 $template = CRM_Core_Smarty
::singleton();
2717 $displayName = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Contact',
2722 self
::profileDisplay($values['id'], $values['values'], $template);
2723 $emailList = explode(',', $values['email']);
2725 $contactLink = CRM_Utils_System
::url('civicrm/contact/view',
2726 "reset=1&cid=$contactID",
2727 TRUE, NULL, FALSE, FALSE, TRUE
2730 //get the default domain email address.
2731 list($domainEmailName, $domainEmailAddress) = CRM_Core_BAO_Domain
::getNameAndEmail();
2733 if (!$domainEmailAddress ||
$domainEmailAddress == 'info@EXAMPLE.ORG') {
2734 $fixUrl = CRM_Utils_System
::url('civicrm/admin/domain', 'action=update&reset=1');
2735 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)));
2738 foreach ($emailList as $emailTo) {
2739 // FIXME: take the below out of the foreach loop
2740 CRM_Core_BAO_MessageTemplate
::sendTemplate(
2742 'groupName' => 'msg_tpl_workflow_uf',
2743 'valueName' => 'uf_notify',
2744 'contactId' => $contactID,
2745 'tplParams' => array(
2746 'displayName' => $displayName,
2747 'currentDate' => date('r'),
2748 'contactLink' => $contactLink,
2750 'from' => "$domainEmailName <$domainEmailAddress>",
2751 'toEmail' => $emailTo,
2758 * Given a contact id and a group id, returns the field values from the db
2759 * for this group and notify email only if group's notify field is
2760 * set and field values are not empty
2762 * @params $gid group id
2763 * @params $cid contact id
2764 * @params $params associative array
2769 * @param bool $skipCheck
2774 function checkFieldsEmptyValues($gid, $cid, $params, $skipCheck = FALSE) {
2776 if (CRM_Core_BAO_UFGroup
::filterUFGroups($gid, $cid) ||
$skipCheck) {
2778 $fields = CRM_Core_BAO_UFGroup
::getFields($gid, FALSE, CRM_Core_Action
::VIEW
);
2779 CRM_Core_BAO_UFGroup
::getValues($cid, $fields, $values, FALSE, $params, TRUE);
2781 $email = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $gid, 'notify');
2783 if (!empty($values) &&
2788 'values' => $values,
2799 * Function to assign uf fields to template
2801 * @params int $gid group id
2802 * @params array $values associative array of fields
2811 function profileDisplay($gid, $values, $template) {
2812 $groupTitle = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $gid, 'title');
2813 $template->assign('grouptitle', $groupTitle);
2814 if (count($values)) {
2815 $template->assign('values', $values);
2820 * Format fields for dupe Contact Matching
2822 * @param array $params associated array
2824 * @param null $contactId
2826 * @return array $data assoicated formatted array
2830 static function formatFields($params, $contactId = NULL) {
2832 // get the primary location type id and email
2833 list($name, $primaryEmail, $primaryLocationType) = CRM_Contact_BAO_Contact_Location
::getEmailDetails($contactId);
2836 $defaultLocationType = CRM_Core_BAO_LocationType
::getDefault();
2837 $primaryLocationType = $defaultLocationType->id
;
2841 $locationType = array();
2843 $primaryLocation = 0;
2844 foreach ($params as $key => $value) {
2845 list($fieldName, $locTypeId, $phoneTypeId) = explode('-', $key);
2847 if ($locTypeId == 'Primary') {
2848 $locTypeId = $primaryLocationType;
2851 if (is_numeric($locTypeId)) {
2852 if (!in_array($locTypeId, $locationType)) {
2853 $locationType[$count] = $locTypeId;
2856 $loc = CRM_Utils_Array
::key($locTypeId, $locationType);
2858 $data['location'][$loc]['location_type_id'] = $locTypeId;
2860 // if we are getting in a new primary email, dont overwrite the new one
2861 if ($locTypeId == $primaryLocationType) {
2862 if (!empty($params['email-' . $primaryLocationType])) {
2863 $data['location'][$loc]['email'][$loc]['email'] = $fields['email-' . $primaryLocationType];
2865 elseif (isset($primaryEmail)) {
2866 $data['location'][$loc]['email'][$loc]['email'] = $primaryEmail;
2872 $data['location'][$loc]['is_primary'] = 1;
2874 if ($fieldName == 'phone') {
2876 $data['location'][$loc]['phone'][$loc]['phone_type_id'] = $phoneTypeId;
2879 $data['location'][$loc]['phone'][$loc]['phone_type_id'] = '';
2881 $data['location'][$loc]['phone'][$loc]['phone'] = $value;
2883 elseif ($fieldName == 'email') {
2884 $data['location'][$loc]['email'][$loc]['email'] = $value;
2886 elseif ($fieldName == 'im') {
2887 $data['location'][$loc]['im'][$loc]['name'] = $value;
2890 if ($fieldName === 'state_province') {
2891 $data['location'][$loc]['address']['state_province_id'] = $value;
2893 elseif ($fieldName === 'country') {
2894 $data['location'][$loc]['address']['country_id'] = $value;
2897 $data['location'][$loc]['address'][$fieldName] = $value;
2902 // TODO: prefix, suffix and gender translation may no longer be necessary - check inputs
2903 if ($key === 'individual_suffix') {
2904 $data['suffix_id'] = $value;
2906 elseif ($key === 'individual_prefix') {
2907 $data['prefix_id'] = $value;
2909 elseif ($key === 'gender') {
2910 $data['gender_id'] = $value;
2912 elseif (substr($key, 0, 6) === 'custom') {
2913 if ($customFieldID = CRM_Core_BAO_CustomField
::getKeyID($key)) {
2915 if ($customFields[$customFieldID]['html_type'] == 'CheckBox') {
2916 $value = implode(CRM_Core_DAO
::VALUE_SEPARATOR
, array_keys($value));
2918 // fix the date field
2919 if ($customFields[$customFieldID]['data_type'] == 'Date') {
2920 $date = CRM_Utils_Date
::format($value);
2927 $data['custom'][$customFieldID] = array(
2930 'extends' => $customFields[$customFieldID]['extends'],
2931 'type' => $customFields[$customFieldID]['data_type'],
2932 'custom_field_id' => $customFieldID,
2936 elseif ($key == 'edit') {
2940 $data[$key] = $value;
2945 if (!$primaryLocation) {
2947 $data['location'][$loc]['email'][$loc]['email'] = $primaryEmail;
2955 * calculate the profile type 'group_type' as per profile fields.
2958 * @param bool $includeTypeValues
2959 * @param int $ignoreFieldId ignore particular profile field
2961 * @internal param int $gid profile id
2962 * @return array list of calculated group type
2964 static function calculateGroupType($gId, $includeTypeValues = FALSE, $ignoreFieldId = NULL) {
2965 //get the profile fields.
2966 $ufFields = self
::getFields($gId, FALSE, NULL, NULL, NULL, TRUE, NULL, TRUE);
2967 return self
::_calculateGroupType($ufFields, $includeTypeValues, $ignoreFieldId);
2971 * calculate the profile type 'group_type' as per profile fields.
2974 * @param bool $includeTypeValues
2975 * @param int $ignoreFieldId ignore perticular profile field
2977 * @internal param int $gid profile id
2978 * @return array list of calculated group type
2980 static function _calculateGroupType($ufFields, $includeTypeValues = FALSE, $ignoreFieldId = NULL) {
2981 $groupType = $groupTypeValues = $customFieldIds = array();
2982 if (!empty($ufFields)) {
2983 foreach ($ufFields as $fieldName => $fieldValue) {
2984 //ignore field from group type when provided.
2985 //in case of update profile field.
2986 if ($ignoreFieldId && ($ignoreFieldId == $fieldValue['field_id'])) {
2989 if (!in_array($fieldValue['field_type'], $groupType)) {
2990 $groupType[$fieldValue['field_type']] = $fieldValue['field_type'];
2993 if ($includeTypeValues && ($fldId = CRM_Core_BAO_CustomField
::getKeyID($fieldName))) {
2994 $customFieldIds[$fldId] = $fldId;
2999 if (!empty($customFieldIds)) {
3000 $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) . ')';
3002 $customGroups = CRM_Core_DAO
::executeQuery($query);
3003 while ($customGroups->fetch()) {
3004 if (!$customGroups->extends_entity_column_value
) {
3008 $groupTypeName = "{$customGroups->extends}Type";
3009 if ($customGroups->extends == 'Participant' && $customGroups->extends_entity_column_id
) {
3010 $groupTypeName = CRM_Core_OptionGroup
::getValue('custom_data_type', $customGroups->extends_entity_column_id
, 'value', 'String', 'name');
3013 foreach (explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $customGroups->extends_entity_column_value
) as $val) {
3015 $groupTypeValues[$groupTypeName][$val] = $val;
3020 if (!empty($groupTypeValues)) {
3021 $groupType = array_merge($groupType, $groupTypeValues);
3029 * Update the profile type 'group_type' as per profile fields including group types and group subtype values.
3030 * Build and store string like: group_type1,group_type2[VALUE_SEPERATOR]group_type1Type:1:2:3,group_type2Type:1:2
3033 * BirthDate + Email Individual,Contact
3034 * BirthDate + Subject Individual,Activity
3035 * BirthDate + Subject + SurveyOnlyField Individual,Activity\0ActivityType:28
3036 * BirthDate + Subject + SurveyOnlyField + PhoneOnlyField (Not allowed)
3037 * BirthDate + SurveyOnlyField Individual,Activity\0ActivityType:28
3038 * BirthDate + Subject + SurveyOrPhoneField Individual,Activity\0ActivityType:2:28
3039 * BirthDate + SurveyOrPhoneField Individual,Activity\0ActivityType:2:28
3040 * BirthDate + SurveyOrPhoneField + SurveyOnlyField Individual,Activity\0ActivityType:2:28
3041 * BirthDate + StudentField + Subject + SurveyOnlyField Individual,Activity,Student\0ActivityType:28
3044 * @param Array $groupTypes With key having group type names
3046 * @internal param int $gid profile id
3049 static function updateGroupTypes($gId, $groupTypes = array(
3051 if (!is_array($groupTypes) ||
!$gId) {
3055 // If empty group types set group_type as 'null'
3056 if (empty($groupTypes)) {
3057 return CRM_Core_DAO
::setFieldValue('CRM_Core_DAO_UFGroup', $gId, 'group_type', 'null');
3060 $componentGroupTypes = array('Contribution', 'Participant', 'Membership', 'Activity', 'Case');
3061 $validGroupTypes = array_merge(array('Contact', 'Individual', 'Organization', 'Household'), $componentGroupTypes, CRM_Contact_BAO_ContactType
::subTypes());
3063 $gTypes = $gTypeValues = array();
3065 $participantExtends = array('ParticipantRole', 'ParticipantEventName', 'ParticipantEventType');
3066 // Get valid group type and group subtypes
3067 foreach ($groupTypes as $groupType => $value) {
3068 if (in_array($groupType, $validGroupTypes) && !in_array($groupType, $gTypes)) {
3069 $gTypes[] = $groupType;
3074 if (in_array($groupType, $participantExtends)) {
3075 $subTypesOf = $groupType;
3077 elseif (strpos($groupType, 'Type') > 0) {
3078 $subTypesOf = substr($groupType, 0, strpos($groupType, 'Type'));
3084 if (!empty($value) &&
3085 (in_array($subTypesOf, $componentGroupTypes) ||
3086 in_array($subTypesOf, $participantExtends)
3089 $gTypeValues[$subTypesOf] = $groupType . ":" . implode(':', $value);
3093 if (empty($gTypes)) {
3097 // Build String to store group types and group subtypes
3098 $groupTypeString = implode(',', $gTypes);
3099 if (!empty($gTypeValues)) {
3100 $groupTypeString .= CRM_Core_DAO
::VALUE_SEPARATOR
. implode(',', $gTypeValues);
3103 return CRM_Core_DAO
::setFieldValue('CRM_Core_DAO_UFGroup', $gId, 'group_type', $groupTypeString);
3107 * Create a "group_type" string
3109 * @param array $coreTypes e.g. array('Individual','Contact','Student')
3110 * @param array $subTypes e.g. array('ActivityType' => array(7, 11))
3111 * @param string $delim
3114 * @throws CRM_Core_Exception
3116 static function encodeGroupType($coreTypes, $subTypes, $delim = CRM_Core_DAO
::VALUE_SEPARATOR
) {
3117 $groupTypeExpr = '';
3119 $groupTypeExpr .= implode(',', $coreTypes);
3122 if (count($subTypes) > 1) {
3123 throw new CRM_Core_Exception("Multiple subtype filtering is not currently supported by widget.");
3125 foreach ($subTypes as $subType => $subTypeIds) {
3126 $groupTypeExpr .= $delim . $subType . ':' . implode(':', $subTypeIds);
3129 return $groupTypeExpr;
3133 * This function is used to setDefault componet specific profile fields.
3135 * @param array $fields profile fields.
3136 * @param int $componentId componetID
3137 * @param string $component component name
3138 * @param array $defaults an array of default values.
3140 * @param bool $isStandalone
3144 public static function setComponentDefaults(&$fields, $componentId, $component, &$defaults, $isStandalone = FALSE) {
3145 if (!$componentId ||
3146 !in_array($component, array('Contribute', 'Membership', 'Event', 'Activity'))
3151 $componentBAO = $componentSubType = NULL;
3152 switch ($component) {
3154 $componentBAO = 'CRM_Member_BAO_Membership';
3155 $componentBAOName = 'Membership';
3156 $componentSubType = array('membership_type_id');
3160 $componentBAO = 'CRM_Contribute_BAO_Contribution';
3161 $componentBAOName = 'Contribution';
3162 $componentSubType = array( 'financial_type_id' );
3166 $componentBAO = 'CRM_Event_BAO_Participant';
3167 $componentBAOName = 'Participant';
3168 $componentSubType = array('role_id', 'event_id');
3172 $componentBAO = 'CRM_Activity_BAO_Activity';
3173 $componentBAOName = 'Activity';
3174 $componentSubType = array('activity_type_id');
3179 $params = array('id' => $componentId);
3181 //get the component values.
3182 CRM_Core_DAO
::commonRetrieve($componentBAO, $params, $values);
3184 $formattedGroupTree = array();
3185 $dateTimeFields = array('participant_register_date', 'activity_date_time', 'receive_date', 'receipt_date', 'cancel_date', 'thankyou_date', 'membership_start_date', 'membership_end_date', 'join_date');
3186 foreach ($fields as $name => $field) {
3187 $fldName = $isStandalone ?
$name : "field[$componentId][$name]";
3188 if (in_array($name, $dateTimeFields)) {
3189 $timefldName = $isStandalone ?
"{$name}_time" : "field[$componentId][{$name}_time]";
3190 if (!empty($values[$name])) {
3191 list($defaults[$fldName], $defaults[$timefldName]) = CRM_Utils_Date
::setDateDefaults($values[$name]);
3194 elseif (array_key_exists($name, $values)) {
3195 $defaults[$fldName] = $values[$name];
3197 elseif ($name == 'participant_note') {
3198 $noteDetails = CRM_Core_BAO_Note
::getNote($componentId, 'civicrm_participant');
3199 $defaults[$fldName] = array_pop($noteDetails);
3201 elseif (in_array($name, array(
3202 'financial_type', 'payment_instrument', 'participant_status', 'participant_role'))) {
3203 $defaults[$fldName] = $values["{$name}_id"];
3205 elseif ($name == 'membership_type') {
3206 // since membership_type field is a hierselect -
3207 $defaults[$fldName][0] =
3208 CRM_Core_DAO
::getFieldValue('CRM_Member_DAO_MembershipType',$values['membership_type_id'],'member_of_contact_id','id');
3209 $defaults[$fldName][1] = $values['membership_type_id'];
3211 elseif ($name == 'membership_status') {
3212 $defaults[$fldName] = $values['status_id'];
3214 elseif ($customFieldInfo = CRM_Core_BAO_CustomField
::getKeyID($name, TRUE)) {
3215 if (empty($formattedGroupTree)) {
3216 //get the groupTree as per subTypes.
3217 $groupTree = array();
3218 foreach ($componentSubType as $subType) {
3219 $subTree = CRM_Core_BAO_CustomGroup
::getTree($componentBAOName, CRM_Core_DAO
::$_nullObject,
3220 $componentId, 0, $values[$subType]
3222 $groupTree = CRM_Utils_Array
::crmArrayMerge($groupTree, $subTree);
3224 $formattedGroupTree = CRM_Core_BAO_CustomGroup
::formatGroupTree($groupTree, 1, CRM_Core_DAO
::$_nullObject);
3225 CRM_Core_BAO_CustomGroup
::setDefaults($formattedGroupTree, $defaults);
3228 //FIX ME: We need to loop defaults, but once we move to custom_1_x convention this code can be simplified.
3229 foreach ($defaults as $customKey => $customValue) {
3230 if ($customFieldDetails = CRM_Core_BAO_CustomField
::getKeyID($customKey, TRUE)) {
3231 if ($name == 'custom_' . $customFieldDetails[0]) {
3233 //hack to set default for checkbox
3234 //basically this is for weired field name like field[33][custom_19]
3235 //we are converting this field name to array structure and assign value.
3238 foreach ($formattedGroupTree as $tree) {
3239 if ('CheckBox' == CRM_Utils_Array
::value('html_type', $tree['fields'][$customFieldDetails[0]])) {
3241 $defaults['field'][$componentId][$name] = $customValue;
3244 elseif (CRM_Utils_Array
::value('data_type', $tree['fields'][$customFieldDetails[0]]) == 'Date') {
3247 // CRM-6681, $default contains formatted date, time values.
3248 $defaults[$fldName] = $customValue;
3249 if (!empty($defaults[$customKey . '_time'])) {
3250 $defaults['field'][$componentId][$name . '_time'] = $defaults[$customKey . '_time'];
3255 if (!$skipValue ||
$isStandalone) {
3256 $defaults[$fldName] = $customValue;
3258 unset($defaults[$customKey]);
3268 * @param array|string $profiles - name of profile(s) to create links for
3269 * @param array $appendProfiles - name of profile(s) to append to each link
3273 static function getCreateLinks($profiles = '', $appendProfiles = array()) {
3274 // Default to contact profiles
3276 $profiles = array('new_individual', 'new_organization', 'new_household');
3278 $profiles = (array) $profiles;
3279 $toGet = array_merge($profiles, (array) $appendProfiles);
3280 $retrieved = civicrm_api3('uf_group', 'get', array(
3281 'name' => array('IN' => $toGet),
3284 $links = $append = array();
3285 if (!empty($retrieved['values'])) {
3286 foreach($retrieved['values'] as $id => $profile) {
3287 if (in_array($profile['name'], $profiles)) {
3289 'label' => $profile['title'],
3290 'url' => CRM_Utils_System
::url('civicrm/profile/create', "reset=1&context=dialog&gid=$id",
3291 NULL, NULL, FALSE, NULL, FALSE) ,
3292 'type' => ucfirst(str_replace('new_', '', $profile['name'])),
3299 foreach ($append as $id) {
3300 foreach ($links as &$link) {
3301 $link['url'] .= ",$id";
3309 * Function to retrieve groups of profiles
3311 * @param integer $profileID id of the profile
3313 * @return array returns array
3316 static function profileGroups($profileID) {
3317 $groupTypes = array();
3318 $profileTypes = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $profileID, 'group_type');
3319 if ($profileTypes) {
3320 $groupTypeParts = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $profileTypes);
3321 $groupTypes = explode(',', $groupTypeParts[0]);
3327 * Function to alter contact params by filtering existing subscribed groups and returns
3328 * unsubscribed groups array for subscription.
3330 * @param array $params contact params
3331 * @param int $contactId user contact id
3333 * @return array $subscribeGroupIds This contains array of groups for subscription
3335 static function getDoubleOptInGroupIds(&$params, $contactId = NULL) {
3336 $config = CRM_Core_Config
::singleton();
3337 $subscribeGroupIds = array();
3339 // process further only if profileDoubleOptIn enabled and if groups exist
3340 if (!array_key_exists('group', $params) ||
3341 !self
::isProfileDoubleOptin() ||
3342 CRM_Utils_System
::isNull($params['group'])
3344 return $subscribeGroupIds;
3347 //check if contact email exist.
3349 foreach ($params as $name => $value) {
3350 if (strpos($name, 'email-') !== FALSE) {
3356 //Proceed furthur only if email present
3358 return $subscribeGroupIds;
3361 //do check for already subscriptions.
3362 $contactGroups = array();
3366 FROM civicrm_group_contact
3367 WHERE status = 'Added'
3368 AND contact_id = %1";
3370 $dao = CRM_Core_DAO
::executeQuery($query, array(1 => array($contactId, 'Integer')));
3371 while ($dao->fetch()) {
3372 $contactGroups[$dao->group_id
] = $dao->group_id
;
3376 //since we don't have names, compare w/ label.
3377 $mailingListGroupType = array_search('Mailing List', CRM_Core_OptionGroup
::values('group_type'));
3379 //actual processing start.
3380 foreach ($params['group'] as $groupId => $isSelected) {
3381 //unset group those are not selected.
3383 unset($params['group'][$groupId]);
3387 $groupTypes = explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
3388 CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Group', $groupId, 'group_type', 'id')
3390 //get only mailing type group and unset it from params
3391 if (in_array($mailingListGroupType, $groupTypes) && !in_array($groupId, $contactGroups)) {
3392 $subscribeGroupIds[$groupId] = $groupId;
3393 unset($params['group'][$groupId]);
3397 return $subscribeGroupIds;
3401 * Function to check if we are rendering mixed profiles
3403 * @param array $profileIds associated array of profile ids
3405 * @return boolean $mixProfile true if profile is mixed
3409 static function checkForMixProfiles($profileIds) {
3410 $mixProfile = FALSE;
3412 $contactTypes = array('Individual', 'Household', 'Organization');
3413 $subTypes = CRM_Contact_BAO_ContactType
::subTypes();
3415 $components = array('Contribution', 'Participant', 'Membership', 'Activity');
3417 $typeCount = array('ctype' => array(), 'subtype' => array());
3418 foreach ($profileIds as $gid) {
3419 $profileType = CRM_Core_BAO_UFField
::getProfileType($gid);
3420 // ignore profile of type Contact
3421 if ($profileType == 'Contact') {
3424 if (in_array($profileType, $contactTypes)) {
3425 if (!isset($typeCount['ctype'][$profileType])) {
3426 $typeCount['ctype'][$profileType] = 1;
3429 // check if we are rendering profile of different contact types
3430 if (count($typeCount['ctype']) == 2) {
3435 elseif (in_array($profileType, $components)) {
3440 if (!isset($typeCount['subtype'][$profileType])) {
3441 $typeCount['subtype'][$profileType] = 1;
3443 // check if we are rendering profile of different contact sub types
3444 if (count($typeCount['subtype']) == 2) {
3454 * Function to determine of we show overlay profile or not
3456 * @return boolean true if profile should be shown else false
3460 static function showOverlayProfile() {
3461 $showOverlay = TRUE;
3463 // get the id of overlay profile
3464 $overlayProfileId = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', 'summary_overlay', 'id', 'name');
3465 $query = "SELECT count(id) FROM civicrm_uf_field WHERE uf_group_id = {$overlayProfileId} AND visibility IN ('Public Pages', 'Public Pages and Listings') ";
3467 $count = CRM_Core_DAO
::singleValueQuery($query);
3469 //check if there are no public fields and use is anonymous
3470 $session = CRM_Core_Session
::singleton();
3471 if (!$count && !$session->get('userID')) {
3472 $showOverlay = FALSE;
3475 return $showOverlay;
3479 * function to get group type values of the profile
3481 * @params Integer $profileId Profile Id
3482 * @params String $groupType Group Type
3485 * @param null $groupType
3487 * @return Array group type values
3491 static function groupTypeValues($profileId, $groupType = NULL) {
3492 $groupTypeValue = array();
3493 $groupTypes = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_UFGroup', $profileId, 'group_type');
3495 $groupTypeParts = explode(CRM_Core_DAO
::VALUE_SEPARATOR
, $groupTypes);
3496 if (empty($groupTypeParts[1])) {
3497 return $groupTypeValue;
3499 $participantExtends = array('ParticipantRole', 'ParticipantEventName', 'ParticipantEventType');
3501 foreach (explode(',', $groupTypeParts[1]) as $groupTypeValues) {
3503 $valueParts = explode(':', $groupTypeValues);
3505 ($valueParts[0] != "{$groupType}Type" ||
3506 ($groupType == 'Participant' &&
3507 !in_array($valueParts[0], $participantExtends)
3513 foreach ($valueParts as $val) {
3514 if (CRM_Utils_Rule
::integer($val)) {
3515 $values[$val] = $val;
3518 if (!empty($values)) {
3519 $typeName = substr($valueParts[0], 0, -4);
3520 if (in_array($valueParts[0], $participantExtends)) {
3521 $typeName = $valueParts[0];
3523 $groupTypeValue[$typeName] = $values;
3527 return $groupTypeValue;
3531 * @return bool|object
3533 static function isProfileDoubleOptin() {
3534 // check for double optin
3535 $config = CRM_Core_Config
::singleton();
3536 if (in_array('CiviMail', $config->enableComponents
)) {
3537 return CRM_Core_BAO_Setting
::getItem(CRM_Core_BAO_Setting
::MAILING_PREFERENCES_NAME
,
3538 'profile_double_optin', NULL, FALSE
3545 * @return bool|object
3547 static function isProfileAddToGroupDoubleOptin() {
3548 // check for add to group double optin
3549 $config = CRM_Core_Config
::singleton();
3550 if (in_array('CiviMail', $config->enableComponents
)) {
3551 return CRM_Core_BAO_Setting
::getItem(CRM_Core_BAO_Setting
::MAILING_PREFERENCES_NAME
,
3552 'profile_add_to_group_double_optin', NULL, FALSE
3559 * get profiles used for batch entry
3561 * @return array profileIds profile ids
3564 static function getBatchProfiles() {
3566 FROM civicrm_uf_group
3567 WHERE name IN ('contribution_batch_entry', 'membership_batch_entry')";
3568 $dao = CRM_Core_DAO
::executeQuery( $query );
3569 $profileIds = array();
3570 while( $dao->fetch() ) {
3571 $profileIds[$dao->id
] = $dao->id
;
3577 * @todo what do I do?
3579 * @param $destination
3580 * @param bool $returnMultiSummaryFields
3582 * @return array|null
3584 static function shiftMultiRecordFields(&$source, &$destination, $returnMultiSummaryFields = FALSE) {
3585 $multiSummaryFields = $returnMultiSummaryFields ?
array( ) : NULL;
3586 foreach ($source as $field => $properties) {
3587 if (!CRM_Core_BAO_CustomField
::getKeyID($field)) {
3590 if (CRM_Core_BAO_CustomField
::isMultiRecordField($field)) {
3591 $destination[$field] = $properties;
3592 if ($returnMultiSummaryFields) {
3593 if ($properties['is_multi_summary']) {
3594 $multiSummaryFields[$field] = $properties;
3597 unset($source[$field]);
3600 return $multiSummaryFields;
3604 * This is function is used to format pseudo fields
3606 * @param array $fields associated array of profile fields
3610 static function reformatProfileFields(&$fields) {
3611 //reformat fields array
3612 foreach ($fields as $name => $field) {
3613 //reformat phone and extension field
3614 if ( substr($field['name'], 0, 13) == 'phone_and_ext') {
3615 $fieldSuffix = str_replace('phone_and_ext-', '', $field['name']);
3617 // retain existing element properties and just update and replace key
3618 CRM_Utils_Array
::crmReplaceKey($fields, $name, "phone-{$fieldSuffix}");
3619 $fields["phone-{$fieldSuffix}"]['name'] = "phone-{$fieldSuffix}";
3620 $fields["phone-{$fieldSuffix}"]['where'] = 'civicrm_phone.phone';
3622 // add additional phone extension field
3623 $fields["phone_ext-{$fieldSuffix}"] = $field;
3624 $fields["phone_ext-{$fieldSuffix}"]['title'] = $field['title'] .' - '.ts('Ext.');
3625 $fields["phone_ext-{$fieldSuffix}"]['name'] = "phone_ext-{$fieldSuffix}";
3626 $fields["phone_ext-{$fieldSuffix}"]['where'] = 'civicrm_phone.phone_ext';
3627 $fields["phone_ext-{$fieldSuffix}"]['skipDisplay'] = 1;
3628 //ignore required for extension field
3629 $fields["phone_ext-{$fieldSuffix}"]['is_required'] = 0;