Розробка кастомних 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 з великим досвідом. Замовте розробку кастомних блоків, і ми реалізуємо будь-яку логіку з максимальною продуктивністю.