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

Автор: Алексей Орлов | Опубликовано: 17.02.2026

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

Что такое автоматизация чистокодов и зачем она нужна

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

Автоматизация позволяет:

Динамически регистрировать чистокоды в зависимости от настроек или контекста.
Удалять устаревшие или конфликтующие чистокоды по определенным условиям.
Обеспечивать централизованное управление чистокодами в одном месте.

Теперь рассмотрим, как реализовать подобную автоматизацию на практике.

Автоматическая регистрация чистокодов по конфигурации

Часто требуется, чтобы чистокоды регистрировались не в статичном коде, а динамически, например, из массива настроек. Ниже пример функции wplancer_register_dynamic_shortcodes(), которая читает конфигурацию и регистрирует чистокоды автоматически.

function wplancer_register_dynamic_shortcodes() {
    $shortcodes = [
        'button' => function($atts, $content = null) {
            $a = shortcode_atts(['url' => '#', 'class' => 'btn'], $atts);
            return '<a href="' . esc_url($a['url']) . '" class="' . esc_attr($a['class']) . '">' . $content . '</a>';
        },
        'alert' => function($atts, $content = null) {
            $a = shortcode_atts(['type' => 'info'], $atts);
            return '<div class="alert alert-' . esc_attr($a['type']) . '">' . $content . '</div>';
        }
    ];

    foreach ($shortcodes as $tag => $callback) {
        add_shortcode($tag, $callback);
    }
}
add_action('init', 'wplancer_register_dynamic_shortcodes');

В этом примере массив $shortcodes содержит пары: имя чистокода и функцию обработки. Такая структура позволяет легко добавлять или удалять чистокоды, изменяя лишь конфигурацию.

Преимущества такого подхода

Централизованное управление.
Удобно расширять и модифицировать.
Минимум повторяющегося кода.

Автоматическое удаление чистокодов при определенных условиях

Иногда возникает задача деактивировать или полностью удалить чистокод, например, если плагин отключен или изменились требования. WordPress не предоставляет встроенной функции удаления чистокодов, но мы можем обойти это ограничение.

Для удаления чистокода нужно воспользоваться функцией remove_shortcode(). Чтобы автоматизировать удаление, можно использовать условие, например, проверять настройки или версии.

function wplancer_conditional_remove_shortcodes() {
    $remove_list = ['alert']; // Список удаляемых чистокодов

    foreach ($remove_list as $tag) {
        remove_shortcode($tag);
    }
}
add_action('init', 'wplancer_conditional_remove_shortcodes', 20);

Обратите внимание, что при удалении чистокода важно вызывать remove_shortcode() после регистрации, поэтому выставляем приоритет 20, чтобы это произошло после создания чистокодов.

Как проверить, зарегистрирован ли чистокод

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

function wplancer_is_shortcode_registered($tag) {
    global $shortcode_tags;
    return isset($shortcode_tags[$tag]);
}

Это полезно для динамического управления и отладки.

Использование плагинов для управления чистокодами

Если хочется не только программировать, но и получить UI для управления, рекомендуем обратить внимание на плагины, которые облегчают работу с чистокодами:

Expert Review — позволяет создавать отзывы с помощью шорткодов и управлять ими.
WPRemark — система комментариев и отзывов с поддержкой шорткодов.

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

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

При реализации автоматизации чистокодов в WordPress советуем учитывать следующие моменты:

Используйте неймспейсы в именах функций и чистокодов. Это уменьшит риск конфликтов с другими плагинами. В примерах выше мы использовали префикс wplancer_.
Регистрируйте и удаляйте чистокоды на хук init. Это гарантирует, что все нужные хуки WordPress уже подключены.
Для сложных чистокодов выделяйте отдельные классы. Это повысит читаемость и расширяемость.
Тестируйте работу чистокодов на разных страницах и с разными параметрами. Автоматизация не должна приводить к ошибкам отображения.

Пример расширенного класса для динамических чистокодов

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

class WPLancer_Shortcode_Manager {
    private $shortcodes = [];

    public function __construct() {
        add_action('init', [&$this, 'register_shortcodes']);
        add_action('init', [&$this, 'remove_shortcodes'], 20);
    }

    public function add_shortcode($tag, $callback) {
        $this->shortcodes[$tag] = $callback;
    }

    public function register_shortcodes() {
        foreach ($this->shortcodes as $tag => $callback) {
            add_shortcode($tag, $callback);
        }
    }

    public function remove_shortcodes() {
        // Пример: удаляем шорткод 'old_shortcode' если он зарегистрирован
        if (isset($this->shortcodes['old_shortcode'])) {
            remove_shortcode('old_shortcode');
        }
    }
}

$wplancer_sc_manager = new WPLancer_Shortcode_Manager();
$wplancer_sc_manager->add_shortcode('button', function($atts, $content = null) {
    $a = shortcode_atts(['url' => '#', 'class' => 'btn'], $atts);
    return '<a href="' . esc_url($a['url']) . '" class="' . esc_attr($a['class']) . '">' . $content . '</a>';
});

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