3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
37 * This class is to build the form for adding Group
39 class CRM_Group_Form_Edit
extends CRM_Core_Form
{
42 * the group id, used when editing a group
49 * the group object, if an id is present
56 * The title of the group being deleted
63 * Store the group values
67 protected $_groupValues;
70 * what blocks should we show and hide.
72 * @var CRM_Core_ShowHideBlocks
77 * the civicrm_group_organization table id
81 protected $_groupOrganizationID;
84 * set up variables to build the form
89 function preProcess() {
90 $this->_id
= $this->get('id');
92 $breadCrumb = array(array('title' => ts('Manage Groups'),
93 'url' => CRM_Utils_System
::url('civicrm/group',
97 CRM_Utils_System
::appendBreadCrumb($breadCrumb);
99 $this->_groupValues
= array();
100 $params = array('id' => $this->_id
);
101 $this->_group
= CRM_Contact_BAO_Group
::retrieve($params, $this->_groupValues
);
102 $this->_title
= $this->_groupValues
['title'];
105 $this->assign('action', $this->_action
);
106 $this->assign('showBlockJS', TRUE);
108 if ($this->_action
== CRM_Core_Action
::DELETE
) {
109 if (isset($this->_id
)) {
110 $this->assign('title', $this->_title
);
111 $this->assign('count', CRM_Contact_BAO_Group
::memberCount($this->_id
));
112 CRM_Utils_System
::setTitle(ts('Confirm Group Delete'));
116 if (isset($this->_id
)) {
117 $groupValues = array(
119 'title' => $this->_title
,
121 isset($this->_groupValues
['saved_search_id']) ?
122 $this->_groupValues
['saved_search_id'] : '',
124 if (isset($this->_groupValues
['saved_search_id'])) {
125 $groupValues['mapping_id'] = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_SavedSearch',
126 $this->_groupValues
['saved_search_id'],
129 $groupValues['search_custom_id'] = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_SavedSearch',
130 $this->_groupValues
['saved_search_id'],
134 if (!empty($this->_groupValues
['created_id']))
135 $groupValues['created_by'] =
136 CRM_Core_DAO
::getFieldValue("CRM_Contact_DAO_Contact", $this->_groupValues
['created_id'] , 'sort_name', 'id');
138 if (!empty($this->_groupValues
['modified_id'])) {
139 $groupValues['modified_by'] =
140 CRM_Core_DAO
::getFieldValue("CRM_Contact_DAO_Contact", $this->_groupValues
['modified_id'] , 'sort_name', 'id');
143 $this->assign_by_ref('group', $groupValues);
145 CRM_Utils_System
::setTitle(ts('Group Settings: %1', array(1 => $this->_title
)));
147 $session = CRM_Core_Session
::singleton();
148 $session->pushUserContext(CRM_Utils_System
::url('civicrm/group', 'reset=1'));
152 CRM_Custom_Form_CustomData
::preProcess($this, NULL, NULL, 1, 'Group', $this->_id
);
156 * This function sets the default values for the form. LocationType that in edit/view mode
157 * the default values are retrieved from the database
162 function setDefaultValues() {
165 if (isset($this->_id
)) {
166 $defaults = $this->_groupValues
;
167 if (!empty($defaults['group_type'])) {
168 $types = explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
169 substr($defaults['group_type'], 1, -1)
171 $defaults['group_type'] = array();
172 foreach ($types as $type) {
173 $defaults['group_type'][$type] = 1;
177 if (CRM_Core_Permission
::check('administer Multiple Organizations') &&
178 CRM_Core_Permission
::isMultisiteEnabled()
180 CRM_Contact_BAO_GroupOrganization
::retrieve($this->_id
, $defaults);
182 if (!empty($defaults['group_organization'])) {
184 $this->_groupOrganizationID
= $defaults['group_organization'];
186 if (!empty($defaults['organization_id'])) {
187 $result = civicrm_api3('contact', 'getquick', array(
189 'id' => $defaults['organization_id']
191 $this->assign('organizationName', $result['values'][0]['data']);
194 $this->assign('organizationName', '');
199 if (!((CRM_Core_Permission
::check('access CiviMail')) ||
200 (CRM_Mailing_Info
::workflowEnabled() &&
201 CRM_Core_Permission
::check('create mailings')
204 $groupTypes = CRM_Core_OptionGroup
::values('group_type', TRUE);
205 if ($defaults['group_type'][$groupTypes['Mailing List']] == 1) {
206 $this->assign('freezeMailignList', $groupTypes['Mailing List']);
209 $this->assign('hideMailignList', $groupTypes['Mailing List']);
213 if (empty($defaults['parents'])) {
214 $defaults['parents'] = CRM_Core_BAO_Domain
::getGroupId();
217 // custom data set defaults
218 $defaults +
= CRM_Custom_Form_CustomData
::setDefaultValues($this);
223 * Function to actually build the form
228 public function buildQuickForm() {
229 if ($this->_action
== CRM_Core_Action
::DELETE
) {
230 $this->addButtons(array(
233 'name' => ts('Delete Group'),
238 'name' => ts('Cancel'),
245 $this->applyFilter('__ALL__', 'trim');
246 $this->add('text', 'title', ts('Name') . ' ',
247 CRM_Core_DAO
::getAttribute('CRM_Contact_DAO_Group', 'title'), TRUE
250 $this->add('textarea', 'description', ts('Description') . ' ',
251 CRM_Core_DAO
::getAttribute('CRM_Contact_DAO_Group', 'description')
254 $groupTypes = CRM_Core_OptionGroup
::values('group_type', TRUE);
255 $config = CRM_Core_Config
::singleton();
256 if (isset($this->_id
) && !empty($this->_groupValues
['saved_search_id'])) {
257 unset($groupTypes['Access Control']);
260 if (!empty($groupTypes)) {
261 $this->addCheckBox('group_type',
264 NULL, NULL, NULL, NULL, ' '
268 $this->add('select', 'visibility', ts('Visibility'),
269 CRM_Core_SelectValues
::ufVisibility(TRUE), TRUE
272 $groupNames = CRM_Core_PseudoConstant
::group();
274 $parentGroups = $parentGroupElements = array();
275 if (isset($this->_id
) && !empty($this->_groupValues
['parents'])) {
276 $parentGroupIds = explode(',', $this->_groupValues
['parents']);
277 foreach ($parentGroupIds as $parentGroupId) {
278 $parentGroups[$parentGroupId] = $groupNames[$parentGroupId];
279 if (array_key_exists($parentGroupId, $groupNames)) {
280 $parentGroupElements[$parentGroupId] = $groupNames[$parentGroupId];
281 $this->addElement('checkbox', "remove_parent_group_$parentGroupId",
282 $groupNames[$parentGroupId]
287 $this->assign_by_ref('parent_groups', $parentGroupElements);
289 if (isset($this->_id
)) {
290 $potentialParentGroupIds = CRM_Contact_BAO_GroupNestingCache
::getPotentialCandidates($this->_id
,
295 $potentialParentGroupIds = array_keys($groupNames);
298 $parentGroupSelectValues = array('' => '- ' . ts('select') . ' -');
299 foreach ($potentialParentGroupIds as $potentialParentGroupId) {
300 if (array_key_exists($potentialParentGroupId, $groupNames)) {
301 $parentGroupSelectValues[$potentialParentGroupId] = $groupNames[$potentialParentGroupId];
305 if (count($parentGroupSelectValues) > 1) {
306 if (CRM_Core_Permission
::isMultisiteEnabled()) {
307 $required = empty($parentGroups) ?
TRUE : FALSE;
308 $required = (($this->_id
&& CRM_Core_BAO_Domain
::isDomainGroup($this->_id
)) ||
310 ) ?
FALSE : $required;
315 $this->add('select', 'parents', ts('Add Parent'), $parentGroupSelectValues, $required);
317 if (CRM_Core_Permission
::check('administer Multiple Organizations') &&
318 CRM_Core_Permission
::isMultisiteEnabled()
320 //group organization Element
321 $groupOrgDataURL = CRM_Utils_System
::url('civicrm/ajax/search', 'org=1', FALSE, NULL, FALSE);
322 $this->assign('groupOrgDataURL', $groupOrgDataURL);
324 $this->addElement('text', 'organization', ts('Organization'), '');
325 $this->addElement('hidden', 'organization_id', '', array('id' => 'organization_id'));
328 // is_reserved property CRM-9936
329 $this->addElement('checkbox', 'is_reserved', ts('Reserved Group?'));
330 if (!CRM_Core_Permission
::check('administer reserved groups')) {
331 $this->freeze('is_reserved');
335 CRM_Custom_Form_CustomData
::buildQuickForm($this);
337 $this->addButtons(array(
341 ($this->_action
== CRM_Core_Action
::ADD
) ?
342 ts('Continue') : ts('Save'),
347 'name' => ts('Cancel'),
352 $doParentCheck = FALSE;
353 if (CRM_Core_Permission
::isMultisiteEnabled()) {
354 $doParentCheck = ($this->_id
&& CRM_Core_BAO_Domain
::isDomainGroup($this->_id
)) ?
FALSE : TRUE;
359 'parentGroups' => $parentGroups,
360 'doParentCheck' => $doParentCheck,
362 $this->addFormRule(array('CRM_Group_Form_Edit', 'formRule'), $options);
366 * global validation rules for the form
368 * @param array $fields posted values of the form
370 * @return array list of errors to be posted back to the form
374 static function formRule($fields, $fileParams, $options) {
377 $doParentCheck = $options['doParentCheck'];
378 $self = &$options['selfObj'];
380 if ($doParentCheck) {
381 $parentGroups = $options['parentGroups'];
384 foreach ($fields as $key => $val) {
385 if (substr($key, 0, 20) == 'remove_parent_group_') {
391 if (!empty($fields['parents'])) {
395 if ((count($parentGroups) >= 1) && (($grpRemove - $grpAdd) >= count($parentGroups))) {
396 $errors['parents'] = ts('Make sure at least one parent group is set.');
400 // do check for both name and title uniqueness
401 if (!empty($fields['title'])) {
402 $title = trim($fields['title']);
408 $params = array(1 => array($title, 'String'));
411 $query .= "AND id <> %2";
412 $params[2] = array($self->_id
, 'Integer');
415 $grpCnt = CRM_Core_DAO
::singleValueQuery($query, $params);
417 $errors['title'] = ts('Group \'%1\' already exists.', array(1 => $fields['title']));
421 return empty($errors) ?
TRUE : $errors;
425 * Process the form when submitted
430 public function postProcess() {
431 CRM_Utils_System
::flushCache('CRM_Core_DAO_Group');
433 $updateNestingCache = FALSE;
434 if ($this->_action
& CRM_Core_Action
::DELETE
) {
435 CRM_Contact_BAO_Group
::discard($this->_id
);
436 CRM_Core_Session
::setStatus(ts("The Group '%1' has been deleted.", array(1 => $this->_title
)), ts('Group Deleted'), 'success');
437 $updateNestingCache = TRUE;
440 // store the submitted values in an array
441 $params = $this->controller
->exportValues($this->_name
);
443 $params['is_active'] = CRM_Utils_Array
::value('is_active', $this->_groupValues
, 1);
445 if ($this->_action
& CRM_Core_Action
::UPDATE
) {
446 $params['id'] = $this->_id
;
449 if ($this->_action
& CRM_Core_Action
::UPDATE
&& isset($this->_groupOrganizationID
)) {
450 $params['group_organization'] = $this->_groupOrganizationID
;
453 $params['is_reserved'] = CRM_Utils_Array
::value('is_reserved', $params, FALSE);
455 $customFields = CRM_Core_BAO_CustomField
::getFields('Group');
456 $params['custom'] = CRM_Core_BAO_CustomField
::postProcess($params,
462 $group = CRM_Contact_BAO_Group
::create($params);
465 * Remove any parent groups requested to be removed
468 if (!empty($this->_groupValues
['parents'])) {
469 $parentGroupIds = explode(',', $this->_groupValues
['parents']);
470 foreach ($parentGroupIds as $parentGroupId) {
471 if (isset($params["remove_parent_group_$parentGroupId"])) {
472 CRM_Contact_BAO_GroupNesting
::remove($parentGroupId, $group->id
);
473 $updateNestingCache = TRUE;
478 CRM_Core_Session
::setStatus(ts('The Group \'%1\' has been saved.', array(1 => $group->title
)), ts('Group Saved'), 'success');
481 * Add context to the session, in case we are adding members to the group
484 if ($this->_action
& CRM_Core_Action
::ADD
) {
485 $this->set('context', 'amtg');
486 $this->set('amtgID', $group->id
);
488 $session = CRM_Core_Session
::singleton();
489 $session->pushUserContext(CRM_Utils_System
::url('civicrm/group/search', 'reset=1&force=1&context=smog&gid=' . $group->id
));
493 // update the nesting cache
494 if ($updateNestingCache) {
495 CRM_Contact_BAO_GroupNestingCache
::update();