WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/dynamic sidebar

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Contents

Описание

Вызывает активные виджеты в том порядке, который настроен для боковой панели. Если у вас несколько боковых панелей, вы должны указать в параметрах название или номер той панели, которую хотите отобразить. Эта функция возвращает true при успехе и false при ошибке.

Возвращаемое значение используется, чтобы определить, следует ли отображать статичную боковую панель. Это гарантирует, что ваша тема будет выглядеть хорошо, даже когда нет активных виджетов.

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

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

 <?php dynamic_sidebar$index ); ?> 

Параметры

index
(integer/string) (optional) Название или номер динамичной боковой панели
Default: 1

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

(boolean) 
True, если виджеты боковой панели найдены и вызваны. False, если виджеты боковой панели не найдены или не вызваны.

Примеры

Рекомендуемое использование этой функции:

<ul id="sidebar">
<?php if ( !dynamic_sidebar() ) : ?>
   <li>{static sidebar item 1}</li>
   <li>{static sidebar item 2}</li>
<?php endif; ?>
</ul>
<ul id="sidebar">
   <?php dynamic_sidebar( 'Right Sidebar' ); ?>
</ul>

В теме "Twenty Ten" (3.0+)

Несколько боковых панелей

You can load a specific sidebar by either their name (if given a string) or ID (if given an integer). For example, dynamic_sidebar('top_menu') will present a sidebar registered with register_sidebar(array('name'=>'top_menu',)).

Using ID's ( dynamic_sidebar(1) ) is easier in that you don't need to name your sidebar, but they are harder to figure out without looking into your functions.php file or in the widgets administration panel and thus make your code less readable. Note that ID's begin at 1.

If you name your own ID values in the register_sidebar() WordPress function, you might increase readability of the code. The ID should be all lowercase alphanumeric characters and not contain white space. You can also use the - and _ characters. IDs must be unique and cannot match a sidebar name. Using your own IDs can also make the sidebar name translatable.

// See the __() WordPress function for valid values for $text_domain.
register_sidebar( array(
    'id'          => 'top-menu',
    'name'        => __( 'Top Menu', $text_domain ),
    'description' => __( 'This sidebar is located above the age logo.', $text_domain ),
) );

This allows the use of dynamic_sidebar( 'top-menu' ) which uses an ID and is readable.

История изменений

С версии: 2.2.0

Исходный файл

dynamic_sidebar() объявляется в wp-includes/widgets.php.

Читайте также

Схожее

Widgets: is_active_widget(), the_widget(), register_widget(), unregister_widget(), wp_register_widget_control(), wp_unregister_widget_control(), wp_convert_widget_settings(), wp_get_widget_defaults(), wp_widget_description()

See also index of Function Reference and index of Template Tags.