drupal/core/modules/layout_builder/layout_builder.module

<?php

/**
 * @file
 * Provides hook implementations for Layout Builder.
 */

use Drupal\Core\Breadcrumb\Breadcrumb;
use Drupal\Core\Cache\CacheableMetadata;
use Drupal\Core\Entity\EntityInterface;
use Drupal\Core\Entity\FieldableEntityInterface;
use Drupal\Core\Field\Plugin\Field\FieldFormatter\TimestampFormatter;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Link;
use Drupal\Core\Render\Element;
use Drupal\Core\Routing\RouteMatchInterface;
use Drupal\Core\Url;
use Drupal\field\FieldConfigInterface;
use Drupal\layout_builder\Entity\LayoutBuilderEntityViewDisplay;
use Drupal\layout_builder\Entity\LayoutBuilderEntityViewDisplayStorage;
use Drupal\layout_builder\Entity\LayoutEntityDisplayInterface;
use Drupal\layout_builder\Form\DefaultsEntityForm;
use Drupal\layout_builder\Form\LayoutBuilderEntityViewDisplayForm;
use Drupal\layout_builder\Form\OverridesEntityForm;
use Drupal\Core\Entity\Display\EntityViewDisplayInterface;
use Drupal\layout_builder\Plugin\Block\ExtraFieldBlock;
use Drupal\layout_builder\InlineBlockEntityOperations;
use Drupal\Core\Session\AccountInterface;
use Drupal\Core\Access\AccessResult;
use Drupal\layout_builder\Plugin\SectionStorage\OverridesSectionStorage;

/**
 * Implements hook_help().
 */
function layout_builder_help($route_name, RouteMatchInterface $route_match) {
  // Add help text to the Layout Builder UI.
  if ($route_match->getRouteObject()->getOption('_layout_builder')) {
    $output = '<p>' . t('This layout builder tool allows you to configure the layout of the main content area.') . '</p>';
    if (\Drupal::currentUser()->hasPermission('administer blocks')) {
      $output .= '<p>' . t('To manage other areas of the page, use the <a href="@block-ui">block administration page</a>.', ['@block-ui' => Url::fromRoute('block.admin_display')->toString()]) . '</p>';
    }
    else {
      $output .= '<p>' . t('To manage other areas of the page, use the block administration page.') . '</p>';
    }
    $output .= '<p>' . t('Forms and links inside the content of the layout builder tool have been disabled.') . '</p>';
    return $output;
  }

  switch ($route_name) {
    case 'help.page.layout_builder':
      $output = '<h2>' . t('About') . '</h2>';
      $output .= '<p>' . t('Layout Builder allows you to use layouts to customize how content, content blocks, and other <a href=":field_help" title="Field module help, with background on content entities">content entities</a> are displayed.', [':field_help' => Url::fromRoute('help.page', ['name' => 'field'])->toString()]) . '</p>';
      $output .= '<p>' . t('For more information, see the <a href=":layout-builder-documentation">online documentation for the Layout Builder module</a>.', [':layout-builder-documentation' => 'https://www.drupal.org/docs/8/core/modules/layout-builder']) . '</p>';
      $output .= '<h2>' . t('Uses') . '</h2>';
      $output .= '<dl>';
      $output .= '<dt>' . t('Default layouts') . '</dt>';
      $output .= '<dd>' . t('Layout Builder can be selectively enabled on the "Manage Display" page in the <a href=":field_ui">Field UI</a>. This allows you to control the output of each type of display individually. For example, a "Basic page" might have view modes such as Full and Teaser, with each view mode having different layouts selected.', [':field_ui' => Url::fromRoute('help.page', ['name' => 'field_ui'])->toString()]) . '</dd>';
      $output .= '<dt>' . t('Overridden layouts') . '</dt>';
      $output .= '<dd>' . t('If enabled, each individual content item can have a custom layout. Once the layout for an individual content item is overridden, changes to the Default layout will no longer affect it. Overridden layouts may be reverted to return to matching and being synchronized to their Default layout.') . '</dd>';
      $output .= '<dt>' . t('User permissions') . '</dt>';
      $output .= '<dd>' . t('The Layout Builder module makes a number of permissions available, which can be set by role on the <a href=":permissions">permissions page</a>. For more information, see the <a href=":layout-builder-permissions">Configuring Layout Builder permissions</a> online documentation.', [
        ':permissions' => Url::fromRoute('user.admin_permissions.module', ['modules' => 'layout_builder'])->toString(),
        ':layout-builder-permissions' => 'https://www.drupal.org/docs/8/core/modules/layout-builder/configuring-layout-builder-permissions',
      ]) . '</dd>';
      $output .= '</dl>';
      return $output;
  }
}

/**
 * Implements hook_entity_type_alter().
 */
function layout_builder_entity_type_alter(array &$entity_types) {
  /** @var \Drupal\Core\Entity\EntityTypeInterface[] $entity_types */
  $entity_types['entity_view_display']
    ->setClass(LayoutBuilderEntityViewDisplay::class)
    ->setStorageClass(LayoutBuilderEntityViewDisplayStorage::class)
    ->setFormClass('layout_builder', DefaultsEntityForm::class)
    ->setFormClass('edit', LayoutBuilderEntityViewDisplayForm::class);

  // Ensure every fieldable entity type has a layout form.
  foreach ($entity_types as $entity_type) {
    if ($entity_type->entityClassImplements(FieldableEntityInterface::class)) {
      $entity_type->setFormClass('layout_builder', OverridesEntityForm::class);
    }
  }
}

/**
 * Implements hook_form_FORM_ID_alter() for \Drupal\field_ui\Form\EntityFormDisplayEditForm.
 */
function layout_builder_form_entity_form_display_edit_form_alter(&$form, FormStateInterface $form_state) {
  // Hides the Layout Builder field. It is rendered directly in
  // \Drupal\layout_builder\Entity\LayoutBuilderEntityViewDisplay::buildMultiple().
  unset($form['fields'][OverridesSectionStorage::FIELD_NAME]);
  $key = array_search(OverridesSectionStorage::FIELD_NAME, $form['#fields']);
  if ($key !== FALSE) {
    unset($form['#fields'][$key]);
  }
}

/**
 * Implements hook_field_config_insert().
 */
function layout_builder_field_config_insert(FieldConfigInterface $field_config) {
  // Clear the sample entity for this entity type and bundle.
  $sample_entity_generator = \Drupal::service('layout_builder.sample_entity_generator');
  $sample_entity_generator->delete($field_config->getTargetEntityTypeId(), $field_config->getTargetBundle());
  \Drupal::service('plugin.manager.block')->clearCachedDefinitions();
}

/**
 * Implements hook_field_config_delete().
 */
function layout_builder_field_config_delete(FieldConfigInterface $field_config) {
  // Clear the sample entity for this entity type and bundle.
  $sample_entity_generator = \Drupal::service('layout_builder.sample_entity_generator');
  $sample_entity_generator->delete($field_config->getTargetEntityTypeId(), $field_config->getTargetBundle());
  \Drupal::service('plugin.manager.block')->clearCachedDefinitions();
}

/**
 * Implements hook_entity_view_alter().
 *
 * ExtraFieldBlock block plugins add placeholders for each extra field which is
 * configured to be displayed. Those placeholders are replaced by this hook.
 * Modules that implement hook_entity_extra_field_info() use their
 * implementations of hook_entity_view_alter() to add the rendered output of
 * the extra fields they provide, so we cannot get the rendered output of extra
 * fields before this point in the view process.
 * layout_builder_module_implements_alter() moves this implementation of
 * hook_entity_view_alter() to the end of the list.
 *
 * @see \Drupal\layout_builder\Plugin\Block\ExtraFieldBlock::build()
 * @see layout_builder_module_implements_alter()
 */
function layout_builder_entity_view_alter(array &$build, EntityInterface $entity, EntityViewDisplayInterface $display) {
  // Only replace extra fields when Layout Builder has been used to alter the
  // build. See \Drupal\layout_builder\Entity\LayoutBuilderEntityViewDisplay::buildMultiple().
  if (isset($build['_layout_builder']) && !Element::isEmpty($build['_layout_builder'])) {
    /** @var \Drupal\Core\Entity\EntityFieldManagerInterface $field_manager */
    $field_manager = \Drupal::service('entity_field.manager');
    $extra_fields = $field_manager->getExtraFields($entity->getEntityTypeId(), $entity->bundle());
    if (!empty($extra_fields['display'])) {
      foreach ($extra_fields['display'] as $field_name => $extra_field) {
        // If the extra field is not set replace with an empty array to avoid
        // the placeholder text from being rendered.
        $replacement = $build[$field_name] ?? [];
        ExtraFieldBlock::replaceFieldPlaceholder($build, $replacement, $field_name);
        // After the rendered field in $build has been copied over to the
        // ExtraFieldBlock block we must remove it from its original location or
        // else it will be rendered twice.
        unset($build[$field_name]);
      }
    }
  }

  $route_name = \Drupal::routeMatch()->getRouteName();

  // If the entity is displayed within a Layout Builder block and the current
  // route is in the Layout Builder UI, then remove all contextual link
  // placeholders.
  if ($route_name && $display instanceof LayoutBuilderEntityViewDisplay && str_starts_with($route_name, 'layout_builder.')) {
    unset($build['#contextual_links']);
  }
}

/**
 * Implements hook_entity_build_defaults_alter().
 */
function layout_builder_entity_build_defaults_alter(array &$build, EntityInterface $entity, $view_mode) {
  // Contextual links are removed for entities viewed in Layout Builder's UI.
  // The route.name.is_layout_builder_ui cache context accounts for this
  // difference.
  // @see layout_builder_entity_view_alter()
  // @see \Drupal\layout_builder\Cache\LayoutBuilderUiCacheContext
  $build['#cache']['contexts'][] = 'route.name.is_layout_builder_ui';
}

/**
 * Implements hook_module_implements_alter().
 */
function layout_builder_module_implements_alter(&$implementations, $hook) {
  if ($hook === 'entity_view_alter') {
    // Ensure that this module's implementation of hook_entity_view_alter() runs
    // last so that other modules that use this hook to render extra fields will
    // run before it.
    $group = $implementations['layout_builder'];
    unset($implementations['layout_builder']);
    $implementations['layout_builder'] = $group;
  }
}

/**
 * Implements hook_entity_presave().
 */
function layout_builder_entity_presave(EntityInterface $entity) {
  if (\Drupal::moduleHandler()->moduleExists('block_content')) {
    /** @var \Drupal\layout_builder\InlineBlockEntityOperations $entity_operations */
    $entity_operations = \Drupal::classResolver(InlineBlockEntityOperations::class);
    $entity_operations->handlePreSave($entity);
  }
}

/**
 * Implements hook_entity_delete().
 */
function layout_builder_entity_delete(EntityInterface $entity) {
  if (\Drupal::moduleHandler()->moduleExists('block_content')) {
    /** @var \Drupal\layout_builder\InlineBlockEntityOperations $entity_operations */
    $entity_operations = \Drupal::classResolver(InlineBlockEntityOperations::class);
    $entity_operations->handleEntityDelete($entity);
  }
}

/**
 * Implements hook_cron().
 */
function layout_builder_cron() {
  if (\Drupal::moduleHandler()->moduleExists('block_content')) {
    /** @var \Drupal\layout_builder\InlineBlockEntityOperations $entity_operations */
    $entity_operations = \Drupal::classResolver(InlineBlockEntityOperations::class);
    $entity_operations->removeUnused();
  }
}

/**
 * Implements hook_plugin_filter_TYPE__CONSUMER_alter().
 */
function layout_builder_plugin_filter_block__layout_builder_alter(array &$definitions, array $extra) {
  // Remove blocks that are not useful within Layout Builder.
  unset($definitions['system_messages_block']);
  unset($definitions['help_block']);
  unset($definitions['local_tasks_block']);
  unset($definitions['local_actions_block']);

  // Remove blocks that are non-functional within Layout Builder.
  unset($definitions['system_main_block']);
  // @todo Restore the page title block in https://www.drupal.org/node/2938129.
  unset($definitions['page_title_block']);
}

/**
 * Implements hook_plugin_filter_TYPE_alter().
 */
function layout_builder_plugin_filter_block_alter(array &$definitions, array $extra, $consumer) {
  // @todo Determine the 'inline_block' blocks should be allowed outside
  //   of layout_builder https://www.drupal.org/node/2979142.
  if ($consumer !== 'layout_builder' || !isset($extra['list']) || $extra['list'] !== 'inline_blocks') {
    foreach ($definitions as $id => $definition) {
      if ($definition['id'] === 'inline_block') {
        unset($definitions[$id]);
      }
    }
  }
}

/**
 * Implements hook_ENTITY_TYPE_access().
 */
function layout_builder_block_content_access(EntityInterface $entity, $operation, AccountInterface $account) {
  /** @var \Drupal\block_content\BlockContentInterface $entity */
  if ($operation === 'view' || $entity->isReusable() || empty(\Drupal::service('inline_block.usage')->getUsage($entity->id()))) {
    // If the operation is 'view' or this is reusable block or if this is
    // non-reusable that isn't used by this module then don't alter the access.
    return AccessResult::neutral();
  }

  if ($account->hasPermission('create and edit custom blocks')) {
    return AccessResult::allowed();
  }
  return AccessResult::forbidden();
}

/**
 * Implements hook_plugin_filter_TYPE__CONSUMER_alter().
 */
function layout_builder_plugin_filter_block__block_ui_alter(array &$definitions, array $extra) {
  foreach ($definitions as $id => $definition) {
    // Filter out any layout_builder-provided block that has required context
    // definitions.
    if ($definition['provider'] === 'layout_builder' && !empty($definition['context_definitions'])) {
      /** @var \Drupal\Core\Plugin\Context\ContextDefinitionInterface $context_definition */
      foreach ($definition['context_definitions'] as $context_definition) {
        if ($context_definition->isRequired()) {
          unset($definitions[$id]);
          break;
        }
      }
    }
  }
}

/**
 * Implements hook_plugin_filter_TYPE__CONSUMER_alter().
 */
function layout_builder_plugin_filter_layout__layout_builder_alter(array &$definitions, array $extra) {
  // Remove layouts provide by layout discovery that are not needed because of
  // layouts provided by this module.
  $duplicate_layouts = [
    'layout_twocol',
    'layout_twocol_bricks',
    'layout_threecol_25_50_25',
    'layout_threecol_33_34_33',
  ];

  foreach ($duplicate_layouts as $duplicate_layout) {
    /** @var \Drupal\Core\Layout\LayoutDefinition[] $definitions */
    if (isset($definitions[$duplicate_layout])) {
      if ($definitions[$duplicate_layout]->getProvider() === 'layout_discovery') {
        unset($definitions[$duplicate_layout]);
      }
    }
  }

  // Move the one column layout to the top.
  if (isset($definitions['layout_onecol']) && $definitions['layout_onecol']->getProvider() === 'layout_discovery') {
    $one_col = $definitions['layout_onecol'];
    unset($definitions['layout_onecol']);
    $definitions = [
      'layout_onecol' => $one_col,
    ] + $definitions;
  }
}

/**
 * Implements hook_plugin_filter_TYPE_alter().
 */
function layout_builder_plugin_filter_layout_alter(array &$definitions, array $extra, $consumer) {
  // Hide the blank layout plugin from listings.
  unset($definitions['layout_builder_blank']);
}

/**
 * Implements hook_system_breadcrumb_alter().
 */
function layout_builder_system_breadcrumb_alter(Breadcrumb &$breadcrumb, RouteMatchInterface $route_match, array $context) {
  // Remove the extra 'Manage display' breadcrumb for Layout Builder defaults.
  if ($route_match->getRouteObject() && $route_match->getRouteObject()->hasOption('_layout_builder') && $route_match->getParameter('section_storage_type') === 'defaults') {
    $links = array_filter($breadcrumb->getLinks(), function (Link $link) use ($route_match) {
      $entity_type_id = $route_match->getParameter('entity_type_id');
      if (!$link->getUrl()->isRouted()) {
        return TRUE;
      }
      return $link->getUrl()->getRouteName() !== "entity.entity_view_display.$entity_type_id.default";
    });
    // Links cannot be removed from an existing breadcrumb object. Create a new
    // object but carry over the cacheable metadata.
    $cacheability = CacheableMetadata::createFromObject($breadcrumb);
    $breadcrumb = new Breadcrumb();
    $breadcrumb->setLinks($links);
    $breadcrumb->addCacheableDependency($cacheability);
  }
}

/**
 * Implements hook_entity_translation_create().
 */
function layout_builder_entity_translation_create(EntityInterface $translation) {
  /** @var \Drupal\Core\Entity\FieldableEntityInterface $translation */
  if ($translation->hasField(OverridesSectionStorage::FIELD_NAME) && $translation->getFieldDefinition(OverridesSectionStorage::FIELD_NAME)->isTranslatable()) {
    // When creating a new translation do not copy untranslated sections because
    // per-language layouts are not supported.
    $translation->set(OverridesSectionStorage::FIELD_NAME, []);
  }
}

/**
 * Implements hook_theme_registry_alter().
 */
function layout_builder_theme_registry_alter(&$theme_registry) {
  // Move our preprocess to run after
  // content_translation_preprocess_language_content_settings_table().
  if (!empty($theme_registry['language_content_settings_table']['preprocess functions'])) {
    $preprocess_functions = &$theme_registry['language_content_settings_table']['preprocess functions'];
    $index = array_search('layout_builder_preprocess_language_content_settings_table', $preprocess_functions);
    if ($index !== FALSE) {
      unset($preprocess_functions[$index]);
      $preprocess_functions[] = 'layout_builder_preprocess_language_content_settings_table';
    }
  }
}

/**
 * Implements hook_preprocess_HOOK() for language-content-settings-table.html.twig.
 */
function layout_builder_preprocess_language_content_settings_table(&$variables) {
  foreach ($variables['build']['#rows'] as &$row) {
    if (isset($row['#field_name']) && $row['#field_name'] === OverridesSectionStorage::FIELD_NAME) {
      // Rebuild the label to include a warning about using translations with
      // layouts.
      $row['data'][1]['data']['field'] = [
        'label' => $row['data'][1]['data']['field'],
        'description' => [
          '#type' => 'container',
          '#markup' => t('<strong>Warning</strong>: Layout Builder does not support translating layouts. (<a href="https://www.drupal.org/docs/8/core/modules/layout-builder/layout-builder-and-content-translation">online documentation</a>)'),
          '#attributes' => [
            'class' => ['layout-builder-translation-warning'],
          ],
        ],
      ];
    }
  }
}

/**
 * Implements hook_theme_suggestions_HOOK_alter().
 */
function layout_builder_theme_suggestions_field_alter(&$suggestions, array $variables) {
  $element = $variables['element'];
  if (isset($element['#third_party_settings']['layout_builder']['view_mode'])) {
    // See system_theme_suggestions_field().
    $suggestions[] = 'field__' . $element['#entity_type'] . '__' . $element['#field_name'] . '__' . $element['#bundle'] . '__' . $element['#third_party_settings']['layout_builder']['view_mode'];
  }
  return $suggestions;
}

/**
 * Implements hook_ENTITY_TYPE_presave() for entity_view_display entities.
 *
 * Provides a BC layer for modules providing old configurations.
 *
 * @see https://www.drupal.org/node/2993639
 *
 * @todo Remove this BC layer in drupal:11.0.0.
 */
function layout_builder_entity_view_display_presave(EntityViewDisplayInterface $entity_view_display): void {
  if (!$entity_view_display instanceof LayoutEntityDisplayInterface || !$entity_view_display->isLayoutBuilderEnabled()) {
    return;
  }

  /** @var \Drupal\Core\Field\FormatterPluginManager $field_formatter_manager */
  $field_formatter_manager = \Drupal::service('plugin.manager.field.formatter');

  foreach ($entity_view_display->getSections() as $section) {
    foreach ($section->getComponents() as $component) {
      if (str_starts_with($component->getPluginId(), 'field_block:')) {
        $configuration = $component->get('configuration');
        $formatter =& $configuration['formatter'];
        if ($formatter && isset($formatter['type'])) {
          $plugin_definition = $field_formatter_manager->getDefinition($formatter['type'], FALSE);
          // Check also potential plugins extending TimestampFormatter.
          if (!$plugin_definition || !is_a($plugin_definition['class'], TimestampFormatter::class, TRUE)) {
            continue;
          }
          if (!isset($formatter['settings']['tooltip']) || !isset($formatter['settings']['time_diff'])) {
            @trigger_error("Using the 'timestamp' formatter plugin  without the 'tooltip' and 'time_diff' settings is deprecated in drupal:10.1.0 and is required in drupal:11.0.0. See https://www.drupal.org/node/2993639", E_USER_DEPRECATED);
            $formatter['settings'] += $plugin_definition['class']::defaultSettings();
            // Existing timestamp formatters don't have tooltip.
            $formatter['settings']['tooltip']['date_format'] = '';
            $component->set('configuration', $configuration);
          }
        }
      }
    }
  }
}