ACF - Таксономия (Taxonomy)

Описание

Поле «Таксономия» позволяет выбрать один или несколько терминов таксономии.

Скриншоты

Поле «Таксономия» позволяет выбрать один или несколько терминов таксономии.

История изменений

Разделили настройку 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.

Таксономия (Taxonomy)