Розробка кастомного плагіна WooCommerce під бізнес-логіку з нуля

Кастомний плагін 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+ років у розробці.