public function MailSettingsForm::buildForm in Simplenews 8

Same name and namespace in other branches

1. 8.2 src/Form/MailSettingsForm.php \Drupal\simplenews\Form\MailSettingsForm::buildForm()
2. 3.x src/Form/MailSettingsForm.php \Drupal\simplenews\Form\MailSettingsForm::buildForm()

Form constructor.

Parameters

array $form: An associative array containing the structure of the form.

\Drupal\Core\Form\FormStateInterface $form_state: The current state of the form.

Return value

array The form structure.

Overrides ConfigFormBase::buildForm

File

src/Form/MailSettingsForm.php, line 31

Class

MailSettingsForm

Configure simplenews newsletter settings.

Namespace

Drupal\simplenews\Form

Code

public function buildForm(array $form, FormStateInterface $form_state) {
  $config = $this
    ->config('simplenews.settings');
  $form['simplenews_mail_backend']['simplenews_use_cron'] = array(
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Use cron to send newsletters'),
    '#default_value' => $config
      ->get('mail.use_cron'),
    '#description' => $this
      ->t('When checked cron will be used to send newsletters (recommended). Test newsletters and confirmation emails will be sent immediately. Leave unchecked for testing purposes.'),
  );
  $throttle_val = array(
    1,
    10,
    20,
    50,
    100,
    200,
    500,
    1000,
    2000,
    5000,
    10000,
    20000,
  );
  $throttle = array_combine($throttle_val, $throttle_val);
  $throttle[SpoolStorageInterface::UNLIMITED] = $this
    ->t('Unlimited');
  if (function_exists('getrusage')) {
    $description_extra = '<br />' . $this
      ->t('Cron execution must not exceed the PHP maximum execution time of %max seconds. You find the time spend to send emails in the <a href="/admin/reports/dblog">Recent log entries</a>.', array(
      '%max' => ini_get('max_execution_time'),
    ));
  }
  else {
    $description_extra = '<br />' . $this
      ->t('Cron execution must not exceed the PHP maximum execution time of %max seconds.', array(
      '%max' => ini_get('max_execution_time'),
    ));
  }
  $form['simplenews_mail_backend']['simplenews_throttle'] = array(
    '#type' => 'select',
    '#title' => $this
      ->t('Cron throttle'),
    '#options' => $throttle,
    '#default_value' => $config
      ->get('mail.throttle'),
    '#description' => $this
      ->t('Sets the numbers of newsletters sent per cron run. Failure to send will also be counted.') . $description_extra,
  );
  $form['simplenews_mail_backend']['simplenews_spool_expire'] = array(
    '#type' => 'select',
    '#title' => $this
      ->t('Mail spool expiration'),
    '#options' => array(
      0 => $this
        ->t('Immediate'),
      1 => \Drupal::translation()
        ->formatPlural(1, '1 day', '@count days'),
      7 => \Drupal::translation()
        ->formatPlural(1, '1 week', '@count weeks'),
      14 => \Drupal::translation()
        ->formatPlural(2, '1 week', '@count weeks'),
    ),
    '#default_value' => $config
      ->get('mail.spool_expire'),
    '#description' => $this
      ->t('Newsletter mails are spooled. How long must messages be retained in the spool after successful sending. Keeping the message in the spool allows mail statistics (which is not yet implemented). If cron is not used, immediate expiration is advised.'),
  );
  $form['simplenews_mail_backend']['simplenews_debug'] = array(
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Log emails'),
    '#default_value' => $config
      ->get('mail.debug'),
    '#description' => $this
      ->t('When checked all outgoing simplenews emails are logged in the system log. A logged email does not guarantee that it is send or will be delivered. It only indicates that a message is sent to the PHP mail() function. No status information is available of delivery by the PHP mail() function.'),
  );
  return parent::buildForm($form, $form_state);
}