Дополнительные опции товара WooCommerce: Product Add-Ons, поля и доплаты

Не каждый выбор покупателя должен становиться отдельной вариацией товара. Если клиенту нужно указать текст для гравировки, выбрать подарочную упаковку, приложить файл с макетом или добавить платную услугу, десятки SKU и комбинаций быстро делают карточку товара неудобной и сложной в поддержке.

WooCommerce Product Add-Ons решает другую задачу: добавляет к товару дополнительные поля и опции, которые покупатель заполняет перед добавлением в корзину. Опция может быть бесплатной или менять итоговую цену. Это удобно для персонализированных товаров, услуг, печати, подарков, изготовления на заказ и других сценариев, где основной товар остаётся тем же.

Ниже разберём, когда Product Add-Ons подходит лучше вариаций, как спроектировать поля и доплаты, что происходит в корзине и заказе, а также какие ограничения важно учесть до запуска.

Что именно решает Product Add-Ons

Официальное расширение Product Add-Ons позволяет добавлять к товару поля выбора, чекбоксы, короткий и длинный текст, загрузку файла, пользовательскую цену, количество, заголовки и выбор даты. Для опций можно задавать обязательность, описание и изменение цены.

Типовые сценарии:

• гравировка имени или короткой фразы;
• подарочная упаковка за дополнительную плату;
• выбор материала отделки без отдельного складского остатка;
• загрузка изображения или макета для печати;
• выбор даты выполнения или доставки как дополнительного параметра;
• добавление услуги установки, настройки или расширенной подготовки товара;
• добровольная дополнительная сумма или пользовательская цена в подходящих сценариях.

Product Add-Ons, вариации или комплект: что выбрать

Ключевое ограничение Product Add-Ons: сами add-ons не являются отдельными товарами, не получают собственный SKU и не ведут собственный складской остаток. Если дополнительная опция должна реально резервироваться на складе, Product Add-Ons обычно не стоит использовать как замену вариациям или компонентам комплекта.

Шаг 1. Сначала описать бизнес-правила

Перед настройкой составьте список всех дополнительных параметров и для каждого ответьте на несколько вопросов:

• обязателен ли выбор;
• может ли клиент выбрать несколько значений;
• меняет ли опция цену;
• зависит ли цена от количества основного товара;
• нужно ли ограничить длину текста или числовое значение;
• должна ли опция отображаться у всех товаров или только у части каталога;
• нужна ли эта информация складу, производству, менеджеру, CRM или службе доставки.

Такой список помогает не смешивать интерфейс с логикой. Например, «подарочная упаковка» может быть простым чекбоксом с фиксированной доплатой, а «размер» при разных остатках должен остаться вариацией.

Шаг 2. Выбрать глобальные или товарные add-ons

Product Add-Ons поддерживает два основных уровня настройки. Глобальные группы применяются сразу к нескольким товарам и при необходимости ограничиваются категориями. Товарные add-ons создаются в конкретной карточке продукта.

Глобальные группы удобны для повторяющихся правил: подарочной упаковки, стандартной персонализации, срочного изготовления или общей дополнительной услуги. Товарный уровень лучше использовать, когда поле относится только к одному продукту или небольшой группе товаров с уникальным сценарием.

Не стоит копировать одинаковый набор полей вручную в десятки товаров. Если правило действительно общее, глобальная группа проще в сопровождении и снижает риск, что одна карточка останется со старой ценой или подписью.

Шаг 3. Настроить цену без неожиданных расчётов

Официальный Product Add-Ons поддерживает бесплатные и платные опции. Для доплаты доступны разные модели, включая фиксированную сумму, расчёт на основе количества товара и процент от цены продукта. Отрицательное значение может использоваться как скидка.

Для покупателя цена должна быть предсказуемой. Если упаковка стоит фиксированную сумму за весь товар, не используйте режим, который умножает её на количество единиц, если это не соответствует реальному бизнес-процессу. После настройки обязательно проверьте несколько количеств и комбинаций в корзине.

Шаг 4. Не превращать карточку в анкету

Технически добавить много полей несложно, но каждое поле увеличивает количество решений перед покупкой. Оставляйте только то, что действительно нужно для выполнения заказа.

Для длинного набора параметров полезно разделять их понятными заголовками и писать короткие инструкции. Обязательные поля должны быть очевидны, а ошибка — объяснять, что именно нужно исправить. На мобильной версии особенно важно проверить длинные подписи, изображения вариантов, date picker и загрузку файла.

Если нужна более глубокая перестройка самой страницы товара, отдельно посмотрите материал о безопасной кастомизации карточки WooCommerce. Product Add-Ons решает задачу дополнительных данных, а не заменяет архитектуру product page.

Важное ограничение variable products

Add-ons, добавленные к variable product, наследуются всеми его вариациями. В официальном Product Add-Ons нельзя назначить разный набор add-ons каждой отдельной вариации.

Это нужно учитывать заранее. Если у размера S один набор дополнительных услуг, а у размера XL принципиально другой, одного Product Add-Ons может быть недостаточно. В таком случае стоит пересмотреть модель товара или использовать другое расширение/кастомную логику.

И наоборот, если все вариации используют одинаковое поле «Текст для гравировки», Product Add-Ons хорошо дополняет вариативный товар: вариация продолжает отвечать за склад и цену конкретной версии, а add-on — за персонализацию.

Условная логика: не путать разные расширения

У официального WooCommerce Product Add-Ons нет встроенной conditional logic, которая автоматически показывает или скрывает поля в зависимости от предыдущего выбора. В WooCommerce Marketplace существуют другие расширения с похожими названиями и собственной условной логикой, поэтому при выборе решения важно смотреть документацию именно установленного продукта.

Если сценарий строится на цепочке «выбрал A → покажи B → для B рассчитай C», сначала оцените сложность. Иногда проще использовать специализированный конфигуратор или кастомную форму, чем пытаться превратить базовый add-ons механизм в сложный конструктор.

Загрузка файлов: что проверить до запуска

File Upload полезен для макетов, изображений и материалов от клиента, но такой сценарий требует отдельной проверки безопасности. WooCommerce хранит файлы Product Add-Ons в каталоге внутри wp-content/uploads/product_addons_uploads/.

Официальная документация рекомендует отключить directory listing. При этом само отключение списка файлов не делает каждый загруженный файл приватным: пользователь, знающий точный URL, всё ещё может открыть файл. Поэтому Product Add-Ons не следует использовать как защищённое хранилище конфиденциальных документов.

Перед запуском проверьте допустимые типы и размеры файлов, настройки веб-сервера, резервное копирование и срок хранения. Если загружаются чувствительные данные, нужна другая архитектура доступа.

API и headless: add-ons можно автоматизировать

Product Add-Ons имеет собственный REST API для глобальных групп и расширяет WooCommerce Products API данными товарных add-ons. В документации WooCommerce указано, что такая REST-поддержка доступна начиная с Product Add-Ons 6.9.0.

Для глобальных групп используются endpoints семейства wc-product-add-ons/v2/global-add-ons. В данных продукта появляются свойства addons и exclude_global_add_ons. Это позволяет создавать и обновлять конфигурацию из внешней системы, если такая автоматизация действительно нужна.

Для клиентской корзины Product Add-Ons также интегрируется с Store API: при добавлении товара можно передать addons_configuration. Схематичный запрос выглядит так:

{
  "id": 1234,
  "quantity": 1,
  "addons_configuration": {
    "ADDON_ID": "Текст персонализации"
  }
}

ID в примере условный. Реальная структура значения зависит от типа add-on. Для интеграции важно не хардкодить конфигурацию без проверки актуальных ID и не передавать секретные ключи в клиентский код.

Если магазин синхронизирует заказ с CRM, ERP или производством, заранее проверьте, как выбранные add-ons попадают в line item metadata и как внешняя система должна их интерпретировать. При сложной интеграции можно использовать доработку WooCommerce, а для нового магазина — разработку WooCommerce-магазина.

Типичные ошибки при внедрении

• Использовать add-on вместо складской сущности. Если опция имеет собственный SKU и остаток, это обычно вариация или отдельный компонент.
• Создать слишком много полей. Карточка становится длинной, а покупатель теряет основной CTA.
• Не проверить количество. Доплата может рассчитываться не так, как ожидает бизнес, если выбран quantity-based режим.
• Ожидать разные add-ons для каждой вариации. Официальный Product Add-Ons применяет набор к variable product и наследует его всеми вариациями.
• Ожидать встроенную conditional logic. У официального Product Add-Ons её нет.
• Тестировать только product page. Нужно пройти корзину, checkout, заказ, письма и внешние выгрузки.
• Считать file upload приватным хранилищем. Отключение directory listing не закрывает доступ по точному URL.

Когда лучше Product Bundles

Если дополнительный выбор — это не услуга и не параметр, а самостоятельный товар, Product Bundles может быть более правильной моделью. Например, основной товар продаётся вместе с реальным аксессуаром, у которого есть собственный склад, SKU и отдельная карточка.

Подробно про этот сценарий — в статье Product Bundles WooCommerce: настройка комплектов.

Вывод

Product Add-Ons полезен там, где к основному товару нужно добавить персонализацию, услугу или дополнительный параметр без создания новой складской позиции. Он хорошо подходит для гравировки, упаковки, текста, файлов и простых доплат, но не должен подменять вариации и реальные компоненты со своим SKU и остатком.

Надёжное внедрение начинается с модели данных: что является товаром, что — вариацией, а что — дополнительной опцией. После этого уже настраиваются поля, цена, мобильный UX, корзина, заказ и интеграции. Если стандартной конфигурации недостаточно, A.S Groups может доработать действующий WooCommerce-магазин под конкретный процесс.

Официальные источники

• WooCommerce — Product Add-Ons Documentation
• WooCommerce — Product Add-Ons REST API Reference
• WooCommerce — Hardening File Uploads
• WooCommerce — Variable Products Documentation
• WooCommerce Developer Docs — Store API