Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?php |
2 | /* | |
3 | +--------------------------------------------------------------------+ | |
bc77d7c0 | 4 | | Copyright CiviCRM LLC. All rights reserved. | |
6a488035 | 5 | | | |
bc77d7c0 TO |
6 | | This work is published under the GNU AGPLv3 license with some | |
7 | | permitted exceptions and without any warranty. For full license | | |
8 | | and copyright information, see https://civicrm.org/licensing | | |
6a488035 | 9 | +--------------------------------------------------------------------+ |
d25dd0ee | 10 | */ |
6a488035 TO |
11 | |
12 | /** | |
13 | * | |
14 | * @package CRM | |
ca5cec67 | 15 | * @copyright CiviCRM LLC https://civicrm.org/licensing |
6a488035 TO |
16 | */ |
17 | ||
18 | /** | |
19 | * Main page for viewing contact. | |
6a488035 TO |
20 | */ |
21 | class CRM_Contact_Page_View extends CRM_Core_Page { | |
22 | ||
23 | /** | |
100fef9d | 24 | * The id of the object being viewed (note/relationship etc) |
6a488035 | 25 | * |
69078420 | 26 | * @var int |
6a488035 TO |
27 | */ |
28 | protected $_id; | |
29 | ||
30 | /** | |
100fef9d | 31 | * The contact id of the contact being viewed |
6a488035 | 32 | * |
69078420 | 33 | * @var int |
6a488035 TO |
34 | */ |
35 | protected $_contactId; | |
36 | ||
37 | /** | |
38 | * The action that we are performing | |
39 | * | |
69078420 | 40 | * @var string |
6a488035 TO |
41 | */ |
42 | protected $_action; | |
43 | ||
44 | /** | |
45 | * The permission we have on this contact | |
46 | * | |
69078420 | 47 | * @var string |
6a488035 TO |
48 | */ |
49 | protected $_permission; | |
50 | ||
51 | /** | |
95cdcc0f | 52 | * Heart of the viewing process. |
6a488035 | 53 | * |
95cdcc0f | 54 | * The runner gets all the meta data for the contact and calls the appropriate type of page to view. |
6a488035 | 55 | */ |
00be9182 | 56 | public function preProcess() { |
6a488035 TO |
57 | // process url params |
58 | $this->_id = CRM_Utils_Request::retrieve('id', 'Positive', $this); | |
59 | $this->assign('id', $this->_id); | |
60 | ||
61 | $qfKey = CRM_Utils_Request::retrieve('key', 'String', $this); | |
62 | //validate the qfKey | |
63 | if (!CRM_Utils_Rule::qfKey($qfKey)) { | |
64 | $qfKey = NULL; | |
65 | } | |
66 | $this->assign('searchKey', $qfKey); | |
67 | ||
68 | // retrieve the group contact id, so that we can get contact id | |
69 | $gcid = CRM_Utils_Request::retrieve('gcid', 'Positive', $this); | |
70 | ||
71 | if (!$gcid) { | |
780f5a52 | 72 | $this->_contactId = CRM_Utils_Request::retrieve('cid', 'Positive', $this); |
6a488035 TO |
73 | } |
74 | else { | |
75 | $this->_contactId = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_GroupContact', $gcid, 'contact_id'); | |
76 | } | |
77 | ||
78 | if (!$this->_contactId) { | |
79 | CRM_Core_Error::statusBounce( | |
80 | ts('We could not find a contact id.'), | |
81 | CRM_Utils_System::url('civicrm/dashboard', 'reset=1') | |
82 | ); | |
83 | } | |
84 | ||
85 | // ensure that the id does exist | |
481a74f4 | 86 | if (CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'id') != $this->_contactId) { |
6a488035 | 87 | CRM_Core_Error::statusBounce( |
be2fb01f | 88 | ts('A Contact with that ID does not exist: %1', [1 => $this->_contactId]), |
6a488035 TO |
89 | CRM_Utils_System::url('civicrm/dashboard', 'reset=1') |
90 | ); | |
91 | } | |
92 | ||
93 | $this->assign('contactId', $this->_contactId); | |
94 | ||
95 | // see if we can get prev/next positions from qfKey | |
be2fb01f | 96 | $navContacts = [ |
6a488035 TO |
97 | 'prevContactID' => NULL, |
98 | 'prevContactName' => NULL, | |
99 | 'nextContactID' => NULL, | |
100 | 'nextContactName' => NULL, | |
101 | 'nextPrevError' => 0, | |
be2fb01f | 102 | ]; |
6a488035 | 103 | if ($qfKey) { |
d379a6d9 | 104 | $pos = Civi::service('prevnext')->getPositions("civicrm search $qfKey", |
6a488035 TO |
105 | $this->_contactId, |
106 | $this->_contactId | |
107 | ); | |
108 | $found = FALSE; | |
109 | ||
110 | if (isset($pos['prev'])) { | |
111 | $navContacts['prevContactID'] = $pos['prev']['id1']; | |
112 | $navContacts['prevContactName'] = $pos['prev']['data']; | |
113 | $found = TRUE; | |
114 | } | |
115 | ||
116 | if (isset($pos['next'])) { | |
117 | $navContacts['nextContactID'] = $pos['next']['id1']; | |
118 | $navContacts['nextContactName'] = $pos['next']['data']; | |
119 | $found = TRUE; | |
120 | } | |
121 | ||
9c1bc317 | 122 | $context = $_GET['context'] ?? NULL; |
6a488035 TO |
123 | if (!$found) { |
124 | // seems like we did not find any contacts | |
125 | // maybe due to bug CRM-9096 | |
126 | // however we should account for 1 contact results (which dont have prev next) | |
127 | if (!$pos['foundEntry']) { | |
128 | $navContacts['nextPrevError'] = 1; | |
129 | } | |
130 | } | |
72b60e71 CW |
131 | elseif ($context) { |
132 | $this->assign('context', $context); | |
be2fb01f CW |
133 | CRM_Utils_System::appendBreadCrumb([ |
134 | [ | |
72b60e71 | 135 | 'title' => ts('Search Results'), |
be2fb01f CW |
136 | 'url' => CRM_Utils_System::url("civicrm/contact/search/$context", ['qfKey' => $qfKey]), |
137 | ], | |
138 | ]); | |
72b60e71 | 139 | } |
6a488035 TO |
140 | } |
141 | $this->assign($navContacts); | |
142 | ||
143 | $path = CRM_Utils_System::url('civicrm/contact/view', 'reset=1&cid=' . $this->_contactId); | |
be2fb01f | 144 | CRM_Utils_System::appendBreadCrumb([['title' => ts('View Contact'), 'url' => $path]]); |
6a488035 TO |
145 | |
146 | if ($image_URL = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'image_URL')) { | |
c3821398 | 147 | $this->assign("imageURL", CRM_Utils_File::getImageURL($image_URL)); |
6a488035 TO |
148 | } |
149 | ||
150 | // also store in session for future use | |
151 | $session = CRM_Core_Session::singleton(); | |
152 | $session->set('view.id', $this->_contactId); | |
153 | ||
154 | $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this, FALSE, 'browse'); | |
155 | $this->assign('action', $this->_action); | |
156 | ||
157 | // check logged in user permission | |
158 | self::checkUserPermission($this); | |
159 | ||
006389de | 160 | list($displayName, $contactImage, $contactType, $contactSubtype, $contactImageUrl) = self::getContactDetails($this->_contactId); |
6a488035 TO |
161 | $this->assign('displayName', $displayName); |
162 | ||
163 | $this->set('contactType', $contactType); | |
ae34b946 DS |
164 | |
165 | // note: there could still be multiple subtypes. We just trimming the outer separator. | |
166 | $this->set('contactSubtype', trim($contactSubtype, CRM_Core_DAO::VALUE_SEPARATOR)); | |
6a488035 TO |
167 | |
168 | // add to recently viewed block | |
169 | $isDeleted = (bool) CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'is_deleted'); | |
170 | ||
be2fb01f | 171 | $recentOther = [ |
6a488035 TO |
172 | 'imageUrl' => $contactImageUrl, |
173 | 'subtype' => $contactSubtype, | |
174 | 'isDeleted' => $isDeleted, | |
be2fb01f | 175 | ]; |
6a488035 | 176 | |
1795d03b | 177 | if (CRM_Contact_BAO_Contact_Permission::allow($this->_contactId, CRM_Core_Permission::EDIT)) { |
6a488035 TO |
178 | $recentOther['editUrl'] = CRM_Utils_System::url('civicrm/contact/add', "reset=1&action=update&cid={$this->_contactId}"); |
179 | } | |
180 | ||
181 | if (($session->get('userID') != $this->_contactId) && CRM_Core_Permission::check('delete contacts') | |
182 | && !$isDeleted | |
183 | ) { | |
184 | $recentOther['deleteUrl'] = CRM_Utils_System::url('civicrm/contact/view/delete', "reset=1&delete=1&cid={$this->_contactId}"); | |
185 | } | |
186 | ||
187 | CRM_Utils_Recent::add($displayName, | |
188 | CRM_Utils_System::url('civicrm/contact/view', "reset=1&cid={$this->_contactId}"), | |
189 | $this->_contactId, | |
190 | $contactType, | |
191 | $this->_contactId, | |
192 | $displayName, | |
193 | $recentOther | |
194 | ); | |
195 | $this->assign('isDeleted', $isDeleted); | |
196 | ||
197 | // set page title | |
198 | $title = self::setTitle($this->_contactId, $isDeleted); | |
199 | $this->assign('title', $title); | |
aafd773a | 200 | |
6a488035 TO |
201 | // Check if this is default domain contact CRM-10482 |
202 | if (CRM_Contact_BAO_Contact::checkDomainContact($this->_contactId)) { | |
203 | $this->assign('domainContact', TRUE); | |
0db6c3e1 TO |
204 | } |
205 | else { | |
88b7498f | 206 | $this->assign('domainContact', FALSE); |
6a488035 TO |
207 | } |
208 | ||
209 | // Add links for actions menu | |
210 | self::addUrls($this, $this->_contactId); | |
211 | ||
212 | if ($contactType == 'Organization' && | |
213 | CRM_Core_Permission::check('administer Multiple Organizations') && | |
aaffa79f | 214 | Civi::settings()->get('is_enabled')) { |
6a488035 TO |
215 | //check is any relationship between the organization and groups |
216 | $groupOrg = CRM_Contact_BAO_GroupOrganization::hasGroupAssociated($this->_contactId); | |
217 | if ($groupOrg) { | |
218 | $groupOrganizationUrl = CRM_Utils_System::url('civicrm/group', | |
219 | "reset=1&oid={$this->_contactId}" | |
220 | ); | |
221 | $this->assign('groupOrganizationUrl', $groupOrganizationUrl); | |
222 | } | |
223 | } | |
224 | } | |
225 | ||
226 | /** | |
227 | * Get meta details of the contact. | |
228 | * | |
100fef9d | 229 | * @param int $contactId |
fd31fa4c | 230 | * |
a6c01b45 CW |
231 | * @return array |
232 | * contact fields in fixed order | |
6a488035 | 233 | */ |
00be9182 | 234 | public static function getContactDetails($contactId) { |
6a488035 TO |
235 | return list($displayName, |
236 | $contactImage, | |
237 | $contactType, | |
238 | $contactSubtype, | |
239 | $contactImageUrl | |
353ffa53 | 240 | ) = CRM_Contact_BAO_Contact::getDisplayAndImage($contactId, |
6a488035 TO |
241 | TRUE, |
242 | TRUE | |
006389de | 243 | ); |
6a488035 TO |
244 | } |
245 | ||
4319322b EM |
246 | /** |
247 | * @param $page | |
100fef9d | 248 | * @param int $contactID |
4319322b | 249 | */ |
00be9182 | 250 | public static function checkUserPermission($page, $contactID = NULL) { |
6a488035 TO |
251 | // check for permissions |
252 | $page->_permission = NULL; | |
253 | ||
254 | if (!$contactID) { | |
255 | $contactID = $page->_contactId; | |
256 | } | |
257 | ||
258 | // automatically grant permissin for users on their own record. makes | |
259 | // things easier in dashboard | |
260 | $session = CRM_Core_Session::singleton(); | |
261 | ||
ad623fd4 | 262 | if ($session->get('userID') == $contactID && CRM_Core_Permission::check('edit my contact')) { |
6a488035 TO |
263 | $page->assign('permission', 'edit'); |
264 | $page->_permission = CRM_Core_Permission::EDIT; | |
265 | // deleted contacts’ stuff should be (at best) only viewable | |
266 | } | |
267 | elseif (CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $contactID, 'is_deleted') and CRM_Core_Permission::check('access deleted contacts')) { | |
268 | $page->assign('permission', 'view'); | |
269 | $page->_permission = CRM_Core_Permission::VIEW; | |
270 | } | |
271 | elseif (CRM_Contact_BAO_Contact_Permission::allow($contactID, CRM_Core_Permission::EDIT)) { | |
272 | $page->assign('permission', 'edit'); | |
273 | $page->_permission = CRM_Core_Permission::EDIT; | |
274 | } | |
275 | elseif (CRM_Contact_BAO_Contact_Permission::allow($contactID, CRM_Core_Permission::VIEW)) { | |
276 | $page->assign('permission', 'view'); | |
277 | $page->_permission = CRM_Core_Permission::VIEW; | |
278 | } | |
279 | else { | |
280 | $session->pushUserContext(CRM_Utils_System::url('civicrm', 'reset=1')); | |
281 | CRM_Core_Error::statusBounce(ts('You do not have the necessary permission to view this contact.')); | |
282 | } | |
283 | } | |
284 | ||
59f97da6 | 285 | /** |
100fef9d | 286 | * @param int $contactId |
59f97da6 EM |
287 | * @param bool $isDeleted |
288 | * | |
289 | * @return string | |
290 | */ | |
00be9182 | 291 | public static function setTitle($contactId, $isDeleted = FALSE) { |
6a488035 | 292 | static $contactDetails; |
93ddaacb | 293 | $contactImage = NULL; |
6a488035 TO |
294 | if (!isset($contactDetails[$contactId])) { |
295 | list($displayName, $contactImage) = self::getContactDetails($contactId); | |
be2fb01f | 296 | $contactDetails[$contactId] = [ |
6a488035 TO |
297 | 'displayName' => $displayName, |
298 | 'contactImage' => $contactImage, | |
7d3ddae6 | 299 | 'isDeceased' => (bool) CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $contactId, 'is_deceased'), |
be2fb01f | 300 | ]; |
6a488035 TO |
301 | } |
302 | else { | |
303 | $displayName = $contactDetails[$contactId]['displayName']; | |
304 | $contactImage = $contactDetails[$contactId]['contactImage']; | |
305 | } | |
306 | ||
307 | // set page title | |
308 | $title = "{$contactImage} {$displayName}"; | |
7d3ddae6 | 309 | if ($contactDetails[$contactId]['isDeceased']) { |
7c38bbf0 | 310 | $title .= ' <span class="crm-contact-deceased">(' . ts('deceased') . ')</span>'; |
7d3ddae6 | 311 | } |
6a488035 TO |
312 | if ($isDeleted) { |
313 | $title = "<del>{$title}</del>"; | |
50bdbb5b SL |
314 | try { |
315 | $mergedTo = civicrm_api3('Contact', 'getmergedto', ['contact_id' => $contactId, 'api.Contact.get' => ['return' => 'display_name']]); | |
316 | } | |
317 | catch (CiviCRM_API3_Exception $e) { | |
318 | CRM_Core_Session::singleton()->setStatus(ts('This contact was deleted during a merge operation. The contact it was merged into cannot be found and may have been deleted.')); | |
319 | $mergedTo = ['count' => 0]; | |
320 | } | |
93ddaacb | 321 | if ($mergedTo['count']) { |
322 | $mergedToContactID = $mergedTo['id']; | |
323 | $mergedToDisplayName = $mergedTo['values'][$mergedToContactID]['api.Contact.get']['values'][0]['display_name']; | |
324 | $title .= ' ' . ts('(This contact has been merged to <a href="%1">%2</a>)', [ | |
69078420 SL |
325 | 1 => CRM_Utils_System::url('civicrm/contact/view', ['reset' => 1, 'cid' => $mergedToContactID]), |
326 | 2 => $mergedToDisplayName, | |
327 | ]); | |
93ddaacb | 328 | } |
6a488035 TO |
329 | } |
330 | ||
331 | // Inline-edit places its own title on the page | |
332 | CRM_Utils_System::setTitle('CiviCRM', '<span id="crm-remove-title" style="display:none">CiviCRM</span>'); | |
333 | ||
334 | return $title; | |
335 | } | |
336 | ||
337 | /** | |
fe482240 | 338 | * Add urls for display in the actions menu. |
59f97da6 | 339 | * @param CRM_Core_Page $obj |
77c5b619 | 340 | * @param int $cid |
6a488035 | 341 | */ |
00be9182 | 342 | public static function addUrls(&$obj, $cid) { |
ce80b209 | 343 | $uid = CRM_Core_BAO_UFMatch::getUFId($cid); |
ccd74e76 | 344 | |
6a488035 | 345 | if ($uid) { |
59f97da6 | 346 | $userRecordUrl = CRM_Core_Config::singleton()->userSystem->getUserRecordUrl($cid); |
6a488035 TO |
347 | $obj->assign('userRecordUrl', $userRecordUrl); |
348 | $obj->assign('userRecordId', $uid); | |
349 | } | |
59f97da6 EM |
350 | elseif (CRM_Core_Config::singleton()->userSystem->checkPermissionAddUser()) { |
351 | $userAddUrl = CRM_Utils_System::url('civicrm/contact/view/useradd', 'reset=1&action=add&cid=' . $cid); | |
6a488035 TO |
352 | $obj->assign('userAddUrl', $userAddUrl); |
353 | } | |
354 | ||
355 | if (CRM_Core_Permission::check('access Contact Dashboard')) { | |
356 | $dashboardURL = CRM_Utils_System::url('civicrm/user', | |
357 | "reset=1&id={$cid}" | |
358 | ); | |
359 | $obj->assign('dashboardURL', $dashboardURL); | |
360 | } | |
361 | ||
362 | // See if other modules want to add links to the activtity bar | |
be2fb01f | 363 | $hookLinks = []; |
a9b15f31 | 364 | CRM_Utils_Hook::links('view.contact.activity', |
6a488035 TO |
365 | 'Contact', |
366 | $cid, | |
1273d77c | 367 | $hookLinks |
6a488035 TO |
368 | ); |
369 | if (is_array($hookLinks)) { | |
370 | $obj->assign('hookLinks', $hookLinks); | |
371 | } | |
372 | } | |
96025800 | 373 | |
6a488035 | 374 | } |