ExposedFormUITest.php in Drupal 8

Namespace

Drupal\Tests\views_ui\Functional

File

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

<?php

namespace Drupal\Tests\views_ui\Functional;

use Drupal\views\Entity\View;

/**
 * Tests exposed forms UI functionality.
 *
 * @group views_ui
 */
class ExposedFormUITest extends UITestBase {

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

  /**
   * {@inheritdoc}
   */
  public static $modules = [
    'node',
    'views_ui',
    'block',
    'taxonomy',
    'field_ui',
    'datetime',
  ];

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

  /**
   * Array of error message strings raised by the grouped form.
   *
   * @var array
   *
   * @see FilterPluginBase::buildGroupValidate
   */
  protected $groupFormUiErrors = [];
  protected function setUp($import_test_views = TRUE) {
    parent::setUp($import_test_views);
    $this
      ->drupalCreateContentType([
      'type' => 'article',
    ]);
    $this
      ->drupalCreateContentType([
      'type' => 'page',
    ]);

    // Create some random nodes.
    for ($i = 0; $i < 5; $i++) {
      $this
        ->drupalCreateNode();
    }

    // Error strings used in the grouped filter form validation.
    $this->groupFormUiErrors['missing_value'] = t('A value is required if the label for this item is defined.');
    $this->groupFormUiErrors['missing_title'] = t('A label is required if the value for this item is defined.');
    $this->groupFormUiErrors['missing_title_empty_operator'] = t('A label is required for the specified operator.');
  }

  /**
   * Tests the admin interface of exposed filter and sort items.
   */
  public function testExposedAdminUi() {
    $edit = [];
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');

    // Be sure that the button is called exposed.
    $this
      ->helperButtonHasLabel('edit-options-expose-button-button', 'Expose filter');

    // The first time the filter UI is displayed, the operator and the
    // value forms should be shown.
    $this
      ->assertFieldById('edit-options-operator-in', 'in', 'Operator In exists');
    $this
      ->assertFieldById('edit-options-operator-not-in', 'not in', 'Operator Not In exists');
    $this
      ->assertFieldById('edit-options-value-page', '', 'Checkbox for Page exists');
    $this
      ->assertFieldById('edit-options-value-article', '', 'Checkbox for Article exists');

    // Click the Expose filter button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', $edit, t('Expose filter'));

    // Check the label of the expose button.
    $this
      ->helperButtonHasLabel('edit-options-expose-button-button', 'Hide filter');

    // After exposing the filter, Operator and Value should be still here.
    $this
      ->assertFieldById('edit-options-operator-in', 'in', 'Operator In exists');
    $this
      ->assertFieldById('edit-options-operator-not-in', 'not in', 'Operator Not In exists');
    $this
      ->assertFieldById('edit-options-value-page', '', 'Checkbox for Page exists');
    $this
      ->assertFieldById('edit-options-value-article', '', 'Checkbox for Article exists');

    // Check the validations of the filter handler.
    $edit = [];
    $edit['options[expose][identifier]'] = '';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertText(t('The identifier is required if the filter is exposed.'));
    $edit = [];
    $edit['options[expose][identifier]'] = 'value';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertText(t('This identifier is not allowed.'));

    // Now check the sort criteria.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/sort/created');
    $this
      ->helperButtonHasLabel('edit-options-expose-button-button', 'Expose sort');
    $this
      ->assertNoFieldById('edit-options-expose-label', '', 'Make sure no label field is shown');

    // Un-expose the filter.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $this
      ->drupalPostForm(NULL, [], t('Hide filter'));

    // After Un-exposing the filter, Operator and Value should be shown again.
    $this
      ->assertFieldById('edit-options-operator-in', 'in', 'Operator In exists after hide filter');
    $this
      ->assertFieldById('edit-options-operator-not-in', 'not in', 'Operator Not In exists after hide filter');
    $this
      ->assertFieldById('edit-options-value-page', '', 'Checkbox for Page exists after hide filter');
    $this
      ->assertFieldById('edit-options-value-article', '', 'Checkbox for Article exists after hide filter');

    // Click the Expose sort button.
    $edit = [];
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/sort/created', $edit, t('Expose sort'));

    // Check the label of the expose button.
    $this
      ->helperButtonHasLabel('edit-options-expose-button-button', 'Hide sort');
    $this
      ->assertFieldById('edit-options-expose-label', 'Authored on', 'Make sure a label field is shown');

    // Test adding a new exposed sort criteria.
    $view_id = $this
      ->randomView()['id'];
    $this
      ->drupalGet("admin/structure/views/nojs/add-handler/{$view_id}/default/sort");
    $this
      ->drupalPostForm(NULL, [
      'name[node_field_data.created]' => 1,
    ], t('Add and configure @handler', [
      '@handler' => t('sort criteria'),
    ]));
    $this
      ->assertFieldByXPath('//input[@name="options[order]" and @checked="checked"]', 'ASC', 'The default order is set.');

    // Change the order and expose the sort.
    $this
      ->drupalPostForm(NULL, [
      'options[order]' => 'DESC',
    ], t('Apply'));
    $this
      ->drupalPostForm("admin/structure/views/nojs/handler/{$view_id}/default/sort/created", [], t('Expose sort'));
    $this
      ->assertFieldByXPath('//input[@name="options[order]" and @checked="checked"]', 'DESC');
    $this
      ->assertFieldByName('options[expose][label]', 'Authored on', 'The default label is set.');

    // Change the label and save the view.
    $edit = [
      'options[expose][label]' => $this
        ->randomString(),
    ];
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->drupalPostForm(NULL, [], t('Save'));

    // Check that the values were saved.
    $display = View::load($view_id)
      ->getDisplay('default');
    $this
      ->assertTrue($display['display_options']['sorts']['created']['exposed']);
    $this
      ->assertEqual($display['display_options']['sorts']['created']['expose'], [
      'label' => $edit['options[expose][label]'],
    ]);
    $this
      ->assertEqual($display['display_options']['sorts']['created']['order'], 'DESC');
  }

  /**
   * Tests the admin interface of exposed grouped filters.
   */
  public function testGroupedFilterAdminUi() {
    $edit = [];
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');

    // Click the Expose filter button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', $edit, t('Expose filter'));

    // Check the label of the grouped filters button.
    $this
      ->helperButtonHasLabel('edit-options-group-button-button', 'Grouped filters');

    // Click the Grouped Filters button.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $this
      ->drupalPostForm(NULL, [], t('Grouped filters'));

    // After click on 'Grouped Filters', the standard operator and value should
    // not be displayed.
    $this
      ->assertNoFieldById('edit-options-operator-in', 'in', 'Operator In not exists');
    $this
      ->assertNoFieldById('edit-options-operator-not-in', 'not in', 'Operator Not In not exists');
    $this
      ->assertNoFieldById('edit-options-value-page', '', 'Checkbox for Page not exists');
    $this
      ->assertNoFieldById('edit-options-value-article', '', 'Checkbox for Article not exists');

    // Check that after click on 'Grouped Filters', a new button is shown to
    // add more items to the list.
    $this
      ->helperButtonHasLabel('edit-options-group-info-add-group', 'Add another item');

    // Validate a single entry for a grouped filter.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = 'Is Article';
    $edit["options[group_info][group_items][1][value][article]"] = 'article';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertUrl('admin/structure/views/view/test_exposed_admin_ui/edit/default');
    $this
      ->assertNoGroupedFilterErrors();

    // Validate multiple entries for grouped filters.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = 'Is Article';
    $edit["options[group_info][group_items][1][value][article]"] = 'article';
    $edit["options[group_info][group_items][2][title]"] = 'Is Page';
    $edit["options[group_info][group_items][2][value][page]"] = 'page';
    $edit["options[group_info][group_items][3][title]"] = 'Is Page and Article';
    $edit["options[group_info][group_items][3][value][article]"] = 'article';
    $edit["options[group_info][group_items][3][value][page]"] = 'page';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertUrl('admin/structure/views/view/test_exposed_admin_ui/edit/default', [], 'Correct validation of the node type filter.');
    $this
      ->assertNoGroupedFilterErrors();

    // Validate an "is empty" filter -- title without value is valid.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/body_value');
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = 'No body';
    $edit["options[group_info][group_items][1][operator]"] = 'empty';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertUrl('admin/structure/views/view/test_exposed_admin_ui/edit/default', [], 'The "empty" operator validates correctly.');
    $this
      ->assertNoGroupedFilterErrors();

    // Ensure the string "0" can be used as a value for numeric filters.
    $this
      ->drupalPostForm('admin/structure/views/nojs/add-handler/test_exposed_admin_ui/default/filter', [
      'name[node_field_data.nid]' => TRUE,
    ], t('Add and configure @handler', [
      '@handler' => t('filter criteria'),
    ]));
    $this
      ->drupalPostForm(NULL, [], t('Expose filter'));
    $this
      ->drupalPostForm(NULL, [], t('Grouped filters'));
    $edit = [];
    $edit['options[group_info][group_items][1][title]'] = 'Testing zero';
    $edit['options[group_info][group_items][1][operator]'] = '>';
    $edit['options[group_info][group_items][1][value][value]'] = '0';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertUrl('admin/structure/views/view/test_exposed_admin_ui/edit/default', [], 'A string "0" is a valid value.');
    $this
      ->assertNoGroupedFilterErrors();

    // Ensure "between" filters validate correctly.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/nid');
    $edit['options[group_info][group_items][1][title]'] = 'ID between test';
    $edit['options[group_info][group_items][1][operator]'] = 'between';
    $edit['options[group_info][group_items][1][value][min]'] = '0';
    $edit['options[group_info][group_items][1][value][max]'] = '10';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertUrl('admin/structure/views/view/test_exposed_admin_ui/edit/default', [], 'The "between" filter validates correctly.');
    $this
      ->assertNoGroupedFilterErrors();
  }
  public function testGroupedFilterAdminUiErrors() {

    // Select the empty operator without a title specified.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/body_value');
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = '';
    $edit["options[group_info][group_items][1][operator]"] = 'empty';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertText($this->groupFormUiErrors['missing_title_empty_operator']);

    // Specify a title without a value.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', [], t('Expose filter'));
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', [], t('Grouped filters'));
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = 'Is Article';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertText($this->groupFormUiErrors['missing_value']);

    // Specify a value without a title.
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type');
    $edit = [];
    $edit["options[group_info][group_items][1][title]"] = '';
    $edit["options[group_info][group_items][1][value][article]"] = 'article';
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));
    $this
      ->assertText($this->groupFormUiErrors['missing_title']);
  }

  /**
   * Asserts that there are no Grouped Filters errors.
   *
   * @param string $message
   *   The assert message.
   * @param string $group
   *   The assertion group.
   *
   * @return bool
   *   Result of the assertion.
   */
  protected function assertNoGroupedFilterErrors($message = '', $group = 'Other') {
    foreach ($this->groupFormUiErrors as $error) {
      $err_message = $message;
      if (empty($err_message)) {
        $err_message = "Verify that '{$error}' is not in the HTML output.";
      }
      if (empty($message)) {
        return $this
          ->assertNoRaw($error, $err_message, $group);
      }
    }
    return TRUE;
  }

  /**
   * Tests the configuration of grouped exposed filters.
   */
  public function testExposedGroupedFilter() {

    // Click the Expose filter button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', [], t('Expose filter'));

    // Select 'Grouped filters' radio button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/type', [], t('Grouped filters'));

    // Add 3 groupings.
    $edit = [
      'options[group_button][radios][radios]' => 1,
      'options[group_info][group_items][1][title]' => '1st',
      'options[group_info][group_items][1][value][all]' => 'all',
      'options[group_info][group_items][2][title]' => '2nd',
      'options[group_info][group_items][2][value][article]' => 'article',
      'options[group_info][group_items][3][title]' => '3rd',
      'options[group_info][group_items][3][value][page]' => 'page',
    ];

    // Apply the filter settings.
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));

    // Check that the view is saved without errors.
    $this
      ->drupalPostForm(NULL, [], t('Save'));
    $this
      ->assertSession()
      ->statusCodeEquals(200);

    // Click the Expose filter button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/add-handler/test_exposed_admin_ui/default/filter', [
      'name[node_field_data.status]' => 1,
    ], t('Add and configure filter criteria'));
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/status', [], t('Expose filter'));

    // Select 'Grouped filters' radio button.
    $this
      ->drupalPostForm('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/status', [], t('Grouped filters'));

    // Add 3 groupings.
    $edit = [
      'options[group_button][radios][radios]' => 1,
      'options[group_info][group_items][1][title]' => 'Any',
      'options[group_info][group_items][1][value]' => 'All',
      'options[group_info][group_items][2][title]' => 'Published',
      'options[group_info][group_items][2][value]' => 1,
      'options[group_info][group_items][3][title]' => 'Unpublished',
      'options[group_info][group_items][3][value]' => 0,
    ];

    // Apply the filter settings.
    $this
      ->drupalPostForm(NULL, $edit, t('Apply'));

    // Check that the view is saved without errors.
    $this
      ->drupalPostForm(NULL, [], t('Save'));
    $this
      ->assertSession()
      ->statusCodeEquals(200);
    $this
      ->drupalGet('admin/structure/views/nojs/handler/test_exposed_admin_ui/default/filter/status');

    // Assert the same settings defined before still are there.
    $this
      ->assertFieldChecked('edit-options-group-info-group-items-1-value-all');
    $this
      ->assertFieldChecked('edit-options-group-info-group-items-2-value-1');
    $this
      ->assertFieldChecked('edit-options-group-info-group-items-3-value-0');
  }

}

Classes

Name	Description
ExposedFormUITest	Tests exposed forms UI functionality.