首页 历史文章 WordPress插件开发之Action Reference

WordPress插件开发之Action Reference

时间:2020-05-11 来源:网络 浏览:183

进行WordPress开发的前提条件是了解WordPress的各种API,其中WordPress最重要的两种接口是ActionFilter。而这其中,action多为将我们自定义的函数插入WordPress内核当中,让函数穿插在WordPress之中完成运行,而Filter则是在函数运算完成后修改删除或过滤结果,对运算结果再进行处理。

本文将就其中之一Action进行讲解,以便大家掌握WordPress的基本开发方法。

Action即动作,WordPress作为开放性和拓展性最强的Blog/CMS程序,在其自身执行过程中会额外执行由插件插入的函数,以实现插件的目的,这个允许插件开发者自定义在某点执行函数的接口即Action。当一个用户访问WordPress任意页面后,WordPress将按顺序执行每一行代码,并在一定条件下激发Action,执行挂在该Action上的函数。

简单范例

当访客访问https://www.2wp.com.cn/后,执行的是index.php,即WordPress的入口程序。index.php先后载入一些基本参数(如数据库信息、默认语言),进行一些必要的检查(如WordPress是否已经安装),然后载入我们的插件,当然,前提是这个插件已经启用。在插件中,我们输入以下代码:

add_action('wp_head','print_my_feed');
function print_my_feed(){
 //do something
 echo '<link rel="alternate" type="application/rss+xml"
          title="2WP" href="https://www.2wp.com.cn" />';
}

在这里,print_my_feed函数执行的是输出WPCEO的Feed链接。如果用户使用了Firefox浏览器或新版的IE,在地址栏附近应该能看到一个醒目的订阅图标,提现用户可以订阅该网站。

WordPress常用Action接口

以下是一个普通前台页面的Action执行过程。

  1. muplugins_loaded
  2. plugins_loaded
  3. load_textdomain
  4. set_current_user
  5. init
  6. wp_loaded
  7. parse_request
  8. send_headers
  9. parse_query
  10. pre_get_posts
  11. posts_selection
  12. wp
  13. template_redirect
  14. get_header
  15. wp_head
  16. wp_enqueue_scripts
  17. wp_print_styles
  18. wp_print_scripts
  19. loop_start
  20. the_post
  21. loop_end
  22. get_sidebar
  23. dynamic_sidebar
  24. wp_meta
  25. get_footer
  26. wp_footer
  27. shutdown

对于我们的插件来说,什么时候执行这个动作尤为重要。例如一个需要发送Cookie的函数,它应当在template_redirect之前完成输出Cookie的行为(否则可能会引起PHP错误);一个需要改变默认获取Post文章的Hook,就应当在pre_get_posts这个Action上做出修改;如果我们需要在HTML代码中自行加入样式表,就需要在wp_head这个Action中添加。

除了前台,后台开发也是WordPress插件开发的重点,以下是后台管理界面的普通执行流程。

  1. muplugins_loaded
  2. plugins_loaded
  3. load_textdomain
  4. auth_cookie_valid
  5. set_current_user
  6. init
  7. wp_loaded
  8. auth_redirect
  9. admin_menu
  10. admin_init
  11. parse_request
  12. send_headers
  13. wp
  14. admin_head
  15. adminmenu
  16. admin_notices
  17. admin_footer
  18. shutdown

相比于前台,后台的运行流程中有一些后台独有的Action,如auth_redirect,重定向未登录用户到登录界面;admin_menu是初始化WordPress后台的管理菜单。

Action接口函数解析

在之前我们已经学习了add_action这个函数的基本使用方法,现在来介绍一下它的具体使用方法和其他Action函数的使用方法。

add_action('action_name','my_function_name',$priority=10,$accepted_args=1);

 

前两个参数即要插入的Action和需要插入的函数,$priority为载入顺序,例如同样是wp_head这个Action,可能有数个插件都需要在这里加载自己的CSS或JavaScript文件,WordPress载入时会按照从小到大的顺序载入。同一个Action下,$priority越小越早执行。$accepted_args 为接受的参数,默认为一个,如果某Action提供了多个参数,则需要修改这个数值。

remove_action('action_name','my_function_name',$priority=10,$accepted_args=1);

 

有添加就需要有删除,remove_action就是删除挂载在Action上的函数。

do_action('action_name', $arg );

 

执行Action,除了系统会执行固定的Action,我们在插件中也能创建自己的Action。$arg为传入的参数,这里的参数可以为数个。

小结

本文比较具体地描述了WordPress Action的使用方法,也欢迎大家继续关注爱WP的后续文章。。

标题:WordPress插件开发之Action Reference
链接:https://www.bigetheme.cn/35.html
版权:文章转载自网络,如有侵权,请联系删除!