function node_views_data in Views (for Drupal 7) 6.3
Same name and namespace in other branches
- 8.3 modules/node.views.inc \node_views_data()
- 6.2 modules/node.views.inc \node_views_data()
- 7.3 modules/node.views.inc \node_views_data()
Implementation of hook_views_data()
Related topics
File
- modules/
node.views.inc, line 17 - Provide views data and handlers for node.module
Code
function node_views_data() {
// ----------------------------------------------------------------
// node table -- basic table information.
// Define the base group of this table. Fields that don't
// have a group defined will go into this field by default.
$data['node']['table']['group'] = t('Node');
// Advertise this table as a possible base table
$data['node']['table']['base'] = array(
'field' => 'nid',
'title' => t('Node'),
'help' => t("Nodes are a Drupal site's primary content."),
'weight' => -10,
);
// For other base tables, explain how we join
$data['node']['table']['join'] = array(
// this explains how the 'node' table (named in the line above)
// links toward the node_revisions table.
'node_revisions' => array(
'handler' => 'views_join',
// this is actually optional
'left_table' => 'node_revisions',
// Because this is a direct link it could be left out.
'left_field' => 'nid',
'field' => 'nid',
),
);
// ----------------------------------------------------------------
// node table -- fields
// nid
$data['node']['nid'] = array(
'title' => t('Nid'),
'help' => t('The node ID of the node.'),
// The help that appears on the UI,
// Information for displaying the nid
'field' => array(
'handler' => 'views_handler_field_node',
'click sortable' => TRUE,
),
// Information for accepting a nid as an argument
'argument' => array(
'handler' => 'views_handler_argument_node_nid',
'parent' => 'views_handler_argument_numeric',
// make sure parent is included
'name field' => 'title',
// the field to display in the summary.
'numeric' => TRUE,
'validate type' => 'nid',
),
// Information for accepting a nid as a filter
'filter' => array(
'handler' => 'views_handler_filter_numeric',
),
// Information for sorting on a nid.
'sort' => array(
'handler' => 'views_handler_sort',
),
);
// title
// This definition has more items in it than it needs to as an example.
$data['node']['title'] = array(
'title' => t('Title'),
// The item it appears as on the UI,
'help' => t('The title of the node.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'field' => 'title',
// the real field. This could be left out since it is the same.
'group' => t('Node'),
// The group it appears in on the UI. Could be left out.
'handler' => 'views_handler_field_node',
'click sortable' => TRUE,
'link_to_node default' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort',
),
// Information for accepting a title as a filter
'filter' => array(
'handler' => 'views_handler_filter_string',
),
'argument' => array(
'handler' => 'views_handler_argument_string',
),
);
// created field
$data['node']['created'] = array(
'title' => t('Post date'),
// The item it appears as on the UI,
'help' => t('The date the node was posted.'),
// The help that appears on the UI,
'field' => array(
'handler' => 'views_handler_field_date',
'click sortable' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort_date',
),
'filter' => array(
'handler' => 'views_handler_filter_date',
),
);
// changed field
$data['node']['changed'] = array(
'title' => t('Updated date'),
// The item it appears as on the UI,
'help' => t('The date the node was last updated.'),
// The help that appears on the UI,
'field' => array(
'handler' => 'views_handler_field_date',
'click sortable' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort_date',
),
'filter' => array(
'handler' => 'views_handler_filter_date',
),
);
// Node type
$data['node']['type'] = array(
'title' => t('Type'),
// The item it appears as on the UI,
'help' => t('The type of a node (for example, "blog entry", "forum post", "story", etc).'),
// The help that appears on the UI,
'field' => array(
'handler' => 'views_handler_field_node_type',
'click sortable' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort',
),
'filter' => array(
'handler' => 'views_handler_filter_node_type',
),
'argument' => array(
'handler' => 'views_handler_argument_node_type',
),
);
// published status
$data['node']['status'] = array(
'title' => t('Published'),
'help' => t('Whether or not the node is published.'),
'field' => array(
'handler' => 'views_handler_field_boolean',
'click sortable' => TRUE,
'output formats' => array(
'published-notpublished' => array(
t('Published'),
t('Not published'),
),
),
),
'filter' => array(
'handler' => 'views_handler_filter_boolean_operator',
'label' => t('Published'),
'type' => 'yes-no',
'use equal' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort',
),
);
// published status + extra
$data['node']['status_extra'] = array(
'title' => t('Published or admin'),
'help' => t('Filters out unpublished nodes if the current user cannot view them.'),
'filter' => array(
'field' => 'status',
'handler' => 'views_handler_filter_node_status',
'label' => t('Published or admin'),
),
);
// promote status
$data['node']['promote'] = array(
'title' => t('Promoted to front page'),
'help' => t('Whether or not the node is promoted to the front page.'),
'field' => array(
'handler' => 'views_handler_field_boolean',
'click sortable' => TRUE,
'output formats' => array(
'promoted-notpromoted' => array(
t('Promoted'),
t('Not promoted'),
),
),
),
'filter' => array(
'handler' => 'views_handler_filter_boolean_operator',
'label' => t('Promoted to front page'),
'type' => 'yes-no',
),
'sort' => array(
'handler' => 'views_handler_sort',
),
);
// moderate
$data['node']['moderate'] = array(
'title' => t('In moderation'),
// The item it appears as on the UI,
'help' => t('Whether or not the node is currently in the moderation queue.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'handler' => 'views_handler_field_boolean',
'click sortable' => TRUE,
),
'filter' => array(
'handler' => 'views_handler_filter_boolean_operator',
'label' => t('In the moderation queue'),
'type' => 'yes-no',
),
'sort' => array(
'handler' => 'views_handler_sort',
),
);
// sticky
$data['node']['sticky'] = array(
'title' => t('Sticky'),
// The item it appears as on the UI,
'help' => t('Whether or not the node is sticky.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'handler' => 'views_handler_field_boolean',
'click sortable' => TRUE,
'output formats' => array(
'sticky' => array(
t('Sticky'),
t('Not sticky'),
),
),
),
'filter' => array(
'handler' => 'views_handler_filter_boolean_operator',
'label' => t('Sticky'),
'type' => 'yes-no',
),
'sort' => array(
'handler' => 'views_handler_sort',
'help' => t('Whether or not the node is sticky. To list sticky nodes first, set this to descending.'),
),
);
// links to operate on the node
$data['node']['view_node'] = array(
'field' => array(
'title' => t('Link'),
'help' => t('Provide a simple link to the node.'),
'handler' => 'views_handler_field_node_link',
),
);
$data['node']['edit_node'] = array(
'field' => array(
'title' => t('Edit link'),
'help' => t('Provide a simple link to edit the node.'),
'handler' => 'views_handler_field_node_link_edit',
),
);
$data['node']['delete_node'] = array(
'field' => array(
'title' => t('Delete link'),
'help' => t('Provide a simple link to delete the node.'),
'handler' => 'views_handler_field_node_link_delete',
),
);
$data['node']['path'] = array(
'field' => array(
'title' => t('Path'),
'help' => t('The aliased path to this node.'),
'handler' => 'views_handler_field_node_path',
),
);
// Bogus fields for aliasing purposes.
$data['node']['created_fulldate'] = array(
'title' => t('Created date'),
'help' => t('Date in the form of CCYYMMDD.'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_fulldate',
),
);
$data['node']['created_year_month'] = array(
'title' => t('Created year + month'),
'help' => t('Date in the form of YYYYMM.'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_year_month',
),
);
$data['node']['created_year'] = array(
'title' => t('Created year'),
'help' => t('Date in the form of YYYY.'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_year',
),
);
$data['node']['created_month'] = array(
'title' => t('Created month'),
'help' => t('Date in the form of MM (01 - 12).'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_month',
),
);
$data['node']['created_day'] = array(
'title' => t('Created day'),
'help' => t('Date in the form of DD (01 - 31).'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_day',
),
);
$data['node']['created_week'] = array(
'title' => t('Created week'),
'help' => t('Date in the form of WW (01 - 53).'),
'argument' => array(
'field' => 'created',
'handler' => 'views_handler_argument_node_created_week',
),
);
$data['node']['changed_fulldate'] = array(
'title' => t('Updated date'),
'help' => t('Date in the form of CCYYMMDD.'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_fulldate',
),
);
$data['node']['changed_year_month'] = array(
'title' => t('Updated year + month'),
'help' => t('Date in the form of YYYYMM.'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_year_month',
),
);
$data['node']['changed_year'] = array(
'title' => t('Updated year'),
'help' => t('Date in the form of YYYY.'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_year',
),
);
$data['node']['changed_month'] = array(
'title' => t('Updated month'),
'help' => t('Date in the form of MM (01 - 12).'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_month',
),
);
$data['node']['changed_day'] = array(
'title' => t('Updated day'),
'help' => t('Date in the form of DD (01 - 31).'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_day',
),
);
$data['node']['changed_week'] = array(
'title' => t('Updated week'),
'help' => t('Date in the form of WW (01 - 53).'),
'argument' => array(
'field' => 'changed',
'handler' => 'views_handler_argument_node_created_week',
),
);
// uid field
$data['node']['uid'] = array(
'title' => t('Author'),
'help' => t('Relate a node to the user who created it.'),
'relationship' => array(
'handler' => 'views_handler_relationship',
'base' => 'users',
'base field' => 'uid',
'label' => t('user'),
),
);
$data['node']['uid_revision'] = array(
'title' => t('User has a revision'),
'help' => t('All nodes where a certain user has a revision'),
'real field' => 'nid',
'filter' => array(
'handler' => 'views_handler_filter_node_uid_revision',
),
'argument' => array(
'handler' => 'views_handler_argument_node_uid_revision',
),
);
// ----------------------------------------------------------------------
// Node revisions table
// Define the base group of this table. Fields that don't
// have a group defined will go into this field by default.
$data['node_revisions']['table']['group'] = t('Node revision');
// Advertise this table as a possible base table
$data['node_revisions']['table']['base'] = array(
'field' => 'vid',
'title' => t('Node revision'),
'help' => t('Node revisions are a history of changes to nodes.'),
);
// For other base tables, explain how we join
$data['node_revisions']['table']['join'] = array(
// Directly links to node table.
'node' => array(
'left_field' => 'vid',
'field' => 'vid',
),
);
// uid field for node revisions
$data['node_revisions']['uid'] = array(
'title' => t('User'),
'help' => t('Relate a node revision to the user who created the revision.'),
'relationship' => array(
'handler' => 'views_handler_relationship',
'base' => 'users',
'field' => 'uid',
'label' => t('revision user'),
),
);
// Body field
$data['node_revisions']['body'] = array(
'group' => t('Node'),
'title' => t('Body'),
// The item it appears as on the UI,
'help' => t('The actual, full data in the body field; this may not be valid data on all node types.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'handler' => 'views_handler_field_markup',
'format' => 'format',
),
'filter' => array(
'handler' => 'views_handler_filter_string',
),
);
// Teaser field
$data['node_revisions']['teaser'] = array(
'group' => t('Node'),
'title' => t('Teaser'),
// The item it appears as on the UI,
'help' => t('The stored teaser field. This may not be valid or useful data on all node types.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'handler' => 'views_handler_field_markup',
'format' => 'format',
),
'filter' => array(
'handler' => 'views_handler_filter_string',
),
);
// nid
$data['node_revisions']['vid'] = array(
'title' => t('Vid'),
'help' => t('The revision ID of the node revision.'),
// The help that appears on the UI,
// Information for displaying the nid
'field' => array(
// 'handler' => 'views_handler_field',
'click sortable' => TRUE,
),
// Information for accepting a nid as an argument
'argument' => array(
'handler' => 'views_handler_argument_node_vid',
'parent' => 'views_handler_argument_numeric',
// make sure parent is included
'click sortable' => TRUE,
'numeric' => TRUE,
),
// Information for accepting a nid as a filter
'filter' => array(
'handler' => 'views_handler_filter_numeric',
),
// Information for sorting on a nid.
'sort' => array(
'handler' => 'views_handler_sort',
),
'relationship' => array(
'handler' => 'views_handler_relationship',
'base' => 'node',
'base field' => 'nid',
'title' => t('Node'),
'label' => t('Get the actual node from a node revision.'),
),
);
// title
$data['node_revisions']['title'] = array(
'title' => t('Title'),
// The item it appears as on the UI,
'help' => t('The title of the node.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'field' => 'title',
// the real field
'handler' => 'views_handler_field_node_revision',
'click sortable' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort',
),
'filter' => array(
'handler' => 'views_handler_filter_string',
),
'argument' => array(
'handler' => 'views_handler_argument_string',
),
);
// log field
$data['node_revisions']['log'] = array(
'title' => t('Log message'),
// The item it appears as on the UI,
'help' => t('The log message entered when the revision was created.'),
// The help that appears on the UI,
// Information for displaying a title as a field
'field' => array(
'handler' => 'views_handler_field_xss',
),
'filter' => array(
'handler' => 'views_handler_filter_string',
),
);
// revision timestamp
// changed field
$data['node_revisions']['timestamp'] = array(
'title' => t('Updated date'),
// The item it appears as on the UI,
'help' => t('The date the node was last updated.'),
// The help that appears on the UI,
'field' => array(
'handler' => 'views_handler_field_date',
'click sortable' => TRUE,
),
'sort' => array(
'handler' => 'views_handler_sort_date',
),
'filter' => array(
'handler' => 'views_handler_filter_date',
),
);
// input format id
$data['node_revisions']['format'] = array(
'title' => t('Input format id'),
// The item it appears as on the UI,
'help' => t('The numeric input format of the node revision. !default means the default input format.', array(
'!default' => FILTER_FORMAT_DEFAULT,
)),
// The help that appears on the UI,
// Information for displaying an input format as a field
'field' => array(
'handler' => 'views_handler_field_numeric',
'click sortable' => TRUE,
),
// Information for sorting on input format
'sort' => array(
'handler' => 'views_handler_sort',
),
// Information for accepting input format as a filter
'filter' => array(
'handler' => 'views_handler_filter_numeric',
),
);
// input format name
// A (numeric) format of 0 means the default; Drupal also applies the default
// if the format specifed for a node revision has been deleted.
// This complexity makes sorting and filtering by format name tricky,
// hence these are not yet supported.
$data['node_revisions']['format_name'] = array(
'title' => t('Input format'),
// The item it appears as on the UI,
'help' => t('The name of the input format of the node revision.'),
// The help that appears on the UI,
// Information for displaying an input format as a field
'field' => array(
'handler' => 'views_handler_field_filter_format_name',
),
);
$data['node_revisions']['revert_revision'] = array(
'field' => array(
'title' => t('Revert link'),
'help' => t('Provide a simple link to revert to the revision.'),
'handler' => 'views_handler_field_node_revision_link_revert',
),
);
$data['node_revisions']['delete_revision'] = array(
'field' => array(
'title' => t('Delete link'),
'help' => t('Provide a simple link to delete the node revision.'),
'handler' => 'views_handler_field_node_revision_link_delete',
),
);
// ----------------------------------------------------------------------
// Node access table
// Define the base group of this table. Fields that don't
// have a group defined will go into this field by default.
$data['node_access']['table']['group'] = t('Node access');
// For other base tables, explain how we join
$data['node_access']['table']['join'] = array(
// Directly links to node table.
'node' => array(
'left_field' => 'nid',
'field' => 'nid',
),
);
// nid field
$data['node_access']['nid'] = array(
'title' => t('Access'),
'help' => t('Filter by access.'),
'filter' => array(
'handler' => 'views_handler_filter_node_access',
'help' => t('Filter for nodes by view access. <strong>Not necessary if you are using node as your base table.</strong>'),
),
);
// ----------------------------------------------------------------------
// History table
// We're actually defining a specific instance of the table, so let's
// alias it so that we can later add the real table for other purposes if we
// need it.
$data['history_user']['table']['group'] = t('Node');
// Explain how this table joins to others.
$data['history_user']['table']['join'] = array(
// Directly links to node table.
'node' => array(
'table' => 'history',
'left_field' => 'nid',
'field' => 'nid',
'extra' => array(
array(
'field' => 'uid',
'value' => '***CURRENT_USER***',
'numeric' => TRUE,
),
),
),
);
$data['history_user']['timestamp'] = array(
'title' => t('Has new content'),
'field' => array(
'handler' => 'views_handler_field_history_user_timestamp',
'help' => t('Show a marker if the node has new or updated content.'),
),
'filter' => array(
'help' => t('Show only nodes that have new content.'),
'handler' => 'views_handler_filter_history_user_timestamp',
),
);
return $data;
}