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

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

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

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

Причины, почему описание товара может не отображаться

1. Конфликт переопределённых шаблонов темы

WooCommerce позволяет переопределять шаблоны в папке темы /woocommerce. При обновлении WooCommerce старые шаблоны могут стать несовместимыми.

2. Нарушение работы хуков, отвечающих за вывод описания

Описание товара выводится с помощью хука woocommerce_single_product_summary. Если этот хук удалён или приоритет изменён, описание может исчезнуть.

3. Ошибки в базе данных или повреждённый мета-поле

Описание хранится в поле post_content таблицы wp_posts. Если это поле пустое или повреждённое, ничего не отобразится.

Пошаговое решение проблемы

Шаг 1. Проверка и восстановление шаблонов

Перейдите в админку WooCommerce > Статус > Шаблоны и проверьте, какие файлы устарели. Если есть устаревшие шаблоны, замените их на оригинальные из последней версии WooCommerce.

Для этого скопируйте актуальные шаблоны из wp-content/plugins/woocommerce/templates/ в папку темы wp-content/themes/your-theme/woocommerce/, соблюдая структуру.

Шаг 2. Проверка и восстановление хуков в functions.php

Добавьте следующий код в файл functions.php активной темы, чтобы убедиться, что вывод описания включён:

remove_all_actions('woocommerce_single_product_summary');

add_action('woocommerce_single_product_summary', 'woocommerce_template_single_title', 5);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_price', 10);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_excerpt', 20);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_meta', 40);
add_action('woocommerce_single_product_summary', 'woocommerce_template_single_sharing', 50);

Если описание всё ещё не отображается, возможно, этот хук был полностью удалён или переопределён.

Шаг 3. Проверка данных в базе

Подключитесь к базе данных через phpMyAdmin или другой клиент и выполните запрос для проверки контента товара:

SELECT ID, post_title, LENGTH(post_content) AS content_length FROM wp_posts WHERE post_type = 'product' AND ID = <ID_вашего_товара>;

Если content_length равен 0, описание пустое — надо добавить или восстановить.

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

• Обновите страницу товара и убедитесь, что описание отображается.
• Проверьте на разных товарах и в разных браузерах.
• Отключите WP_DEBUG, если он был включён.

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

• Ошибки в шаблонах: Использование устаревших шаблонов из старых версий WooCommerce — обновите их.
• Хуки удалены или изменены: Часто темы или плагины удаляют нужные действия. Проверьте functions.php и отключите конфликтные плагины.
• Пустое описание в базе: При импорте товаров или обновлениях могли пропасть данные — восстановите вручную.
• Кэширование: Иногда причина — кэш плагинов или CDN. Очистите кэш после изменений.

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

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

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