add_term_meta() – добавляет метаданные в термин

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

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

  • false – если мета-поле добавить не удалось, например термина с указанным ID не существует или же $unique установлен в true и метаполе с заданным ключом уже есть в базе данных.
  • ID метаполя, если метаданные добавлены.
  • Объект класса WP_Error, если указанный term_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!
) */

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.