WooCommerce: решение проблемы со скрытым товаром после обновления

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

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

• Изменения в статусах публикации товаров (например, смена с "publish" на "draft" или "private").
• Изменения в параметрах видимости товара (catalog visibility).
• Ошибки кэширования после обновления.
• Конфликты с фильтрами или хуками, которые влияют на WP_Query товаров.
• Проблемы с таксономиями — например, товар лишился категории или тегов, из-за чего исключается из запроса.

Как проверить статус товара в базе данных

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

SELECT ID, post_status, post_type FROM wp_posts WHERE post_type = 'product' AND post_title LIKE '%название_товара%';

Убедитесь, что post_status равен publish. Если нет — это одна из причин скрытия товара.

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

1. Проверяем и восстанавливаем статус товара

В админке WordPress перейдите в раздел Товары, отфильтруйте по статусу «Черновик» или «Личное» и массово измените статус на «Опубликовано».

Если нужно сделать это программно, используйте следующий код в functions.php или в плагине для однократного запуска:

function wphelper_fix_hidden_products_status() {
    $args = [
        'post_type' => 'product',
        'post_status' => ['draft', 'pending', 'private'],
        'posts_per_page' => -1
    ];
    $products = get_posts($args);
    foreach ($products as $product) {
        wp_update_post([
            'ID' => $product->ID,
            'post_status' => 'publish'
        ]);
    }
}
add_action('init', 'wphelper_fix_hidden_products_status', 20);

2. Проверяем параметр видимости товара

WooCommerce использует мета-поле _visibility или таксономию product_visibility для управления показом товара в каталоге. Убедитесь, что товар не имеет значение hidden.

Для массовой проверки и исправления используйте WP-CLI:

wp post meta update $(wp post list --post_type=product --format=ids) _visibility visible

Или программно:

function wphelper_fix_product_visibility() {
    $args = [
        'post_type' => 'product',
        'posts_per_page' => -1
    ];
    $products = get_posts($args);
    foreach ($products as $product) {
        update_post_meta($product->ID, '_visibility', 'visible');
    }
}
add_action('init', 'wphelper_fix_product_visibility', 21);

3. Очистка кэша и пересоздание индексов

Если вы используете плагины кэширования (например, WP Super Cache, W3 Total Cache, LiteSpeed Cache), очистите весь кэш сайта и браузера.

Также рекомендуется сбросить постоянные ссылки: перейдите в Настройки > Постоянные ссылки и нажмите «Сохранить изменения» без правок.

4. Проверяем фильтры и хуки, влияющие на WP_Query

Временно отключите сторонние плагины, которые могут вмешиваться в запросы товаров, особенно кастомные фильтры и хук pre_get_posts.

Для отладки добавьте в functions.php:

add_action('pre_get_posts', function($query) {
    if ($query->is_main_query() && !is_admin() && $query->is_post_type_archive('product')) {
        error_log('WooCommerce main query args: ' . print_r($query->query_vars, true));
    }
});

Это поможет понять, какие параметры запроса могут исключать товар.

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

• Обновите страницу каталога товаров в режиме инкогнито или после очистки кэша браузера.
• В панели администратора проверьте статус и видимость товара.
• Используйте WP-CLI для проверки количества опубликованных товаров: wp post list --post_type=product --post_status=publish --format=count.
• Если товары отображаются, проблема решена.

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

• Ошибка: Статус товара остается «черновик» — решение: массовое обновление статуса через админку или код.
• Ошибка: Метаполе _visibility установлено в «hidden» — решение: обновить значение на «visible».
• Ошибка: Кэш не очищен — решение: обязательно очистите все уровни кэширования.
• Ошибка: Конфликт плагинов — решение: отключайте плагины по одному и проверяйте отображение товаров.
• Ошибка: Изменения не применяются из-за кеширования на стороне хостинга — решение: обратитесь к хостеру или проверьте серверный кэш.

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

• Перед обновлением WooCommerce всегда делайте полный бэкап базы данных и файлов сайта.
• Используйте Child Theme для внесения изменений в functions.php, чтобы не потерять их при обновлении.
• Регулярно очищайте мета-данные и транзиенты, чтобы избежать замусоривания базы данных.
• Для массовых операций с товарами используйте WP-CLI — это быстрее и снижает нагрузку на сервер.
• Мониторьте логи ошибок PHP и WooCommerce для своевременного обнаружения проблем.

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