public function SettingsForm::buildForm in Block Blacklist [Deprecated] 8

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/SettingsForm.php, line 57

Class

SettingsForm

Class BlockBlacklistSettings.

Namespace

Drupal\block_blacklist\Form

Code

public function buildForm(array $form, FormStateInterface $form_state) {
  $description[] = $this
    ->t("Drupal provides an extensive list of blocks, " . "many of which you may never use anywhere, and others you won't use " . "in Layout Builder. Improve UX and system performance by removing " . "blocks that won't be used on this site. Removing blocks from the " . "system list will have the most performance benefits, but blocks " . "removed using the 'System' settings will no longer appear anywhere " . "in Drupal, neither in the block configuration for each theme, nor in " . "the Layout Builder block list, so you must carefully check that you " . "really don't need those blocks. Blocks removed using the 'Layout " . "Builder' settings will have less performance impact, but be removed " . "only from Layout Builder listings.")
    ->__toString();
  $description[] = $this
    ->t("See a list of all blocks in the <a href=':url'> " . "'System' block ID list</a> and the <a href=':url2'> 'Layout " . "Builder' block ID list</a> to help you adjust these settings. These " . "lists will display the blocks that remain after blacklisted blocks " . "have been removed. Use the lists to identity block IDs " . "and figure out which patterns and items you want to remove. The lists " . "will be impacted by the settings below, so you can keep checking " . "them as you update your settings to see that you have gotten the " . "results you intended.", [
    ":url" => "/admin/config/block_blacklist/system-list",
    ":url2" => "/admin/config/block_blacklist/layout-list",
  ])
    ->__toString();
  $description[] = '<strong> ' . $this
    ->t("Use this feature with care! " . "If you remove any blocks currently in use, you will see messages about " . "non-existant blocks in places where the blocks should appear.")
    ->__toString() . '</strong>';
  $description[] = $this
    ->t("List each name or value on a new line in the " . "appropriate section below. You have the option to identify blocks to " . "be removed by name or prefix, or provide a regex for more complex " . "matching options.")
    ->__toString();
  $items = [];
  $items[] = $this
    ->t("Block ids listed in the 'Match' list will be " . "removed by looking for an exact match for that id.")
    ->__toString();
  $items[] = $this
    ->t("Use the 'Prefix' list to remove all blocks that " . "have a specific prefix followed by a colon. For example, identifying " . "the prefix 'field_block:user' would remove block IDs like 'field_" . "block:user:user:uid' and 'field_block:user:user:langcode'.")
    ->__toString();
  $items[] = $this
    ->t("The regex list is a place to provide regex strings " . "that will be used to determine which blocks to remove. A regex like " . "'/field_block:node:(.*):nid/' would remove the nid field block for " . "all content types.")
    ->__toString();
  $description[] = '<ul><li>' . implode('</li><li>', $items) . '</li></ul>';
  $config = $this
    ->config('block_blacklist.settings');
  $form['system'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('System-wide Blacklist'),
    '#open' => TRUE,
    '#prefix' => '<p>' . implode('</p><p>', $description) . '</p>',
  ];
  $form['system']['system_match'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('System Blacklist Match'),
    '#description' => $this
      ->t('Enter a list of block ids to remove ' . 'completely from the block system.'),
    '#default_value' => $config
      ->get('system_match'),
  ];
  $form['system']['system_prefix'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('System Blacklist Prefix'),
    '#description' => $this
      ->t('Enter a list of prefixes to use to ' . 'identify system blocks to remove.'),
    '#default_value' => $config
      ->get('system_prefix'),
  ];
  $form['system']['system_regex'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('System Blacklist Regex'),
    '#description' => $this
      ->t('Enter a list of regex strings to use to ' . 'identify system blocks to remove.'),
    '#default_value' => $config
      ->get('system_regex'),
  ];
  $form['layout'] = [
    '#type' => 'details',
    '#title' => $this
      ->t('Layout Builder Blacklist'),
    '#open' => TRUE,
  ];
  $form['layout']['layout_match'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('Layout Builder Blacklist Match'),
    '#description' => $this
      ->t('Enter a list of block ids to remove ' . 'completely from the Layout Builder list.'),
    '#default_value' => $config
      ->get('layout_match'),
  ];
  $form['layout']['layout_prefix'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('Layout Builder Blacklist Prefix'),
    '#description' => $this
      ->t('Enter a list of prefixes to use to ' . 'identify Layout Builder blocks to remove.'),
    '#default_value' => $config
      ->get('layout_prefix'),
  ];
  $form['layout']['layout_regex'] = [
    '#type' => 'textarea',
    '#title' => $this
      ->t('Layout Builder Blacklist Regex'),
    '#description' => $this
      ->t('Enter a list of regex strings to use to ' . 'identify Layout Builder blocks to remove.'),
    '#default_value' => $config
      ->get('layout_regex'),
  ];
  return parent::buildForm($form, $form_state);
}