Обзор
Поле «Группа кнопок» добавляет удобный интерфейс для выбора значений.
Скриншоты
История изменений
- Добавлено в версии 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 ) {
//...
}
?>