Drupal → Добавляем в Views поддержку своих таблиц

Простой пример того, как можно рассказать Views о своей таблице и сделать возможным выборку из этой таблицы.

В моём блоге у каждой заметки есть блок под названием Написанное актуально для (скриншот). Этот блок хранится в таблице versionfield и подключается при просмотре ноды в хуке hook_nodeapi. Структура таблицы:

CREATE TABLE `versionfield` (
  `nid` int(10) unsigned NOT NULL default 0,
  `version` varchar(255) NOT NULL default '',
  PRIMARY KEY  (`nid`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;

Её то мы и будем для примера подключать к Views.

Первым делом в основном файле модуля реализуем хук hook_views_api(), который сообщает Views о том, что мы хотим использовать его возможности. Функция должна возвращать версию Views API, которую использует модуль:

/**
 * Implements hook_views_api()
 */
function mymodule_views_api() {
  return array('api' => 2);
}

Дальше создаём в корне модуля файл имямодуля.views.inc и реализуем в нём хук hook_views_data():

/**
 * Реализация hook_views_data()
 */
function mymodule_views_data() {
  // подключаем к базовой таблице node, таблицу versionfield
  $data['versionfield']['table']['join']['node'] = array(
    'left_field' => 'nid', // ключевое поле из базовой таблицы, т.е из {node}
    'field' => 'nid',      // ключевое поле из подключаемой таблицы, т.е из {versionfield}
  );
    
  // рассказываем views о текстовом поле version из таблицы versionfield
  $data['versionfield']['version'] = array(
    'title'  => 'Написанное актуально для',
    'help'   => 'Версия скриптов используемых в заметке',
    'group'  => t('Node'),                                         // группа, к которой будет принадлежать поле
    'field'  => array('handler' => 'views_handler_field'),         // указываем на возможность добавлять поле в блоке Поля
    'sort'   => array('handler' => 'views_handler_sort'),          // указываем на возможность сортировки по этому полю в блоке Критерии сортировки
    'filter' => array('handler' => 'views_handler_filter_string'), // указываем на возможность фильтровать по этому полю в блоке Фильтры
  );
 
  return $data;
}

Очищаем кэш и пытаемся добавить новое поле к представлению:

Аналогичное поле появилось у критериев сортировки и фильтров.

Представление с новым полем:

Это очень простой пример использования Views API, рекомендую продолжить ознакомление по ссылкам:

— Модуль Views — API. Основы
— Views API часть 1 (подключаем свою таблицу)
— Как подружить свой тип данных с Views
— Developing With Views Part I: Describing your data to Views
— Views online help: Views' API
— Views 2 API Manual
— Как связать сущность с модулем Views в Drupal

Подружить свою таблицу с Views можно и из админки — модуль Data.