Плагины WordPress: установка, проверка и аварийное отключение

За 30-40 минут вы установите плагин в WordPress, проверите, что сайт после этого жив, и узнаете, как отключить плагин, если админка перестала открываться. Последнее нужно чаще, чем кажется: один неудачный плагин или обновление дают белый экран, и тогда выручает доступ к файлам. Статья написана для WordPress 6.x.

Что нужно до начала

• Учётная запись с ролью «Администратор». Редактор раздел «Плагины» не увидит.
• Доступ к файлам сайта по SFTP или FTP либо файловый менеджер хостинга. Без него вы не сможете отключить плагин, когда админка не открывается.
• Свежая резервная копия файлов и базы данных. Сделайте её средствами хостинга.
• Необязательно: SSH-доступ и установленный WP-CLI для последнего раздела.

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

Журнал ошибок: что вписать в wp-config.php

Откройте файл wp-config.php в корне сайта и добавьте три строки выше комментария «That's all, stop editing!». Если такие константы там уже есть, поменяйте значения, а не дублируйте строки: повторное определение даст предупреждение PHP.

// Журнал ошибок для проверки плагина (WordPress 6.x)
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Проверка: файл debug.log появится при первой записанной ошибке. Пока его нет, это нормально.

Шаги: от выбора до удаления

1. Выберите плагин. Откройте «Плагины → Добавить новый» (название пункта слегка различается по версиям) и найдите нужный. В карточке смотрите на дату последнего обновления, число активных установок и строку о совместимости с вашей версией WordPress. Ориентир: плагин, который не обновлялся пару лет, лучше пропустить. Проверка: в карточке видны все три показателя, и они вас устраивают.
2. Установите и активируйте. Нажмите «Установить», затем «Активировать». Проверка: в списке «Установленные плагины» у плагина есть ссылка «Деактивировать».
3. Или загрузите ZIP. Если плагин не из каталога: «Плагины → Добавить новый → Загрузить плагин», выберите архив, нажмите «Установить». Проверка: WordPress сообщает об успешной установке и предлагает активацию.
4. Проверьте сайт. Откройте главную в приватном окне браузере, затем страницы, где плагин должен работать (форма, корзина, галерея), и админку. Проверка: страницы открываются, а в debug.log нет новых строк, где в пути встречается wp-content/plugins/имя-плагина.
5. Обновляйте по одному. Сначала бэкап, потом один плагин, потом проверка сайта, как в шаге 4. Так сразу видно, какое обновление сломало сайт. Проверка: в списке исчезла пометка «Доступно обновление», версия выросла.
6. Уберите ненужное. Сначала «Деактивировать», посмотрите на сайт, затем «Удалить». Учтите: удаление может стереть данные плагина из базы, это зависит от самого плагина. Проверка: плагина нет в списке, а папки нет в wp-content/plugins.

Свой минимальный плагин

Плагин в WordPress это PHP-файл с комментарием-заголовком в папке wp-content/plugins. Чтобы увидеть, как это работает, создайте файл wp-content/plugins/site-note/site-note.php:

<?php
/**
 * Plugin Name: Site Note
 * Description: Выводит короткую заметку в подвале сайта.
 * Version: 1.0.0
 * Requires at least: 6.0
 * Requires PHP: 7.4
 * License: GPL-2.0-or-later
 */

// Файл нельзя запускать напрямую, только через WordPress
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// Печатает абзац там, где тема вызывает wp_footer()
function site_note_print() {
	echo '<p>' . esc_html( 'Заметка из плагина Site Note.' ) . '</p>';
}
add_action( 'wp_footer', 'site_note_print' );

Пояснение: хук (hook) это точка в коде WordPress, к которой плагин подключает свою функцию. Хук-действие (action) что-то делает, хук-фильтр (filter) меняет данные.

Проверка: в списке плагинов появился «Site Note». После активации в подвале сайта видна заметка. Если её нет, тема, вероятно, не вызывает wp_footer(). Описание заголовков плагина лежит в официальной документации.

Аварийное отключение, когда админка не открывается

1. Подключитесь по SFTP и откройте wp-content/plugins. Переименуйте папку подозрительного плагина, например в site-note_off. Проверка: обновите страницу сайта, критическая ошибка исчезла.
2. Не знаете, какой плагин виноват: переименуйте всю папку plugins в plugins_off и зайдите в админку. Проверка: админка открывается, плагины в списке не активны.
3. Верните имя папке plugins и включайте плагины по одному, проверяя сайт после каждого. Проверка: на каком плагине сайт снова падает, тот и причина.

С доступом по SSH то же самое делается через WP-CLI из корня сайта:

# Список плагинов и их статус
wp plugin list

# Отключить один плагин по имени папки
wp plugin deactivate site-note

# Отключить все плагины сразу
wp plugin deactivate --all

# Включить плагин обратно
wp plugin activate site-note

Если не получилось

• «Installation failed: Could not create directory.» Нет прав на запись в wp-content/plugins. Проверьте владельца и права папки или напишите в поддержку хостинга.
• «The uploaded file exceeds the upload_max_filesize directive in php.ini.» Архив больше лимита загрузки. Распакуйте его локально и загрузите папку плагина в wp-content/plugins по SFTP.
• «Plugin could not be activated because it triggered a fatal error.» Откройте wp-content/debug.log и найдите строку «PHP Fatal error» с путём к файлу плагина. Частые причины: версия PHP ниже требуемой плагином или конфликт с другим плагином.
• «There has been a critical error on this website.» Сайт упал после активации или обновления. WordPress обычно шлёт администратору письмо со ссылкой на режим восстановления. Если письма нет, используйте аварийное отключение выше.
• «Briefly unavailable for scheduled maintenance. Check back in a minute.» Обновление прервалось. Удалите файл .maintenance в корне сайта и повторите обновление.

Что делать дальше

Верните в wp-config.php значение WP_DEBUG на false и удалите debug.log: на некоторых серверах файл доступен по прямой ссылке. Затем пройдитесь по списку плагинов и уберите те, которыми не пользуетесь. Если сайт стал медленнее, поставьте на время плагин Query Monitor: он показывает время и запросы к базе в разрезе плагинов. Обязательные для сайта плагины в виде mu-plugins и безопасность чужого кода это отдельные темы, здесь мы их не разворачивали.