Розробка кастомної теми WordPress: ACF, Vite, Core Web Vitals

Розробка кастомної теми WordPress: від дизайну до деплою

Готовий шаблон не завжди вписується в дизайн: медичний портал вимагає суворого порядку полів, а інтернет-магазин — нестандартної фільтрації. Тільки кастомна тема дає повний контроль — продуктивність без баласту сторонніх фреймворків, точну відповідність фірмовому стилю та гнучкість під специфічні завдання. Ми розробляємо теми з нуля на PHP 8.3+ з сучасним стеком: SCSS, TypeScript, Vite. За 10+ років ми створили понад 100 кастомних тем для SaaS, медіа та e-commerce — кожна оптимізована під Core Web Vitals.

Найчастіше клієнти приходять з готовим дизайном у Figma та вимогами: LCP < 2.5s, CLS < 0.1, підтримка кастомних полів без плагінів. Ми не використовуємо page builders — лише чистий код, який не гальмує адмінку та не потребує постійних оновлень сумісності. Кожен проєкт починається з аудиту макетів: виявляємо вузькі місця ще до написання першого рядка PHP.

Які проблеми вирішує кастомна тема?

Готовий шаблон часто програє кастомній розробці в 3 рази за швидкістю завантаження (дані Lighthouse). Ось типові болі:

• Hydration mismatch — при використанні SSR з React-віджетами в адмінці.
• N+1 запитів у циклі WordPress — кастомна логіка лінивого завантаження коментарів через REST API.
• Надлишковий CSS — у темі лише ті стилі, що потрібні: жодного Bootstrap з 200 КБ невикористовуваних правил.
• Конфлікти оновлень — комерційні шаблони часто ламаються після оновлення WordPress. Кастомна тема під контролем на Git.

Ми вирішуємо ці проблеми на етапі архітектури: використовуємо Repository pattern для запитів, оптимізуємо TTFB через Redis-кеш та вимикаємо непотрібні хуки. Згідно з HTTP Archive, кастомні теми мають на 30% кращий LCP.

Як ми будуємо тему: від каркаса до деплою

Наш підхід — модульна структура, де кожен компонент живе у своєму файлі. Ось мінімальний скелет, з якого починаємо:

my-theme/
├── style.css
├── functions.php
├── index.php
├── header.php
├── footer.php
├── single.php
├── page.php
├── archive.php
├── search.php
├── 404.php
├── front-page.php
├── template-parts/
├── inc/
├── src/
└── package.json

functions.php: правильна архітектура

<?php
// Підключаємо модульно, не пишемо все в один файл
require get_template_directory() . '/inc/theme-setup.php';
require get_template_directory() . '/inc/enqueue.php';
require get_template_directory() . '/inc/custom-post-types.php';

// inc/theme-setup.php
function mytheme_setup(): void {
    add_theme_support('title-tag');
    add_theme_support('post-thumbnails');
    add_theme_support('html5', ['search-form', 'comment-form', 'gallery', 'caption', 'style', 'script']);
    add_theme_support('custom-logo', [
        'height' => 60,
        'width' => 200,
        'flex-height' => true,
    ]);
    add_theme_support('woocommerce'); // якщо потрібно

    load_theme_textdomain('mytheme', get_template_directory() . '/languages');

    register_nav_menus([
        'primary' => __('Головне меню', 'mytheme'),
        'footer'  => __('Меню підвалу', 'mytheme'),
    ]);
}
add_action('after_setup_theme', 'mytheme_setup');

// inc/enqueue.php
function mytheme_enqueue_assets(): void {
    $theme_version = wp_get_theme()->get('Version');
    wp_enqueue_style(
        'mytheme-style',
        get_template_directory_uri() . '/dist/css/main.css',
        [],
        $theme_version
    );
    wp_enqueue_script(
        'mytheme-main',
        get_template_directory_uri() . '/dist/js/main.js',
        [],
        $theme_version,
        ['strategy' => 'defer', 'in_footer' => true]
    );
    wp_localize_script('mytheme-main', 'siteData', [
        'ajaxUrl' => admin_url('admin-ajax.php'),
        'nonce'   => wp_create_nonce('mytheme_nonce'),
        'homeUrl' => home_url(),
    ]);
}
add_action('wp_enqueue_scripts', 'mytheme_enqueue_assets');

Збірка фронтенду: Vite проти Webpack

Для швидкої розробки ми використовуємо Vite — він дає миттєвий HMR та легкі білди. Конфіг під WordPress стандартний:

// vite.config.js
import { defineConfig } from 'vite';
import liveReload from 'vite-plugin-live-reload';

export default defineConfig({
  plugins: [liveReload('**/*.php')],
  build: {
    outDir: 'dist',
    rollupOptions: {
      input: {
        main: 'src/js/main.js',
        admin: 'src/js/admin.js',
      },
    },
  },
  css: {
    preprocessorOptions: {
      scss: { additionalData: '@use "src/scss/variables" as *;' },
    },
  },
});

ACF для кастомних полів

Кастомні поля через ACF Pro — стандарт для складних тем. Реєстрація через PHP гарантує версіонування та переносимість:

// Реєстрація полів через PHP (не через UI — для версіонування)
if (function_exists('acf_add_local_field_group')) {
    acf_add_local_field_group([
        'key' => 'group_hero_section',
        'title' => 'Секція Hero',
        'fields' => [
            [
                'key' => 'field_hero_heading',
                'label' => 'Заголовок',
                'name' => 'hero_heading',
                'type' => 'text',
            ],
            [
                'key' => 'field_hero_image',
                'label' => 'Фонове зображення',
                'name' => 'hero_image',
                'type' => 'image',
                'return_format' => 'array',
            ],
        ],
        'location' => [
            [['param' => 'page_template', 'operator' => '==', 'value' => 'template-home.php']],
        ],
    ]);
}

При реєстрації через UI поля зберігаються в базі та легко втрачаються при перенесенні. Наш підхід — тільки PHP-код, який версіонується в Git.

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

• Вихідний код теми на Git (з історією комітів)
• Інструкція з деплою (Composer, npm scripts)
• Стилізація під Pixel Perfect (адаптив до 320px)
• Оптимізація під Core Web Vitals (LCP < 2.5s, CLS < 0.1)
• Базова налаштування SEO (Schema.org, Open Graph)
• Тестування на 3 останніх версіях WordPress та PHP 8.1–8.3

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

1. Аналіз дизайн-макетів та вимог (1–2 дні)
2. Проектування каркаса теми, реєстрація кастомних типів (2–3 дні)
3. Верстка шаблонів та підключення збірника (5–10 днів)
4. Інтеграція ACF та кастомних полів (2–3 дні)
5. Тестування на швидкість та деплой (1–2 дні)

Чому кастомна тема вигідніша за готовий шаблон?

Готовий шаблон економить час на старті, але через рік ви втрачаєте гроші на доопрацюваннях та оптимізації. Кастомна тема не містить мертвого коду, легко розширюється та не потребує постійних патчів сумісності. Середня економія на хостингу — 30% завдяки зниженню навантаження на сервер. При однакових умовах хостингу кастомна тема завантажується в 2 рази швидше за готовий шаблон.

Терміни

Базова тема з шаблонами (головна, блог, сторінка, 404) без дизайну — 2–3 дні. Тема за готовим дизайном з 10–15 типами сторінок, ACF-полями та кастомними типами записів — 2–3 тижні. Терміни можуть варіюватися залежно від складності.

Зв'яжіться з нами для оцінки вашого проєкту. Отримайте консультацію, і ми підготуємо кошторис.

Розробка 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). Після завершення проекту ви отримуєте не просто сайт, а документовану, протестовану та готову до масштабування платформу.

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