Home

add_metadata

February 11, 2011 by Thorsten 0 Comments

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

/wp-includes/meta.php, Documentation, Files, Filters, Filters by letter a, Functions, Functions by letter a
, ,

No comments yet... Be the first to leave a reply!

Leave a comment