WPCraft WooCommerce: старт магазина на готовой сборке
WPCraft WooCommerce — стартовая сборка интернет-магазина: открытая дочерняя тема Blocksy под WooCommerce. Её ставят на чистый WordPress и сразу начинают разработку. Что входит в сборку, чем она отличается от альтернатив и как заказать доработку под свой магазин — на странице сборки.
Эта страница — инструкция по старту: что нужно для установки, как поставить сборку и с чего начать разработку.
Что входит
Заголовок раздела «Что входит»- Страницы в коде. Файл в
patterns/pages/рендерит страницу WordPress с тем же путём. - Blade-компоненты на daisyUI 5 и Tailwind v4. Hero, секции, преимущества, FAQ, CTA, форма заявки, карточка и сетка товаров.
- Шаблоны магазина. Главная, «Доставка и оплата», «О магазине», «Контакты», заготовки политики и оферты.
- Чекаут под РФ. Без штата и второй строки адреса, телефон обязателен, рубль по умолчанию.
- Яндекс. Тема рекомендует Site Kit for Yandex (Метрика, Вебмастер) и WooMS (МойСклад). Для оплаты и доставки есть слоты.
- AI-агенты.
AGENTS.mdи скиллы в.agents/skills/.
Требования
Заголовок раздела «Требования»- WordPress 6.6+ и PHP 8.3+.
- WooCommerce, Blocksy и Blocksy Companion — бесплатные версии.
- Постоянные ссылки любой структуры, кроме «Plain». Рекомендуем
/%postname%. Базовая настройка WooCommerce описана в статье установка и первые шаги.
Установка из zip
Заголовок раздела «Установка из zip»Путь для владельца магазина или контент-менеджера: без консоли и сборки фронтенда.
-
Установите и активируйте тему Blocksy.
-
Откройте Внешний вид → Темы → Добавить → Загрузить тему и выберите
wpcraft-woocommerce.zipиз релиза. В архиве уже естьvendor/и собранный CSS. -
Активируйте WPCraft WooCommerce и установите плагины из уведомления в админке.
-
Заведите страницы и сделайте
/homeглавной:Окно терминала wp wpcw pages sync --set-front-page -
Необязательно: загрузите демо-товары.
Окно терминала wp eval-file wp-content/themes/wpcraft-woocommerce/demo/seed.php
Публичный репозиторий и релиз с архивом готовятся к публикации. Ссылки появятся на странице сборки.
Установка для разработки
Заголовок раздела «Установка для разработки»Путь для разработчика, который будет менять тему:
cd wp-content/themes/wpcraft-woocommercecomposer install # Acorn (Blade)npm installnpm run build # assets/css/app.css; npm run watch — пересборка при измененияхБез vendor/ тема работает как обычная дочерняя Blocksy и показывает уведомление в админке. Паттерны страниц при этом выводятся без Blade, компоненты не работают.
Если Acorn уже загружен другим пакетом, например mu-plugin на мультисайте, тема не подключает свой vendor/ и использует готовое приложение. Кэш Blade лежит в wp-content/cache/wpcraft-woocommerce, путь меняется константой WPCRAFT_WOO_STORAGE_PATH.
Первая страница
Заголовок раздела «Первая страница»Страница — это запись WordPress с шаблоном «Code Driven», а её содержимое — файл в patterns/pages/. Путь файла равен адресу страницы:
patterns/pages/home.blade.php→ главная (запись/home)patterns/pages/delivery.blade.php→/deliverypatterns/pages/help/returns.blade.php→/help/returnspatterns/pages/help/index.blade.php→/help
Основная форма — *.blade.php. Шапка страницы лежит в Blade-комментарии, данные — в блоке @php:
{{-- Title: Распродажа Description: Meta description страницы.--}}@php defined('ABSPATH') || exit; $rows = [['heading' => '…', 'description' => '…']];@endphp<x-section id="sale" level="h1" eyebrow="Распродажа" heading="…"> <x-benefits :rows="$rows" /></x-section>После нового файла выполните wp wpcw pages sync, флаг --dry-run покажет план. Команда только создаёт недостающие записи и не меняет существующие. Записи с чужим шаблоном она показывает как conflict.
- Заголовок, canonical и SEO принадлежат записи WordPress.
Description:из шапки выводится, если не установлен SEO-плагин.Robots: noindexв шапке закрывает страницу от индексации.
Каталог компонентов открывается на странице /styleguide, она закрыта от индексации.
Хуки для доработок
Заголовок раздела «Хуки для доработок»Оплата и доставка — места, куда встаёт платёжный или доставочный модуль:
wpcraft_woo/checkout/before_payment,wpcraft_woo/checkout/after_payment— классический чекаут.wpcraft_woo/delivery/methods,wpcraft_woo/delivery/payments— страница «Доставка и оплата».
Поведение темы:
wpcraft_woo/ru_checkout(filter, bool) — включает и выключает чекаут под РФ.wpcraft_woo/product_grid/query(filter) — аргументыwc_get_products()для сетки товаров.wpcraft_woo/recommended_plugins(filter) — список плагинов в уведомлении.wpcraft_woo/contact_form/submitted(action),wpcraft_woo/contact_form/sendиwpcraft_woo/contact_form/recipient(filter) — форма заявки.
Смена палитры
Заголовок раздела «Смена палитры»Цвета задаются в theme.json → settings.color.palette. Их читают и daisyUI-компоненты, и палитра Blocksy, поэтому CSS пересобирать не нужно. Порядок для AI-агента описан в скилле .agents/skills/brand-tokens/SKILL.md внутри темы.
Работа с AI-агентом
Заголовок раздела «Работа с AI-агентом»В корне темы лежат AGENTS.md и скиллы:
add-page— новая страница-паттерн.add-component— Blade-компонент на daisyUI.woocommerce-customize— доработка WooCommerce через хуки вместо переопределения шаблонов.brand-tokens— смена палитры и шрифтов.
Агент работает по этим правилам, результат проверяет разработчик.
Связанные страницы
Заголовок раздела «Связанные страницы»- Установка и первые шаги — базовая настройка WooCommerce.
- Лучшие темы для WooCommerce — почему в основе Blocksy и какие есть альтернативы.
- Страницы магазина
Материалы и источники
Заголовок раздела «Материалы и источники»- WPCraft WooCommerce — страница сборки
- README темы
wpcraft-woocommerce(репозиторий готовится к публикации) - Blocksy на WordPress.org