Описание
Поле «Таксономия» позволяет выбрать один или несколько терминов таксономии.
Скриншоты
История изменений
- Разделили настройку
load_save_terms
наload_terms
иsave_terms
в версии 5.2.7. Создание терминов
добавлено в версии 5.2.3.
Настройки
- Таксономия. Выбирает таксономию, из которой вы хотите выбрать термин(ы).
- Внешний вид. Выбирает тип отображаемого интерфейса (флажок, множественный выбор, переключатели, выбор).
- Разрешить null. Позволяет сохранить пустое значение. По-умолчанию false.
- Создание терминов. Позволяет создавать новые термины во время редактирования.
- Сохранение терминов. Соединяет выбранные термины с объектом публикации.
- Загрузить термины. Загружает выбранные термины из объекта сообщения.
- Возвращаемое значение. Задает формат возвращаемых данных. Можно выбрать
объект термина
(WP_Term) илиID термина
(int).
Использование в шаблоне
Поле Таксономия вернет одно или несколько значений (объектов или id) в зависимости от настройки возвращаемого значения. Ниже приведены несколько примеров того, как вы можете использовать эти данные.
Вывести значение (выбрано 1 значение)
В этом примере показано, как получить и отобразить один объект термина. Такая ситуация возможно когда внешний вид выбран как переключатель или выбор.
<?php
$term = get_field('taxonomy_field_name');
if( $term ): ?>
<h2><?php echo esc_html( $term->name ); ?></h2>
<p><?php echo esc_html( $term->description ); ?></p>
<?php endif; ?>
Вывести значение (выбрано несколько значений)
В этом примере показано, как получить и перебрать несколько выбранных объектов терминов. акая ситуация возможно когда внешний вид выбран как флажок или множественный выбор.
<?php
$terms = get_field('taxonomy_field_name');
if( $terms ): ?>
<ul>
<?php foreach( $terms as $term ): ?>
<li>
<h2><?php echo esc_html( $term->name ); ?></h2>
<p><?php echo esc_html( $term->description ); ?></p>
<a href="<?php echo esc_url( get_term_link( $term ) ); ?>">View all '<?php echo esc_html( $term->name ); ?>' posts</a>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
Вывести значение из конкретной термы
Плагин Advanced Custom Fields можно использовать для добавления пользовательских полей в термины таксономии. Основываясь на этом, в следующих примерах показано, как загрузить значение настраиваемого поля из выбранного значения термина.
<?php
$term = get_field('taxonomy_field_name');
if( $term ): ?>
<h2>Term name: <?php echo esc_html( $term->name ); ?></h2>
<p>Term color: <?php the_field('color', $term); ?></p>
<?php endif; ?>
Примечания
Настройка аргументов запроса
Аргументы запроса, используемые для поиска и отображения терминов таксономии, можно настроить с помощью одного из следующих фильтров в зависимости от настройки внешнего вида вашего поля таксономии.
Для флажка или множественного выбора используйте фильтр acf/fields/taxonomy/query.
Для переключателя или выбора используйте фильтр acf/fields/taxonomy/wp_list_categories.
Настройка текста
Текст, отображаемый для каждого термина таксономии, можно настроить с помощью фильтра acf/fields/taxonomy/result.