Разработка кастомной темы WooCommerce

Разработка кастомной темы WooCommerce

Стандартный WooCommerce выглядит стандартно. Тема Storefront — отправная точка, но не конечный результат. Кастомная тема WooCommerce — это полный контроль над шаблонами каталога, карточки товара, корзины и оформления заказа без переопределения сотни CSS-правил поверх чужого кода. Разработка кастомной темы от дизайна до production — от 10 до 20 рабочих дней в зависимости от количества кастомных шаблонов и нестандартных элементов.

Структура WooCommerce-темы

WooCommerce ищет шаблоны в папке woocommerce/ внутри активной темы. Если файл найден — он перекрывает оригинальный из плагина:

wp-content/themes/my-theme/
├── woocommerce/
│   ├── archive-product.php         # Страница каталога
│   ├── single-product.php          # Карточка товара
│   ├── cart/
│   │   └── cart.php                # Корзина
│   ├── checkout/
│   │   ├── form-checkout.php       # Форма оформления
│   │   └── thankyou.php            # Страница подтверждения
│   ├── myaccount/
│   │   └── dashboard.php           # Личный кабинет
│   ├── content-product.php         # Элемент каталога (карточка в списке)
│   ├── single-product/
│   │   ├── tabs/
│   │   │   └── tabs.php            # Вкладки товара
│   │   └── related.php             # Похожие товары
│   └── loop/
│       ├── pagination.php
│       └── add-to-cart.php
└── functions.php

Полный список шаблонов: wp-content/plugins/woocommerce/templates/.

Переопределение шаблона карточки товара

Вместо копирования content-product.php с минимальными правками — пишем с нуля под дизайн:

<?php
// woocommerce/content-product.php
defined('ABSPATH') || exit;

global $product;

if (!$product || !$product->is_visible()) return;

$product_id    = $product->get_id();
$permalink     = get_the_permalink();
$thumbnail_url = get_the_post_thumbnail_url($product_id, 'woocommerce_thumbnail');
$badge         = get_post_meta($product_id, '_product_badge', true);
?>

<article <?php wc_product_class('product-card', $product); ?>>

    <a href="<?= esc_url($permalink) ?>" class="product-card__image-wrap" tabindex="-1">
        <?php if ($thumbnail_url) : ?>
            <img
                src="<?= esc_url($thumbnail_url) ?>"
                alt="<?= esc_attr(get_the_title()) ?>"
                loading="lazy"
                class="product-card__image"
            >
        <?php else : ?>
            <div class="product-card__image product-card__image--placeholder"></div>
        <?php endif; ?>

        <?php if ($badge) : ?>
            <span class="product-card__badge"><?= esc_html($badge) ?></span>
        <?php endif; ?>

        <?php if ($product->is_on_sale()) : ?>
            <span class="product-card__sale"><?= esc_html(wc_get_sale_flash()) ?></span>
        <?php endif; ?>
    </a>

    <div class="product-card__body">
        <a href="<?= esc_url($permalink) ?>" class="product-card__title">
            <?= esc_html(get_the_title()) ?>
        </a>

        <?php if ($product->get_short_description()) : ?>
            <p class="product-card__desc"><?= wp_kses_post(wp_trim_words($product->get_short_description(), 12)) ?></p>
        <?php endif; ?>

        <div class="product-card__footer">
            <span class="product-card__price"><?= wp_kses_post($product->get_price_html()) ?></span>

            <?php if ($product->is_in_stock()) : ?>
                <?php woocommerce_template_loop_add_to_cart(['class' => 'btn btn--primary btn--sm']); ?>
            <?php else : ?>
                <span class="product-card__outofstock">Нет в наличии</span>
            <?php endif; ?>
        </div>
    </div>

</article>

Хуки для добавления элементов без переопределения шаблонов

Многие изменения можно сделать через хуки, не трогая шаблоны:

// Убираем рейтинг из карточки в каталоге
remove_action('woocommerce_after_shop_loop_item_title', 'woocommerce_template_loop_rating', 5);

// Добавляем артикул
add_action('woocommerce_after_shop_loop_item_title', function () {
    global $product;
    $sku = $product->get_sku();
    if ($sku) {
        echo '<span class="product-card__sku">Арт: ' . esc_html($sku) . '</span>';
    }
}, 6);

// Перемещаем цену до заголовка на карточке товара
remove_action('woocommerce_single_product_summary', 'woocommerce_template_single_price', 10);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_price', 5);

// Добавляем кастомную секцию после описания
add_action('woocommerce_single_product_summary', function () {
    global $product;
    $benefits = get_post_meta($product->get_id(), '_product_benefits', true);
    if ($benefits) {
        echo '<div class="product-benefits">' . wp_kses_post($benefits) . '</div>';
    }
}, 25);

Кастомная галерея товара

WooCommerce использует Flexslider для галереи — тяжело и устарело. Замена на кастомную реализацию:

// Отключаем стандартную галерею
remove_action('woocommerce_product_thumbnails', 'woocommerce_show_product_thumbnails', 20);
remove_action('woocommerce_before_single_product_summary', 'woocommerce_show_product_images', 20);

// Подключаем свою
add_action('woocommerce_before_single_product_summary', 'my_theme_product_gallery', 20);

function my_theme_product_gallery(): void {
    global $product;

    $main_image_id    = $product->get_image_id();
    $gallery_ids      = $product->get_gallery_image_ids();
    $all_image_ids    = $main_image_id ? array_merge([$main_image_id], $gallery_ids) : $gallery_ids;

    if (empty($all_image_ids)) {
        echo wc_placeholder_img('woocommerce_single');
        return;
    }

    echo '<div class="product-gallery" data-lightbox="product">';
    echo '<div class="product-gallery__main">';
    foreach ($all_image_ids as $idx => $image_id) {
        $full  = wp_get_attachment_image_url($image_id, 'full');
        $large = wp_get_attachment_image_url($image_id, 'woocommerce_single');
        $alt   = get_post_meta($image_id, '_wp_attachment_image_alt', true) ?: get_the_title();
        printf(
            '<a href="%s" class="product-gallery__slide%s" data-index="%d">
                <img src="%s" alt="%s" loading="%s">
            </a>',
            esc_url($full),
            $idx === 0 ? ' product-gallery__slide--active' : '',
            $idx,
            esc_url($large),
            esc_attr($alt),
            $idx === 0 ? 'eager' : 'lazy'
        );
    }
    echo '</div>';

    if (count($all_image_ids) > 1) {
        echo '<div class="product-gallery__thumbs">';
        foreach ($all_image_ids as $idx => $image_id) {
            $thumb = wp_get_attachment_image_url($image_id, 'thumbnail');
            printf(
                '<button class="product-gallery__thumb%s" data-index="%d" aria-label="Фото %d">
                    <img src="%s" alt="" loading="lazy">
                </button>',
                $idx === 0 ? ' product-gallery__thumb--active' : '',
                $idx,
                $idx + 1,
                esc_url($thumb)
            );
        }
        echo '</div>';
    }

    echo '</div>';
}

Кастомная страница каталога

// woocommerce/archive-product.php
get_header();
?>
<main class="catalog-page">
    <div class="catalog-page__sidebar">
        <?php dynamic_sidebar('woocommerce-sidebar'); ?>
    </div>
    <div class="catalog-page__main">
        <?php if (woocommerce_product_loop()) : ?>
            <div class="catalog-page__toolbar">
                <?php woocommerce_catalog_ordering(); ?>
                <?php woocommerce_result_count(); ?>
            </div>
            <?php woocommerce_product_loop_start(); ?>
                <?php while (have_posts()) : the_post(); ?>
                    <?php wc_get_template_part('content', 'product'); ?>
                <?php endwhile; ?>
            <?php woocommerce_product_loop_end(); ?>
            <?php woocommerce_pagination(); ?>
        <?php else : ?>
            <?php do_action('woocommerce_no_products_found'); ?>
        <?php endif; ?>
    </div>
</main>
<?php
get_footer();

Декларация поддержки WooCommerce

Тема должна явно заявить о поддержке WooCommerce, иначе будет показано предупреждение:

add_action('after_setup_theme', function () {
    add_theme_support('woocommerce', [
        'thumbnail_image_width'         => 450,
        'single_image_width'            => 800,
        'product_grid'                  => [
            'default_rows'    => 3,
            'min_rows'        => 1,
            'default_columns' => 4,
            'min_columns'     => 2,
            'max_columns'     => 6,
        ],
    ]);
    add_theme_support('wc-product-gallery-zoom');
    add_theme_support('wc-product-gallery-lightbox');
    add_theme_support('wc-product-gallery-slider');
});

Типовые сроки: кастомная тема с переопределением основных шаблонов и базовым CSS — 5–7 дней. Полноценная тема с кастомной галереей, фильтрами, AJAX-корзиной и адаптивностью — 12–18 дней.