HandlerTest.php in Drupal 8

Namespace

Drupal\Tests\views_ui\Functional

File

core/modules/views_ui/tests/src/Functional/HandlerTest.php

<?php

namespace Drupal\Tests\views_ui\Functional;

use Drupal\Component\Render\FormattableMarkup;
use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;
use Drupal\views\Tests\ViewTestData;
use Drupal\views\ViewExecutable;

/**
 * Tests handler UI for views.
 *
 * @group views_ui
 * @see \Drupal\views\Plugin\views\HandlerBase
 */
class HandlerTest extends UITestBase {

  /**
   * {@inheritdoc}
   */
  public static $modules = [
    'node_test_views',
  ];

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

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

  /**
   * {@inheritdoc}
   */
  protected function setUp($import_test_views = TRUE) {
    parent::setUp($import_test_views);
    $this
      ->placeBlock('page_title_block');
    ViewTestData::createTestViews(get_class($this), [
      'node_test_views',
    ]);
  }

  /**
   * Overrides \Drupal\views\Tests\ViewTestBase::schemaDefinition().
   *
   * Adds a uid column to test the relationships.
   *
   * @internal
   */
  protected function schemaDefinition() {
    $schema = parent::schemaDefinition();
    $schema['views_test_data']['fields']['uid'] = [
      'description' => "The {users}.uid of the author of the beatle entry.",
      'type' => 'int',
      'unsigned' => TRUE,
      'not null' => TRUE,
      'default' => 0,
    ];
    return $schema;
  }

  /**
   * Overrides \Drupal\views\Tests\ViewTestBase::viewsData().
   *
   * Adds:
   * - a relationship for the uid column.
   * - a dummy field with no help text.
   */
  protected function viewsData() {
    $data = parent::viewsData();
    $data['views_test_data']['uid'] = [
      'title' => t('UID'),
      'help' => t('The test data UID'),
      'relationship' => [
        'id' => 'standard',
        'base' => 'users_field_data',
        'base field' => 'uid',
      ],
    ];

    // Create a dummy field with no help text.
    $data['views_test_data']['no_help'] = $data['views_test_data']['name'];
    $data['views_test_data']['no_help']['field']['title'] = t('No help');
    $data['views_test_data']['no_help']['field']['real field'] = 'name';
    unset($data['views_test_data']['no_help']['help']);
    return $data;
  }

  /**
   * Tests UI CRUD.
   */
  public function testUICRUD() {
    $handler_types = ViewExecutable::getHandlerTypes();
    foreach ($handler_types as $type => $type_info) {

      // Test adding handlers.
      $add_handler_url = "admin/structure/views/nojs/add-handler/test_view_empty/default/{$type}";

      // Area handler types need to use a different handler.
      if (in_array($type, [
        'header',
        'footer',
        'empty',
      ])) {
        $this
          ->drupalPostForm($add_handler_url, [
          'name[views.area]' => TRUE,
        ], t('Add and configure @handler', [
          '@handler' => $type_info['ltitle'],
        ]));
        $id = 'area';
        $edit_handler_url = "admin/structure/views/nojs/handler/test_view_empty/default/{$type}/{$id}";
      }
      elseif ($type == 'relationship') {
        $this
          ->drupalPostForm($add_handler_url, [
          'name[views_test_data.uid]' => TRUE,
        ], t('Add and configure @handler', [
          '@handler' => $type_info['ltitle'],
        ]));
        $id = 'uid';
        $edit_handler_url = "admin/structure/views/nojs/handler/test_view_empty/default/{$type}/{$id}";
      }
      else {
        $this
          ->drupalPostForm($add_handler_url, [
          'name[views_test_data.job]' => TRUE,
        ], t('Add and configure @handler', [
          '@handler' => $type_info['ltitle'],
        ]));
        $id = 'job';
        $edit_handler_url = "admin/structure/views/nojs/handler/test_view_empty/default/{$type}/{$id}";
      }
      $this
        ->assertUrl($edit_handler_url, [], 'The user got redirected to the handler edit form.');
      $random_label = $this
        ->randomMachineName();
      $this
        ->drupalPostForm(NULL, [
        'options[admin_label]' => $random_label,
      ], t('Apply'));
      $this
        ->assertUrl('admin/structure/views/view/test_view_empty/edit/default', [], 'The user got redirected to the views edit form.');
      $this
        ->assertLinkByHref($edit_handler_url, 0, 'The handler edit link appears in the UI.');
      $links = $this
        ->xpath('//a[starts-with(normalize-space(text()), :label)]', [
        ':label' => $random_label,
      ]);
      $this
        ->assertTrue(isset($links[0]), 'The handler edit link has the right label');

      // Save the view and have a look whether the handler was added as expected.
      $this
        ->drupalPostForm(NULL, [], t('Save'));
      $view = $this->container
        ->get('entity_type.manager')
        ->getStorage('view')
        ->load('test_view_empty');
      $display = $view
        ->getDisplay('default');
      $this
        ->assertTrue(isset($display['display_options'][$type_info['plural']][$id]), 'Ensure the field was added to the view itself.');

      // Remove the item and check that it's removed
      $this
        ->drupalPostForm($edit_handler_url, [], t('Remove'));
      $this
        ->assertNoLinkByHref($edit_handler_url, 0, 'The handler edit link does not appears in the UI after removing.');
      $this
        ->drupalPostForm(NULL, [], t('Save'));
      $view = $this->container
        ->get('entity_type.manager')
        ->getStorage('view')
        ->load('test_view_empty');
      $display = $view
        ->getDisplay('default');
      $this
        ->assertFalse(isset($display['display_options'][$type_info['plural']][$id]), 'Ensure the field was removed from the view itself.');
    }

    // Test adding a field of the user table using the uid relationship.
    $type_info = $handler_types['relationship'];
    $add_handler_url = "admin/structure/views/nojs/add-handler/test_view_empty/default/relationship";
    $this
      ->drupalPostForm($add_handler_url, [
      'name[views_test_data.uid]' => TRUE,
    ], t('Add and configure @handler', [
      '@handler' => $type_info['ltitle'],
    ]));
    $add_handler_url = "admin/structure/views/nojs/add-handler/test_view_empty/default/field";
    $type_info = $handler_types['field'];
    $this
      ->drupalPostForm($add_handler_url, [
      'name[users_field_data.name]' => TRUE,
    ], t('Add and configure @handler', [
      '@handler' => $type_info['ltitle'],
    ]));
    $id = 'name';
    $edit_handler_url = "admin/structure/views/nojs/handler/test_view_empty/default/field/{$id}";
    $this
      ->assertUrl($edit_handler_url, [], 'The user got redirected to the handler edit form.');
    $this
      ->assertFieldByName('options[relationship]', 'uid', 'Ensure the relationship select is filled with the UID relationship.');
    $this
      ->drupalPostForm(NULL, [], t('Apply'));
    $this
      ->drupalPostForm(NULL, [], t('Save'));
    $view = $this->container
      ->get('entity_type.manager')
      ->getStorage('view')
      ->load('test_view_empty');
    $display = $view
      ->getDisplay('default');
    $this
      ->assertTrue(isset($display['display_options'][$type_info['plural']][$id]), 'Ensure the field was added to the view itself.');
  }

  /**
   * Tests escaping of field labels in help text.
   */
  public function testHandlerHelpEscaping() {

    // Setup a field with two instances using a different label.
    // Ensure that the label is escaped properly.
    $this
      ->drupalCreateContentType([
      'type' => 'article',
    ]);
    $this
      ->drupalCreateContentType([
      'type' => 'page',
    ]);
    FieldStorageConfig::create([
      'field_name' => 'field_test',
      'entity_type' => 'node',
      'type' => 'string',
    ])
      ->save();
    FieldConfig::create([
      'field_name' => 'field_test',
      'entity_type' => 'node',
      'bundle' => 'page',
      'label' => 'The giraffe" label',
    ])
      ->save();
    FieldConfig::create([
      'field_name' => 'field_test',
      'entity_type' => 'node',
      'bundle' => 'article',
      'label' => 'The <em>giraffe"</em> label <script>alert("the return of the xss")</script>',
    ])
      ->save();
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/content/default/field');
    $this
      ->assertEscaped('The <em>giraffe"</em> label <script>alert("the return of the xss")</script>');
    $this
      ->assertEscaped('Appears in: page, article. Also known as: Content: The giraffe" label');
  }

  /**
   * Tests broken handlers.
   */
  public function testBrokenHandlers() {
    $handler_types = ViewExecutable::getHandlerTypes();
    foreach ($handler_types as $type => $type_info) {
      $this
        ->drupalGet('admin/structure/views/view/test_view_broken/edit');
      $href = "admin/structure/views/nojs/handler/test_view_broken/default/{$type}/id_broken";
      $result = $this
        ->xpath('//a[contains(@href, :href)]', [
        ':href' => $href,
      ]);
      $this
        ->assertCount(1, $result, new FormattableMarkup('Handler (%type) edit link found.', [
        '%type' => $type,
      ]));
      $text = 'Broken/missing handler';
      $this
        ->assertIdentical($result[0]
        ->getText(), $text, 'Ensure the broken handler text was found.');
      $this
        ->drupalGet($href);
      $result = $this
        ->xpath('//h1[@class="page-title"]');
      $this
        ->assertStringContainsString($text, $result[0]
        ->getText(), 'Ensure the broken handler text was found.');
      $original_configuration = [
        'field' => 'id_broken',
        'id' => 'id_broken',
        'relationship' => 'none',
        'table' => 'views_test_data',
        'plugin_id' => 'numeric',
      ];
      foreach ($original_configuration as $key => $value) {
        $this
          ->assertText(new FormattableMarkup('@key: @value', [
          '@key' => $key,
          '@value' => $value,
        ]));
      }
    }
  }

  /**
   * Ensures that neither node type or node ID appears multiple times.
   *
   * @see \Drupal\views\EntityViewsData
   */
  public function testNoDuplicateFields() {
    $handler_types = [
      'field',
      'filter',
      'sort',
      'argument',
    ];
    foreach ($handler_types as $handler_type) {
      $add_handler_url = 'admin/structure/views/nojs/add-handler/test_node_view/default/' . $handler_type;
      $this
        ->drupalGet($add_handler_url);
      $this
        ->assertNoDuplicateField('ID', 'Content');
      $this
        ->assertNoDuplicateField('ID', 'Content revision');
      $this
        ->assertNoDuplicateField('Content type', 'Content');
      $this
        ->assertNoDuplicateField('UUID', 'Content');
      $this
        ->assertNoDuplicateField('Revision ID', 'Content');
      $this
        ->assertNoDuplicateField('Revision ID', 'Content revision');
    }
  }

  /**
   * Ensures that no missing help text is shown.
   *
   * @see \Drupal\views\EntityViewsData
   */
  public function testErrorMissingHelp() {

    // Test that the error message is not shown for entity fields but an empty
    // description field is shown instead.
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_node_view/default/field');
    $this
      ->assertNoText('Error: missing help');
    $this
      ->assertRaw('<td class="description"></td>', 'Empty description found');

    // Test that no error message is shown for other fields.
    $this
      ->drupalGet('admin/structure/views/nojs/add-handler/test_view_empty/default/field');
    $this
      ->assertNoText('Error: missing help');
  }

  /**
   * Asserts that fields only appear once.
   *
   * @param string $field_name
   *   The field name.
   * @param string $entity_type
   *   The entity type to which the field belongs.
   */
  public function assertNoDuplicateField($field_name, $entity_type) {
    $elements = $this
      ->xpath('//td[.=:entity_type]/preceding-sibling::td[@class="title" and .=:title]', [
      ':title' => $field_name,
      ':entity_type' => $entity_type,
    ]);
    $this
      ->assertCount(1, $elements, $field_name . ' appears just once in ' . $entity_type . '.');
  }

}

Classes

Name	Description
HandlerTest	Tests handler UI for views.