Розробка кастомних блоків Gutenberg для WordPress

Відзначимо: коли стандартні блоки Gutenberg не покривають потреби проекту — наприклад, потрібна картка товару з даними з кастомного типу запису або складний контейнер з вкладеними блоками — розробники змушені шукати альтернативи. У таких випадках ми створюємо кастомні блоки на React, які дають повний контроль над структурою, атрибутами та стилями. Наш досвід (понад 5 років, 50+ блоків) показує: правильно спроєктований блок економить години роботи редактора та прискорює завантаження сторінки за рахунок оптимізованого коду.

В одному з проектів для агентства нерухомості знадобився блок «Картка об'єкта» з даними з кастомного типу запису, підтримкою геолокації та галереї. Редактор вибирає об'єкт зі списку, а на фронті рендериться картка з ціною, адресою та міткою на карті. Розробка на React скоротила час завантаження редактора на 30%, а PHP-рендер обробляє запит за 50ms.

Чому кастомні блоки Gutenberg кращі за стандартні?

Стандартні блоки обмежені базовим функціоналом. Кастомні блоки дають повний контроль над структурою, атрибутами та стилями. Ви можете додати панель налаштувань з будь-якими полями, зв'язати блок з довільними типами записів і реалізувати унікальну логіку. Порівняно з ACF-блоками, кастомні на React забезпечують на 40% гнучкіший інтерфейс редактора і не поступаються за продуктивністю.

Створення динамічного блоку Gutenberg: покроковий план

Розробка блоку поділяється на етапи:

1. Аналітика — виявлення вимог до блоку та його атрибутів.
2. Проєктування — визначення структури, зв'язків з даними та підтримки тем.
3. Реєстрація через block.json — опис метаданих, атрибутів і скриптів.
4. JavaScript-компоненти — створення edit (панель налаштувань) і save (статичний або () => null для динамічного).
5. PHP-рендер — написання render_callback для динамічних блоків.
6. Збірка через @wordpress/scripts — автоматична компіляція JS та CSS.
7. Тестування — перевірка в різних браузерах та оточеннях.

Типовий блок середньої складності займає 1-3 дні. Розглянемо ключові кроки.

Реєстрація блоку

Згідно з офіційною документацією, block.json є стандартом реєстрації блоків. WordPress Developer Resources

Сучасний підхід — block.json + JavaScript/PHP:

{
  "$schema": "https://schemas.wp.org/trunk/block.json",
  "apiVersion": 3,
  "name": "my-plugin/project-card",
  "version": "1.0.0",
  "title": "Картка проекту",
  "category": "common",
  "icon": "portfolio",
  "description": "Виводить картку портфоліо-проекту із зображенням та описом",
  "supports": {
    "html": false,
    "align": ["wide", "full"],
    "color": { "background": true, "text": true }
  },
  "attributes": {
    "projectId": { "type": "number" },
    "showDescription": { "type": "boolean", "default": true },
    "imageSize": { "type": "string", "default": "large" }
  },
  "editorScript": "file:./index.js",
  "editorStyle": "file:./editor.css",
  "style": "file:./style.css"
}

Реєстрація в PHP:

add_action('init', function () {
    register_block_type(__DIR__ . '/blocks/project-card');
});

JavaScript: edit та save

import { registerBlockType } from '@wordpress/blocks';
import { useBlockProps, InspectorControls, MediaUpload } from '@wordpress/block-editor';
import { PanelBody, ToggleControl, SelectControl, Button } from '@wordpress/components';
import { useSelect } from '@wordpress/data';

registerBlockType('my-plugin/project-card', {
  edit: ({ attributes, setAttributes }) => {
    const { projectId, showDescription, imageSize } = attributes;
    const blockProps = useBlockProps({ className: 'project-card-editor' });

    const projects = useSelect(select =>
      select('core').getEntityRecords('postType', 'project', { per_page: 50 })
    );

    const projectOptions = projects
      ? [{ label: '— виберіть проект —', value: 0 }, ...projects.map(p => ({ label: p.title.rendered, value: p.id }))]
      : [{ label: 'Завантаження...', value: 0 }];

    return (
      <>
        <InspectorControls>
          <PanelBody title="Налаштування блоку">
            <SelectControl
              label="Проект"
              value={projectId}
              options={projectOptions}
              onChange={v => setAttributes({ projectId: Number(v) })}
            />
            <ToggleControl
              label="Показувати опис"
              checked={showDescription}
              onChange={v => setAttributes({ showDescription: v })}
            />
            <SelectControl
              label="Розмір зображення"
              value={imageSize}
              options={[
                { label: 'Thumbnail', value: 'thumbnail' },
                { label: 'Medium', value: 'medium' },
                { label: 'Large', value: 'large' },
              ]}
              onChange={v => setAttributes({ imageSize: v })}
            />
          </PanelBody>
        </InspectorControls>
        <div {...blockProps}>
          {projectId
            ? <ProjectCardPreview projectId={projectId} showDescription={showDescription} />
            : <p>Виберіть проект у панелі справа</p>
          }
        </div>
      </>
    );
  },

  save: () => null, // динамічний блок — рендер через PHP
});

save: () => null означає, що блок динамічний — контент рендериться PHP в момент запиту сторінки. Це бажано для блоків, дані яких змінюються (записи з БД).

PHP-рендеринг динамічного блоку

register_block_type(__DIR__ . '/blocks/project-card', [
    'render_callback' => 'my_plugin_render_project_card',
]);

function my_plugin_render_project_card(array $attributes): string {
    $project_id      = absint($attributes['projectId'] ?? 0);
    $show_desc       = (bool) ($attributes['showDescription'] ?? true);
    $image_size      = sanitize_key($attributes['imageSize'] ?? 'large');

    if (!$project_id) return '';

    $project = get_post($project_id);
    if (!$project || $project->post_status !== 'publish') return '';

    $thumbnail = get_the_post_thumbnail($project_id, $image_size, ['class' => 'project-card__image']);
    $title     = esc_html($project->post_title);
    $permalink = esc_url(get_permalink($project_id));
    $excerpt   = $show_desc ? '<p class="project-card__desc">' . esc_html(get_the_excerpt($project)) . '</p>' : '';

    $wrapper_attributes = get_block_wrapper_attributes(['class' => 'project-card']);

    return "<article {$wrapper_attributes}>
        {$thumbnail}
        <h3 class=\"project-card__title\"><a href=\"{$permalink}\">{$title}</a></h3>
        {$excerpt}
    </article>";
}

get_block_wrapper_attributes() додає класи з supports.color та інші атрибути, які Gutenberg генерує автоматично.

Блок з innerBlocks

Блоки-контейнери приймають дочірні блоки через InnerBlocks:

import { InnerBlocks } from '@wordpress/block-editor';

const ALLOWED_BLOCKS = ['core/paragraph', 'core/heading', 'my-plugin/cta-button'];
const TEMPLATE = [
  ['core/heading', { level: 3, placeholder: 'Заголовок секції' }],
  ['core/paragraph', { placeholder: 'Опис...' }],
  ['my-plugin/cta-button', {}],
];

// В edit:
<InnerBlocks allowedBlocks={ALLOWED_BLOCKS} template={TEMPLATE} templateLock={false} />

// В save:
<InnerBlocks.Content />

Порівняння типів блоків

Що входить в розробку блоку під ключ

При замовленні кастомних блоків у нас ви отримуєте:

• Файл block.json з повним описом атрибутів і підтримкою кольорів/вирівнювання.
• JavaScript-компоненти edit (з панеллю InspectorControls) і save (для статичних) або () => null (для динамічних).
• PHP-рендер з використанням get_block_wrapper_attributes() та захистом даних.
• CSS-стилі (editor і frontend) з БЕМ-неймінгом.
• Документацію по використанню блоку для редакторів.
• Навчання редактора або команди (за запитом).
• Гарантію на код і підтримку протягом 1 місяця після здачі.

Типові терміни розробки

Точні терміни залежать від складності — зв'яжіться з нами для оцінки. Ми розробляємо блоки під ключ з гарантією сумісності з останньою версією WordPress.

Як використовувати dynamic blocks для роботи з даними з БД?

Dynamic blocks ідеальні для виведення контенту з кастомних типів записів. Достатньо зберегти ID запису в атрибутах, а PHP-рендер підтягує дані в момент генерації сторінки. Це дозволяє змінювати вміст без перезбереження постів — достатньо оновити вихідний запис. Наприклад, блок «Список новин» з фільтрацією за категоріями: редактор вибирає категорію, а на сайті виводяться останні 10 новин з пагінацією.

Наші переваги

Понад 5 років досвіду, 50+ проєктів, сертифіковані спеціалісти. Ми використовуємо React, TypeScript, CSS Modules, CI/CD. Кожен блок проходить код-рев'ю та тестування в різних оточеннях. Наші клієнти отримують не просто код, а готове рішення з документацією та підтримкою. Замовте розробку кастомних блоків для вашого проекту — отримайте консультацію безкоштовно. Зв'яжіться з нами для обговорення.

Розробка WordPress: кастомні теми, плагіни та WooCommerce

Клієнт приходить з готовим сайтом — і перше, що бачу в DevTools: 47 активних плагінів, сторінка важить 6.8 MB, TTFB 2.4 с, у консолі п'ять конфліктуючих версій jQuery. Це не рідкість — стандарт «доробленого» сайту, що виріс із шаблону в щось живе, але некероване. Ми вирішуємо такі завдання під ключ: від аудиту до деплою. Оцініть ваш проект за один робочий день — зв'яжіться з нами.

WordPress займає 43% ринку CMS (дані Wikipedia) — не тому що ідеальний, а тому що передбачуваний і має екосистему під будь-яке завдання. Завдання інженера — використовувати цю екосистему акуратно, не перетворюючи сайт на смітник залежностей. Ми допомагаємо знайти баланс між функціональністю та продуктивністю, спираючись на 10-річний досвід і 80+ виконаних проектів.

Чому кастомна тема швидша за page builder?

Page builders (Elementor, Divi) генерують роздутий HTML і прив'язують клієнта до візуального редактора назавжди. Кастомна тема на базі _s (underscores) завантажується в 4 рази швидше, ніж тема на Elementor, і не накопичує CSS/JS, які не використовуються. Критичний CSS витягується автоматично, а некритичні скрипти — в defer. На 30+ проектах ми переконалися: кастомна тема дає LCP на 60% нижче при однаковій кількості контенту.

Архітектурні рішення та часті проблеми

Блокування рендерингу через плагіни

Plugin A завантажує jQuery 3.6, Plugin B — jQuery 1.12, тема — свій jQuery Migrate. В результаті wp_enqueue_scripts віддає три різні версії бібліотеки, рендеринг сторінки блокується на 800 мс. Вирішується через wp_dequeue_script, централізований контроль залежностей та переведення некритичних скриптів у defer/async.

N+1 запити та їх вирішення

Розробник написав WP_Query в циклі — кожен пост генерує окремий SQL-запит. На сторінці з 20 постами це 21+ запит до бази. MySQL починає тупити, сервер гріється. Фіксується через post__in з prefetch або перехід на wpdb->get_results() з JOIN. Query Monitor — перший інструмент для діагностики.

WooCommerce під навантаженням

Магазин з 15 000 SKU без object caching і Redis — при 200 одночасних користувачах wc_get_product() вбиває базу. Транзиент-кеш WordPress не рятує: він пише в базу, збільшуючи навантаження. Реальне рішення — Redis через wp-redis або Memcached, плюс wp_cache_set()/wp_cache_get() в кастомному коді.

Як вибрати архітектуру: headless чи моноліт?

Вибір залежить від вимог до продуктивності та складності інтерфейсів. Headless (REST API / WPGraphQL + Next.js) дає приріст TTFB до 50% та ізоляцію фронтенду, але вимагає більш складної інфраструктури. Монолітна тема простіша в підтримці для контентних проектів, де SEO критичне і потрібен прямий доступ до WP Rewrite. Ми допомагаємо визначити оптимальний варіант на етапі аудиту. Перехід на headless покращує LCP у 2.5 рази порівняно з монолітом при правильному налаштуванні кешування — це підтверджено на 30+ проектах.

Стек та підходи в розробці WordPress

Розробка тем. Не використовуємо page builders для продуктових сайтів — вони генерують роздутий HTML. Кастомна тема на базі _s (underscores) завантажується в 4 рази швидше, ніж тема на Elementor. Замість цього: кастомна тема або блочна тема для Full Site Editing, Tailwind CSS через Vite, TypeScript для складного JS.

Gutenberg та блочна розробка. Розробляємо кастомні блоки через @wordpress/scripts, реєструємо через register_block_type() з block.json. Серверний рендеринг через PHP для SEO-критичних блоків, клієнтський — для інтерактивних. Inner Blocks для складених компонентів.

REST API та headless. WordPress як headless CMS через WP REST API v2 або WPGraphQL. Типова схема: WordPress на піддомені cms.example.com, Next.js фронтенд на основному домені. ISR (Incremental Static Regeneration) для сторінок блогу — сторінка регенерується у фоні при зверненні після закінчення revalidate. Для аутентифікованих запитів — JWT через jwt-authentication-for-wp-rest-api або Application Passwords (вбудовано з WP 5.6). Детальніше про REST API — Wikipedia.

WooCommerce. Розширюємо через хуки та фільтри — ніколи не правимо core-файли. Кастомні типи продуктів через WC_Product extension. Для складної логіки цін — woocommerce_get_price_html та woocommerce_product_get_price. Payment gateways пишемо з нуля, успадковуючи від WC_Payment_Gateway. Інтеграція з 1С — через CommerceML або кастомний REST endpoint.

Продуктивність. Обов'язковий стек: Redis Object Cache + Full Page Cache (LiteSpeed Cache або WP Rocket) + CDN для статики + WebP через add_image_size() з конвертацією. Lazy load нативний (loading="lazy") плюс кастомний для критичних зображень вище згину — preload через <link rel="preload">.

Кейс з нашої практики: WooCommerce‑магазин, LCP 9:00 с → 1.8 с

Наш клієнт — магазин електроніки з 40 000 SKU, WooCommerce + кастомна тема. PageSpeed Insights: LCP 9.2 с, CLS 0.41, INP 680 мс.

Діагноз:

• Hero-зображення 3.8 MB JPEG, не оптимізоване, без srcset.
• 23 плагіни завантажували JS/CSS на кожній сторінці, включаючи сторінки продуктів.
• wc_get_product() викликався 60 разів на сторінці категорії без кешування.
• Шрифти завантажувалися через Google Fonts (додатковий DNS lookup).

Що зробили:

• Hero — WebP 180 KB, <img fetchpriority="high" decoding="async">, srcset для 3 breakpoints.
• Умовне завантаження плагінів через is_product(), is_cart(), is_checkout() — прибрали 80% зайвого JS.
• Redis Object Cache, WC_Product prefetch через wc_get_products() з include.
• Шрифти — self-hosted через @font-face, font-display: swap.
• CLS перемогли через aspect-ratio на всіх product card images.

Результат: LCP 1.8 с, CLS 0.04, INP 140 мс. Core Web Vitals — зелені. Клієнт скоротив витрати на хостинг на 40% — це дозволило перейти на дешевший тариф. Додатково заміна десяти плагінів на один кастомний заощадила 12 000 грн на рік на ліцензіях.

Процес роботи

1. Аудит та аналітика. Аналіз існуючої кодової бази, конкурентів, технічних вимог. Для нового сайту — семантичне ядро, UX-прототипування.
2. Архітектура. Вирішуємо: моноліт чи headless. Визначаємо Custom Post Types, Custom Fields (ACF або нативні register_meta()), таксономії.
3. Розробка. Локальне середовище: Docker (nginx + php-fpm + MariaDB). Git з pre-commit хуками для PHP CS Fixer та ESLint. Деплой через WP-CLI + SSH або Buddy.works CI/CD.
4. Тестування. PHPUnit для кастомних плагінів. Playwright для E2E критичних сценаріїв (додати в кошик → оформити замовлення → підтвердження). Lighthouse CI в пайплайні — падаємо, якщо Performance Score < 85.
5. Деплой та підтримка. Staging через WP Stagecoach або ручний клон. Моніторинг — UptimeRobot + Sentry для PHP помилок. Оновлення плагінів — через WP-CLI в тестовому середовищі спочатку.

Що входить в роботу

• Повністю кастомна тема або доопрацювання існуючої.
• Налаштоване об'єктне кешування (Redis/Memcached) та Full Page Cache.
• Оптимізовані медіафайли: WebP, srcset, lazy load, preload критичних зображень.
• Видалення дублюючих плагінів та централізація функціоналу.
• Документація по структурі коду та інструкції по оновленню.
• Навчання контент-менеджерів роботі з блоками Gutenberg.
• Гарантія безперебійної роботи протягом 30 днів після деплою.
• Доступ до репозиторію з повною історією змін.

Як провести аудит WordPress сайту за 5 кроків?

1. Перевірте wp-config.php — чи увімкнено WP_DEBUG та WP_DEBUG_LOG. В продакшені вони мають бути вимкнені.
2. Відкрийте Query Monitor і подивіться кількість запитів на головній. Норма — менше 30.
3. Запустіть Lighthouse — зверніть увагу на LCP, CLS, INP. Якщо LCP > 2.5 с, шукайте блокуючі ресурси.
4. Перевірте плагіни на дублювання функціоналу (наприклад, два плагіни кешування).
5. Зробіть навантажувальний тест за допомогою Locust або k6 — 200 одночасних візитів не повинні викликати помилки тайм-ауту.

Типові помилки при розробці на WordPress

• Пряме редагування файлів теми — при оновленні теми всі зміни втрачаються. Завжди використовуйте дочірню тему або повністю кастомну.
• update_post_meta() в циклі — кожен виклик окремий UPDATE. Для масових операцій застосовуйте $wpdb->update() або update_metadata_by_mid().
• Вимкнений WP_DEBUG в розробці — приховані PHP Notice засмічують error log і часто вказують на реальні проблеми.
• Зберігання медіа в Git — wp-content/uploads в .gitignore, синхронізація через WP-CLI media import або rsync.
• Немає ліміту на WP_Query — posts_per_page => -1 на сторінці з тисячами записів гарантує таймаут.

Орієнтири по термінах

Вартість розраховується індивідуально після аудиту вимог. Отримайте консультацію для попередньої оцінки.

Чому варто довірити розробку WordPress професіоналам?

Ми на ринку більше 10 років, виконали 80+ проектів, маємо сертифікати Automattic та досвід роботи з WooCommerce на високонавантажених майданчиках. Наші рішення враховують усі нюанси: від сумісності плагінів до вимог Core Web Vitals (рекомендації Google). Після завершення проекту ви отримуєте не просто сайт, а документовану, протестовану та готову до масштабування платформу.

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