wp plugin: плагины WordPress из терминала
Плагины WordPress можно включать, отключать, ставить и обновлять из терминала, без админки. Главная польза — когда плагин сломал сайт и админка не открывается: одна команда отключает его, и сайт снова работает. Здесь — все команды wp plugin и что значат их ответы.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Посмотрите плагины:
sudo -u www-data wp plugin list --fields=name,status,update+----------------+----------+-----------+ | name | status | update | +----------------+----------+-----------+ | akismet | active | none | | classic-editor | inactive | available | +----------------+----------+-----------+name— имя плагина для команд,status— включён (active) или выключен (inactive),update— есть ли обновление (available) или нет (none).
Почему команды запускают через sudo -u www-data — WP-CLI от пользователя сайта.
Какие столбцы бывают
Без --fields WP-CLI покажет все основные столбцы:
| Столбец | Что значит |
|---|---|
name | имя плагина — его пишут в командах |
status | active — включён, inactive — выключен, must-use — плагин из папки wp-content/mu-plugins: работает, пока лежит в ней |
update | available — есть обновление, none — нет |
version | версия, которая стоит |
update_version | версия, до которой можно обновить |
auto_update | включено ли автообновление плагина |
Только включённые плагины: wp plugin list --status=active.
Отключить плагин
sudo -u www-data wp plugin deactivate classic-editorPlugin 'classic-editor' deactivated.
Success: Deactivated 1 of 1 plugins.Плагин выключен, его файлы остались. Если он уже был выключен:
Warning: Plugin 'classic-editor' isn't active.
Success: Plugin already deactivated.Включить обратно:
sudo -u www-data wp plugin activate classic-editorPlugin 'classic-editor' activated.
Success: Activated 1 of 1 plugins.Если плагин уже включён — Warning: Plugin 'classic-editor' is already active. Если имя написано с ошибкой — Warning: The 'classic-editor' plugin could not be found., а в конце строка Error:. Имя смотрите в столбце name команды wp plugin list.
Если сайт сломал плагин
Сайт пишет о критической ошибке или показывает пустую страницу после установки или обновления плагина:
- Отключите все плагины:
sudo -u www-data wp plugin deactivate --allВ конце —
Success: Deactivatedи сколько плагинов отключено. - Откройте сайт. Если он заработал, виноват один из плагинов.
- Включайте плагины по одному командой
wp plugin activate имяи после каждого открывайте сайт. На каком плагине сайт снова сломается — тот и виноват: отключите его и оставьте выключенным.
Если команда WP-CLI сама обрывается с Fatal error и путём wp-content/plugins/…, добавьте --skip-plugins:
sudo -u www-data wp plugin deactivate --all --skip-pluginsРазбор ошибки на сайте — критическая ошибка WordPress.
Установить плагин
sudo -u www-data wp plugin install classic-editor --activateWP-CLI найдёт плагин в каталоге WordPress.org по имени из адреса его страницы — wordpress.org/plugins/classic-editor/. Ответ начинается строкой Installing с названием и версией плагина. Затем идут строки о скачивании и распаковке — их пишет WordPress, на русском сайте по-русски. В конце:
Activating 'classic-editor'...
Plugin 'classic-editor' activated.
Success: Installed 1 of 1 plugins.Без --activate плагин установится выключенным.
| Что видите | Что значит |
|---|---|
Warning: classic-editor: Plugin already installed. | плагин уже стоит, обновить — wp plugin update classic-editor |
Warning: Couldn't find 'classic-editor' in the WordPress.org plugin directory. | в каталоге нет плагина с таким именем: проверьте имя в адресе страницы плагина |
Обновить плагины
- Выгрузите базу:
sudo -u www-data wp db export - > ~/site.sql(wp db). - Посмотрите, что будет обновлено, ничего не меняя:
sudo -u www-data wp plugin update --all --dry-runОтвет — строка
Available plugin updates:и таблица плагинов с версиями. Если обновлять нечего —No plugin updates available. - Обновите:
sudo -u www-data wp plugin update --allВ конце — таблица:
name— плагин,old_version— старая версия,new_version— новая,status—Updated, если обновлён. Последняя строка —Success: Updatedи сколько плагинов обновлено. - Откройте сайт в браузере.
| Ключ | Что делает |
|---|---|
--all | обновить все плагины |
classic-editor akismet | обновить только эти плагины — имена через пробел вместо --all |
--exclude=akismet | обновить все, кроме этих: WP-CLI напишет Skipped updates for: akismet |
--minor | только обновления вида 1.2 → 1.3, без перехода на 2.0 |
--patch | только обновления вида 1.2.1 → 1.2.2 |
--dry-run | показать, что обновится, и ничего не менять |
Если обновлять нечего — Success: Plugin already updated. Без --all и без имён WP-CLI ответит Error: Please specify one or more plugins, or use --all.
Автообновления плагинов — автообновления WordPress.
Удалить плагин
- Отключите плагин:
sudo -u www-data wp plugin deactivate classic-editor. - Удалите его файлы:
sudo -u www-data wp plugin delete classic-editorDeleted 'classic-editor' plugin. Success: Deleted 1 of 1 plugins.
Удаление нельзя отменить: вернуть плагин можно только установкой заново.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Warning: The 'имя' plugin could not be found. | плагина с таким именем нет на сайте | имя — из столбца name в wp plugin list |
Error: Please specify one or more plugins, or use --all. | не указано, что обновлять | имена плагинов или --all |
Error: Only updated и числа | часть плагинов не обновилась | выше в ответе — строки Warning: с причиной |
Error: No plugins и глагол, например No plugins installed. | ни один плагин не обработан | выше в ответе — строки Warning: с причиной |
Fatal error и путь wp-content/plugins/… | плагин ломает WordPress и WP-CLI вместе с ним | добавьте --skip-plugins (выше) |
| обновление пишет, что не может создать папку | файлы сайта принадлежат другому пользователю | sudo -u www-data (разбор) |
Error: YIKES! It looks like you're running this as root. | команда запущена от root | sudo -u www-data wp … (разбор) |
Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.
Источники
- Документация WP-CLI: wp plugin — на английском: list, activate, deactivate, install, update, delete и их ключи.
Сверено 10 ноября 2026 года.
Что почитать дальше
- wp themeкак сменить тему, если сайт сломала она.
- Ошибки WordPressчто значат сообщения сайта и что делать.
- Команды WP-CLIвсе команды на одной странице.