WordPress中用於建立以及擷取側邊欄的PHP函數講解,wordpressphp
register_sidebar()(建立側邊欄)
建立一個側邊欄,用來放置小工具。這個函數使用的時候請放在一個函數裡,掛載到 “widgets_init” 鉤子。
用法
register_sidebar( $args );
參數
$args
(字串 | 數組)(可選)要建立的側邊欄的參數。
預設值:
$args = array( 'name' => __( 'Sidebar name', 'theme_text_domain' ), 'id' => 'unique-sidebar-id', 'description' => '', 'class' => '', 'before_widget' => '
', 'after_widget' => '', 'before_title' => '
', 'after_title' => '
');
數組參數介紹:
- name:側邊欄名稱
- id:側邊欄 ID,必須為小寫,預設為遞增的數組 ID
- description:側邊欄描述
- class:給其中的小工具的額外 class
- before_widget:裡邊的小工具的開頭 Html 代碼
- after_widget:裡邊的小工具的末尾的 Html 代碼
- before_title:裡邊的小工具的標題的開頭 Html 代碼
- after_title:裡邊的小工具的標題的末尾的 Html 代碼
例子
register_sidebar( array( 'name' => __( '右邊的側邊欄' ), 'id' => 'sidebar-1', 'description' => __( '右側邊欄的小工具。' ), 'before_title' => '', 'after_title' => '
',));
其它
該函數位於:wp-includes/widgets.php
get_sidebar()(擷取側邊欄)
get_sidebar() 用來引入側邊欄模板。如果指定名稱則引入當前主題根目錄的 sidebar-{name}.php 檔案,不指定則引入當前主題根目錄的 sidebar.php 檔案,如果檔案不存在則引入 wp-includes/theme-compat/sidebar.php 檔案。
用法
get_sidebar( $name );
參數
$name
(字串)(可選)引入模板的名稱,如果指定則引入當前主題根目錄的 sidebar-{$name}.php 檔案。
預設值:None
例子
下邊的代碼將引入當前主題根目錄的 sidebar.php 檔案:
<?php get_sidebar(); ?>
下邊的代碼將引入當前主題根目錄的 sidebar-left.php 檔案:
<?php get_sidebar( 'left' ); ?>
下邊的例子分別引入了左側邊欄(sidebar-left.php)和右側邊欄(sidebar-right.php):
<?php get_header(); ?><?php get_sidebar( 'left' ); ?>
內容內容
<?php get_sidebar( 'right' ); ?><?php get_footer(); ?>
其它
此函數位於:wp-includes/general-template.php
您可能感興趣的文章:
- WordPress中自訂後台管理介面色彩配置的小技巧
- 在WordPress中實現發送http請求的相關函數解析
- 在WordPress的文章編輯器中設定預設內容的方法
- 詳解WordPress中添加和執行動作的函數使用方法
http://www.bkjia.com/PHPjc/1086653.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/1086653.htmlTechArticleWordPress中用於建立以及擷取側邊欄的PHP函數講解,wordpressphp register_sidebar()(建立側邊欄) 建立一個側邊欄,用來放置小工具。這個函數使...