apply_shortcodes()
Це нова назва (аліас) функції do_shortcode() .
Знаходить у переданому тексті зареєстровані шорткоди та обробляє їх.
Функція обробить тільки шорткод, про які WP знає (які зареєстровані як шорткод). Шорткоди реєструються за допомогою функції add_shortcode() . Тобто. конструкції виду [some_name] не будуть видалені або оброблені, якщо WordPress не доданий шорткод some_name .
Якщо тег шорткоду невідомий, то контент повернеться як є (шорткод у ньому не буде оброблений). Таке може вийти, наприклад, коли Плагін відключено, але його шорткод використовується в контенті.
Читайте обов’язково: Шорткоди в WordPress .
(швидко) | 50000 разів – 0.67 сек
(дуже швидко)
Хуків немає.
Повертає
Строку
. Текст, у якому шоткоди оброблені (змінено виведення прикріплених до них функцій).
Використання
do_shortcode($content, $ignore_html);
-
$content
(рядок) (обов’язковий) - Текст у якому потрібно перетворити шорткод.
-
$ignore_html
(рядок) -
Чи ігнорувати шорткоди всередині HTML. Якщо поставити true, то шорткод всередині HTML оброблені не будуть.
Типово: false
Приклади
#1 Обробка окремого шорткоду
Використання шоткоду в PHP файлі, за межами контенту, коли потрібно отримати вивод шоткоду окремо.
Цей приклад показує як обробити шорткод із коду PHP. Наприклад, якщо потрібно вивести шорткод у десь довільному місці шаблону.
echo apply_shortcodes('[somename]');
або такий приклад:
echo apply_shortcodes( '[contact-form-7 id="91" title="quote"]' );
#2 Ще приклади
Дивіться у описі Функції do_shortcode() .
нотатки
- Дивіться: do_shortcode()
список змін
З версії 5.4.0 | Введено. |
Код apply_shortcodes() apply shortcodes WP 6.0.2
function apply_shortcodes( $content, $ignore_html = false ) { return do_shortcode( $content, $ignore_html ); }