Обновление Опции Сайта (UPDATE_SITE_OPTION) – Как использовать функцию update_site_option() в WordPress

Обновление Опции Сайта (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.

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *