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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(新規追加)
 
(パラメータ: 一部訳)
15行目: 15行目:
 
== パラメータ ==
 
== パラメータ ==
  
{{Parameter|$meta_type|string|Type of object the metadata is for (e.g., comment, post, or user).常に単数。}}
+
{{Parameter|$meta_type|string|Type of object the metadata is for (e.g., コメント, 投稿, またはユーザー).常に単数。}}
 
{{Parameter|$object_id|integer|The ID of the object metadata is for.}}
 
{{Parameter|$object_id|integer|The ID of the object metadata is for.}}
{{Parameter|$meta_key|string|A metadata key (as in 'key'=>'value').}}
+
{{Parameter|$meta_key|string|メタデータキー。 ('key'=>'value'として).}}
{{Parameter|$meta_value|string|A metadata value (as in 'key'=>'value').}}
+
{{Parameter|$meta_value|string|メタデータキー。 ('key'=>'value'として).}}
{{Parameter|$unique|boolean|This determines whether the specified key can have multiple entries for the specified object id. If false, <tt>add_metadata()</tt> will add duplicate keys to the object. If true, nothing will be added if the specified key already exists for the specified id.|Optional|False}}
+
{{Parameter|$unique|boolean|This determines whether the specified key can have multiple entries for the specified object id. If false, <tt>add_metadata()</tt> will add duplicate keys to the object. If true, nothing will be added if the specified key already exists for the specified id.|オプション|False}}
  
 
== 戻り値 ==
 
== 戻り値 ==

2015年6月20日 (土) 21:45時点における版

説明

WordPressで指定されたオブジェクトのメタデータを追加します。

NOTE: This is a generic, low level function and should not be used directly by plugins or themes. Instead, use the corresponding meta functions for the object type you're working with:

使い方

<?php add_metadata( $meta_type, $object_id, $meta_key, $meta_value, $unique ); ?>

パラメータ

$meta_type
string) (必須) Type of object the metadata is for (e.g., コメント, 投稿, またはユーザー).常に単数。
初期値: なし
$object_id
integer) (必須) The ID of the object metadata is for.
初期値: なし
$meta_key
string) (必須) メタデータキー。 ('key'=>'value'として).
初期値: なし
$meta_value
string) (必須) メタデータキー。 ('key'=>'value'として).
初期値: なし
$unique
boolean) (オプション) This determines whether the specified key can have multiple entries for the specified object id. If false, add_metadata() will add duplicate keys to the object. If true, nothing will be added if the specified key already exists for the specified id.
初期値: False

戻り値

(boolean|integer) 
Returns false on failure. On success, returns the ID of the inserted row. However, note that the return value may instead be the result of the 'add_{$meta_type}_metadata' filter.

  • Uses: $wpdb
  • Uses: apply_filters() - Calls 'add_{$meta_type}_metadata' with null and each of the parameters passed to the function. If the result of this filter call is anything other than null, the function will be short-circuited and the result will be returned.
  • Uses: do_action() - Calls 'added_{$meta_type}_meta' if the metadata was added successfully with the ID of the new row in the meta table and the first three function parameters.

更新履歴

ソースファイル

add_metadata()wp-includes/meta.phpにあります。

関連

メタデータ API: add_metadata(), get_metadata() /en, update_metadata() /en, delete_metadata() /en



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


このページ「関数リファレンス/add metadata」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

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