Como usar get_field() do Plugin Advanced Custom Fields?

O valor get_field() retorna o valor de um campo específico.

Essa função pode ser usada para carregar o valor de qualquer campo de qualquer local.

Observe que cada tipo de campo retorna diferentes formas de dados (string, int, array, etc).

Parâmetros

get_field($selector, [$post_id], [$format_value]);

• $selector (string) (Obrigatório) O nome do campo ou a chave do campo.
• $post_id (mixed) (Opcional) O ID da postagem em que o valor é salvo. O padrão é a postagem atual.
• $format_value (bool) (Opcional) Se deve aplicar a lógica de formatação. O padrão é true.

Retorna

(misto) O valor do campo.

Exemplos

Obter um valor da postagem atual

Este exemplo mostra como carregar o valor do campo “text_field” da postagem atual.

$value = get_field( "text_field" );

Obter um valor de uma postagem específica

Este exemplo mostra como carregar o valor do campo “campo_de_texto” da postagem com o ID = 123.

$value = get_field( "text_field", 123 );

Verifique se o valor existe

Este exemplo mostra como verificar se existe um valor para um campo.

$value = get_field( "text_field" );

if( $value ) {
    echo $value;
} else {
    echo 'empty';
}

Obter um valor de diferentes objetos

Este exemplo mostra uma variedade de valores de $post_id para obter um valor de uma postagem, usuário, termo e opção.

$post_id = false; // current post
$post_id = 1; // post ID = 1
$post_id = "user_2"; // user ID = 2
$post_id = "category_3"; // category term ID = 3
$post_id = "event_4"; // event (taxonomia customizada) term ID = 4
$post_id = "option"; // página de opções
$post_id = "options"; // o mesmo que acima

$value = get_field( 'my_field', $post_id );

Obter um valor sem formatação

Neste exemplo, o campo “image” é um campo de imagem que normalmente retornaria um objeto de imagem. No entanto, passando false como um terceiro parâmetro para a função get_field, o valor nunca é formatado e retornado como no banco de dados.

Observe que o segundo parâmetro está definido como false para direcionar a postagem atual.