Campo de Checkboxes

O campo de checkboxes cria uma lista de opções selecionáveis. Útil para escolher categorias ou informações que podem possuir multiplicidade.

acf checkbox

Campos adicionais deste tipo de campo

  • Escolhas: Aqui você vai popular a lista de valores selecionáveis. Cada item desta lista deverá estar em uma linha,  e deverá ser preenchido no formato ‘valor : label’. Se você escrever apenas um item sem os dois pontos os separando, o mesmo nome será o label e o value deste select;
  • Layout: Como será visualmente apresentada, modo vertical ou horizontal.

Como utilizar este campo em um template WP?

A API retorna diferentes dados para estas funções:

  • get_field: um array de valores
  • the_field: uma string contendo todos os valores separados por vírgulas
<?php

/*
*  Exibindo valor único
*/

?>
<p>Cor: <?php the_field('field_name'); ?></p>
<?php

/*
*  Exibindo o label de um valor único
*/

$field = get_field_object('field_name');
$value = get_field('field_name');
$label = $field['choices'][ $value ];

?>
<p>Color: <?php echo $label; ?></p>
<?php

/*
*  Exibindo múltiplos valores
*/

?>
<p>Cores: <?php echo implode(', ', get_field('field_name')); ?></p>
<?php

/*
*  Condicional
*/

if( in_array( 'red', get_field('field_name') ) )
{
    //...
}

/*
*  Listando apenas os resultados com um determinado valor
*/

$posts = get_posts(array(
    'meta_query' => array(
        array(
            'key' => 'field_name', // nome do custom field
            'value' => '"red"',
            'compare' => 'LIKE'
        )
    )
));

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

?>

 

Posts Similares

  • have_rows()

    have_rows()

    Esta função verifica se o campo (repetidor ou conteúdo flexível) tem quaisquer linhas de dados para executar um loop. Esta é uma função booleana, ou seja, ele retorna VERDADEIRO ou FALSO. Esta função é uma substituição para a função has_sub_field, no entanto, tem algumas diferenças pequenas mas significativas. A principal diferença é que esta função não…

  • Shortcode do ACF

    Shortcode do ACF

    O Shortcode do ACF pode ser utilizado em sua postagem para exibir o valor de um campo personalizado simples, como o de texto. Se você não sabe o que é um shortcode, recomendamos a leitura da documentação oficial do WordPress, no Codex. Requisitos ACF v3.1.1 ou superior Como Utilizar Place the shortcode marker with the desired field within your…

  • Campo de Upload de Arquivo

    O campo de Upload de arquivo permite que um arquivo seja selecionado e enviada para o servidor, utilizando a API nativa do WordPress para upload, o plupload. Campos adicionais deste tipo de campo Valor Retornado: Define o tipo de retorno dos dados. Você pode escolher entre Objeto (array de dados), URL do arquivo (string), ou ID do arquivo (int); Biblioteca:…

  • Campo Verdadeiro ou Falso (booleano)

    O campo Verdadeiro ou Falso cria um seletor com estas duas opções, onde 1 é verdadeiro e 0 é falso. Campos adicionais deste tipo de campo Mensagem: Texto descritivo exibido perto do checkbox. Valor padrão: você pode definir se o valor padrão será verdadeiro ou falso. Como utilizar este campo em um template WP? A API…

  • the_field()

    the_field()

    Imprime o valor do campo especificado, da mesma forma que um “echo get_field($field_name)” faria, mas simplificando isso 🙂 Parâmetros $field_name: nome do campo a ser retornado. Exemplo: “page_content” (obrigatório) $post_id: Especifica o ID do post  onde o seu valor foi digitado. O padrão é pegar o do post atual, do loop que você está. Você também pode…

  • Campo Seletor de Datas (Date Picker)

    O campo seletor de datas (date picker) cria um seletor jQuery de datas. Este campo é muito útil quando temos postagens que precisam exibir uma data diferente da data de publicação, como a data de início e fim de um determinado evento. Campos adicionais deste tipo de campo Formato dos dados: A string que representa a…

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *