class EntityDisplayTest

Tests the EntityDisplay configuration entities.

Hierarchy

Expanded class hierarchy of EntityDisplayTest

File

drupal/core/modules/entity/lib/Drupal/entity/Tests/EntityDisplayTest.php, line 15
Contains \Drupal\entity\Tests\EntityDisplayTest.

Namespace

Drupal\entity\Tests
View source
class EntityDisplayTest extends DrupalUnitTestBase {
  public static $modules = array(
    'entity',
    'field',
    'entity_test',
  );
  public static function getInfo() {
    return array(
      'name' => 'Entity display configuration entities',
      'description' => 'Tests the entity display configuration entities.',
      'group' => 'Entity API',
    );
  }
  protected function setUp() {
    parent::setUp();
    $this
      ->installConfig(array(
      'field',
    ));
  }

  /**
   * Tests basic CRUD operations on EntityDisplay objects.
   */
  public function testEntityDisplayCRUD() {
    $display = entity_create('entity_display', array(
      'targetEntityType' => 'entity_test',
      'bundle' => 'entity_test',
      'mode' => 'default',
    ));
    $expected = array();

    // Check that providing no 'weight' results in the highest current weight
    // being assigned.
    $expected['component_1'] = array(
      'weight' => 0,
    );
    $expected['component_2'] = array(
      'weight' => 1,
    );
    $display
      ->setComponent('component_1');
    $display
      ->setComponent('component_2');
    $this
      ->assertEqual($display
      ->getComponent('component_1'), $expected['component_1']);
    $this
      ->assertEqual($display
      ->getComponent('component_2'), $expected['component_2']);

    // Check that arbitrary options are correctly stored.
    $expected['component_3'] = array(
      'weight' => 10,
      'foo' => 'bar',
    );
    $display
      ->setComponent('component_3', $expected['component_3']);
    $this
      ->assertEqual($display
      ->getComponent('component_3'), $expected['component_3']);

    // Check that the display can be properly saved and read back.
    $display
      ->save();
    $display = entity_load('entity_display', $display
      ->id());
    foreach (array(
      'component_1',
      'component_2',
      'component_3',
    ) as $name) {
      $this
        ->assertEqual($display
        ->getComponent($name), $expected[$name]);
    }

    // Check that getComponents() returns options for all components.
    $this
      ->assertEqual($display
      ->getComponents(), $expected);

    // Check that a component can be removed.
    $display
      ->removeComponent('component_3');
    $this
      ->assertNULL($display
      ->getComponent('component_3'));

    // Check that the removal is correctly persisted.
    $display
      ->save();
    $display = entity_load('entity_display', $display
      ->id());
    $this
      ->assertNULL($display
      ->getComponent('component_3'));

    // Check that CreateCopy() creates a new component that can be correclty
    // saved.
    $new_display = $display
      ->createCopy('other_view_mode');
    $new_display
      ->save();
    $new_display = entity_load('entity_display', $new_display
      ->id());
    $this
      ->assertEqual($new_display->targetEntityType, $display->targetEntityType);
    $this
      ->assertEqual($new_display->bundle, $display->bundle);
    $this
      ->assertEqual($new_display->mode, 'other_view_mode');
    $this
      ->assertEqual($new_display
      ->getComponents(), $display
      ->getComponents());
  }

  /**
   * Tests entity_get_display().
   */
  public function testEntityGetDisplay() {

    // Check that entity_get_display() returns a fresh object when no
    // configuration entry exists.
    $display = entity_get_display('entity_test', 'entity_test', 'default');
    $this
      ->assertTrue($display
      ->isNew());

    // Add some components and save the display.
    $display
      ->setComponent('component_1', array(
      'weight' => 10,
    ))
      ->save();

    // Check that entity_get_display() returns the correct object.
    $display = entity_get_display('entity_test', 'entity_test', 'default');
    $this
      ->assertFalse($display
      ->isNew());
    $this
      ->assertEqual($display->id, 'entity_test.entity_test.default');
    $this
      ->assertEqual($display
      ->getComponent('component_1'), array(
      'weight' => 10,
    ));
  }

  /**
   * Tests the behavior of a field component within an EntityDisplay object.
   */
  public function testExtraFieldComponent() {
    $display = entity_create('entity_display', array(
      'targetEntityType' => 'entity_test',
      'bundle' => 'entity_test',
      'mode' => 'default',
    ));

    // Check that the default visibility taken into account for extra fields
    // unknown in the display.
    $this
      ->assertEqual($display
      ->getComponent('display_extra_field'), array(
      'weight' => 5,
    ));
    $this
      ->assertNull($display
      ->getComponent('display_extra_field_hidden'));

    // Check that setting explicit options overrides the defaults.
    $display
      ->removeComponent('display_extra_field');
    $display
      ->setComponent('display_extra_field_hidden', array(
      'weight' => 10,
    ));
    $this
      ->assertNull($display
      ->getComponent('display_extra_field'));
    $this
      ->assertEqual($display
      ->getComponent('display_extra_field_hidden'), array(
      'weight' => 10,
    ));
  }

  /**
   * Tests the behavior of a field component within an EntityDisplay object.
   */
  public function testFieldComponent() {
    $this
      ->enableModules(array(
      'field_sql_storage',
      'field_test',
    ));
    $display = entity_create('entity_display', array(
      'targetEntityType' => 'entity_test',
      'bundle' => 'entity_test',
      'mode' => 'default',
    ));

    // Create a field and an instance.
    $field = array(
      'field_name' => 'test_field',
      'type' => 'test_field',
    );
    field_create_field($field);
    $instance = array(
      'field_name' => $field['field_name'],
      'entity_type' => 'entity_test',
      'bundle' => 'entity_test',
    );
    field_create_instance($instance);

    // Check that providing no options results in default values being used.
    $display
      ->setComponent($field['field_name']);
    $field_type_info = field_info_field_types($field['type']);
    $default_formatter = $field_type_info['default_formatter'];
    $default_settings = field_info_formatter_settings($default_formatter);
    $expected = array(
      'weight' => 0,
      'label' => 'above',
      'type' => $default_formatter,
      'settings' => $default_settings,
    );
    $this
      ->assertEqual($display
      ->getComponent($field['field_name']), $expected);

    // Check that the getFormatter() method returns the correct formatter plugin.
    $formatter = $display
      ->getFormatter($field['field_name']);
    $this
      ->assertEqual($formatter
      ->getPluginId(), $default_formatter);
    $this
      ->assertEqual($formatter
      ->getSettings(), $default_settings);

    // Check that the formatter is statically persisted, by assigning an
    // arbitrary property and reading it back.
    $random_value = $this
      ->randomString();
    $formatter->randomValue = $random_value;
    $formatter = $display
      ->getFormatter($field['field_name']);
    $this
      ->assertEqual($formatter->randomValue, $random_value);

    // Check that changing the definition creates a new formatter.
    $display
      ->setComponent($field['field_name'], array(
      'type' => 'field_test_multiple',
    ));
    $formatter = $display
      ->getFormatter($field['field_name']);
    $this
      ->assertEqual($formatter
      ->getPluginId(), 'field_test_multiple');
    $this
      ->assertFalse(isset($formatter->randomValue));

    // Check that specifying an unknown formatter (e.g. case of a disabled
    // module) gets stored as is in the display, but results in the default
    // formatter being used.
    $display
      ->setComponent($field['field_name'], array(
      'type' => 'unknown_formatter',
    ));
    $options = $display
      ->getComponent($field['field_name']);
    $this
      ->assertEqual($options['type'], 'unknown_formatter');
    $formatter = $display
      ->getFormatter($field['field_name']);
    $this
      ->assertEqual($formatter
      ->getPluginId(), $default_formatter);
  }

  /**
   * Tests renaming and deleting a bundle.
   */
  public function testRenameDeleteBundle() {
    $this
      ->enableModules(array(
      'field_sql_storage',
      'field_test',
      'node',
      'system',
    ));
    $this
      ->installSchema('node', array(
      'node_type',
    ));
    $this
      ->installSchema('system', array(
      'variable',
    ));

    // Create a node bundle and display object.
    node_type_save((object) array(
      'type' => 'article',
    ));
    entity_get_display('node', 'article', 'default')
      ->save();

    // Rename the article bundle and assert the entity display is renamed.
    $info = node_type_load('article');
    $info->old_type = 'article';
    $info->type = 'article_rename';
    node_type_save($info);
    $old_display = entity_load('entity_display', 'node.article.default');
    $this
      ->assertFalse($old_display);
    $new_display = entity_load('entity_display', 'node.article_rename.default');
    $this
      ->assertEqual('article_rename', $new_display->bundle);
    $this
      ->assertEqual('node.article_rename.default', $new_display->id);

    // Delete the bundle.
    node_type_delete('article_rename');
    $display = entity_load('entity_display', 'node.article_rename.default');
    $this
      ->assertFalse($display);
  }

  /**
   * Tests deleting field instance.
   */
  public function testDeleteFieldInstance() {
    $this
      ->enableModules(array(
      'field_sql_storage',
      'field_test',
    ));

    // Create a field and an instance.
    $field = entity_create('field_entity', array(
      'field_name' => 'test_field',
      'type' => 'test_field',
    ));
    $field
      ->save();
    $instance = entity_create('field_instance', array(
      'field_name' => $field['field_name'],
      'entity_type' => 'entity_test',
      'bundle' => 'entity_test',
    ));
    $instance
      ->save();

    // Create an entity display.
    $display = entity_create('entity_display', array(
      'targetEntityType' => 'entity_test',
      'bundle' => 'entity_test',
      'viewMode' => 'default',
    ))
      ->setComponent($field['field_name'])
      ->save();

    // Delete the instance.
    $instance
      ->delete();

    // Check that the component has been removed from the entity display.
    $display = entity_get_display('entity_test', 'entity_test', 'default');
    $this
      ->assertFalse($display
      ->getComponent($field['field_name']));
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DrupalUnitTestBase::$keyValueFactory protected property A KeyValueMemoryFactory instance to use when building the container.
DrupalUnitTestBase::$moduleFiles private property
DrupalUnitTestBase::$themeData private property
DrupalUnitTestBase::$themeFiles private property
DrupalUnitTestBase::containerBuild public function Sets up the base service container for this test. 1
DrupalUnitTestBase::disableModules protected function Disables modules for this test.
DrupalUnitTestBase::enableModules protected function Enables modules for this test.
DrupalUnitTestBase::installConfig protected function Installs default configuration for a given list of modules.
DrupalUnitTestBase::installSchema protected function Installs a specific table from a module schema definition.
DrupalUnitTestBase::tearDown protected function Deletes created files, database tables, and reverts all environment changes. Overrides TestBase::tearDown 2
DrupalUnitTestBase::__construct function Overrides \Drupal\simpletest\UnitTestBase::__construct(). Overrides UnitTestBase::__construct
EntityDisplayTest::$modules public static property Modules to enable. Overrides DrupalUnitTestBase::$modules
EntityDisplayTest::getInfo public static function
EntityDisplayTest::setUp protected function Sets up Drupal unit test environment. Overrides DrupalUnitTestBase::setUp
EntityDisplayTest::testDeleteFieldInstance public function Tests deleting field instance.
EntityDisplayTest::testEntityDisplayCRUD public function Tests basic CRUD operations on EntityDisplay objects.
EntityDisplayTest::testEntityGetDisplay public function Tests entity_get_display().
EntityDisplayTest::testExtraFieldComponent public function Tests the behavior of a field component within an EntityDisplay object.
EntityDisplayTest::testFieldComponent public function Tests the behavior of a field component within an EntityDisplay object.
EntityDisplayTest::testRenameDeleteBundle public function Tests renaming and deleting a bundle.
TestBase::$assertions protected property Assertions thrown in that test case.
TestBase::$configImporter protected property The config importer that can used in a test. 1
TestBase::$container protected property The dependency injection container used in the test. 1
TestBase::$databasePrefix protected property The database prefix of this test run.
TestBase::$dieOnFail public property Whether to die in case any test assertion fails.
TestBase::$originalFileDirectory protected property The original file directory, before it was changed for testing purposes.
TestBase::$originalPrefix protected property The original database prefix when running inside Simpletest.
TestBase::$originalSettings protected property The settings array.
TestBase::$public_files_directory protected property The public file directory for the test environment.
TestBase::$results public property Current results of this test case.
TestBase::$setup protected property Flag to indicate whether the test has been set up.
TestBase::$setupDatabasePrefix protected property
TestBase::$setupEnvironment protected property
TestBase::$skipClasses protected property This class is skipped when looking for the source of an assertion.
TestBase::$testId protected property The test run ID.
TestBase::$timeLimit protected property Time limit for the test.
TestBase::$verbose protected property TRUE if verbose debugging is enabled.
TestBase::$verboseClassName protected property Safe class name for use in verbose output filenames.
TestBase::$verboseDirectory protected property Directory where verbose output files are put.
TestBase::$verboseDirectoryUrl protected property URL to the verbose output file directory.
TestBase::$verboseId protected property Incrementing identifier for verbose output filenames.
TestBase::assert protected function Internal helper: stores the assert.
TestBase::assertEqual protected function Check to see if two values are equal.
TestBase::assertFalse protected function Check to see if a value is false (an empty string, 0, NULL, or FALSE).
TestBase::assertIdentical protected function Check to see if two values are identical.
TestBase::assertIdenticalObject protected function Checks to see if two objects are identical.
TestBase::assertNotEqual protected function Check to see if two values are not equal.
TestBase::assertNotIdentical protected function Check to see if two values are not identical.
TestBase::assertNotNull protected function Check to see if a value is not NULL.
TestBase::assertNull protected function Check to see if a value is NULL.
TestBase::assertTrue protected function Check to see if a value is not false (not an empty string, 0, NULL, or FALSE).
TestBase::changeDatabasePrefix protected function Changes the database connection to the prefixed one.
TestBase::checkRequirements protected function Checks the matching requirements for Test. 4
TestBase::configImporter public function Returns a ConfigImporter object to import test importing of configuration. 1
TestBase::copyConfig public function Copies configuration objects from source storage to target storage.
TestBase::deleteAssert public static function Delete an assertion record by message ID.
TestBase::error protected function Fire an error assertion. 1
TestBase::errorHandler public function Handle errors during test runs.
TestBase::exceptionHandler protected function Handle exceptions.
TestBase::fail protected function Fire an assertion that is always negative.
TestBase::filePreDeleteCallback public static function Ensures test files are deletable within file_unmanaged_delete_recursive().
TestBase::generatePermutations public static function Converts a list of possible parameters into a stack of permutations.
TestBase::getAssertionCall protected function Cycles through backtrace until the first non-assertion method is found.
TestBase::getDatabaseConnection public static function Returns the database connection to the site running Simpletest.
TestBase::insertAssert public static function Store an assertion from outside the testing context.
TestBase::pass protected function Fire an assertion that is always positive.
TestBase::prepareConfigDirectories protected function Create and set new configuration directories. 1
TestBase::prepareDatabasePrefix protected function Generates a database prefix for running tests.
TestBase::prepareEnvironment protected function Prepares the current environment for running the test.
TestBase::randomName public static function Generates a random string containing letters and numbers.
TestBase::randomObject public static function Generates a random PHP object.
TestBase::randomString public static function Generates a random string of ASCII characters of codes 32 to 126.
TestBase::rebuildContainer protected function Rebuild drupal_container(). 1
TestBase::run public function Run all tests in this class.
TestBase::settingsSet protected function Changes in memory settings.
TestBase::verbose protected function Logs verbose message in a text file.
UnitTestBase::$configDirectories protected property