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

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

Если при интеграции системы лицензирования в WooCommerce плагин возникают ошибки, важно сначала определить источник проблемы. Типичные симптомы:

• Лицензия не активируется или не деактивируется
• Обновления плагина не проходят проверку лицензии
• Ошибки в ответах API лицензионного сервера
• Конфликты с другими плагинами, кешем или REST API

Для диагностики используйте встроенный лог ошибок WordPress и включите WP_DEBUG в wp-config.php:

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

Логи сохраняются в wp-content/debug.log. Проверьте их после попытки активации лицензии.

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

1. Правильное хранение лицензионного ключа

Лицензионный ключ должен сохраняться в опциях WordPress с уникальным префиксом, чтобы избежать конфликтов:

update_option('myplugin_license_key', sanitize_text_field($_POST['license_key']));

2. Реализация проверки лицензии через REST API

Пример запроса к серверу лицензий с обработкой ответа:

function myplugin_check_license($license_key) {
    $response = wp_remote_post('https://license-server.example.com/api/check', [
        'body' => ['license_key' => $license_key]
    ]);
    if (is_wp_error($response)) {
        return false;
    }
    $data = json_decode(wp_remote_retrieve_body($response), true);
    return !empty($data['valid']);
}

3. Интеграция проверки в обновления WooCommerce плагина

Добавьте проверку лицензии перед выполнением обновления, используя хук pre_set_site_transient_update_plugins:

add_filter('pre_set_site_transient_update_plugins', function($transient) {
    if (empty($transient->response)) {
        return $transient;
    }
    $license_key = get_option('myplugin_license_key');
    if (!myplugin_check_license($license_key)) {
        unset($transient->response['myplugin/myplugin.php']);
    }
    return $transient;
});

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

• Попробуйте активировать лицензию с корректным и некорректным ключом и просмотрите логи debug.log на наличие ошибок
• Перейдите в раздел обновлений плагинов — при действующей лицензии обновления должны отображаться, иначе — нет
• Проверьте, что REST API-запросы к серверу лицензий возвращают ожидаемые статусы

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

• Ошибка: Запросы к серверу лицензий блокируются хостингом
  Проверьте firewall и ограничения PHP (например, allow_url_fopen, cURL). Добавьте вывод ошибок wp_remote_post для отладки.
• Ошибка: Кеширование результатов проверки лицензии
  Добавьте уникальный параметр времени или используйте transient с коротким сроком хранения, чтобы избежать кеширования устаревших данных.
• Ошибка: Конфликты REST API с другими плагинами
  Проверьте, нет ли перехвата маршрутов REST API. Используйте префиксы и уникальные namespace.
• Ошибка: Неправильное сохранение ключа
  Всегда используйте функции санитизации и проверяйте наличие данных перед сохранением.

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

• Используйте HTTPS для всех запросов к лицензионному серверу
• Храните лицензионные ключи в базе данных в зашифрованном виде, например с помощью функций OpenSSL и опций с обновлением
• Минимизируйте количество запросов к лицензионному серверу — например, проверяйте лицензию только при активации и обновлениях
• Для больших магазинов с WooCommerce добавьте асинхронную проверку лицензии через WP-Cron, чтобы не замедлять загрузку страниц

Сравнение вариантов реализации проверки лицензии