public function EmailWebformHandler::buildConfigurationForm in Webform 6.x

Same name and namespace in other branches

1. 8.5 src/Plugin/WebformHandler/EmailWebformHandler.php \Drupal\webform\Plugin\WebformHandler\EmailWebformHandler::buildConfigurationForm()

Form constructor.

Plugin forms are embedded in other forms. In order to know where the plugin form is located in the parent form, #parents and #array_parents must be known, but these are not available during the initial build phase. In order to have these properties available when building the plugin form's elements, let this method return a form element that has a #process callback and build the rest of the form in the callback. By the time the callback is executed, the element's #parents and #array_parents properties will have been set by the form API. For more documentation on #parents and #array_parents, see \Drupal\Core\Render\Element\FormElement.

Parameters

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

\Drupal\Core\Form\FormStateInterface $form_state: The current state of the form. Calling code should pass on a subform state created through \Drupal\Core\Form\SubformState::createForSubform().

Return value

array The form structure.

Overrides WebformHandlerBase::buildConfigurationForm

1 call to EmailWebformHandler::buildConfigurationForm()

ScheduleEmailWebformHandler::buildConfigurationForm in modules/webform_scheduled_email/src/Plugin/WebformHandler/ScheduleEmailWebformHandler.php

Form constructor.

1 method overrides EmailWebformHandler::buildConfigurationForm()

ScheduleEmailWebformHandler::buildConfigurationForm in modules/webform_scheduled_email/src/Plugin/WebformHandler/ScheduleEmailWebformHandler.php

Form constructor.

File

src/Plugin/WebformHandler/EmailWebformHandler.php, line 289

Class

EmailWebformHandler

Emails a webform submission.

Namespace

Drupal\webform\Plugin\WebformHandler

Code

public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
  $this
    ->applyFormStateToConfiguration($form_state);

  // Get options, mail, and text elements as options (text/value).
  $text_element_options_value = [];
  $text_element_options_raw = [];
  $name_element_options = [];
  $mail_element_options = [];
  $options_element_options = [];
  $elements = $this->webform
    ->getElementsInitializedAndFlattened();
  foreach ($elements as $element_key => $element) {
    $element_plugin = $this->elementManager
      ->getElementInstance($element);
    if (!$element_plugin
      ->isInput($element) || !isset($element['#type'])) {
      continue;
    }

    // Set title.
    $element_title = isset($element['#title']) ? new FormattableMarkup('@title (@key)', [
      '@title' => $element['#title'],
      '@key' => $element_key,
    ]) : $element_key;

    // Add options element token, which can include multiple values.
    if (isset($element['#options'])) {
      $options_element_options["[webform_submission:values:{$element_key}:raw]"] = $element_title;
    }

    // Multiple value elements can NOT be used as a tokens.
    if ($element_plugin
      ->hasMultipleValues($element)) {
      continue;
    }
    if (!$element_plugin
      ->isComposite()) {

      // Add text element value and raw tokens.
      $text_element_options_value["[webform_submission:values:{$element_key}:value]"] = $element_title;
      $text_element_options_raw["[webform_submission:values:{$element_key}:raw]"] = $element_title;

      // Add name element token.
      $name_element_options["[webform_submission:values:{$element_key}:raw]"] = $element_title;

      // Add mail element token.
      if (in_array($element['#type'], [
        'email',
        'hidden',
        'value',
        'textfield',
        'webform_email_multiple',
        'webform_email_confirm',
      ])) {
        $mail_element_options["[webform_submission:values:{$element_key}:raw]"] = $element_title;
      }
    }

    // Element type specific tokens.
    switch ($element['#type']) {
      case 'webform_name':

        // Allow 'webform_name' composite to be used a value token.
        $name_element_options["[webform_submission:values:{$element_key}:value]"] = $element_title;
        break;
      case 'text_format':

        // Allow 'text_format' composite to be used a value token.
        $text_element_options_value["[webform_submission:values:{$element_key}]"] = $element_title;
        break;
    }

    // Handle composite sub elements.
    if ($element_plugin instanceof WebformCompositeBase) {
      $composite_elements = $element_plugin
        ->getCompositeElements();
      foreach ($composite_elements as $composite_key => $composite_element) {
        $composite_element_plugin = $this->elementManager
          ->getElementInstance($element);
        if (!$composite_element_plugin
          ->isInput($element) || !isset($composite_element['#type'])) {
          continue;
        }

        // Set composite title.
        if (isset($element['#title'])) {
          $f_args = [
            '@title' => $element['#title'],
            '@composite_title' => $composite_element['#title'],
            '@key' => $element_key,
            '@composite_key' => $composite_key,
          ];
          $composite_title = new FormattableMarkup('@title: @composite_title (@key: @composite_key)', $f_args);
        }
        else {
          $composite_title = "{$element_key}:{$composite_key}";
        }

        // Add name element token. Only applies to basic (not composite) elements.
        $name_element_options["[webform_submission:values:{$element_key}:{$composite_key}:raw]"] = $composite_title;

        // Add mail element token.
        if (in_array($composite_element['#type'], [
          'email',
          'webform_email_multiple',
          'webform_email_confirm',
        ])) {
          $mail_element_options["[webform_submission:values:{$element_key}:{$composite_key}:raw]"] = $composite_title;
        }
      }
    }
  }

  // Get roles.
  $roles_element_options = [];
  if ($roles = $this->configFactory
    ->get('webform.settings')
    ->get('mail.roles')) {
    $role_names = array_map('\\Drupal\\Component\\Utility\\Html::escape', user_role_names(TRUE));
    if (!in_array('authenticated', $roles)) {
      $role_names = array_intersect_key($role_names, array_combine($roles, $roles));
    }
    foreach ($role_names as $role_name => $role_label) {
      $roles_element_options["[webform_role:{$role_name}]"] = new FormattableMarkup('@title (@key)', [
        '@title' => $role_label,
        '@key' => $role_name,
      ]);
    }
  }

  // Get email and name other.
  $other_element_email_options = [
    '[site:mail]' => 'Site email address',
    '[current-user:mail]' => 'Current user email address [Authenticated only]',
    '[webform:author:mail]' => 'Webform author email address',
    '[webform_submission:user:mail]' => 'Webform submission owner email address [Authenticated only]',
  ];
  $other_element_name_options = [
    '[site:name]' => 'Site name',
    '[current-user:display-name]' => 'Current user display name',
    '[current-user:account-name]' => 'Current user account name',
    '[webform:author:display-name]' => 'Webform author display name',
    '[webform:author:account-name]' => 'Webform author account name',
    '[webform_submission:author:display-name]' => 'Webform submission author display name',
    '[webform_submission:author:account-name]' => 'Webform submission author account name',
  ];

  // Disable client-side HTML5 validation which is having issues with hidden
  // element validation.
  // @see http://stackoverflow.com/questions/22148080/an-invalid-form-control-with-name-is-not-focusable
  $form['#attributes']['novalidate'] = 'novalidate';

  // To.
  $form['to'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Send to'),
    '#help' => $this
      ->t('This is the "To:" email header which will be the person(s) responsible for receiving this webform.'),
    '#open' => TRUE,
  ];
  $form['to']['to_mail'] = $this
    ->buildElement('to_mail', $this
    ->t('To email'), $this
    ->t('To email address'), TRUE, $mail_element_options, $options_element_options, $roles_element_options, $other_element_email_options);
  $form['to']['cc_mail'] = $this
    ->buildElement('cc_mail', $this
    ->t('CC email'), $this
    ->t('CC email address'), FALSE, $mail_element_options, $options_element_options, $roles_element_options, $other_element_email_options);
  $form['to']['bcc_mail'] = $this
    ->buildElement('bcc_mail', $this
    ->t('BCC email'), $this
    ->t('BCC email address'), FALSE, $mail_element_options, $options_element_options, $roles_element_options, $other_element_email_options);
  $token_types = [
    'webform',
    'webform_submission',
  ];

  // Show webform role tokens if they have been specified.
  if (!empty($roles_element_options)) {
    $token_types[] = 'webform_role';
  }
  if ($this->moduleHandler
    ->moduleExists('webform_access')) {
    $token_types[] = 'webform_access';
  }
  if ($this->moduleHandler
    ->moduleExists('webform_group')) {
    $token_types[] = 'webform_group';
  }
  $form['to']['token_tree_link'] = $this
    ->buildTokenTreeElement($token_types);
  if (empty($roles_element_options) && $this->currentUser
    ->hasPermission('administer webform')) {
    $route_name = 'webform.config.handlers';
    $route_destination = Url::fromRoute('entity.webform.handlers', [
      'webform' => $this
        ->getWebform()
        ->id(),
    ])
      ->toString();
    $route_options = [
      'query' => [
        'destination' => $route_destination,
      ],
    ];
    $t_args = [
      ':href' => Url::fromRoute($route_name, [], $route_options)
        ->toString(),
    ];
    $form['to']['roles_message'] = [
      '#type' => 'webform_message',
      '#message_type' => 'warning',
      '#message_message' => $this
        ->t('Please note: You can select which <strong>user roles</strong> are available to receive webform emails by going to the Webform module\'s <a href=":href">admin settings</a> form.', $t_args),
      '#message_close' => TRUE,
      '#message_id' => 'webform_email_roles_message',
      '#message_storage' => WebformMessage::STORAGE_USER,
    ];
  }

  // From.
  $form['from'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Send from (website/domain)'),
    '#help' => $this
      ->t('This is the "From:" email header which should come from <em>you</em>.  It should be your brand, company, organization, or website entity.'),
    '#open' => TRUE,
  ];
  $form['from']['from_mail'] = $this
    ->buildElement('from_mail', $this
    ->t('From email'), $this
    ->t('From email address'), TRUE, $mail_element_options, $options_element_options, NULL, $other_element_email_options);
  $form['from']['from_name'] = $this
    ->buildElement('from_name', $this
    ->t('From name'), $this
    ->t('From name'), FALSE, $name_element_options, NULL, NULL, $other_element_name_options);
  $form['from']['token_tree_link'] = $this
    ->buildTokenTreeElement();

  // 'From name' is not used if it contains multiple email addresses.
  $form['from']['from_name']['from_name']['#states'] = [
    '!visible' => [
      ':input[name="settings[from_mail][other]"]' => [
        'value' => [
          'pattern' => ',',
        ],
      ],
    ],
  ];

  // Settings: Reply-to.
  $form['reply_to'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Reply to (individual/organization)'),
    '#help' => $this
      ->t('The "Reply-To:" email header is used for replying to the email that is received.  For example, if you collect a customers email, you would want to reply-to them. If you collect a lead generation form and want to reply to the coordinator, you would reply-to them.'),
    '#open' => TRUE,
  ];
  $form['reply_to']['reply_to'] = $this
    ->buildElement('reply_to', $this
    ->t('Reply-to email'), $this
    ->t('Reply-to email address'), FALSE, $mail_element_options, NULL, NULL, $other_element_email_options);
  $form['reply_to']['token_tree_link'] = $this
    ->buildTokenTreeElement($token_types);

  // Message.
  $form['message'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Message'),
    '#open' => TRUE,
  ];
  $form['message'] += $this
    ->buildElement('subject', $this
    ->t('Subject'), $this
    ->t('subject'), FALSE, $text_element_options_raw);
  $has_edit_twig_access = WebformTwigExtension::hasEditTwigAccess() || $this->configuration['twig'];

  // Message: Body.
  // Building a custom select other element that toggles between
  // HTML (CKEditor), Plain text (CodeMirror), and Twig (CodeMirror)
  // custom body elements.
  $body_options = [];
  $body_options[WebformSelectOther::OTHER_OPTION] = $this
    ->t('Custom body…');
  if ($has_edit_twig_access) {
    $body_options['twig'] = $this
      ->t('Twig template…');
  }
  $body_options[static::DEFAULT_VALUE] = $this
    ->t('Default');
  $body_options[(string) $this
    ->t('Elements')] = $text_element_options_value;

  // Get default format.
  $body_default_format = $this->configuration['html'] ? 'html' : 'text';

  // Get default values.
  $body_default_values = $this
    ->getBodyDefaultValues();

  // Get custom default values which are the same as default values.
  $body_custom_default_values = $this
    ->getBodyDefaultValues();

  // Set up default Twig body and convert tokens to use the
  // webform_token() Twig function.
  // @see \Drupal\webform\Twig\WebformTwigExtension
  $twig_default_body = $body_custom_default_values[$body_default_format];
  $twig_default_body = preg_replace('/(\\[[^]]+\\])/', '{{ webform_token(\'\\1\', webform_submission, [], options) }}', $twig_default_body);
  $body_custom_default_values['twig'] = $twig_default_body;

  // Look at the 'body' and determine the body select and custom
  // default values.
  if (WebformOptionsHelper::hasOption($this->configuration['body'], $body_options)) {
    $body_select_default_value = $this->configuration['body'];
  }
  elseif ($this->configuration['twig']) {
    $body_select_default_value = 'twig';
    $body_custom_default_values['twig'] = $this->configuration['body'];
  }
  else {
    $body_select_default_value = WebformSelectOther::OTHER_OPTION;
    $body_custom_default_values[$body_default_format] = $this->configuration['body'];
  }

  // Build body select menu.
  $form['message']['body'] = [
    '#type' => 'select',
    '#title' => $this
      ->t('Body'),
    '#options' => $body_options,
    '#required' => TRUE,
    '#default_value' => $body_select_default_value,
  ];
  foreach ($body_default_values as $format => $default_value) {
    if ($format === 'html') {
      $form['message']['body_custom_' . $format] = [
        '#type' => 'webform_html_editor',
        '#format' => $this->configFactory
          ->get('webform.settings')
          ->get('html_editor.mail_format'),
      ];
    }
    else {
      $form['message']['body_custom_' . $format] = [
        '#type' => 'webform_codemirror',
        '#mode' => $format,
      ];
    }
    $form['message']['body_custom_' . $format] += [
      '#title' => $this
        ->t('Body custom value (@format)', [
        '@format' => $format,
      ]),
      '#title_display' => 'hidden',
      '#default_value' => $body_custom_default_values[$format],
      '#states' => [
        'visible' => [
          ':input[name="settings[body]"]' => [
            'value' => WebformSelectOther::OTHER_OPTION,
          ],
          ':input[name="settings[html]"]' => [
            'checked' => $format === 'html' ? TRUE : FALSE,
          ],
        ],
        'required' => [
          ':input[name="settings[body]"]' => [
            'value' => WebformSelectOther::OTHER_OPTION,
          ],
          ':input[name="settings[html]"]' => [
            'checked' => $format === 'html' ? TRUE : FALSE,
          ],
        ],
      ],
    ];

    // Must set #parents because body_custom_* is not a configuration value.
    // @see \Drupal\webform\Plugin\WebformHandler\EmailWebformHandler::validateConfigurationForm
    $form['message']['body_custom_' . $format]['#parents'] = [
      'settings',
      'body_custom_' . $format,
    ];

    // Default body.
    $form['message']['body_default_' . $format] = [
      '#type' => 'webform_codemirror',
      '#mode' => $format,
      '#title' => $this
        ->t('Body default value (@format)', [
        '@format' => $format,
      ]),
      '#title_display' => 'hidden',
      '#default_value' => $body_default_values[$format],
      '#attributes' => [
        'readonly' => 'readonly',
        'disabled' => 'disabled',
      ],
      '#states' => [
        'visible' => [
          ':input[name="settings[body]"]' => [
            'value' => static::DEFAULT_VALUE,
          ],
          ':input[name="settings[html]"]' => [
            'checked' => $format === 'html' ? TRUE : FALSE,
          ],
        ],
      ],
    ];
  }

  // Twig body with help.
  $form['message']['body_custom_twig'] = [
    '#type' => 'webform_codemirror',
    '#mode' => 'twig',
    '#title' => $this
      ->t('Body custom value (Twig)'),
    '#title_display' => 'hidden',
    '#default_value' => $body_custom_default_values['twig'],
    '#access' => $has_edit_twig_access,
    '#states' => [
      'visible' => [
        ':input[name="settings[body]"]' => [
          'value' => 'twig',
        ],
      ],
      'required' => [
        ':input[name="settings[body]"]' => [
          'value' => 'twig',
        ],
      ],
    ],
    // Must set #parents because body_custom_twig is not a configuration value.
    // @see \Drupal\webform\Plugin\WebformHandler\EmailWebformHandler::validateConfigurationForm
    '#parents' => [
      'settings',
      'body_custom_twig',
    ],
  ];
  $form['message']['body_custom_twig_help'] = WebformTwigExtension::buildTwigHelp() + [
    '#access' => $has_edit_twig_access,
    '#states' => [
      'visible' => [
        ':input[name="settings[body]"]' => [
          'value' => 'twig',
        ],
      ],
    ],
  ];

  // Tokens.
  $form['message']['token_tree_link'] = $this
    ->buildTokenTreeElement();

  // Elements.
  $form['elements'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Included email values/markup'),
    '#description' => $this
      ->t('The selected elements will be included in the [webform_submission:values] token. Individual values may still be printed if explicitly specified as a [webform_submission:values:?] in the email body template.'),
    '#open' => $this->configuration['excluded_elements'] ? TRUE : FALSE,
  ];
  $form['elements']['excluded_elements'] = [
    '#type' => 'webform_excluded_elements',
    '#exclude_markup' => FALSE,
    '#webform_id' => $this->webform
      ->id(),
    '#default_value' => $this->configuration['excluded_elements'],
  ];
  $form['elements']['ignore_access'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Always include elements with private and restricted access'),
    '#description' => $this
      ->t('If checked, access controls for included element will be ignored.'),
    '#return_value' => TRUE,
    '#default_value' => $this->configuration['ignore_access'],
  ];
  $form['elements']['exclude_empty'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Exclude empty elements'),
    '#description' => $this
      ->t('If checked, empty elements will be excluded from the email values.'),
    '#return_value' => TRUE,
    '#default_value' => $this->configuration['exclude_empty'],
  ];
  $form['elements']['exclude_empty_checkbox'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Exclude unselected checkboxes'),
    '#description' => $this
      ->t('If checked, empty checkboxes will be excluded from the email values.'),
    '#return_value' => TRUE,
    '#default_value' => $this->configuration['exclude_empty_checkbox'],
  ];
  $form['elements']['exclude_attachments'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Exclude file elements with attachments'),
    '#return_value' => TRUE,
    '#description' => $this
      ->t('If checked, file attachments will be excluded from the email values, but the selected element files will still be attached to the email.'),
    '#default_value' => $this->configuration['exclude_attachments'],
    '#access' => $this
      ->getWebform()
      ->hasAttachments(),
    '#disabled' => !$this
      ->supportsAttachments(),
    '#states' => [
      'visible' => [
        ':input[name="settings[attachments]"]' => [
          'checked' => TRUE,
        ],
      ],
    ],
  ];
  $elements = $this->webform
    ->getElementsInitializedFlattenedAndHasValue();
  foreach ($elements as $element) {
    if (!empty($element['#access_view_roles']) || !empty($element['#private'])) {
      $form['elements']['ignore_access_message'] = [
        '#type' => 'webform_message',
        '#message_message' => $this
          ->t('This webform contains private and/or restricted access elements, which will only be included if the user submitting the form has access to these elements.'),
        '#message_type' => 'warning',
        '#states' => [
          'visible' => [
            ':input[name="settings[ignore_access]"]' => [
              'checked' => FALSE,
            ],
          ],
        ],
      ];
      break;
    }
  }

  // Attachments.
  $form['attachments'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Attachments'),
    '#access' => $this
      ->getWebform()
      ->hasAttachments(),
  ];
  if (!$this
    ->supportsAttachments()) {
    $t_args = [
      ':href_smtp' => 'https://www.drupal.org/project/smtp',
      ':href_mailsystem' => 'https://www.drupal.org/project/mailsystem',
      ':href_swiftmailer' => 'https://www.drupal.org/project/swiftmailer',
    ];
    $form['attachments']['attachments_message'] = [
      '#type' => 'webform_message',
      '#message_message' => $this
        ->t('To send email attachments, please install and configure the <a href=":href_smtp">SMTP Authentication Support</a> module or the <a href=":href_mailsystem">Mail System</a> and <a href=":href_swiftmailer">SwiftMailer</a> module.', $t_args),
      '#message_type' => 'warning',
      '#message_close' => TRUE,
      '#message_storage' => WebformMessage::STORAGE_SESSION,
    ];
  }
  $form['attachments']['attachments'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Include files as attachments'),
    '#description' => $this
      ->t('If checked, only file upload elements selected in the above included email values will be attached to the email.'),
    '#return_value' => TRUE,
    '#disabled' => !$this
      ->supportsAttachments(),
    '#default_value' => $this->configuration['attachments'],
  ];

  // Additional.
  $results_disabled = $this
    ->getWebform()
    ->getSetting('results_disabled');
  $form['additional'] = [
    '#type' => 'fieldset',
    '#title' => $this
      ->t('Additional settings'),
  ];

  // Settings: States.
  $form['additional']['states'] = [
    '#type' => 'checkboxes',
    '#title' => $this
      ->t('Send email'),
    '#options' => [
      WebformSubmissionInterface::STATE_DRAFT_CREATED => $this
        ->t('…when <b>draft is created</b>.'),
      WebformSubmissionInterface::STATE_DRAFT_UPDATED => $this
        ->t('…when <b>draft is updated</b>.'),
      WebformSubmissionInterface::STATE_CONVERTED => $this
        ->t('…when anonymous <b>submission is converted</b> to authenticated.'),
      WebformSubmissionInterface::STATE_COMPLETED => $this
        ->t('…when <b>submission is completed</b>.'),
      WebformSubmissionInterface::STATE_UPDATED => $this
        ->t('…when <b>submission is updated</b>.'),
      WebformSubmissionInterface::STATE_DELETED => $this
        ->t('…when <b>submission is deleted</b>.'),
      WebformSubmissionInterface::STATE_LOCKED => $this
        ->t('…when <b>submission is locked</b>.'),
    ],
    '#access' => $results_disabled ? FALSE : TRUE,
    '#default_value' => $results_disabled ? [
      WebformSubmissionInterface::STATE_COMPLETED,
    ] : $this->configuration['states'],
  ];
  $form['additional']['states_message'] = [
    '#type' => 'webform_message',
    '#message_message' => $this
      ->t("Because no submission state is checked, this email can only be sent using the 'Resend' form and/or custom code."),
    '#message_type' => 'warning',
    '#states' => [
      'visible' => [
        ':input[name^="settings[states]"]' => [
          'checked' => FALSE,
        ],
      ],
    ],
  ];

  // Settings: Return path.
  $form['additional']['return_path'] = $this
    ->buildElement('return_path', $this
    ->t('Return path'), $this
    ->t('Return path email address'), FALSE, $mail_element_options, NULL, NULL, $other_element_email_options);

  // Settings: Sender mail.
  $form['additional']['sender_mail'] = $this
    ->buildElement('sender_mail', $this
    ->t('Sender email'), $this
    ->t('Sender email address'), FALSE, $mail_element_options, $options_element_options, NULL, $other_element_email_options);

  // Settings: Sender name.
  $form['additional']['sender_name'] = $this
    ->buildElement('sender_name', $this
    ->t('Sender name'), $this
    ->t('Sender name'), FALSE, $name_element_options, NULL, NULL, $other_element_name_options);

  // Settings: HTML.
  $form['additional']['html'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Send email as HTML'),
    '#return_value' => TRUE,
    '#access' => $this
      ->supportsHtml(),
    '#default_value' => $this->configuration['html'],
  ];

  // Setting: Themes.
  $form['additional']['theme_name'] = [
    '#type' => 'select',
    '#title' => $this
      ->t('Theme to render this email'),
    '#description' => $this
      ->t('Select the theme that will be used to render this email.'),
    '#options' => $this->themeManager
      ->getThemeNames(),
    '#default_value' => $this->configuration['theme_name'],
  ];
  $form['additional']['parameters'] = [
    '#type' => 'webform_codemirror',
    '#mode' => 'yaml',
    '#title' => $this
      ->t('Custom parameters'),
    '#description' => $this
      ->t('Enter additional custom parameters to be appended to the email message\'s parameters. Custom parameters are used by <a href=":href">email related add-on modules</a>.', [
      ':href' => 'https://www.drupal.org/docs/8/modules/webform/webform-add-ons#mail',
    ]),
    '#default_value' => $this->configuration['parameters'],
  ];

  // Development.
  $form['development'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Development settings'),
  ];
  $form['development']['debug'] = [
    '#type' => 'checkbox',
    '#title' => $this
      ->t('Enable debugging'),
    '#description' => $this
      ->t('If checked, sent emails will be displayed onscreen to all users.'),
    '#return_value' => TRUE,
    '#default_value' => $this->configuration['debug'],
  ];

  // ISSUE: TranslatableMarkup is breaking the #ajax.
  // WORKAROUND: Convert all Render/Markup to strings.
  WebformElementHelper::convertRenderMarkupToStrings($form);
  $this
    ->elementTokenValidate($form, $token_types);
  return $this
    ->setSettingsParents($form);
}