WooCommerce: не отображается кнопка «Добавить в корзину» при использовании кастомных шаблонов — как исправить

Диагностика проблемы с кнопкой «Добавить в корзину»

При кастомизации WooCommerce часто возникает ситуация, когда кнопка «Добавить в корзину» перестает отображаться на страницах товаров или архивов. Это типично при использовании дочерних тем с переопределёнными шаблонами или кастомных тем, которые неправильно подключают необходимые хуки WooCommerce.

Чтобы диагностировать проблему, выполните следующие проверки:

• Проверьте, переопределён ли файл шаблона, отвечающий за вывод кнопки, например content-single-product.php или content-product.php в папке woocommerce вашей темы.
• Убедитесь, что в шаблонах присутствуют стандартные хуки WooCommerce, такие как woocommerce_template_single_add_to_cart или woocommerce_template_loop_add_to_cart.
• Отключите все плагины кроме WooCommerce и переключитесь на стандартную тему Storefront, чтобы проверить, появляется ли кнопка без кастомного кода.
• Активируйте WP_DEBUG и проверьте логи PHP на ошибки, связанные с WooCommerce.

Пошаговое решение: восстановление кнопки «Добавить в корзину» в кастомных шаблонах

1. Проверка и исправление шаблонов

Если вы переопределяете шаблоны WooCommerce в своей теме, убедитесь, что в них присутствуют необходимые хуки. Например, для страницы отдельного товара в content-single-product.php должен быть вызов:

<?php do_action( 'woocommerce_single_product_summary' ); ?>

Этот хук отвечает за вывод названия, рейтинга, цены, описания и кнопки добавления в корзину. Если этот вызов отсутствует, кнопка не появится.

2. Использование правильных хуков для кнопки в списках товаров

Для шаблонов архива товаров (каталог, категория) в файлах content-product.php должна быть функция:

<?php do_action( 'woocommerce_after_shop_loop_item' ); ?>

Именно на этот хук навешена функция woocommerce_template_loop_add_to_cart, которая выводит кнопку на карточках товаров.

Если вы полностью переписали шаблон без вызова этого хука, добавьте его вручную или вызовите функцию напрямую:

<?php woocommerce_template_loop_add_to_cart(); ?>

3. Пример исправления кастомного шаблона

Пример минимального кода для вывода кнопки в шаблоне архива:

<div class="product">
    <h2><?php the_title(); ?></h2>
    <?php woocommerce_show_product_sale_flash(); ?>
    <?php woocommerce_template_loop_product_thumbnail(); ?>
    <div class="price"><?php wc_get_template( 'loop/price.php' ); ?></div>
    <?php woocommerce_template_loop_add_to_cart(); ?>
</div>

Проверка результата после внедрения

• Очистите кеш браузера и плагинов кеширования.
• Обновите страницу товара и страницы архива товаров.
• Проверьте наличие кнопки «Добавить в корзину» на фронтенде.
• Используйте инструменты разработчика браузера (F12) для проверки, что HTML-код кнопки присутствует в DOM.
• Если кнопка не отображается, убедитесь, что у товара есть статус «В наличии» и он не скрыт настройками WooCommerce.

Частые ошибки и как их исправить

• Отсутствие вызова ключевых хуков WooCommerce: как правило, в кастомных шаблонах забывают вызвать do_action('woocommerce_single_product_summary') или do_action('woocommerce_after_shop_loop_item'). Исправляйте, добавляя эти вызовы.
• Неправильные условия отображения кнопки: кнопка не выводится, если товар не публикуется, отсутствуют запасы или товар помечен как «простой» без возможности покупки. Проверьте настройки товара и статусы.
• Конфликты с плагинами: отключите все плагины кроме WooCommerce для проверки - иногда другие плагины могут влиять на вывод кнопок.
• Кеширование: кеширование страниц и объектов может скрывать изменения. Очистите кеш.

Практические советы по производительности и безопасности

• При кастомизации шаблонов старайтесь не удалять стандартные хуки WooCommerce, а использовать их для расширения функционала.
• Избегайте прямого копирования шаблонов без необходимости — лучше создавать отдельные шаблоны для минимальных изменений.
• Для вывода кнопок используйте встроенные функции WooCommerce, чтобы избежать ошибок и проблем с совместимостью.
• Регулярно обновляйте WooCommerce и темы, чтобы минимизировать риски из-за устаревшего кода.

Сравнение способов вывода кнопки «Добавить в корзину» в кастомных темах