WooCommerce Blueprints — это функция, появившаяся в WooCommerce 9.9, которая упрощает настройку, управление и тестирование конфигураций магазина. Если вы запускаете несколько магазинов, работаете в команде или тестируете новые расширения, Blueprints позволяют импортировать и экспортировать настройки, плагины и темы всего в несколько кликов.
С помощью Blueprints вы можете:
- Экономить время, используя готовые конфигурации магазинов повторно.
- Поддерживать единые настройки в команде и на разных окружениях.
- Безопасно тестировать новые функции и конфигурации.
Что такое Чертежи?
Blueprint — это переносимый файл конфигурации, который содержит настройки вашего магазина WooCommerce. В него могут входить настройки WooCommerce, активные плагины и тема оформления.
Это позволяет легко воссоздавать среду магазина, делиться конфигурациями с коллегами и быстро запускать новые магазины с нужными параметрами.
Blueprints используют формат Blueprints от WordPress Playground, что делает их совместимыми с различными инструментами WordPress.
Включение функции Blueprints
Чтобы включить Blueprints:
- Перейдите в WooCommerce → Настройки → Дополнительно → Функции.
- Прокрутите страницу до опции Blueprint.
- Включите чекбокс Blueprint (бета).
- Нажмите Сохранить изменения.

После включения появится новый раздел Blueprints в WooCommerce → Настройки → Дополнительно → Blueprints.
Экспорт Blueprint
Экспорт позволяет сохранить текущую конфигурацию магазина в файл .json, который можно использовать повторно или импортировать на другой сайт WooCommerce.
- Перейдите в WooCommerce → Настройки → Дополнительно → Blueprints.
- Прокрутите до раздела Экспорт.
- Выберите, что нужно включить в экспорт.
- Нажмите Экспорт, чтобы скачать файл Blueprint.

Настройки WooCommerce
Можно экспортировать следующие разделы настроек WooCommerce:
- Основные
- Товары
- Налоги
- Доставка
- Платежи
- Аккаунты и конфиденциальность
- Интеграции
- Видимость сайта
- Дополнительно
Экспорт Blueprint использует WooCommerce Settings API, поэтому включаются только настройки, зарегистрированные через этот API. Пользовательские таблицы базы данных (например, директории загрузок или старые REST API ключи) не экспортируются.
Также не экспортируются настройки платежных аккаунтов — их нужно будет настроить вручную после импорта.
Плагины и расширения
Сейчас поддерживаются только плагины и темы из WordPress.org. Вы можете выбрать, какие плагины и расширения включить в экспорт Blueprint.
Импорт Blueprint
Импорт позволяет применить сохраненную конфигурацию магазина к новому или существующему сайту WooCommerce.
- Перейдите в WooCommerce → Настройки → Дополнительно → Blueprints.
- Прокрутите до раздела Импорт.
- Загрузите файл Blueprint.
- Нажмите кнопку Импорт.

Импорт доступен только в режиме «Скоро открытие»
Импорт Blueprint возможен только если магазин находится в режиме «Скоро открытие», чтобы избежать случайных изменений на рабочем сайте.
Если вы работаете локально или на тестовом сайте, можно разрешить импорт в рабочем режиме, добавив в файл
wp-config.php:define( 'ALLOW_BLUEPRINT_IMPORT_IN_LIVE_MODE', true );
Преимущества
- Быстрое применение стартовой конфигурации для новых магазинов.
- Синхронизация настроек и плагинов между окружениями (разработка, тестирование).
- Тестирование расширений WooCommerce в разных конфигурациях.
- Быстрое воспроизведение настроек при запуске в новом регионе или при тестировании новых функций.
Безопасность
Для обеспечения безопасности Blueprints были реализованы следующие меры защиты:
- Строгая проверка схемы: все файлы Blueprint проходят проверку JSON-схемы перед применением.
- Проверка прав доступа: только авторизованные пользователи могут импортировать и экспортировать Blueprint. Все операции проверяются через REST API.
- Ограничения настроек: при импорте блокируется изменение критически важных параметров WordPress, например:
- URL сайта (siteurl, home)
- Настройки пользователей и системы
Это позволяет переносить большинство настроек, защищая критически важные параметры от изменений.
- Безопасное выполнение SQL: поддерживаются только безопасные типы запросов (INSERT, UPDATE, REPLACE INTO). Также:
- блокируются небезопасные SQL-команды
- обнаруживаются попытки SQL-инъекций
- запрещена запись в защищенные таблицы
Эти меры снижают риск нежелательных изменений в базе данных при импорте.
- Журналирование: все операции импорта и экспорта записываются в лог. Посмотреть их можно в WooCommerce → Статус → Логи (источник
wc-blueprint).
⚠️ Рекомендации по безопасности: перед импортом обязательно проверяйте файл Blueprint, особенно если он получен от третьих лиц. Убедитесь, что его содержимое корректно и не вызывает сомнений.
