Купить

Группа кнопок (Button Group)

Обзор

Поле «Группа кнопок» добавляет удобный интерфейс для выбора значений.

Скриншоты

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

  • Добавлено в версии 5.6.3

Настройки

ИмяОписание
ВариантыКаждый вариант должен начинаться с новой строки (к примеру, «Красный»). Для большего контроля значения и ярлыка используйте символ «:» (к примеру, red : Красный). Вы можете добавлять HTML иконки, как показано на скриншотах выше.
Разрешить пусто значение?Разрешает пустое значение для этого поля.
Значение по умолчаниюУстанавливает значение поля при первом редактировании. Нужно указывать именно значение (не ярлык).
БлокПозволяет выбрать тип отображения для поля: горизонтальный или вертикальный.
Возвращаемое значениеПозволяет настроить вид возвращаемого значения для функции get_field() и похожих функций.

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

Поле «Группа кнопок» возвращает значение, ярлык или оба (в виде массива со значением и ярлыком), выбранном в настройке Возвращаемое значение.

Базовое

Пример показывает, как вывести значение, используя тип Возвращаемого значения, установленный в «Значение».

<p>Цвет: <?php the_field('color'); ?></p>

Вывод значения и ярлыка

Пример показывает, как использовать значения, используя тип Возвращаемого значения, установленный в «Оба (массив)».

<?php

// переменная
$color = get_field('color');

?>
<p>Цвет: <span class="color-<?php echo $color['value']; ?>"><?php echo $color['label']; ?></span></p>

Условный оператор

Пример показывает, как использовать значение поля для проверки на условие.

<?php if( get_field('color') == 'red' ): ?>
	<p>Выбран красный цвет!</p>
<?php endif; ?>

Query posts

Пример показывает, как сделать выборку из query posts по значению «red».

<?php

$posts = get_posts(array(
    'meta_query' => array(
        array(
            'key' => 'color', // имя произвольного поля
            'value' => 'red',
        )
    )
));

if( $posts ) {
    //...
}

?>