Issue #1875260 by Gábor Hojtsy, xjm, brantwynn, EclipseGc, Bojhan: Fixed Make the block title required and allow it to be hidden.

core/modules/block/block.module

@@ -42,6 +42,11 @@ const BLOCK_VISIBILITY_LISTED = 1;
  */
 const BLOCK_VISIBILITY_PHP = 2;
 
+/**
+ * Indicates the block label (title) should be displayed to end users.
+ */
+const BLOCK_LABEL_VISIBLE = 'visible';
+
 /**
  * Implements hook_help().
  */
@@ -528,6 +533,11 @@ function template_preprocess_block(&$variables) {
   $block_counter = &drupal_static(__FUNCTION__, array());
 
   $variables['block'] = (object) $variables['elements']['#block_config'];
+  // If the block title is configured to be hidden, set it to an empty string.
+  if (empty($variables['elements']['#block']->label_display)) {
+    $variables['block']->label_hidden = $variables['block']->label;
+    $variables['block']->label = '';
+  }
 
   // All blocks get an independent counter for each region.
   if (!isset($block_counter[$variables['block']->region])) {

core/modules/block/lib/Drupal/block/BlockBase.php

@@ -238,6 +238,13 @@ abstract class BlockBase extends PluginBase implements BlockInterface {
       '#title' => t('Title'),
       '#maxlength' => 255,
       '#default_value' => !$entity->isNew() ? $entity->label() : $definition['admin_label'],
+      '#required' => TRUE,
+    );
+    $form['label_display'] = array(
+      '#type' => 'checkbox',
+      '#title' => t('Display title'),
+      '#default_value' => $entity->label_display == BLOCK_LABEL_VISIBLE ? TRUE : FALSE,
+      '#return_value' => BLOCK_LABEL_VISIBLE,
     );
     $form['machine_name'] = array(
       '#type' => 'machine_name',

core/modules/block/lib/Drupal/block/Plugin/Core/Entity/Block.php

@@ -52,6 +52,17 @@ class Block extends ConfigEntityBase {
    */
   public $label;
 
+  /**
+   * Whether the block label is displayed to end users.
+   *
+   * When this is set to BLOCK_LABEL_VISIBLE (the default value), the label is
+   * rendered as header in the block markup. Otherwise, the label is passed
+   * to the block template as a separate $label_hidden variable.
+   *
+   * @var string
+   */
+  public $label_display = BLOCK_LABEL_VISIBLE;
+
   /**
    * The block UUID.
    *
@@ -169,6 +180,7 @@ class Block extends ConfigEntityBase {
     $names = array(
       'id',
       'label',
+      'label_display',
       'uuid',
       'region',
       'weight',

core/modules/block/lib/Drupal/block/Tests/BlockStorageUnitTest.php

@@ -93,6 +93,7 @@ class BlockStorageUnitTest extends DrupalUnitTestBase {
     $expected_properties = array(
       'id' => 'stark.test_block',
       'label' => '',
+      'label_display' => BLOCK_LABEL_VISIBLE,
       'region' => '-1',
       'weight' => '',
       'module' => 'block_test',

core/modules/block/lib/Drupal/block/Tests/BlockTest.php

@@ -313,6 +313,37 @@ class BlockTest extends WebTestBase {
     $this->assertNoFieldByXPath($xpath, FALSE, 'Block found in no regions.');
   }
 
+  /**
+   * Test block title display settings.
+   */
+  function testHideBlockTitle() {
+    $block_name = 'system_powered_by_block';
+    // Create a random title for the block.
+    $title = $this->randomName(8);
+    $machine_name = strtolower($this->randomName(8));
+    // Enable a standard block.
+    $default_theme = variable_get('theme_default', 'stark');
+    $edit = array(
+      'machine_name' => $machine_name,
+      'region' => 'sidebar_first',
+      'label' => $title,
+    );
+    $this->drupalPost('admin/structure/block/add/' . $block_name . '/' . $default_theme, $edit, t('Save block'));
+    $this->assertText('The block configuration has been saved.', 'Block was saved');
+
+    $this->drupalGet('user');
+    $this->assertText($title, 'Block title was displayed by default.');
+
+    $edit = array(
+      'label_display' => FALSE,
+    );
+    $this->drupalPost('admin/structure/block/manage/' . $default_theme . '.' . $machine_name . '/configure', $edit, t('Save block'));
+    $this->assertText('The block configuration has been saved.', 'Block was saved');
+
+    $this->drupalGet('user');
+    $this->assertNoText($title, 'Block title was not displayed when hidden.');
+  }
+
   /**
    * Moves a block to a given region via the UI and confirms the result.
    *

core/modules/block/templates/block.tpl.php

@@ -6,6 +6,8 @@
  *
  * Available variables:
  * - $block->label: Block title.
+ * - $block->label_hidden: The hidden block title value if the block was
+ *    configured to hide the title ($block->label is empty in this case).
  * - $content: Block content.
  * - $block->module: Module that generated the block.
  * - $block->delta: An ID for the block, unique within each module.

core/profiles/minimal/config/block.block.stark.admin.yml

@@ -16,3 +16,4 @@ visibility:
 plugin: 'system_menu_block:menu-admin'
 settings:
   cache: '-1'
+label_display: visible

core/profiles/minimal/config/block.block.stark.login.yml

@@ -16,3 +16,4 @@ visibility:
 plugin: user_login_block
 settings:
   cache: '-1'
+label_display: visible

core/profiles/minimal/config/block.block.stark.tools.yml

@@ -16,3 +16,4 @@ visibility:
 plugin: 'system_menu_block:menu-tools'
 settings:
   cache: '-1'
+label_display: visible

core/profiles/standard/config/block.block.bartik.content.yml

@@ -19,3 +19,4 @@ module: system
 region: content
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.footer.yml

@@ -19,3 +19,4 @@ module: system
 region: footer
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.help.yml

@@ -19,3 +19,4 @@ module: system
 region: help
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.login.yml

@@ -20,3 +20,4 @@ region: sidebar_first
 weight: '0'
 plugin: user_login_block
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.powered.yml

@@ -19,3 +19,4 @@ module: system
 region: footer
 weight: '10'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.search.yml

@@ -19,3 +19,4 @@ module: search
 region: sidebar_first
 weight: '-1'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.bartik.tools.yml

@@ -19,3 +19,4 @@ module: system
 region: sidebar_first
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.seven.content.yml

@@ -19,3 +19,4 @@ module: system
 region: content
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.seven.help.yml

@@ -19,3 +19,4 @@ module: system
 region: help
 weight: '0'
 langcode: en
+label_display: visible

core/profiles/standard/config/block.block.seven.login.yml

@@ -19,3 +19,4 @@ module: user
 region: content
 weight: '10'
 langcode: en
+label_display: visible