Respect '0' as a default when generating DAOs
[civicrm-core.git] / CRM / Core / DAO / UFField.php
CommitLineData
e501603b 1<?php
c3fc2621 2
e501603b
TO
3/**
4 * @package CRM
8c9251b3 5 * @copyright CiviCRM LLC (c) 2004-2018
e501603b
TO
6 *
7 * Generated from xml/schema/CRM/Core/UFField.xml
8 * DO NOT EDIT. Generated by CRM_Core_CodeGen
e7a6b91a 9 * (GenCodeChecksum:4777c5b97760d4bd4b7138468d18ded5)
e501603b 10 */
c3fc2621 11
f41f0342 12/**
c3fc2621 13 * Database access object for the UFField entity.
f41f0342 14 */
e501603b 15class CRM_Core_DAO_UFField extends CRM_Core_DAO {
c3fc2621 16
e501603b 17 /**
f41f0342 18 * Static instance to hold the table name.
e501603b
TO
19 *
20 * @var string
21 */
22 static $_tableName = 'civicrm_uf_field';
c3fc2621 23
e501603b 24 /**
f41f0342 25 * Should CiviCRM log any modifications to this table in the civicrm_log table.
e501603b 26 *
c3fc2621 27 * @var bool
e501603b 28 */
c3fc2621
CW
29 static $_log = TRUE;
30
e501603b
TO
31 /**
32 * Unique table ID
33 *
34 * @var int unsigned
35 */
36 public $id;
c3fc2621 37
e501603b
TO
38 /**
39 * Which form does this field belong to.
40 *
41 * @var int unsigned
42 */
43 public $uf_group_id;
c3fc2621 44
e501603b
TO
45 /**
46 * Name for CiviCRM field which is being exposed for sharing.
47 *
48 * @var string
49 */
50 public $field_name;
c3fc2621 51
e501603b
TO
52 /**
53 * Is this field currently shareable? If false, hide the field for all sharing contexts.
54 *
55 * @var boolean
56 */
57 public $is_active;
c3fc2621 58
e501603b
TO
59 /**
60 * the field is view only and not editable in user forms.
61 *
62 * @var boolean
63 */
64 public $is_view;
c3fc2621 65
e501603b
TO
66 /**
67 * Is this field required when included in a user or registration form?
68 *
69 * @var boolean
70 */
71 public $is_required;
c3fc2621 72
e501603b
TO
73 /**
74 * Controls field display order when user framework fields are displayed in registration and account editing forms.
75 *
76 * @var int
77 */
78 public $weight;
c3fc2621 79
e501603b
TO
80 /**
81 * Description and/or help text to display after this field.
82 *
83 * @var text
84 */
85 public $help_post;
c3fc2621 86
e501603b
TO
87 /**
88 * Description and/or help text to display before this field.
89 *
90 * @var text
91 */
92 public $help_pre;
c3fc2621 93
e501603b
TO
94 /**
95 * In what context(s) is this field visible.
96 *
97 * @var string
98 */
99 public $visibility;
c3fc2621 100
e501603b
TO
101 /**
102 * Is this field included as a column in the selector table?
103 *
104 * @var boolean
105 */
106 public $in_selector;
c3fc2621 107
e501603b
TO
108 /**
109 * Is this field included search form of profile?
110 *
111 * @var boolean
112 */
113 public $is_searchable;
c3fc2621 114
e501603b
TO
115 /**
116 * Location type of this mapping, if required
117 *
118 * @var int unsigned
119 */
120 public $location_type_id;
c3fc2621 121
e501603b
TO
122 /**
123 * Phone Type Id, if required
124 *
125 * @var int unsigned
126 */
127 public $phone_type_id;
c3fc2621 128
e501603b
TO
129 /**
130 * Website Type Id, if required
131 *
132 * @var int unsigned
133 */
134 public $website_type_id;
c3fc2621 135
e501603b
TO
136 /**
137 * To save label for fields.
138 *
139 * @var string
140 */
141 public $label;
c3fc2621 142
e501603b
TO
143 /**
144 * This field saves field type (ie individual,household.. field etc).
145 *
146 * @var string
147 */
148 public $field_type;
c3fc2621 149
e501603b
TO
150 /**
151 * Is this field reserved for use by some other CiviCRM functionality?
152 *
153 * @var boolean
154 */
155 public $is_reserved;
c3fc2621 156
e501603b
TO
157 /**
158 * Include in multi-record listing?
159 *
160 * @var boolean
161 */
162 public $is_multi_summary;
c3fc2621 163
e501603b 164 /**
f41f0342 165 * Class constructor.
e501603b 166 */
c3fc2621 167 public function __construct() {
e501603b
TO
168 $this->__table = 'civicrm_uf_field';
169 parent::__construct();
170 }
c3fc2621 171
e501603b 172 /**
f41f0342 173 * Returns foreign keys and entity references.
e501603b
TO
174 *
175 * @return array
176 * [CRM_Core_Reference_Interface]
177 */
c3fc2621 178 public static function getReferenceColumns() {
346aaaba
TO
179 if (!isset(Civi::$statics[__CLASS__]['links'])) {
180 Civi::$statics[__CLASS__]['links'] = static ::createReferenceColumns(__CLASS__);
c3fc2621
CW
181 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), 'uf_group_id', 'civicrm_uf_group', 'id');
182 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), 'location_type_id', 'civicrm_location_type', 'id');
346aaaba 183 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'links_callback', Civi::$statics[__CLASS__]['links']);
e501603b 184 }
346aaaba 185 return Civi::$statics[__CLASS__]['links'];
e501603b 186 }
c3fc2621 187
e501603b
TO
188 /**
189 * Returns all the column names of this table
190 *
191 * @return array
192 */
c3fc2621 193 public static function &fields() {
346aaaba 194 if (!isset(Civi::$statics[__CLASS__]['fields'])) {
c3fc2621
CW
195 Civi::$statics[__CLASS__]['fields'] = [
196 'id' => [
e501603b
TO
197 'name' => 'id',
198 'type' => CRM_Utils_Type::T_INT,
c3fc2621 199 'title' => ts('Profile Field ID'),
e501603b 200 'description' => 'Unique table ID',
c3fc2621 201 'required' => TRUE,
522a26c9 202 'table_name' => 'civicrm_uf_field',
203 'entity' => 'UFField',
204 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 205 'localizable' => 0,
c3fc2621
CW
206 ],
207 'uf_group_id' => [
e501603b
TO
208 'name' => 'uf_group_id',
209 'type' => CRM_Utils_Type::T_INT,
c3fc2621 210 'title' => ts('Profile ID'),
e501603b 211 'description' => 'Which form does this field belong to.',
c3fc2621 212 'required' => TRUE,
522a26c9 213 'table_name' => 'civicrm_uf_field',
214 'entity' => 'UFField',
215 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 216 'localizable' => 0,
e501603b 217 'FKClassName' => 'CRM_Core_DAO_UFGroup',
c3fc2621 218 'html' => [
e501603b 219 'type' => 'Select',
c3fc2621
CW
220 ],
221 'pseudoconstant' => [
e501603b
TO
222 'table' => 'civicrm_uf_group',
223 'keyColumn' => 'id',
224 'labelColumn' => 'title',
c3fc2621
CW
225 ]
226 ],
227 'field_name' => [
e501603b
TO
228 'name' => 'field_name',
229 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 230 'title' => ts('Profile Field Name'),
e501603b 231 'description' => 'Name for CiviCRM field which is being exposed for sharing.',
c3fc2621 232 'required' => TRUE,
e501603b
TO
233 'maxlength' => 64,
234 'size' => CRM_Utils_Type::BIG,
522a26c9 235 'table_name' => 'civicrm_uf_field',
236 'entity' => 'UFField',
237 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 238 'localizable' => 0,
c3fc2621
CW
239 ],
240 'is_active' => [
e501603b
TO
241 'name' => 'is_active',
242 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 243 'title' => ts('Profile Field Is Active'),
e501603b
TO
244 'description' => 'Is this field currently shareable? If false, hide the field for all sharing contexts.',
245 'default' => '1',
522a26c9 246 'table_name' => 'civicrm_uf_field',
247 'entity' => 'UFField',
248 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 249 'localizable' => 0,
c3fc2621
CW
250 ],
251 'is_view' => [
e501603b
TO
252 'name' => 'is_view',
253 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 254 'title' => ts('Profile Is View Only'),
e501603b 255 'description' => 'the field is view only and not editable in user forms.',
45a83e42 256 'default' => '0',
522a26c9 257 'table_name' => 'civicrm_uf_field',
258 'entity' => 'UFField',
259 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 260 'localizable' => 0,
c3fc2621
CW
261 ],
262 'is_required' => [
e501603b
TO
263 'name' => 'is_required',
264 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 265 'title' => ts('Profile Field Is Required'),
e501603b 266 'description' => 'Is this field required when included in a user or registration form?',
45a83e42 267 'default' => '0',
522a26c9 268 'table_name' => 'civicrm_uf_field',
269 'entity' => 'UFField',
270 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 271 'localizable' => 0,
c3fc2621
CW
272 ],
273 'weight' => [
e501603b
TO
274 'name' => 'weight',
275 'type' => CRM_Utils_Type::T_INT,
c3fc2621 276 'title' => ts('Order'),
e501603b 277 'description' => 'Controls field display order when user framework fields are displayed in registration and account editing forms.',
c3fc2621 278 'required' => TRUE,
e501603b 279 'default' => '1',
522a26c9 280 'table_name' => 'civicrm_uf_field',
281 'entity' => 'UFField',
282 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 283 'localizable' => 0,
c3fc2621
CW
284 ],
285 'help_post' => [
e501603b
TO
286 'name' => 'help_post',
287 'type' => CRM_Utils_Type::T_TEXT,
c3fc2621 288 'title' => ts('Profile Field Post Help'),
e501603b 289 'description' => 'Description and/or help text to display after this field.',
522a26c9 290 'table_name' => 'civicrm_uf_field',
291 'entity' => 'UFField',
292 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 293 'localizable' => 1,
c3fc2621
CW
294 ],
295 'help_pre' => [
e501603b
TO
296 'name' => 'help_pre',
297 'type' => CRM_Utils_Type::T_TEXT,
c3fc2621 298 'title' => ts('Profile Field Pre Help'),
e501603b 299 'description' => 'Description and/or help text to display before this field.',
522a26c9 300 'table_name' => 'civicrm_uf_field',
301 'entity' => 'UFField',
302 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 303 'localizable' => 1,
c3fc2621
CW
304 ],
305 'visibility' => [
e501603b
TO
306 'name' => 'visibility',
307 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 308 'title' => ts('Profile Field Visibility'),
e501603b
TO
309 'description' => 'In what context(s) is this field visible.',
310 'maxlength' => 32,
311 'size' => CRM_Utils_Type::MEDIUM,
312 'default' => 'User and User Admin Only',
522a26c9 313 'table_name' => 'civicrm_uf_field',
314 'entity' => 'UFField',
315 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 316 'localizable' => 0,
c3fc2621 317 'html' => [
e501603b 318 'type' => 'Select',
c3fc2621
CW
319 ],
320 'pseudoconstant' => [
e501603b 321 'callback' => 'CRM_Core_SelectValues::ufVisibility',
c3fc2621
CW
322 ]
323 ],
324 'in_selector' => [
e501603b
TO
325 'name' => 'in_selector',
326 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 327 'title' => ts('Profile Field Is a Filter'),
e501603b 328 'description' => 'Is this field included as a column in the selector table?',
45a83e42 329 'default' => '0',
522a26c9 330 'table_name' => 'civicrm_uf_field',
331 'entity' => 'UFField',
332 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 333 'localizable' => 0,
c3fc2621
CW
334 ],
335 'is_searchable' => [
e501603b
TO
336 'name' => 'is_searchable',
337 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 338 'title' => ts('Profile Field Is Searchable'),
e501603b 339 'description' => 'Is this field included search form of profile?',
45a83e42 340 'default' => '0',
522a26c9 341 'table_name' => 'civicrm_uf_field',
342 'entity' => 'UFField',
343 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 344 'localizable' => 0,
c3fc2621
CW
345 ],
346 'location_type_id' => [
e501603b
TO
347 'name' => 'location_type_id',
348 'type' => CRM_Utils_Type::T_INT,
c3fc2621 349 'title' => ts('Profile Field Location Type'),
e501603b 350 'description' => 'Location type of this mapping, if required',
522a26c9 351 'table_name' => 'civicrm_uf_field',
352 'entity' => 'UFField',
353 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 354 'localizable' => 0,
e501603b 355 'FKClassName' => 'CRM_Core_DAO_LocationType',
c3fc2621
CW
356 ],
357 'phone_type_id' => [
e501603b
TO
358 'name' => 'phone_type_id',
359 'type' => CRM_Utils_Type::T_INT,
c3fc2621 360 'title' => ts('Profile Field Phone Type'),
e501603b 361 'description' => 'Phone Type Id, if required',
522a26c9 362 'table_name' => 'civicrm_uf_field',
363 'entity' => 'UFField',
364 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 365 'localizable' => 0,
c3fc2621
CW
366 ],
367 'website_type_id' => [
e501603b
TO
368 'name' => 'website_type_id',
369 'type' => CRM_Utils_Type::T_INT,
c3fc2621 370 'title' => ts('Profile Field Website Type'),
e501603b 371 'description' => 'Website Type Id, if required',
522a26c9 372 'table_name' => 'civicrm_uf_field',
373 'entity' => 'UFField',
374 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 375 'localizable' => 0,
c3fc2621
CW
376 ],
377 'label' => [
e501603b
TO
378 'name' => 'label',
379 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 380 'title' => ts('Profile Field Label'),
e501603b 381 'description' => 'To save label for fields.',
c3fc2621 382 'required' => TRUE,
e501603b
TO
383 'maxlength' => 255,
384 'size' => CRM_Utils_Type::HUGE,
522a26c9 385 'table_name' => 'civicrm_uf_field',
386 'entity' => 'UFField',
387 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 388 'localizable' => 1,
c3fc2621
CW
389 ],
390 'field_type' => [
e501603b
TO
391 'name' => 'field_type',
392 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 393 'title' => ts('Profile Field Type'),
e501603b
TO
394 'description' => 'This field saves field type (ie individual,household.. field etc).',
395 'maxlength' => 255,
396 'size' => CRM_Utils_Type::HUGE,
522a26c9 397 'table_name' => 'civicrm_uf_field',
398 'entity' => 'UFField',
399 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 400 'localizable' => 0,
c3fc2621
CW
401 ],
402 'is_reserved' => [
e501603b
TO
403 'name' => 'is_reserved',
404 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 405 'title' => ts('Profile Field Is Reserved'),
e501603b 406 'description' => 'Is this field reserved for use by some other CiviCRM functionality?',
522a26c9 407 'table_name' => 'civicrm_uf_field',
408 'entity' => 'UFField',
409 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 410 'localizable' => 0,
c3fc2621
CW
411 ],
412 'is_multi_summary' => [
e501603b
TO
413 'name' => 'is_multi_summary',
414 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 415 'title' => ts('Profile Field Supports Multiple'),
e501603b 416 'description' => 'Include in multi-record listing?',
45a83e42 417 'default' => '0',
522a26c9 418 'table_name' => 'civicrm_uf_field',
419 'entity' => 'UFField',
420 'bao' => 'CRM_Core_BAO_UFField',
6a7e5e5d 421 'localizable' => 0,
c3fc2621
CW
422 ],
423 ];
346aaaba 424 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'fields_callback', Civi::$statics[__CLASS__]['fields']);
e501603b 425 }
346aaaba 426 return Civi::$statics[__CLASS__]['fields'];
e501603b 427 }
c3fc2621 428
e501603b 429 /**
bd8e0b14 430 * Return a mapping from field-name to the corresponding key (as used in fields()).
e501603b
TO
431 *
432 * @return array
bd8e0b14 433 * Array(string $name => string $uniqueName).
e501603b 434 */
c3fc2621 435 public static function &fieldKeys() {
bd8e0b14
TO
436 if (!isset(Civi::$statics[__CLASS__]['fieldKeys'])) {
437 Civi::$statics[__CLASS__]['fieldKeys'] = array_flip(CRM_Utils_Array::collect('name', self::fields()));
e501603b 438 }
bd8e0b14 439 return Civi::$statics[__CLASS__]['fieldKeys'];
e501603b 440 }
c3fc2621 441
e501603b
TO
442 /**
443 * Returns the names of this table
444 *
445 * @return string
446 */
c3fc2621 447 public static function getTableName() {
e501603b
TO
448 return CRM_Core_DAO::getLocaleTableName(self::$_tableName);
449 }
c3fc2621 450
e501603b
TO
451 /**
452 * Returns if this table needs to be logged
453 *
c3fc2621 454 * @return bool
e501603b 455 */
c3fc2621 456 public function getLog() {
e501603b
TO
457 return self::$_log;
458 }
c3fc2621 459
e501603b
TO
460 /**
461 * Returns the list of fields that can be imported
462 *
463 * @param bool $prefix
464 *
465 * @return array
466 */
c3fc2621
CW
467 public static function &import($prefix = FALSE) {
468 $r = CRM_Core_DAO_AllCoreTables::getImports(__CLASS__, 'uf_field', $prefix, []);
60808919 469 return $r;
e501603b 470 }
c3fc2621 471
e501603b
TO
472 /**
473 * Returns the list of fields that can be exported
474 *
475 * @param bool $prefix
476 *
477 * @return array
478 */
c3fc2621
CW
479 public static function &export($prefix = FALSE) {
480 $r = CRM_Core_DAO_AllCoreTables::getExports(__CLASS__, 'uf_field', $prefix, []);
60808919 481 return $r;
e501603b 482 }
c3fc2621 483
e7a6b91a
AS
484 /**
485 * Returns the list of indices
c3fc2621
CW
486 *
487 * @param bool $localize
488 *
489 * @return array
e7a6b91a
AS
490 */
491 public static function indices($localize = TRUE) {
c3fc2621
CW
492 $indices = [
493 'IX_website_type_id' => [
e7a6b91a 494 'name' => 'IX_website_type_id',
c3fc2621 495 'field' => [
e7a6b91a 496 0 => 'website_type_id',
c3fc2621
CW
497 ],
498 'localizable' => FALSE,
e7a6b91a 499 'sig' => 'civicrm_uf_field::0::website_type_id',
c3fc2621
CW
500 ],
501 ];
e7a6b91a
AS
502 return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables::multilingualize(__CLASS__, $indices) : $indices;
503 }
c3fc2621 504
e501603b 505}