Использование REST API для синхронизации пользователей и ролей WooCommerce между сайтами WordPress

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

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

Проверить проблему можно так:

• Создайте нового пользователя с ролью «Клиент» на сайте A.
• Проверьте наличие этого пользователя и роли на сайте B.
• Если пользователь отсутствует или роль не совпадает — стандартная синхронизация не работает.

Пошаговое решение с использованием REST API WordPress и WooCommerce

1. Включение и настройка REST API на обоих сайтах

Убедитесь, что на обоих сайтах активирован REST API и настроена аутентификация через OAuth или Basic Auth. Для простоты примера используем Basic Auth с плагином Application Passwords, встроенным в WordPress 5.6+.

2. Создание пользовательского эндпоинта для синхронизации пользователей

Добавьте в файл functions.php или создайте плагин с таким кодом на целевом сайте (куда будет приходить синхронизированная информация):

add_action('rest_api_init', function () {
    register_rest_route('sync/v1', '/users', array(
        'methods' => 'POST',
        'callback' => 'sync_users_callback',
        'permission_callback' => function () {
            return current_user_can('manage_options');
        },
    ));
});

function sync_users_callback(WP_REST_Request $request) {
    $users_data = $request->get_param('users');
    if (!is_array($users_data)) {
        return new WP_Error('invalid_data', 'Users data must be an array', array('status' => 400));
    }
    foreach ($users_data as $user) {
        if (empty($user['user_login']) || empty($user['user_email'])) {
            continue;
        }
        $existing_user = get_user_by('login', $user['user_login']);
        if ($existing_user) {
            // Обновление роли пользователя
            $existing_user->set_role($user['role']);
            wp_update_user(array(
                'ID' => $existing_user->ID,
                'user_email' => $user['user_email'],
            ));
        } else {
            // Создание нового пользователя с временным паролем
            $password = wp_generate_password(12, false);
            $user_id = wp_create_user($user['user_login'], $password, $user['user_email']);
            if (!is_wp_error($user_id)) {
                $new_user = new WP_User($user_id);
                $new_user->set_role($user['role']);
            }
        }
    }
    return rest_ensure_response(array('status' => 'success'));
}

3. Отправка данных с исходного сайта

Используйте следующий код для отправки пользователей с сайта-источника. Этот код можно запускать по расписанию через WP-Cron или вручную:

function send_users_to_remote_site() {
    $users = get_users(array('fields' => array('user_login', 'user_email', 'roles')));
    $users_to_send = array();
    foreach ($users as $user) {
        $users_to_send[] = array(
            'user_login' => $user->user_login,
            'user_email' => $user->user_email,
            'role' => reset($user->roles), // берем первую роль
        );
    }

    $remote_url = 'https://remote-site.com/wp-json/sync/v1/users';
    $username = 'apiuser';
    $password = 'application_password';

    $response = wp_remote_post($remote_url, array(
        'headers' => array(
            'Authorization' => 'Basic ' . base64_encode($username . ':' . $password),
            'Content-Type' => 'application/json',
        ),
        'body' => json_encode(array('users' => $users_to_send)),
        'timeout' => 15,
    ));

    if (is_wp_error($response)) {
        error_log('Sync error: ' . $response->get_error_message());
        return false;
    }

    return true;
}

// Запуск синхронизации вручную
// send_users_to_remote_site();

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

• Создайте нового пользователя на сайте-источнике с ролью «Клиент».
• Вызовите функцию send_users_to_remote_site() (можно через консоль WP-CLI или временно добавить вызов в шаблон).
• Проверьте наличие нового пользователя на сайте-получателе с правильной ролью.
• Измените роль существующего пользователя на сайте-источнике, повторите синхронизацию и проверьте обновление роли на сайте-получателе.

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

• Ошибка 401 Unauthorized — проверьте правильность логина и пароля для Basic Auth, а также наличие нужных прав у пользователя API.
• Пользователь не создаётся — убедитесь, что поля user_login и user_email заполнены и уникальны.
• Роли не обновляются — проверьте, что роли существуют на целевом сайте и совпадают с передаваемыми.
• Проблемы с таймаутами — увеличьте параметр timeout в wp_remote_post.
• Проблемы с безопасностью — не используйте Basic Auth на сайтах без SSL, лучше настроить OAuth или использовать защищённые VPN/токены.

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

• Для защиты REST API эндпоинта используйте проверку nonce или пользовательские capability вместо manage_options, если хотите ограничить доступ.
• Минимизируйте передаваемые данные — отправляйте только необходимые поля.
• Настройте WP-Cron на запуск синхронизации в ночное время, чтобы снизить нагрузку.
• Логируйте ошибки синхронизации в отдельный файл для последующего анализа.
• Рассмотрите использование плагина Clearfy Pro для оптимизации REST API и безопасности вашего сайта.

Сравнение вариантов синхронизации пользователей WooCommerce