WooCommerce: как добавить поддержку оценок и отзывов в тему WordPress

Диагностика проблемы: почему отзывы и рейтинги не отображаются в теме WooCommerce

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

Проверить, включены ли отзывы в WooCommerce, можно в админке: WooCommerce > Настройки > Товары > Общие, опция Включить отзывы о товарах должна быть активна.

Пошаговое решение: как добавить поддержку отзывов и рейтингов в тему

1. Включение настроек WooCommerce для отзывов

Убедитесь, что в настройках WooCommerce включены отзывы и рейтинги:

WooCommerce > Настройки > Товары > Общие > Включить отзывы о товарах (Enabled product reviews) - должна быть отмечена
Также отметьте опцию "Включить рейтинги отзывов" для отображения звезд.

2. Добавление поддержки отзывов в single-product.php

В шаблоне темы, отвечающем за вывод одиночной страницы товара (single-product.php или content-single-product.php), должно быть вызвано отображение вкладки с отзывами.

Стандартный код WooCommerce для вывода вкладок с описанием, отзывами и дополнительной информацией:

do_action( 'woocommerce_after_single_product_summary' );

Если в вашей теме отсутствует этот вызов, добавьте его, например так:

<?php
// Вставьте в нужном месте шаблона
if ( function_exists( 'woocommerce_output_product_data_tabs' ) ) {
    woocommerce_output_product_data_tabs();
}
?>

Это позволит вывести вкладки, включая отзывы.

3. Убедитесь, что в functions.php темы подключена поддержка WooCommerce

Добавьте в functions.php вызов поддержки WooCommerce, если его нет:

function theme_add_woocommerce_support() {
    add_theme_support( 'woocommerce' );
}
add_action( 'after_setup_theme', 'theme_add_woocommerce_support' );

4. Настройка вывода рейтингов рядом с отзывами

Чтобы рейтинги отображались в списке отзывов, WooCommerce использует стандартные функции, но иногда темы надо подправить. Например, можно добавить в шаблон комментариев:

<?php if ( get_option( 'woocommerce_enable_review_rating' ) === 'yes' ) : ?>
    <div class="star-rating" title="<?php echo esc_attr( sprintf( __( 'Rated %s out of 5', 'woocommerce' ), $comment_rating ) ); ?>">
        <span style="width:<?php echo ( ( $comment_rating / 5 ) * 100 ); ?>%"> </span>
    </div>
<?php endif; ?>

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

После внесения изменений:

• Откройте страницу товара на фронтенде сайта;
• Убедитесь, что отображается вкладка "Отзывы" с формой добавления отзыва;
• Добавьте тестовый отзыв с оценкой (звёздами);
• Проверьте, что отзыв и рейтинг отображаются корректно в списке отзывов.

Если вкладка не появляется, проверьте консоль браузера на ошибки JavaScript и логи PHP на наличие ошибок.

Частые ошибки и способы их исправления

• Вкладка отзывов отсутствует
  Причина: в шаблоне не вызывается woocommerce_output_product_data_tabs() или do_action( 'woocommerce_after_single_product_summary' ).
  Решение: добавить вызов в шаблон.
• Отзывы не сохраняются
  Причина: отключены отзывы в настройках WooCommerce или конфликт с плагинами.
  Проверка: отключить плагины, проверить настройки WooCommerce.
• Рейтинги не отображаются
  Причина: в шаблоне не выводится рейтинг, или отключены в настройках.
  Решение: добавить код вывода рейтинга в шаблон комментариев.
• Стили отзывов не применяются
  Решение: подключить стили WooCommerce или добавить свои CSS для классов .star-rating.

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

• Используйте встроенный механизм WordPress для проверки и валидации данных отзывов, не отключайте защиту от спама.
• Для больших магазинов с большим числом отзывов рассмотрите кеширование вывода вкладок или отзывов с помощью transient API.
• Не удаляйте стандартные скрипты WooCommerce, они отвечают за корректную работу вкладок и отзывов.
• Добавляйте поддержку отзывов в дочерних темах, чтобы не потерять изменения при обновлении основной темы.

Сравнение способов добавления отзывов в тему WooCommerce