键概念
本教程演示了如何将自定义Drupal 7数据库表与视图模块集成在一起,从而实现了功能强大的查询和数据表示功能。 我们将介绍了解您的模块的表结构,定义用于显示,过滤和排序的字段处理程序,并使用加入来建立表之间的关系。 该过程利用视图处理程序 - 类管理显示,排序和过滤操作的类 - 允许自定义超出默认功能。
本指南重点介绍未表示为Drupal实体的表。 有关实体集成与视图的集成,请参考其他资源。
可用的示例模块“ expose”(为简洁而省略了存储库详细信息)。 exposed
表(下面详细介绍的结构)将用于演示。 可以使用此mySQL命令插入示例数据:
INSERT INTO `exposed` (`id`, `name`, `deadline`, `node_id`) VALUES (1, 'Danny', 1399477939, 1), (2, 'Peter', 1399477957, 2);
>将表与视图集成 集成涉及两个关键步骤:了解有关模块的视图并定义表的结构。
>步骤1:了解有关模块的视图
>
>在您的模块的文件中实现:
这指定视图API版本和与视图相关的文件的位置。
hook_views_api()
>.module
步骤2:定义表的结构
/** * Implements hook_views_api(). */ function expose_views_api() { return array( 'api' => 3, 'path' => drupal_get_path('module', 'expose') . '/includes/views', ); }
create
(在上面指定的目录中)和实现:>
此代码定义了表的组并将其指定为基础表,使其在视图接口中可用。 字段定义(下一个详细信息)将在此处添加。>
expose.views.inc
>hook_views_data()
步骤3:定义字段
/** * Implements hook_views_data(). */ function expose_views_data() { $data = array(); $data['exposed']['table']['group'] = t('Exposed'); $data['exposed']['table']['base'] = array( 'title' => t('Exposed'), 'help' => t('Contains records exposed to Views.'), ); // Field definitions (see below) return $data; }
>在
中,为每列添加字段定义:这为每列指定显示的操作器(),排序(
)和过滤()。 根据数据类型选择了适当的处理程序(例如,数字,字符串,日期)。
hook_views_data()
>
// ... (previous code) ... // ID field $data['exposed']['id'] = array( 'title' => t('ID'), 'help' => t('Record ID'), 'field' => array('handler' => 'views_handler_field_numeric'), 'sort' => array('handler' => 'views_handler_sort'), 'filter' => array('handler' => 'views_handler_filter_numeric'), ); // Name field $data['exposed']['name'] = array( 'title' => t('Name'), 'help' => t('Record name'), 'field' => array('handler' => 'views_handler_field'), 'sort' => array('handler' => 'views_handler_sort'), 'filter' => array('handler' => 'views_handler_filter_string'), ); // Deadline field $data['exposed']['deadline'] = array( 'title' => t('Deadline'), 'help' => t('Record deadline'), 'field' => array('handler' => 'views_handler_field_date'), 'sort' => array('handler' => 'views_handler_sort_date'), 'filter' => array('handler' => 'views_handler_filter_date'), ); // ... (Node ID field and join definition - see below) ... return $data;
>
field
使用sort
filter
列加入
> >这定义了连接并指定显示
>用于显示的处理程序,从而可以访问与节点相关的字段。 还定义了基于节点ID的过滤和上下文过滤的关系和参数。实施这些步骤后,请清除Drupal的缓存。 现在,您的自定义表应该可以在视图接口中访问。node
>
node_id
// ... (previous code) ... // Join definition $data['exposed']['table']['join'] = array( 'node' => array( 'left_field' => 'nid', 'field' => 'node_id', ), ); // Node ID field $data['exposed']['node_id'] = array( 'title' => t('Node ID'), 'help' => t('Node ID'), 'field' => array('handler' => 'views_handler_field_node'), 'sort' => array('handler' => 'views_handler_sort'), 'filter' => array('handler' => 'views_handler_filter_numeric'), 'relationship' => array( 'base' => 'node', 'field' => 'node_id', 'handler' => 'views_handler_relationship', 'label' => t('Node'), ), 'argument' => array( 'handler' => 'views_handler_argument_node_nid', 'numeric' => TRUE, 'validate type' => 'nid', ), ); return $data;
>此详细说明提供了将自定义表与Drupal 7的视图模块集成的综合指南。 切记为您的特定数据类型量身定制处理程序选择,并利用自定义处理程序的灵活性来获得高级功能。 原始输入的FAQ部分已被省略,因为它在此精制响应中大部分涵盖了。
以上是将表暴露于Drupal 7中的视图的详细内容。更多信息请关注PHP中文网其他相关文章!