Удаление пользовательских опций в WordPress с помощью DELETE_USER_OPTION()

Функция DELETE_USER_OPTION() была введена в версии WordPress 3.0. Она позволяет удалить опцию пользователя с учетом глобальных параметров блога.

Что такое пользовательские опции?

Пользовательские опции похожи на метаданные пользователя, но имеют поддержку глобальных опций блога. Это значит, что если параметр is_global равен false (по умолчанию), то к имени опции добавляется префикс таблицы WordPress.

Возвращаемое значение

Функция возвращает:

• true — если операция успешна
• false — если произошла ошибка

Синтаксис

Функция вызывается следующим образом:

delete_user_option( $user_id, $option_name, $is_global );

Параметры

• $user_id (int) — обязательный. Идентификатор пользователя, для которого удаляется опция.
• $option_name (string) — обязательный. Имя опции пользователя, которую нужно удалить.
• $is_global (bool) — Определяет, является ли имя опции глобальным или специфичным для блога. По умолчанию: false (опция специфична для блога).

Примеры использования

Пример 1: Удаление опции по умолчанию для пользователя с ID=8

В этом примере мы удаляем опцию default_password_nag для пользователя с ID 8:

if( delete_user_option( 8, 'default_password_nag' ) ) {
echo "Опция default_password_nag была удалена!";
} else {
echo "Не удалось удалить опцию default_password_nag!";
}

Замечание: Убедитесь, что вы используете правильный идентификатор пользователя и имя опции.

Примечания

• Функция работает с объектом базы данных WordPress, доступным через global $wpdb.

Изменения

• С версии 3.0.0 — Введена функция DELETE_USER_OPTION().

Код функции

Функция delete_user_option выглядит следующим образом:

function delete_user_option( $user_id, $option_name, $is_global = false ) {
global $wpdb;

if ( ! $is_global ) {
    $option_name = $wpdb->get_blog_prefix() . $option_name;
}

return delete_user_meta( $user_id, $option_name );

}

Связанные функции

В WordPress есть и другие функции, касающиеся пользователей, которые могут быть полезны:

• clean_user_cache()
• current_user_can()
• get_current_user_id()
• get_edit_user_link()
• get_user_by()
• get_user_option()
• get_userdata()
• get_users()
• is_user_logged_in()
• wp_create_user()
• wp_destroy_other_sessions()
• wp_get_current_user()
• wp_insert_user()
• wp_list_users()
• wp_send_new_user_notifications()
• wp_set_current_user()
• wp_update_user()
• WP_User()

Эти функции помогут вам управлять пользователями и их опциями в WordPress более эффективно.