get_taxonomies()

Извлекает список зарегистрированных имен или объектов таксономий
Функция WordPress
INT 3.0.0
WordPress Icon

Описание функции

Функция get_taxonomies() возвращает список зарегистрированных имен или объектов таксономий в WordPress.

Назначение функции

Функция get_taxonomies() используется для получения списка всех зарегистрированных таксономий в WordPress. Таксономии в WordPress используются для организации и классификации контента, таких как категории и метки.

  • $args (массив, необязательный): Массив аргументов в формате ключ => значение для сопоставления с объектами таксономий. По умолчанию: пустой массив.
  • $output (строка, необязательный): Тип вывода, который нужно вернуть в массиве. Принимает значения ‘names’ (имена таксономий) или ‘objects’ (объекты таксономий). По умолчанию: ‘names’.
  • $operator (строка, необязательный): Логическая операция, которую нужно выполнить. Принимает значения ‘and’ (все элементы должны совпадать) или ‘or’ (достаточно, чтобы один элемент совпадал). По умолчанию: ‘and’.

Функция возвращает массив имен или объектов таксономий.


$args = array(
    'public' => true, // Получить только публичные таксономии
    'show_ui' => true, // Показывать пользовательский интерфейс для таксономий
);
$output = 'objects'; // Вернуть объекты таксономий
$operator = 'or'; // Логическая операция "или"
$taxonomies = get_taxonomies($args, $output, $operator);
foreach ($taxonomies as $taxonomy) {
    echo $taxonomy->name; // Выводит имя таксономии
    echo $taxonomy->label; // Выводит метку таксономии
    // Другие операции с объектом таксономии
}

Примеры использования

Получение списка зарегистрированных таксономий


$taxonomies = get_taxonomies();
// Результат: array( 'category', 'post_tag' )

Функция get_taxonomies() без аргументов возвращает массив со списком зарегистрированных таксономий. В данном примере возвращается массив, содержащий имена таксономий «category» и «post_tag».

Получение объектов таксономий


$taxonomies = get_taxonomies( array(), 'objects' );
// Результат: array( WP_Taxonomy( 'category' ), WP_Taxonomy( 'post_tag' ) )

Параметр $output позволяет указать тип вывода в массиве. Значение «objects» возвращает массив с объектами таксономий. В данном примере возвращается массив, содержащий объекты таксономий «category» и «post_tag».

Получение имен таксономий с определенными аргументами


$args = array(
    'public' => true,
    'show_ui' => true
);
$taxonomies = get_taxonomies( $args );
// Результат: array( 'category', 'post_tag' )

Параметр $args позволяет указать аргументы, с которыми будут сравниваться объекты таксономий. В данном примере возвращается массив, содержащий имена таксономий «category» и «post_tag», которые имеют аргументы «public» и «show_ui» со значением «true».

Получение имен таксономий с определенным типом вывода и оператором


$output = 'names';
$operator = 'or';
$taxonomies = get_taxonomies( array(), $output, $operator );
// Результат: array( 'category', 'post_tag' )

Параметры $output и $operator позволяют указать тип вывода и логическую операцию. В данном примере возвращается массив, содержащий имена таксономий «category» и «post_tag» с типом вывода «names» и оператором «or». Это означает, что достаточно, чтобы хотя бы один элемент из массива соответствовал аргументам.

Получение объектов таксономий с определенными аргументами


$args = array(
    'public' => true,
    'show_ui' => true
);
$output = 'objects';
$taxonomies = get_taxonomies( $args, $output );
// Результат: array( WP_Taxonomy( 'category' ), WP_Taxonomy( 'post_tag' ) )

Параметры $args и $output могут быть комбинированы для получения объектов таксономий с определенными аргументами. В данном примере возвращается массив, содержащий объекты таксономий «category» и «post_tag», которые имеют аргументы «public» и «show_ui» со значением «true» и тип вывода «objects».

Вопросы и ответы

Как получить список зарегистрированных таксономий?

Функция get_taxonomies() позволяет получить список зарегистрированных таксономий в WordPress. Для этого необходимо вызвать функцию без передачи каких-либо аргументов:


$taxonomies = get_taxonomies();

В результате выполнения этого кода в переменной $taxonomies будет храниться массив с именами зарегистрированных таксономий.

Как получить список только имен таксономий?

Если вам необходимо получить только имена зарегистрированных таксономий, вы можете использовать параметр $output со значением «names». В этом случае функция вернет массив с именами таксономий:


$taxonomies = get_taxonomies(array(), 'names');

В данном примере мы передаем пустой массив в качестве аргумента $args, так как нам не требуется фильтровать таксономии по каким-либо параметрам.

Как получить список только объектов таксономий?

Если вам необходимо получить список объектов таксономий, вы можете использовать параметр $output со значением «objects». В этом случае функция вернет массив с объектами таксономий:


$taxonomies = get_taxonomies(array(), 'objects');

В данном примере мы также передаем пустой массив в качестве аргумента $args, так как нам не требуется фильтровать таксономии по каким-либо параметрам.

Как получить список таксономий с определенными аргументами?

Функция get_taxonomies() позволяет получить список зарегистрированных таксономий в WordPress. Для получения списка таксономий с определенными аргументами, необходимо передать массив $args с нужными параметрами.

Пример кода:


$args = array(
    'public'   => true,
    'show_ui'  => true,
    'show_in_nav_menus' => true,
);
$taxonomies = get_taxonomies( $args, 'names' );

Как получить список таксономий, используя оператор ‘или’?

Для получения списка таксономий с использованием оператора ‘или’, необходимо передать параметр $operator со значением ‘or’.

Пример кода:


$taxonomies = get_taxonomies( array(), 'names', 'or' );

Как получить список таксономий, используя оператор ‘и’?

Для получения списка таксономий с использованием оператора ‘и’, необходимо передать параметр $operator со значением ‘and’.

Пример кода:


$taxonomies = get_taxonomies( array(), 'names', 'and' );

Как получить список таксономий без указания аргументов?

Если необходимо получить список всех зарегистрированных таксономий без указания аргументов, можно вызвать функцию get_taxonomies() без параметров.

Пример кода:


$taxonomies = get_taxonomies();

Функция get_taxonomies() позволяет получить список зарегистрированных таксономий в WordPress. Она предоставляет удобные возможности для фильтрации таксономий с помощью аргументов и операторов. Благодаря этой функции разработчики могут легко получить необходимую информацию о таксономиях и использовать ее в своих проектах.

Связанные элементы

  • Функция register_taxonomy(): регистрирует новую таксономию.
  • Функция get_taxonomy(): возвращает объект таксономии по ее имени.
  • Функция is_taxonomy(): проверяет, является ли указанное имя таксономией.
  • Функция taxonomy_exists(): проверяет, существует ли таксономия с указанным именем.
  • Хук registered_taxonomy: вызывается после успешной регистрации таксономии.
Обсуждение