Описание do_shortcode_tag
— Filter
Хук do_shortcode_tag позволяет изменить обработку шорткодов в WordPress. Он срабатывает при выполнении шорткода и позволяет модифицировать его поведение и вывод перед отображением на странице
Примеры использования
Пример изменения вывода шорткода [example_shortcode]:
add_filter('do_shortcode_tag', function($result, $tag, $attr, $content) {
if ($tag === 'example_shortcode') {
return 'Измененный вывод шорткода';
}
return $result;
}, 10, 4);
Этот код изменяет вывод шорткода [example_shortcode] на ‘Измененный вывод шорткода’
Пример добавления атрибутов к шорткоду:
add_filter('do_shortcode_tag', function($result, $tag, $attr) {
if ($tag === 'example_shortcode') {
$attr['new_attribute'] = 'Новое значение';
}
return $result;
}, 10, 3);
С помощью этого кода мы добавляем новый атрибут к шорткоду [example_shortcode]
Пример модификации контента шорткода:
add_filter('do_shortcode_tag', function($result, $tag, $attr, $content) {
if ($tag === 'example_shortcode') {
return str_replace('старое', 'новое', $content);
}
return $result;
}, 10, 4);
Этот код заменяет слово ‘старое’ на ‘новое’ в содержимом шорткода [example_shortcode]
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить поведение или вывод шорткодов в WordPress
– Производительность
Поскольку хук работает с результатом выполнения шорткодов, его использование не должно значительно влиять на производительность, если не применять ресурсоемкие операции
– Предупреждения
Следите за тем, чтобы изменения не нарушали функциональность шорткодов, используемых другими плагинами или темами
Альтернативы
Тип: function
Функция добавления нового шорткода и его обработки
Используйте add_shortcode, когда необходимо создать новый шорткод с уникальным поведением
