sanitize_(object_type)_meta_(meta_key) │ filter-hook │ WP 3.3.0

Filters the sanitization of a specific meta key of a specific meta type.

The dynamic portions of the hook name, $meta_type, and $meta_key, refer to the metadata object type (comment, post, term, or user) and the meta key value, respectively.

Usage

add_filter( 'sanitize_(object_type)_meta_(meta_key)', 'wp_kama_sanitize_object_type_meta_key_filter', 10, 3 );

/**
 * Function for `sanitize_(object_type)_meta_(meta_key)` filter-hook.
 * 
 * @param mixed  $meta_value  Metadata value to sanitize.
 * @param string $meta_key    Metadata key.
 * @param string $object_type Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user', or any other object type with an associated meta table.
 *
 * @return mixed
 */
function wp_kama_sanitize_object_type_meta_key_filter( $meta_value, $meta_key, $object_type ){

	// filter...
	return $meta_value;
}

$meta_value(mixed)

Metadata value to sanitize.

$meta_key(string)

Metadata key.

$object_type(string)

Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user', or any other object type with an associated meta table.

Changelog

Where the hook is called

return apply_filters( "sanitize_{$object_type}_meta_{$meta_key}", $meta_value, $meta_key, $object_type );

Where the hook is used in WordPress

add_filter( 'sanitize_post_meta_footnotes', '_wp_filter_post_meta_footnotes' );

remove_filter( 'sanitize_post_meta_footnotes', '_wp_filter_post_meta_footnotes' );

add_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['sanitize_callback'], 10, 4 );

add_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'], 10, 3 );

remove_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['sanitize_callback'] );

remove_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'] );