Merge pull request #15732 from totten/master-tplaner-when
[civicrm-core.git] / settings / Mailing.setting.php
index e38584c89f3264af810b3102448dab3859a21d7a..925bfa5b781b0f8bf85f5db9517ab7eb1177b2db 100644 (file)
@@ -1,9 +1,9 @@
 <?php
 /*
  +--------------------------------------------------------------------+
- | CiviCRM version 4.7                                                |
+ | CiviCRM version 5                                                  |
  +--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2017                                |
+ | Copyright CiviCRM LLC (c) 2004-2019                                |
  +--------------------------------------------------------------------+
  | This file is a part of CiviCRM.                                    |
  |                                                                    |
@@ -28,7 +28,7 @@
 /**
  *
  * @package CRM
- * @copyright CiviCRM LLC (c) 2004-2017
+ * @copyright CiviCRM LLC (c) 2004-2019
  * $Id$
  *
  */
  * Settings metadata file
  */
 
-return array(
-  'profile_double_optin' => array(
+return [
+  'profile_double_optin' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'profile_double_optin',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => '1',
     'add' => '4.1',
-    'title' => 'Enable Double Opt-in for Profile Group(s) field',
+    'title' => ts('Enable Double Opt-in for Profile Group(s) field'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'When CiviMail is enabled, users who "subscribe" to a group from a profile Group(s) checkbox will receive a confirmation email. They must respond (opt-in) before they are added to the group.',
+    'description' => ts('When CiviMail is enabled, users who "subscribe" to a group from a profile Group(s) checkbox will receive a confirmation email. They must respond (opt-in) before they are added to the group.'),
     'help_text' => NULL,
-  ),
-  'track_civimail_replies' => array(
+  ],
+  'track_civimail_replies' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'track_civimail_replies',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => '0',
     'add' => '4.1',
-    'title' => 'Track replies using VERP in Reply-To header',
+    'title' => ts('Track replies using VERP in Reply-To header'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'If checked, mailings will default to tracking replies using VERP-ed Reply-To. ',
+    'description' => ts('If checked, mailings will default to tracking replies using VERP-ed Reply-To. '),
     'help_text' => NULL,
     'validate_callback' => 'CRM_Core_BAO_Setting::validateBoolSetting',
-  ),
-  'civimail_workflow' => array(
+  ],
+  'civimail_workflow' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'civimail_workflow',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => '0',
     'add' => '4.1',
-    'title' => 'Use CiviMail Workflow',
+    'title' => ts('Enable workflow support for CiviMail'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'When CiviMail is enabled, users who "subscribe" to a group from a profile Group(s) checkbox will receive a confirmation email. They must respond (opt-in) before they are added to the group.',
+    'description' => ts('Drupal-only. Rules module must be enabled (beta feature - use with caution).'),
     'help_text' => NULL,
-  ),
-  'civimail_server_wide_lock' => array(
+  ],
+  'civimail_server_wide_lock' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'civimail_server_wide_lock',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => '0',
     'add' => '4.1',
-    'title' => 'Lock Mails Server-Wide for Mail Sending',
+    'title' => ts('Enable global server wide lock for CiviMail'),
     'is_domain' => 1,
     'is_contact' => 0,
     'description' => NULL,
     'help_text' => NULL,
-  ),
-  'replyTo' => array(
+  ],
+  'replyTo' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'replyTo',
@@ -107,116 +107,116 @@ return array(
     'is_contact' => 0,
     'description' => 'Allow CiviMail users to send mailings with a custom Reply-To header',
     'help_text' => NULL,
-  ),
-  'mailing_backend' => array(
+  ],
+  'mailing_backend' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'mailing_backend',
     'type' => 'Array',
     'html_type' => 'checkbox',
-    'default' => array('outBound_option' => '3'),
+    'default' => ['outBound_option' => '3'],
     'add' => '4.1',
     'title' => 'Mailing Backend',
     'is_domain' => 1,
     'is_contact' => 0,
     'description' => NULL,
     'help_text' => NULL,
-  ),
-  'profile_add_to_group_double_optin' => array(
+  ],
+  'profile_add_to_group_double_optin' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'profile_add_to_group_double_optin',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => '0',
     'add' => '4.1',
-    'title' => 'Enable Double Opt-in for Profile Group(s) field',
+    'title' => ts('Enable Double Opt-in for Profiles which use the "Add to Group" setting'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'When CiviMail is enabled, users who "subscribe" to a group from a profile Group(s) checkbox will receive a confirmation email. They must respond (opt-in) before they are added to the group.',
+    'description' => ts('When CiviMail is enabled and a profile uses the "Add to Group" setting, users who complete the profile form will receive a confirmation email. They must respond (opt-in) before they are added to the group.'),
     'help_text' => NULL,
-  ),
-  'disable_mandatory_tokens_check' => array(
+  ],
+  'disable_mandatory_tokens_check' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'disable_mandatory_tokens_check',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => 0,
     'add' => '4.4',
-    'title' => 'Disable check for mandatory tokens',
+    'title' => ts('Disable check for mandatory tokens'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'Don\'t check for presence of mandatory tokens (domain address; unsubscribe/opt-out) before sending mailings. WARNING: Mandatory tokens are a safe-guard which facilitate compliance with the US CAN-SPAM Act. They should only be disabled if your organization adopts other mechanisms for compliance or if your organization is not subject to CAN-SPAM.',
+    'description' => ts('Don\'t check for presence of mandatory tokens (domain address; unsubscribe/opt-out) before sending mailings. WARNING: Mandatory tokens are a safe-guard which facilitate compliance with the US CAN-SPAM Act. They should only be disabled if your organization adopts other mechanisms for compliance or if your organization is not subject to CAN-SPAM.'),
     'help_text' => NULL,
-  ),
-  'dedupe_email_default' => array(
+  ],
+  'dedupe_email_default' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'dedupe_email_default',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => 1,
     'add' => '4.5',
-    'title' => 'CiviMail dedupes e-mail addresses by default',
+    'title' => ts('CiviMail dedupes e-mail addresses by default'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'Set the "dedupe e-mail" option when sending a new mailing to "true" by default.',
+    'description' => ts('Set the "dedupe e-mail" option when sending a new mailing to "true" by default.'),
     'help_text' => NULL,
-  ),
-  'hash_mailing_url' => array(
+  ],
+  'hash_mailing_url' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'hash_mailing_url',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => 0,
     'add' => '4.5',
-    'title' => 'Hashed Mailing URL\'s',
+    'title' => ts('Hashed Mailing URL\'s'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'If enabled, a randomized hash key will be used to reference the mailing URL in the mailing.viewUrl token, instead of the mailing ID',
+    'description' => ts('If enabled, a randomized hash key will be used to reference the mailing URL in the mailing.viewUrl token, instead of the mailing ID'),
     'help_text' => NULL,
-  ),
-  'civimail_multiple_bulk_emails' => array(
+  ],
+  'civimail_multiple_bulk_emails' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'civimail_multiple_bulk_emails',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => 0,
     'add' => '4.5',
-    'title' => ' Multiple Bulk Emails',
+    'title' => ts('Enable multiple bulk email address for a contact.'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'If enabled, CiviMail will deliver a copy of the email to each bulk email listed for the contact.',
+    'description' => ts('CiviMail will deliver a copy of the email to each bulk email listed for the contact. Enabling this setting will also change the options for the "Email on Hold" field in Advanced Search.'),
     'help_text' => NULL,
-  ),
-  'include_message_id' => array(
+  ],
+  'include_message_id' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'include_message_id',
-    'type' => 'Integer',
+    'type' => 'Boolean',
     'html_type' => 'checkbox',
     'default' => FALSE,
     'add' => '4.5',
-    'title' => 'Enable CiviMail to generate Message-ID header',
+    'title' => ts('Enable CiviMail to generate Message-ID header'),
     'is_domain' => 1,
     'is_contact' => 0,
     'description' => '',
     'help_text' => NULL,
-  ),
-  'mailerBatchLimit' => array(
+  ],
+  'mailerBatchLimit' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'mailerBatchLimit',
     'type' => 'Integer',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 8,
-    ),
+    ],
     'default' => 0,
     'add' => '4.7',
     'title' => 'Mailer Batch Limit',
@@ -224,18 +224,18 @@ return array(
     'is_contact' => 0,
     'description' => 'Throttle email delivery by setting the maximum number of emails sent during each CiviMail run (0 = unlimited).',
     'help_text' => NULL,
-  ),
-  'mailerJobSize' => array(
+  ],
+  'mailerJobSize' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'mailerJobSize',
     'type' => 'Integer',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 8,
-    ),
+    ],
     'default' => 0,
     'add' => '4.7',
     'title' => 'Mailer Job Size',
@@ -243,18 +243,18 @@ return array(
     'is_contact' => 0,
     'description' => 'If you want to utilize multi-threading enter the size you want your sub jobs to be split into. Recommended values are between 1,000 and 10,000. Use a lower value if your server has multiple cron jobs running simultaneously, but do not use values smaller than 1,000. Enter "0" to disable multi-threading and process mail as one single job - batch limits still apply.',
     'help_text' => NULL,
-  ),
-  'mailerJobsMax' => array(
+  ],
+  'mailerJobsMax' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'mailerJobsMax',
     'type' => 'Integer',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 8,
-    ),
+    ],
     'default' => 0,
     'add' => '4.7',
     'title' => 'Mailer Cron Job Limit',
@@ -262,18 +262,18 @@ return array(
     'is_contact' => 0,
     'description' => 'The maximum number of mailer delivery jobs executing simultaneously (0 = allow as many processes to execute as started by cron)',
     'help_text' => NULL,
-  ),
-  'mailThrottleTime' => array(
+  ],
+  'mailThrottleTime' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'mailThrottleTime',
     'type' => 'Integer',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 8,
-    ),
+    ],
     'default' => 0,
     'add' => '4.7',
     'title' => 'Mailer Throttle Time',
@@ -281,18 +281,18 @@ return array(
     'is_contact' => 0,
     'description' => 'The time to sleep in between each e-mail in micro seconds. Setting this above 0 allows you to control the rate at which e-mail messages are sent to the mail server, avoiding filling up the mail queue very quickly. Set to 0 to disable.',
     'help_text' => NULL,
-  ),
-  'verpSeparator' => array(
+  ],
+  'verpSeparator' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'verpSeparator',
     'type' => 'String',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 32,
-    ),
+    ],
     'default' => '.',
     'add' => '4.7',
     'title' => 'VERP Separator',
@@ -300,53 +300,55 @@ return array(
     'is_contact' => 0,
     'description' => 'Separator character used when CiviMail generates VERP (variable envelope return path) Mail-From addresses.',
     'help_text' => NULL,
-  ),
-  'write_activity_record' => array(
+  ],
+  'write_activity_record' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'write_activity_record',
     'type' => 'Boolean',
-    'quick_form_type' => 'YesNo',
+    'html_type' => 'checkbox',
+    'quick_form_type' => 'CheckBox',
     'default' => '1',
     'add' => '4.7',
-    'title' => 'Enable CiviMail to create activities on delivery',
+    'title' => ts('Enable CiviMail to create activities on delivery'),
     'is_domain' => 1,
     'is_contact' => 0,
     'description' => NULL,
     'help_text' => NULL,
-  ),
-  'simple_mail_limit' => array(
+  ],
+  'simple_mail_limit' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'simple_mail_limit',
     'type' => 'Integer',
     'quick_form_type' => 'Element',
     'html_type' => 'text',
-    'html_attributes' => array(
+    'html_attributes' => [
       'size' => 4,
       'maxlength' => 8,
-    ),
+    ],
     'default' => 50,
     'title' => 'Simple mail limit',
     'is_domain' => 1,
     'is_contact' => 0,
     'description' => 'The number of emails sendable via simple mail. Make sure you understand the implications for your spam reputation and legal requirements for bulk emails before editing. As there is some risk both to your spam reputation and the products if this is misused it is a hidden setting',
     'help_text' => 'CiviCRM forces users sending more than this number of mails to use CiviMails. CiviMails have additional precautions: not sending to contacts who do not want bulk mail, adding domain name and opt out links. You should familiarise yourself with the law relevant to you on bulk mailings if changing this setting. For the US https://en.wikipedia.org/wiki/CAN-SPAM_Act_of_2003 is a good place to start.',
-  ),
-  'auto_recipient_rebuild' => array(
+  ],
+  'auto_recipient_rebuild' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'auto_recipient_rebuild',
     'type' => 'Boolean',
-    'quick_form_type' => 'YesNo',
+    'html_type' => 'checkbox',
+    'quick_form_type' => 'CheckBox',
     'default' => '1',
-    'title' => 'Enable automatic CiviMail recipient count display',
+    'title' => ts('Enable automatic CiviMail recipient count display'),
     'is_domain' => 1,
     'is_contact' => 0,
-    'description' => 'Enable this setting to rebuild recipient list automatically during composing mail. Disable will allow you to rebuild recipient manually.',
-    'help_text' => 'CiviMail automatically fetches recipient list and count whenever mailing groups are included or excluded while composing bulk mail. This phenomena may degrade performance for large sites, so disable this setting to build and fetch recipients for selected groups, manually.',
-  ),
-  'allow_mail_from_logged_in_contact' => array(
+    'description' => ts('Enable this setting to rebuild recipient list automatically during composing mail. Disable will allow you to rebuild recipient manually.'),
+    'help_text' => ts('CiviMail automatically fetches recipient list and count whenever mailing groups are included or excluded while composing bulk mail. This phenomena may degrade performance for large sites, so disable this setting to build and fetch recipients for selected groups, manually.'),
+  ],
+  'allow_mail_from_logged_in_contact' => [
     'group_name' => 'Mailing Preferences',
     'group' => 'mailing',
     'name' => 'allow_mail_from_logged_in_contact',
@@ -358,5 +360,5 @@ return array(
     'is_contact' => 0,
     'description' => 'Allow sending email from the logged in contact\'s email address',
     'help_text' => 'CiviCRM allows you to send email from the domain from email addresses and the logged in contact id addresses by default. Disable this if you only want to allow the domain from addresses to be used.',
-  ),
-);
+  ],
+];