Кастомні Views у Drupal: фільтри, плагіни, REST-експорт

---
# 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 чи плагін?

Кастомні плагіни працюють в 2 рази швидше за аналогічні через Preprocess, а також дають кращий контроль над кешуванням. Наприклад, кастомний плагін фільтра кращий за hook_views_query_alter в 2 рази за швидкодією. Важливо також враховувати контекстуальні фільтри та агрегацію для оптимізації запитів до бази даних.

Процес роботи: від аналітики до деплою

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

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

Терміни та вартість

Терміни залежать від складності: простий кастомний фільтр — від півдня, комплексний проєкт з таблицею та REST — 2–3 дні. Орієнтовна вартість: простий фільтр — від $150, комплексне рішення — від $400. При цьому економія порівняно з шаблонними рішеннями може сягати $200 на простому проєкті. У середньому такі доопрацювання економлять до 60% бюджету порівняно з костилями в шаблонах. Зв'яжіться з нами — оцінимо ваш проєкт. Отримайте консультацію з архітектури та оптимізації.

Детальніше про Views API читайте в офіційній документації Drupal. Замовте розробку — отримайте готове рішення з гарантією сумісності та продуктивності.