讓主題支持小工具
WordPress 的小工具（widget）是一大特色，它讓用戶自由拖動(dòng)組合內(nèi)容，而且任何插件和主題都可以添加一個(gè)額外的小工具，增加擴(kuò)展性。

默認(rèn)情況下，一個(gè)主題并不會(huì)支持小工具，需要主題開發(fā)者啟用小工具功能并把小工具在相應(yīng)的前臺(tái)位置調(diào)用出來，這樣用戶才能在后臺(tái)直接拖動(dòng)生成側(cè)邊欄。

本文就來教你如何激活小工具功能，并且添加一個(gè)側(cè)邊欄，最后在前臺(tái)顯示出來。

注冊側(cè)邊欄

默認(rèn)的，后臺(tái)外觀下是沒有 “小工具” 這個(gè)菜單按鈕的，如果想要讓他出現(xiàn)，就至少需要注冊一個(gè)側(cè)邊欄，否則即使顯示出來，也沒有用。

注冊一個(gè)側(cè)邊欄需要使用 register_sidebar() 函數(shù)，用法比較簡單，只有一個(gè)屬性，填上需要的信息就行了。

register_sidebar( array(
 'name' => __( '默認(rèn)側(cè)邊欄', 'Bing' ),//側(cè)邊的名字
 'id' => 'widget_default',//側(cè)邊欄的 ID，注冊多個(gè)側(cè)邊欄的時(shí)候不要重復(fù)
 'description' => __( '側(cè)邊欄的描述', 'Bing' ),//側(cè)邊欄的描述，會(huì)在后臺(tái)顯示
 'before_widget' => '<div class="widget %2$s">',//側(cè)邊欄里的小工具的開頭代碼，可以在里邊使用 %2$s 來調(diào)用小工具的 ID，實(shí)現(xiàn)給每個(gè)小工具添加不同的樣式
 'after_widget' => '</div>',//側(cè)邊欄里的小工具的結(jié)尾代碼
 'before_title' => '<h3 class="widget-title">',//側(cè)邊欄里的小工具的標(biāo)題的開頭代碼
 'after_title' => '</h3>'//側(cè)邊欄里的小工具的標(biāo)題的結(jié)尾代碼
) );

運(yùn)用上邊的例子代碼，就能創(chuàng)建出一個(gè)側(cè)邊欄，外觀下也顯示 “小工具” 按鈕了。

在這個(gè)側(cè)邊欄里，用戶就可以自由的添加小工具了。復(fù)制代碼，還可以創(chuàng)建更多的側(cè)邊欄。

調(diào)用側(cè)邊欄

光注冊是沒有意義的，用戶添加之后，還要把小工具顯示在前臺(tái)才可以，這就用到了 dynamic_sidebar() 函數(shù)。

一般情況下，我們需要先判斷一下小工具區(qū)域內(nèi)是否添加了小工具，如果添加了，則顯示小工具，否則提示用戶添加小工具。判斷側(cè)邊欄里是否被添加了小工具需要使用 is_active_sidebar() 函數(shù)。

<?php
if( is_active_sidebar( 'widget_default' ) ){
 echo '<aside id="sidebar">';
  dynamic_sidebar( 'widget_default' );
 echo '</aside>';
}else{
 echo '<p>請?jiān)O(shè)置小工具</p>';
}
?>

非常簡單吧，調(diào)用好后，前臺(tái)的小工具就會(huì)按照注冊時(shí)給出的格式一個(gè)一個(gè)的輸出了。

添加插件啟用函數(shù)
register_activation_hook() 可以讓你添加一個(gè)函數(shù)，這個(gè)函數(shù)會(huì)在指定插件啟用時(shí)執(zhí)行，一般用于插件開發(fā)。

用法

register_activation_hook( $file, $function );

參數(shù)

$file

（字符串）（必須）需要在啟用時(shí)執(zhí)行函數(shù)的插件的主文件路徑，如果是當(dāng)前插件，直接寫 __FILE__ 即可。

$function

（回調(diào)函數(shù)）（必須）執(zhí)行的函數(shù)。

例子

function Bing_myplugin_activate(){
 global $wpdb;
 $wpdb->query( '' );//創(chuàng)建一些數(shù)據(jù)表
}
register_activation_hook( __FILE__, 'Bing_myplugin_activate' );

其它

此函數(shù)位于：wp-includes/plugin.php

最新評論