> WordPress开发手册 > dynamic_sidebar

dynamic_sidebar


主题编写的时候,为了能将整个页面框架撑起,很多主题作者会喜欢将设定好的小工具位置加上一些默认的东西,诸如登陆、标签云、统计等等,今天主要用代码解析一下这部分功能实现的方法。

本篇主要讲解一些浅显易懂的东西,所以高手可以绕道了…..

dynamic_sidebar函数

dynamic_sidebar 函数是实现该功能的主要函数,很不幸这个函数依然没有中文版的文档,所以大家又要忍受我的英文翻译,哈哈。
描述:这个函数是用来检测,当前的小工具区有没有被设定。返回“真、假”的布尔值。
用法:

//检测sidebar-1有没有被设定小工具
 dynamic_sidebar( 'sidebar-1' )

实例

本部分实例源自于官方 Twenty Eleven 主题

<div id="secondary" class="widget-area" role="complementary">
	<?PHP 
		//检测sidebar-1有没有被设定小工具  
		if ( ! dynamic_sidebar( 'sidebar-1' ) ) : //如果没有,执行以下部分代码?> 
		<aside id="archives" class="widget">
			<h3 class="widget-title">
			<?php _e( 'Archives', 'twentyeleven' ); ?></h3>
			<ul>				
			<?php wp_get_archives( array( 'type' => 'monthly' ) ); ?>
			</ul>
		</aside>
		<aside id="meta" class="widget">
			<h3 class="widget-title"><?php _e( 'Meta', 'twentyeleven' ); ?></h3>
			<ul><?php wp_register(); ?><li><?php wp_loginout(); ?></li><?php wp_meta(); ?></ul>
		</aside>
 	<?php endif; // end if ( ! dynamic_sidebar( 'sidebar-1' ) )  ?>
</div><!-- #secondary  -->

下一篇: