add_term_meta() – добавляет метаданные в термин - Блог про веб-разработку, SEO и маркетинг

Функция добавляет мета-поле (произвольное поле) для элемента таксономии с указанным ID. То есть это может быть рубрика, метка или элемент произвольной таксономии.

Функция возвращает:

add_term_meta( $term_id, $meta_key, $meta_value, $unique = false )

Параметры

$term_id: (целое число) ID элемента таксономии.
$meta_key: (строка) Ключ мета-поля.
$meta_value: Значение мета-поля. Можете даже передавать массивы, они будут автоматически сериализованы перед сохранением в базу данных.
$unique: (логическое) В базе данных для одного и того же термина может существовать несколько полей с одним и тем же ключом – и это нормально. Тем не менее, если вы не хотите, чтобы функция добавляла новое значение ключа в базу данных, если оно уже существует, то укажите этот параметр в значение true.

Примеры

// в качестве примера поработаем с термином с ID=5
// прикол в том, что нам даже не надо знать, рубрика это, метка или что-то ещё
$term_id = 5;
 
// добавили
add_term_meta( $term_id, 'true_key', 'Привет, мир!' );
 
// попробуем получить и вывести
$true_value = get_term_meta( $term_id, 'true_key', true );
echo $true_value; // Привет, мир
 
// попробуем добавить ещё с $unique = true
add_term_meta( $term_id, 'true_key', 'Hello world!', true );
 
// попробуем получить и вывести
$true_value = get_term_meta( $term_id, 'true_key', true );
echo $true_value; // Привет, мир
 
// попробуем добавить ещё с $unique = false
add_term_meta( $term_id, 'true_key', 'Hello world!' );
 
// попробуем получить и вывести
$true_value = get_term_meta( $term_id, 'true_key', true );
echo $true_value; // Array
print_r( $true_value );
/* Array
(
	[0] => Привет мир!
	[1] => Hello world!
) */