get_post_type_labels

函数
get_post_type_labels ( $post_type_object )
Access
Private
参数
  • (object|WP_Post_Type) $post_type_object Post type object.
    Required:
返回值
  • (object) Object with all the labels as member variables.
定义位置
相关方法
get_post_typesget_post_type_objectget_post_typeget_post_type_capabilitiesget_post_type_archive_link
引入
3.0.0
弃用
-

get_post_type_labels函数是一个WordPress的函数,用于检索一个指定的文章类型的标签: 这个函数把文章类型的名称作为参数,并返回一个标签数组。

从一个文章类型对象中建立一个包含所有文章类型标签的对象。
在文章类型对象中接受标签阵列的键。

– `name`-文章类型的一般名称,通常是复数。相同的,并被
`$post_type_object->label`。默认为”文章”/”页面”。
– `singular_name` – 这个文章类型的一个对象的名称。默认为’文章’/’页面’。
– `add_new` – 分层和非分层类型的默认值都是’添加新的’。
当国际化这个字符串时,请使用一个{@link gettext context}来匹配你的文章类型。
匹配你的文章类型。例如:`_x( ‘Add New’, ‘product’, ‘textdomain’);`.
– `add_new_item` – 添加一个新的单项的标签。默认为’添加新帖’/’添加新页’。
– `edit_item` – 用于编辑一个单一项目的标签。默认为’编辑文章’/’编辑页面’。
– `new_item` – 新项目页面标题的标签。默认为’新文章’/’新页面’。
– `view_item` – 用于查看单一项目的标签。默认为’查看文章’/’查看页面’。
– `view_items` – 查看文章类型存档的标签。默认为’查看文章’/’查看页面’。
– `search_items` – 用于搜索复数项目的标签。默认为”搜索文章”/”搜索页面”。
– `not_found` – 当没有找到项目时使用的标签。默认为”没有找到文章”/”没有找到页面”。
– `not_found_in_trash` – 当回收站中没有项目时使用的标签。缺省是’回收站中没有发现文章’/’回收站中没有发现页面’。
‘回收站中没有发现页面’。
– `parent_item_colon` – 标签,用于分层项目的父级前缀。不用于非层次性的
文章类型。默认为”父页:”。
– `all_items` – 标示子菜单链接中所有项目的标签。默认为”所有文章”/”所有页面”。
– `archives` – 导航菜单中档案的标签。默认为’文章档案’/’页面档案’。
– `attributes` – 属性元框的标签。默认为”文章属性”/”页面属性”。
– `insert_into_item` – 媒体框架按钮的标签。默认为’插入到文章’/’插入到页面’。
– `uploaded_to_this_item` – 媒体框架过滤器的标签。缺省是’上载到这个文章’/’上载到这个页面’。
‘上载到这个页面’。
– `featured_image` – 特色图片元框标题的标签。默认为”特色图片”。
– `set_featured_image` – 用于设置特色图片的标签。默认为”设置特色图片”。
– `remove_featured_image` – 用于移除特色图片的标签。默认值是’移除特色图片’。
– `use_featured_image` – 媒体框架中使用特色图片的标签。默认值是”作为特色图片使用”。
– `menu_name` – 菜单名称的标签。默认与`name’相同。
– `filter_items_list` – 表视图隐藏标题的标签。默认为’过滤文章列表’/’过滤页面列表’。
‘过滤页面列表’.
– `filter_by_date` – 列表表中的日期过滤器的标签。默认为”按日期过滤”。
– `items_list_navigation` – 表格分页的隐藏标题的标签。默认为’文章列表导航’/’页面列表导航’。
‘页面列表导航’。
– `items_list` – 表的隐藏标题的标签。默认为’文章列表’/’页面列表’。
– `item_published` – 当一个项目被发布时使用的标签。默认为’文章发布’。/ ‘页面发布’。
– `item_published_privately` – 当一个项目以私密的方式发布时使用的标签。
默认为’文章已私下发布’。/ ‘页面私下发布’。
– `item_reverted_to_draft` – 当一个项目被转换为草稿时使用的标签。
默认为’文章恢复为草稿’。/ ‘页面恢复为草稿’。
– `item_scheduled` – 当一个项目被计划发布时使用的标签。默认为’文章已安排好’。/
‘页面预定。
– `item_updated` – 当一个项目被更新时使用的标签。缺省是’文章更新’。/ ‘页面更新’。
– `item_link` – 导航链接块变化的标题。默认为’文章链接’/’页面链接’。

– `item_link_description` – 导航链接块的描述。默认为’一个文章的链接’。/
‘一个页面的链接’。

以上,第一个默认值适用于非分层的文章类型(如文章),第二个默认值适用于分层的文章类型(如页面)。

注意:要设置文章类型管理通知中使用的标签,请参阅{@see ‘post_updated_messages’}过滤器。

function get_post_type_labels( $post_type_object ) {
	$nohier_vs_hier_defaults = WP_Post_Type::get_default_labels();

	$nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];

	$labels = _get_custom_object_labels( $post_type_object, $nohier_vs_hier_defaults );

	$post_type = $post_type_object->name;

	$default_labels = clone $labels;

	/**
	 * Filters the labels of a specific post type.
	 *
	 * The dynamic portion of the hook name, `$post_type`, refers to
	 * the post type slug.
	 *
	 * Possible hook names include:
	 *
	 *  - `post_type_labels_post`
	 *  - `post_type_labels_page`
	 *  - `post_type_labels_attachment`
	 *
	 * @since 3.5.0
	 *
	 * @see get_post_type_labels() for the full list of labels.
	 *
	 * @param object $labels Object with labels for the post type as member variables.
	 */
	$labels = apply_filters( "post_type_labels_{$post_type}", $labels );

	// Ensure that the filtered labels contain all required default values.
	$labels = (object) array_merge( (array) $default_labels, (array) $labels );

	return $labels;
}

常见问题

FAQs
查看更多 >