説明
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
関連
お勧め
カテゴリー専用の投稿一覧と新規投稿メニューを追加する（2012年1月23日 更新）
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。ブロックエディターの文字サイズ設定を変えてみる（2019年12月12日 更新）
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
4.2で始まるiOSの絵文字ケア（2018年5月27日 更新）
WordPress 4.2のベータ1、ベータ2が立て続けにリリースされ、4.2の正式版リリースが近づいています。4.2のポイントの1つは絵文字のクロスブラウザ対応です。ここでの絵文字とは、UTF-8で4バイトのコードが割り当てられている（基本的にはiOSの）絵文字を指します。この絵文字を含んだ投稿が正しく保存できなかったり、iOS以外の環境で意図した通りに表示できないといった問題があり、4.2ではそのような問題を対処をコードが組み込まれています。
「不明な書式」って何ですか。（2024年11月13日 更新）
オートコンプリート機能を利用して四字熟語を挿入するプラグインを作った際、ツールバーに「不明な書式をクリア（Clear Unknown Formatting）」ボタンが表示されるようになった。この「書式」、何を指しているのかわからないんだが。
決まった値を返すだけの関数群（2018年5月27日 更新）
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。