apply_shortcodes() │ WP 5.4.0

Это новое название (алиас) функции do_shortcode().

Находит в переданном тексте зарегистрированные шорткоды и обрабатывает их.

Функция обработает только шорткоды, о которых WP знает (которые зарегистрированы как шорткоды). Шорткоды регистрируются с помощью функции add_shortcode(). Т.е. конструкции вида [some_name] не будут удалены или обработаны, если в WordPress не добавлен шорткод some_name.

Если тег шорткода неизвестен, то контент вернется как есть (шорткод в нем не будет обработан). Такое может получиться, например, когда Плагин отключен, но его шорткод используется в контенте.

Читайте обязательно: Шорткоды в WordPress.

Работает на основе: do_shortcode_tag(), get_shortcode_regex(), do_shortcodes_in_html_tags()
1 раз — 0.0004201 сек (быстро) | 50000 раз — 0.67 сек (очень быстро)

Хуков нет.

Возвращает

Строку. Текст, в котором шоткоды обработаны (изменены на вывод прикрепленных к ним функций).

Использование

do_shortcode( $content, $ignore_html );
$content(строка) (обязательный)
Текст в котором нужно преобразовать шорткоды.
$ignore_html(строка)
Игнорировать ли шорткоды внутри HTML. Если поставить true, то шорткоды внутри HTML обработаны не будут.
По умолчанию: false

Примеры

2

#1 Обработка отдельного шорткода

Использование шоткода в PHP файле, за пределами контента, когда нужно получить вывод шоткода отдельно.

Этот пример показывает как обработать шорткод из кода PHP. Например, если нужно вывести шорткод в где-то произвольном месте шаблона.

echo apply_shortcodes( '[somename]' );

или такой пример:

echo apply_shortcodes( '[contact-form-7 id="91" title="quote"]' );

Контентный шорткод:

echo apply_shortcodes( '[myshrtcode]My Text[/myshrtcode]' );
0

#2 Еще примеры

Смотрите в описании Функции do_shortcode().

Заметки

Список изменений

С версии 5.4.0 Введена.

Код apply_shortcodes() WP 6.5.2

wp-includes/shortcodes.php 
function apply_shortcodes( $content, $ignore_html = false ) {
	return do_shortcode( $content, $ignore_html );
}

Шорткоды