delete_user_meta()
Видаляє зазначені метадані певного користувача.
Можна визначати опцію для видалення ключа ($meta_key) або одночасно за ключом і значенням ключа ($meta_key, $meta_value). Видалення за ключом та значенням оберігає від видалення дублюючих опцій, у яких ключі однакові. А якщо вказати лише ключ, то будуть видалені всі опції із зазначеним ключем (їх може бути декілька).
Метадані користувача – це аналог довільних полів у постів. Тільки тут пост це користувач. Зберігаються такі дані таблицю wp_usermeta .
Працює на основі:
delete_metadata()
delete_metadata()
Основа для:
delete_user_option()
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.
За замовчуванням: ”
Приклади
#1 Видалимо опцію _province у користувача 9:
$user_id = 9; if ( ! delete_user_meta($user_id, '_province') ) { echo "Оооопс! Помилка трапилася під час цієї операції!"; }
список змін
З версії 3.0.0 | Введено. |
Код delete_user_meta() 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 ); }