Hi!请登陆

如何给WordPress的文章添加自定义文章状态

2021-1-18 58 1/18

首先,我们来了解一下什么是文章状态,以及默认有哪些文章状态。在文章发布界面,我们可以看到有一个发布模块,该模块中有一个状态设置选项。其中 WordPress 默认内置了的文章状态有:

  • 草稿 – 已保存但尚未完成且尚未发布的文章
  • 自动草稿 – WordPress 具有自动保存功能,可自动将草稿保存为修订版
  • 待审核 – 已完成并提交审核但尚未发布的文章
  • 未来 – 计划稍后定时发布的文章,也就是通过上图设置发布时间为未来某个时间点即可
  • 私密 – 标记为私密的文章,只有自己登录后可见
  • 回收 – 被添加到回收站的文章
  • 继承 – 自动继承其父页面状态的子页面

当然,除了这些默认的文章状态以外,我们还可以添加自定义的文章状态,具体代码示例如下:

  1. // 注册新的文章状态
  2. function wpdx_add_custom_post_status(){
  3.     register_post_status('rejected', array(
  4.         'label'                     => _x( 'Rejected', 'post' ),
  5.         'public'                    => false,
  6.         'exclude_from_search'       => false,
  7.         'show_in_admin_all_list'    => true,
  8.         'show_in_admin_status_list' => true,
  9.         'label_count'               => _n_noop( 'Rejected <span class="count">(%s)</span>', 'Rejected <span class="count">(%s)</span>' ),
  10.     ) );
  11. }
  12. add_action( 'init', 'wpdx_add_custom_post_status' );
  13. // 通过 js 添加新的状态到文章编辑页面
  14. function wpdx_add_post_status_list(){
  15.     global $post;
  16.     $complete = '';
  17.     $label = '';
  18.     if($post->post_type == 'post'){  //只对默认的 post 类型添加
  19.         if($post->post_status == 'rejected'){
  20.             $complete = ' selected="selected"';
  21.             $label = '<span id="post-status-display"> Rejected</span>';
  22.         }
  23.         echo '
  24.         <script>
  25.         jQuery(document).ready(function($){
  26.             $("select#post_status").append("<option value=\"rejected\" '.$complete.'>Rejected</option>");
  27.             $(".misc-pub-section label").append("'.$label.'");
  28.         });
  29.         </script>
  30.         ';
  31.     }
  32. }
  33. add_action('admin_footer-post.php', 'wpdx_add_post_status_list');
  34. add_action('admin_footer-post-new.php', 'wpdx_add_post_status_list');
  35. // 通过 js 添加新的状态到文章列表的快速编辑
  36. function wpdx_add_custom_status_in_quick_edit() {
  37.         echo "<script>
  38.         jQuery(document).ready( function($) {
  39.             $( 'select[name=\"_status\"]' ).append( '<option value=\"rejected\">Rejected</option>' );      
  40.         }); 
  41.         </script>";
  42.     }
  43. add_action('admin_footer-edit.php','wpdx_add_custom_status_in_quick_edit');

上面的代码示例注册了新的文章状态:Rejected,请根据你的实际需要,修改代码中高亮显示的行中的大小写的 Rejected,才能完全设置为你自己的文章状态!

由于 WordPress 自身存在一个 bug:新注册的文章状态不会自动添加到设置选择中,所有上面就只能通过 js 方式添加选择,这个 bug 已经提交了好几年了,不清楚为什么 WordPress 官方一直没有修复。

比如我将上述代码的 Rejected 改为投稿,那么在文章发布模块的状态设置中就会多出一种“投稿”的文章状态选择,具体最终的效果如下图所示:

如何给WordPress的文章添加自定义文章状态

如何给WordPress的文章添加自定义文章状态

如果你希望文章状态更变了以后做一些操作,比如发送邮件通知等,可以看看插件 Post Status Notifier  和  Post Status Notifications,还有一个不错的  Edit Flow

延伸阅读:

  • https://developer.wordpress.org/reference/functions/register_post_status/
  • https://codex.wordpress.org/Plugin_API/Action_Reference/admin_footer-(hookname)

相关推荐