Разработка кастомных Plugin blocks Drupal под ключ

Проблема: готовых блоков недостаточно

80% наших клиентов сталкиваются с тем, что стандартные блоки Drupal не покрывают бизнес-требования. Content blocks статичны, они не позволяют реализовать динамический контент с конфигурацией — персонализированные виджеты, списки с условиями, интеграции с API. Без программирования не обойтись. Мы разрабатываем Plugin blocks на PHP, используя Drupal Plugin API, и настраиваем кэширование так, чтобы сайт летал.

Недавно к нам обратился клиент с задачей: вывести на главной странице блок с последними твитами сотрудников. Content blocks не позволяли автоматически подтягивать данные из соцсети. Мы создали Plugin block с интеграцией по API, с настройками количества твитов и фильтрацией по хештегам. Блок обновляется каждые 15 минут, кэш инвалидируется по тегам. Производительность не пострадала — LCP остался на уровне 1.2 секунды.

Как создать плагин-блок с конфигурацией?

Рассмотрим типичный пример: блок «Последние новости» с настройкой количества и опцией исключения текущей страницы. Вот полный код такого блока с использованием dependency injection и правильным кэшированием:

// src/Plugin/Block/LatestNewsBlock.php
namespace Drupal\my_module\Plugin\Block;

use Drupal\Core\Block\BlockBase;
use Drupal\Core\Cache\Cache;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Plugin\ContainerFactoryPluginInterface;
use Drupal\Core\Entity\EntityTypeManagerInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * @Block(
 *   id = "my_module_latest_news",
 *   admin_label = @Translation("Latest News"),
 *   category = @Translation("My Module"),
 *   context_definitions = {
 *     "node" = @ContextDefinition("entity:node", required = FALSE, label = @Translation("Current node"))
 *   }
 * )
 */
class LatestNewsBlock extends BlockBase implements ContainerFactoryPluginInterface {

  public function __construct(
    array $configuration,
    $plugin_id,
    $plugin_definition,
    private readonly EntityTypeManagerInterface $entityTypeManager,
  ) {
    parent::__construct($configuration, $plugin_id, $plugin_definition);
  }

  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition): static {
    return new static(
      $configuration,
      $plugin_id,
      $plugin_definition,
      $container->get('entity_type.manager'),
    );
  }

  public function blockForm($form, FormStateInterface $form_state): array {
    $config = $this->getConfiguration();
    $form['count'] = [
      '#type' => 'number',
      '#title' => $this->t('Number of items'),
      '#default_value' => $config['count'] ?? 4,
      '#min' => 1,
      '#max' => 20,
    ];
    $form['exclude_current'] = [
      '#type' => 'checkbox',
      '#title' => $this->t('Exclude current node'),
      '#default_value' => $config['exclude_current'] ?? TRUE,
    ];
    return $form;
  }

  public function blockSubmit($form, FormStateInterface $form_state): void {
    $this->configuration['count'] = $form_state->getValue('count');
    $this->configuration['exclude_current'] = $form_state->getValue('exclude_current');
  }

  public function build(): array {
    $config = $this->getConfiguration();
    $count = $config['count'] ?? 4;
    $storage = $this->entityTypeManager->getStorage('node');
    $query = $storage->getQuery()
      ->condition('type', 'news')
      ->condition('status', 1)
      ->sort('created', 'DESC')
      ->range(0, $count)
      ->accessCheck(TRUE);
    if ($config['exclude_current'] ?? TRUE) {
      try {
        $current_node = $this->getContextValue('node');
        if ($current_node && $current_node->id()) {
          $query->condition('nid', $current_node->id(), '<>');
        }
      } catch (\Exception $e) {}
    }
    $ids = $query->execute();
    if (empty($ids)) {
      return ['#markup' => ''];
    }
    $nodes = $storage->loadMultiple($ids);
    $view_builder = $this->entityTypeManager->getViewBuilder('node');
    return [
      '#theme' => 'my_module_news_list',
      '#items' => array_map(fn($n) => $view_builder->view($n, 'teaser'), $nodes),
      '#cache' => [
        'tags' => Cache::mergeTags(['node_list:news'], $this->getCacheTags()),
        'contexts' => ['route', 'user.roles'],
        'max-age' => Cache::PERMANENT,
      ],
    ];
  }

  public function getCacheTags(): array {
    return Cache::mergeTags(parent::getCacheTags(), ['node_list:news']);
  }

}

Content blocks vs Plugin blocks: что выбрать?

Plugin blocks выигрывают в гибкости и скорости. Content blocks подходят для статического контента, который правят редакторы.

Почему важно правильно настроить кэширование?

Кастомный блок может стать узким местом, если проигнорировать кэширование. Типичная ошибка — выставлять max-age = 0 для всех блоков. Это убивает производительность. Мы используем комбинацию:

• cache_tags — инвалидация при изменении данных (например, при создании новой новости);
• cache_contexts — вариации для разных ролей, языков, URL;
• max-age = Cache::PERMANENT — блок кэшируется до инвалидации.

Правильное кэширование даёт прирост скорости до 10 раз по сравнению с некешированным решением.

Стратегии кэширования

Что входит в работу?

При заказе разработки кастомных блоков под ключ мы выполняем:

• Анализ требований и проектирование структуры блоков;
• Реализацию плагин-блоков с конфигурацией (blockForm, build, кэширование);
• Интеграцию с Layout Builder (если требуется);
• Создание Content block types с кастомными полями (для редакторов);
• Документирование кода и инструкции для редакторов;
• Тестирование на производительность и совместимость;
• Передачу готовых блоков с гарантией работы.

Подробнее о Plugin API см. официальную документацию Drupal.

Этапы разработки

1. Аналитика — выявляем функциональные требования, определяем типы данных и условия отображения.
2. Проектирование — создаём схему блоков, продумываем кэширование и структуру конфигурации.
3. Реализация — пишем Plugin blocks с dependency injection, формами настроек и рендером.
4. Тестирование — проверяем на различных страницах, с разными ролями, с нагрузкой.
5. Деплой — размещаем блоки, конфигурацию экспортируем в YAML, передаём документацию.

Сроки: один простой блок — 1 день, набор сложных (с формами, Layout Builder, интеграцией) — 3–5 дней. Точную оценку даём после анализа.

Зачем заказывать кастомные блоки?

Стандартные блоки не решают задач, требующих динамики и гибкости. Plugin blocks дают полный контроль над логикой и кэшированием. За 10 лет работы мы создали более 50 блоков для разных проектов — от персонализированных виджетов до сложных форм с AJAX. Экономия времени на разработку составляет до 40% по сравнению с созданием аналогичного функционала через UI.

Хотите получить такой же результат? Свяжитесь с нами для консультации — мы оценим задачу и предложим оптимальное решение с гарантией качества. Сертифицированные специалисты Drupal с большим опытом. Закажите разработку кастомных блоков, и мы реализуем любую логику с максимальной производительностью.