CRM/Contact/Form/Edit/Individual.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.5                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  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.   |
  13  |                                                                    |
  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.        |
  18  |                                                                    |
  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  +--------------------------------------------------------------------+
  26 */
  27
  28 /**
  29  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2014
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * Auxilary class to provide support to the Contact Form class. Does this by implementing
  38  * a small set of static methods
  39  *
  40  */
  41 class CRM_Contact_Form_Edit_Individual {
  42
  43   /**
  44    * This function provides the HTML form elements that are specific
  45    * to the Individual Contact Type
  46    *
  47    * @param CRM_Core_Form $form form object
  48    * @param int $inlineEditMode ( 1 for contact summary
  49    * top bar form and 2 for display name edit )
  50    *
  51    * @access public
  52    * @return void
  53    */
  54   public static function buildQuickForm(&$form, $inlineEditMode = NULL) {
  55     $form->applyFilter('__ALL__', 'trim');
  56
  57     if ( !$inlineEditMode || $inlineEditMode == 1 ) {
  58       $nameFields = CRM_Core_BAO_Setting::valueOptions(CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME,
  59         'contact_edit_options', TRUE, NULL,
  60         FALSE, 'name', TRUE, 'AND v.filter = 2'
  61       );
  62
  63       //prefix
  64       $prefix = CRM_Core_PseudoConstant::get('CRM_Contact_DAO_Contact', 'prefix_id');
  65       if (isset($nameFields['Prefix']) && !empty($prefix)) {
  66         $form->addSelect('prefix_id', array('class' => 'eight', 'placeholder' => ' ', 'label' => ts('Prefix')));
  67       }
  68
  69       $attributes = CRM_Core_DAO::getAttribute('CRM_Contact_DAO_Contact');
  70
  71       if (isset($nameFields['Formal Title'])) {
  72         $form->addElement('text', 'formal_title', ts('Title'), $attributes['formal_title']);
  73       }
  74
  75       // first_name
  76       if (isset($nameFields['First Name'])) {
  77         $form->addElement('text', 'first_name', ts('First Name'), $attributes['first_name']);
  78       }
  79
  80       //middle_name
  81       if (isset($nameFields['Middle Name'])) {
  82         $form->addElement('text', 'middle_name', ts('Middle Name'), $attributes['middle_name']);
  83       }
  84
  85       // last_name
  86       if (isset($nameFields['Last Name'])) {
  87         $form->addElement('text', 'last_name', ts('Last Name'), $attributes['last_name']);
  88       }
  89
  90       // suffix
  91       $suffix = CRM_Core_PseudoConstant::get('CRM_Contact_DAO_Contact', 'suffix_id');
  92       if (isset($nameFields['Suffix']) && $suffix) {
  93         $form->addSelect('suffix_id', array('class' => 'eight', 'placeholder' => ' ', 'label' => ts('Suffix')));
  94       }
  95     }
  96
  97     if ( !$inlineEditMode || $inlineEditMode == 2 ) {
  98       // nick_name
  99       $form->addElement('text', 'nick_name', ts('Nickname'),
 100         CRM_Core_DAO::getAttribute('CRM_Contact_DAO_Contact', 'nick_name')
 101       );
 102
 103       // job title
 104       // override the size for UI to look better
 105       $attributes['job_title']['size'] = 30;
 106       $form->addElement('text', 'job_title', ts('Job Title'), $attributes['job_title'], 'size="30"');
 107
 108       //Current Employer Element
 109       $props = array(
 110         'api' => array('params' => array('contact_type' => 'Organization')),
 111         'create' => TRUE,
 112       );
 113       $form->addEntityRef('employer_id', ts('Current Employer'), $props);
 114       $attributes['source']['class'] = 'big';
 115       $form->addElement('text', 'contact_source', ts('Source'), CRM_Utils_Array::value('source', $attributes));
 116     }
 117
 118     if ( !$inlineEditMode ) {
 119       $checkSimilar = CRM_Core_BAO_Setting::getItem(CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME,
 120         'contact_ajax_check_similar',
 121         NULL,
 122         TRUE
 123       );
 124
 125       if ( $checkSimilar == null ) {
 126         $checkSimilar = 0;
 127       }
 128       $form->assign('checkSimilar', $checkSimilar);
 129
 130       //External Identifier Element
 131       $form->add('text', 'external_identifier', ts('External ID'),
 132         CRM_Core_DAO::getAttribute('CRM_Contact_DAO_Contact', 'external_identifier'), FALSE
 133       );
 134
 135       $form->addRule('external_identifier',
 136         ts('External ID already exists in Database.'),
 137         'objectExists',
 138         array('CRM_Contact_DAO_Contact', $form->_contactId, 'external_identifier')
 139       );
 140       $config = CRM_Core_Config::singleton();
 141       CRM_Core_ShowHideBlocks::links($form, 'demographics', '', '');
 142     }
 143   }
 144
 145   /**
 146    * global form rule
 147    *
 148    * @param array $fields the input form values
 149    * @param array $files the uploaded files if any
 150    * @param null $contactID
 151    *
 152    * @return true if no errors, else array of errors
 153    * @access public
 154    * @static
 155    */
 156   static function formRule($fields, $files, $contactID = NULL) {
 157     $errors = array();
 158     $primaryID = CRM_Contact_Form_Contact::formRule($fields, $errors, $contactID);
 159
 160     // make sure that firstName and lastName or a primary OpenID is set
 161     if (!$primaryID && (empty($fields['first_name']) || empty($fields['last_name']))) {
 162       $errors['_qf_default'] = ts('First Name and Last Name OR an email OR an OpenID in the Primary Location should be set.');
 163     }
 164
 165     //check for duplicate - dedupe rules
 166     CRM_Contact_Form_Contact::checkDuplicateContacts($fields, $errors, $contactID, 'Individual');
 167
 168     return empty($errors) ? TRUE : $errors;
 169   }
 170 }
 171