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



お勧め

HTML編集モードに定型文ボタンを追加する(2011年6月1日 更新)

投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。

4.4では投稿ページも専用テンプレートが適用できる(2018年5月27日 更新)

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目(2011年7月6日 更新)

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

標準で使用できる数少ないショートコード[caption]とは(2018年5月27日 更新)

画像をアップロードして「投稿に追加」ボタンをクリックすると、投稿記事内にリンク付きのimgタグか、ショートコードのが挿入される。ここではそれらの書式を整理する。

ショートコードを含んだページを表示する前に何か処理する(2014年5月28日 更新)

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。