Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?xml version="1.0" encoding="iso-8859-1" ?> |
2 | ||
3 | <table> | |
4 | <base>CRM/Mailing</base> | |
5 | <class>Mailing</class> | |
6 | <name>civicrm_mailing</name> | |
7 | <comment>Stores information about a mailing.</comment> | |
8 | <archive>true</archive> | |
9 | <field> | |
5435b737 | 10 | <name>id</name> |
0d94665e | 11 | <title>Mailing ID</title> |
5435b737 EM |
12 | <type>int unsigned</type> |
13 | <required>true</required> | |
6a488035 TO |
14 | </field> |
15 | <primaryKey> | |
5435b737 EM |
16 | <name>id</name> |
17 | <autoincrement>true</autoincrement> | |
6a488035 TO |
18 | </primaryKey> |
19 | <field> | |
5435b737 | 20 | <name>domain_id</name> |
0d94665e | 21 | <title>Mailing Domain</title> |
5435b737 EM |
22 | <type>int unsigned</type> |
23 | <pseudoconstant> | |
24 | <table>civicrm_domain</table> | |
25 | <keyColumn>id</keyColumn> | |
26 | <labelColumn>name</labelColumn> | |
27 | </pseudoconstant> | |
28 | <comment>Which site is this mailing for</comment> | |
29 | <add>3.4</add> | |
6a488035 TO |
30 | </field> |
31 | <foreignKey> | |
5435b737 EM |
32 | <name>domain_id</name> |
33 | <table>civicrm_domain</table> | |
34 | <key>id</key> | |
35 | <onDelete>SET NULL</onDelete> | |
36 | <add>3.4</add> | |
6a488035 TO |
37 | </foreignKey> |
38 | <field> | |
5435b737 | 39 | <name>header_id</name> |
0d94665e | 40 | <title>Mailing Header</title> |
5435b737 EM |
41 | <type>int unsigned</type> |
42 | <comment>FK to the header component.</comment> | |
6a488035 TO |
43 | </field> |
44 | <foreignKey> | |
5435b737 EM |
45 | <name>header_id</name> |
46 | <table>civicrm_mailing_component</table> | |
47 | <key>id</key> | |
48 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
49 | </foreignKey> |
50 | <field> | |
5435b737 | 51 | <name>footer_id</name> |
0d94665e | 52 | <title>Mailing Footer</title> |
5435b737 EM |
53 | <type>int unsigned</type> |
54 | <comment>FK to the footer component.</comment> | |
6a488035 TO |
55 | </field> |
56 | <foreignKey> | |
5435b737 EM |
57 | <name>footer_id</name> |
58 | <table>civicrm_mailing_component</table> | |
59 | <key>id</key> | |
60 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
61 | </foreignKey> |
62 | <field> | |
5435b737 | 63 | <name>reply_id</name> |
0d94665e | 64 | <title>Mailing Reply</title> |
5435b737 EM |
65 | <type>int unsigned</type> |
66 | <comment>FK to the auto-responder component.</comment> | |
6a488035 TO |
67 | </field> |
68 | <foreignKey> | |
5435b737 EM |
69 | <name>reply_id</name> |
70 | <table>civicrm_mailing_component</table> | |
71 | <key>id</key> | |
72 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
73 | </foreignKey> |
74 | <field> | |
5435b737 | 75 | <name>unsubscribe_id</name> |
0d94665e | 76 | <title>Mailing Unsubscribe</title> |
5435b737 EM |
77 | <type>int unsigned</type> |
78 | <comment>FK to the unsubscribe component.</comment> | |
6a488035 TO |
79 | </field> |
80 | <foreignKey> | |
5435b737 EM |
81 | <name>unsubscribe_id</name> |
82 | <table>civicrm_mailing_component</table> | |
83 | <key>id</key> | |
84 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
85 | </foreignKey> |
86 | <field> | |
5435b737 | 87 | <name>resubscribe_id</name> |
0d94665e | 88 | <title>Mailing Resubscribe</title> |
5435b737 | 89 | <type>int unsigned</type> |
6a488035 TO |
90 | </field> |
91 | <foreignKey> | |
5435b737 EM |
92 | <name>optout_id</name> |
93 | <table>civicrm_mailing_component</table> | |
94 | <key>id</key> | |
95 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
96 | </foreignKey> |
97 | <field> | |
5435b737 | 98 | <name>optout_id</name> |
0d94665e | 99 | <title>Mailing Opt Out</title> |
5435b737 EM |
100 | <type>int unsigned</type> |
101 | <comment>FK to the opt-out component.</comment> | |
6a488035 TO |
102 | </field> |
103 | <foreignKey> | |
5435b737 EM |
104 | <name>optout_id</name> |
105 | <table>civicrm_mailing_component</table> | |
106 | <key>id</key> | |
107 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
108 | </foreignKey> |
109 | <field> | |
5435b737 | 110 | <name>name</name> |
0d94665e | 111 | <title>Mailing Name</title> |
5435b737 EM |
112 | <type>varchar</type> |
113 | <length>128</length> | |
114 | <comment>Mailing Name.</comment> | |
115 | <html> | |
116 | <type>Text</type> | |
117 | </html> | |
6a488035 | 118 | </field> |
e81bac46 | 119 | <field> |
120 | <name>mailing_type</name> | |
121 | <type>varchar</type> | |
122 | <title>Mailing Type</title> | |
123 | <length>32</length> | |
124 | <comment>differentiate between standalone mailings, A/B tests, and A/B final-winner</comment> | |
125 | <pseudoconstant> | |
126 | <callback>CRM_Mailing_PseudoConstant::mailingTypes</callback> | |
127 | </pseudoconstant> | |
128 | <add>4.6</add> | |
129 | <html> | |
130 | <type>Select</type> | |
131 | </html> | |
132 | </field> | |
6a488035 | 133 | <field> |
5435b737 | 134 | <name>from_name</name> |
0d94665e | 135 | <title>Mailing From Name</title> |
5435b737 EM |
136 | <type>varchar</type> |
137 | <length>128</length> | |
138 | <comment>From Header of mailing</comment> | |
139 | <html> | |
140 | <type>Text</type> | |
141 | </html> | |
6a488035 TO |
142 | </field> |
143 | <field> | |
5435b737 | 144 | <name>from_email</name> |
0d94665e | 145 | <title>Mailing From Email</title> |
5435b737 EM |
146 | <type>varchar</type> |
147 | <length>128</length> | |
148 | <comment>From Email of mailing</comment> | |
149 | <html> | |
150 | <type>Text</type> | |
151 | </html> | |
6a488035 TO |
152 | </field> |
153 | <field> | |
5435b737 EM |
154 | <name>replyto_email</name> |
155 | <type>varchar</type> | |
156 | <length>128</length> | |
157 | <comment>Reply-To Email of mailing</comment> | |
158 | <html> | |
159 | <type>Text</type> | |
160 | </html> | |
6a488035 | 161 | </field> |
703875d8 TO |
162 | <field> |
163 | <name>template_type</name> | |
164 | <title>Template Type</title> | |
165 | <type>varchar</type> | |
166 | <length>64</length> | |
167 | <default>'traditional'</default> | |
168 | <required>true</required> | |
169 | <comment>The language/processing system used for email templates.</comment> | |
170 | <pseudoconstant> | |
171 | <callback>CRM_Mailing_BAO_Mailing::getTemplateTypeNames</callback> | |
172 | </pseudoconstant> | |
173 | </field> | |
174 | <field> | |
175 | <name>template_options</name> | |
176 | <title>Template Options (JSON)</title> | |
177 | <type>longtext</type> | |
178 | <comment>Advanced options used by the email templating system. (JSON encoded)</comment> | |
179 | </field> | |
6a488035 | 180 | <field> |
5435b737 EM |
181 | <name>subject</name> |
182 | <type>varchar</type> | |
183 | <length>128</length> | |
184 | <comment>Subject of mailing</comment> | |
185 | <html> | |
186 | <type>Text</type> | |
187 | </html> | |
6a488035 TO |
188 | </field> |
189 | <field> | |
5435b737 EM |
190 | <name>body_text</name> |
191 | <type>longtext</type> | |
192 | <comment>Body of the mailing in text format.</comment> | |
6a488035 TO |
193 | </field> |
194 | <field> | |
5435b737 EM |
195 | <name>body_html</name> |
196 | <type>longtext</type> | |
197 | <comment>Body of the mailing in html format.</comment> | |
6a488035 TO |
198 | </field> |
199 | <field> | |
5435b737 EM |
200 | <name>url_tracking</name> |
201 | <type>boolean</type> | |
202 | <comment>Should we track URL click-throughs for this mailing?</comment> | |
203 | <html> | |
204 | <type>CheckBox</type> | |
205 | </html> | |
6a488035 TO |
206 | </field> |
207 | <field> | |
5435b737 EM |
208 | <name>forward_replies</name> |
209 | <type>boolean</type> | |
210 | <comment>Should we forward replies back to the author?</comment> | |
211 | <html> | |
212 | <type>CheckBox</type> | |
213 | </html> | |
6a488035 TO |
214 | </field> |
215 | <field> | |
5435b737 EM |
216 | <name>auto_responder</name> |
217 | <type>boolean</type> | |
218 | <comment>Should we enable the auto-responder?</comment> | |
219 | <html> | |
220 | <type>CheckBox</type> | |
221 | </html> | |
6a488035 TO |
222 | </field> |
223 | <field> | |
5435b737 | 224 | <name>open_tracking</name> |
32ac94e8 | 225 | <title>Track Mailing?</title> |
5435b737 EM |
226 | <type>boolean</type> |
227 | <comment>Should we track when recipients open/read this mailing?</comment> | |
6a488035 TO |
228 | </field> |
229 | <field> | |
5435b737 | 230 | <name>is_completed</name> |
32ac94e8 | 231 | <title>Mailing Completed</title> |
5435b737 EM |
232 | <type>boolean</type> |
233 | <comment>Has at least one job associated with this mailing finished?</comment> | |
234 | <html> | |
235 | <type>CheckBox</type> | |
236 | </html> | |
6a488035 TO |
237 | </field> |
238 | <field> | |
5435b737 | 239 | <name>msg_template_id</name> |
32ac94e8 | 240 | <title>Mailing Message Template</title> |
5435b737 EM |
241 | <type>int unsigned</type> |
242 | <comment>FK to the message template.</comment> | |
6a488035 TO |
243 | </field> |
244 | <foreignKey> | |
5435b737 EM |
245 | <name>msg_template_id</name> |
246 | <table>civicrm_msg_template</table> | |
247 | <key>id</key> | |
248 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
249 | </foreignKey> |
250 | <field> | |
5435b737 EM |
251 | <name>override_verp</name> |
252 | <type>boolean</type> | |
253 | <default>0</default> | |
254 | <add>2.2</add> | |
255 | <comment>Should we overrite VERP address in Reply-To</comment> | |
256 | <html> | |
257 | <type>CheckBox</type> | |
258 | </html> | |
6a488035 TO |
259 | </field> |
260 | <field> | |
5435b737 | 261 | <name>created_id</name> |
32ac94e8 | 262 | <title>Mailing Creator</title> |
5435b737 EM |
263 | <type>int unsigned</type> |
264 | <comment>FK to Contact ID who first created this mailing</comment> | |
6a488035 TO |
265 | </field> |
266 | <foreignKey> | |
5435b737 EM |
267 | <name>created_id</name> |
268 | <table>civicrm_contact</table> | |
269 | <key>id</key> | |
270 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
271 | </foreignKey> |
272 | <field> | |
5435b737 | 273 | <name>created_date</name> |
4387c66f | 274 | <type>timestamp</type> |
e7a6eae8 | 275 | <default>NULL</default> |
4387c66f | 276 | <required>false</required> |
5435b737 EM |
277 | <title>Mailing Created Date</title> |
278 | <comment>Date and time this mailing was created.</comment> | |
279 | <add>3.0</add> | |
280 | <html> | |
281 | <type>Select Date</type> | |
4387c66f | 282 | <formatType>activityDateTime</formatType> |
5435b737 | 283 | </html> |
6a488035 | 284 | </field> |
e7a6eae8 SL |
285 | <field> |
286 | <name>modified_date</name> | |
287 | <uniqueName>mailing_modified_date</uniqueName> | |
288 | <type>timestamp</type> | |
289 | <comment>When the mailing (or closely related entity) was created or modified or deleted.</comment> | |
290 | <required>false</required> | |
291 | <export>true</export> | |
292 | <default>CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP</default> | |
293 | <add>4.7</add> | |
294 | </field> | |
6a488035 | 295 | <field> |
5435b737 | 296 | <name>scheduled_id</name> |
32ac94e8 | 297 | <title>Scheduled By</title> |
5435b737 EM |
298 | <type>int unsigned</type> |
299 | <comment>FK to Contact ID who scheduled this mailing</comment> | |
6a488035 TO |
300 | </field> |
301 | <foreignKey> | |
5435b737 EM |
302 | <name>scheduled_id</name> |
303 | <table>civicrm_contact</table> | |
304 | <key>id</key> | |
305 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
306 | </foreignKey> |
307 | <field> | |
5435b737 | 308 | <name>scheduled_date</name> |
4387c66f | 309 | <type>timestamp</type> |
310 | <default>NULL</default> | |
311 | <required>false</required> | |
5435b737 EM |
312 | <title>Mailing Scheduled Date</title> |
313 | <comment>Date and time this mailing was scheduled.</comment> | |
314 | <add>3.3</add> | |
4387c66f | 315 | <html> |
316 | <type>Select Date</type> | |
317 | <formatType>activityDateTime</formatType> | |
318 | </html> | |
6a488035 TO |
319 | </field> |
320 | <field> | |
5435b737 | 321 | <name>approver_id</name> |
32ac94e8 | 322 | <title>Approved By</title> |
5435b737 EM |
323 | <type>int unsigned</type> |
324 | <comment>FK to Contact ID who approved this mailing</comment> | |
6a488035 TO |
325 | </field> |
326 | <foreignKey> | |
5435b737 EM |
327 | <name>approver_id</name> |
328 | <table>civicrm_contact</table> | |
329 | <key>id</key> | |
330 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
331 | </foreignKey> |
332 | <field> | |
5435b737 | 333 | <name>approval_date</name> |
4387c66f | 334 | <type>timestamp</type> |
335 | <default>NULL</default> | |
336 | <required>false</required> | |
5435b737 EM |
337 | <title>Mailing Approved Date</title> |
338 | <comment>Date and time this mailing was approved.</comment> | |
339 | <add>3.3</add> | |
4387c66f | 340 | <html> |
341 | <type>Select Date</type> | |
342 | <formatType>activityDateTime</formatType> | |
343 | </html> | |
5435b737 EM |
344 | </field> |
345 | <field> | |
346 | <name>approval_status_id</name> | |
347 | <type>int unsigned</type> | |
348 | <title>Approval Status</title> | |
349 | <comment>The status of this mailing. Values: none, approved, rejected</comment> | |
350 | <pseudoconstant> | |
351 | <optionGroupName>mail_approval_status</optionGroupName> | |
352 | </pseudoconstant> | |
353 | <html> | |
354 | <type>Select</type> | |
355 | </html> | |
356 | <add>3.3</add> | |
357 | </field> | |
358 | <field> | |
359 | <name>approval_note</name> | |
360 | <type>longtext</type> | |
361 | <title>Approval Note</title> | |
362 | <comment>Note behind the decision.</comment> | |
363 | <add>3.3</add> | |
364 | <html> | |
365 | <type>TextArea</type> | |
366 | </html> | |
367 | </field> | |
368 | <field> | |
369 | <name>is_archived</name> | |
370 | <type>boolean</type> | |
56b7523d | 371 | <title>Is Mailing Archived?</title> |
5435b737 EM |
372 | <default>0</default> |
373 | <comment>Is this mailing archived?</comment> | |
374 | <html> | |
375 | <type>CheckBox</type> | |
376 | </html> | |
377 | <add>2.2</add> | |
378 | </field> | |
379 | <field> | |
380 | <name>visibility</name> | |
381 | <type>varchar</type> | |
56b7523d | 382 | <title>Mailing Visibility</title> |
5435b737 EM |
383 | <length>40</length> |
384 | <default>'Public Pages'</default> | |
385 | <comment>In what context(s) is the mailing contents visible (online viewing)</comment> | |
386 | <pseudoconstant> | |
387 | <callback>CRM_Core_SelectValues::groupVisibility</callback> | |
388 | </pseudoconstant> | |
389 | <add>3.3</add> | |
390 | <html> | |
391 | <type>Select</type> | |
392 | </html> | |
393 | </field> | |
394 | <field> | |
395 | <name>campaign_id</name> | |
396 | <type>int unsigned</type> | |
56b7523d | 397 | <title>Mailing Campaign</title> |
5435b737 EM |
398 | <comment>The campaign for which this mailing has been initiated.</comment> |
399 | <pseudoconstant> | |
400 | <table>civicrm_campaign</table> | |
401 | <keyColumn>id</keyColumn> | |
402 | <labelColumn>title</labelColumn> | |
403 | </pseudoconstant> | |
404 | <add>3.4</add> | |
405 | <html> | |
406 | <type>Select</type> | |
407 | </html> | |
3c7d2158 | 408 | </field> |
409 | <foreignKey> | |
5435b737 EM |
410 | <name>campaign_id</name> |
411 | <table>civicrm_campaign</table> | |
412 | <key>id</key> | |
413 | <onDelete>SET NULL</onDelete> | |
6a488035 TO |
414 | </foreignKey> |
415 | <field> | |
5435b737 EM |
416 | <name>dedupe_email</name> |
417 | <type>boolean</type> | |
56b7523d | 418 | <title>No Duplicate emails?</title> |
5435b737 EM |
419 | <default>0</default> |
420 | <add>4.1</add> | |
421 | <comment>Remove duplicate emails?</comment> | |
422 | <html> | |
423 | <type>CheckBox</type> | |
424 | </html> | |
6a488035 | 425 | </field> |
3c7d2158 | 426 | <field> |
5435b737 | 427 | <name>sms_provider_id</name> |
0d94665e | 428 | <title>Mailing SMS Provider</title> |
5435b737 EM |
429 | <type>int unsigned</type> |
430 | <add>4.2</add> | |
431 | <html> | |
432 | <type>Select</type> | |
433 | </html> | |
3c7d2158 | 434 | </field> |
435 | <foreignKey> | |
5435b737 EM |
436 | <name>sms_provider_id</name> |
437 | <table>civicrm_sms_provider</table> | |
438 | <key>id</key> | |
439 | <onDelete>SET NULL</onDelete> | |
440 | <add>4.2</add> | |
6a488035 | 441 | </foreignKey> |
c57f36a1 | 442 | <field> |
5435b737 EM |
443 | <name>hash</name> |
444 | <title>Mailing Hash</title> | |
445 | <type>varchar</type> | |
446 | <length>16</length> | |
447 | <comment>Key for validating requests related to this mailing.</comment> | |
448 | <add>4.5</add> | |
c57f36a1 PJ |
449 | </field> |
450 | <index> | |
5435b737 EM |
451 | <name>index_hash</name> |
452 | <fieldName>hash</fieldName> | |
453 | <add>4.5</add> | |
c57f36a1 | 454 | </index> |
bac4cd35 | 455 | <field> |
456 | <name>location_type_id</name> | |
457 | <title>Location Type</title> | |
458 | <type>int unsigned</type> | |
bac4cd35 | 459 | <comment>With email_selection_method, determines which email address to use</comment> |
78301a79 TO |
460 | <pseudoconstant> |
461 | <table>civicrm_location_type</table> | |
462 | <keyColumn>id</keyColumn> | |
463 | <labelColumn>display_name</labelColumn> | |
464 | </pseudoconstant> | |
64dfb8df | 465 | <add>4.6</add> |
bac4cd35 | 466 | </field> |
befed893 CDU |
467 | <foreignKey> |
468 | <name>location_type_id</name> | |
469 | <table>civicrm_location_type</table> | |
470 | <key>id</key> | |
471 | <onDelete>SET NULL</onDelete> | |
472 | <add>4.6</add> | |
473 | </foreignKey> | |
f96a4094 | 474 | <field> |
bac4cd35 | 475 | <name>email_selection_method</name> |
476 | <type>varchar</type> | |
477 | <length>20</length> | |
478 | <default>'automatic'</default> | |
479 | <comment>With location_type_id, determine how to choose the email address to use.</comment> | |
78301a79 TO |
480 | <pseudoconstant> |
481 | <callback>CRM_Core_SelectValues::emailSelectMethods</callback> | |
482 | </pseudoconstant> | |
64dfb8df | 483 | <add>4.6</add> |
bac4cd35 | 484 | </field> |
c00b95ef ML |
485 | <field> |
486 | <name>language</name> | |
487 | <title>Mailing Language</title> | |
488 | <type>varchar</type> | |
489 | <length>5</length> | |
490 | <comment>Language of the content of the mailing. Useful for tokens.</comment> | |
491 | <add>4.6</add> | |
492 | <pseudoconstant> | |
493 | <optionGroupName>languages</optionGroupName> | |
494 | <keyColumn>name</keyColumn> | |
495 | </pseudoconstant> | |
496 | <html> | |
497 | <type>Select</type> | |
498 | </html> | |
499 | </field> | |
c2b4755a | 500 | </table> |