cat_is_ancestor_of()
Перевіряє, чи вказана рубрика є дочірньою до іншої зазначеної рубрики (перевіряються всі рівні вкладеності). Умовний тег.
нотатки
Функція буде працювати, тільки якщо категорія вказана у параметрі
$cat2буде вкладена в категорію$cat1.Результат true буде повернуто навіть якщо $cat2 вкладена в $cat1 через кілька категорій (багаторівнева перевірка вкладеності).
- У параметри слід передавати саме число чи об’єкт. Наприклад, якщо передати число у вигляді рядка
'4', функція поверне false навіть якщо категорії споріднені.
Працює на основі:
term_is_ancestor_of()
term_is_ancestor_of()
1 раз – 0.000757 сек
(повільно) | 50000 разів – 1.05 сек
(швидко) |
PHP 7.0.5, WP 4.5.1
(повільно) | 50000 разів – 1.05 сек
(швидко) |
PHP 7.0.5, WP 4.5.1
Хуків немає.
Повертає
true|false.
true– коли $cat1 споріднена категорія до категорії $cat2 .false– Коли не споріднена.
Використання
cat_is_ancestor_of ($ cat1, $ cat2);
-
$cat1
(число/об’єкт) (обов’язковий) -
ID батьківської категорії. Категорії, яка повинна бути батьківською до категорії, зазначеної в параметрі
$cat2. -
$cat2
(число/об’єкт) (обов’язковий) -
ID дочірньої категорії будь-якого рівня. Категорії, яка повинна бути дочірньою категорією до категорії, зазначеної в параметрі
$cat1.
Приклади
#1 Nav Menu тільки для категорії з ID 4
Це приклад, який можна використовувати на сторінці категорій для того, щоб вивести навігаційне меню wp_nav_menu() тільки для категорії з ID 4 або категорій вкладених у цю категорію.
// якщо це категорія 4 або її підкатегорія
if( cat_is_ancestor_of( 4, $cat ) || is_category( 4 ) ){
wp_nav_menu(['menu' => 'Music']]);
}
список змін
| З версії 2.1.0 | Введено. |
Код cat_is_ancestor_of() cat is ancestor of WP 6.0.2
function cat_is_ancestor_of( $cat1, $cat2 ) {
return term_is_ancestor_of( $cat1, $cat2, 'category' );
}