DAOs with singular/plural options for entity titles
[civicrm-core.git] / CRM / Case / DAO / CaseContact.php
CommitLineData
e501603b 1<?php
c3fc2621 2
e501603b
TO
3/**
4 * @package CRM
ca5cec67 5 * @copyright CiviCRM LLC https://civicrm.org/licensing
e501603b
TO
6 *
7 * Generated from xml/schema/CRM/Case/CaseContact.xml
8 * DO NOT EDIT. Generated by CRM_Core_CodeGen
7b66c3b5 9 * (GenCodeChecksum:57c93b00e00d0a48d5071d5a991289ab)
e501603b 10 */
c3fc2621 11
f41f0342 12/**
c3fc2621 13 * Database access object for the CaseContact entity.
f41f0342 14 */
e501603b 15class CRM_Case_DAO_CaseContact extends CRM_Core_DAO {
929a1c14
CW
16 const EXT = 'civicrm';
17 const TABLE_ADDED = '2.1';
c3fc2621 18
e501603b 19 /**
f41f0342 20 * Static instance to hold the table name.
e501603b
TO
21 *
22 * @var string
23 */
fa45b5b9 24 public static $_tableName = 'civicrm_case_contact';
c3fc2621 25
e501603b 26 /**
f41f0342 27 * Should CiviCRM log any modifications to this table in the civicrm_log table.
e501603b 28 *
c3fc2621 29 * @var bool
e501603b 30 */
fa45b5b9 31 public static $_log = TRUE;
c3fc2621 32
e501603b
TO
33 /**
34 * Unique case-contact association id
35 *
e6ca0a57 36 * @var int
e501603b
TO
37 */
38 public $id;
c3fc2621 39
e501603b
TO
40 /**
41 * Case ID of case-contact association.
42 *
e6ca0a57 43 * @var int
e501603b
TO
44 */
45 public $case_id;
c3fc2621 46
e501603b
TO
47 /**
48 * Contact ID of contact record given case belongs to.
49 *
e6ca0a57 50 * @var int
e501603b
TO
51 */
52 public $contact_id;
c3fc2621 53
e501603b 54 /**
f41f0342 55 * Class constructor.
e501603b 56 */
c3fc2621 57 public function __construct() {
e501603b
TO
58 $this->__table = 'civicrm_case_contact';
59 parent::__construct();
60 }
c3fc2621 61
449c4e6b
CW
62 /**
63 * Returns localized title of this entity.
7b66c3b5
AH
64 *
65 * @param bool $plural
66 * Whether to return the plural version of the title.
449c4e6b 67 */
7b66c3b5
AH
68 public static function getEntityTitle($plural = FALSE) {
69 return $plural ? ts('Case Contacts') : ts('Case Contact');
449c4e6b
CW
70 }
71
e501603b 72 /**
f41f0342 73 * Returns foreign keys and entity references.
e501603b
TO
74 *
75 * @return array
76 * [CRM_Core_Reference_Interface]
77 */
c3fc2621 78 public static function getReferenceColumns() {
346aaaba 79 if (!isset(Civi::$statics[__CLASS__]['links'])) {
fa45b5b9 80 Civi::$statics[__CLASS__]['links'] = static::createReferenceColumns(__CLASS__);
c3fc2621
CW
81 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), 'case_id', 'civicrm_case', 'id');
82 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), 'contact_id', 'civicrm_contact', 'id');
346aaaba 83 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'links_callback', Civi::$statics[__CLASS__]['links']);
e501603b 84 }
346aaaba 85 return Civi::$statics[__CLASS__]['links'];
e501603b 86 }
c3fc2621 87
e501603b
TO
88 /**
89 * Returns all the column names of this table
90 *
91 * @return array
92 */
c3fc2621 93 public static function &fields() {
346aaaba 94 if (!isset(Civi::$statics[__CLASS__]['fields'])) {
c3fc2621
CW
95 Civi::$statics[__CLASS__]['fields'] = [
96 'id' => [
e501603b
TO
97 'name' => 'id',
98 'type' => CRM_Utils_Type::T_INT,
c3fc2621 99 'title' => ts('Case Contact ID'),
215b423e 100 'description' => ts('Unique case-contact association id'),
c3fc2621 101 'required' => TRUE,
a36434b9 102 'where' => 'civicrm_case_contact.id',
522a26c9 103 'table_name' => 'civicrm_case_contact',
104 'entity' => 'CaseContact',
105 'bao' => 'CRM_Case_BAO_CaseContact',
6a7e5e5d 106 'localizable' => 0,
a9d0587b 107 'add' => '2.1',
c3fc2621
CW
108 ],
109 'case_id' => [
e501603b
TO
110 'name' => 'case_id',
111 'type' => CRM_Utils_Type::T_INT,
c3fc2621 112 'title' => ts('Case'),
215b423e 113 'description' => ts('Case ID of case-contact association.'),
c3fc2621 114 'required' => TRUE,
a36434b9 115 'where' => 'civicrm_case_contact.case_id',
522a26c9 116 'table_name' => 'civicrm_case_contact',
117 'entity' => 'CaseContact',
118 'bao' => 'CRM_Case_BAO_CaseContact',
6a7e5e5d 119 'localizable' => 0,
e501603b 120 'FKClassName' => 'CRM_Case_DAO_Case',
a9d0587b 121 'add' => '2.1',
c3fc2621
CW
122 ],
123 'contact_id' => [
e501603b
TO
124 'name' => 'contact_id',
125 'type' => CRM_Utils_Type::T_INT,
c3fc2621 126 'title' => ts('Contact ID'),
215b423e 127 'description' => ts('Contact ID of contact record given case belongs to.'),
c3fc2621 128 'required' => TRUE,
a36434b9 129 'where' => 'civicrm_case_contact.contact_id',
522a26c9 130 'table_name' => 'civicrm_case_contact',
131 'entity' => 'CaseContact',
132 'bao' => 'CRM_Case_BAO_CaseContact',
6a7e5e5d 133 'localizable' => 0,
e501603b 134 'FKClassName' => 'CRM_Contact_DAO_Contact',
c3fc2621 135 'html' => [
e501603b 136 'type' => 'EntityRef',
c3fc2621 137 ],
a9d0587b 138 'add' => '2.1',
c3fc2621
CW
139 ],
140 ];
346aaaba 141 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'fields_callback', Civi::$statics[__CLASS__]['fields']);
e501603b 142 }
346aaaba 143 return Civi::$statics[__CLASS__]['fields'];
e501603b 144 }
c3fc2621 145
e501603b 146 /**
bd8e0b14 147 * Return a mapping from field-name to the corresponding key (as used in fields()).
e501603b
TO
148 *
149 * @return array
bd8e0b14 150 * Array(string $name => string $uniqueName).
e501603b 151 */
c3fc2621 152 public static function &fieldKeys() {
bd8e0b14
TO
153 if (!isset(Civi::$statics[__CLASS__]['fieldKeys'])) {
154 Civi::$statics[__CLASS__]['fieldKeys'] = array_flip(CRM_Utils_Array::collect('name', self::fields()));
e501603b 155 }
bd8e0b14 156 return Civi::$statics[__CLASS__]['fieldKeys'];
e501603b 157 }
c3fc2621 158
e501603b
TO
159 /**
160 * Returns the names of this table
161 *
162 * @return string
163 */
c3fc2621 164 public static function getTableName() {
e501603b
TO
165 return self::$_tableName;
166 }
c3fc2621 167
e501603b
TO
168 /**
169 * Returns if this table needs to be logged
170 *
c3fc2621 171 * @return bool
e501603b 172 */
c3fc2621 173 public function getLog() {
e501603b
TO
174 return self::$_log;
175 }
c3fc2621 176
e501603b
TO
177 /**
178 * Returns the list of fields that can be imported
179 *
180 * @param bool $prefix
181 *
182 * @return array
183 */
c3fc2621
CW
184 public static function &import($prefix = FALSE) {
185 $r = CRM_Core_DAO_AllCoreTables::getImports(__CLASS__, 'case_contact', $prefix, []);
60808919 186 return $r;
e501603b 187 }
c3fc2621 188
e501603b
TO
189 /**
190 * Returns the list of fields that can be exported
191 *
192 * @param bool $prefix
193 *
194 * @return array
195 */
c3fc2621
CW
196 public static function &export($prefix = FALSE) {
197 $r = CRM_Core_DAO_AllCoreTables::getExports(__CLASS__, 'case_contact', $prefix, []);
60808919 198 return $r;
e501603b 199 }
c3fc2621 200
e7a6b91a
AS
201 /**
202 * Returns the list of indices
c3fc2621
CW
203 *
204 * @param bool $localize
205 *
206 * @return array
e7a6b91a
AS
207 */
208 public static function indices($localize = TRUE) {
c3fc2621
CW
209 $indices = [
210 'UI_case_contact_id' => [
e7a6b91a 211 'name' => 'UI_case_contact_id',
c3fc2621 212 'field' => [
e7a6b91a
AS
213 0 => 'case_id',
214 1 => 'contact_id',
c3fc2621
CW
215 ],
216 'localizable' => FALSE,
217 'unique' => TRUE,
738b63ef 218 'sig' => 'civicrm_case_contact::1::case_id::contact_id',
c3fc2621
CW
219 ],
220 ];
e7a6b91a
AS
221 return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables::multilingualize(__CLASS__, $indices) : $indices;
222 }
c3fc2621 223
e501603b 224}