Description
Retourne les paramètres d’un champ spécifique.
Chaque champ contient de nombreux paramètres tels qu’une étiquette, un nom et un type. Cette fonction peut être utilisée pour charger ces paramètres sous forme de tableau avec la valeur du champ.
Paramètres
get_field_object($selector, , , );-
$selector(string) (obligatoire) Le nom du champ ou la clé du champ. -
$post_id(mixed) (facultatif) L’ID du post où la valeur est enregistrée. La valeur par défaut est le poste actuel. -
$format_value(bool) (Facultatif) Si l’on veut appliquer une logique de formatage. La valeur par défaut est true. -
$load_value(bool) (Facultatif) Si la valeur du champ doit être chargée. La valeur par défaut est true.
Return
(array) Cette fonction retournera un tableau ressemblant à ce qui suit. Veuillez noter que chaque champ contient des paramètres uniques.
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' => '' ));Exemples
Afficher l’étiquette et la valeur d’un champ
Cet exemple montre comment charger un champ et afficher son étiquette et sa valeur.
<?php$field = get_field_object('my_field');?><p><?php echo $field; ?>: <?php echo $field; ?></p>Afficher l’étiquette et la valeur d’un champ à partir d’un post spécifique
Cet exemple montre comment charger un champ et afficher son étiquette et sa valeur à partir du post avec ID = 123.
<?php$field = get_field_object('my_field', 123);?><p><?php echo $field; ?>: <?php echo $field; ?></p>Retrouver un champ en utilisant sa clé
Dans certaines circonstances, il peut être nécessaire de charger un champ par sa clé, par exemple lorsqu’une valeur n’a pas encore été enregistrée.Cet exemple montre comment charger un champ en utilisant sa clé.
<?php$field = get_field_object('field_123456');?>Afficher des données spécifiques au type de champ
Certains types de champ stockent des données supplémentaires, comme le champ Select. Cet exemple montre comment boucler sur les choix d’un champ Select et les afficher dans une liste.
<?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; ?>