Функция APPLY_SHORTCODES() в WordPress 5.4.0

Функция apply_shortcodes() предназначена для поиска шорткодов в тексте и их обработки через соответствующие хуки. Эта функция является синонимом функции do_shortcode(), которая выполняет аналогичную задачу.

Как она работает

Функция использует несколько других функций:

• do_shortcode_tag(): обрабатывает конкретный шорткод.
• get_shortcode_regex(): генерирует регулярное выражение для поиска шорткодов.
• do_shortcodes_in_html_tags(): обрабатывает шорткоды внутри HTML-тегов.

Производительность: Время выполнения функции при 50 000 вызовах — всего 0.67 секунды, что довольно быстро.

Возвращаемое значение

Функция возвращает строку — текст с обработанными шорткодами.

Как использовать

Аргументы

Функция принимает два аргумента:

• $content (строка, обязательный): текст, в котором нужно искать шорткоды.
• $ignore_html (истина/ложь): если установлен в true, функция пропустит шорткоды внутри HTML-тегов. По умолчанию — false.

Примеры использования

Пример 1: Простой вызов

Функция apply_shortcodes() является синонимом do_shortcode(), поэтому вы можете посмотреть примеры использования этой функции здесь.

echo apply_shortcodes( '[somename]' ); // Выводит результат шорткода

Пример 2: Шорткод с параметрами

Вы можете передавать параметры в шорткоды:

echo apply_shortcodes( '
Error: Contact form not found.
' ); // Выводит форму контактов

Пример 3: Шорткод в контенте

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

echo apply_shortcodes( '[myshrtcode]Мой текст[/myshrtcode]' ); // Отобразит результат шорткода

Заметки

• Для дополнительной информации о шорткодах ознакомьтесь с функцией do_shortcode().

Изменения

• С версии 5.4.0: Функция была добавлена в ядро WordPress.

Код функции

Ниже представлена реализация функции apply_shortcodes():

function apply_shortcodes( $content, $ignore_html = false ) {
return do_shortcode( $content, $ignore_html );
}

Связанные функции

• add_shortcode(): добавляет новый шорткод.
• do_shortcode(): выполняет обработку шорткода.
• gallery_shortcode(): обработчик шорткода для галерей.
• get_shortcode_regex(): генерирует регулярное выражение для поиска шорткодов.
• has_shortcode(): проверяет наличие шорткода в тексте.
• remove_all_shortcodes(): удаляет все шорткоды из текста.
• remove_shortcode(): удаляет конкретный шорткод.
• shortcode_atts(): обрабатывает атрибуты шорткода.
• shortcode_exists(): проверяет, существует ли шорткод.
• shortcode_parse_atts(): парсит атрибуты шорткода.
• strip_shortcodes(): удаляет все шорткоды из текста.
• wp_audio_shortcode(): обрабатывает аудио-шорткод.
• wp_playlist_shortcode(): обрабатывает шорткод плейлиста.
• wp_video_shortcode(): обрабатывает видео-шорткод.

Эта статья поможет вам понять, как использовать функцию apply_shortcodes() в WordPress и эффективно обрабатывать шорткоды в вашем контенте.