08.Мар.2011 ^{16.Фев.2011} Рубрики Ком-ев: 0↓ Автор: Kama ⁷¹²

cat_is_ancestor_of с версии 2.1.0

Описание

Условный тег, проверяющий родственность двух категорий (проверяются все уровни вложенности).

Это логическая функция, поэтому она возвращает правду (true), если $cat1 родственная категория к категории $cat2 и ложь (false), если не родственная.

Использование

<?php cat_is_ancestor_of( $cat1, $cat2 ); ?>

Параметры

$cat1

(число/объект) (обязательный) ID категории, которая должна быть родительской к категории указанной в параметре cat2. Вместо ID можено передать объект.
По умолчанию: нет

$cat2

(число/объект) (обязательный) ID категории, которая должна быть дочерней категорией к категории указанной в параметре cat1. Вместо ID можно указать объект.
По умолчанию: нет

Примеры

1. Это пример, который можно использовать на странице категорий, для того чтобы вывести навигационное меню (wp_nav_menu()) только для категории с ID 4 или категорий вложенных в эту категорию.

<?php
// если это категория 4 или её подкатегория
if (cat_is_ancestor_of(4, $cat) or is_category(4)) {
      wp_nav_menu( array('menu' => 'Music' ));
} ?>

На заметку

Функция будет работать, только если категория указанная в параметре $cat2 будет вложеной в категорию указанную в параметре $cat1;
Результат true будет возвращен даже если $cat2 вложена в $cat1 через несколько категорий (многоуровневая проверка вложенности);
В параметры следует передвать именно число или объект. Например если передать число в виде строки ('4'), функия вернет false даже если категории родственные.

cat_is_ancestor_of()

из файла: /wp-includes/category.php ^{WP 3.3.2}

function cat_is_ancestor_of( $cat1, $cat2 ) {
	if ( ! isset($cat1->term_id) )
		$cat1 = &get_category( $cat1 );
	if ( ! isset($cat2->parent) )
		$cat2 = &get_category( $cat2 );

	if ( empty($cat1->term_id) || empty($cat2->parent) )
		return false;
	if ( $cat2->parent == $cat1->term_id )
		return true;

	return cat_is_ancestor_of( $cat1, get_category( $cat2->parent ) );
}

Связанные Функции

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Комментариев нет↓cat_is_ancestor_of