DisplayEntityReferenceTest.php in Drupal 9

Namespace

Drupal\Tests\views\Functional\Plugin

File

core/modules/views/tests/src/Functional/Plugin/DisplayEntityReferenceTest.php

<?php

namespace Drupal\Tests\views\Functional\Plugin;

use Drupal\entity_test\Entity\EntityTest;
use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;
use Drupal\Tests\field\Traits\EntityReferenceTestTrait;
use Drupal\Tests\views\Functional\ViewTestBase;
use Drupal\views\Views;

/**
 * Tests the entity reference display plugin.
 *
 * @group views
 *
 * @see \Drupal\views\Plugin\views\display\EntityReference
 */
class DisplayEntityReferenceTest extends ViewTestBase {
  use EntityReferenceTestTrait;

  /**
   * Views used by this test.
   *
   * @var array
   */
  public static $testViews = [
    'test_display_entity_reference',
  ];

  /**
   * Modules to enable.
   *
   * @var array
   */
  protected static $modules = [
    'entity_test',
    'field',
    'views_ui',
  ];

  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';

  /**
   * The used field name in the test.
   *
   * @var string
   */
  protected $fieldName;

  /**
   * The used entity reference field name in the test.
   *
   * @var string
   */
  protected $entityRefFieldName;

  /**
   * The field storage.
   *
   * @var \Drupal\field\Entity\FieldStorageConfig
   */
  protected $fieldStorage;

  /**
   * The field config.
   *
   * @var \Drupal\field\Entity\FieldConfig
   */
  protected $field;

  /**
   * {@inheritdoc}
   */
  protected function setUp($import_test_views = TRUE) : void {
    parent::setUp($import_test_views);
    $this
      ->drupalLogin($this
      ->drupalCreateUser([
      'administer views',
    ]));

    // Create the text field.
    $this->fieldName = 'field_test_entity_ref_display';
    $this->fieldStorage = FieldStorageConfig::create([
      'field_name' => $this->fieldName,
      'entity_type' => 'entity_test',
      'type' => 'text',
    ]);
    $this->fieldStorage
      ->save();

    // Create an instance of the text field on the content type.
    $this->field = FieldConfig::create([
      'field_storage' => $this->fieldStorage,
      'bundle' => 'entity_test',
    ]);
    $this->field
      ->save();

    // Add an entity reference field to reference the same base table.
    $this->entityRefFieldName = 'field_test_entity_ref_entity_ref';
    $this
      ->createEntityReferenceField('entity_test', 'entity_test', $this->entityRefFieldName, NULL, 'entity_test');

    // Create some entities to search. Add a common string to the name and
    // the text field in two entities so we can test that we can search in both.
    for ($i = 0; $i < 5; $i++) {
      EntityTest::create([
        'bundle' => 'entity_test',
        'name' => 'name' . $i,
        $this->fieldName => 'text',
      ])
        ->save();
      EntityTest::create([
        'bundle' => 'entity_test',
        'name' => 'name',
        $this->fieldName => 'text' . $i,
      ])
        ->save();
    }
    EntityTest::create([
      'bundle' => 'entity_test',
      'name' => 'name',
      $this->fieldName => 'tex',
    ])
      ->save();
    EntityTest::create([
      'bundle' => 'entity_test',
      'name' => 'name',
      $this->fieldName => 'TEX',
    ])
      ->save();
    EntityTest::create([
      'bundle' => 'entity_test',
      'name' => 'name',
      $this->fieldName => 'sometext',
    ])
      ->save();
  }

  /**
   * Tests the entity reference display plugin.
   */
  public function testEntityReferenceDisplay() {

    // Test that the 'title' settings are not shown.
    $this
      ->drupalGet('admin/structure/views/view/test_display_entity_reference/edit/entity_reference_1');
    $this
      ->assertSession()
      ->linkByHrefNotExists('admin/structure/views/nojs/display/test_display_entity_reference/entity_reference_1/title');

    // Add the new field to the fields.
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_display_entity_reference/default/field');
    $this
      ->submitForm([
      'name[entity_test__' . $this->fieldName . '.' . $this->fieldName . ']' => TRUE,
    ], 'Add and configure fields');
    $this
      ->submitForm([], 'Apply');

    // Test that the right fields are shown on the display settings form.
    $this
      ->drupalGet('admin/structure/views/nojs/display/test_display_entity_reference/entity_reference_1/style_options');
    $this
      ->assertSession()
      ->pageTextContains('Test entity: Name');
    $this
      ->assertSession()
      ->pageTextContains('Test entity: ' . $this->field
      ->label());

    // Add the new field to the search fields.
    $this
      ->submitForm([
      'style_options[search_fields][' . $this->fieldName . ']' => $this->fieldName,
    ], 'Apply');
    $this
      ->submitForm([], 'Save');
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');

    // Add the required settings to test a search operation.
    $options = [
      'match' => '1',
      'match_operator' => 'CONTAINS',
      'limit' => 0,
      'ids' => NULL,
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);

    // Test that we have searched in both fields.
    $this
      ->assertCount(2, $view->result, 'Search returned two rows');
    $view
      ->destroy();

    // Test the 'CONTAINS' match_operator.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');
    $options = [
      'match' => 'tex',
      'match_operator' => 'CONTAINS',
      'limit' => 0,
      'ids' => NULL,
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);
    $this
      ->assertCount(13, $view->result, 'Search returned thirteen rows');
    $view
      ->destroy();

    // Test the 'STARTS_WITH' match_operator.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');
    $options = [
      'match' => 'tex',
      'match_operator' => 'STARTS_WITH',
      'limit' => 0,
      'ids' => NULL,
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);
    $this
      ->assertCount(12, $view->result, 'Search returned twelve rows');
    $view
      ->destroy();

    // Test the '=' match_operator.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');
    $options = [
      'match' => 'tex',
      'match_operator' => '=',
      'limit' => 0,
      'ids' => NULL,
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);
    $this
      ->assertCount(2, $view->result, 'Search returned two rows');
    $view
      ->destroy();

    // Add a relationship and a field using that relationship.
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_display_entity_reference/default/relationship');
    $this
      ->submitForm([
      'name[entity_test.user_id]' => TRUE,
    ], 'Add and configure relationships');
    $this
      ->submitForm([], 'Apply');
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_display_entity_reference/default/field');
    $this
      ->submitForm([
      'name[users_field_data.uid]' => TRUE,
    ], 'Add and configure fields');
    $this
      ->submitForm([], 'Apply');

    // Add the new field to the search fields.
    $this
      ->drupalGet('admin/structure/views/nojs/display/test_display_entity_reference/entity_reference_1/style_options');
    $this
      ->submitForm([
      'style_options[search_fields][uid]' => 'uid',
    ], 'Apply');
    $this
      ->submitForm([], 'Save');

    // Test that the search still works with the related field.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');

    // Add the required settings to test a search operation.
    $options = [
      'match' => '2',
      'match_operator' => 'CONTAINS',
      'limit' => 0,
      'ids' => NULL,
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);

    // Run validation when using a relationship to the same base table.
    $this
      ->assertCount(2, $view->result, 'Search returned two rows');
    $view
      ->destroy();
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_display_entity_reference/default/relationship');
    $this
      ->submitForm([
      'name[entity_test__field_test_entity_ref_entity_ref.field_test_entity_ref_entity_ref]' => TRUE,
    ], 'Add and configure relationships');
    $this
      ->submitForm([], 'Apply');
    $this
      ->submitForm([], 'Save');

    // Test that the search still works with the related field.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');

    // Add IDs to trigger validation.
    $options = [
      'match' => '1',
      'match_operator' => 'CONTAINS',
      'limit' => 0,
      'ids' => [
        1,
        2,
      ],
    ];
    $view->display_handler
      ->setOption('entity_reference_options', $options);
    $this
      ->executeView($view);
    $this
      ->assertCount(2, $view->result, 'Search returned two rows');

    // Test that the render() return empty array for empty result.
    $view = Views::getView('test_display_entity_reference');
    $view
      ->setDisplay('entity_reference_1');
    $render = $view->display_handler
      ->render();
    $this
      ->assertSame([], $render, 'Render returned empty array');
  }

}

Classes

Name	Description
DisplayEntityReferenceTest	Tests the entity reference display plugin.