get_post_status_object

(3.0.0以降)
get_post_status_object - 投稿ステータス情報を取得する

説明

object get_post_status_object( string $post_status )
投稿ステータス情報を取得する。

パラメータ

  • $post_status
    投稿ステータスを指定。

返り値

投稿ステータス情報（オブジェクト）を返す。

注意

標準（WordPress 4.0.0）の投稿ステータス情報は次の通り。
ステータス
プロパティ		'publish''future''draft''pending''private''trash''auto-draft''inherit'
label"公開済み""予約済み""下書き""保留中""非公開""ゴミ箱""auto-draft""inherit"
label_count 
array( 0=>"Published <span class="count">(%s)</span>",
 1=>"Published <span class="count">(%s)</span>",
 'singular'=>"Published <span class="count">(%s)</span>",
 'plural'=>"Published <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"Scheduled <span class="count">(%s)</span>",
 1=>"Scheduled <span class="count">(%s)</span>",
 'singular'=>"Scheduled <span class="count">(%s)</span>",
 'plural'=>"Scheduled <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"Draft <span class="count">(%s)</span>",
 1=>"Drafts <span class="count">(%s)</span>",
 'singular'=>"Draft <span class="count">(%s)</span>",
 'plural'"Drafts <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"Pending <span class="count">(%s)</span>",
 1=>"Pending <span class="count">(%s)</span>",
 'singular'=>"Pending <span class="count">(%s)</span>",
 'plural'"Pending <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"Private <span class="count">(%s)</span>",
 1=>"Private <span class="count">(%s)</span>",
 'singular'=>"Private <span class="count">(%s)</span>",
 'plural'=>"Private <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"Trash <span class="count">(%s)</span>",
 1=>"Trash <span class="count">(%s)</span>",
 'singular'=>"Trash <span class="count">(%s)</span>",
 'plural'=>"Trash <span class="count">(%s)</span>",
 'context'=>null,
 'domain'=>null )
 
array( 0=>"auto-draft",
 1=>"auto-draft" )
 
array( 0=>"inherit",
 1=>"inherit" )
exclude_from_searchfalsefalsefalsefalsefalsetruetruefalse
_builtintruetruetruetruetruetruetruetrue
publictruefalsefalsefalsefalsefalsefalsefalse
internalfalsefalsefalsefalsefalsetruetruetrue
protectedfalsetruetruetruefalsefalsefalsefalse
privatefalsefalsefalsefalsetruefalsefalsefalse
publicly_queryabletruefalsefalsefalsefalsefalsefalsefalse
show_in_admin_status_listtruetruetruetruetruetruefalsefalse
show_in_admin_all_listtruetruetruetruetruefalsefalsefalse
name"publish""future""draft""pending""private""trash""auto-draft""inherit"

使用例

  • 投稿情報$postの投稿ステータス情報を取得する。
    <?php $status_obj = get_post_status_object( get_post_status( $post ) ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/post.php

関連

参考

Code Reference: get_post_status_object

お勧めコンテンツ

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目（2011年7月6日 登録）

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。

投稿一覧に独自リンクを追加する（2013年4月25日 登録）

管理者ページの「投稿一覧」や「固定ページ一覧」の各投稿記事はマウスポインタを移動すると、「編集」や「クイック編集」といったリンクが表示される。このリンクに独自のリンクを追加する方法を調べてみた。

もうquery_postsは呼ばない（2011年9月27日 登録）

トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭でquery_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。

使っていないか確認しないとね！（2011年6月8日 登録）

2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは3.24.7.0現在、廃止予定となっている関数をまとめて紹介する。

query_posts（WP_Queryクラス）で'tax_query'を使いこなす（2011年9月8日 登録）

2日にわたって投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」「query_posts（WP_Queryクラス）で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。

最終更新日時 : 2014-10-09 09:32