Переглядає текст на наявність в ньому шорткодов і застосовує зареєстровані функції до знайденим шорткодам.
Функція обробить тільки шорткоди, про які WP знає (які зареєстровані як шорткоди). Шорткоди реєструються за допомогою функції add_shortcode (). Тобто конструкції виду [some_name] НЕ будуть видалені або оброблені, якщо в WordPress не додано шорткод some_name.
Шорткод (шоткод) - це конструкція в тексті, яка буде оброблена і замінена на будь-якої HTML код. Шорткод може викликатися по-різному. Приклад виклику шорткода [somename]:
- [Somename]
- [Somename id = "123" size = "medium"]
- [Somename] текст [/ somename]
Вона обробляється функції відповідає за даний шоткод. Шоткоди і функції з обробні реєструються окремо через add_shortcode ().
повертає
Рядок. Текст, в якому шоткоди оброблені (змінені на висновок прикріплених до них функцій).
Використання
$ Content (рядок) (обов'язковий) Текст в якому потрібно перетворити шорткоди.
За замовчуванням: немає $ ignore_html (рядок) Ігнорувати чи шорткоди всередині HTML. Якщо поставити true, то шорткоди всередині HTML оброблені не будуть.
За замовчуванням: false
# 1. Обробить всі шорткоди в тексті
З файлу shortcodes.php. Прикріплює функцію do_shortcode () до фільтра the_content. який спрацьовує при виведенні контенту поста:
# 2. Обробка окремого шорткода
Використання шоткода в PHP файлі, за межами контенту, коли потрібно отримати висновок шоткода окремо.
Цей приклад показує як обробити шорткод з коду PHP. Наприклад, якщо потрібно вивести шорткод в десь довільному місці шаблону.
або такий приклад:
# 3. Хто відкриває і закриває шорткод
Використання шоткода в PHP файлі, за межами контенту. Для відкривають і закривають шорткодов: