function views_fetch_fields in Views (for Drupal 7) 7.3

Same name and namespace in other branches

1. 8.3 views_ui/admin.inc \views_fetch_fields()
2. 6.3 includes/admin.inc \views_fetch_fields()
3. 6.2 includes/admin.inc \views_fetch_fields()

Fetch a list of all fields available for a given base type.

Parameters

(array|string) $base: A list or a single base_table, for example node.

string $type: The handler type, for example field or filter.

bool $grouping: Should the result grouping by its 'group' label.

Return value

array A keyed array of in the form of 'base_table' => 'Description'.

5 calls to views_fetch_fields()

ViewsUiBaseViewsWizard::build_filters in plugins/views_wizard/views_ui_base_views_wizard.class.php

Build the part of the form that allows the user to select the filters.

ViewsUiBaseViewsWizard::default_display_filters_user in plugins/views_wizard/views_ui_base_views_wizard.class.php

views_handler_relationship_groupwise_max::options_form in handlers/views_handler_relationship_groupwise_max.inc

Extends the relationship's basic options.

views_ui_add_item_form in includes/admin.inc

Form to add_item items in the views UI.

views_ui_config_item_form in includes/admin.inc

Form to config_item items in the views UI.

File

includes/admin.inc, line 5294

Provides the Views' administrative interface.

Code

function views_fetch_fields($base, $type, $grouping = FALSE) {
  static $fields = array();
  if (empty($fields)) {
    $data = views_fetch_data();

    // This constructs this ginormous multi dimensional array to
    // collect the important data about fields. In the end,
    // the structure looks a bit like this (using nid as an example)
    // $strings['nid']['filter']['title'] = 'string'.
    //
    // This is constructed this way because the above referenced strings
    // can appear in different places in the actual data structure so that
    // the data doesn't have to be repeated a lot. This essentially lets
    // each field have a cheap kind of inheritance.
    $components = array(
      'title',
      'group',
      'help',
      'base',
      'aliases',
    );
    $components_errors = array();

    // Fixed number of calls to t() to produce error components.
    foreach ($components as $string) {
      $components_errors[$string] = t("Error: missing @component", array(
        '@component' => $string,
      ));
    }
    foreach ($data as $table => $table_data) {
      $bases = array();
      $strings = array();
      $skip_bases = array();
      foreach ($table_data as $field => $info) {

        // Collect table data from this table.
        if ($field == 'table') {

          // calculate what tables this table can join to.
          if (!empty($info['join'])) {
            $bases = array_keys($info['join']);
          }

          // And it obviously joins to itself.
          $bases[] = $table;
          continue;
        }
        foreach (array(
          'field',
          'sort',
          'filter',
          'argument',
          'relationship',
          'area',
        ) as $key) {
          if (!empty($info[$key])) {
            if ($grouping && !empty($info[$key]['no group by'])) {
              continue;
            }
            if (!empty($info[$key]['skip base'])) {
              foreach ((array) $info[$key]['skip base'] as $base_name) {
                $skip_bases[$field][$key][$base_name] = TRUE;
              }
            }
            elseif (!empty($info['skip base'])) {
              foreach ((array) $info['skip base'] as $base_name) {
                $skip_bases[$field][$key][$base_name] = TRUE;
              }
            }

            // Don't show old fields. The real field will be added right.
            if (isset($info[$key]['moved to'])) {
              continue;
            }
            foreach ($components as $string) {

              // First, try the lowest possible level.
              if (!empty($info[$key][$string])) {
                $strings[$field][$key][$string] = $info[$key][$string];
              }
              elseif (!empty($info[$string])) {
                $strings[$field][$key][$string] = $info[$string];
              }
              elseif (!empty($table_data['table'][$string])) {
                $strings[$field][$key][$string] = $table_data['table'][$string];
              }
              else {
                if ($string != 'base') {
                  $strings[$field][$key][$string] = $components_errors[$string];
                }
              }
            }
          }
        }
      }
      foreach ($bases as $base_name) {
        foreach ($strings as $field => $field_strings) {
          foreach ($field_strings as $type_name => $type_strings) {
            if (empty($skip_bases[$field][$type_name][$base_name])) {
              $fields[$base_name][$type_name]["{$table}.{$field}"] = $type_strings;
            }
          }
        }
      }
    }
  }

  // If we have an array of base tables available, go through them all and add
  // them together. Duplicate keys will be lost and that's Just Fine.
  if (is_array($base)) {
    $strings = array();
    foreach ($base as $base_table) {
      if (isset($fields[$base_table][$type])) {
        $strings += $fields[$base_table][$type];
      }
    }
    uasort($strings, '_views_sort_types');
    return $strings;
  }
  if (isset($fields[$base][$type])) {
    uasort($fields[$base][$type], '_views_sort_types');
    return $fields[$base][$type];
  }
  return array();
}