the_meta()
Affiche une liste des champs personnalisés d'un poste.
Description
La fonction formate les données dans une liste désordonnées. Elle peut être utilisée dans la boucle WordPress ou dans un poste simple (single). Elle ignore les clés des méta-données commençant par un underscore (_).
Pour plus d'informations sur cette fonction, voir les champs personnalisés.
Structure de la fonction the_meta()
Définie dans le fichier wp-includes/post-template.php à la ligne 1091 :
function the_meta() {
_deprecated_function( __FUNCTION__, '6.0.2', 'get_post_meta()' );
$keys = get_post_custom_keys();
if ( $keys ) {
$li_html = '';
foreach ( (array) $keys as $key ) {
$keyt = trim( $key );
if ( is_protected_meta( $keyt, 'post' ) ) {
continue;
}
$values = array_map( 'trim', get_post_custom_values( $key ) );
$value = implode( ', ', $values );
$html = sprintf(
"<li><span class='post-meta-key'>%s</span> %s</li>\n",
/* translators: %s: Post custom field name. */
esc_html( sprintf( _x( '%s:', 'Post custom field name' ), $key ) ),
esc_html( $value )
);
/**
* Filters the HTML output of the li element in the post custom fields list.
*
* @since 2.2.0
*
* @param string $html The HTML output for the li element.
* @param string $key Meta key.
* @param string $value Meta value.
*/
$li_html .= apply_filters( 'the_meta_key', $html, $key, $value );
}
if ( $li_html ) {
echo "<ul class='post-meta'>\n{$li_html}</ul>\n";
}
}
}
Fonctions et Hook utilisés par the_meta()
_x()
Reçoit une chaîne traduite avec son contexte.
apply_filters()
Appel les fonctions qui ont été attaché à un filtre (hook).
the_meta_key
Filtre la sortie HTML des éléments li de la liste des méta-données du poste.
get_post_custom_keys()
Retourne les noms de champ de méta-donnée pour un poste.
get_post_custom_values()
Retourne les valeurs pour un champ personnalisé et un id de poste donnés.
is_protected_meta()
Détermine si une clé de méta-donnée est considérée comme protégée.
Où trouver la fonction the_meta()
dans le CMS Wordpress
Sources
Codex Wordpress : the_meta()
Autres fonctions dans le même fichier : wp-includes/post-template.php