update_(meta_type)_metadata_by_mid filter-hook . WP 5.0.0
Short-circuits updating metadata of a specific type by meta ID.
The dynamic portion of the hook, $meta_type, refers to the meta object type (post, comment, term, user, or any other type with an associated meta table). Returning a non-null value will effectively short-circuit the function.
Usage
add_filter( 'update_(meta_type)_metadata_by_mid', 'filter_function_name_5', 10, 4 ); function filter_function_name_5( $check, $meta_id, $meta_value, $meta_key ){ // filter... return $check; }
- $check(null/true/false)
- Whether to allow updating metadata for the given type.
- $meta_id(int)
- Meta ID.
- $meta_value(mixed)
- Meta value. Must be serializable if non-scalar.
- $meta_key(string/true/false)
- Meta key, if provided.
Changelog
Since 5.0.0 | Introduced. |
Where the hook is called
update_(meta_type)_metadata_by_mid
wp-includes/meta.php 816
$check = apply_filters( "update_{$meta_type}_metadata_by_mid", null, $meta_id, $meta_value, $meta_key );
Where in WP core the hook is used WordPress
wp-includes/meta.php 115
add_filter( 'update_term_metadata_by_mid', 'wp_check_term_meta_support_prefilter' );
wp-includes/meta.php 66
add_filter( 'update_blog_metadata_by_mid', 'wp_check_site_meta_support_prefilter' );