首頁 >後端開發 >php教程 >WordPress中用於建立以及取得側邊欄的PHP函數講解

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

WBOY
WBOY原創
2016-07-29 09:08:22967瀏覽

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教程有興趣的朋友有所幫助。

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn