3 +--------------------------------------------------------------------+
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2019 |
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-2019
35 * This class is for UF Group (Profile) configuration.
37 class CRM_UF_Form_Group
extends CRM_Core_Form
{
39 use CRM_Core_Form_EntityFormTrait
;
42 * Fields for the entity to be assigned to the template.
44 * Fields may have keys
45 * - name (required to show in tpl from the array)
46 * - description (optional, will appear below the field)
47 * - not-auto-addable - this class will not attempt to add the field using addField.
48 * (this will be automatically set if the field does not have html in it's metadata
49 * or is not a core field on the form's entity).
50 * - help (option) add help to the field - e.g ['id' => 'id-source', 'file' => 'CRM/Contact/Form/Contact']]
51 * - template - use a field specific template to render this field
53 * - is_freeze (field should be frozen).
57 protected $entityFields = [];
60 * Set entity fields to be assigned to the form.
62 protected function setEntityFields() {
63 $this->entityFields
= [
64 'title' => ['name' => 'title'],
65 'frontend_title' => ['name' => 'frontend_title'],
66 'description' => ['name' => 'description', 'help' => ['id' => 'id-description', 'file' => 'CRM/UF/Form/Group.hlp']],
67 'uf_group_type' => ['name' => 'uf_group_type', 'not-auto-addable' => TRUE, 'help' => ['id' => 'id-used_for', 'file' => 'CRM/UF/Form/Group.hlp'], 'post_html_text' => ' ' . $this->getOtherModuleString()],
68 'cancel_button_text' => ['name' => 'cancel_button_text', 'help' => ['id' => 'id-cancel_button_text', 'file' => 'CRM/UF/Form/Group.hlp'], 'class' => 'cancel_button_section'],
69 'submit_button_text' => ['name' => 'submit_button_text', 'help' => ['id' => 'id-submit_button_text', 'file' => 'CRM/UF/Form/Group.hlp'], 'class' => ''],
74 * Explicitly declare the entity api name.
76 public function getDefaultEntity() {
81 * The form id saved to the session for an update.
88 * The title for group.
93 protected $_groupElement;
98 * Set variables up before form is built.
100 public function preProcess() {
102 $this->_id
= $this->get('id');
104 $this->_id
= CRM_Utils_Request
::retrieve('id', 'Positive', $this, FALSE, 0);
106 $this->assign('gid', $this->_id
);
107 $this->_group
= CRM_Core_PseudoConstant
::group();
109 if ($this->_action
& (CRM_Core_Action
::UPDATE | CRM_Core_Action
::DELETE
)) {
110 $title = CRM_Core_BAO_UFGroup
::getTitle($this->_id
);
111 $this->assign('profileTitle', $title);
114 // setting title for html page
115 if ($this->_action
& CRM_Core_Action
::UPDATE
) {
116 CRM_Utils_System
::setTitle(ts('Profile Settings') . " - $title");
118 elseif ($this->_action
& (CRM_Core_Action
::DISABLE | CRM_Core_Action
::DELETE
)) {
119 $ufGroup['module'] = implode(' , ', CRM_Core_BAO_UFGroup
::getUFJoinRecord($this->_id
, TRUE));
121 $status = CRM_Core_BAO_UFGroup
::usedByModule($this->_id
);
122 if ($this->_action
& (CRM_Core_Action
::DISABLE
)) {
124 $message = 'This profile is currently used for ' . $ufGroup['module'] . '. If you disable the profile - it will be removed from these forms and/or modules. Do you want to continue?';
127 $message = 'Are you sure you want to disable this Profile?';
132 $message = 'This profile is currently used for ' . $ufGroup['module'] . '. If you delete the profile - it will be removed from these forms and/or modules. This action cannot be undone. Do you want to continue?';
135 $message = 'Are you sure you want to delete this Profile? This action cannot be undone.';
138 $this->assign('message', $message);
141 CRM_Utils_System
::setTitle(ts('New CiviCRM Profile'));
146 * Build the form object.
150 public function buildQuickForm() {
151 self
::buildQuickEntityForm();
152 if ($this->_action
& (CRM_Core_Action
::DISABLE | CRM_Core_Action
::DELETE
)) {
153 if ($this->_action
& (CRM_Core_Action
::DISABLE
)) {
154 $display = 'Disable Profile';
157 $display = 'Delete Profile';
159 $this->addButtons(array(
163 'spacing' => ' ',
168 'name' => ts('Cancel'),
175 $uf_group_type = array();
176 $UFGroupType = CRM_Core_SelectValues
::ufGroupTypes();
177 foreach ($UFGroupType as $key => $value) {
178 $uf_group_type[] = $this->createElement('checkbox', $key, NULL, $value);
180 $this->addGroup($uf_group_type, 'uf_group_type', ts('Used For'), ' ');
183 $this->add('wysiwyg', 'help_pre', ts('Pre-form Help'), CRM_Core_DAO
::getAttribute('CRM_Core_DAO_UFGroup', 'help_post'));
184 $this->add('wysiwyg', 'help_post', ts('Post-form Help'), CRM_Core_DAO
::getAttribute('CRM_Core_DAO_UFGroup', 'help_post'));
187 $this->add('text', 'weight', ts('Order'), CRM_Core_DAO
::getAttribute('CRM_Core_DAO_UFJoin', 'weight'), TRUE);
188 $this->addRule('weight', ts('is a numeric field'), 'numeric');
190 // is this group active ?
191 $this->addElement('checkbox', 'is_active', ts('Is this CiviCRM Profile active?'));
193 $paneNames = array('Advanced Settings' => 'buildAdvanceSetting');
195 foreach ($paneNames as $name => $type) {
197 $dataURL = "&reset=1&action=update&id={$this->_id}&snippet=4&formType={$type}";
200 $dataURL = "&reset=1&action=add&snippet=4&formType={$type}";
203 $allPanes[$name] = array(
204 'url' => CRM_Utils_System
::url('civicrm/admin/uf/group/setting',
211 CRM_UF_Form_AdvanceSetting
::$type($this);
214 $this->addButtons(array(
217 'name' => ts('Save'),
218 'spacing' => ' ',
223 'name' => ts('Cancel'),
227 // views are implemented as frozen form
228 if ($this->_action
& CRM_Core_Action
::VIEW
) {
230 $this->addElement('button', 'done', ts('Done'), array('onclick' => "location.href='civicrm/admin/uf/group?reset=1&action=browse'"));
233 $this->addFormRule(array('CRM_UF_Form_Group', 'formRule'), $this);
237 * Set default values for the form. Note that in edit/view mode
238 * the default values are retrieved from the database
243 public function setDefaultValues() {
245 $showHide = new CRM_Core_ShowHideBlocks();
247 if ($this->_action
== CRM_Core_Action
::ADD
) {
248 $defaults['weight'] = CRM_Utils_Weight
::getDefaultWeight('CRM_Core_DAO_UFJoin');
251 //id fetched for Dojo Pane
252 $pId = CRM_Utils_Request
::retrieve('id', 'Positive', $this);
257 if ((isset($this->_id
))) {
259 $defaults['weight'] = CRM_Core_BAO_UFGroup
::getWeight($this->_id
);
261 $params = array('id' => $this->_id
);
262 CRM_Core_BAO_UFGroup
::retrieve($params, $defaults);
263 $defaults['group'] = CRM_Utils_Array
::value('limit_listings_group_id', $defaults);
264 $defaults['add_contact_to_group'] = CRM_Utils_Array
::value('add_to_group_id', $defaults);
265 //get the uf join records for current uf group
266 $ufJoinRecords = CRM_Core_BAO_UFGroup
::getUFJoinRecord($this->_id
);
267 foreach ($ufJoinRecords as $key => $value) {
268 $checked[$value] = 1;
270 $defaults['uf_group_type'] = isset($checked) ?
$checked : "";
283 'is_proximity_search',
285 foreach ($advFields as $key) {
286 if (!empty($defaults[$key])) {
288 $this->_allPanes
['Advanced Settings']['open'] = 'true';
294 $defaults['add_cancel_button'] = 1;
295 $defaults['is_active'] = 1;
296 $defaults['is_map'] = 0;
297 $defaults['is_update_dupe'] = 0;
298 $defaults['is_proximity_search'] = 0;
300 // Don't assign showHide elements to template in DELETE mode (fields to be shown and hidden don't exist)
301 if (!($this->_action
& CRM_Core_Action
::DELETE
) && !($this->_action
& CRM_Core_Action
::DISABLE
)) {
302 $showHide->addToTemplate();
304 $this->assign('allPanes', $this->_allPanes
);
311 * @param array $fields
312 * The input form values.
313 * @param array $files
314 * The uploaded files if any.
316 * Current form object.
319 * true if no errors, else array of errors
321 public static function formRule($fields, $files, $self) {
324 //validate profile title as well as name.
325 $title = $fields['title'];
326 $name = CRM_Utils_String
::munge($title, '_', 56);
327 $name .= $self->_id ?
'_' . $self->_id
: '';
328 $query = 'select count(*) from civicrm_uf_group where ( name like %1 ) and id != %2';
329 $pCnt = CRM_Core_DAO
::singleValueQuery($query, array(
330 1 => array($name, 'String'),
331 2 => array((int) $self->_id
, 'Integer'),
334 $errors['title'] = ts('Profile \'%1\' already exists in Database.', array(1 => $title));
337 return empty($errors) ?
TRUE : $errors;
345 public function postProcess() {
346 if ($this->_action
& CRM_Core_Action
::DELETE
) {
347 $title = CRM_Core_BAO_UFGroup
::getTitle($this->_id
);
348 CRM_Core_BAO_UFGroup
::del($this->_id
);
349 CRM_Core_Session
::setStatus(ts("Your CiviCRM Profile '%1' has been deleted.", array(1 => $title)), ts('Profile Deleted'), 'success');
351 elseif ($this->_action
& CRM_Core_Action
::DISABLE
) {
352 $ufJoinParams = array('uf_group_id' => $this->_id
);
353 CRM_Core_BAO_UFGroup
::delUFJoin($ufJoinParams);
355 CRM_Core_BAO_UFGroup
::setIsActive($this->_id
, 0);
358 // get the submitted form values.
360 $params = $this->controller
->exportValues($this->_name
);
362 if (!array_key_exists('is_active', $params)) {
363 $params['is_active'] = 0;
366 if ($this->_action
& (CRM_Core_Action
::UPDATE
)) {
367 $ids['ufgroup'] = $this->_id
;
369 // lets skip trying to mess around with profile weights and allow the user to do as needed.
371 elseif ($this->_action
& CRM_Core_Action
::ADD
) {
372 $session = CRM_Core_Session
::singleton();
373 $params['created_id'] = $session->get('userID');
374 $params['created_date'] = date('YmdHis');
378 $ufGroup = CRM_Core_BAO_UFGroup
::add($params, $ids);
380 if (!empty($params['is_active'])) {
381 //make entry in uf join table
382 CRM_Core_BAO_UFGroup
::createUFJoin($params, $ufGroup->id
);
384 elseif ($this->_id
) {
385 // this profile has been set to inactive, delete all corresponding UF Join's
386 $ufJoinParams = array('uf_group_id' => $this->_id
);
387 CRM_Core_BAO_UFGroup
::delUFJoin($ufJoinParams);
390 if ($this->_action
& CRM_Core_Action
::UPDATE
) {
391 $url = CRM_Utils_System
::url('civicrm/admin/uf/group', 'reset=1&action=browse');
392 CRM_Core_Session
::setStatus(ts("Your CiviCRM Profile '%1' has been saved.", array(1 => $ufGroup->title
)), ts('Profile Saved'), 'success');
395 // Jump directly to adding a field if popups are disabled
396 $action = CRM_Core_Resources
::singleton()->ajaxPopupsEnabled ?
'' : '/add';
397 $url = CRM_Utils_System
::url("civicrm/admin/uf/group/field$action", 'reset=1&new=1&gid=' . $ufGroup->id
. '&action=' . ($action ?
'add' : 'browse'));
398 CRM_Core_Session
::setStatus(ts('Your CiviCRM Profile \'%1\' has been added. You can add fields to this profile now.',
399 array(1 => $ufGroup->title
)
400 ), ts('Profile Added'), 'success');
402 $session = CRM_Core_Session
::singleton();
403 $session->replaceUserContext($url);
406 // update cms integration with registration / my account
407 CRM_Utils_System
::updateCategories();
411 * Set the delete message.
413 * We do this from the constructor in order to do a translation.
415 public function setDeleteMessage() {}
418 * Get the string to display next to the used for field indicating unchangeable uses.
422 protected function getOtherModuleString() {
423 $otherModules = CRM_Core_BAO_UFGroup
::getUFJoinRecord($this->_id
, TRUE, TRUE);
424 if (!empty($otherModules)) {
425 $otherModuleString = NULL;
426 foreach ($otherModules as $key) {
427 $otherModuleString .= " [ x ] <label>" . $key . "</label>";
430 return $otherModuleString;