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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/update post meta 19:34, 2 February 2010 Mslade)
 
(全体を和訳,update only the first field はウソなので削除)
1行目: 1行目:
==Description==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
The function, [[Function Reference/update post meta|update post meta()]], updates the value of an existing meta key (custom field) for the specified post.
+
[[関数リファレンス/update post meta|update post meta()]] は、指定した投稿に存在するカスタムフィールドの値を更新します。[[関数リファレンス/add post meta|add_post_meta()]] の代わりとしても使うことができます。この関数はまず、<tt>$post_id</tt> で ID を指定した投稿に <tt>$meta_key</tt> を持つカスタムフィールドが存在することを確認します。もし存在しなければ代わりに <tt>add_post_meta($post_id, $meta_key, $meta_value)</tt> を実行し、その結果(常に <var>true</var>)を返します。
  
This may be used in place of [[Function Reference/add post meta|add_post_meta()]] function.  The first thing this function will do is make sure that $meta_key already exists on $post_id.  If it does not, add_post_meta($post_id, $meta_key, $meta_value) is called instead and its results are returned.
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
True will always be returned.
+
<?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?>
  
==Usage==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
%%% <?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> %%%
+
{{Parameter|$post_id|整数|更新したいカスタムフィールドを持つ投稿の ID。}}
 +
{{Parameter|$meta_key|文字列|更新したいカスタムフィールドのキー。}}
 +
{{Parameter|$meta_value|文字列|カスタムフィールドの新しい値。}}
 +
{{Parameter|$prev_value|文字列|更新したいカスタムフィールドの元の値。これは、同じキーを持つカスタムフィールドを区別するパラメータです。省略すると、指定したキーを持つカスタムフィールドはすべて値が更新されます。|オプション}}
  
==Parameters==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
{{Parameter|$post_id|integer|The ID of the post which contains the field you will edit.}}
+
<div id="Default_Usage">
{{Parameter|$meta_key|string|The key of the custom field you will edit.}}
+
===デフォルトの使い方===
{{Parameter|$meta_value|string|The new value of the custom field.}}
+
</div>
{{Parameter|$prev_value|string|The old value of the custom field you wish to change. This is to differentiate between several fields with the same key.  If omitted, and there are multiple rows for this post and meta key, all meta values will be updated.|optional}}
+
 
+
==Examples==
+
 
+
===Default Usage===
+
  
 +
ID が76の投稿で、キーが <tt>my_key</tt> のカスタムフィールドの値を ''Steve'' に変更します。
 
  <?php update_post_meta(76, 'my_key', 'Steve'); ?>
 
  <?php update_post_meta(76, 'my_key', 'Steve'); ?>
  
===Other Examples===
+
===その他の例===
  
Assuming a post has an ID of 76, and the following 4 custom fields:
+
ID が76の投稿に、以下の4つのカスタムフィールドがある場合:
  
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
+
<div style="border:1px solid blue; width:50%; padding:0 20px">
 
[key_1] => 'Happy'<br/>
 
[key_1] => 'Happy'<br/>
 
[key_1] => 'Sad'<br/>
 
[key_1] => 'Sad'<br/>
 
[key_2] => 'Gregory'<br/>
 
[key_2] => 'Gregory'<br/>
[my_key] => 'Steve'<br/>
+
[my_key] => 'Steve'
 
</div>
 
</div>
  
To change <tt>key_2</tt>'s value to ''Hans'':
+
<tt>key_2</tt> のキーを持つカスタムフィールドの値を ''Hans'' に変更するには:
 
  <?php update_post_meta(76, 'key_2', 'Hans'); ?>
 
  <?php update_post_meta(76, 'key_2', 'Hans'); ?>
  
To change <tt>key_1</tt>'s value from ''Sad'' to ''Happy'':
+
<tt>key_1</tt> のキーを持つカスタムフィールドで値を ''Sad'' から ''Happy'' に変更するには:
 
  <?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>
 
  <?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>
  
The fields would now look like this:
+
この結果、カスタムフィールドは以下のようになります:
  
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
+
<div style="border:1px solid blue; width:50%; padding:0 20px">
 
[key_1] => 'Happy'<br/>
 
[key_1] => 'Happy'<br/>
 
[key_1] => 'Happy'<br/>
 
[key_1] => 'Happy'<br/>
 
[key_2] => 'Hans'<br/>
 
[key_2] => 'Hans'<br/>
[my_key] => 'Steve'<br/>
+
[my_key] => 'Steve'
 
</div>
 
</div>
'''''Note:''' This function will update only the first field that matches the criteria.''
 
  
To change the first <tt>key_1</tt>'s value from ''Happy'' to ''Excited'':
+
'''''注:''' この関数は、条件に一致するすべてのカスタムフィールドを変更します。''
 +
 
 +
始めの <tt>key_1</tt> のキーを持つカスタムフィールドの値を ''Happy'' から ''Excited'' に変更するには:
 
<pre><?php  
 
<pre><?php  
 
   update_post_meta(76, 'key_1', 'Excited', 'Happy');
 
   update_post_meta(76, 'key_1', 'Excited', 'Happy');
  
   //Or
+
   // または
  
 
   update_post_meta(76, 'key_1', 'Excited');
 
   update_post_meta(76, 'key_1', 'Excited');
 
  //To change all fields with the key "key_1":
 
 
  $key1_values = get_post_custom_values('key_1', 76);
 
  foreach ( $key1_values as $value )
 
    update_post_meta(76, 'key_1', 'Excited', $value);
 
 
?></pre>
 
?></pre>
For a more detailed example, go to the [[Function Reference/post meta Function Examples|post_meta Functions Examples]] page.
 
  
==Related==
+
さらに詳しい例は [[関数リファレンス/post meta 関数の例|post meta 関数の例]] を見てください。
 +
 
 +
<div id="Related">
 +
== 関連資料 ==
 +
</div>
  
 
{{Post Meta Tags}}
 
{{Post Meta Tags}}
74行目: 79行目:
 
{{原文|Function Reference/update post meta|82577}}<!-- 19:34, 2 February 2010 Mslade -->
 
{{原文|Function Reference/update post meta|82577}}<!-- 19:34, 2 February 2010 Mslade -->
 
[[Category:Functions]]
 
[[Category:Functions]]
[[en:Function Reference/update post meta]
+
[[en:Function Reference/update post meta]]

2010年4月22日 (木) 21:53時点における版

update post meta() は、指定した投稿に存在するカスタムフィールドの値を更新します。add_post_meta() の代わりとしても使うことができます。この関数はまず、$post_id で ID を指定した投稿に $meta_key を持つカスタムフィールドが存在することを確認します。もし存在しなければ代わりに add_post_meta($post_id, $meta_key, $meta_value) を実行し、その結果(常に true)を返します。

使い方

<?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> 

パラメータ

$post_id
整数) (必須) 更新したいカスタムフィールドを持つ投稿の ID。
初期値: なし
$meta_key
文字列) (必須) 更新したいカスタムフィールドのキー。
初期値: なし
$meta_value
文字列) (必須) カスタムフィールドの新しい値。
初期値: なし
$prev_value
文字列) (オプション) 更新したいカスタムフィールドの元の値。これは、同じキーを持つカスタムフィールドを区別するパラメータです。省略すると、指定したキーを持つカスタムフィールドはすべて値が更新されます。
初期値: なし

用例

デフォルトの使い方

ID が76の投稿で、キーが my_key のカスタムフィールドの値を Steve に変更します。

<?php update_post_meta(76, 'my_key', 'Steve'); ?>

その他の例

ID が76の投稿に、以下の4つのカスタムフィールドがある場合:

[key_1] => 'Happy'
[key_1] => 'Sad'
[key_2] => 'Gregory'
[my_key] => 'Steve'

key_2 のキーを持つカスタムフィールドの値を Hans に変更するには:

<?php update_post_meta(76, 'key_2', 'Hans'); ?>

key_1 のキーを持つカスタムフィールドで値を Sad から Happy に変更するには:

<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>

この結果、カスタムフィールドは以下のようになります:

[key_1] => 'Happy'
[key_1] => 'Happy'
[key_2] => 'Hans'
[my_key] => 'Steve'

注: この関数は、条件に一致するすべてのカスタムフィールドを変更します。

始めの key_1 のキーを持つカスタムフィールドの値を Happy から Excited に変更するには:

<?php 
  update_post_meta(76, 'key_1', 'Excited', 'Happy');

  // または

  update_post_meta(76, 'key_1', 'Excited');
?>

さらに詳しい例は post meta 関数の例 を見てください。


カスタムフィールド: the_meta(), get_post_meta(), add_post_meta(), update_post_meta(), delete_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys() (post_meta 関数の例 /en も参照)


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

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