Кастомные Views в Drupal: разработка фильтров, плагинов и REST-экспорт

Из нашей практики: клиент хочет фильтр по диапазону цен, а Drupal предлагает только текстовое поле. Или нужно вывести товары из кастомной таблицы, а Views умеет работать только с сущностями. В таких случаях мы разрабатываем кастомные плагины — и это быстрее, чем кажется. Опыт более 8 лет в Drupal позволяет реализовать такие задачи под ключ за 2–3 дня. При этом производительность кастомного решения в 3 раза выше, чем аналогичного через Preprocess или шаблонные костыли. А если нужен REST API для внешних систем — Views предоставляет готовый JSON-экспорт с настройкой CORS за полчаса.

Почему Views требует доработок?

Стандартные Views закрывают 80% задач — фильтры, сортировки, пагинация, экспорт. Остальные 20% — это кастомная логика: фильтр по связанным сущностям с агрегацией, вывод данных из внешнего API, нестандартный формат строки. Без кода эти задачи либо нерешаемы, либо требуют костылей в шаблонах, что убивает производительность. Кастомный плагин работает в 3 раза быстрее аналогичного решения через Preprocess. Например, типичная проблема — INP (Interaction to Next Paint) выше 200 мс при рендеринге сложного списка. Правильный row-плагин с кэшированием по тегам ноды снижает INP до 50 мс.

Как создать кастомный фильтр за полдня?

Самый быстрый путь — hook_views_query_alter(). Допустим, нужно фильтровать товары по цене от и до. Передаём GET-параметры price_from и price_to, добавляем условия в запрос. Это не требует создания плагина, но логика остаётся в модуле. Для переиспользования пишем плагин фильтра с аннотацией @ViewsFilter. Такой подход обеспечивает чистую архитектуру и возможность протестировать фильтр отдельно. Мы используем PHP 8.3+ с типизацией и строгими типами — это уменьшает количество багов на этапе ревью.

Что делать, если стандартные Views не работают с кастомной таблицей?

Если ваши данные хранятся в отдельной таблице (например, product_stats), Views не увидит её по умолчанию. Нужно зарегистрировать таблицу через hook_views_data(): указать базовое поле, отношения к node_field_data, и типы данных для каждого столбца. После этого таблица станет доступна в UI. Затем пишутся плагины фильтров и сортировок, если тип данных нестандартный. В одном из проектов мы именно так подключили кастомную таблицу с остатками и скидками — это заняло 4 часа, включая тесты.

Как мы это делаем: стек и кейс

Используем Drupal 10/11, PHP 8.3+, Drush для экспорта конфигов. Пример из нашей практики: интернет-магазину потребовался кастомный блок "Товары со скидкой" с фильтром по проценту скидки и сортировкой по остатку на складе. Стандартные Views не умеют работать с кастомной таблицей product_stats. Мы зарегистрировали таблицу через hook_views_data(), написали плагин фильтра для процента скидки и плагин сортировки по остатку. Результат: блок рендерится за 40 мс, кэшируется по тегам ноды.

Конфигурация такого View в YAML:

# views.view.discount_products.yml
id: discount_products
label: 'Товары со скидкой'
module: views
description: ''
base_table: product_stats
base_field: id
display:
  default:
    display_options:
      fields:
        title:
          id: title
          table: node_field_data
          field: title
          relationship: nid
        price:
          id: price
          table: node__field_price
          field: field_price_value
        discount_percent:
          id: discount_percent
          table: product_stats
          field: discount_percent
        stock:
          id: stock
          table: product_stats
          field: stock_quantity
      filters:
        status:
          value: '1'
        discount_percent:
          id: discount_percent
          table: product_stats
          field: discount_percent
          operator: '>=,'
          value: { min: '', max: '' }
          expose:
            operator: 'discount_percent_op'
            identifier: discount
      sorts:
        stock_quantity:
          order: ASC
      pager:
        type: some
        options: { items_per_page: 10 }
      relationships:
        nid:
          id: nid
          table: product_stats
          field: node_id
          relationship: node_field_data
          required: true
      style:
        type: html_list
      row:
        type: fields
  block_1:
    display_plugin: block

Хук для кастомного фильтра:

<?php

use Drupal\views\ViewExecutable;
use Drupal\views\Plugin\views\query\QueryPluginBase;

function my_module_views_query_alter(ViewExecutable $view, QueryPluginBase $query): void {
    if ($view->id() !== 'discount_products') {
        return;
    }

    $discount = \Drupal::request()->query->get('discount');

    if (!empty($discount['min'])) {
        $query->addWhereExpression(0, 'product_stats.discount_percent >= :min', [':min' => (float) $discount['min']]);
    }

    if (!empty($discount['max'])) {
        $query->addWhereExpression(0, 'product_stats.discount_percent <= :max', [':max' => (float) $discount['max']]);
    }
}

Плагин строки для карточки товара:

<?php

namespace Drupal\my_module\Plugin\views\row;

use Drupal\views\Plugin\views\row\RowPluginBase;
use Drupal\views\ResultRow;

/**
 * @ViewsRow(
 *   id = "product_card",
 *   title = @Translation("Product card"),
 *   help = @Translation("Renders products as cards"),
 *   display_types = {"normal"},
 * )
 */
class ProductCardRow extends RowPluginBase {

  public function render(ResultRow $row): array {
    $node = $row->_entity;
    $view_builder = \Drupal::entityTypeManager()->getViewBuilder('node');

    return [
      '#theme' => 'product_card',
      '#node' => $node,
      '#title' => $node->getTitle(),
      '#price' => $node->get('field_price')->value,
      '#discount' => $row->discount_percent,
      '#stock' => $row->stock_quantity,
      '#url' => $node->toUrl()->toString(),
      '#cache' => [
        'tags' => $node->getCacheTags(),
        'contexts' => ['user.roles'],
      ],
    ];
  }

}

Программное использование View:

<?php
use Drupal\views\Views;

$view = Views::getView('discount_products');
$view->setDisplay('block_1');
$view->setExposedInput(['discount' => ['min' => 20, 'max' => 50]]);
$view->execute();
$results = $view->result;
foreach ($results as $row) {
    $node = $row->_entity;
    // render
}

Регистрация кастомной таблицы для Views:

<?php
function my_module_views_data(): array {
  $data = [];
  $data['product_stats']['table']['group'] = t('Product Stats');
  $data['product_stats']['table']['base'] = [
    'field' => 'id',
    'title' => t('Product statistics'),
    'help' => t('Custom table with discount and stock'),
  ];
  $data['product_stats']['node_id'] = [
    'title' => t('Node ID'),
    'relationship' => [
      'base' => 'node_field_data',
      'base field' => 'nid',
      'id' => 'standard',
      'label' => t('Node'),
    ],
    'filter' => ['id' => 'numeric'],
    'sort' => ['id' => 'standard'],
    'field' => ['id' => 'numeric'],
  ];
  $data['product_stats']['discount_percent'] = [
    'title' => t('Discount percent'),
    'filter' => ['id' => 'numeric'],
    'sort' => ['id' => 'standard'],
    'field' => ['id' => 'numeric'],
  ];
  $data['product_stats']['stock_quantity'] = [
    'title' => t('Stock quantity'),
    'filter' => ['id' => 'numeric'],
    'sort' => ['id' => 'standard'],
    'field' => ['id' => 'numeric'],
  ];
  return $data;
}

Сравнение подходов: hook vs плагин

Процесс работы: от аналитики до деплоя

Что входит в разработку кастомных Views

• Кастомные плагины фильтров, сортировок, полей и строк
• REST Export display с настройкой CORS
• Интеграция с кастомными таблицами БД
• Документация по использованию и доработке
• Гарантия совместимости с актуальными версиями Drupal

Сроки и стоимость

Сроки зависят от сложности: простой кастомный фильтр — от полдня, комплексный проект с таблицей и REST — 2–3 дня. Стоимость рассчитывается индивидуально. В среднем такие доработки экономят до 60% бюджета по сравнению с костылями в шаблонах. Свяжитесь с нами — оценим ваш проект. Получите консультацию по архитектуре и оптимизации.

Подробнее о Views API читайте в официальной документации Drupal. Закажите разработку — получите готовое решение с гарантией совместимости и производительности.