3 +--------------------------------------------------------------------+
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2018 |
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-2018
35 * This class generates form components for Relationship Type.
37 class CRM_Admin_Form_RelationshipType
extends CRM_Admin_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
= [
65 'name' => 'label_a_b',
66 'description' => ts("Label for the relationship from Contact A to Contact B. EXAMPLE: Contact A is 'Parent of' Contact B."),
70 'name' => 'label_b_a',
71 'description' => ts("Label for the relationship from Contact B to Contact A. EXAMPLE: Contact B is 'Child of' Contact A. You may leave this blank for relationships where the name is the same in both directions (e.g. Spouse).")
73 'description' => ['name' => 'description'],
74 'contact_types_a' => ['name' => 'contact_types_a', 'not-auto-addable' => TRUE],
75 'contact_types_b' => ['name' => 'contact_types_b', 'not-auto-addable' => TRUE],
76 'is_active' => ['name' => 'is_active'],
81 * Deletion message to be assigned to the form.
85 protected $deleteMessage;
88 * Explicitly declare the entity api name.
90 public function getDefaultEntity() {
91 return 'RelationshipType';
95 * Set the delete message.
97 * We do this from the constructor in order to do a translation.
99 public function setDeleteMessage() {
100 $this->deleteMessage
= ts('WARNING: Deleting this option will result in the loss of all Relationship records of this type.') . ts('This may mean the loss of a substantial amount of data, and the action cannot be undone.') . ts('Do you want to continue?');
104 * Build the form object.
106 public function buildQuickForm() {
107 $isReserved = ($this->_id
&& CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_RelationshipType', $this->_id
, 'is_reserved'));
108 $this->entityFields
['is_active']['is_freeze'] = $isReserved;
110 self
::buildQuickEntityForm();
111 if ($this->_action
& CRM_Core_Action
::DELETE
) {
115 $this->addRule('label_a_b', ts('Label already exists in Database.'),
116 'objectExists', array('CRM_Contact_DAO_RelationshipType', $this->_id
, 'label_a_b')
118 $this->addRule('label_b_a', ts('Label already exists in Database.'),
119 'objectExists', array('CRM_Contact_DAO_RelationshipType', $this->_id
, 'label_b_a')
122 $contactTypes = CRM_Contact_BAO_ContactType
::getSelectElements(FALSE, TRUE, '__');
123 foreach (['contact_types_a' => ts('Contact Type A'), 'contact_types_b' => ts('Contact Type B')] as $name => $label) {
124 $element = $this->add('select', $name, $label . ' ',
126 '' => ts('All Contacts'),
134 if ($this->_action
& CRM_Core_Action
::VIEW
) {
143 public function setDefaultValues() {
144 if ($this->_action
!= CRM_Core_Action
::DELETE
&&
147 $defaults = $params = array();
148 $params = array('id' => $this->_id
);
149 $baoName = $this->_BAOName
;
150 $baoName::retrieve($params, $defaults);
151 $defaults['contact_types_a'] = CRM_Utils_Array
::value('contact_type_a', $defaults);
152 if (!empty($defaults['contact_sub_type_a'])) {
153 $defaults['contact_types_a'] .= '__' . $defaults['contact_sub_type_a'];
156 $defaults['contact_types_b'] = CRM_Utils_Array
::value('contact_type_b', $defaults);
157 if (!empty($defaults['contact_sub_type_b'])) {
158 $defaults['contact_types_b'] .= '__' . $defaults['contact_sub_type_b'];
163 return parent
::setDefaultValues();
168 * Process the form submission.
170 public function postProcess() {
171 if ($this->_action
& CRM_Core_Action
::DELETE
) {
172 CRM_Contact_BAO_RelationshipType
::del($this->_id
);
173 CRM_Core_Session
::setStatus(ts('Selected Relationship type has been deleted.'), ts('Record Deleted'), 'success');
176 // store the submitted values in an array
177 $params = $this->exportValues();
178 $params['is_active'] = CRM_Utils_Array
::value('is_active', $params, FALSE);
180 if ($this->_action
& CRM_Core_Action
::UPDATE
) {
181 $params['id'] = $this->_id
;
184 $cTypeA = CRM_Utils_System
::explode('__',
185 $params['contact_types_a'],
188 $cTypeB = CRM_Utils_System
::explode('__',
189 $params['contact_types_b'],
193 $params['contact_type_a'] = $cTypeA[0];
194 $params['contact_type_b'] = $cTypeB[0];
196 $params['contact_sub_type_a'] = $cTypeA[1] ?
$cTypeA[1] : 'null';
197 $params['contact_sub_type_b'] = $cTypeB[1] ?
$cTypeB[1] : 'null';
199 if (!strlen(trim(CRM_Utils_Array
::value('label_b_a', $params)))) {
200 $params['label_b_a'] = CRM_Utils_Array
::value('label_a_b', $params);
203 if (empty($params['id'])) {
204 // Set name on created but don't update on update as the machine name is not exposed.
205 $params['name_b_a'] = CRM_Utils_String
::munge($params['label_b_a']);
206 $params['name_a_b'] = CRM_Utils_String
::munge($params['label_a_b']);
209 $result = civicrm_api3('RelationshipType', 'create', $params);
211 $this->ajaxResponse
['relationshipType'] = $result['values'];
213 CRM_Core_Session
::setStatus(ts('The Relationship Type has been saved.'), ts('Saved'), 'success');