AddToAllBundlesConfigActionTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\field\Kernel;

use Drupal\Component\Plugin\Exception\PluginNotFoundException;
use Drupal\Core\Config\Action\ConfigActionException;
use Drupal\Core\Entity\EntityFieldManagerInterface;
use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\Recipe\RecipeRunner;
use Drupal\field\Entity\FieldConfig;
use Drupal\FunctionalTests\Core\Recipe\RecipeTestTrait;
use Drupal\KernelTests\KernelTestBase;
use Drupal\node\Entity\NodeType;

/**
 * @covers \Drupal\field\Plugin\ConfigAction\AddToAllBundles
 *
 * @group Recipe
 * @group field
 */
class AddToAllBundlesConfigActionTest extends KernelTestBase {
  use RecipeTestTrait;
  
  /**
   * {@inheritdoc}
   */
  protected static $modules = [
    'field',
    'node',
    'system',
    'text',
    'user',
  ];
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    NodeType::create([
      'type' => 'one',
      'name' => 'One',
    ])->save();
    NodeType::create([
      'type' => 'two',
      'name' => 'Two',
    ])->save();
  }
  
  /**
   * Tests instantiating a field on all bundles of an entity type.
   */
  public function testInstantiateNewFieldOnAllBundles() : void {
    // Ensure the body field doesn't actually exist yet.
    $storage_definitions = $this->container
      ->get(EntityFieldManagerInterface::class)
      ->getFieldStorageDefinitions('node');
    $this->assertArrayNotHasKey('body', $storage_definitions);
    $this->applyAction('field.storage.node.body');
    // Fields and expected data exist.
    /** @var \Drupal\field\FieldConfigInterface[] $body_fields */
    $body_fields = $this->container
      ->get(EntityTypeManagerInterface::class)
      ->getStorage('field_config')
      ->loadByProperties([
      'entity_type' => 'node',
      'field_name' => 'body',
    ]);
    ksort($body_fields);
    $this->assertSame([
      'node.one.body',
      'node.two.body',
    ], array_keys($body_fields));
    foreach ($body_fields as $field) {
      $this->assertSame('Body field label', $field->label());
      $this->assertSame('Set by config actions.', $field->getDescription());
    }
    // Expect an error when the 'addToAllBundles' action is invoked on anything
    // other than a field storage config entity.
    $this->expectException(PluginNotFoundException::class);
    $this->expectExceptionMessage('The "user_role" entity does not support the "addToAllBundles" config action.');
    $this->applyAction('user.role.anonymous');
  }
  
  /**
   * Tests that the action can be set to fail if the field already exists.
   */
  public function testFailIfExists() : void {
    $this->installConfig('node');
    node_add_body_field(NodeType::load('one'));
    $this->expectException(ConfigActionException::class);
    $this->expectExceptionMessage('Field node.one.body already exists.');
    $this->applyAction('field.storage.node.body', TRUE);
  }
  
  /**
   * Tests that the action will ignore existing fields by default.
   */
  public function testIgnoreExistingFields() : void {
    $this->installConfig('node');
    node_add_body_field(NodeType::load('one'))->setLabel('Original label')
      ->setDescription('Original description')
      ->save();
    $this->applyAction('field.storage.node.body');
    // The existing field should not be changed.
    $field = FieldConfig::loadByName('node', 'one', 'body');
    $this->assertInstanceOf(FieldConfig::class, $field);
    $this->assertSame('Original label', $field->label());
    $this->assertSame('Original description', $field->getDescription());
    // But the new field should be created as expected.
    $field = FieldConfig::loadByName('node', 'two', 'body');
    $this->assertInstanceOf(FieldConfig::class, $field);
    $this->assertSame('Body field label', $field->label());
    $this->assertSame('Set by config actions.', $field->getDescription());
  }
  
  /**
   * Applies a recipe with the addToAllBundles action.
   *
   * @param string $config_name
   *   The name of the config object which should run the addToAllBundles
   *   action.
   * @param bool $fail_if_exists
   *   (optional) Whether the action should fail if the field already exists on
   *   any bundle. Defaults to FALSE.
   */
  private function applyAction(string $config_name, bool $fail_if_exists = FALSE) : void {
    $fail_if_exists = var_export($fail_if_exists, TRUE);
    $contents = <<<YAML
name: Instantiate field on all bundles
config:
  import:
    node:
      - field.storage.node.body
  actions:
    {<span class="php-variable">$config_name</span>}:
      addToAllBundles:
        label: Body field label
        description: Set by config actions.
        fail_if_exists: {<span class="php-variable">$fail_if_exists</span>}
YAML;
    $recipe = $this->createRecipe($contents);
    RecipeRunner::processRecipe($recipe);
  }

}