5 * @copyright CiviCRM LLC (c) 2004-2019
7 * Generated from xml/schema/CRM/Contact/Contact.xml
8 * DO NOT EDIT. Generated by CRM_Core_CodeGen
9 * (GenCodeChecksum:ee3bf9f2d1faed5a4de439ecf0537ac6)
13 * Database access object for the Contact entity.
15 class CRM_Contact_DAO_Contact
extends CRM_Core_DAO
{
18 * Static instance to hold the table name.
22 public static $_tableName = 'civicrm_contact';
25 * Should CiviCRM log any modifications to this table in the civicrm_log table.
29 public static $_log = TRUE;
46 * May be used to over-ride contact view and edit templates.
50 public $contact_sub_type;
78 * Has the contact opted out from receiving all bulk email from the organization or site domain?
85 * May be used for SSN, EIN/TIN, Household ID (census) or other applicable unique legal/government ID.
89 public $legal_identifier;
92 * Unique trusted external ID (generally from a legacy app/datasource). Particularly useful for deduping operations.
96 public $external_identifier;
99 * Name used for sorting different contact types
106 * Formatted name representing preferred format for display/print/other output.
110 public $display_name;
127 * optional URL for preferred image (photo, logo, etc.) to display for this contact.
134 * What is the preferred mode of communication.
138 public $preferred_communication_method;
141 * Which language is preferred for communication. FK to languages in civicrm_option_value.
145 public $preferred_language;
148 * What is the preferred mode of sending an email.
152 public $preferred_mail_format;
155 * Key for validating requests related to this contact.
162 * API Key for validating requests related to this contact.
169 * where contact come from, e.g. import, donate module insert...
197 * Prefix or Title for name (Ms, Mr...). FK to prefix ID
204 * Suffix for name (Jr, Sr...). FK to suffix ID
211 * Formal (academic or similar) title in front of name. (Prof., Dr. etc.)
215 public $formal_title;
218 * Communication style (e.g. formal vs. familiar) to use with this contact. FK to communication styles in civicrm_option_value.
222 public $communication_style_id;
225 * FK to civicrm_option_value.id, that has to be valid registered Email Greeting.
229 public $email_greeting_id;
232 * Custom Email Greeting.
236 public $email_greeting_custom;
239 * Cache Email Greeting.
243 public $email_greeting_display;
246 * FK to civicrm_option_value.id, that has to be valid registered Postal Greeting.
250 public $postal_greeting_id;
253 * Custom Postal greeting.
257 public $postal_greeting_custom;
260 * Cache Postal greeting.
264 public $postal_greeting_display;
267 * FK to civicrm_option_value.id, that has to be valid registered Addressee.
271 public $addressee_id;
278 public $addressee_custom;
285 public $addressee_display;
318 public $deceased_date;
325 public $household_name;
328 * Optional FK to Primary Contact for this household.
332 public $primary_contact_id;
339 public $organization_name;
342 * Standard Industry Classification Code.
349 * the OpenID (or OpenID-style http://username.domain/) unique identifier for this contact mainly used for logging in to CiviCRM
353 public $user_unique_id;
356 * OPTIONAL FK to civicrm_contact record.
368 * When was the contact was created.
372 public $created_date;
375 * When was the contact (or closely related entity) was created or modified or deleted.
379 public $modified_date;
384 public function __construct() {
385 $this->__table
= 'civicrm_contact';
386 parent
::__construct();
390 * Returns foreign keys and entity references.
393 * [CRM_Core_Reference_Interface]
395 public static function getReferenceColumns() {
396 if (!isset(Civi
::$statics[__CLASS__
]['links'])) {
397 Civi
::$statics[__CLASS__
]['links'] = static::createReferenceColumns(__CLASS__
);
398 Civi
::$statics[__CLASS__
]['links'][] = new CRM_Core_Reference_Basic(self
::getTableName(), 'primary_contact_id', 'civicrm_contact', 'id');
399 Civi
::$statics[__CLASS__
]['links'][] = new CRM_Core_Reference_Basic(self
::getTableName(), 'employer_id', 'civicrm_contact', 'id');
400 CRM_Core_DAO_AllCoreTables
::invoke(__CLASS__
, 'links_callback', Civi
::$statics[__CLASS__
]['links']);
402 return Civi
::$statics[__CLASS__
]['links'];
406 * Returns all the column names of this table
410 public static function &fields() {
411 if (!isset(Civi
::$statics[__CLASS__
]['fields'])) {
412 Civi
::$statics[__CLASS__
]['fields'] = [
415 'type' => CRM_Utils_Type
::T_INT
,
416 'title' => ts('Contact ID'),
417 'description' => ts('Unique Contact ID'),
420 'where' => 'civicrm_contact.id',
421 'headerPattern' => '/internal|contact?|id$/i',
423 'table_name' => 'civicrm_contact',
424 'entity' => 'Contact',
425 'bao' => 'CRM_Contact_BAO_Contact',
429 'name' => 'contact_type',
430 'type' => CRM_Utils_Type
::T_STRING
,
431 'title' => ts('Contact Type'),
432 'description' => ts('Type of Contact.'),
434 'size' => CRM_Utils_Type
::BIG
,
435 'where' => 'civicrm_contact.contact_type',
437 'table_name' => 'civicrm_contact',
438 'entity' => 'Contact',
439 'bao' => 'CRM_Contact_BAO_Contact',
444 'pseudoconstant' => [
445 'table' => 'civicrm_contact_type',
446 'keyColumn' => 'name',
447 'labelColumn' => 'label',
448 'condition' => 'parent_id IS NULL',
451 'contact_sub_type' => [
452 'name' => 'contact_sub_type',
453 'type' => CRM_Utils_Type
::T_STRING
,
454 'title' => ts('Contact Subtype'),
455 'description' => ts('May be used to over-ride contact view and edit templates.'),
457 'size' => CRM_Utils_Type
::HUGE
,
459 'where' => 'civicrm_contact.contact_sub_type',
460 'headerPattern' => '/C(ontact )?(subtype|sub-type|sub type)/i',
462 'table_name' => 'civicrm_contact',
463 'entity' => 'Contact',
464 'bao' => 'CRM_Contact_BAO_Contact',
466 'serialize' => self
::SERIALIZE_SEPARATOR_BOOKEND
,
470 'pseudoconstant' => [
471 'table' => 'civicrm_contact_type',
472 'keyColumn' => 'name',
473 'labelColumn' => 'label',
474 'condition' => 'parent_id IS NOT NULL',
478 'name' => 'do_not_email',
479 'type' => CRM_Utils_Type
::T_BOOLEAN
,
480 'title' => ts('Do Not Email'),
482 'where' => 'civicrm_contact.do_not_email',
483 'headerPattern' => '/d(o )?(not )?(email)/i',
484 'dataPattern' => '/^\d{1,}$/',
487 'table_name' => 'civicrm_contact',
488 'entity' => 'Contact',
489 'bao' => 'CRM_Contact_BAO_Contact',
492 'type' => 'CheckBox',
496 'name' => 'do_not_phone',
497 'type' => CRM_Utils_Type
::T_BOOLEAN
,
498 'title' => ts('Do Not Phone'),
500 'where' => 'civicrm_contact.do_not_phone',
501 'headerPattern' => '/d(o )?(not )?(call|phone)/i',
502 'dataPattern' => '/^\d{1,}$/',
505 'table_name' => 'civicrm_contact',
506 'entity' => 'Contact',
507 'bao' => 'CRM_Contact_BAO_Contact',
510 'type' => 'CheckBox',
514 'name' => 'do_not_mail',
515 'type' => CRM_Utils_Type
::T_BOOLEAN
,
516 'title' => ts('Do Not Mail'),
518 'where' => 'civicrm_contact.do_not_mail',
519 'headerPattern' => '/^(d(o\s)?n(ot\s)?mail)|(\w*)?bulk\s?(\w*)$/i',
520 'dataPattern' => '/^\d{1,}$/',
523 'table_name' => 'civicrm_contact',
524 'entity' => 'Contact',
525 'bao' => 'CRM_Contact_BAO_Contact',
528 'type' => 'CheckBox',
532 'name' => 'do_not_sms',
533 'type' => CRM_Utils_Type
::T_BOOLEAN
,
534 'title' => ts('Do Not Sms'),
536 'where' => 'civicrm_contact.do_not_sms',
537 'headerPattern' => '/d(o )?(not )?(sms)/i',
538 'dataPattern' => '/^\d{1,}$/',
541 'table_name' => 'civicrm_contact',
542 'entity' => 'Contact',
543 'bao' => 'CRM_Contact_BAO_Contact',
546 'type' => 'CheckBox',
550 'name' => 'do_not_trade',
551 'type' => CRM_Utils_Type
::T_BOOLEAN
,
552 'title' => ts('Do Not Trade'),
554 'where' => 'civicrm_contact.do_not_trade',
555 'headerPattern' => '/d(o )?(not )?(trade)/i',
556 'dataPattern' => '/^\d{1,}$/',
559 'table_name' => 'civicrm_contact',
560 'entity' => 'Contact',
561 'bao' => 'CRM_Contact_BAO_Contact',
564 'type' => 'CheckBox',
568 'name' => 'is_opt_out',
569 'type' => CRM_Utils_Type
::T_BOOLEAN
,
570 'title' => ts('No Bulk Emails (User Opt Out)'),
571 'description' => ts('Has the contact opted out from receiving all bulk email from the organization or site domain?'),
574 'where' => 'civicrm_contact.is_opt_out',
577 'table_name' => 'civicrm_contact',
578 'entity' => 'Contact',
579 'bao' => 'CRM_Contact_BAO_Contact',
582 'type' => 'CheckBox',
585 'legal_identifier' => [
586 'name' => 'legal_identifier',
587 'type' => CRM_Utils_Type
::T_STRING
,
588 'title' => ts('Legal Identifier'),
589 'description' => ts('May be used for SSN, EIN/TIN, Household ID (census) or other applicable unique legal/government ID.'),
591 'size' => CRM_Utils_Type
::MEDIUM
,
593 'where' => 'civicrm_contact.legal_identifier',
594 'headerPattern' => '/legal\s?id/i',
595 'dataPattern' => '/\w+?\d{5,}/',
597 'table_name' => 'civicrm_contact',
598 'entity' => 'Contact',
599 'bao' => 'CRM_Contact_BAO_Contact',
605 'external_identifier' => [
606 'name' => 'external_identifier',
607 'type' => CRM_Utils_Type
::T_STRING
,
608 'title' => ts('External Identifier'),
609 'description' => ts('Unique trusted external ID (generally from a legacy app/datasource). Particularly useful for deduping operations.'),
613 'where' => 'civicrm_contact.external_identifier',
614 'headerPattern' => '/external\s?id/i',
615 'dataPattern' => '/^\d{11,}$/',
617 'table_name' => 'civicrm_contact',
618 'entity' => 'Contact',
619 'bao' => 'CRM_Contact_BAO_Contact',
626 'name' => 'sort_name',
627 'type' => CRM_Utils_Type
::T_STRING
,
628 'title' => ts('Sort Name'),
629 'description' => ts('Name used for sorting different contact types'),
632 'where' => 'civicrm_contact.sort_name',
634 'table_name' => 'civicrm_contact',
635 'entity' => 'Contact',
636 'bao' => 'CRM_Contact_BAO_Contact',
643 'name' => 'display_name',
644 'type' => CRM_Utils_Type
::T_STRING
,
645 'title' => ts('Display Name'),
646 'description' => ts('Formatted name representing preferred format for display/print/other output.'),
649 'where' => 'civicrm_contact.display_name',
651 'table_name' => 'civicrm_contact',
652 'entity' => 'Contact',
653 'bao' => 'CRM_Contact_BAO_Contact',
660 'name' => 'nick_name',
661 'type' => CRM_Utils_Type
::T_STRING
,
662 'title' => ts('Nickname'),
663 'description' => ts('Nickname.'),
667 'where' => 'civicrm_contact.nick_name',
668 'headerPattern' => '/n(ick\s)name|nick$/i',
669 'dataPattern' => '/^\w+$/',
671 'table_name' => 'civicrm_contact',
672 'entity' => 'Contact',
673 'bao' => 'CRM_Contact_BAO_Contact',
680 'name' => 'legal_name',
681 'type' => CRM_Utils_Type
::T_STRING
,
682 'title' => ts('Legal Name'),
683 'description' => ts('Legal Name.'),
687 'where' => 'civicrm_contact.legal_name',
688 'headerPattern' => '/^legal|(l(egal\s)?name)$/i',
690 'table_name' => 'civicrm_contact',
691 'entity' => 'Contact',
692 'bao' => 'CRM_Contact_BAO_Contact',
699 'name' => 'image_URL',
700 'type' => CRM_Utils_Type
::T_TEXT
,
701 'title' => ts('Image Url'),
702 'description' => ts('optional URL for preferred image (photo, logo, etc.) to display for this contact.'),
704 'where' => 'civicrm_contact.image_URL',
706 'table_name' => 'civicrm_contact',
707 'entity' => 'Contact',
708 'bao' => 'CRM_Contact_BAO_Contact',
714 'preferred_communication_method' => [
715 'name' => 'preferred_communication_method',
716 'type' => CRM_Utils_Type
::T_STRING
,
717 'title' => ts('Preferred Communication Method'),
718 'description' => ts('What is the preferred mode of communication.'),
720 'size' => CRM_Utils_Type
::HUGE
,
722 'where' => 'civicrm_contact.preferred_communication_method',
723 'headerPattern' => '/^p(ref\w*\s)?c(omm\w*)|( meth\w*)$/i',
724 'dataPattern' => '/^\w+$/',
726 'table_name' => 'civicrm_contact',
727 'entity' => 'Contact',
728 'bao' => 'CRM_Contact_BAO_Contact',
730 'serialize' => self
::SERIALIZE_SEPARATOR_BOOKEND
,
734 'pseudoconstant' => [
735 'optionGroupName' => 'preferred_communication_method',
736 'optionEditPath' => 'civicrm/admin/options/preferred_communication_method',
739 'preferred_language' => [
740 'name' => 'preferred_language',
741 'type' => CRM_Utils_Type
::T_STRING
,
742 'title' => ts('Preferred Language'),
743 'description' => ts('Which language is preferred for communication. FK to languages in civicrm_option_value.'),
745 'size' => CRM_Utils_Type
::SIX
,
747 'where' => 'civicrm_contact.preferred_language',
748 'headerPattern' => '/^lang/i',
750 'table_name' => 'civicrm_contact',
751 'entity' => 'Contact',
752 'bao' => 'CRM_Contact_BAO_Contact',
757 'pseudoconstant' => [
758 'optionGroupName' => 'languages',
759 'keyColumn' => 'name',
760 'optionEditPath' => 'civicrm/admin/options/languages',
763 'preferred_mail_format' => [
764 'name' => 'preferred_mail_format',
765 'type' => CRM_Utils_Type
::T_STRING
,
766 'title' => ts('Preferred Mail Format'),
767 'description' => ts('What is the preferred mode of sending an email.'),
769 'size' => CRM_Utils_Type
::EIGHT
,
771 'where' => 'civicrm_contact.preferred_mail_format',
772 'headerPattern' => '/^p(ref\w*\s)?m(ail\s)?f(orm\w*)$/i',
775 'table_name' => 'civicrm_contact',
776 'entity' => 'Contact',
777 'bao' => 'CRM_Contact_BAO_Contact',
782 'pseudoconstant' => [
783 'callback' => 'CRM_Core_SelectValues::pmf',
788 'type' => CRM_Utils_Type
::T_STRING
,
789 'title' => ts('Contact Hash'),
790 'description' => ts('Key for validating requests related to this contact.'),
792 'size' => CRM_Utils_Type
::MEDIUM
,
793 'where' => 'civicrm_contact.hash',
795 'table_name' => 'civicrm_contact',
796 'entity' => 'Contact',
797 'bao' => 'CRM_Contact_BAO_Contact',
802 'type' => CRM_Utils_Type
::T_STRING
,
803 'title' => ts('Api Key'),
804 'description' => ts('API Key for validating requests related to this contact.'),
806 'size' => CRM_Utils_Type
::MEDIUM
,
807 'where' => 'civicrm_contact.api_key',
810 'administer CiviCRM',
814 'table_name' => 'civicrm_contact',
815 'entity' => 'Contact',
816 'bao' => 'CRM_Contact_BAO_Contact',
819 'contact_source' => [
821 'type' => CRM_Utils_Type
::T_STRING
,
822 'title' => ts('Contact Source'),
823 'description' => ts('where contact come from, e.g. import, donate module insert...'),
827 'where' => 'civicrm_contact.source',
828 'headerPattern' => '/(C(ontact\s)?Source)$/i',
830 'table_name' => 'civicrm_contact',
831 'entity' => 'Contact',
832 'bao' => 'CRM_Contact_BAO_Contact',
839 'name' => 'first_name',
840 'type' => CRM_Utils_Type
::T_STRING
,
841 'title' => ts('First Name'),
842 'description' => ts('First Name.'),
846 'where' => 'civicrm_contact.first_name',
847 'headerPattern' => '/^first|(f(irst\s)?name)$/i',
848 'dataPattern' => '/^\w+$/',
850 'table_name' => 'civicrm_contact',
851 'entity' => 'Contact',
852 'bao' => 'CRM_Contact_BAO_Contact',
859 'name' => 'middle_name',
860 'type' => CRM_Utils_Type
::T_STRING
,
861 'title' => ts('Middle Name'),
862 'description' => ts('Middle Name.'),
866 'where' => 'civicrm_contact.middle_name',
867 'headerPattern' => '/^middle|(m(iddle\s)?name)$/i',
868 'dataPattern' => '/^\w+$/',
870 'table_name' => 'civicrm_contact',
871 'entity' => 'Contact',
872 'bao' => 'CRM_Contact_BAO_Contact',
879 'name' => 'last_name',
880 'type' => CRM_Utils_Type
::T_STRING
,
881 'title' => ts('Last Name'),
882 'description' => ts('Last Name.'),
886 'where' => 'civicrm_contact.last_name',
887 'headerPattern' => '/^last|(l(ast\s)?name)$/i',
888 'dataPattern' => '/^\w+(\s\w+)?+$/',
890 'table_name' => 'civicrm_contact',
891 'entity' => 'Contact',
892 'bao' => 'CRM_Contact_BAO_Contact',
899 'name' => 'prefix_id',
900 'type' => CRM_Utils_Type
::T_INT
,
901 'title' => ts('Individual Prefix'),
902 'description' => ts('Prefix or Title for name (Ms, Mr...). FK to prefix ID'),
904 'where' => 'civicrm_contact.prefix_id',
905 'headerPattern' => '/^(prefix|title)/i',
906 'dataPattern' => '/^(mr|ms|mrs|sir|dr)\.?$/i',
908 'table_name' => 'civicrm_contact',
909 'entity' => 'Contact',
910 'bao' => 'CRM_Contact_BAO_Contact',
915 'pseudoconstant' => [
916 'optionGroupName' => 'individual_prefix',
917 'optionEditPath' => 'civicrm/admin/options/individual_prefix',
921 'name' => 'suffix_id',
922 'type' => CRM_Utils_Type
::T_INT
,
923 'title' => ts('Individual Suffix'),
924 'description' => ts('Suffix for name (Jr, Sr...). FK to suffix ID'),
926 'where' => 'civicrm_contact.suffix_id',
927 'headerPattern' => '/^suffix$/i',
928 'dataPattern' => '/^(sr|jr)\.?|i{2,}$/',
930 'table_name' => 'civicrm_contact',
931 'entity' => 'Contact',
932 'bao' => 'CRM_Contact_BAO_Contact',
937 'pseudoconstant' => [
938 'optionGroupName' => 'individual_suffix',
939 'optionEditPath' => 'civicrm/admin/options/individual_suffix',
943 'name' => 'formal_title',
944 'type' => CRM_Utils_Type
::T_STRING
,
945 'title' => ts('Formal Title'),
946 'description' => ts('Formal (academic or similar) title in front of name. (Prof., Dr. etc.)'),
948 'size' => CRM_Utils_Type
::BIG
,
950 'where' => 'civicrm_contact.formal_title',
951 'headerPattern' => '/^title/i',
953 'table_name' => 'civicrm_contact',
954 'entity' => 'Contact',
955 'bao' => 'CRM_Contact_BAO_Contact',
961 'communication_style_id' => [
962 'name' => 'communication_style_id',
963 'type' => CRM_Utils_Type
::T_INT
,
964 'title' => ts('Communication Style'),
965 'description' => ts('Communication style (e.g. formal vs. familiar) to use with this contact. FK to communication styles in civicrm_option_value.'),
967 'where' => 'civicrm_contact.communication_style_id',
968 'headerPattern' => '/style/i',
970 'table_name' => 'civicrm_contact',
971 'entity' => 'Contact',
972 'bao' => 'CRM_Contact_BAO_Contact',
977 'pseudoconstant' => [
978 'optionGroupName' => 'communication_style',
979 'optionEditPath' => 'civicrm/admin/options/communication_style',
982 'email_greeting_id' => [
983 'name' => 'email_greeting_id',
984 'type' => CRM_Utils_Type
::T_INT
,
985 'title' => ts('Email Greeting ID'),
986 'description' => ts('FK to civicrm_option_value.id, that has to be valid registered Email Greeting.'),
987 'where' => 'civicrm_contact.email_greeting_id',
989 'table_name' => 'civicrm_contact',
990 'entity' => 'Contact',
991 'bao' => 'CRM_Contact_BAO_Contact',
993 'pseudoconstant' => [
994 'optionGroupName' => 'email_greeting',
995 'optionEditPath' => 'civicrm/admin/options/email_greeting',
998 'email_greeting_custom' => [
999 'name' => 'email_greeting_custom',
1000 'type' => CRM_Utils_Type
::T_STRING
,
1001 'title' => ts('Email Greeting Custom'),
1002 'description' => ts('Custom Email Greeting.'),
1004 'size' => CRM_Utils_Type
::HUGE
,
1006 'where' => 'civicrm_contact.email_greeting_custom',
1008 'table_name' => 'civicrm_contact',
1009 'entity' => 'Contact',
1010 'bao' => 'CRM_Contact_BAO_Contact',
1016 'email_greeting_display' => [
1017 'name' => 'email_greeting_display',
1018 'type' => CRM_Utils_Type
::T_STRING
,
1019 'title' => ts('Email Greeting'),
1020 'description' => ts('Cache Email Greeting.'),
1022 'size' => CRM_Utils_Type
::HUGE
,
1023 'where' => 'civicrm_contact.email_greeting_display',
1024 'table_name' => 'civicrm_contact',
1025 'entity' => 'Contact',
1026 'bao' => 'CRM_Contact_BAO_Contact',
1032 'postal_greeting_id' => [
1033 'name' => 'postal_greeting_id',
1034 'type' => CRM_Utils_Type
::T_INT
,
1035 'title' => ts('Postal Greeting ID'),
1036 'description' => ts('FK to civicrm_option_value.id, that has to be valid registered Postal Greeting.'),
1037 'where' => 'civicrm_contact.postal_greeting_id',
1039 'table_name' => 'civicrm_contact',
1040 'entity' => 'Contact',
1041 'bao' => 'CRM_Contact_BAO_Contact',
1046 'pseudoconstant' => [
1047 'optionGroupName' => 'postal_greeting',
1048 'optionEditPath' => 'civicrm/admin/options/postal_greeting',
1051 'postal_greeting_custom' => [
1052 'name' => 'postal_greeting_custom',
1053 'type' => CRM_Utils_Type
::T_STRING
,
1054 'title' => ts('Postal Greeting Custom'),
1055 'description' => ts('Custom Postal greeting.'),
1057 'size' => CRM_Utils_Type
::HUGE
,
1059 'where' => 'civicrm_contact.postal_greeting_custom',
1061 'table_name' => 'civicrm_contact',
1062 'entity' => 'Contact',
1063 'bao' => 'CRM_Contact_BAO_Contact',
1069 'postal_greeting_display' => [
1070 'name' => 'postal_greeting_display',
1071 'type' => CRM_Utils_Type
::T_STRING
,
1072 'title' => ts('Postal Greeting'),
1073 'description' => ts('Cache Postal greeting.'),
1075 'size' => CRM_Utils_Type
::HUGE
,
1076 'where' => 'civicrm_contact.postal_greeting_display',
1077 'table_name' => 'civicrm_contact',
1078 'entity' => 'Contact',
1079 'bao' => 'CRM_Contact_BAO_Contact',
1086 'name' => 'addressee_id',
1087 'type' => CRM_Utils_Type
::T_INT
,
1088 'title' => ts('Addressee ID'),
1089 'description' => ts('FK to civicrm_option_value.id, that has to be valid registered Addressee.'),
1090 'where' => 'civicrm_contact.addressee_id',
1092 'table_name' => 'civicrm_contact',
1093 'entity' => 'Contact',
1094 'bao' => 'CRM_Contact_BAO_Contact',
1096 'pseudoconstant' => [
1097 'optionGroupName' => 'addressee',
1098 'optionEditPath' => 'civicrm/admin/options/addressee',
1101 'addressee_custom' => [
1102 'name' => 'addressee_custom',
1103 'type' => CRM_Utils_Type
::T_STRING
,
1104 'title' => ts('Addressee Custom'),
1105 'description' => ts('Custom Addressee.'),
1107 'size' => CRM_Utils_Type
::HUGE
,
1109 'where' => 'civicrm_contact.addressee_custom',
1111 'table_name' => 'civicrm_contact',
1112 'entity' => 'Contact',
1113 'bao' => 'CRM_Contact_BAO_Contact',
1119 'addressee_display' => [
1120 'name' => 'addressee_display',
1121 'type' => CRM_Utils_Type
::T_STRING
,
1122 'title' => ts('Addressee'),
1123 'description' => ts('Cache Addressee.'),
1125 'size' => CRM_Utils_Type
::HUGE
,
1126 'where' => 'civicrm_contact.addressee_display',
1127 'table_name' => 'civicrm_contact',
1128 'entity' => 'Contact',
1129 'bao' => 'CRM_Contact_BAO_Contact',
1136 'name' => 'job_title',
1137 'type' => CRM_Utils_Type
::T_STRING
,
1138 'title' => ts('Job Title'),
1139 'description' => ts('Job Title'),
1143 'where' => 'civicrm_contact.job_title',
1144 'headerPattern' => '/^job|(j(ob\s)?title)$/i',
1145 'dataPattern' => '//',
1147 'table_name' => 'civicrm_contact',
1148 'entity' => 'Contact',
1149 'bao' => 'CRM_Contact_BAO_Contact',
1156 'name' => 'gender_id',
1157 'type' => CRM_Utils_Type
::T_INT
,
1158 'title' => ts('Gender'),
1159 'description' => ts('FK to gender ID'),
1161 'where' => 'civicrm_contact.gender_id',
1162 'headerPattern' => '/^gender$/i',
1164 'table_name' => 'civicrm_contact',
1165 'entity' => 'Contact',
1166 'bao' => 'CRM_Contact_BAO_Contact',
1171 'pseudoconstant' => [
1172 'optionGroupName' => 'gender',
1173 'optionEditPath' => 'civicrm/admin/options/gender',
1177 'name' => 'birth_date',
1178 'type' => CRM_Utils_Type
::T_DATE
,
1179 'title' => ts('Birth Date'),
1180 'description' => ts('Date of birth'),
1182 'where' => 'civicrm_contact.birth_date',
1183 'headerPattern' => '/^birth|(b(irth\s)?date)|D(\W*)O(\W*)B(\W*)$/i',
1184 'dataPattern' => '/\d{4}-?\d{2}-?\d{2}/',
1186 'table_name' => 'civicrm_contact',
1187 'entity' => 'Contact',
1188 'bao' => 'CRM_Contact_BAO_Contact',
1191 'type' => 'Select Date',
1192 'formatType' => 'birth',
1196 'name' => 'is_deceased',
1197 'type' => CRM_Utils_Type
::T_BOOLEAN
,
1198 'title' => ts('Deceased'),
1200 'where' => 'civicrm_contact.is_deceased',
1201 'headerPattern' => '/i(s\s)?d(eceased)$/i',
1204 'table_name' => 'civicrm_contact',
1205 'entity' => 'Contact',
1206 'bao' => 'CRM_Contact_BAO_Contact',
1209 'type' => 'CheckBox',
1212 'deceased_date' => [
1213 'name' => 'deceased_date',
1214 'type' => CRM_Utils_Type
::T_DATE
,
1215 'title' => ts('Deceased Date'),
1216 'description' => ts('Date of deceased'),
1218 'where' => 'civicrm_contact.deceased_date',
1219 'headerPattern' => '/^deceased|(d(eceased\s)?date)$/i',
1221 'table_name' => 'civicrm_contact',
1222 'entity' => 'Contact',
1223 'bao' => 'CRM_Contact_BAO_Contact',
1226 'type' => 'Select Date',
1227 'formatType' => 'birth',
1230 'household_name' => [
1231 'name' => 'household_name',
1232 'type' => CRM_Utils_Type
::T_STRING
,
1233 'title' => ts('Household Name'),
1234 'description' => ts('Household Name.'),
1238 'where' => 'civicrm_contact.household_name',
1239 'headerPattern' => '/^household|(h(ousehold\s)?name)$/i',
1240 'dataPattern' => '/^\w+$/',
1242 'table_name' => 'civicrm_contact',
1243 'entity' => 'Contact',
1244 'bao' => 'CRM_Contact_BAO_Contact',
1250 'primary_contact_id' => [
1251 'name' => 'primary_contact_id',
1252 'type' => CRM_Utils_Type
::T_INT
,
1253 'title' => ts('Household Primary Contact ID'),
1254 'description' => ts('Optional FK to Primary Contact for this household.'),
1255 'where' => 'civicrm_contact.primary_contact_id',
1256 'table_name' => 'civicrm_contact',
1257 'entity' => 'Contact',
1258 'bao' => 'CRM_Contact_BAO_Contact',
1260 'FKClassName' => 'CRM_Contact_DAO_Contact',
1265 'organization_name' => [
1266 'name' => 'organization_name',
1267 'type' => CRM_Utils_Type
::T_STRING
,
1268 'title' => ts('Organization Name'),
1269 'description' => ts('Organization Name.'),
1273 'where' => 'civicrm_contact.organization_name',
1274 'headerPattern' => '/^organization|(o(rganization\s)?name)$/i',
1275 'dataPattern' => '/^\w+$/',
1277 'table_name' => 'civicrm_contact',
1278 'entity' => 'Contact',
1279 'bao' => 'CRM_Contact_BAO_Contact',
1286 'name' => 'sic_code',
1287 'type' => CRM_Utils_Type
::T_STRING
,
1288 'title' => ts('Sic Code'),
1289 'description' => ts('Standard Industry Classification Code.'),
1291 'size' => CRM_Utils_Type
::EIGHT
,
1293 'where' => 'civicrm_contact.sic_code',
1294 'headerPattern' => '/^sic|(s(ic\s)?code)$/i',
1296 'table_name' => 'civicrm_contact',
1297 'entity' => 'Contact',
1298 'bao' => 'CRM_Contact_BAO_Contact',
1304 'user_unique_id' => [
1305 'name' => 'user_unique_id',
1306 'type' => CRM_Utils_Type
::T_STRING
,
1307 'title' => ts('Unique ID (OpenID)'),
1308 'description' => ts('the OpenID (or OpenID-style http://username.domain/) unique identifier for this contact mainly used for logging in to CiviCRM'),
1310 'size' => CRM_Utils_Type
::HUGE
,
1312 'where' => 'civicrm_contact.user_unique_id',
1313 'headerPattern' => '/^Open\s?ID|u(niq\w*)?\s?ID/i',
1314 'dataPattern' => '/^[\w\/\:\.]+$/',
1317 'table_name' => 'civicrm_contact',
1318 'entity' => 'Contact',
1319 'bao' => 'CRM_Contact_BAO_Contact',
1325 'current_employer_id' => [
1326 'name' => 'employer_id',
1327 'type' => CRM_Utils_Type
::T_INT
,
1328 'title' => ts('Current Employer'),
1329 'description' => ts('OPTIONAL FK to civicrm_contact record.'),
1330 'where' => 'civicrm_contact.employer_id',
1332 'table_name' => 'civicrm_contact',
1333 'entity' => 'Contact',
1334 'bao' => 'CRM_Contact_BAO_Contact',
1336 'FKClassName' => 'CRM_Contact_DAO_Contact',
1338 'type' => 'EntityRef',
1341 'contact_is_deleted' => [
1342 'name' => 'is_deleted',
1343 'type' => CRM_Utils_Type
::T_BOOLEAN
,
1344 'title' => ts('Contact is in Trash'),
1346 'where' => 'civicrm_contact.is_deleted',
1349 'table_name' => 'civicrm_contact',
1350 'entity' => 'Contact',
1351 'bao' => 'CRM_Contact_BAO_Contact',
1354 'type' => 'CheckBox',
1358 'name' => 'created_date',
1359 'type' => CRM_Utils_Type
::T_TIMESTAMP
,
1360 'title' => ts('Created Date'),
1361 'description' => ts('When was the contact was created.'),
1362 'required' => FALSE,
1363 'where' => 'civicrm_contact.created_date',
1365 'default' => 'NULL',
1366 'table_name' => 'civicrm_contact',
1367 'entity' => 'Contact',
1368 'bao' => 'CRM_Contact_BAO_Contact',
1371 'modified_date' => [
1372 'name' => 'modified_date',
1373 'type' => CRM_Utils_Type
::T_TIMESTAMP
,
1374 'title' => ts('Modified Date'),
1375 'description' => ts('When was the contact (or closely related entity) was created or modified or deleted.'),
1376 'required' => FALSE,
1377 'where' => 'civicrm_contact.modified_date',
1379 'default' => 'CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP',
1380 'table_name' => 'civicrm_contact',
1381 'entity' => 'Contact',
1382 'bao' => 'CRM_Contact_BAO_Contact',
1386 CRM_Core_DAO_AllCoreTables
::invoke(__CLASS__
, 'fields_callback', Civi
::$statics[__CLASS__
]['fields']);
1388 return Civi
::$statics[__CLASS__
]['fields'];
1392 * Return a mapping from field-name to the corresponding key (as used in fields()).
1395 * Array(string $name => string $uniqueName).
1397 public static function &fieldKeys() {
1398 if (!isset(Civi
::$statics[__CLASS__
]['fieldKeys'])) {
1399 Civi
::$statics[__CLASS__
]['fieldKeys'] = array_flip(CRM_Utils_Array
::collect('name', self
::fields()));
1401 return Civi
::$statics[__CLASS__
]['fieldKeys'];
1405 * Returns the names of this table
1409 public static function getTableName() {
1410 return self
::$_tableName;
1414 * Returns if this table needs to be logged
1418 public function getLog() {
1423 * Returns the list of fields that can be imported
1425 * @param bool $prefix
1429 public static function &import($prefix = FALSE) {
1430 $r = CRM_Core_DAO_AllCoreTables
::getImports(__CLASS__
, 'contact', $prefix, []);
1435 * Returns the list of fields that can be exported
1437 * @param bool $prefix
1441 public static function &export($prefix = FALSE) {
1442 $r = CRM_Core_DAO_AllCoreTables
::getExports(__CLASS__
, 'contact', $prefix, []);
1447 * Returns the list of indices
1449 * @param bool $localize
1453 public static function indices($localize = TRUE) {
1455 'index_contact_type' => [
1456 'name' => 'index_contact_type',
1458 0 => 'contact_type',
1460 'localizable' => FALSE,
1461 'sig' => 'civicrm_contact::0::contact_type',
1463 'index_contact_sub_type' => [
1464 'name' => 'index_contact_sub_type',
1466 0 => 'contact_sub_type',
1468 'localizable' => FALSE,
1469 'sig' => 'civicrm_contact::0::contact_sub_type',
1471 'UI_external_identifier' => [
1472 'name' => 'UI_external_identifier',
1474 0 => 'external_identifier',
1476 'localizable' => FALSE,
1478 'sig' => 'civicrm_contact::1::external_identifier',
1480 'index_sort_name' => [
1481 'name' => 'index_sort_name',
1485 'localizable' => FALSE,
1486 'sig' => 'civicrm_contact::0::sort_name',
1488 'index_preferred_communication_method' => [
1489 'name' => 'index_preferred_communication_method',
1491 0 => 'preferred_communication_method',
1493 'localizable' => FALSE,
1494 'sig' => 'civicrm_contact::0::preferred_communication_method',
1497 'name' => 'index_hash',
1501 'localizable' => FALSE,
1502 'sig' => 'civicrm_contact::0::hash',
1504 'index_api_key' => [
1505 'name' => 'index_api_key',
1509 'localizable' => FALSE,
1510 'sig' => 'civicrm_contact::0::api_key',
1512 'index_first_name' => [
1513 'name' => 'index_first_name',
1517 'localizable' => FALSE,
1518 'sig' => 'civicrm_contact::0::first_name',
1520 'index_last_name' => [
1521 'name' => 'index_last_name',
1525 'localizable' => FALSE,
1526 'sig' => 'civicrm_contact::0::last_name',
1529 'name' => 'UI_prefix',
1533 'localizable' => FALSE,
1534 'sig' => 'civicrm_contact::0::prefix_id',
1537 'name' => 'UI_suffix',
1541 'localizable' => FALSE,
1542 'sig' => 'civicrm_contact::0::suffix_id',
1544 'index_communication_style_id' => [
1545 'name' => 'index_communication_style_id',
1547 0 => 'communication_style_id',
1549 'localizable' => FALSE,
1550 'sig' => 'civicrm_contact::0::communication_style_id',
1553 'name' => 'UI_gender',
1557 'localizable' => FALSE,
1558 'sig' => 'civicrm_contact::0::gender_id',
1560 'index_is_deceased' => [
1561 'name' => 'index_is_deceased',
1565 'localizable' => FALSE,
1566 'sig' => 'civicrm_contact::0::is_deceased',
1568 'index_household_name' => [
1569 'name' => 'index_household_name',
1571 0 => 'household_name',
1573 'localizable' => FALSE,
1574 'sig' => 'civicrm_contact::0::household_name',
1576 'index_organization_name' => [
1577 'name' => 'index_organization_name',
1579 0 => 'organization_name',
1581 'localizable' => FALSE,
1582 'sig' => 'civicrm_contact::0::organization_name',
1584 'index_is_deleted_sort_name' => [
1585 'name' => 'index_is_deleted_sort_name',
1591 'localizable' => FALSE,
1592 'sig' => 'civicrm_contact::0::is_deleted::sort_name::id',
1594 'index_created_date' => [
1595 'name' => 'index_created_date',
1597 0 => 'created_date',
1599 'localizable' => FALSE,
1600 'sig' => 'civicrm_contact::0::created_date',
1602 'index_modified_date' => [
1603 'name' => 'index_modified_date',
1605 0 => 'modified_date',
1607 'localizable' => FALSE,
1608 'sig' => 'civicrm_contact::0::modified_date',
1611 return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables
::multilingualize(__CLASS__
, $indices) : $indices;