get_post_custom( int $post_id )
Retourne les clés et valeurs des méta-données d'un poste en passant son id.
Paramètre
$post_id
(int)optionnelId du poste. Par défaut ID de la global $post.
Description / Informations supplémentaires
Les champs de méta sont retournés du cache quand c'est possible, ainsi la fonction est optimisée pour être appelée plusieurs fois.
Retourne
(array) Les méta-données d'un poste.
Déclaration et structure de la fonction get_post_custom()
get_post_custom()
est déclarée dans le fichier wp-includes/post.php
à la ligne 2706 :
function get_post_custom( $post_id = 0 ) {
$post_id = absint( $post_id );
if ( ! $post_id ) {
$post_id = get_the_ID();
}
return get_post_meta( $post_id );
}
Fonctions utilisées par get_post_custom()
absint()
Convertit une valeur en entier positif (valeur absolue).
get_the_id()
Retourne l'id de l'item actuel dans la loop WordPress.
get_post_meta()
Retourne la valeur d'un champ de méta-donnée pour un id de poste donné.
Où est utilisée la fonction get_post_custom()
dans le CMS WordPress
Exemple
$custom_fields = get_post_custom(72);
$my_custom_field = $custom_fields['my_custom_field'];
foreach ( $my_custom_field as $key => $value ) {
echo $key . " => " . $value . "<br />";
}
Sources
Codex WordPress : get_post_custom()
Autres fonctions dans le même fichier : wp-includes/post.php