You are here

class BlockListBuilder in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/modules/block/src/BlockListBuilder.php \Drupal\block\BlockListBuilder

Defines a class to build a listing of block entities.

Hierarchy

Expanded class hierarchy of BlockListBuilder

See also

\Drupal\block\Entity\Block

File

core/modules/block/src/BlockListBuilder.php, line 29
Contains \Drupal\block\BlockListBuilder.

Namespace

Drupal\block
View source
class BlockListBuilder extends ConfigEntityListBuilder implements FormInterface {

  /**
   * The theme containing the blocks.
   *
   * @var string
   */
  protected $theme;

  /**
   * The current request.
   *
   * @var \Symfony\Component\HttpFoundation\Request
   */
  protected $request;

  /**
   * The theme manager.
   *
   * @var \Drupal\Core\Theme\ThemeManagerInterface
   */
  protected $themeManager;

  /**
   * The form builder.
   *
   * @var \Drupal\Core\Form\FormBuilderInterface
   */
  protected $formBuilder;

  /**
   * {@inheritdoc}
   */
  protected $limit = FALSE;

  /**
   * Constructs a new BlockListBuilder object.
   *
   * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
   *   The entity type definition.
   * @param \Drupal\Core\Entity\EntityStorageInterface $storage
   *   The entity storage class.
   * @param \Drupal\Core\Theme\ThemeManagerInterface $theme_manager
   *   The theme manager.
   * @param \Drupal\Core\Form\FormBuilderInterface $form_builder
   *   The form builder.
   */
  public function __construct(EntityTypeInterface $entity_type, EntityStorageInterface $storage, ThemeManagerInterface $theme_manager, FormBuilderInterface $form_builder) {
    parent::__construct($entity_type, $storage);
    $this->themeManager = $theme_manager;
    $this->formBuilder = $form_builder;
  }

  /**
   * {@inheritdoc}
   */
  public static function createInstance(ContainerInterface $container, EntityTypeInterface $entity_type) {
    return new static($entity_type, $container
      ->get('entity.manager')
      ->getStorage($entity_type
      ->id()), $container
      ->get('theme.manager'), $container
      ->get('form_builder'));
  }

  /**
   * {@inheritdoc}
   *
   * @param string|null $theme
   *   (optional) The theme to display the blocks for. If NULL, the current
   *   theme will be used.
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The current request.
   *
   * @return array
   *   The block list as a renderable array.
   */
  public function render($theme = NULL, Request $request = NULL) {
    $this->request = $request;
    $this->theme = $theme;
    return $this->formBuilder
      ->getForm($this);
  }

  /**
   * {@inheritdoc}
   */
  public function getFormId() {
    return 'block_admin_display_form';
  }

  /**
   * {@inheritdoc}
   */
  public function buildForm(array $form, FormStateInterface $form_state) {
    $form['#attached']['library'][] = 'core/drupal.tableheader';
    $form['#attached']['library'][] = 'block/drupal.block';
    $form['#attached']['library'][] = 'block/drupal.block.admin';
    $form['#attributes']['class'][] = 'clearfix';

    // Build the form tree.
    $form['blocks'] = $this
      ->buildBlocksForm();
    $form['actions'] = array(
      '#tree' => FALSE,
      '#type' => 'actions',
    );
    $form['actions']['submit'] = array(
      '#type' => 'submit',
      '#value' => $this
        ->t('Save blocks'),
      '#button_type' => 'primary',
    );
    return $form;
  }

  /**
   * Builds the main "Blocks" portion of the form.
   *
   * @return array
   */
  protected function buildBlocksForm() {

    // Build blocks first for each region.
    $blocks = [];
    $entities = $this
      ->load();

    /** @var \Drupal\block\BlockInterface[] $entities */
    foreach ($entities as $entity_id => $entity) {
      $definition = $entity
        ->getPlugin()
        ->getPluginDefinition();
      $blocks[$entity
        ->getRegion()][$entity_id] = array(
        'label' => $entity
          ->label(),
        'entity_id' => $entity_id,
        'weight' => $entity
          ->getWeight(),
        'entity' => $entity,
        'category' => $definition['category'],
      );
    }
    $form = array(
      '#type' => 'table',
      '#header' => array(
        $this
          ->t('Block'),
        $this
          ->t('Category'),
        $this
          ->t('Region'),
        $this
          ->t('Weight'),
        $this
          ->t('Operations'),
      ),
      '#attributes' => array(
        'id' => 'blocks',
      ),
    );

    // Weights range from -delta to +delta, so delta should be at least half
    // of the amount of blocks present. This makes sure all blocks in the same
    // region get an unique weight.
    $weight_delta = round(count($entities) / 2);
    $placement = FALSE;
    if ($this->request->query
      ->has('block-placement')) {
      $placement = $this->request->query
        ->get('block-placement');
      $form['#attached']['drupalSettings']['blockPlacement'] = $placement;
    }

    // Loop over each region and build blocks.
    $regions = $this
      ->systemRegionList($this
      ->getThemeName(), REGIONS_VISIBLE);
    $block_regions_with_disabled = $regions + array(
      BlockInterface::BLOCK_REGION_NONE => $this
        ->t('Disabled', array(), array(
        'context' => 'Plural',
      )),
    );
    foreach ($block_regions_with_disabled as $region => $title) {
      $form['#tabledrag'][] = array(
        'action' => 'match',
        'relationship' => 'sibling',
        'group' => 'block-region-select',
        'subgroup' => 'block-region-' . $region,
        'hidden' => FALSE,
      );
      $form['#tabledrag'][] = array(
        'action' => 'order',
        'relationship' => 'sibling',
        'group' => 'block-weight',
        'subgroup' => 'block-weight-' . $region,
      );
      $form['region-' . $region] = array(
        '#attributes' => array(
          'class' => array(
            'region-title',
            'region-title-' . $region,
          ),
          'no_striping' => TRUE,
        ),
      );
      $form['region-' . $region]['title'] = array(
        '#theme_wrappers' => array(
          'container' => array(
            '#attributes' => array(
              'class' => 'region-title__action',
            ),
          ),
        ),
        '#prefix' => $region != BlockInterface::BLOCK_REGION_NONE ? $title : $block_regions_with_disabled[$region],
        '#type' => 'link',
        '#title' => $this
          ->t('Place block <span class="visually-hidden">in the %region region</span>', [
          '%region' => $block_regions_with_disabled[$region],
        ]),
        '#url' => Url::fromRoute('block.admin_library', [
          'theme' => $this
            ->getThemeName(),
        ], [
          'query' => [
            'region' => $region,
          ],
        ]),
        '#wrapper_attributes' => array(
          'colspan' => 5,
        ),
        '#attributes' => [
          'class' => [
            'use-ajax',
            'button',
            'button--small',
          ],
          'data-dialog-type' => 'modal',
          'data-dialog-options' => Json::encode([
            'width' => 700,
          ]),
        ],
      );
      $form['region-' . $region . '-message'] = array(
        '#attributes' => array(
          'class' => array(
            'region-message',
            'region-' . $region . '-message',
            empty($blocks[$region]) ? 'region-empty' : 'region-populated',
          ),
        ),
      );
      $form['region-' . $region . '-message']['message'] = array(
        '#markup' => '<em>' . $this
          ->t('No blocks in this region') . '</em>',
        '#wrapper_attributes' => array(
          'colspan' => 5,
        ),
      );
      if (isset($blocks[$region])) {
        foreach ($blocks[$region] as $info) {
          $entity_id = $info['entity_id'];
          $form[$entity_id] = array(
            '#attributes' => array(
              'class' => array(
                'draggable',
              ),
            ),
          );
          if ($placement && $placement == Html::getClass($entity_id)) {
            $form[$entity_id]['#attributes']['class'][] = 'color-success';
            $form[$entity_id]['#attributes']['class'][] = 'js-block-placed';
          }
          $form[$entity_id]['info'] = array(
            '#plain_text' => $info['label'],
            '#wrapper_attributes' => array(
              'class' => array(
                'block',
              ),
            ),
          );
          $form[$entity_id]['type'] = array(
            '#markup' => $info['category'],
          );
          $form[$entity_id]['region-theme']['region'] = array(
            '#type' => 'select',
            '#default_value' => $region,
            '#empty_value' => BlockInterface::BLOCK_REGION_NONE,
            '#title' => $this
              ->t('Region for @block block', array(
              '@block' => $info['label'],
            )),
            '#title_display' => 'invisible',
            '#options' => $regions,
            '#attributes' => array(
              'class' => array(
                'block-region-select',
                'block-region-' . $region,
              ),
            ),
            '#parents' => array(
              'blocks',
              $entity_id,
              'region',
            ),
          );
          $form[$entity_id]['region-theme']['theme'] = array(
            '#type' => 'hidden',
            '#value' => $this
              ->getThemeName(),
            '#parents' => array(
              'blocks',
              $entity_id,
              'theme',
            ),
          );
          $form[$entity_id]['weight'] = array(
            '#type' => 'weight',
            '#default_value' => $info['weight'],
            '#delta' => $weight_delta,
            '#title' => $this
              ->t('Weight for @block block', array(
              '@block' => $info['label'],
            )),
            '#title_display' => 'invisible',
            '#attributes' => array(
              'class' => array(
                'block-weight',
                'block-weight-' . $region,
              ),
            ),
          );
          $form[$entity_id]['operations'] = $this
            ->buildOperations($info['entity']);
        }
      }
    }

    // Do not allow disabling the main system content block when it is present.
    if (isset($form['system_main']['region'])) {
      $form['system_main']['region']['#required'] = TRUE;
    }
    return $form;
  }

  /**
   * Gets the name of the theme used for this block listing.
   *
   * @return string
   *   The name of the theme.
   */
  protected function getThemeName() {

    // If no theme was specified, use the current theme.
    if (!$this->theme) {
      $this->theme = $this->themeManager
        ->getActiveTheme()
        ->getName();
    }
    return $this->theme;
  }

  /**
   * {@inheritdoc}
   */
  protected function getEntityIds() {
    return $this
      ->getStorage()
      ->getQuery()
      ->condition('theme', $this
      ->getThemeName())
      ->sort($this->entityType
      ->getKey('id'))
      ->execute();
  }

  /**
   * {@inheritdoc}
   */
  public function getDefaultOperations(EntityInterface $entity) {
    $operations = parent::getDefaultOperations($entity);
    if (isset($operations['edit'])) {
      $operations['edit']['title'] = $this
        ->t('Configure');
    }
    return $operations;
  }

  /**
   * {@inheritdoc}
   */
  public function validateForm(array &$form, FormStateInterface $form_state) {

    // No validation.
  }

  /**
   * {@inheritdoc}
   */
  public function submitForm(array &$form, FormStateInterface $form_state) {
    $entities = $this->storage
      ->loadMultiple(array_keys($form_state
      ->getValue('blocks')));

    /** @var \Drupal\block\BlockInterface[] $entities */
    foreach ($entities as $entity_id => $entity) {
      $entity_values = $form_state
        ->getValue(array(
        'blocks',
        $entity_id,
      ));
      $entity
        ->setWeight($entity_values['weight']);
      $entity
        ->setRegion($entity_values['region']);
      if ($entity
        ->getRegion() == BlockInterface::BLOCK_REGION_NONE) {
        $entity
          ->disable();
      }
      else {
        $entity
          ->enable();
      }
      $entity
        ->save();
    }
    drupal_set_message(t('The block settings have been updated.'));

    // Remove any previously set block placement.
    $this->request->query
      ->remove('block-placement');
  }

  /**
   * Wraps system_region_list().
   */
  protected function systemRegionList($theme, $show = REGIONS_ALL) {
    return system_region_list($theme, $show);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
BlockListBuilder::$formBuilder protected property The form builder.
BlockListBuilder::$limit protected property The number of entities to list per page, or FALSE to list all entities. Overrides EntityListBuilder::$limit
BlockListBuilder::$request protected property The current request.
BlockListBuilder::$theme protected property The theme containing the blocks.
BlockListBuilder::$themeManager protected property The theme manager.
BlockListBuilder::buildBlocksForm protected function Builds the main "Blocks" portion of the form.
BlockListBuilder::buildForm public function Form constructor. Overrides FormInterface::buildForm
BlockListBuilder::createInstance public static function Instantiates a new instance of this entity handler. Overrides EntityListBuilder::createInstance
BlockListBuilder::getDefaultOperations public function Gets this list's default operations. Overrides ConfigEntityListBuilder::getDefaultOperations
BlockListBuilder::getEntityIds protected function Loads entity IDs using a pager sorted by the entity id. Overrides EntityListBuilder::getEntityIds
BlockListBuilder::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
BlockListBuilder::getThemeName protected function Gets the name of the theme used for this block listing.
BlockListBuilder::render public function Overrides EntityListBuilder::render
BlockListBuilder::submitForm public function Form submission handler. Overrides FormInterface::submitForm
BlockListBuilder::systemRegionList protected function Wraps system_region_list().
BlockListBuilder::validateForm public function Form validation handler. Overrides FormInterface::validateForm
BlockListBuilder::__construct public function Constructs a new BlockListBuilder object. Overrides EntityListBuilder::__construct
ConfigEntityListBuilder::load public function Loads entities of this type from storage for listing. Overrides EntityListBuilder::load 7
DependencySerializationTrait::$_serviceIds protected property An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
EntityHandlerBase::$moduleHandler protected property The module handler to invoke hooks on. 3
EntityHandlerBase::moduleHandler protected function Gets the module handler. 3
EntityHandlerBase::setModuleHandler public function Sets the module handler for this handler.
EntityListBuilder::$entityType protected property Information about the entity type.
EntityListBuilder::$entityTypeId protected property The entity type ID.
EntityListBuilder::$storage protected property The entity storage class.
EntityListBuilder::buildHeader public function Builds the header row for the entity listing. 22
EntityListBuilder::buildOperations public function Builds a renderable list of operation links for the entity. 2
EntityListBuilder::buildRow public function Builds a row for an entity in the entity listing. 22
EntityListBuilder::getLabel Deprecated protected function Gets the label of an entity.
EntityListBuilder::getOperations public function Provides an array of information to build a list of operation links. Overrides EntityListBuilderInterface::getOperations 2
EntityListBuilder::getStorage public function Gets the entity storage. Overrides EntityListBuilderInterface::getStorage
EntityListBuilder::getTitle protected function Gets the title of the page. 1
StringTranslationTrait::$stringTranslation protected property The string translation service.
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.