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

最終更新 : 2014年10月09日 09:32

関連

参考

Code Reference: get_post_status_object

お勧め

決まった値を返すだけの関数群（2018年5月27日 更新）

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

the_date関数で投稿日を確実に表示する（2011年12月20日 更新）

投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）

WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。

さくらのVPSでKUSANAGI（2018年5月27日 更新）

請け負っていた業務が一段落したので、「さくらのVPS」で「KUSANAGI」を試してみました。推奨環境はメモリ4GBとなっているが、今回は実験的な利用なので、SSD 2GBプランでトライしました。

絵文字画像がPNGからSVGへ（2018年5月27日 更新）

WordPressでは絵文字に対応していないブラウザ環境で絵文字を表示する仕組みをバージョン4.2から提供。絵文字に対応しているブラウザとそん色がない表示を実現する。