説明
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
関連
お勧め
時代はWP_Queryなのか(2011年8月1日 更新)
WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。3.6リリース直前チェック(2013年7月26日 更新)
$wpdbは、WordPressのデータベースにアクセスする際に使用できる便利なオブジェクト。独自テーブルの利用やデータ検索の最適化など、標準提供される関数では実現できないことを手助けしてくれる。そんな$wpdbのescapeメソッドが3.6で非推奨(deprecated)になる。テーブルブロックを投稿メタ(カスタムフィールド)に保存する(2022年1月5日 更新)
ふと「テーブルブロックの内容を投稿メタ(カスタムフィールド)として保存できたら便利なのでは」と思い、投稿メタの使い方を調べてみた。
さくらのVPSでKUSANAGI(2018年5月27日 更新)
請け負っていた業務が一段落したので、「さくらのVPS」で「KUSANAGI」を試してみました。推奨環境はメモリ4GBとなっているが、今回は実験的な利用なので、SSD 2GBプランでトライしました。
投稿画面のウェジェットを2列にする(2013年4月17日 更新)
ダッシュボード画面ではスクリーンレイアウトを最大4列まで選択できるのに、投稿画面は1列か2列のどちらか。高解像度のディスプレイを使っていると、投稿画面では大画面のメリットを生かせていない理由がここにあるのではと感じ、3列対応にしてみた。