CRM/Contact/Page/View.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   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       |
   9  +--------------------------------------------------------------------+
  10  */
  11
  12 /**
  13  *
  14  * @package CRM
  15  * @copyright CiviCRM LLC https://civicrm.org/licensing
  16  */
  17
  18 /**
  19  * Main page for viewing contact.
  20  */
  21 class CRM_Contact_Page_View extends CRM_Core_Page {
  22
  23   /**
  24    * The id of the object being viewed (note/relationship etc)
  25    *
  26    * @var int
  27    */
  28   protected $_id;
  29
  30   /**
  31    * The contact id of the contact being viewed
  32    *
  33    * @var int
  34    */
  35   protected $_contactId;
  36
  37   /**
  38    * The action that we are performing
  39    *
  40    * @var string
  41    */
  42   protected $_action;
  43
  44   /**
  45    * The permission we have on this contact
  46    *
  47    * @var string
  48    */
  49   protected $_permission;
  50
  51   /**
  52    * Heart of the viewing process.
  53    *
  54    * The runner gets all the meta data for the contact and calls the appropriate type of page to view.
  55    */
  56   public function preProcess() {
  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) {
  72       $this->_contactId = CRM_Utils_Request::retrieve('cid', 'Positive', $this);
  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
  86     if (CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'id') != $this->_contactId) {
  87       CRM_Core_Error::statusBounce(
  88         ts('A Contact with that ID does not exist: %1', [1 => $this->_contactId]),
  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
  96     $navContacts = [
  97       'prevContactID' => NULL,
  98       'prevContactName' => NULL,
  99       'nextContactID' => NULL,
 100       'nextContactName' => NULL,
 101       'nextPrevError' => 0,
 102     ];
 103     if ($qfKey) {
 104       $pos = Civi::service('prevnext')->getPositions("civicrm search $qfKey",
 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
 122       $context = $_GET['context'] ?? NULL;
 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       }
 131       elseif ($context) {
 132         $this->assign('context', $context);
 133         CRM_Utils_System::appendBreadCrumb([
 134           [
 135             'title' => ts('Search Results'),
 136             'url' => CRM_Utils_System::url("civicrm/contact/search/$context", ['qfKey' => $qfKey]),
 137           ],
 138         ]);
 139       }
 140     }
 141     $this->assign($navContacts);
 142
 143     $path = CRM_Utils_System::url('civicrm/contact/view', 'reset=1&cid=' . $this->_contactId);
 144     CRM_Utils_System::appendBreadCrumb([['title' => ts('View Contact'), 'url' => $path]]);
 145
 146     if ($image_URL = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'image_URL')) {
 147       $this->assign("imageURL", CRM_Utils_File::getImageURL($image_URL));
 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
 160     list($displayName, $contactImage, $contactType, $contactSubtype, $contactImageUrl) = self::getContactDetails($this->_contactId);
 161     $this->assign('displayName', $displayName);
 162
 163     $this->set('contactType', $contactType);
 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));
 167
 168     // add to recently viewed block
 169     $isDeleted = (bool) CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'is_deleted');
 170
 171     $recentOther = [
 172       'imageUrl' => $contactImageUrl,
 173       'subtype' => $contactSubtype,
 174       'isDeleted' => $isDeleted,
 175     ];
 176
 177     if (CRM_Contact_BAO_Contact_Permission::allow($this->_contactId, CRM_Core_Permission::EDIT)) {
 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);
 200
 201     // Check if this is default domain contact CRM-10482
 202     if (CRM_Contact_BAO_Contact::checkDomainContact($this->_contactId)) {
 203       $this->assign('domainContact', TRUE);
 204     }
 205     else {
 206       $this->assign('domainContact', FALSE);
 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') &&
 214       Civi::settings()->get('is_enabled')) {
 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    *
 229    * @param int $contactId
 230    *
 231    * @return array
 232    *   contact fields in fixed order
 233    */
 234   public static function getContactDetails($contactId) {
 235     return list($displayName,
 236       $contactImage,
 237       $contactType,
 238       $contactSubtype,
 239       $contactImageUrl
 240       ) = CRM_Contact_BAO_Contact::getDisplayAndImage($contactId,
 241       TRUE,
 242       TRUE
 243       );
 244   }
 245
 246   /**
 247    * @param $page
 248    * @param int $contactID
 249    */
 250   public static function checkUserPermission($page, $contactID = NULL) {
 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
 262     if ($session->get('userID') == $contactID && CRM_Core_Permission::check('edit my contact')) {
 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
 285   /**
 286    * @param int $contactId
 287    * @param bool $isDeleted
 288    *
 289    * @return string
 290    */
 291   public static function setTitle($contactId, $isDeleted = FALSE) {
 292     static $contactDetails;
 293     $contactImage = NULL;
 294     if (!isset($contactDetails[$contactId])) {
 295       list($displayName, $contactImage) = self::getContactDetails($contactId);
 296       $contactDetails[$contactId] = [
 297         'displayName' => $displayName,
 298         'contactImage' => $contactImage,
 299         'isDeceased' => (bool) CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $contactId, 'is_deceased'),
 300       ];
 301     }
 302     else {
 303       $displayName = $contactDetails[$contactId]['displayName'];
 304       $contactImage = $contactDetails[$contactId]['contactImage'];
 305     }
 306
 307     // set page title
 308     $title = "{$contactImage} {$displayName}";
 309     if ($contactDetails[$contactId]['isDeceased']) {
 310       $title .= '  <span class="crm-contact-deceased">(' . ts('deceased') . ')</span>';
 311     }
 312     if ($isDeleted) {
 313       $title = "<del>{$title}</del>";
 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       }
 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>)', [
 325           1 => CRM_Utils_System::url('civicrm/contact/view', ['reset' => 1, 'cid' => $mergedToContactID]),
 326           2 => $mergedToDisplayName,
 327         ]);
 328       }
 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   /**
 338    * Add urls for display in the actions menu.
 339    * @param CRM_Core_Page $obj
 340    * @param int $cid
 341    */
 342   public static function addUrls(&$obj, $cid) {
 343     $uid = CRM_Core_BAO_UFMatch::getUFId($cid);
 344
 345     if ($uid) {
 346       $userRecordUrl = CRM_Core_Config::singleton()->userSystem->getUserRecordUrl($cid);
 347       $obj->assign('userRecordUrl', $userRecordUrl);
 348       $obj->assign('userRecordId', $uid);
 349     }
 350     elseif (CRM_Core_Config::singleton()->userSystem->checkPermissionAddUser()) {
 351       $userAddUrl = CRM_Utils_System::url('civicrm/contact/view/useradd', 'reset=1&action=add&cid=' . $cid);
 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
 363     $hookLinks = [];
 364     CRM_Utils_Hook::links('view.contact.activity',
 365       'Contact',
 366       $cid,
 367       $hookLinks
 368     );
 369     if (is_array($hookLinks)) {
 370       $obj->assign('hookLinks', $hookLinks);
 371     }
 372   }
 373
 374 }