Разработка кастомного плагина 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+ лет в разработке.

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

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

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

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

Блокировка рендеринга из-за плагинов

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 типа Elementor для продуктовых сайтов — они генерируют раздутый HTML и привязывают клиента к визуальному редактору навсегда. Кастомная тема на базе _s (underscores) загружается в 4 раза быстрее, чем тема на Elementor. Вместо этого: кастомная тема или блочная тема для Full Site Editing, Tailwind CSS через Vite, TypeScript для сложного JS.

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

REST API и headless. WordPres как 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 — зелёные. Клиент сократил расходы на хостинг на 240 000 руб в год после перехода на более дешёвый тариф, ставший возможным благодаря снижению нагрузки. Дополнительно замена 10 плагинов на один кастомный сэкономила ещё 80 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 в тестовой среде сначала.

Как провести аудит 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 одновременных визитов не должны вызывать ошибки тайм-аута.

Что вы получите в результате

• Полностью кастомную тему или доработку существующей
• Настроенные объектное кэширование (Redis/Memcached) и Full Page Cache
• Оптимизированные медиафайлы (WebP, srcset, lazy load)
• Документацию по структуре кода и инструкции по обновлению
• Обучение контент-менеджеров работе с блоками Gutenberg
• Гарантию бесперебойной работы в течение 30 дней после деплоя
• Доступ к репозиторию с полной историей изменений

Ориентиры по срокам

Стоимость рассчитывается индивидуально после аудита требований. Получите консультацию для предварительной оценки.

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

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