FeedsMapperTestBase.php in Feeds 8.2

Helper class with auxiliary functions for feeds mapper module tests.

Namespace

Drupal\feeds\Tests

File

lib/Drupal/feeds/Tests/FeedsMapperTestBase.php

<?php

/**
 * @file
 * Helper class with auxiliary functions for feeds mapper module tests.
 */
namespace Drupal\feeds\Tests;


/**
 * Base class for implementing Feeds Mapper test cases.
 */
class FeedsMapperTestBase extends FeedsWebTestBase {

  // A lookup map to select the widget for each field type.
  private static $field_widgets = array(
    'datetime' => 'datetime_default',
    'number_decimal' => 'number',
    'email' => 'email_textfield',
    'emimage' => 'emimage_textfields',
    'emaudio' => 'emaudio_textfields',
    'file' => 'file_generic',
    'image' => 'image_image',
    'link' => 'link_default',
    'number_float' => 'number',
    'number_integer' => 'number',
    'nodereference' => 'nodereference_select',
    'text' => 'text_textfield',
    'userreference' => 'userreference_select',
  );

  /**
   * Assert that a form field for the given field with the given value
   * exists in the current form.
   *
   * @param $field_name
   *   The name of the field.
   * @param $value
   *   The (raw) value expected for the field.
   * @param $index
   *   The index of the field (for q multi-valued field).
   *
   * @see FeedsMapperTestBase::getFormFieldsNames()
   * @see FeedsMapperTestBase::getFormFieldsValues()
   */
  protected function assertNodeFieldValue($field_name, $value, $index = 0) {
    $names = $this
      ->getFormFieldsNames($field_name, $index);
    $values = $this
      ->getFormFieldsValues($field_name, $value);
    foreach ($names as $k => $name) {
      $value = $values[$k];
      $this
        ->assertFieldByName($name, $value, t('Found form field %name for %field_name with the expected value.', array(
        '%name' => $name,
        '%field_name' => $field_name,
      )));
    }
  }

  /**
   * Returns the form fields names for a given CCK field. Default implementation
   * provides support for a single form field with the following name pattern
   * <code>"field_{$field_name}[{$index}][value]"</code>
   *
   * @param $field_name
   *   The name of the CCK field.
   * @param $index
   *   The index of the field (for q multi-valued field).
   *
   * @return
   *   An array of form field names.
   */
  protected function getFormFieldsNames($field_name, $index) {
    return array(
      "field_{$field_name}[und][{$index}][value]",
    );
  }

  /**
   * Returns the form fields values for a given CCK field. Default implementation
   * returns a single element array with $value casted to a string.
   *
   * @param $field_name
   *   The name of the CCK field.
   * @param $value
   *   The (raw) value expected for the CCK field.
   * @return An array of form field values.
   */
  protected function getFormFieldsValues($field_name, $value) {
    return array(
      (string) $value,
    );
  }

  /**
   * Create a new content-type, and add a field to it. Mostly copied from
   * cck/tests/content.crud.test ContentUICrud::testAddFieldUI
   *
   * @param $settings
   *   (Optional) An array of settings to pass through to
   *   drupalCreateContentType().
   * @param $fields
   *   (Optional) an keyed array of $field_name => $field_type used to add additional
   *   fields to the new content type.
   *
   * @return
   *   The machine name of the new content type.
   *
   * @see DrupalWebTestCase::drupalCreateContentType()
   */
  protected final function createContentType(array $settings = array(), array $fields = array()) {
    $type = $this
      ->drupalCreateContentType($settings);
    $typename = $type->type;

    // Create the fields
    foreach ($fields as $field_name => $options) {
      if (is_string($options)) {
        $options = array(
          'type' => $options,
        );
      }
      $field_type = isset($options['type']) ? $options['type'] : 'text';
      $field_widget = isset($options['widget']) ? $options['widget'] : $this
        ->selectFieldWidget($field_name, $field_type);
      $this
        ->assertTrue($field_widget !== NULL, "Field type {$field_type} supported");
      $label = $field_name . '_' . $field_type . '_label';
      $edit = array(
        'fields[_add_new_field][label]' => $label,
        'fields[_add_new_field][field_name]' => $field_name,
        'fields[_add_new_field][type]' => $field_type,
        'fields[_add_new_field][widget_type]' => $field_widget,
      );
      $this
        ->drupalPost("admin/structure/types/manage/{$typename}/fields", $edit, 'Save');

      // (Default) Configure the field.
      $edit = isset($options['settings']) ? $options['settings'] : array();
      $this
        ->drupalPost(NULL, $edit, 'Save field settings');
      $this
        ->assertText('Updated field ' . $label . ' field settings.');
      $edit = isset($options['instance_settings']) ? $options['instance_settings'] : array();
      $this
        ->drupalPost(NULL, $edit, 'Save settings');
      $this
        ->assertText('Saved ' . $label . ' configuration.');
    }
    return $typename;
  }

  /**
   * Select the widget for the field. Default implementation provides widgets
   * for Date, Number, Text, Node reference, User reference, Email, Emfield,
   * Filefield, Image, and Link.
   *
   * Extracted as a method to allow test implementations to add widgets for
   * the tested CCK field type(s). $field_name allow to test the same
   * field type with different widget (is this useful ?)
   *
   * @param $field_name
   *   The name of the field.
   * @param $field_type
   *   The CCK type of the field.
   *
   * @return
   *   The widget for this field, or NULL if the field_type is not
   *   supported by this test class.
   */
  protected function selectFieldWidget($field_name, $field_type) {
    $field_widgets = FeedsMapperTestBase::$field_widgets;
    return isset($field_widgets[$field_type]) ? $field_widgets[$field_type] : NULL;
  }

}

Classes

Name	Description
FeedsMapperTestBase	Base class for implementing Feeds Mapper test cases.