説明
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
関連
お勧め
Posts filter multiselect：プラグイン作ってみました（2022年4月8日 更新）
先週の金曜日、知り合いの方から「投稿一覧ページで絞り込みを行う際、複数選択できないか」といった問い合わせがあり、その時には「標準では無理ですね」と返答しました。このこと自体は事実なのですが、要するに「複数選択可能なドロップダウンメニュー」が実現できれば対応するのはそれほど難しくないような気がしました。この週末、そんなノリでちょっとコーディングしてできたのがこのプラグインです。全投稿を取得するのはnopaging=1でいい（2011年8月31日 更新）
query_posts関数（またはWP_Queryクラス）を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」－「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには？Contact Form 7に確認フェーズを（2012年12月16日 更新）
Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript（jQuery）を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。古めのリビジョンを削除した時のメモ（2022年5月16日 更新）
大きく育ったデータベースを整理するため、古めのリビジョンとそれに紐づいたカスタムフィールドデータを削除。と思ったら「The total number of locks exceeds the lock table size」というエラーが発生して削除できなかった。
プラグインで注意が必要な関数（2013年11月27日 更新）
先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。