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

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

関数リファレンス/add metadata

提供: WordPress Codex 日本語版
< 関数リファレンス
2015年6月18日 (木) 00:43時点におけるMiccweb (トーク | 投稿記録)による版 (新規追加)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

説明

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., comment, post, or user).常に単数。
初期値: なし
$object_id
integer) (必須) The ID of the object metadata is for.
初期値: なし
$meta_key
string) (必須) A metadata key (as in 'key'=>'value').
初期値: なし
$meta_value
string) (必須) A metadata value (as in 'key'=>'value').
初期値: なし
$unique
boolean) (Optional) 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最新版との差分