快捷導(dǎo)航

詳解WordPress開(kāi)發(fā)中g(shù)et_current_screen()函數(shù)的使用

更新時(shí)間：2016年01月11日 16:23:54 作者：稍息少年

這篇文章主要介紹了WordPress開(kāi)發(fā)中g(shù)et_current_screen()函數(shù)的使用,get_current_screen()通常在對(duì)象的實(shí)例化時(shí)使用,需要的朋友可以參考下

get_current_screen() 函數(shù)是一個(gè)我們很少用到，但卻超級(jí)實(shí)用的一個(gè)函數(shù)，如果你正著手于制作一個(gè)主題，卻不知道文檔應(yīng)該放在哪里的話，那你應(yīng)該看一下這個(gè)從 WordPress 3.0 才開(kāi)始有的函數(shù)，該函數(shù)允許我們獲得一個(gè) WP_Screen 對(duì)象，并使用該對(duì)象的成員方法在后臺(tái)里面加掛我們自定義的一個(gè)幫助菜單(該功能在，3.3版后得到完善)。

如果你不喜歡將 WordPress 研究的太透徹的話，那你現(xiàn)在就可以拿著醬油瓶，向前打醬油去了。

引言
首先，get_current_screen() 很簡(jiǎn)單，只是返回一個(gè)對(duì)象，所以本文主要講述，獲得對(duì)象后的操作。

描述

//使用起來(lái)很簡(jiǎn)單
$screen = get_current_screen();
// 此時(shí) $screen 為實(shí)例化的對(duì)象

應(yīng)用實(shí)例
我們來(lái)一個(gè)簡(jiǎn)單的例子，過(guò)程代碼雖然可以顯示但可能在時(shí)機(jī)應(yīng)用中沒(méi)有任何意義，只為舉例。
雖然已經(jīng)極具精簡(jiǎn)，但是還是很繞，噶的保佑您能看懂。

 function xz_theme_options_add_page() {
 $theme_page = add_theme_page(
//如果成功，則返回hook標(biāo)簽，否則返回假到變量$theme_page。
  '主題設(shè)置',//頁(yè)面Titlee
  '主題設(shè)置',// 在后臺(tái)菜單中顯示的名字
  'edit_theme_options',// 選項(xiàng)放置的位置
  'theme_options', // 別名,也就是get傳送的參數(shù)
  'xz_theme_op_page' //顯示內(nèi)容調(diào)用的函數(shù)
 );
 if ( ! $theme_page )
 return;//建立失敗則跳出函數(shù)
 add_action( "load-$theme_page", 'xz_help' );//在主題設(shè)置中掛幫助菜單
}
add_action( 'admin_menu', 'xz_theme_options_add_page' );
//在后臺(tái)菜單加載時(shí)，加載xz_theme_options_add_page函數(shù)
 
function xz_theme_op_page (){//編輯頁(yè)面顯示函數(shù)
 echo "我是主題編輯頁(yè)面";
}
 
function xz_help (){
 $help = '這里是幫助中間位置顯示的內(nèi)容
  <ol><li>A</li><li>B</li>
  <li>C</li><li>D</li></ol>';
 
 $sidebar = '這里是幫助右邊欄顯示的位置';
 
 $screen = get_current_screen();//第一主角，獲得對(duì)象
 $screen->add_help_tab( array(//用成員方法注冊(cè)幫助Tab
  'title' => '翔子主題幫助',//左邊欄標(biāo)簽的名字
  'id' => 'theme-options-help',//不解釋
  'content' => $help,//設(shè)定標(biāo)簽對(duì)應(yīng)的內(nèi)容
  )
 );
 $screen->set_help_sidebar( $sidebar );//方法只能使用一次，以最后一次調(diào)用為準(zhǔn)。
}

效果
如果不出意外的話，經(jīng)上面的折騰，你得主題就有了初步的幫助界面了。
點(diǎn)擊下圖的位置

2016111162240789.jpg (286×152)

自定義幫助按鈕位置

點(diǎn)擊后如下圖

2016111162325157.jpg (1024×209)

自定義幫助

總結(jié)
set_help_sidebar( )//方法只能使用一次，以最后一次調(diào)用為準(zhǔn)。這里你可以添加一些你得api地址之類(lèi)的或廣告之類(lèi)的東西。
add_help_tab() 方法可以多次使用，每使用一次標(biāo)簽會(huì)多一個(gè)，當(dāng)然你還要設(shè)置對(duì)應(yīng)的$help值。

您可能感興趣的文章: