• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/get post」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get post 03:51, 21 April 2010 Martythornley)
 
(全体を和訳)
1行目: 1行目:
==Description==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
Takes a post ID and returns the database record for that post. You can specify, by means of the <tt>$output</tt> parameter, how you would like the results returned.
+
投稿 ID または投稿オブジェクトで指定した投稿のレコードをデータベースから取得します。<tt>$output</tt> で戻り値の型を指定できます。<tt>$filter</tt> には、取得したレコード内の各フィールドに対する無害化のコンテキストを指定します。無害化については [[Function Reference/sanitize post field|sanitize_post_field()]] も見てください。
  
==Usage==
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
%%%<?php get_post( $id, $output ); ?> %%%
+
<?php get_post( $id, $output, $filter ); ?>
  
==Parameters==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
{{Parameter|$post|integer|The ID of the post you'd like to fetch. '''You must pass a variable containing an integer''' (e.g. <tt>$id</tt>). A literal integer (e.g. <tt>7</tt>) will cause a fatal error (''Only variables can be passed for reference'' or ''Cannot pass parameter 1 by reference'').}}
+
{{Parameter|$post|整数またはオブジェクト|取得したい投稿の ID またはオブジェクト。ここには変数を指定してください。例えば <var>7</var> のような数値を直接指定するとエラー(''Only variables can be passed for reference'' または ''Cannot pass parameter 1 by reference'')になります。}}
{{Parameter|$output|string|How you'd like the result. <ul><li>''OBJECT'' - returns an object</li><li>''ARRAY_A'' - Returns an associative array of field names to values</li><li>''ARRAY_N'' - returns a numeric array of field values</li></ul>|optional|OBJECT}}
+
{{Parameter|$output|定数|戻り値の型|オプション|OBJECT}}
 +
:* <code>'ARRAY_A'</code> - 連想配列
 +
:* <code>'ARRAY_N'</code> - インデックス配列
 +
:* <code>'OBJECT'</code> - 投稿オブジェクト
 +
{{Parameter|$filter|文字列|無害化のコンテキスト|オプション|'raw'}}
 +
:* <code>'raw'</code> - 数値フィールドの値のみ無害化
 +
:* <code>'edit'</code> - 各種フィルターフックで無害化
 +
:* <code>'db'</code> - 各種フィルターフックで無害化
 +
:* <code>'display'</code> - 数値フィールドの値のみ無害化
 +
:* <code>'attreibute'</code> - <tt>esc_attr()</tt> で無害化
 +
:* <code>'js'</code> - <tt>esc_js()</tt> で無害化
  
==Example==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
To get the title for a post with ID 7:
+
投稿 ID が7のタイトルを取得する:
  
%%%<?php
+
<pre><?php
 
$my_id = 7;
 
$my_id = 7;
$post_id_7 = get_post($my_id);  
+
$post_id_7 = get_post ( $my_id );  
 
$title = $post_id_7->post_title;
 
$title = $post_id_7->post_title;
?> %%%
+
?></pre>
  
Alternatively, specify the <tt>$output</tt> parameter:
+
<tt>$output</tt> を指定した場合:
  
%%%<?php
+
<pre><?php
 
$my_id = 7;
 
$my_id = 7;
$post_id_7 = get_post($my_id, ARRAY_A);
+
$post_id_7 = get_post( $my_id, ARRAY_A );
 
$title = $post_id_7['post_title'];
 
$title = $post_id_7['post_title'];
?> %%%
+
?></pre>
  
%%%<?php
+
<prE><?php
## Correct: pass a dummy variable as post_id
+
// 正)投稿 ID としてダミー変数を使用:
 
$the_post = & get_post( $dummy_id = 7 );
 
$the_post = & get_post( $dummy_id = 7 );
 
 
## Incorrect: literal integer as post_id
+
// 誤)投稿 ID に数値を使用:
 
$the_post = & get_post( 7 );
 
$the_post = & get_post( 7 );
// Fatal error: 'Only variables can be passed for reference' or 'Cannot pass parameter 1 by reference'
+
// Fatal error: 'Only variables can be passed for reference' または 'Cannot pass parameter 1 by reference'
?>%%%
+
?></pre>
  
==Return==
+
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
  
The fields returned are:
+
戻り値に含まれるフィールドの値:
 +
[[データベース概要#Table:_wp_posts|データベース概要 - テーブル: wp_posts]] も見てください。
  
; <tt>ID</tt> : (''integer'') The post ID
+
; <tt>ID</tt> : (''整数'') 投稿 ID
; <tt>post_author</tt> : (''integer'') The post author's ID
+
; <tt>post_author</tt> : (''整数'') 作成者 ID
; <tt>post_date</tt> : (''string'') The datetime of the post (<tt>YYYY-MM-DD HH:MM:SS</tt>)
+
; <tt>post_date</tt> : (''文字列'') 投稿日時 (<tt>YYYY-MM-DD HH:MM:SS</tt>)
; <tt>post_date_gmt</tt> : (''string'') The GMT datetime of the post (<tt>YYYY-MM-DD HH:MM:SS</tt>)
+
; <tt>post_date_gmt</tt> : (''文字列'') GMT での投稿日時 (<tt>YYYY-MM-DD HH:MM:SS</tt>)
; <tt>post_content</tt> : (''string'') The post's contents
+
; <tt>post_content</tt> : (''文字列'') 本文
; <tt>post_title</tt> : (''string'') The post's title
+
; <tt>post_title</tt> : (''文字列'') タイトル
; <tt>post_category</tt> : (''integer'') The post category's ID. Note that this will always be 0 (zero) from wordpress 2.1 onwards. To determine a post's category or categories, use [[Function_Reference/get_the_category|get_the_category()]].
+
; <tt>post_category</tt> : (''整数'') カテゴリー ID。[[Version 2.1|バージョン 2.1]] 以降、常に0です。投稿のカテゴリーを取得するには [[関数リファレンス/get_the_category|get_the_category()]] を使用してください。
; <tt>post_excerpt</tt> : (''string'') The post excerpt
+
; <tt>post_excerpt</tt> : (''文字列'') 抜粋
; <tt>post_status</tt> : (''string'') The post status (<tt>publish|pending|draft|private|static|object|attachment|inherit|future</tt>)
+
; <tt>post_status</tt> : (''文字列'') 公開ステータス (<tt>publish|pending|draft|private|static|object|attachment|inherit|future</tt>)
; <tt>comment_status</tt> : (''string'') The comment status (<tt>open|closed|registered_only</tt>)
+
; <tt>comment_status</tt> : (''文字列'') コメントステータス (<tt>open|closed|registered_only</tt>)
; <tt>ping_status</tt> : (''string'') The pingback/trackback status (<tt>open|closed</tt>)
+
; <tt>ping_status</tt> : (''文字列'') ピンバック/トラックバックステータス (<tt>open|closed</tt>)
; <tt>post_password</tt> : (''string'') The post password
+
; <tt>post_password</tt> : (''文字列'') 閲覧パスワード
; <tt>post_name</tt> : (''string'') The post's URL slug
+
; <tt>post_name</tt> : (''文字列'') スラッグ
; <tt>to_ping</tt> : (''string'') URLs to be pinged
+
; <tt>to_ping</tt> : (''文字列'') ピン通知 URL
; <tt>pinged</tt> : (''string'') URLs already pinged
+
; <tt>pinged</tt> : (''文字列'') ピン通知済み URL
; <tt>post_modified</tt> : (''string'') The last modified datetime of the post (<tt>YYYY-MM-DD HH:MM:SS</tt>)
+
; <tt>post_modified</tt> : (''文字列'') 更新日時 (<tt>YYYY-MM-DD HH:MM:SS</tt>)
; <tt>post_modified_gmt</tt> : (''string'') The last modified GMT datetime of the post (<tt>YYYY-MM-DD HH:MM:SS</tt>)
+
; <tt>post_modified_gmt</tt> : (''文字列'') GMT での更新日時 (<tt>YYYY-MM-DD HH:MM:SS</tt>)
; <tt>post_content_filtered</tt> : (''string'')  
+
; <tt>post_content_filtered</tt> : (''文字列'')  
; <tt>post_parent</tt> : (''integer'') The parent post's ID (for attachments, etc)
+
; <tt>post_parent</tt> : (''整数'') ID (固定ページや添付ファイルなどで使用)
; <tt>guid</tt> : (''string'') A link to the post. Note: One cannot rely upon the GUID to be the permalink (as it previously was in pre-2.5), Nor can you expect it to be a valid link to the post. It's mearly a unique identifier, which so happens to be a link to the post at present.
+
; <tt>guid</tt> : (''文字列'') 投稿へのリンクの書式になっている識別子。
; <tt>menu_order</tt> : (''integer'')  
+
; <tt>menu_order</tt> : (''整数'') [[Pages|固定ページ]] の表示順序。
; <tt>post_type</tt> : (''string'') (<tt>post|page|attachment</tt>)
+
; <tt>post_type</tt> : (''文字列'') 投稿タイプ (<tt>post|page|attachment</tt>)
; <tt>post_mime_type</tt> : (''string'') Mime Type (for attachments, etc)
+
; <tt>post_mime_type</tt> : (''文字列'') 添付ファイルのとき MIME タイプ(image/png など)
; <tt>comment_count</tt> : (''integer'') Number of comments
+
; <tt>comment_count</tt> : (''整数'') コメント数
  
== Source File ==
+
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
  
<tt>get_post()</tt> is located in {{Trac|wp-includes/post.php}} and {{Trac|wp-app.php}}.
+
* [[Version 1.5.1|バージョン 1.5.1]] : 新規導入
  
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
 +
 +
<tt>get_post()</tt> は {{Trac|wp-includes/post.php}} と {{Trac|wp-app.php}} に含まれています。
 +
 +
<!--
 
== References ==
 
== References ==
  
 
* [http://wordpress.org/support/topic/54424 get_post method not working] NB: "This topic has been closed to new replies."
 
* [http://wordpress.org/support/topic/54424 get_post method not working] NB: "This topic has been closed to new replies."
 +
-->
  
== Related ==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 
{{Copyedit}}
 
 
{{原文|Function Reference/get post|86339}}
 
{{原文|Function Reference/get post|86339}}
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[en:Function Reference/get post]]
 
[[en:Function Reference/get post]]

2010年4月29日 (木) 00:04時点における版

投稿 ID または投稿オブジェクトで指定した投稿のレコードをデータベースから取得します。$output で戻り値の型を指定できます。$filter には、取得したレコード内の各フィールドに対する無害化のコンテキストを指定します。無害化については sanitize_post_field() も見てください。

使い方

<?php get_post( $id, $output, $filter ); ?>

パラメータ

$post
整数またはオブジェクト) (必須) 取得したい投稿の ID またはオブジェクト。ここには変数を指定してください。例えば 7 のような数値を直接指定するとエラー(Only variables can be passed for reference または Cannot pass parameter 1 by reference)になります。
初期値: なし
$output
定数) (オプション) 戻り値の型
初期値: OBJECT
  • 'ARRAY_A' - 連想配列
  • 'ARRAY_N' - インデックス配列
  • 'OBJECT' - 投稿オブジェクト
$filter
文字列) (オプション) 無害化のコンテキスト
初期値: 'raw'
  • 'raw' - 数値フィールドの値のみ無害化
  • 'edit' - 各種フィルターフックで無害化
  • 'db' - 各種フィルターフックで無害化
  • 'display' - 数値フィールドの値のみ無害化
  • 'attreibute' - esc_attr() で無害化
  • 'js' - esc_js() で無害化

用例

投稿 ID が7のタイトルを取得する:

<?php
$my_id = 7;
$post_id_7 = get_post ( $my_id ); 
$title = $post_id_7->post_title;
?>

$output を指定した場合:

<?php
$my_id = 7;
$post_id_7 = get_post( $my_id, ARRAY_A );
$title = $post_id_7['post_title'];
?>
<?php
//	正)投稿 ID としてダミー変数を使用:
$the_post = & get_post( $dummy_id = 7 );
	
//	誤)投稿 ID に数値を使用:
$the_post = & get_post( 7 );
//	Fatal error: 'Only variables can be passed for reference' または 'Cannot pass parameter 1 by reference'
?>

戻り値

戻り値に含まれるフィールドの値: データベース概要 - テーブル: wp_posts も見てください。

ID 
(整数) 投稿 ID
post_author 
(整数) 作成者 ID
post_date 
(文字列) 投稿日時 (YYYY-MM-DD HH:MM:SS)
post_date_gmt 
(文字列) GMT での投稿日時 (YYYY-MM-DD HH:MM:SS)
post_content 
(文字列) 本文
post_title 
(文字列) タイトル
post_category 
(整数) カテゴリー ID。バージョン 2.1 以降、常に0です。投稿のカテゴリーを取得するには get_the_category() を使用してください。
post_excerpt 
(文字列) 抜粋
post_status 
(文字列) 公開ステータス (publish|pending|draft|private|static|object|attachment|inherit|future)
comment_status 
(文字列) コメントステータス (open|closed|registered_only)
ping_status 
(文字列) ピンバック/トラックバックステータス (open|closed)
post_password 
(文字列) 閲覧パスワード
post_name 
(文字列) スラッグ
to_ping 
(文字列) ピン通知 URL
pinged 
(文字列) ピン通知済み URL
post_modified 
(文字列) 更新日時 (YYYY-MM-DD HH:MM:SS)
post_modified_gmt 
(文字列) GMT での更新日時 (YYYY-MM-DD HH:MM:SS)
post_content_filtered 
(文字列)
post_parent 
(整数) 親 ID (固定ページや添付ファイルなどで使用)
guid 
(文字列) 投稿へのリンクの書式になっている識別子。
menu_order 
(整数) 固定ページ の表示順序。
post_type 
(文字列) 投稿タイプ (post|page|attachment)
post_mime_type 
(文字列) 添付ファイルのとき MIME タイプ(image/png など)
comment_count 
(整数) コメント数

変更履歴

ソースファイル

get_post()wp-includes/post.phpwp-app.php に含まれています。



関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/get post最新版との差分