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

関連

お勧めコンテンツ

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