WordPress中用於建立以及取得側邊欄的PHP函數講解-php教程-PHP中文網

WordPress中用於建立以及取得側邊欄的PHP函數講解

WBOY

發布： 2016-07-29 09:08:22

原創

949 人瀏覽過

register_sidebar()（建立側邊欄）
建立一個側邊欄，用來放置小工具。這個函數使用的時候請放在一個函數裡，掛載到 “widgets_init” 鉤子。

用法

register_sidebar( $args );

登入後複製

參數

$args

（字串 | 陣列）（可選）要建立的側邊欄的參數。

預設值：

$args = array(
  'name'     => __( 'Sidebar name', 'theme_text_domain' ),
  'id'      => 'unique-sidebar-id',
  'description'  => '',
  'class'     => '',
  'before_widget' => '<li>',
  'after_widget' => '</li>',
  'before_title' => '<h2>',
  'after_title'  => '</h2>'
);

登入後複製

數組參數介紹：

name：側邊欄名稱
id：側邊欄ID，必須為小寫，預設為遞增的陣列ID
id：側邊欄ID，必須為小寫，預設為遞增的陣列ID
class：給其中的小工具的額外class
before_widget：裡邊的小工具的開頭Html 程式碼
after_widget：裡邊的小工具的結尾的Html 程式碼
before_title：裡邊的小工具的結尾的Html 程式碼
before_title：裡邊的小工具的標題程式碼

after_title：裡邊的小工具的標題的末尾的Html 程式碼

範例

register_sidebar( array(
  'name'     => __( '右边的侧边栏' ),
  'id'      => 'sidebar-1',
  'description' => __( '右侧边栏的小工具。' ),
  'before_title' => '<h3>',
  'after_title' => '</h3>',
));

登入後複製

其它

該函數位於：wp-includes/widggetets/wi列邊欄(

get_sidebar() 用來引入側邊欄模板。如果指定名稱則引入當前主題根目錄的sidebar-{name}.php 文件，不指定則引入當前主題根目錄的sidebar.php 文件，如果文件不存在則引入wp-includes/theme-compat/sidebar.php文件。

用法

get_sidebar( $name );

登入後複製

參數

$name

（字串）（可選）引入模板的名稱，如果指定則引入當前主題根目錄的 sidebar-{$name}.php 檔案。

預設值：None

範例

下邊的程式碼將引入目前主題根目錄的sidebar.php 檔案：

<&#63;php get_sidebar(); &#63;>

登入後複製

下邊的程式碼將引入目前主題根目錄的sidebar-left.php

<&#63;php get_sidebar( 'left' ); &#63;>

登入後複製

下邊的例子分別引入了左側邊欄（sidebar-left.php）和右側邊欄（sidebar-right.php）：

<?php get_header(); ?>
<&#63;php get_sidebar( 'left' ); &#63;>

登入後複製

內容內容

<&#63;php get_sidebar( 'right' ); &#63;>
<&#63;php get_footer(); &#63;>

登入後複製

：wp-includes/general-template.php

以上就介紹了WordPress中用於創建以及獲取側邊欄的PHP函數講解，包括了方面的內容，希望對PHP教程有興趣的朋友有所幫助。