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' );

Миша

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

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

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