update_user_option()
Оновлює опцію (метаполі) користувача. Розрахована на режим MU. Обгортка для update_user_meta() тільки додає префікс БД до назви метаполя.
Принцип роботи:
- Якщо $global = false (за замовчуванням), до назви метаполя додає префікс бази даних (з wp-config.php).
- Якщо $global = true повністю ідентична update_user_meta() .
Працює на основі:
update_user_meta()
update_user_meta()
Хуків немає.
Повертає
int|true|false.
- ID метаполя, якщо воно не існувало раніше і було створено
- true при успішному оновленні значення
- false за помилки.
Використання
update_user_option($user_id, $option_name, $newvalue, $global);
-
$user_id
(число) (обов’язковий) - ID Користувача.
-
$option_name
(рядок) (обов’язковий) - Назва опції.
-
$newvalue
(змішаний) (обов’язковий) - Значення опції.
-
$global
(логічний) Визначає, чи опція є глобальною або відноситься до локального сайту.
$global=true повністю ідентична update_user_meta () .
Типово: false
Приклади
#1 Додаємо опцію префікс_test_option для користувача з ID 1
update_user_option( 1, 'test_option', 'my_value'); // У користувача 1 з'явиться метаполі wp_test_option зі значенням my_value // wp_ Тут - це префікс бази даних
#2 Додаємо опцію test_option для користувача з ID 1
update_user_option( 1, 'test_option', 'my_value', true); // аналог update_user_meta() - у користувача 1 з'явиться // метаполі test_option зі значенням my_value
нотатки
- Global. wpdb. $wpdb WordPress database abstraction object.
список змін
| З версії 2.0.0 | Введено. |
Код update_user_option() update user option WP 6.0.2
function update_user_option( $user_id, $option_name, $newvalue, $global = false ) {
Global $wpdb;
if ( ! $global ) {
$option_name = $wpdb->get_blog_prefix() . $option_name;
}
return update_user_meta( $user_id, $option_name, $newvalue );
}