Merge pull request #19525 from eileenmcnaughton/member_soft
[civicrm-core.git] / CRM / Friend / DAO / Friend.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/Friend/Friend.xml
8 * DO NOT EDIT. Generated by CRM_Core_CodeGen
2cbbebe8 9 * (GenCodeChecksum:a8021c454eacc9a8dbcd09e0310a1d5f)
e501603b 10 */
c3fc2621 11
f41f0342 12/**
c3fc2621 13 * Database access object for the Friend entity.
f41f0342 14 */
e501603b 15class CRM_Friend_DAO_Friend extends CRM_Core_DAO {
929a1c14
CW
16 const EXT = 'civicrm';
17 const TABLE_ADDED = '2.0';
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_tell_friend';
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 = FALSE;
c3fc2621 32
e501603b
TO
33 /**
34 * Friend ID
35 *
e6ca0a57 36 * @var int
e501603b
TO
37 */
38 public $id;
c3fc2621 39
e501603b
TO
40 /**
41 * Name of table where item being referenced is stored.
42 *
43 * @var string
44 */
45 public $entity_table;
c3fc2621 46
e501603b
TO
47 /**
48 * Foreign key to the referenced item.
49 *
e6ca0a57 50 * @var int
e501603b
TO
51 */
52 public $entity_id;
c3fc2621 53
e501603b 54 /**
e501603b
TO
55 * @var string
56 */
57 public $title;
c3fc2621 58
e501603b
TO
59 /**
60 * Introductory message to contributor or participant displayed on the Tell a Friend form.
61 *
62 * @var text
63 */
64 public $intro;
c3fc2621 65
e501603b
TO
66 /**
67 * Suggested message to friends, provided as default on the Tell A Friend form.
68 *
69 * @var text
70 */
71 public $suggested_message;
c3fc2621 72
e501603b
TO
73 /**
74 * URL for general info about the organization - included in the email sent to friends.
75 *
76 * @var string
77 */
78 public $general_link;
c3fc2621 79
e501603b
TO
80 /**
81 * Text for Tell a Friend thank you page header and HTML title.
82 *
83 * @var string
84 */
85 public $thankyou_title;
c3fc2621 86
e501603b
TO
87 /**
88 * Thank you message displayed on success page.
89 *
90 * @var text
91 */
92 public $thankyou_text;
c3fc2621 93
e501603b 94 /**
e6ca0a57 95 * @var bool
e501603b
TO
96 */
97 public $is_active;
c3fc2621 98
e501603b 99 /**
f41f0342 100 * Class constructor.
e501603b 101 */
c3fc2621 102 public function __construct() {
e501603b
TO
103 $this->__table = 'civicrm_tell_friend';
104 parent::__construct();
105 }
c3fc2621 106
449c4e6b
CW
107 /**
108 * Returns localized title of this entity.
7b66c3b5
AH
109 *
110 * @param bool $plural
111 * Whether to return the plural version of the title.
449c4e6b 112 */
7b66c3b5
AH
113 public static function getEntityTitle($plural = FALSE) {
114 return $plural ? ts('Friends') : ts('Friend');
449c4e6b
CW
115 }
116
e501603b 117 /**
f41f0342 118 * Returns foreign keys and entity references.
e501603b
TO
119 *
120 * @return array
121 * [CRM_Core_Reference_Interface]
122 */
c3fc2621 123 public static function getReferenceColumns() {
346aaaba 124 if (!isset(Civi::$statics[__CLASS__]['links'])) {
fa45b5b9 125 Civi::$statics[__CLASS__]['links'] = static::createReferenceColumns(__CLASS__);
c3fc2621 126 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Dynamic(self::getTableName(), 'entity_id', NULL, 'id', 'entity_table');
346aaaba 127 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'links_callback', Civi::$statics[__CLASS__]['links']);
e501603b 128 }
346aaaba 129 return Civi::$statics[__CLASS__]['links'];
e501603b 130 }
c3fc2621 131
e501603b
TO
132 /**
133 * Returns all the column names of this table
134 *
135 * @return array
136 */
c3fc2621 137 public static function &fields() {
346aaaba 138 if (!isset(Civi::$statics[__CLASS__]['fields'])) {
c3fc2621
CW
139 Civi::$statics[__CLASS__]['fields'] = [
140 'id' => [
e501603b
TO
141 'name' => 'id',
142 'type' => CRM_Utils_Type::T_INT,
c3fc2621 143 'title' => ts('Friend ID'),
215b423e 144 'description' => ts('Friend ID'),
c3fc2621 145 'required' => TRUE,
a36434b9 146 'where' => 'civicrm_tell_friend.id',
522a26c9 147 'table_name' => 'civicrm_tell_friend',
148 'entity' => 'Friend',
149 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 150 'localizable' => 0,
2cbbebe8
A
151 'html' => [
152 'type' => 'Number',
153 ],
a9d0587b 154 'add' => '2.0',
c3fc2621
CW
155 ],
156 'entity_table' => [
e501603b
TO
157 'name' => 'entity_table',
158 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 159 'title' => ts('Entity Table'),
215b423e 160 'description' => ts('Name of table where item being referenced is stored.'),
c3fc2621 161 'required' => TRUE,
e501603b
TO
162 'maxlength' => 64,
163 'size' => CRM_Utils_Type::BIG,
a36434b9 164 'where' => 'civicrm_tell_friend.entity_table',
522a26c9 165 'table_name' => 'civicrm_tell_friend',
166 'entity' => 'Friend',
167 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 168 'localizable' => 0,
a9d0587b 169 'add' => '2.0',
c3fc2621
CW
170 ],
171 'entity_id' => [
e501603b
TO
172 'name' => 'entity_id',
173 'type' => CRM_Utils_Type::T_INT,
c3fc2621 174 'title' => ts('Entity ID'),
215b423e 175 'description' => ts('Foreign key to the referenced item.'),
c3fc2621 176 'required' => TRUE,
a36434b9 177 'where' => 'civicrm_tell_friend.entity_id',
522a26c9 178 'table_name' => 'civicrm_tell_friend',
179 'entity' => 'Friend',
180 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 181 'localizable' => 0,
a9d0587b 182 'add' => '2.0',
c3fc2621
CW
183 ],
184 'title' => [
e501603b
TO
185 'name' => 'title',
186 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 187 'title' => ts('Title'),
e501603b
TO
188 'maxlength' => 255,
189 'size' => CRM_Utils_Type::HUGE,
a36434b9 190 'where' => 'civicrm_tell_friend.title',
522a26c9 191 'table_name' => 'civicrm_tell_friend',
192 'entity' => 'Friend',
193 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 194 'localizable' => 1,
c3fc2621 195 'html' => [
e501603b 196 'type' => 'Text',
c3fc2621 197 ],
a9d0587b 198 'add' => '2.0',
c3fc2621
CW
199 ],
200 'intro' => [
e501603b
TO
201 'name' => 'intro',
202 'type' => CRM_Utils_Type::T_TEXT,
c3fc2621 203 'title' => ts('Intro'),
215b423e 204 'description' => ts('Introductory message to contributor or participant displayed on the Tell a Friend form.'),
a36434b9 205 'where' => 'civicrm_tell_friend.intro',
522a26c9 206 'table_name' => 'civicrm_tell_friend',
207 'entity' => 'Friend',
208 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 209 'localizable' => 1,
c3fc2621 210 'html' => [
e501603b 211 'type' => 'Text',
c3fc2621 212 ],
a9d0587b 213 'add' => '2.0',
c3fc2621
CW
214 ],
215 'suggested_message' => [
e501603b
TO
216 'name' => 'suggested_message',
217 'type' => CRM_Utils_Type::T_TEXT,
c3fc2621 218 'title' => ts('Suggested Message'),
215b423e 219 'description' => ts('Suggested message to friends, provided as default on the Tell A Friend form.'),
a36434b9 220 'where' => 'civicrm_tell_friend.suggested_message',
522a26c9 221 'table_name' => 'civicrm_tell_friend',
222 'entity' => 'Friend',
223 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 224 'localizable' => 1,
c3fc2621 225 'html' => [
e501603b 226 'type' => 'Text',
c3fc2621 227 ],
a9d0587b 228 'add' => '2.0',
c3fc2621
CW
229 ],
230 'general_link' => [
e501603b
TO
231 'name' => 'general_link',
232 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 233 'title' => ts('General Link'),
215b423e 234 'description' => ts('URL for general info about the organization - included in the email sent to friends.'),
e501603b
TO
235 'maxlength' => 255,
236 'size' => CRM_Utils_Type::HUGE,
c3fc2621 237 'import' => TRUE,
e501603b 238 'where' => 'civicrm_tell_friend.general_link',
c3fc2621 239 'export' => TRUE,
522a26c9 240 'table_name' => 'civicrm_tell_friend',
241 'entity' => 'Friend',
242 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 243 'localizable' => 0,
c3fc2621 244 'html' => [
e501603b 245 'type' => 'Text',
c3fc2621 246 ],
a9d0587b 247 'add' => '2.0',
c3fc2621
CW
248 ],
249 'thankyou_title' => [
e501603b
TO
250 'name' => 'thankyou_title',
251 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 252 'title' => ts('Thank You Title'),
215b423e 253 'description' => ts('Text for Tell a Friend thank you page header and HTML title.'),
e501603b
TO
254 'maxlength' => 255,
255 'size' => CRM_Utils_Type::HUGE,
a36434b9 256 'where' => 'civicrm_tell_friend.thankyou_title',
522a26c9 257 'table_name' => 'civicrm_tell_friend',
258 'entity' => 'Friend',
259 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 260 'localizable' => 1,
c3fc2621 261 'html' => [
e501603b 262 'type' => 'Text',
c3fc2621 263 ],
a9d0587b 264 'add' => '2.0',
c3fc2621
CW
265 ],
266 'thankyou_text' => [
e501603b
TO
267 'name' => 'thankyou_text',
268 'type' => CRM_Utils_Type::T_TEXT,
c3fc2621 269 'title' => ts('Thank You Text'),
215b423e 270 'description' => ts('Thank you message displayed on success page.'),
a36434b9 271 'where' => 'civicrm_tell_friend.thankyou_text',
522a26c9 272 'table_name' => 'civicrm_tell_friend',
273 'entity' => 'Friend',
274 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 275 'localizable' => 1,
c3fc2621 276 'html' => [
e501603b 277 'type' => 'Text',
c3fc2621 278 ],
a9d0587b 279 'add' => '2.0',
c3fc2621
CW
280 ],
281 'is_active' => [
e501603b
TO
282 'name' => 'is_active',
283 'type' => CRM_Utils_Type::T_BOOLEAN,
c3fc2621 284 'title' => ts('Enabled?'),
a36434b9 285 'where' => 'civicrm_tell_friend.is_active',
522a26c9 286 'table_name' => 'civicrm_tell_friend',
287 'entity' => 'Friend',
288 'bao' => 'CRM_Friend_BAO_Friend',
6a7e5e5d 289 'localizable' => 0,
c3fc2621 290 'html' => [
e501603b 291 'type' => 'CheckBox',
c3fc2621 292 ],
a9d0587b 293 'add' => '2.0',
c3fc2621
CW
294 ],
295 ];
346aaaba 296 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'fields_callback', Civi::$statics[__CLASS__]['fields']);
e501603b 297 }
346aaaba 298 return Civi::$statics[__CLASS__]['fields'];
e501603b 299 }
c3fc2621 300
e501603b 301 /**
bd8e0b14 302 * Return a mapping from field-name to the corresponding key (as used in fields()).
e501603b
TO
303 *
304 * @return array
bd8e0b14 305 * Array(string $name => string $uniqueName).
e501603b 306 */
c3fc2621 307 public static function &fieldKeys() {
bd8e0b14
TO
308 if (!isset(Civi::$statics[__CLASS__]['fieldKeys'])) {
309 Civi::$statics[__CLASS__]['fieldKeys'] = array_flip(CRM_Utils_Array::collect('name', self::fields()));
e501603b 310 }
bd8e0b14 311 return Civi::$statics[__CLASS__]['fieldKeys'];
e501603b 312 }
c3fc2621 313
e501603b
TO
314 /**
315 * Returns the names of this table
316 *
317 * @return string
318 */
c3fc2621 319 public static function getTableName() {
e501603b
TO
320 return CRM_Core_DAO::getLocaleTableName(self::$_tableName);
321 }
c3fc2621 322
e501603b
TO
323 /**
324 * Returns if this table needs to be logged
325 *
c3fc2621 326 * @return bool
e501603b 327 */
c3fc2621 328 public function getLog() {
e501603b
TO
329 return self::$_log;
330 }
c3fc2621 331
e501603b
TO
332 /**
333 * Returns the list of fields that can be imported
334 *
335 * @param bool $prefix
336 *
337 * @return array
338 */
c3fc2621
CW
339 public static function &import($prefix = FALSE) {
340 $r = CRM_Core_DAO_AllCoreTables::getImports(__CLASS__, 'tell_friend', $prefix, []);
60808919 341 return $r;
e501603b 342 }
c3fc2621 343
e501603b
TO
344 /**
345 * Returns the list of fields that can be exported
346 *
347 * @param bool $prefix
348 *
349 * @return array
350 */
c3fc2621
CW
351 public static function &export($prefix = FALSE) {
352 $r = CRM_Core_DAO_AllCoreTables::getExports(__CLASS__, 'tell_friend', $prefix, []);
60808919 353 return $r;
e501603b 354 }
c3fc2621 355
e7a6b91a
AS
356 /**
357 * Returns the list of indices
c3fc2621
CW
358 *
359 * @param bool $localize
360 *
361 * @return array
e7a6b91a
AS
362 */
363 public static function indices($localize = TRUE) {
c3fc2621 364 $indices = [];
e7a6b91a
AS
365 return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables::multilingualize(__CLASS__, $indices) : $indices;
366 }
c3fc2621 367
e501603b 368}