WordPress函数文档dynamic_sidebar()
发布于
by
调用并显示自定义sidebar侧边栏 描述 This function calls each of the a…
调用并显示自定义sidebar侧边栏
描述
This function calls each of the active widget callbacks in order, which prints the markup for the sidebar. If you have more than one sidebar, you should give this function the name or number of the sidebar you want to print. This function returns true on success and false on failure.
The return value should be used to determine whether to display a static sidebar. This ensures that your theme will look good even when the Widgets plug-in is not active.
If your sidebars were registered by number, they should be retrieved by number. If they had names when you registered them, use their names to retrieve them.
用法
<?php dynamic_sidebar( $index ); ?>
参数
index
(integer/string) (可选) Name or ID of dynamic sidebar.
默认值: 1
示例
Here is the recommended use of this function:
|
1
2
3
4
5
6
7
8
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
<?php if ( is_active_sidebar( ‘left-sidebar’ ) ) : ?>
<ul id=“sidebar”>
<?php dynamic_sidebar( ‘left-sidebar’ ); ?>
</ul>
<?php endif; ?>
|
|
1
2
3
4
5
6
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
<ul id=“sidebar”>
<?php dynamic_sidebar( ‘right-sidebar’ ); ?>
</ul>
|
|
1
2
3
4
5
6
7
8
9
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
<ul id=“sidebar”>
<?php if ( ! dynamic_sidebar() ) : ?>
<li>{static sidebar item 1}</li>
<li>{static sidebar item 2}</li>
<?php endif; ?>
</ul>
|
in the “Twenty Ten” theme (3.0+)
-
wp-content/themes/twentyten/sidebar.php -
wp-content/themes/twentyten/sidebar-footer.php
源文件
dynamic_sidebar() 函数的代码位于 wp-includes/widgets.php.
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
/**
* Display dynamic sidebar.
*
* By default this displays the default sidebar or ‘sidebar-1’. If your theme specifies the ‘id’ or
* ‘name’ parameter for its registered sidebars you can pass an id or name as the $index parameter.
* Otherwise, you can pass in a numerical index to display the sidebar at that index.
*
* @since 2.2.0
*
* @global array $wp_registered_sidebars
* @global array $wp_registered_widgets
*
* @param int|string $index Optional, default is 1. Index, name or ID of dynamic sidebar.
* @return bool True, if widget sidebar was found and called. False if not found or not called.
*/
function dynamic_sidebar($index = 1) {
global $wp_registered_sidebars, $wp_registered_widgets;
if ( is_int($index) ) {
$index = “sidebar-$index”;
} else {
$index = sanitize_title($index);
foreach ( (array) $wp_registered_sidebars as $key => $value ) {
if ( sanitize_title($value[‘name’]) == $index ) {
$index = $key;
break;
}
}
}
$sidebars_widgets = wp_get_sidebars_widgets();
if ( empty( $wp_registered_sidebars[ $index ] ) || empty( $sidebars_widgets[ $index ] ) || ! is_array( $sidebars_widgets[ $index ] ) ) {
/** This action is documented in wp-includes/widgets.php */
do_action( ‘dynamic_sidebar_before’, $index, false );
/** This action is documented in wp-includes/widgets.php */
do_action( ‘dynamic_sidebar_after’, $index, false );
/** This filter is documented in wp-includes/widgets.php */
return apply_filters( ‘dynamic_sidebar_has_widgets’, false, $index );
}
/**
* Fires before widgets are rendered in a dynamic sidebar.
*
* Note: The action also fires for empty sidebars, and on both the front-end
* and back-end, including the Inactive Widgets sidebar on the Widgets screen.
*
* @since 3.9.0
*
* @param int|string $index Index, name, or ID of the dynamic sidebar.
* @param bool $has_widgets Whether the sidebar is populated with widgets.
* Default true.
*/
do_action( ‘dynamic_sidebar_before’, $index, true );
$sidebar = $wp_registered_sidebars[$index];
$did_one = false;
foreach ( (array) $sidebars_widgets[$index] as $id ) {
if ( !isset($wp_registered_widgets[$id]) ) continue;
$params = array_merge(
array( array_merge( $sidebar, array(‘widget_id’ => $id, ‘widget_name’ => $wp_registered_widgets[$id][‘name’]) ) ),
(array) $wp_registered_widgets[$id][‘params’]
);
// Substitute HTML id and class attributes into before_widget
$classname_ = ”;
foreach ( (array) $wp_registered_widgets[$id][‘classname’] as $cn ) {
if ( is_string($cn) )
$classname_ .= ‘_’ . $cn;
elseif ( is_object($cn) )
$classname_ .= ‘_’ . get_class($cn);
}
$classname_ = ltrim($classname_, ‘_’);
$params[0][‘before_widget’] = sprintf($params[0][‘before_widget’], $id, $classname_);
/**
* Filter the parameters passed to a widget’s display callback.
*
* Note: The filter is evaluated on both the front-end and back-end,
* including for the Inactive Widgets sidebar on the Widgets screen.
*
* @since 2.5.0
*
* @see register_sidebar()
*
* @param array $params {
* @type array $args {
* An array of widget display arguments.
*
* @type string $name Name of the sidebar the widget is assigned to.
* @type string $id ID of the sidebar the widget is assigned to.
* @type string $description The sidebar description.
* @type string $class CSS class applied to the sidebar container.
* @type string $before_widget HTML markup to prepend to each widget in the sidebar.
* @type string $after_widget HTML markup to append to each widget in the sidebar.
* @type string $before_title HTML markup to prepend to the widget title when displayed.
* @type string $after_title HTML markup to append to the widget title when displayed.
* @type string $widget_id ID of the widget.
* @type string $widget_name Name of the widget.
* }
* @type array $widget_args {
* An array of multi-widget arguments.
*
* @type int $number Number increment used for multiples of the same widget.
* }
* }
*/
$params = apply_filters( ‘dynamic_sidebar_params’, $params );
$callback = $wp_registered_widgets[$id][‘callback’];
/**
* Fires before a widget’s display callback is called.
*
* Note: The action fires on both the front-end and back-end, including
* for widgets in the Inactive Widgets sidebar on the Widgets screen.
*
* The action is not fired for empty sidebars.
*
* @since 3.0.0
*
* @param array $widget_id {
* An associative array of widget arguments.
*
* @type string $name Name of the widget.
* @type string $id Widget ID.
* @type array|callback $callback When the hook is fired on the front-end, $callback is an array
* containing the widget object. Fired on the back-end, $callback
* is ‘wp_widget_control’, see $_callback.
* @type array $params An associative array of multi-widget arguments.
* @type string $classname CSS class applied to the widget container.
* @type string $description The widget description.
* @type array $_callback When the hook is fired on the back-end, $_callback is populated
* with an array containing the widget object, see $callback.
* }
*/
do_action( ‘dynamic_sidebar’, $wp_registered_widgets[ $id ] );
if ( is_callable($callback) ) {
call_user_func_array($callback, $params);
$did_one = true;
}
}
/**
* Fires after widgets are rendered in a dynamic sidebar.
*
* Note: The action also fires for empty sidebars, and on both the front-end
* and back-end, including the Inactive Widgets sidebar on the Widgets screen.
*
* @since 3.9.0
*
* @param int|string $index Index, name, or ID of the dynamic sidebar.
* @param bool $has_widgets Whether the sidebar is populated with widgets.
* Default true.
*/
do_action( ‘dynamic_sidebar_after’, $index, true );
/**
* Filter whether a sidebar has widgets.
*
* Note: The filter is also evaluated for empty sidebars, and on both the front-end
* and back-end, including the Inactive Widgets sidebar on the Widgets screen.
*
* @since 3.9.0
*
* @param bool $did_one Whether at least one widget was rendered in the sidebar.
* Default false.
* @param int|string $index Index, name, or ID of the dynamic sidebar.
*/
return apply_filters( ‘dynamic_sidebar_has_widgets’, $did_one, $index );
}
|
相关
Sidebars:
is_active_sidebar(),
is_dynamic_sidebar(),
dynamic_sidebar(),
register_sidebars(),
register_sidebar(),
unregister_sidebar(),
wp_register_sidebar_widget(),
wp_unregister_sidebar_widget(),
wp_get_sidebars_widgets(),
wp_set_sidebars_widgets()
- 原文：http://codex.wordpress.org/Function_Reference/dynamic_sidebar
类别：WordPress函数文档、
本文收集自互联网，转载请注明来源。
如有侵权，请联系 wper_net@163.com 删除。
猜你喜欢GUESS YOU LIKE
评论功能已经关闭!