当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「投稿ステータス」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(和訳完了。)
(ワークフロー: 投稿ステータスの遷移リンクを追加。そのほかクリーンアップ少し。)
1行目: 1行目:
WordPress の投稿は幾つかあるステータスの一つを持ちます。投稿のステータスは、その投稿を WordPress がどのように扱うかを決定します。例えば、誰でも見られる公の投稿は <code>[[#Published|公開済]]</code> ステータスを、草稿は <code>[[#Draft|下書き]]</code> ステータスを割り当てられます。ステータスは [[Database_Description#Table:_wp_posts|<code>wp_posts</code>]] テーブルの <code>post_status</code> フィールドへ格納されます。
+
WordPress の投稿はいくつかあるステータスの一つを持ちます。投稿のステータスは、その投稿を WordPress がどのように扱うかを決定します。例えば、誰でも見られる公の投稿は <code>[[#Published|公開済]]</code> ステータスを、草稿は <code>[[#Draft|下書き]]</code> ステータスを割り当てられます。ステータスは [[Database_Description#Table:_wp_posts|<code>wp_posts</code>]] テーブルの <code>post_status</code> フィールドへ格納されます。
  
 
WordPress は、すぐに使える [[#Default Statuses|8 つの組み込みステータス]] を提供します。[[Version 3.0|WordPress 3.0]] からは自分の好きな [[#Custom Status|カスタム投稿ステータス]] を追加して、別の方法で使うことができます。
 
WordPress は、すぐに使える [[#Default Statuses|8 つの組み込みステータス]] を提供します。[[Version 3.0|WordPress 3.0]] からは自分の好きな [[#Custom Status|カスタム投稿ステータス]] を追加して、別の方法で使うことができます。
7行目: 7行目:
 
</div>
 
</div>
  
WordPress は、ウェブサイトへ投稿されたコンテンツを公開する前にユーザーが([[ユーザーの種類と権限]]に基づいて)レビューする為の標準機能を提供します。これは一般的に「ワークフロー」と呼ばれます。WordPress のワークフロー機能は、投稿の <code>post_status</code> フィールドの値によって、投稿がワークフローのどのステップにあるかを判別します。
+
WordPress は、ウェブサイトへ投稿されたコンテンツを公開する前にユーザーが([[ユーザーの種類と権限]]に基づいて)レビューするための標準機能を提供します。これは一般的に「ワークフロー」と呼ばれます。WordPress のワークフロー機能は、投稿の <code>post_status</code> フィールドの値によって、投稿がワークフローのどのステップにあるかを判別します。
  
 
ほとんどのユーザーは少なくとも 2 種類のワークフロー状態を知っているでしょう:
 
ほとんどのユーザーは少なくとも 2 種類のワークフロー状態を知っているでしょう:
16行目: 16行目:
 
WordPress の内部では、「公開」ボタンをクリックすると投稿ステータスへ <code>publish</code> がセットされ、「下書きとして保存」ボタンをクリックすると <code>draft</code> がセットされます。また、[[Roles and Capabilities#edit_posts|<code>edit_posts</code> 権限]]を持つけれども [[Roles and Capabilities#publish_posts|<code>publish_posts</code> 権限]]を持たないユーザーが投稿を書き始めると、「公開」ボタンの代わりに「レビュー待ちとして送信」ボタンが表示されます。そのボタンを押すと、そのユーザーが作った投稿に [[#Pending|<code>pending</code> ステータス]]が割り当てられます。
 
WordPress の内部では、「公開」ボタンをクリックすると投稿ステータスへ <code>publish</code> がセットされ、「下書きとして保存」ボタンをクリックすると <code>draft</code> がセットされます。また、[[Roles and Capabilities#edit_posts|<code>edit_posts</code> 権限]]を持つけれども [[Roles and Capabilities#publish_posts|<code>publish_posts</code> 権限]]を持たないユーザーが投稿を書き始めると、「公開」ボタンの代わりに「レビュー待ちとして送信」ボタンが表示されます。そのボタンを押すと、そのユーザーが作った投稿に [[#Pending|<code>pending</code> ステータス]]が割り当てられます。
  
投稿のステータスは[[Administration Panels|管理画面]]の[[Write Post SubPanel|投稿の追加または編集サブパネル]]でセットできます。ただし、投稿に特定のステータスを割り当てるのは、相応の権限を持つユーザーのみが行えます。内部的には、どの投稿も同じ場所(<tt>[[Database_Description#Table:_wp_posts|wp_posts]]</tt> テーブル)に保存され、<tt>post_status</tt> というカラムで判別されます。
+
投稿ステータスは[[Administration Panels|管理画面]]の[[Write Post SubPanel|投稿の追加または編集サブパネル]]でセットできます。ただし、投稿に特定のステータスを割り当てるのは、相応の権限を持つユーザーのみが行えます。内部的には、どの投稿も同じ場所(<tt>[[Database_Description#Table:_wp_posts|wp_posts]]</tt> テーブル)に保存され、<tt>post_status</tt> というカラムで判別されます。
 +
 
 +
<p class="information">'''参考:''' 投稿ステータスを変えたときに呼び出されるアクション(フック)については[[投稿ステータスの遷移]]を見てください。</p>
  
 
<div id="Default_Statuses">
 
<div id="Default_Statuses">
78行目: 80行目:
 
</div>
 
</div>
  
<div style="margin:10px; border:1px solid blue; padding:5px">
+
<div class="important">'''注意:''' 下記の関数は、登録された投稿ステータスを管理画面に追加''しません''。その機能はまだ開発されていません。詳細は [https://core.trac.wordpress.org/ticket/12706 Trac チケット #12706] を参照してください。このパラメーターを追加するには、アクションフック [http://core.trac.wordpress.org/browser/tags/3.5.1/wp-admin/includes/meta-boxes.php#L183 post_submitbox_misc_actions] の利用を検討してください。</div>
'''注意:'''<br />
+
下記の関数は、登録された投稿ステータスを管理画面に追加''しません''。その機能はまだ開発されていません。詳細は [https://core.trac.wordpress.org/ticket/12706 Trac チケット #12706] を参照してください。このパラメーターを追加するには、アクションフック [http://core.trac.wordpress.org/browser/tags/3.5.1/wp-admin/includes/meta-boxes.php#L183 post_submitbox_misc_actions] の利用を検討してください。
+
</div>
+
  
 
カスタムステータスは、あなたが定義した投稿ステータスです。
 
カスタムステータスは、あなたが定義した投稿ステータスです。
109行目: 108行目:
  
 
<div id="Related">
 
<div id="Related">
== 関連資料 ==
+
== 関連項目 ==
 
</div>
 
</div>
  
 
* [[ユーザーの種類と権限]]
 
* [[ユーザーの種類と権限]]
 +
* [[投稿ステータスの遷移]]
  
 
<div id="Code_Documentation">
 
<div id="Code_Documentation">

2015年7月5日 (日) 08:27時点における版

WordPress の投稿はいくつかあるステータスの一つを持ちます。投稿のステータスは、その投稿を WordPress がどのように扱うかを決定します。例えば、誰でも見られる公の投稿は 公開済 ステータスを、草稿は 下書き ステータスを割り当てられます。ステータスは wp_posts テーブルの post_status フィールドへ格納されます。

WordPress は、すぐに使える 8 つの組み込みステータス を提供します。WordPress 3.0 からは自分の好きな カスタム投稿ステータス を追加して、別の方法で使うことができます。

WordPress は、ウェブサイトへ投稿されたコンテンツを公開する前にユーザーが(ユーザーの種類と権限に基づいて)レビューするための標準機能を提供します。これは一般的に「ワークフロー」と呼ばれます。WordPress のワークフロー機能は、投稿の post_status フィールドの値によって、投稿がワークフローのどのステップにあるかを判別します。

ほとんどのユーザーは少なくとも 2 種類のワークフロー状態を知っているでしょう:

WordPress の内部では、「公開」ボタンをクリックすると投稿ステータスへ publish がセットされ、「下書きとして保存」ボタンをクリックすると draft がセットされます。また、edit_posts 権限を持つけれども publish_posts 権限を持たないユーザーが投稿を書き始めると、「公開」ボタンの代わりに「レビュー待ちとして送信」ボタンが表示されます。そのボタンを押すと、そのユーザーが作った投稿に pending ステータスが割り当てられます。

投稿ステータスは管理画面投稿の追加または編集サブパネルでセットできます。ただし、投稿に特定のステータスを割り当てるのは、相応の権限を持つユーザーのみが行えます。内部的には、どの投稿も同じ場所(wp_posts テーブル)に保存され、post_status というカラムで判別されます。

参考: 投稿ステータスを変えたときに呼び出されるアクション(フック)については投稿ステータスの遷移を見てください。

デフォルトのステータス

WordPress がデフォルトで使用する 8 つの投稿ステータスがあります。

公開済 (publish)

誰でも見ることができます。

予約済 (future)

未来の日付に公開を予定されています。

下書き (draft)

適切な ユーザーレベル を持つユーザーが見ることができる、未完成の投稿です。

訳注edit_others_posts 権限を持つユーザー(普通は 編集者 権限グループを割り当てられたユーザー)。

承認待ち (pending)

publish_posts 権限を持つユーザー(普通は 編集者 権限グループを割り当てられたユーザー)による公開を待っています。

非公開 (private)

管理者レベルの WordPress ユーザーだけが見ることができます。

ゴミ箱 (trash)

ゴミ箱の中にある投稿は trash ステータスを割り当てられます。

自動保存 (auto-draft)

編集中に WordPress が自動的に保存した リビジョン です。

継承 (inherit)

子の投稿(添付ファイル/enリビジョン)に割り当てられ、実際のステータスは親投稿のステータスによって決まります。

カスタムステータス

注意: 下記の関数は、登録された投稿ステータスを管理画面に追加しません。その機能はまだ開発されていません。詳細は Trac チケット #12706 を参照してください。このパラメーターを追加するには、アクションフック post_submitbox_misc_actions の利用を検討してください。

カスタムステータスは、あなたが定義した投稿ステータスです。

WordPress へカスタムステータスを追加するには register_post_status() 関数を使用します。この関数により、投稿ステータスと、それが WordPress の中でどのように働くかを定義できます。

"Unread"(未読)というカスタム投稿ステータスを追加する基本的な例を示します:

function custom_post_status(){
	register_post_status( 'unread', array(
		'label'                     => _x( 'Unread', 'post' ),
		'public'                    => true,
		'exclude_from_search'       => false,
		'show_in_admin_all_list'    => true,
		'show_in_admin_status_list' => true,
		'label_count'               => _n_noop( 'Unread <span class="count">(%s)</span>', 'Unread <span class="count">(%s)</span>' ),
	) );
}
add_action( 'init', 'custom_post_status' );

リソース

コード・ドキュメンテーション

最新英語版: WordPress Codex » Post Status最新版との差分