В случае успеха возвращает ID meta_id
записанных в базу данных метаданных, иначе – false
.
add_site_meta( $blog_id, $meta_key, $meta_value, $unique = false );
Параметры
- $blog_id
- (целое число) ID блога, для которого добавляем метаданные.
- $meta_key
- (строка) Ключ, под которым данные будут храниться в базе данных.
- $meta_value
- (число|массив|строка|логическое) Значение. Нескалярные значения будут сериализованы перед сохранением в базу данных.
- $unique
- (логическое) По умолчанию
false
, если указатьtrue
, то, если в базе данных уже существуют данные с этим же ключем, то новые записи в базу добавляться не будут, чтобы лучше понять, скролльте к примеру ниже.
Пример
Попробуйте вставить функцию add_site_meta()
например прямо в functions.php
вашего тестового(!) сайта:
add_site_meta( 4, 'language', 'hawaiian' );
Вот что начнёт происходить с таблицей wp_blogmeta
в базе данных:
Чтобы это предотвратить, вы можете указать четвертый параметр функции, равный true
, тогда всё станет гораздо приятнее:
add_site_meta( 4, 'language', 'hawaiian', true );