Description
Retorna as configurações de um campo específico.
Cada campo contém muitas configurações, tais como uma etiqueta, nome e tipo. Esta função pode ser usada para carregar estas configurações como um array junto com o valor do campo.
Parâmetros
get_field_object($selector, , , );
-
$selector
(string) (Obrigatório) O nome do campo ou chave de campo. -
$post_id
(misto) (Opcional) O ID do post onde o valor é salvo. O valor padrão para o post atual. -
$format_value
(bool) (Opcional) Se aplicar a lógica de formatação. O padrão para true. -
$load_value
(bool) (Opcional) Se carregar o valor do campo. Predefinições para true.
Return
(array) Esta função irá retornar um array parecido com o seguinte. Note que cada campo contém configurações únicas.
array( 'ID' => 0, 'key' => '', 'label' => '', 'name' => '', 'prefix' => '', 'type' => 'text', 'value' => null, 'menu_order' => 0, 'instructions' => '', 'required' => 0, 'id' => '', 'class' => '', 'conditional_logic' => 0, 'parent' => 0, 'wrapper' => array( 'width' => '', 'class' => '', 'id' => '' ));
Exemplos
Exibir etiqueta e valor de um campo
Este exemplo mostra como carregar um campo e exibir sua etiqueta e valor.
<?php$field = get_field_object('my_field');?><p><?php echo $field; ?>: <?php echo $field; ?></p>
Exibir etiqueta e valor de um post específico
Este exemplo mostra como carregar um campo e exibir sua etiqueta e valor do post com ID = 123.
<?php$field = get_field_object('my_field', 123);?><p><?php echo $field; ?>: <?php echo $field; ?></p>
Retrie um campo usando sua chave
Em algumas circunstâncias pode ser necessário carregar um campo pela sua chave, como quando um valor ainda não foi salvo. Este exemplo mostra como carregar um campo usando sua chave.
<?php$field = get_field_object('field_123456');?>
Exibir dados específicos do tipo de campo
Alguns tipos de campo armazenam dados extras, como o campo Select. Este exemplo mostra como fazer loop sobre as escolhas de um campo Select e exibi-las em uma lista.
<?php$field = get_field_object('my_select');if( $field ): ?> <ul> <?php foreach( $field as $value => $label ): ?> <li><?php echo $label; ?></li> <?php endforeach; ?> </ul><?php endif; ?>