функция
since 5.1.0
update_site_meta()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
update_site_meta( int $site_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|boolОписание
Используйте параметр $prev_value, чтобы различать метаполя с одинаковыми ключом и ID сайта.
Если метаполе для сайта не существует, оно будет добавлено.
По историческим причинам на входе как ключ метаданных, так и значение метаданных должны быть «экранированы слэшами» (слэши экранированы).
Оригинал (английский)
Use the $prev_value parameter to differentiate between meta fields with the same key and site ID.
If the meta field for the site does not exist, it will be added.
For historical reasons both the meta key and the meta value are expected to be “slashed” (slashes escaped) on input.
Параметры
$site_id
int
обязательный
ID сайта.
$meta_key
string
обязательный
Ключ метаданных.
$meta_value
mixed
обязательный
Значение метаданных. Должно быть сериализуемым, если не является скалярным значением.
$prev_value
mixed
необязательный
= ''
Предыдущее значение для проверки перед обновлением.
Если указано, обновляются только существующие записи метаданных с этим значением. В противном случае обновляются все записи.
Возвращаемое значение
int|bool
Исходный код
wp-includes/ms-site.php:1116
function update_site_meta( $site_id, $meta_key, $meta_value, $prev_value = '' ) {
return update_metadata( 'blog', $site_id, $meta_key, $meta_value, $prev_value );
}История изменений
| Версия | Описание |
|---|---|
| 5.1.0 | Introduced. |
