Обновление Опции Сайта (UPDATE_SITE_OPTION)
Функция update_site_option() используется для изменения значения опции, которая уже была добавлена для текущей сети сайтов в WordPress.
Как Это Работает
Эта функция фактически вызывает другую функцию — update_network_option(), которая и занимается обновлением опций.
Возвращаемое Значение
Функция возвращает значение true, если опция успешно обновлена, и false, если произошла ошибка.
Синтаксис Использования
update_site_option( $option, $value );
Параметры
- $option (строка) (обязательный): Имя опции, которую вы хотите обновить. Это значение не должно быть экранировано в SQL.
- $value (разное) (обязательный): Новое значение опции, которое также не должно быть экранировано в SQL.
Примеры Использования
Пример 1: Сохранение Опции для Сети Сайтов
update_site_option( 'my_site_option', 321 );
echo get_site_option( 'my_site_option' ); // Выведет: 321
В этом примере мы сохраняем значение 321 в опции с именем my_site_option. Затем мы выводим это значение с помощью функции get_site_option().
Примечания
- Функция
update_site_option()является оберткой дляupdate_network_option(), что означает, что она упрощает процесс работы с опциями сети сайтов.
Изменения в Истории Версий
- С версии 2.8.0: Функция была введена.
- С версии 4.4.0: Функция была изменена и теперь является оберткой для
update_network_option().
Исходный Код Функции
Вот как выглядит функция в коде WordPress:
function update_site_option( $option, $value ) {
return update_network_option( null, $option, $value );
}
Связанные Функции
Функция update_site_option() является частью API опций в WordPress, вот другие функции, которые могут быть полезны:
add_network_option(): Добавляет опцию для сети сайтов.add_option(): Добавляет новую опцию.delete_option(): Удаляет опцию.get_network_option(): Получает опцию сети.get_option(): Получает опцию.get_site_option(): Получает опцию для сайта.register_setting(): Регистрирует новую настройку.update_option(): Обновляет существующую опцию.
Эти функции помогут вам более гибко управлять опциями в WordPress.