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 лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: