当前位置: 首页 > 编程笔记 >

详解WordPress开发中get_current_screen()函数的使用

陈项禹
2023-03-14
本文向大家介绍详解WordPress开发中get_current_screen()函数的使用,包括了详解WordPress开发中get_current_screen()函数的使用的使用技巧和注意事项,需要的朋友参考一下

get_current_screen() 函数是一个我们很少用到,但却超级实用的一个函数,如果你正着手于制作一个主题,却不知道文档应该放在哪里的话,那你应该看一下这个从 WordPress 3.0 才开始有的函数,该函数允许我们获得一个 WP_Screen 对象,并使用该对象的成员方法在后台里面加挂我们自定义的一个帮助菜单(该功能在,3.3版后得到完善)。

如果你不喜欢将 WordPress 研究的太透彻的话,那你现在就可以拿着酱油瓶,向前打酱油去了。

引言
首先,get_current_screen() 很简单,只是返回一个对象,所以本文主要讲述,获得对象后的操作。

描述

//使用起来很简单
$screen = get_current_screen();
// 此时 $screen 为实例化的对象

应用实例
我们来一个简单的例子,过程代码虽然可以显示但可能在时机应用中没有任何意义,只为举例。
虽然已经极具精简,但是还是很绕,噶的保佑您能看懂。

 function xz_theme_options_add_page() {
 $theme_page = add_theme_page(
//如果成功,则返回hook标签,否则返回假到变量$theme_page。
  '主题设置',//页面Titlee
  '主题设置',// 在后台菜单中显示的名字
  'edit_theme_options',// 选项放置的位置
  'theme_options', // 别名,也就是get传送的参数
  'xz_theme_op_page' //显示内容调用的函数
 );
 if ( ! $theme_page )
 return;//建立失败则跳出函数
 add_action( "load-$theme_page", 'xz_help' );//在主题设置中挂帮助菜单
}
add_action( 'admin_menu', 'xz_theme_options_add_page' );
//在后台菜单加载时,加载xz_theme_options_add_page函数
 
function xz_theme_op_page (){//编辑页面显示函数
 echo "我是主题编辑页面";
}
 
function xz_help (){
 $help = '这里是帮助中间位置显示的内容
  <ol><li>A</li><li>B</li>
  <li>C</li><li>D</li></ol>';
 
 $sidebar = '这里是帮助右边栏显示的位置';
 
 $screen = get_current_screen();//第一主角,获得对象
 $screen->add_help_tab( array(//用成员方法注册帮助Tab
  'title' => '翔子主题帮助',//左边栏标签的名字
  'id' => 'theme-options-help',//不解释
  'content' => $help,//设定标签对应的内容
  )
 );
 $screen->set_help_sidebar( $sidebar );//方法只能使用一次,以最后一次调用为准。
}

效果
如果不出意外的话,经上面的折腾,你得主题就有了初步的帮助界面了。
点击下图的位置

自定义帮助按钮位置

点击后如下图

自定义帮助

总结
set_help_sidebar( )//方法只能使用一次,以最后一次调用为准。这里你可以添加一些你得api地址之类的或广告之类的东西。
add_help_tab() 方法可以多次使用,每使用一次标签会多一个,当然你还要设置对应的$help值。

 类似资料:
  • 本文向大家介绍详解WordPress开发中get_header()获取头部函数的用法,包括了详解WordPress开发中get_header()获取头部函数的用法的使用技巧和注意事项,需要的朋友参考一下 函数意义详解 从当前主题调用header.php文件。是不是很简单?好吧,如果你是新手的话这里要提醒一下,这里的get和get_children()、get_category中的get略有不同之处

  • 本文向大家介绍详解WordPress中分类函数wp_list_categories的使用,包括了详解WordPress中分类函数wp_list_categories的使用的使用技巧和注意事项,需要的朋友参考一下 wp_list_categories 函数是 WordPress 中用来罗列系统中分类的函数,该函数拥有许多控制输出的参数,今天突然被一个朋友问到,所以就大概整理了一下。 因为 WordP

  • 本文向大家介绍简单了解WordPress开发中update_option()函数的用法,包括了简单了解WordPress开发中update_option()函数的用法的使用技巧和注意事项,需要的朋友参考一下 函数介绍 update_option()用于更新数据表中存在的选项值。该函数可取代add_option,但不及add_option灵活。update_option会检查并判断选项是否已经存在。

  • 本文向大家介绍详解WordPress开发中用于获取分类及子页面的函数用法,包括了详解WordPress开发中用于获取分类及子页面的函数用法的使用技巧和注意事项,需要的朋友参考一下 get_category get_category 可能我们平时接触的不多,但却是很有用,网上这个函数介绍的貌似不多,所以今天只针对官方 WordPress 英文文档做一下翻译。 函数描述 获得指定分类,以数组或是对象的

  • 本文向大家介绍详解WordPress中用于合成数组的wp_parse_args()函数,包括了详解WordPress中用于合成数组的wp_parse_args()函数的使用技巧和注意事项,需要的朋友参考一下 wp_parse_args() 函数是 WordPress 核心经常用到的函数,它的用途很多,但最主要用来给一个数组参数(args)绑定默认值。 因为 wp_parse_args() 函数返回

  • 本文向大家介绍WordPress开发中用于标题显示的相关函数使用解析,包括了WordPress开发中用于标题显示的相关函数使用解析的使用技巧和注意事项,需要的朋友参考一下 single_cat_title()函数 single_cat_title()函数,日常中我们很少会用到,但这个函数会给我们解决很多问题,诸如当前页面的目录、标签,该函数不依附于 WordPress 主循环中,也不能放入主循环中