function EntityController::addPage

Same name in other branches
  1. 9 core/lib/Drupal/Core/Entity/Controller/EntityController.php \Drupal\Core\Entity\Controller\EntityController::addPage()
  2. 8.9.x core/lib/Drupal/Core/Entity/Controller/EntityController.php \Drupal\Core\Entity\Controller\EntityController::addPage()
  3. 11.x core/lib/Drupal/Core/Entity/Controller/EntityController.php \Drupal\Core\Entity\Controller\EntityController::addPage()

Displays add links for the available bundles.

Redirects to the add form if there's only one bundle available.

Parameters

string $entity_type_id: The entity type ID.

Return value

\Symfony\Component\HttpFoundation\RedirectResponse|array If there's only one available bundle, a redirect response. Otherwise, a render array with the add links for each bundle.

File

core/lib/Drupal/Core/Entity/Controller/EntityController.php, line 155

Class

EntityController
Provides the add-page and title callbacks for entities.

Namespace

Drupal\Core\Entity\Controller

Code

public function addPage($entity_type_id) {
    $entity_type = $this->entityTypeManager
        ->getDefinition($entity_type_id);
    $bundles = $this->entityTypeBundleInfo
        ->getBundleInfo($entity_type_id);
    $bundle_key = $entity_type->getKey('bundle');
    $bundle_entity_type_id = $entity_type->getBundleEntityType();
    $build = [
        '#theme' => 'entity_add_list',
        '#bundles' => [],
    ];
    if ($bundle_entity_type_id) {
        $bundle_argument = $bundle_entity_type_id;
        $bundle_entity_type = $this->entityTypeManager
            ->getDefinition($bundle_entity_type_id);
        $bundle_entity_type_label = $bundle_entity_type->getSingularLabel();
        $build['#cache']['tags'] = $bundle_entity_type->getListCacheTags();
        // Build the message shown when there are no bundles.
        $link_text = $this->t('Add a new @entity_type.', [
            '@entity_type' => $bundle_entity_type_label,
        ]);
        $link_route_name = 'entity.' . $bundle_entity_type->id() . '.add_form';
        $build['#add_bundle_message'] = $this->t('There is no @entity_type yet. @add_link', [
            '@entity_type' => $bundle_entity_type_label,
            '@add_link' => Link::createFromRoute($link_text, $link_route_name)->toString(),
        ]);
        // Filter out the bundles the user doesn't have access to.
        $access_control_handler = $this->entityTypeManager
            ->getAccessControlHandler($entity_type_id);
        foreach ($bundles as $bundle_name => $bundle_info) {
            $access = $access_control_handler->createAccess($bundle_name, NULL, [], TRUE);
            if (!$access->isAllowed()) {
                unset($bundles[$bundle_name]);
            }
            $this->renderer
                ->addCacheableDependency($build, $access);
        }
        // Add descriptions from the bundle entities.
        $bundles = $this->loadBundleDescriptions($bundles, $bundle_entity_type);
    }
    else {
        $bundle_argument = $bundle_key;
    }
    $form_route_name = 'entity.' . $entity_type_id . '.add_form';
    // Redirect if there's only one bundle available.
    if (count($bundles) == 1) {
        $bundle_names = array_keys($bundles);
        $bundle_name = reset($bundle_names);
        $parameters = $this->routeMatch
            ->getRawParameters()
            ->all();
        $parameters[$bundle_argument] = $bundle_name;
        return $this->redirect($form_route_name, $parameters);
    }
    // Prepare the #bundles array for the template.
    foreach ($bundles as $bundle_name => $bundle_info) {
        $build['#bundles'][$bundle_name] = [
            'label' => $bundle_info['label'],
            'description' => $bundle_info['description'] ?? '',
            'add_link' => Link::createFromRoute($bundle_info['label'], $form_route_name, [
                $bundle_argument => $bundle_name,
            ]),
        ];
    }
    return $build;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.