update_term_meta()

Функция позволяет обновить метаданные элемента таксономии с определённым ключом, либо добавить, если их не существует.

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

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

• true – мета-поле было обновлено.
• false – если мета-поле обновить или добавить не удалось, например термина с указанным ID не существует.
• ID метаполя, если метаданные для указанного ключа не существовали и были добавлены, т.е функция отработала как аналог add_term_meta().
• Объект класса WP_Error, если указанный term_id существует в нескольких таксономиях одновременно.

update_term_meta( $term_id, $meta_key, $meta_value, $prev_value = '' )

Параметры

$term_id

(целое число) ID элемента таксономии.

$meta_key

(строка) Ключ мета-поля.

$meta_value

Значение мета-поля. Можете даже передавать массивы, они будут автоматически сериализованы перед сохранением в базу данных.

$prev_value

Дело в том, что даже для одного элемента таксономии в базе данных может быть несколько мета-полей с одним и тем же ключом. Для того, чтобы функция знала, какое из них обновлять, мы можем указать старое значение поля, иначе функция обновит их все.

Примеры

Предположим, что для рубрик (или меток, неважно) мы с вами добавили дополнительные SEO-поля.

Воспользуемся функцией update_term_meta(), чтобы обновить всех их для термина с ID=23.

$term_id = 23;
 
update_term_meta( $term_id, 'seo_title', 'Мета поля в терминах таксономий' );
update_term_meta( $term_id, 'seo_robots', 'yes' );