update_site_option() WP 2.8.0

Обновляет или добавляет указанную опцию для текущего сайта (текущей сети блогов). Для сети мультисайтов.

Если функция используется не в Мультисайт сборке, то управление передается функции update_option() с параметром $autoload = 'no'.

Функция похода на update_option() или update_blog_option(), только она сохраняет данные в таблицу метаданных главного сайта сети wp_sitemeta, а не в таблицу wp_options текущего блога (сайта).

Получать такую опцию нужно через функцию get_site_option().

Про то, чем отличаются опции сайтов и блогов читайте в разделе: Структура сайтов и блогов.

Является основой для: grant_super_admin()

Работает на основе: update_network_option()

Хуков нет.

Возвращает

true/false. True - опция обновлена. False - не удалось обновить опцию.

Использование

update_site_option( $option, $value );

$option(строка) (обязательный)

Название опции, которую нужно обновить/добавить.

$value(смешанный) (обязательный)

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

Если значение опции передается как массив или объект, то перед сохранением, оно будет сериализовано.

Заметки

C версии 4.4.0 стала оберткой для функции update_network_option().

Примеры

#1 Сохраним опцию сети сайтов и получи её

update_site_option( 'my_site_option', 321 );

echo get_site_option( 'my_site_option' ); //> 321

Код update site option: `wp-includes/option.php` ^{WP 5.2.1}

<?php
function update_site_option( $option, $value ) {
	return update_network_option( null, $option, $value );
}

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

Из метки: API опций (параметров)

update_option()