Перейти к содержимому

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 описана в статье установка и первые шаги.

Путь для владельца магазина или контент-менеджера: без консоли и сборки фронтенда.

  1. Установите и активируйте тему Blocksy.

  2. Откройте Внешний вид → Темы → Добавить → Загрузить тему и выберите wpcraft-woocommerce.zip из релиза. В архиве уже есть vendor/ и собранный CSS.

  3. Активируйте WPCraft WooCommerce и установите плагины из уведомления в админке.

  4. Заведите страницы и сделайте /home главной:

    Окно терминала
    wp wpcw pages sync --set-front-page
  5. Необязательно: загрузите демо-товары.

    Окно терминала
    wp eval-file wp-content/themes/wpcraft-woocommerce/demo/seed.php

Публичный репозиторий и релиз с архивом готовятся к публикации. Ссылки появятся на странице сборки.

Путь для разработчика, который будет менять тему:

Окно терминала
cd wp-content/themes/wpcraft-woocommerce
composer install # Acorn (Blade)
npm install
npm 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 → /delivery
  • patterns/pages/help/returns.blade.php → /help/returns
  • patterns/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 внутри темы.

В корне темы лежат AGENTS.md и скиллы:

  • add-page — новая страница-паттерн.
  • add-component — Blade-компонент на daisyUI.
  • woocommerce-customize — доработка WooCommerce через хуки вместо переопределения шаблонов.
  • brand-tokens — смена палитры и шрифтов.

Агент работает по этим правилам, результат проверяет разработчик.