Поиск
Справочник

wp plugin: плагины WordPress из терминала

Плагины WordPress можно включать, отключать, ставить и обновлять из терминала, без админки. Главная польза — когда плагин сломал сайт и админка не открывается: одна команда отключает его, и сайт снова работает. Здесь — все команды wp plugin и что значат их ответы.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Посмотрите плагины:
    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имя плагина — его пишут в командах
statusactive — включён, inactive — выключен, must-use — плагин из папки wp-content/mu-plugins: работает, пока лежит в ней
updateavailable — есть обновление, none — нет
versionверсия, которая стоит
update_versionверсия, до которой можно обновить
auto_updateвключено ли автообновление плагина

Только включённые плагины: wp plugin list --status=active.

Отключить плагин

sudo -u www-data wp plugin deactivate classic-editor
Plugin '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-editor
Plugin '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.

Если сайт сломал плагин

Сайт пишет о критической ошибке или показывает пустую страницу после установки или обновления плагина:

  1. Отключите все плагины:
    sudo -u www-data wp plugin deactivate --all

    В конце — Success: Deactivated и сколько плагинов отключено.

  2. Откройте сайт. Если он заработал, виноват один из плагинов.
  3. Включайте плагины по одному командой 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 --activate

WP-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.в каталоге нет плагина с таким именем: проверьте имя в адресе страницы плагина

Обновить плагины

  1. Выгрузите базу: sudo -u www-data wp db export - > ~/site.sql (wp db).
  2. Посмотрите, что будет обновлено, ничего не меняя:
    sudo -u www-data wp plugin update --all --dry-run

    Ответ — строка Available plugin updates: и таблица плагинов с версиями. Если обновлять нечего — No plugin updates available.

  3. Обновите:
    sudo -u www-data wp plugin update --all

    В конце — таблица: name — плагин, old_version — старая версия, new_version — новая, status — Updated, если обновлён. Последняя строка — Success: Updated и сколько плагинов обновлено.

  4. Откройте сайт в браузере.
КлючЧто делает
--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.

Удалить плагин

  1. Отключите плагин: sudo -u www-data wp plugin deactivate classic-editor.
  2. Удалите его файлы:
    sudo -u www-data wp plugin delete classic-editor
    Deleted '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.команда запущена от rootsudo -u www-data wp … (разбор)

Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.

Источники

Сверено 10 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше

  • wp themeкак сменить тему, если сайт сломала она.
  • Ошибки WordPressчто значат сообщения сайта и что делать.
  • Команды WP-CLIвсе команды на одной странице.