Как удалить все оставшиеся виджеты после удаления плагинов WordPress

Проблема: оставшиеся виджеты после удаления плагинов

При удалении плагина WordPress, который добавлял собственные виджеты, часто остаются их следы в базе данных — заполненные боковые панели с неактивными или «пустыми» виджетами. Это ведёт к захламлению админки и может повлиять на производительность сайта.

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

Для проверки наличия остатков виджетов выполните следующие действия:

• Перейдите в Внешний вид > Виджеты и посмотрите на списки боковых панелей. Если есть блоки с названием удалённого плагина или пустые виджеты «Неактивный виджет», значит, остатки есть.
• В базе данных в таблице wp_options найдите опцию sidebars_widgets. Она содержит массив с назначениями виджетов по боковым панелям. Если там есть виджеты с названиями удалённых плагинов — они не удалены.
• Через консоль WP-CLI можно вывести список виджетов:

  wp widget list

  Если в списке есть виджеты от удалённых плагинов, значит их надо почистить.

Пошаговое решение удаления оставшихся виджетов

1. Резервное копирование

Перед изменениями обязательно сделайте бэкап базы данных и файлов сайта.

2. Очистка через админку

Перетащите неактивные виджеты из боковых панелей в блок «Неактивные виджеты». Затем вручную удалите их из этого блока.

3. Очистка через WP-CLI

Если виджетов много или админка не выводит их корректно, воспользуйтесь WP-CLI. Например, чтобы очистить все виджеты из боковой панели sidebar-1:

wp option get sidebars_widgets --format=json | jq '."sidebar-1" = []' | wp option update sidebars_widgets -

Для удаления конкретных виджетов можно отредактировать опции widget_{widget_name} (например, widget_text для текстовых виджетов), удалив ненужные данные.

4. Автоматизация очистки виджетов удалённых плагинов через код

Добавьте следующий код в файл functions.php вашей темы или в отдельный плагин для удаления виджетов с префиксом, например, plugin_widget_:

function remove_plugin_widgets() {
    $sidebars_widgets = get_option('sidebars_widgets');
    if (empty($sidebars_widgets)) return;
    $changed = false;
    foreach ($sidebars_widgets as $sidebar => $widgets) {
        if (!is_array($widgets)) continue;
        foreach ($widgets as $key => $widget_id) {
            if (strpos($widget_id, 'plugin_widget_') === 0) {
                unset($sidebars_widgets[$sidebar][$key]);
                $changed = true;
            }
        }
    }
    if ($changed) update_option('sidebars_widgets', $sidebars_widgets);
}
add_action('admin_init', 'remove_plugin_widgets');

Замените plugin_widget_ на префикс виджетов вашего удалённого плагина.

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

• Обновите страницу Внешний вид > Виджеты — должны исчезнуть пустые и неактивные виджеты удалённого плагина.
• Через WP-CLI выполните wp widget list, чтобы убедиться, что соответствующие виджеты больше не отображаются.
• Проверьте фронтенд сайта, чтобы убедиться, что боковые панели показываются корректно без ошибок.

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

• Не удаляются виджеты после удаления кода: возможно, вы не указали правильный префикс виджетов. Используйте print_r(get_option('sidebars_widgets')); для уточнения ID виджетов.
• Ошибка при обновлении опции в WP-CLI: убедитесь, что используете правильный синтаксис и у вас есть права на изменение базы данных.
• Виджеты появляются заново после сброса: проверьте, не восстанавливает ли их плагин для миграций или кеширование.

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

• Перед массовыми изменениями в базе данных используйте бэкапы и тестируйте на копии сайта.
• Избегайте частых прямых изменений опций без понимания структуры данных, чтобы не повредить сайт.
• Если у вас сложный сайт с большим количеством виджетов, рассмотрите использование плагинов для управления виджетами, например, Widget Context, вместо ручной очистки.

Сравнение способов очистки оставшихся виджетов