Как использовать WP-CLI для массового изменения ролей пользователей в WordPress

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

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

Часто встречающиеся ситуации:

• Перевод всех подписчиков в редакторы для расширения прав.
• Снятие административных прав у группы пользователей.
• Изменение роли для пользователей, зарегистрированных до определённой даты.

Как проверить текущие роли пользователей

Для начала полезно получить список пользователей с их ролями, чтобы убедиться, кто и какую роль имеет. Для этого удобно использовать WP-CLI:

wp user list --fields=ID,user_login,roles --format=table

Это выведет таблицу с ID, логинами и ролями пользователей.

Пошаговое решение: массовое изменение ролей через WP-CLI

1. Получение ID пользователей по критериям

Допустим, надо изменить роль всем пользователям с ролью subscriber. Сначала получим их ID:

wp user list --role=subscriber --field=ID

2. Изменение роли пользователя

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

wp user set-role USER_ID editor

где USER_ID — ID пользователя, а editor — новая роль.

3. Массовое изменение ролей через цикл

Чтобы изменить роль сразу у всех подписчиков, можно использовать команду оболочки bash:

for id in $(wp user list --role=subscriber --field=ID); do
  wp user set-role $id editor
  echo "Changed user $id role to editor"
done

Это последовательно изменит роль у всех пользователей с ролью subscriber на editor.

4. Альтернатива: добавление роли без удаления старой

Если нужно не заменить роль, а добавить новую (например, у пользователя несколько ролей), используйте:

wp user add-role USER_ID new_role

Аналогично для массового добавления ролей можно применить цикл.

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

После выполнения изменений проверьте, что роли действительно изменились:

wp user list --role=editor --fields=ID,user_login --format=table

Сравните список с тем, что ожидали изменить. Также можно зайти в панель администратора и проверить несколько пользователей.

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

• Ошибка: «Error: User does not exist» — означает, что указанный ID пользователя неверен. Проверьте правильность списка ID.
• Ошибка: «You do not have sufficient permissions» — недостаточно прав для изменения ролей. Запустите WP-CLI с правами администратора сервера или используйте sudo.
• Ошибка: неправильное имя роли — убедитесь, что роль существует в WordPress, например editor, subscriber, administrator и т.д.
• Непреднамеренная потеря роли — команда set-role заменяет все роли пользователя, будьте внимательны, если у пользователя несколько ролей.

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

• Перед массовыми изменениями всегда делайте резервную копию базы данных, чтобы можно было откатиться при ошибках.
• Для очень большого количества пользователей (более 10000) разбивайте обработку на блоки, чтобы не перегружать сервер.
• Используйте WP-CLI на сервере, а не через удалённые вызовы, чтобы избежать проблем с тайм-аутами.
• Проверяйте роли с помощью WP-CLI после изменений, чтобы исключить ошибочные изменения.
• Если в проекте используются кастомные роли, убедитесь, что все роли зарегистрированы и доступны в момент выполнения команд.

Сравнение вариантов массового изменения ролей