3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.3 |
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 generates form components generic to all the contact types.
39 * It delegates the work to lower level subclasses and integrates the changes
40 * back in. It also uses a lot of functionality with the CRM API's, so any change
41 * made here could potentially affect the API etc. Be careful, be aware, use unit tests.
44 class CRM_Contact_Form_RelatedContact
extends CRM_Core_Form
{
47 * The contact type of the form
51 protected $_contactType;
54 * The contact id, used when editing the form
65 protected $_defaults = array();
68 * build all the data structures needed to build the form
73 function preProcess() {
74 // reset action from the session
75 $this->_action
= CRM_Utils_Request
::retrieve('action', 'String',
76 $this, FALSE, 'update'
78 $this->_contactId
= CRM_Utils_Request
::retrieve('cid', 'Positive', $this, TRUE);
80 $rcid = CRM_Utils_Request
::retrieve('rcid', 'Positive', $this);
81 $rcid = $rcid ?
"&id={$rcid}" : '';
82 $session = CRM_Core_Session
::singleton();
83 $session->pushUserContext(CRM_Utils_System
::url('civicrm/user', "reset=1{$rcid}"));
85 if ($this->_contactId
) {
86 $contact = new CRM_Contact_DAO_Contact();
87 $contact->id
= $this->_contactId
;
88 if (!$contact->find(TRUE)) {
89 CRM_Core_Error
::statusBounce(ts('contact does not exist: %1', array(1 => $this->_contactId
)));
91 $this->_contactType
= $contact->contact_type
;
93 // check for permissions
94 if (!CRM_Contact_BAO_Contact_Permission
::allow($this->_contactId
, CRM_Core_Permission
::EDIT
)) {
95 CRM_Core_Error
::statusBounce(ts('You do not have the necessary permission to edit this contact.'));
98 list($displayName, $contactImage) = CRM_Contact_BAO_Contact
::getDisplayAndImage($this->_contactId
);
99 CRM_Utils_System
::setTitle($displayName, $contactImage . ' ' . $displayName);
102 CRM_Core_Error
::statusBounce(ts('Could not get a contact_id and/or contact_type'));
107 * This function sets the default values for the form. Note that in edit/view mode
108 * the default values are retrieved from the database
114 function setDefaultValues() {
115 return $this->_defaults
;
119 * Function to actually build the form
124 public function buildQuickForm() {
126 $params['id'] = $params['contact_id'] = $this->_contactId
;
127 $contact = CRM_Contact_BAO_Contact
::retrieve($params, $this->_defaults
);
129 $countryID = CRM_Utils_Array
::value('country_id',
130 $this->_defaults
['address'][1]
132 $stateID = CRM_Utils_Array
::value('state_province_id',
133 $this->_defaults
['address'][1]
135 CRM_Contact_BAO_Contact_Utils
::buildOnBehalfForm($this,
139 'Contact Information',
143 $this->addButtons(array(
146 'name' => ts('Save'),
151 'name' => ts('Cancel'),
157 * Form submission of new/edit contact is processed.
163 public function postProcess() {
164 // store the submitted values in an array
165 $params = $this->controller
->exportValues($this->_name
);
167 $locType = CRM_Core_BAO_LocationType
::getDefault();
169 'phone', 'email', 'address') as $locFld) {
170 if (!empty($this->_defaults
[$locFld]) && $this->_defaults
[$locFld][1]['location_type_id']) {
171 $params[$locFld][1]['is_primary'] = $this->_defaults
[$locFld][1]['is_primary'];
172 $params[$locFld][1]['location_type_id'] = $this->_defaults
[$locFld][1]['location_type_id'];
175 $params[$locFld][1]['is_primary'] = 1;
176 $params[$locFld][1]['location_type_id'] = $locType->id
;
180 $params['contact_type'] = $this->_contactType
;
181 $params['contact_id'] = $this->_contactId
;
183 $contact = CRM_Contact_BAO_Contact
::create($params, TRUE);
185 // set status message.
186 if ($this->_contactId
) {
187 $message = ts('%1 has been updated.', array(1 => $contact->display_name
));
190 $message = ts('%1 has been created.', array(1 => $contact->display_name
));
192 CRM_Core_Session
::setStatus($message, ts('Contact Saved'), 'success');