February 11, 2011 
Definition:
function add_metadata($meta_type, $object_id, $meta_key, $meta_value, $unique = false) {}
Add metadata for the specified object.
Parameters
- string $meta_type: Type of object metadata is for (e.g., comment, post, or user)
- int $object_id: ID of the object metadata is for
- string $meta_key: Metadata key
- string $meta_value: Metadata value
- bool $unique: Optional, default is false. Whether the specified metadata key should be unique for the object. If true, and the object already has a value for the specified metadata key, no change will be made
Return values
returns:The meta ID on successful update, false on failure.
Defined filters
- add_{$meta_type}_metadata
apply_filters( "add_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $unique )
Source code
function add_metadata($meta_type, $object_id, $meta_key, $meta_value, $unique = false) {
if ( !$meta_type || !$meta_key )
return false;
if ( !$object_id = absint($object_id) )
return false;
if ( ! $table = _get_meta_table($meta_type) )
return false;
global $wpdb;
$column = esc_sql($meta_type . '_id');
// expected_slashed ($meta_key)
$meta_key = stripslashes($meta_key);
$meta_value = stripslashes_deep($meta_value);
$meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type );
$check = apply_filters( "add_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $unique );
357
A HitchHackers guide through WordPress 
No comments yet... Be the first to leave a reply!