Решение проблем с автообновлениями WooCommerce плагинов при использовании лицензий

Диагностика проблем с автообновлениями WooCommerce плагинов и лицензий

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

• Плагин не получает обновления через стандартный механизм WordPress;
• Отсутствие уведомлений об обновлениях в админке;
• Ошибки типа «Неверный лицензионный ключ» или «Лицензия неактивна»;
• Обновления доступны на сервере, но не скачиваются автоматически.

Для выявления причин необходимо проверить несколько ключевых аспектов:

• Правильность передачи и валидации лицензионного ключа;
• Корректность реализации API для проверки лицензий и обновлений;
• Влияние кэш-систем и плагинов оптимизации на запросы обновлений;
• Совместимость с WordPress и WooCommerce версиями.

Проверка журнала ошибок и запросов

Включите WP_DEBUG и логирование запросов к серверу обновлений для анализа ошибок:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

В файле wp-content/debug.log будут записываться ошибки, связанные с активацией и обновлением.

Пошаговое решение: корректная интеграция лицензий и автообновлений WooCommerce

1. Реализация класса обновлений с проверкой лицензии

Создайте класс, который будет обрабатывать запросы обновлений, проверять лицензию и передавать данные WordPress:

class WC_Plugin_Updater {
    protected $license_key;
    protected $api_url;
    protected $plugin_slug;

    public function __construct($license_key, $api_url, $plugin_slug) {
        $this->license_key = $license_key;
        $this->api_url = $api_url;
        $this->plugin_slug = $plugin_slug;
        add_filter('pre_set_site_transient_update_plugins', array($this, 'check_for_update'));
        add_filter('plugins_api', array($this, 'plugin_api_call'), 10, 3);
    }

    public function check_for_update($transient) {
        if (empty($transient->checked)) {
            return $transient;
        }

        $response = wp_remote_post($this->api_url, array(
            'body' => array(
                'action' => 'check_update',
                'license_key' => $this->license_key,
                'plugin_slug' => $this->plugin_slug,
                'version' => $transient->checked[$this->plugin_slug . '/' . $this->plugin_slug . '.php'],
            ),
        ));

        if (is_wp_error($response) || 200 !== wp_remote_retrieve_response_code($response)) {
            return $transient;
        }

        $data = json_decode(wp_remote_retrieve_body($response));

        if ($data && !empty($data->new_version) && version_compare($transient->checked[$this->plugin_slug . '/' . $this->plugin_slug . '.php'], $data->new_version, '<')) {
            $transient->response[$this->plugin_slug . '/' . $this->plugin_slug . '.php'] = (object) array(
                'slug' => $this->plugin_slug,
                'new_version' => $data->new_version,
                'url' => $data->url,
                'package' => $data->package,
            );
        }

        return $transient;
    }

    public function plugin_api_call($result, $action, $args) {
        if ($action !== 'plugin_information' || $args->slug !== $this->plugin_slug) {
            return $result;
        }

        $response = wp_remote_post($this->api_url, array(
            'body' => array(
                'action' => 'plugin_info',
                'license_key' => $this->license_key,
                'plugin_slug' => $this->plugin_slug,
            ),
        ));

        if (is_wp_error($response) || 200 !== wp_remote_retrieve_response_code($response)) {
            return $result;
        }

        $data = json_decode(wp_remote_retrieve_body($response));

        if ($data) {
            return $data;
        }

        return $result;
    }
}

2. Инициализация класса с параметрами лицензии

В файле основного плагина добавьте инициализацию:

$license_key = get_option('wc_plugin_license_key');
$api_url = 'https://your-license-server.com/api';
$plugin_slug = 'your-plugin-slug';

if ($license_key) {
    new WC_Plugin_Updater($license_key, $api_url, $plugin_slug);
}

3. Проверка корректности хранения и передачи лицензионного ключа

Убедитесь, что ключ хранится в базе корректно и не содержит лишних пробелов, символов. Используйте функцию trim() при получении ключа.

4. Отключение конфликтующих кешей и плагинов

Обязательно проверьте, что плагины кеширования (например, WP Rocket, W3 Total Cache) не кэшируют запросы к серверу обновлений:

• Добавьте исключения для URL API лицензий;
• Отключите объектный кеш (Redis, Memcached) временно для теста;
• Очистите все кеши перед проверкой обновлений.

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

Чтобы убедиться, что автообновления работают:

• Перейдите в Консоль > Обновления и нажмите «Проверить обновления»;
• Если доступна новая версия, система должна показать уведомление и предложить обновление;
• В разделе «Плагины» должна отображаться актуальная версия после обновления;
• Проверьте логи debug.log на отсутствие ошибок.

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

• Ошибка "Неверный лицензионный ключ" при проверке обновления: Проверьте правильность и актуальность ключа, убедитесь, что сервер лицензий отвечает корректно.
• Обновления не отображаются, хотя новая версия есть: Проверьте, что фильтр pre_set_site_transient_update_plugins не перезаписывается другими плагинами.
• Кэширование блокирует обновления: Добавьте исключения в настройки кеша, временно отключите кеш и проверьте снова.
• Ошибка 403 или 500 на API запросы: Проверьте настройки сервера, наличие CORS, защиту firewall.

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

• Используйте WP-Cron для регулярной проверки обновлений, не перегружая страницы админки;
• Обеспечьте защищённое соединение HTTPS для API лицензий и обновлений;
• Храните лицензионные ключи в базе в зашифрованном виде или используйте безопасные опции с update_option();
• Добавьте логирование попыток обновления для анализа возможных проблем;
• Минимизируйте количество вызовов API, кешируя результаты на стороне сервера.

Сравнение вариантов реализации автообновлений WooCommerce плагинов