Решение проблемы необновления статуса оплаты WooCommerce в LearnPress

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

При интеграции LearnPress с WooCommerce одна из частых проблем — несинхронизация статусов заказов и оплаты. Например, пользователь оплатил курс через WooCommerce, но статус оплаты в LearnPress не обновился, и доступ к курсу не предоставлен.

Для диагностики:

• Проверьте, что в WooCommerce заказ оплачен (статус "processing" или "completed").
• В админке LearnPress убедитесь, что статус оплаты по курсу остался "неоплачено".
• Активируйте WP_DEBUG и проверьте логи на наличие ошибок, связанных с хуками LearnPress и WooCommerce.
• Проверьте, не конфликтует ли другой плагин с обработкой статусов заказов.

Почему LearnPress не обновляет статус оплаты с WooCommerce

Основные причины:

• Обработчик статусов WooCommerce не вызывается или отключён.
• Конфликт хуков или неправильный приоритет обработки событий.
• Кэширование страниц или объектов, из-за которого статус не меняется мгновенно.
• Проблемы с настройками платежных шлюзов или отложенной оплатой.

Пошаговое решение: как заставить LearnPress обновлять статус оплаты

1. Подключение обработчика обновления статусов заказов

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

add_action('woocommerce_order_status_completed', 'lp_sync_order_status_with_learnpress', 10, 1);
function lp_sync_order_status_with_learnpress($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);
    if (!$order) return;

    foreach ($order->get_items() as $item) {
        $product_id = $item->get_product_id();
        // Получаем курсы LearnPress, связанные с продуктом WooCommerce
        $course_id = get_post_meta($product_id, '_lp_course', true); // Предполагается, что связь хранится в мета

        if ($course_id) {
            $user_id = $order->get_user_id();
            if ($user_id) {
                // Отметить курс как оплаченный
                learn_press_update_user_course_status($user_id, $course_id, 'enrolled');
            }
        }
    }
}

Этот код слушает событие завершения оплаты заказа WooCommerce и обновляет статус курса LearnPress для пользователя.

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

Убедитесь, что у каждого WooCommerce продукта, который продаёт курс, в метаполях _lp_course хранится ID соответствующего курса LearnPress. Если такой метаполе нет, создайте его вручную или через код при создании товаров.

3. Отключение кэширования для страниц оплаты и профиля

Кэширование на уровне сервера или плагинов (например, WP Super Cache, W3 Total Cache) может мешать обновлению статусов. Добавьте исключения для страниц, связанных с LearnPress и WooCommerce:

# В wp-config.php
define('DONOTCACHEPAGE', true); // на странице оплаты и курсов

Как проверить, что проблема решена

• Создайте тестовый заказ в WooCommerce и оплатите его.
• Проверьте статус заказа в WooCommerce — он должен быть "completed".
• В админке LearnPress убедитесь, что статус курса у пользователя изменился на "enrolled" или аналогичный.
• Авторизуйтесь под аккаунтом пользователя и проверьте, что доступ к курсу открыт.
• Включите логирование и убедитесь, что функция lp_sync_order_status_with_learnpress отрабатывает без ошибок.

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

• Отсутствие метаполя связи курса и товара: Без корректного ID курса функция не обновит статус. Проверьте метаполя через phpMyAdmin или плагин Advanced Custom Fields.
• Неверный приоритет или пропущенный хук: Убедитесь, что добавленный хук подключён с приоритетом 10 и не переопределяется другими плагинами.
• Проблемы с пользовательским ID: Если заказ сделан гостем, $order->get_user_id() может быть пустым. В таком случае нужно реализовать дополнительную логику для привязки гостя к пользователю.
• Кэширование мешает обновлению: Отключите все кэши и повторите тест.

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

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

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