delete_user_meta() WP 3.0.0

Видаляє зазначені метадані певного користувача.

Можна визначати опцію для видалення ключа ($meta_key) або одночасно за ключом і значенням ключа ($meta_key, $meta_value). Видалення за ключом та значенням оберігає від видалення дублюючих опцій, у яких ключі однакові. А якщо вказати лише ключ, то будуть видалені всі опції із зазначеним ключем (їх може бути декілька).

Метадані користувача – це аналог довільних полів у постів. Тільки тут пост це користувач. Зберігаються такі дані таблицю wp_usermeta .

Працює на основі:
delete_metadata()
Основа для:
delete_user_option()

Хуків немає.

Повертає

true|false. true чи false, від успішного чи успішного видалення.

Використання

delete_user_meta($user_id, $meta_key, $meta_value);
$user_id
(число) (обов’язковий)
ID користувача.
$meta_key
(рядок) (обов’язковий)
Назва опції, яку потрібно видалити.
$meta_value
(рядок)
Значення опції, яку необхідно видалити. Працює у зв’язці з параметром $meta_key.


За замовчуванням: ”

Приклади

0

#1 Видалимо опцію _province у користувача 9:

$user_id = 9;
if ( ! delete_user_meta($user_id, '_province') ) {
	echo "Оооопс! Помилка трапилася під час цієї операції!";
}

список змін

З версії 3.0.0Введено.

Код delete_user_meta() WP 6.0.2

function delete_user_meta( $user_id, $meta_key, $meta_value = '' ) {
	return delete_metadata( 'user', $user_id, $meta_key, $meta_value );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *