Как удалить неиспользуемые шорткоды в WordPress: практическое руководство

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

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

Шорткоды — это удобный способ внедрять динамический контент. Однако с течением времени некоторые плагины или темы, которые их регистрировали, перестают использоваться. Если не удалить эти шорткоды, то на сайте могут появляться ошибки вида [shortcode] в тексте или вовсе нарушаться визуальное отображение. Кроме того, это влияет на производительность, особенно если присутствуют обращения к несуществующим функциям.

Удаление старых шорткодов помогает:

• Избежать вывода необработанных тегов на страницах
• Снизить нагрузку на парсер контента WordPress
• Очистить базу данных и содержимое от мусора
• Обеспечить безопасность и стабильность работы

Как определить, какие шорткоды не используются

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

1. Поиск в базе данных

Все шорткоды хранятся в содержимом записей (post_content). Можно выполнить SQL-запрос для поиска шорткодов по шаблону:

SELECT ID, post_title FROM wp_posts WHERE post_content LIKE '%[название_шорткода%';

Этот запрос покажет, где именно встречается конкретный шорткод. Если запрос не вернул результатов — шорткод в тексте не используется.

2. Использование плагинов для аудита

Плагины как Shortcode Cleaner Lite помогают сканировать сайт на наличие неактивных или нераспознанных шорткодов, предлагая опции очистки.

3. Анализ зарегистрированных шорткодов

Можно получить список всех зарегистрированных шорткодов с помощью кода:

function wpupgrade_get_registered_shortcodes() {
    global $shortcode_tags;
    return array_keys($shortcode_tags);
}

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

Как безопасно удалить неиспользуемые шорткоды

Удаление шорткодов — это не просто удаление из базы, а корректное удаление их регистрации и очистка контента, чтобы посетители не видели необработанные теги.

1. Удаление регистрации шорткода

Если шорткод больше не нужен, его следует убрать из реестра WordPress:

function wpupgrade_remove_unused_shortcode() {
    remove_shortcode('название_шорткода');
}
add_action('init', 'wpupgrade_remove_unused_shortcode');

Это предотвратит дальнейшую обработку шорткода.

2. Очистка содержимого от шорткодов

Чтобы убрать необработанные шорткоды из записей, можно использовать фильтр на этапе вывода контента:

function wpupgrade_strip_unused_shortcodes($content) {
    $unused_shortcodes = array('shortcode1', 'shortcode2');
    foreach ($unused_shortcodes as $sc) {
        $pattern = get_shortcode_regex(array($sc));
        $content = preg_replace('/'. $pattern .'/s', '', $content);
    }
    return $content;
}
add_filter('the_content', 'wpupgrade_strip_unused_shortcodes');

Этот код удалит упоминания указанных шорткодов из контента при выводе.

3. Массовое удаление из базы данных

Если нужно очистить контент в базе, можно воспользоваться WP-CLI или написать скрипт для поиска и замены:

function wpupgrade_remove_shortcode_from_db($shortcode) {
    global $wpdb;
    $wpdb->query($wpdb->prepare(
        "UPDATE {$wpdb->posts} SET post_content = REPLACE(post_content, %s, '') WHERE post_content LIKE %s",
        '[' . $shortcode . ']', '%[' . $shortcode . '%'
    ));
}
// Вызов функции для каждого шорткода
wpupgrade_remove_shortcode_from_db('shortcode1');

Но этот метод требует осторожности и резервного копирования базы!

Практические советы и рекомендации

— Всегда делайте резервные копии базы перед массовыми правками.
— Тестируйте изменения на тестовом сайте.
— Если шорткод использовался в виджетах или метаполях, не забудьте проверить и их.
— Для удобства можно использовать плагин Clearfy Pro, который помогает управлять шорткодами и оптимизировать сайт.

Заключение

Удаление неиспользуемых шорткодов — важный этап поддержки и оптимизации WordPress-сайта. С помощью описанных методов вы сможете найти, деактивировать и безопасно очистить контент от ненужных шорткодов, улучшив стабильность и производительность вашего проекта.