ImageFieldCreationTrait.php

Same filename in other branches
  1. 8.9.x core/modules/image/tests/src/Kernel/ImageFieldCreationTrait.php
  2. 10 core/modules/image/tests/src/Kernel/ImageFieldCreationTrait.php
  3. 11.x core/modules/image/tests/src/Kernel/ImageFieldCreationTrait.php

Namespace

Drupal\Tests\image\Kernel

File

core/modules/image/tests/src/Kernel/ImageFieldCreationTrait.php

View source
<?php

namespace Drupal\Tests\image\Kernel;

use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;

/**
 * Provides a helper method for creating Image fields.
 */
trait ImageFieldCreationTrait {
    
    /**
     * Create a new image field.
     *
     * @param string $name
     *   The name of the new field (all lowercase), exclude the "field_" prefix.
     * @param string $type_name
     *   The node type that this field will be added to.
     * @param array $storage_settings
     *   (optional) A list of field storage settings that will be added to the
     *   defaults.
     * @param array $field_settings
     *   (optional) A list of instance settings that will be added to the instance
     *   defaults.
     * @param array $widget_settings
     *   (optional) Widget settings to be added to the widget defaults.
     * @param array $formatter_settings
     *   (optional) Formatter settings to be added to the formatter defaults.
     * @param string $description
     *   (optional) A description for the field. Defaults to ''.
     */
    protected function createImageField($name, $type_name, $storage_settings = [], $field_settings = [], $widget_settings = [], $formatter_settings = [], $description = '') {
        FieldStorageConfig::create([
            'field_name' => $name,
            'entity_type' => 'node',
            'type' => 'image',
            'settings' => $storage_settings,
            'cardinality' => !empty($storage_settings['cardinality']) ? $storage_settings['cardinality'] : 1,
        ])->save();
        $field_config = FieldConfig::create([
            'field_name' => $name,
            'label' => $name,
            'entity_type' => 'node',
            'bundle' => $type_name,
            'required' => !empty($field_settings['required']),
            'settings' => $field_settings,
            'description' => $description,
        ]);
        $field_config->save();
        
        /** @var \Drupal\Core\Entity\EntityDisplayRepositoryInterface $display_repository */
        $display_repository = \Drupal::service('entity_display.repository');
        $display_repository->getFormDisplay('node', $type_name)
            ->setComponent($name, [
            'type' => 'image_image',
            'settings' => $widget_settings,
        ])
            ->save();
        $display_repository->getViewDisplay('node', $type_name)
            ->setComponent($name, [
            'type' => 'image',
            'settings' => $formatter_settings,
        ])
            ->save();
        return $field_config;
    }

}

Traits

Title Deprecated Summary
ImageFieldCreationTrait Provides a helper method for creating Image fields.

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