function hook_views_data_alter

nittany7 views.api.php hook_views_data_alter(&$data)
cis7 views.api.php hook_views_data_alter(&$data)
mooc7 views.api.php hook_views_data_alter(&$data)

Alter table structure.

You can add/edit/remove existing tables defined by hook_views_data().

This hook should be placed in and it will be auto-loaded. must be in the directory specified by the 'path' key returned by MODULENAME_views_api(), or the same directory as the .module file, if 'path' is unspecified.


$data: An array of all Views data, passed by reference. See hook_views_data() for structure.

See also


Related topics

18 functions implement hook_views_data_alter()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

comment_views_data_alter in modules/contrib/views/modules/
Use views_data_alter to add items to the node table that are relevant to comments.
contact_views_data_alter in modules/contrib/views/modules/
Implements hook_views_data_alter().
date_views_field_views_data_alter in modules/contrib/date/date_views/date_views.module
Implements hook_field_views_data_alter().
date_views_views_data_alter in modules/contrib/date/date_views/includes/
Implements hook_views_data_alter().
editableviews_field_views_data_alter in modules/contrib/editableviews/
Implement hook_field_views_data_alter.

... See full list

1 invocation of hook_views_data_alter()
_views_fetch_data_build in modules/contrib/views/includes/
Build and set the views data cache if empty.


modules/contrib/views/views.api.php, line 477
Describe hooks provided by the Views module.


function hook_views_data_alter(&$data) {
  // This example alters the title of the node:nid field in the Views UI.
  $data['node']['nid']['title'] = t('Node-Nid');

  // This example adds an example field to the users table.
  $data['users']['example_field'] = array(
    'title' => t('Example field'),
    'help' => t('Some example content that references a user'),
    'field' => array(
      'handler' => 'modulename_handler_field_example_field',

  // This example changes the handler of the node title field.
  // In this handler you could do stuff, like preview of the node when clicking
  // the node title.
  $data['node']['title']['field']['handler'] = 'modulename_handler_field_node_title';

  // This example adds a relationship to table {foo}, so that 'foo' views can
  // add this table using a relationship. Because we don't want to write over
  // the primary key field definition for the {foo}.fid field, we use a dummy
  // field name as the key.
  $data['foo']['dummy_name'] = array(
    'title' => t('Example relationship'),
    'help' => t('Example help'),
    'relationship' => array(
      'base' => 'example_table', // Table we're joining to.
      'base field' => 'eid', // Field on the joined table.
      'field' => 'fid', // Real field name on the 'foo' table.
      'handler' => 'views_handler_relationship',
      'label' => t('Default label for relationship'),
      'title' => t('Title seen when adding relationship'),
      'help' => t('More information about relationship.'),

  // Note that the $data array is not returned – it is modified by reference.