This function has been deprecated. Use delete_user_meta() instead.
delete_usermeta( int $user_id, string $meta_key, mixed $meta_value = '' )
Remove user meta data.
Description
See also
Parameters
- $user_id
-
(Required) User ID.
- $meta_key
-
(Required) Metadata key.
- $meta_value
-
(Optional) Metadata value.
Default value: ''
Return
(bool) True deletion completed and false if user_id is not a number.
Source
File: wp-includes/deprecated.php
function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {
_deprecated_function( __FUNCTION__, 'WP-3.0.0', 'delete_user_meta()' );
global $wpdb;
if ( !is_numeric( $user_id ) )
return false;
$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
if ( is_array($meta_value) || is_object($meta_value) )
$meta_value = serialize($meta_value);
$meta_value = trim( $meta_value );
$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
if ( $cur && $cur->umeta_id )
do_action( 'delete_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
if ( ! empty($meta_value) )
$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s AND meta_value = %s", $user_id, $meta_key, $meta_value) );
else
$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
clean_user_cache( $user_id );
wp_cache_delete( $user_id, 'user_meta' );
if ( $cur && $cur->umeta_id )
do_action( 'deleted_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
return true;
}
Changelog
Version | Description |
---|---|
WP-3.0.0 | Use delete_user_meta() |
WP-2.0.0 | Introduced. This function has been deprecated. Use delete_user_meta() instead. |