WooCommerce: корректное отображение наличия и управление остатками товаров

Проблема с отображением статуса наличия товара в WooCommerce

Многие разработчики и владельцы магазинов на WooCommerce сталкиваются с проблемой некорректного отображения статуса наличия товаров (in stock, out of stock, on backorder). Особенно это проявляется при кастомных настройках управления запасами или использовании сторонних плагинов, которые влияют на логику отображения. В результате покупатели видят неправильный статус, что приводит к потерям продаж и недовольству.

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

Для начала убедитесь, что в настройках WooCommerce включено управление запасами и корректно указаны запасы на уровне продукта или вариации. Проверьте, не конфликтует ли тема или плагин с функцией get_availability(), отвечающей за статус наличия.

Используйте следующие проверки:

• В админке WooCommerce откройте карточку товара и проверьте, что в разделе «Запасы» активировано «Включить управление запасами на уровне товара».
• Проверьте поле «Количество на складе» — оно должно быть числом, не отрицательным.
• Убедитесь, что статус «Разрешить предзаказы» установлен верно (включён или выключен).
• Включите WP_DEBUG в wp-config.php и проверьте, нет ли ошибок, связанных с функциями WooCommerce работы со запасами.

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

Если стандартные настройки правильные, но статус отображается неверно, можно добавить кастомный фильтр, который гарантирует правильное вычисление статуса. Например, в файле functions.php вашей темы или в кастомном плагине:

add_filter('woocommerce_get_availability', 'custom_correct_availability', 10, 2);
function custom_correct_availability($availability, $product) {
    if (!$product->managing_stock()) {
        // Если управление запасами отключено, всегда показываем "В наличии"
        $availability['availability'] = __('В наличии', 'woocommerce');
        $availability['class'] = 'in-stock';
        return $availability;
    }

    $stock_quantity = $product->get_stock_quantity();
    if ($stock_quantity > 0) {
        $availability['availability'] = __('В наличии', 'woocommerce');
        $availability['class'] = 'in-stock';
    } elseif ($product->backorders_allowed()) {
        $availability['availability'] = __('Под заказ', 'woocommerce');
        $availability['class'] = 'available-on-backorder';
    } else {
        $availability['availability'] = __('Нет в наличии', 'woocommerce');
        $availability['class'] = 'out-of-stock';
    }
    return $availability;
}

Этот код учитывает все основные условия и корректно возвращает статус наличия, даже если есть нестандартные настройки.

Автоматическое обновление статуса при изменении запасов

Для динамического обновления статуса на фронтенде при изменении количества товара через AJAX (например, в корзине или каталоге) можно использовать следующий скрипт с хуком:

add_action('wp_ajax_update_stock_status', 'ajax_update_stock_status_callback');
add_action('wp_ajax_nopriv_update_stock_status', 'ajax_update_stock_status_callback');
function ajax_update_stock_status_callback() {
    $product_id = intval($_POST['product_id']);
    $product = wc_get_product($product_id);
    if (!$product) {
        wp_send_json_error('Товар не найден');
        wp_die();
    }

    $availability = wc_get_availability($product);
    wp_send_json_success(array(
        'availability' => $availability['availability'],
        'class' => $availability['class']
    ));
    wp_die();
}

На стороне JS необходимо отправить AJAX-запрос при изменении количества и обновить блок с наличием товара. Это позволит избежать ошибки с устаревшим статусом без перезагрузки страницы.

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

• Откройте страницу товара с разным количеством запасов (больше 0, 0, с разрешённым предзаказом).
• Проверьте текст и css-класс статуса (например, in-stock, out-of-stock, available-on-backorder).
• Проверьте работу изменения количества в корзине и обновление статуса без перезагрузки (если реализован AJAX).
• Включите отладку WooCommerce Status Report (WooCommerce > Статус) и убедитесь, что нет ошибок в логах, связанных с запасами.

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

• Ошибка: Статус всегда показывает «Нет в наличии» даже при наличии товара.
  Причина: Неправильно задано «Управление запасами» или запасы отрицательны.
  Решение: Проверьте и исправьте значения в админке, используйте приведённый фильтр.
• Ошибка: Статус не обновляется при изменении количества в корзине.
  Причина: Отсутствует AJAX-обновление или кэширование страницы.
  Решение: Добавьте AJAX-обработчик и отключите кэширование для динамических страниц WooCommerce.
• Ошибка: Конфликт с плагинами кеширования или кастомными функциями.
  Решение: Временно отключите все плагины кроме WooCommerce и проверьте — если проблема решилась, включайте по одному и выявите виновника.

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

• Используйте встроенные методы WooCommerce для получения и изменения запасов (get_stock_quantity(), set_stock_quantity()), чтобы избежать ошибок и конфликтов.
• Не храните логику отображения наличия в шаблонах темы напрямую — используйте фильтры и хуки.
• Оптимизируйте AJAX-запросы, ограничивая частоту вызовов на клиенте (debounce/throttle).
• При большом количестве товаров используйте объектный кеш WooCommerce или внешние решения для кэширования, чтобы не нагружать базу данных.

Сравнение вариантов решения