Виводить на екран першу активну панель віджетів (сайдбар - панель в якій є хоча б один віджет). Можна вказати ID або номер панелі, яку саме виводити, якщо на сайті більше однієї панелі віджетів.
dynamic_sidebar () повертає true або false, з повертається результатом, також виводить на екран панель віджетів. Значення, що повертається можна використовувати, наприклад, щоб визначити чи потрібно обробляти код замінює віджети, коли в панелі немає віджетів (див. Приклад # 1).
Якщо при реєстрації панелі віджетів за допомогою функції register_sidebar (). як аргумент id ви використовували число, то в dynamic_sidebar () вказуйте це число. Якщо ви використовували назву (рядок), то вказуйте його. Детальніше дивіться нижче, в пункті Множинні сайдбарі.
Хукі з функції:
повертає
true, якщо панель з віджетами була знайдена. false, якщо панелі немає, або в ній немає віджетів.
Використання
$ Index (рядок / число) Ідентифікатор панелі, вказаний в параметрі id функції register_sidebar (), при реєстрації панелі. Якщо вказано число, то буде шукатися панель з ID sidebar- $ index.
За замовчуванням: 1 (sidebar-1)
# 1 Виводимо сайдбар, якщо він є.
Цей приклад показує як вивести перший не порожній сайдбар (при реєстрації id сайдара не було зазначено) або якщо він не знайдений обробити вказаний код:
# 2 Виводимо потрібний сайдбар.
# 3 Перевіряємо наявність панелі і виводимо її
У прикладі 2 ми не перевіряли наявність панелі і віджетів в ній. У цьому прикладі ми перевіримо наявність панелі, щоб не виводити зайві HTML теги (