delete_(meta_type)_metadata_by_mid
Short-circuits deleting metadata of a specific type by meta ID.
The dynamic portion of the hook name, $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.
Possible hook names include:
- delete_post_metadata_by_mid
- delete_comment_metadata_by_mid
- delete_term_metadata_by_mid
- delete_user_metadata_by_mid
Usage
add_filter( 'delete_(meta_type)_metadata_by_mid', 'wp_kama_delete_meta_type_metadata_by_mid_filter', 10, 2 ); /** * Function for `delete_(meta_type)_metadata_by_mid` filter-hook. * * @param null|bool $delete Whether to allow metadata deletion of the given type. * @param int $meta_id Meta ID. * * @return null|bool */ function wp_kama_delete_meta_type_metadata_by_mid_filter( $delete, $meta_id ){ // filter... return $delete; }
- $delete(null|true|false)
- Whether to allow metadata deletion of the given type.
- $meta_id(int)
- Meta ID.
Changelog
Since 5.0.0 | Introduced. |
Where the hook is called
delete_(meta_type)_metadata_by_mid
wp-includes/meta.php 1025
$check = apply_filters( "delete_{$meta_type}_metadata_by_mid", null, $meta_id );
Where the hook is used in WordPress
wp-includes/default-filters.php 136
add_filter( 'delete_term_metadata_by_mid', 'wp_check_term_meta_support_prefilter' );
wp-includes/ms-default-filters.php 67
add_filter( 'delete_blog_metadata_by_mid', 'wp_check_site_meta_support_prefilter' );