WooCommerce: не отображается описание товара после обновления — как исправить

Диагностика проблемы с отсутствием описания товара в WooCommerce

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

• Очистите кэш браузера и сайта (если установлен плагин кэширования).
• Отключите все плагины кроме WooCommerce и переключитесь на стандартную тему (например, Storefront).
• Проверьте консоль браузера на наличие JavaScript ошибок.
• Проверьте, что поле описания товара заполнено в админке WooCommerce.
• Включите WP_DEBUG в wp-config.php для выявления PHP-ошибок.

Пошаговое решение: восстановление отображения описания товара

1. Проверка и очистка кэша

Если установлен плагин кэширования (WP Super Cache, W3 Total Cache, LiteSpeed Cache и т.д.), очистите кэш:

Настройки плагина > Очистить весь кэш (Clear All Cache)

Если вы используете серверный кэш (например, Redis, Memcached), перезапустите сервис или очистите кэш командой через SSH:

redis-cli flushall

2. Отключение конфликтных плагинов и темы

Для выявления конфликтов:

1. Отключите все плагины кроме WooCommerce.
2. Активируйте стандартную тему Storefront.
3. Проверьте, отображается ли описание товара.
4. Понемногу включайте плагины обратно, проверяя страницу товара.
5. Если проблема возникает после включения конкретного плагина, он вызывает конфликт.

3. Проверка шаблона single-product/description.php

В некоторых темах описание товара выводится через файл шаблона single-product/tabs/description.php. Если шаблон переопределён, возможно, в нём ошибка.

Чтобы проверить, замените файл шаблона темой Storefront или удалите переопределение:

wp-content/themes/ваша_тема/woocommerce/single-product/tabs/description.php

Если при удалении файла описание появится, проблема в кастомном шаблоне.

4. Принудительный вывод описания через хук

Временно для диагностики можно вывести описание напрямую в файле functions.php активной темы:

add_action('woocommerce_single_product_summary', function() {
    global $product;
    echo '<div class="custom-description">' . $product->get_description() . '</div>';
}, 25);

Если описание появится, значит, проблема в шаблонах.

5. Проверка данных в базе

Описание товара хранится в метаполе _description и в основном поле post_content поста товара. Запустите запрос в базе для проверки:

SELECT ID, post_title, post_content FROM wp_posts WHERE post_type = 'product' AND ID = {ID_вашего_товара};

Если post_content пустое, описание не сохранено — проверьте редактирование товара.

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

После выполнения каждого шага обновите страницу товара на фронтенде:

• Описание должно отображаться без ошибок.
• Проверьте консоль браузера (F12) на отсутствие ошибок JS.
• Проверьте, что описание корректно выводится и в админке.

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

• Описание не сохраняется в админке: Проверьте права пользователя и наличие ошибок в PHP-логе.
• Конфликт плагинов: Отключайте плагины по одному, выявляйте конфликтующий.
• Кэширование: Забыт очистить кэш браузера/сайта.
• Неправильный шаблон темы: Проверьте переопределенные файлы WooCommerce.

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

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

Сравнение вариантов решения проблемы