Как программно удалить заблокированные или замороженные учётные записи пользователей в WordPress

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

В крупных WordPress-сайтах с регистрацией пользователей часто накапливаются заблокированные или замороженные учётные записи. Они неактивны, могут создавать нагрузку на базу данных и потенциально представлять угрозу безопасности. Часто причиной блокировки становятся подозрения в спаме, длительная неактивность или администраторские меры.

Удаление таких учётных записей вручную занимает много времени и чревато ошибками. Автоматизация с помощью кода решает задачу быстро и безопасно.

Как определить заблокированного пользователя: критерии и фильтрация

Для удаления важно чётко определить, кто считается заблокированным. Обычно для этого используют:

• Пользовательский метаполе (user_meta) с флагом блокировки, например, blocked или account_status => blocked.
• Роль пользователя — например, назначена роль blocked_user.
• Отсутствие активности определённый период (например, не заходил 6 месяцев), данные берутся из user_meta или плагинов логирования.

Пример: в метаполе account_status задано значение blocked для заблокированных аккаунтов.

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

Ниже пример функции, которую можно запустить через WP-CLI или добавить в плагин, чтобы удалить всех пользователей с account_status = blocked:

function wptips_delete_blocked_users() {
    $args = [
        'meta_key' => 'account_status',
        'meta_value' => 'blocked',
        'fields' => 'ID',
        'number' => 100, // лимит на партию
    ];

    $blocked_users = get_users($args);

    if (empty($blocked_users)) {
        echo "Нет заблокированных пользователей для удаления.\n";
        return;
    }

    foreach ($blocked_users as $user_id) {
        require_once ABSPATH . 'wp-admin/includes/user.php';
        wp_delete_user($user_id);
        echo "Пользователь с ID $user_id удалён.\n";
    }
}

Для массового удаления можно запускать эту функцию по крону или вручную через WP-CLI:

wp eval 'wptips_delete_blocked_users();'

Как добавить периодическую очистку по WP-Cron

Добавьте в functions.php или плагин:

if (!wp_next_scheduled('wptips_delete_blocked_users_cron')) {
    wp_schedule_event(time(), 'daily', 'wptips_delete_blocked_users_cron');
}

add_action('wptips_delete_blocked_users_cron', 'wptips_delete_blocked_users');

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

• Используйте get_users(['meta_key' => 'account_status', 'meta_value' => 'blocked']) — запрос должен возвращать пустой массив.
• Проверьте таблицу wp_users в базе данных — заблокированные ID должны отсутствовать.
• Логируйте удаление, выводя ID в консоль или файл, чтобы убедиться, что функция сработала.

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

• Ошибка: Пользователи не удаляются — возможно, не подключен файл wp-admin/includes/user.php перед вызовом wp_delete_user().
  Решение: Добавьте require_once ABSPATH . 'wp-admin/includes/user.php'; перед удалением.
• Ошибка: Скрипт удаляет не тех пользователей — неверно указан meta_key или meta_value.
  Решение: Проверьте конкретные значения в базе, убедитесь в правильности ключа и значения.
• Ошибка: При удалении теряются связанные данные, которые нужны.
  Решение: Создайте резервную копию базы, убедитесь, что удаление безопасно. Можно сначала переместить пользователей в отдельную роль, а потом удалять.
• Ошибка: Скрипт не запускается по cron — WP-Cron отключён или не настроен.
  Решение: Проверьте работу WP-Cron, настройте системный cron для вызова wp-cron.php.

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

• Перед массовым удалением всегда делайте полную резервную копию базы данных.
• Удаление лучше делать партиями по 50-100 пользователей, чтобы избежать таймаутов.
• Проверяйте права пользователя, под которым запускается скрипт — он должен иметь права администратора.
• Для повышения безопасности метаполе блокировки лучше хранить в зашифрованном виде или в защищённом пользовательском поле.
• Если используется плагин для блокировки, изучите его API — возможно, удаление через него сохранит целостность данных.

Сравнение способов удаления заблокированных пользователей