Функция возвращает true
, если к посту (или произвольному типу поста), ID которого указан в первом параметре, относится хотя бы один из элементов таксономии (название которой — второй параметр функции), которые перечислены в третьем параметре функции. Если к указанному посту не относится ни один из перечисленных элементов, функция возвращает false
.
is_object_in_term( $object_id, $taxonomy, $terms = null )
- $object_id
- (целое число) ID объекта (то есть ID записи или какого-либо другого типа постов).
- $taxonomy
- (строка) Название таксономии, для которой будет осуществляться проверка.
- $terms
- (целое число|строка|массив) ID, названия либо ярлыки элементов, принадлежность которых будем проверять. Несколько значений можно перечислить через массив. Если данный параметр не указан, то будет проверяться принадлежность объекта к любому из элементов указанной таксономии.
Несколько похожих функций для более частных случаев:
Пример
Предположим, что на нашем сайте есть каталог телефонов и мобильных устройств, и мы хотим проверить, принадлежит ли телефон с указанным ID к элементу таксономии (это будут компании-производители) «apple» (это будет ярлык компании «Apple»).
if ( is_object_in_term( $phone_id, 'company', 'apple' ) ) : // если ДА else : // если НЕТ endif;