Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

fr:Fonction get post meta

Description

Cette fonction retourne les valeurs des champs personnalisés avec la clé spécifiée de l'article défini. Il s'agit d'un conteneur pour get_metadata('post'). Pour retourner tous les champs personnalisés, voir get_post_custom(). Voir aussi update_post_meta(), delete_post_meta() et add_post_meta().

Utilisation

<?php $meta_values get_post_meta$post_id$key$single ); ?>

Paramètres

$post_id
(integer) (required) L'ID de l'article dont vous souhaitez extraire les données. Utilisez get_the_ID() ou la variable globale $post pour récupérer l'ID de l'objet (ex: $post->ID) alors que dans La Boucle pour récupérer l'ID de l'article vous pouvez utiliser get_the_ID() (ex: get_the_ID()). (Note: Quand vous utilisez une page pour afficher vos articles sur la page d'accueil (option définir dans Paramètres -> Lecture), get_the_ID() et $post->ID récupèrerons l'ID du dernier article. Pour récupérer l'ID de la page, vous devrez utiliser get_queried_object_id().)
Default: None
$key
(string) (optionnel) Chaîne contenant le nom du champs à récupérer.
Default: None
$single
(bool) (optionnel) Si défini à "true" la function retournera la valeur du champs, comme une chaîne. Si défini à "false", ou si le paramètre n'est pas renseigné, la fonction retournera un tableau array des champs personnalisés. Cela peut ne pas être très explicite dans le cas des chaînes sérialisées.Si vous récupérez un tableau sérialisé avec cette méthode, vous devrez définir $single à "true" pour réellement obtenir un tableau dé-sérialisé. Si vous le passez à "false", ou si vous le laissez vide, vous aurez un tableau d'un, et la valeur à l'indice 0 sera la chaîne sérialisée.
Default: false

Valeur(s) de retour

  • Si $id uniquement est renseigné la fonction retournera toutes les valeurs meta dans une chaine associative.
  • Si $single est défini à false, ou laissé vide, la fonction retournera une chaine contenant toutes les valeur de la clé spécifiée.
  • Si $single est défini à true, la fonction retournera la 1ere valeur de la clé spécifiée (pas une chaine)

Si la fonction n'a rien à retourner alors une tableau vide de type array sera retournée sauf si $single est défini à true, dans ce cas une chaine vide sera retournée.

Exemples

Utilisation par défaut

Récupérer toutes les meta pour toutes les clés:

<?php $meta = get_post_meta( get_the_ID() ); ?>

Récupérer la meta pour une clé:

<?php $key_1_values = get_post_meta( 76, 'key_1' ); ?>

Change Log

  • Depuis: 1.5.0

Code Source

get_post_meta() est situé dans in wp-includes/post.php

Functions Similaires

Custom Fields: the_meta(), get_post_meta(), add_post_meta(), update_post_meta(), delete_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys() (See Also: post_meta Function Examples)

See also index of Function Reference and index of Template Tags.