Кастомний плагін WooCommerce: коли готові аддони безсилі

Один наш клієнт торгував обладнанням з відстрочкою платежу та накопичувальними знижками залежно від загальної суми замовлень. Стандартний WooCommerce не вмів ні розраховувати такі знижки, ні створювати кастомний статус «Очікує відправлення». Довелося розробляти кастомний плагін з нуля. Підсумок — повністю автоматизована система лояльності та процесу відвантаження, що обробляє до 200 замовлень на день. Такі завдання не вирішити готовими аддонами.

WooCommerce побудований на хуках WordPress і власному шарі фільтрів — action та filter для кожного етапу: замовлення, товар, платіж. Кастомний плагін — це бізнес-логіка, яка не покривається стандартними модулями: нестандартне ціноутворення, інтеграція з ERP, кастомні статуси, поля товару, звіти. Розробка плагіна середньої складності займає 5–10 робочих днів. Наша команда має 5+ років досвіду в WooCommerce та реалізувала понад 30 кастомних рішень, включаючи інтеграції з 1С та CRM.

Як додати кастомні статуси замовлень у WooCommerce?

Реєструємо статус через register_post_status з префіксом wc-, потім додаємо його до списку статусів через фільтр wc_order_statuses. Можна задати колір бейджа в адмінці та налаштувати надсилання листа при переході в статус.

Покрокова інструкція:

1. Зареєструвати статус за допомогою register_post_status.
2. Додати статус у масив wc_order_statuses через фільтр.
3. (Опціонально) Призначити колір бейджа та email-сповіщення.

Приклад коду:

add_action('init', function () {
    register_post_status('wc-awaiting-delivery', [
        'label'                     => 'Ожидает отправки',
        'public'                    => true,
        'show_in_admin_status_list' => true,
        'show_in_admin_all_list'    => true,
        'exclude_from_search'       => false,
        'label_count'               => _n_noop('Ожидает отправки <span class="count">(%s)</span>', 'Ожидает отправки <span class="count">(%s)</span>'),
    ]);
});

add_filter('wc_order_statuses', function (array $statuses): array {
    $statuses['wc-awaiting-delivery'] = 'Ожидает отправки';
    return $statuses;
});

Чому важлива інтеграція з HPOS (High-Performance Order Storage)?

Починаючи з WooCommerce 7.1, замовлення зберігаються в окремих таблицях wc_orders, а не в wp_posts. При роботі з замовленнями використовуйте тільки WC_Order API — прямі SQL-запити зламаються при увімкненому HPOS. Кастомний плагін повинен декларувати сумісність через FeaturesUtil::declare_compatibility:

add_action('before_woocommerce_init', function () {
    if (class_exists(\Automattic\WooCommerce\Utilities\FeaturesUtil::class)) {
        \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility(
            'custom_order_tables',
            __FILE__,
            true
        );
    }
});

Використання wc_get_orders з параметрами гарантує роботу на обох сховищах.

Приклад реалізації накопичувальної знижки

Система лояльності: чим більше клієнт витратив, тим вища знижка на поточне замовлення. Реалізуємо через woocommerce_cart_calculate_fees:

add_action('woocommerce_cart_calculate_fees', function (WC_Cart $cart): void {
    if (is_admin() && !defined('DOING_AJAX')) return;
    $user_id = get_current_user_id();
    if (!$user_id) return;
    $total_spent = wc_get_customer_total_spent($user_id);
    $discount_pct = 0;
    if ($total_spent >= 100000) $discount_pct = 10;
    elseif ($total_spent >= 50000) $discount_pct = 7;
    elseif ($total_spent >= 20000) $discount_pct = 5;
    if ($discount_pct > 0) {
        $cart->add_fee(sprintf('Накопительная скидка %d%%', $discount_pct), -($cart->get_subtotal() * $discount_pct / 100), true);
    }
});

Що таке Action Scheduler і як його використовувати для фонових завдань?

Action Scheduler — це вбудований у WooCommerce менеджер фонових завдань. Він заснований на таблицях WordPress і надійніший за стандартний wp_cron: повторює завдання при помилках, має UI для моніторингу.

Приклад синхронізації залишків:

as_schedule_single_action(time() + 60, 'my_plugin_sync_stock', ['supplier_id' => 42], 'my-plugin');

add_action('my_plugin_sync_stock', function (int $supplier_id): void {
    $items = fetch_supplier_stock($supplier_id);
    foreach ($items as $sku => $qty) {
        $product_id = wc_get_product_id_by_sku($sku);
        if ($product_id) {
            $product = wc_get_product($product_id);
            $product->set_stock_quantity($qty);
            $product->save();
        }
    }
});

Кастомні поля товару: коли це потрібно?

Якщо товар потребує додаткових атрибутів (виробник, країна походження, сертифікація), додаємо вкладку в редактор товару через woocommerce_product_data_tabs та поля через woocommerce_product_data_panels. Дані зберігаються як post meta. Це дозволяє фільтрувати товари в адмінці та виводити інформацію на вітрині.

Порівняння кастомного плагіна та готового аддона

Типові помилки при розробці кастомних плагінів WooCommerce

Що входить у розробку кастомного плагіна WooCommerce

• Аналіз бізнес-вимог та проектування архітектури
• Написання коду з дотриманням стандартів WordPress та WooCommerce
• Інтеграція з HPOS та актуальними версіями
• Документація API та коду (у форматі README)
• Передача доступів до плагіна та інструкція з встановлення
• Гарантійна підтримка 1 місяць після здачі

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

Вартість розраховується індивідуально після брифу. Орієнтовні терміни:

• Плагін з кастомними полями та статусами: від 3 до 5 днів
• Плагін зі складною логікою знижок та інтеграцією API: від 8 до 12 днів
• Плагін з фоновими завданнями та синхронізацією ERP: від 10 до 15 днів

Бажаєте автоматизувати свій інтернет-магазин? Отримайте консультацію щодо вашого проєкту — ми проаналізуємо вимоги та запропонуємо оптимальне рішення. Замовте розробку кастомного плагіна WooCommerce та позбудьтеся обмежень готових рішень. Гарантуємо сумісність з останніми версіями WooCommerce та досвід 5+ років у розробці.

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

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