get_post_custom_values( string $key = '', int $post_id )
Retourne les valeurs pour un champ personnalisé et un id de poste donnés.
Paramètres
$key(string)optionnelClé de la méta-donné.
Valeur par défaut : ''
$post_id(int)optionnelId du poste. Par défaut id de la global $post.
Description / Informations supplémentaires
Les paramètres de cette fonction ne doivent pas être considérés comme optionnels. Tous les champs personnalisés seront reçus et seulement les valeurs de la clé donnée seront retournées.
Retourne
(array|null) Les valeurs du champ de la méta-donnée.
Déclaration et structure de la fonction get_post_custom_values()
get_post_custom_values() est déclarée dans le fichier wp-includes/post.php à la ligne 2751 :
function get_post_custom_values( $key = '', $post_id = 0 ) {
if ( ! $key ) {
return null;
}
$custom = get_post_custom( $post_id );
return isset( $custom[ $key ] ) ? $custom[ $key ] : null;
}
Fonction utilisée par get_post_custom_values()
get_post_custom()Retourne les clés et valeurs des méta-données d'un poste en passant son id.
Où est utilisée la fonction get_post_custom_values()
dans le CMS WordPress
Exemple
$mykey_values = get_post_custom_values( 'my_key' );
foreach ( $mykey_values as $key => $value ) {
echo "$key => $value ( 'my_key' )<br />";
}
Sources
Codex WordPress : get_post_custom_values()
Autres fonctions dans le même fichier : wp-includes/post.php