FieldStorageAddController.php

Namespace

Drupal\field_ui\Controller

File

core/modules/field_ui/src/Controller/FieldStorageAddController.php

View source
<?php

declare (strict_types=1);
namespace Drupal\field_ui\Controller;

use Drupal\Component\Serialization\Json;
use Drupal\Component\Utility\Html;
use Drupal\Component\Utility\SortArray;
use Drupal\Core\Ajax\AjaxHelperTrait;
use Drupal\Core\Controller\ControllerBase;
use Drupal\Core\Field\FallbackFieldTypeCategory;
use Drupal\Core\Field\FieldTypeCategoryManagerInterface;
use Drupal\Core\Field\FieldTypePluginManagerInterface;
use Drupal\Core\TempStore\PrivateTempStore;
use Drupal\Core\Url;
use Drupal\field_ui\FieldUI;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * Controller for building the field type links.
 *
 * @internal
 */
final class FieldStorageAddController extends ControllerBase {
    use AjaxHelperTrait;
    
    /**
     * The name of the entity type.
     *
     * @var string
     */
    protected $entityTypeId;
    
    /**
     * The entity bundle.
     *
     * @var string
     */
    protected $bundle;
    
    /**
     * Constructs a new FieldStorageAddController.
     */
    public function __construct(FieldTypePluginManagerInterface $fieldTypePluginManager, FieldTypeCategoryManagerInterface $fieldTypeCategoryManager, PrivateTempStore $tempStore) {
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) {
        return new static($container->get('plugin.manager.field.field_type'), $container->get('plugin.manager.field.field_type_category'), $container->get('tempstore.private')
            ->get('field_ui'));
    }
    
    /**
     * Deletes stored field data and builds the field selection links.
     *
     * @param string $entity_type_id
     *   The name of the entity type.
     * @param string $bundle
     *   The entity bundle.
     * @param string $field_name
     *   The field name.
     *
     * @return array
     *   The field selection links.
     */
    public function resetField(string $entity_type_id, string $bundle, string $field_name) {
        // Delete stored field data in case user changes field type.
        $this->tempStore
            ->delete("{$entity_type_id}:{$field_name}");
        return $this->getFieldSelectionLinks($entity_type_id, $bundle);
    }
    
    /**
     * Builds the field selection links.
     *
     * @param string $entity_type_id
     *   The name of the entity type.
     * @param string $bundle
     *   The entity bundle.
     *
     * @return array
     *   The field selection links.
     */
    public function getFieldSelectionLinks(string $entity_type_id, string $bundle) {
        $build = [];
        $this->entityTypeId = $entity_type_id;
        $this->bundle = $bundle;
        $ui_definitions = $this->fieldTypePluginManager
            ->getEntityTypeUiDefinitions($entity_type_id);
        $field_type_options = $unique_definitions = [];
        $grouped_definitions = $this->fieldTypePluginManager
            ->getGroupedDefinitions($ui_definitions, 'label', 'id');
        $category_definitions = $this->fieldTypeCategoryManager
            ->getDefinitions();
        // Invoke a hook to get category properties.
        foreach ($grouped_definitions as $category => $field_types) {
            foreach ($field_types as $name => $field_type) {
                $unique_definitions[$category][$name] = [
                    'unique_identifier' => $name,
                ] + $field_type;
                if ($this->fieldTypeCategoryManager
                    ->hasDefinition($category)) {
                    $category_plugin = $this->fieldTypeCategoryManager
                        ->createInstance($category, $unique_definitions[$category][$name], $category_definitions[$category]);
                    $field_type_options[$category_plugin->getPluginId()] = [
                        'unique_identifier' => $name,
                    ] + $field_type;
                }
                else {
                    $field_type_options[(string) $field_type['label']] = [
                        'unique_identifier' => $name,
                    ] + $field_type;
                }
            }
        }
        $build['add-label'] = [
            '#type' => 'label',
            '#title' => $this->t('Choose a type of field'),
            '#title_display' => 'before',
            '#required' => TRUE,
        ];
        $build['add'] = [
            '#type' => 'container',
            '#attributes' => [
                'class' => 'add-field-container',
            ],
        ];
        $field_type_options_radios = [];
        foreach ($field_type_options as $id => $field_type) {
            
            /** @var \Drupal\Core\Field\FieldTypeCategoryInterface $category_info */
            $category_info = $this->fieldTypeCategoryManager
                ->createInstance($field_type['category'], $field_type);
            $entity_type = $this->entityTypeManager()
                ->getDefinition($this->entityTypeId);
            $display_as_group = !$category_info instanceof FallbackFieldTypeCategory;
            $route_parameters = [
                'entity_type' => $this->entityTypeId,
                'bundle' => $this->bundle,
                'display_as_group' => $display_as_group ? 'true' : 'false',
                'selected_field_type' => $category_info->getPluginId(),
            ] + FieldUI::getRouteBundleParameter($entity_type, $this->bundle);
            $cleaned_class_name = Html::getClass($field_type['unique_identifier']);
            $field_type_options_radios[$id] = [
                '#type' => 'html_tag',
                '#tag' => 'a',
                '#attributes' => [
                    'class' => [
                        'field-option',
                        'use-ajax',
                    ],
                    'role' => 'button',
                    'tabindex' => '0',
                    'data-dialog-type' => 'modal',
                    'data-dialog-options' => Json::encode([
                        'width' => 1100,
                        'title' => $this->t('Add field: @type', [
                            '@type' => $category_info->getLabel(),
                        ]),
                    ]),
                    'href' => Url::fromRoute("field_ui.field_storage_config_add_sub_{$this->entityTypeId}", $route_parameters)
                        ->toString(),
                ],
                '#weight' => $category_info->getWeight(),
                'thumb' => [
                    '#type' => 'container',
                    '#attributes' => [
                        'class' => [
                            'field-option__thumb',
                        ],
                    ],
                    'icon' => [
                        '#type' => 'container',
                        '#attributes' => [
                            'class' => [
                                'field-option__icon',
                                $display_as_group ? "field-icon-{$field_type['category']}" : "field-icon-{$cleaned_class_name}",
                            ],
                        ],
                    ],
                ],
                // Store some data we later need.
'#data' => [
                    '#group_display' => $display_as_group,
                ],
                'words' => [
                    '#type' => 'container',
                    '#attributes' => [
                        'class' => [
                            'field-option__words',
                        ],
                    ],
                    'label' => [
                        '#attributes' => [
                            'class' => [
                                'field-option__label',
                            ],
                        ],
                        '#type' => 'html_tag',
                        '#tag' => 'span',
                        '#value' => $category_info->getLabel(),
                    ],
                    'description' => [
                        '#type' => 'container',
                        '#attributes' => [
                            'class' => [
                                'field-option__description',
                            ],
                        ],
                        '#markup' => $category_info->getDescription(),
                    ],
                ],
            ];
            if ($libraries = $category_info->getLibraries()) {
                $field_type_options_radios[$id]['#attached']['library'] = $libraries;
            }
        }
        uasort($field_type_options_radios, [
            SortArray::class,
            'sortByWeightProperty',
        ]);
        $build['add']['new_storage_type'] = $field_type_options_radios;
        $build['#attached']['library'][] = 'field_ui/drupal.field_ui';
        $build['#attached']['library'][] = 'field_ui/drupal.field_ui.manage_fields';
        $build['#attached']['library'][] = 'core/drupal.dialog.ajax';
        return $build;
    }

}

Classes

Title Deprecated Summary
FieldStorageAddController Controller for building the field type links.

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