鍵概念
本教程演示瞭如何將自定義Drupal 7數據庫表與視圖模塊集成在一起,從而實現了功能強大的查詢和數據表示功能。 我們將介紹了解您的模塊的表結構,定義用於顯示,過濾和排序的字段處理程序,並使用加入來建立表之間的關係。 該過程利用視圖處理程序 - 類管理顯示,排序和過濾操作的類 - 允許自定義超出默認功能。
本指南重點介紹未表示為Drupal實體的表。 有關實體集成與視圖的集成,請參考其他資源。
可用的示例模塊“ expose”(為簡潔而省略了存儲庫詳細信息)。 exposed
表(下面詳細介紹的結構)將用於演示。 可以使用此mySQL命令插入示例數據:
<code class="language-sql">INSERT INTO `exposed` (`id`, `name`, `deadline`, `node_id`) VALUES (1, 'Danny', 1399477939, 1), (2, 'Peter', 1399477957, 2);</code>
>將表與視圖集成 集成涉及兩個關鍵步驟:了解有關模塊的視圖並定義表的結構。
>步驟1:了解有關模塊的視圖
>
>在您的模塊的文件中實現:
這指定視圖API版本和與視圖相關的文件的位置。
hook_views_api()
>.module
步驟2:定義表的結構
<code class="language-php">/** * Implements hook_views_api(). */ function expose_views_api() { return array( 'api' => 3, 'path' => drupal_get_path('module', 'expose') . '/includes/views', ); }</code>>
create
(在上面指定的目錄中)和實現:>
此代碼定義了表的組並將其指定為基礎表,使其在視圖接口中可用。 字段定義(下一個詳細信息)將在此處添加。>
expose.views.inc
>hook_views_data()
步驟3:定義字段
<code class="language-php">/** * 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; }</code>>
>在
中,為每列添加字段定義:這為每列指定顯示的操作器(),排序(
)和過濾()。 根據數據類型選擇了適當的處理程序(例如,數字,字符串,日期)。
hook_views_data()
>
<code class="language-php">// ... (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;</code>
>
field
使用sort
filter
列加入
> >這定義了連接並指定顯示
>用於顯示的處理程序,從而可以訪問與節點相關的字段。 還定義了基於節點ID的過濾和上下文過濾的關係和參數。實施這些步驟後,請清除Drupal的緩存。 現在,您的自定義表應該可以在視圖接口中訪問。 node
>
node_id
<code class="language-php">// ... (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;</code>
>此詳細說明提供了將自定義表與Drupal 7的視圖模塊集成的綜合指南。 切記為您的特定數據類型量身定制處理程序選擇,並利用自定義處理程序的靈活性來獲得高級功能。 原始輸入的FAQ部分已被省略,因為它在此精製響應中大部分涵蓋了。
以上是將表暴露於Drupal 7中的視圖的詳細內容。更多資訊請關注PHP中文網其他相關文章!