wpscholar/wp-post-status

这是一个库,用于更好地将自定义文章状态与WordPress的用户界面集成。

1.0 2017-11-30 21:33 UTC

This package is auto-updated.

Last update: 2024-08-28 23:12:40 UTC


README

这是一个库,用于更好地将自定义文章状态与WordPress的用户界面集成。

入门

大部分情况下,使用与直接在WordPress中调用register_post_status()相同的参数

<?php 

add_action( 'init', function () {

	\wpscholar\WordPress\PostStatus::register( 'archive', [
		'label'                     => esc_html_x( 'Archive', 'post status', 'text-domain' ),
		'labels'                    => [
			'post_state'    => esc_html_x( 'Archived', 'post status state', 'text-domain' ),
		],
		'label_count'               => _n_noop( 'Archived <span class="count">(%s)</span>', 'Archived <span class="count">(%s)</span>', 'text-domain' ),
		'post_types'                => [ 'post' ],
		'public'                    => true,
		'show_in_admin_all_list'    => true,
		'show_in_admin_status_list' => true,
	] );

} );

只需确保将text-domain替换为您的实际插件(或主题)的文本域。

自定义参数

以下为自定义参数

  • labels - 在文章列表页显示状态时,使用post_state标签。
  • post_types - 如果未定义一个或多个文章类型,则无法通过UI分配新状态。

注册自定义文章状态时,可以分配任何想要的参数。然后,在调用get_post_stati()时可以按这些参数进行筛选。

获取自定义标签

可以按照以下方式获取自定义标签

<?php

// Label returned will be 'Archived' (given registration code from previous example)
$label = \wpscholar\WordPress\PostStatus::getLabel('archive', 'post_state');

如果请求的标签不存在,则回退到文章状态对象的label主属性。