Удаление неиспользуемых шорткодов из базы данных WordPress

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

Шорткоды часто остаются в контенте после удаления плагинов или тем, которые их использовали. Они отображаются как текст, портят внешний вид сайта и засоряют базу данных. Для выявления таких шорткодов необходимо просканировать содержимое постов и страниц на наличие нераспознанных шорткодов.

Для диагностики используйте следующий SQL-запрос в phpMyAdmin или любом другом инструменте работы с базой данных:

SELECT ID, post_title, post_content FROM wp_posts WHERE post_content LIKE '%[old_shortcode%';

Замените old_shortcode на имя шорткода, который вы удалили или не используете. Если таких записей много, стоит очистить базу.

Пошаговое решение удаления неиспользуемых шорткодов из базы данных

1. Резервное копирование базы данных

Перед любыми изменениями создайте полную резервную копию базы данных с помощью phpMyAdmin, WP-CLI или плагинов типа UpdraftPlus.

2. Поиск и удаление шорткодов с помощью WP-CLI

WP-CLI позволяет быстро массово заменить или удалить шорткоды из контента. Для удаления всех вхождений шорткода [old_shortcode] используйте команду:

wp search-replace '\[old_shortcode[^\]]*\]' '' --regex --skip-columns=guid --allow-root

Пояснения:

• \[old_shortcode[^\]]*\] — регулярное выражение для поиска шорткода с параметрами;
• --regex — указывает, что поиск по регулярному выражению;
• --skip-columns=guid — исключает из поиска поле guid, чтобы не повредить ссылки;
• --allow-root — если запускаете от root (на сервере).

3. Удаление шорткодов через SQL (альтернативный способ)

Если WP-CLI недоступен, можно использовать SQL-запрос, который заменит шорткод на пустую строку в post_content:

UPDATE wp_posts SET post_content = REGEXP_REPLACE(post_content, '\\[old_shortcode[^\\]]*\\]', '') WHERE post_content REGEXP '\\[old_shortcode';

Обратите внимание, что функция REGEXP_REPLACE доступна в MySQL 8+. Если у вас более старая версия, придется экспортировать базу и править контент через скрипты PHP.

Проверка результата

После удаления шорткода проверьте несколько страниц и постов на наличие следов старого шорткода. В админке используйте поиск по контенту или снова выполните SQL-запрос из раздела диагностики — он должен вернуть 0 результатов.

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

define('WP_DEBUG', true);

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

• Ошибка «спецсимволы в регулярном выражении»: всегда экранируйте квадратные скобки в регулярках двойным обратным слешем (например, \[).
• Удаление шорткодов ломает контент: если шорткод содержал важные данные, удалите его вручную или замените на альтернативный вывод.
• SQL-запрос не работает из-за версии MySQL: используйте WP-CLI или экспортируйте базу и обработайте в PHP-скрипте.
• Запрос заменяет лишний контент: уточните регулярное выражение, чтобы оно не удаляло похожий текст.

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

• Всегда создавайте резервную копию базы перед массовыми изменениями.
• Проводите замену на тестовом сервере, чтобы избежать ошибок на живом сайте.
• Используйте WP-CLI для работы с базой — это быстрее и безопаснее.
• Если часто меняете шорткоды, внедрите в тему или плагин фильтр do_shortcode_tag для вывода заглушек, чтобы легче контролировать использование.

Сравнение методов удаления неиспользуемых шорткодов

Метод	Преимущества	Недостатки
WP-CLI search-replace	Быстро, безопасно, поддерживает регулярки	Требуется доступ к командной строке
SQL REGEXP_REPLACE	Можно запускать из phpMyAdmin, нет внешних зависимостей	Требует MySQL 8+, риск случайной замены
PHP-скрипт обработки	Гибкость, можно учитывать сложный контекст	Нужно писать код, дольше по времени

Пример PHP-скрипта для удаления шорткодов из постов (если нет WP-CLI и MySQL 8+)

<?php
function remove_old_shortcode_from_posts() {
    $args = [
        'post_type'      => 'any',
        'posts_per_page' => -1,
        'post_status'    => 'any',
        's'              => '[old_shortcode',
    ];
    $query = new WP_Query($args);

    while ($query->have_posts()) {
        $query->the_post();
        $content = get_the_content(null, false, get_the_ID());
        $pattern = '/\[old_shortcode[^\]]*\]/';
        $new_content = preg_replace($pattern, '', $content);
        if ($new_content !== $content) {
            wp_update_post([
                'ID'           => get_the_ID(),
                'post_content' => $new_content,
            ]);
        }
    }
    wp_reset_postdata();
}
remove_old_shortcode_from_posts();
?>