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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/wp update post 05:40, 31 March 2010 Bennebw)
 
(全体を和訳。)
1行目: 1行目:
==Description==
+
<div id="Description">
This function updates posts (and pages) in the database. To work as expected, it is necessary to pass the ID of the post to be updated.
+
== 説明 ==
 +
</div>
  
Note that when the post is "updated", the existing Post record is duplicated for audit/revision purposes.  The primary record is then updated with the new values. Category associations, custom fields, post meta, and other related entries continue to be linked to the primary Post record.
+
データベースの投稿を更新します。更新する投稿の ID を指定してください。投稿が ''更新'' されると、以前の投稿はリビジョンとして保存されます。カテゴリー,カスタムフィールドなどの関連情報は更新された新しい投稿に紐付けされます。
  
==Usage==
+
<div id="Usage">
%%% <?php wp_update_post( $post ); ?> %%%
+
== 使い方 ==
 +
</div>
 +
 +
<?php wp_update_post( $post ); ?>
  
==Example==
+
<div id="Parameters">
Before calling wp_update_post() it is necessary to create an array to pass the necessary elements. Unlike [[Function Reference/wp insert post|wp_insert_post()]], it is only necessary to pass the ID of the post to be updated and the elements to be updated. The names of the elements should match those in the database.
+
== パラメータ ==
 +
</div>
 +
 
 +
<tt>wp_update_post()</tt> を実行する前に引数に渡す投稿情報を作成する必要があります。[[関数リファレンス/wp insert post|wp_insert_post()]] とは異なり、投稿 ID を指定する必要があります。
  
 
<pre>
 
<pre>
// Update post 37
+
// ID が37の投稿を更新します
 
   $my_post = array();
 
   $my_post = array();
 
   $my_post['ID'] = 37;
 
   $my_post['ID'] = 37;
   $my_post['post_content'] = 'This is the updated content.';
+
   $my_post['post_content'] = 'これの本文は更新されました。';
  
// Update the post into the database
+
// データベースの投稿情報を更新
 
   wp_update_post( $my_post );
 
   wp_update_post( $my_post );
 
</pre>
 
</pre>
  
===Categories===
+
===カテゴリー===
Categories need to be passed as an array of integers that match the category IDs in the database. This is the case even where only one category is assigned to the post.
+
カテゴリーはカテゴリー ID の配列で指定します。カテゴリーがひとつの場合でも配列にします。
 +
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$post|配列またはオブジェクト|配列の場合は値がエスケープされていること。投稿オブジェクトの場合はエスケープの必要はありません。キーの名前は <tt>wp_posts</tt> テーブルの各フィールド名と一致させます。投稿 ID が未指定の場合は更新ではなく追加になります。|オプション|空の配列}}
 +
 
 +
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
 +
 
 +
投稿の更新が成功した場合は投稿 ID。失敗した場合は <tt>0</tt>。
 +
 
 +
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
 +
 
 +
* [[Version 1.0|バージョン 1.0]] : 新規導入
  
==Parameters==
+
<div id="Source_File">
{{Parameter|$post|array|An object representing the elements that make up a post. There is a one-to-one relationship between these elements and the names of columns in the wp_posts table in the database. Filling out the ID field is not strictly necessary but without it there is little point to using the function.|optional|An empty array}}
+
== ソースファイル ==
 +
</div>
  
==Return==
+
<tt>wp_update_post()</tt> は {{Trac|wp-includes/post.php}} に含まれています。
The ID of the post if the post is successfully added to the database. Otherwise returns <tt>0</tt>.
+
  
==Related==
+
<div id="Related">
[[Function Reference/wp insert post|wp_insert_post()]]
+
== 関連資料 ==
 +
</div>
  
{{Copyedit}}
+
[[関数リファレンス/wp insert post|wp_insert_post()]]
 +
{{Tag Footer}}
 
{{原文|Function Reference/wp update post|85036}}<!-- 05:40, 31 March 2010 Bennebw -->
 
{{原文|Function Reference/wp update post|85036}}<!-- 05:40, 31 March 2010 Bennebw -->
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:New page created]]
 
[[Category:New page created]]
 
[[en:Function Reference/wp update post]]
 
[[en:Function Reference/wp update post]]

2010年5月2日 (日) 22:10時点における版

データベースの投稿を更新します。更新する投稿の ID を指定してください。投稿が 更新 されると、以前の投稿はリビジョンとして保存されます。カテゴリー,カスタムフィールドなどの関連情報は更新された新しい投稿に紐付けされます。

使い方

<?php wp_update_post( $post ); ?>

パラメータ

wp_update_post() を実行する前に引数に渡す投稿情報を作成する必要があります。wp_insert_post() とは異なり、投稿 ID を指定する必要があります。

// ID が37の投稿を更新します
  $my_post = array();
  $my_post['ID'] = 37;
  $my_post['post_content'] = 'これの本文は更新されました。';

// データベースの投稿情報を更新
  wp_update_post( $my_post );

カテゴリー

カテゴリーはカテゴリー ID の配列で指定します。カテゴリーがひとつの場合でも配列にします。

パラメータ

$post
配列またはオブジェクト) (オプション) 配列の場合は値がエスケープされていること。投稿オブジェクトの場合はエスケープの必要はありません。キーの名前は wp_posts テーブルの各フィールド名と一致させます。投稿 ID が未指定の場合は更新ではなく追加になります。
初期値: 空の配列

戻り値

投稿の更新が成功した場合は投稿 ID。失敗した場合は 0

変更履歴

ソースファイル

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

wp_insert_post()

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

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