説明
object get_post_type_labels( object|WP_Post_Type $post_type_object )
投稿タイプのラベルを取得する。
パラメータ
- $post_type_object投稿タイプ情報のオブジェクトを指定。
返り値
投稿タイプのラベルをオブジェクトで返す。いくつかのバージョンでラベルデータが追加されている。
| プロパティ名 | バージョン | 内容（'投稿'の場合） |
|---|---|---|
| name | 3.0.0 | 'Posts' |
| singular_name | 3.0.0 | 'Post' |
| add_new | 3.0.0 | 'Add New' |
| add_new_item | 3.0.0 | 'Add New Post' |
| edit_item | 3.0.0 | 'Edit Post' |
| new_item | 3.0.0 | 'New Post' |
| view_item | 3.0.0 | 'View Post' |
| search_items | 3.0.0 | 'Search Posts' |
| not_found | 3.0.0 | 'No posts found.' |
| not_found_in_trash | 3.0.0 | 'No posts found in Trash.' |
| parent_item_colon | 3.0.0 | null |
| all_items | 3.0.0 | 'All Posts' |
| menu_name | － | 'Posts' |
| name_admin_bar | － | 'Post' |
| featured_image | 4.3.0 | 'Featured Image' |
| set_featured_image | 4.3.0 | 'Set featured image' |
| remove_featured_image | 4.3.0 | 'Remove featured image' |
| use_featured_image | 4.3.0 | 'Use as featured image' |
| archives | 4.4.0 | 'Post Archives' |
| insert_into_item | 4.4.0 | 'Insert into post' |
| uploaded_to_this_item | 4.4.0 | 'Uploaded to this post' |
| filter_items_list | 4.4.0 | 'Filter posts list' |
| items_list_navigation | 4.4.0 | 'Posts list navigation' |
| items_list | 4.4.0 | 'Posts list' |
| view_items | 4.7.0 | 'View Posts' |
| attributes | 4.7.0 | 'Post Attributes' |
| item_published | 5.0.0 | 'Post published.' |
| item_published_privately | 5.0.0 | 'Post published privately.' |
| item_reverted_to_draft | 5.0.0 | 'Post reverted to draft.' |
| item_scheduled | 5.0.0 | 'Post scheduled.' |
| item_updated | 5.0.0 | 'Post updated.' |
注意
テーマやプラグインで本関数を呼び出す機会は少ない。 register_post_type関数で登録した投稿タイプのラベル（連想配列のキーとその内容）を確認できる。
'固定ページ'の場合、parent_item_colonプロパティは'Parent Page:'となる。親子関係のあるカスタム投稿タイプの場合は要注意。
使用例
- 投稿タイプのラベルを取得する。
<?php $labels = get_post_type_labels( $post_type_pbject ); ?>
フィルター
[3.5.0]デフォルトのラベルとマージする前に"post_type_labels_{$post_type}"フィルターを呼び出す。$labelsにはパラメータ$post_type_pbjectから取得したラベルのオブジェクトが格納されている。$labels = apply_filters( "post_type_labels_{$post_type}", $labels );アクション
実行するアクションはありません。ソースファイル
/wp-includes/post.php最終更新 : 2018年12月07日 09:57
関連
お勧め
個人データのエクスポートメール向けに追加された新フィルター（2020年4月2日 更新）
先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。
決まった値を返すだけの関数群（2018年5月27日 更新）
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。
サイドバーの初期化はwidgets_initアクションで（2011年7月14日 更新）
ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。Gutenbergでカスタムフィールドを使う（2018年8月10日 更新）
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
favicon.icoがWordPressロゴになる！？（2020年2月25日 更新）
先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。