WordPress : champs personnalisés (custom fields)

Gérer les champs personnalisés (custom fields) dans WordPress permet d‘ajouter des données supplémentaires et spécifiques à vos articles, pages ou types de publication personnalisés.

Cela offre une flexibilité accrue pour personnaliser le contenu de votre site sans avoir besoin de créer des types de publication supplémentaires.

Remarque : les champs personnalisés sont stockés dans la table wp_postmeta.

Voici comment gérer les champs personnalisés dans WordPress :

1. Activer les champs personnalisés (custom fields) :
   • Assurez-vous que les champs personnalisés sont activés dans votre interface d’administration de WordPress. Pour ce faire, allez dans l’édition d’un article ou une page, puis cliquez sur l’onglet Options en haut à droite et Préférences > Panneaux. Cochez la case “Champs personnalisés” pour afficher les champs personnalisés lors de l’édition des articles et des pages.
2. Ajouter un champ personnalisé à un article ou une page :
   • Lorsque vous éditez un article ou une page, faites défiler vers le bas jusqu’à la section “Champs personnalisés” (custom fields).
   • Dans la boîte de dialogue qui apparaît, entrez un nom de champ personnalisé (par exemple, “Réalisateur”, etc.) dans le champ “Nom” et la valeur souhaitée dans le champ “Valeur“.
   • Cliquez sur “Ajouter un champ personnalisé” pour enregistrer le champ personnalisé.
3. Afficher les champs personnalisés dans le thème : pour afficher les champs personnalisés dans le thème, vous pouvez utiliser la fonction get_post_meta() pour récupérer les valeurs des champs personnalisés.

Remarque : pour une interface de gestion plus évoluée des champs personnalisés, nous basculerons sur l’extension ACF (Advanced Custom Fields).

Exemple d’affichage d’un champ personnalisé “Réalisateur” dans un fichier de modèle de page (film.php) :

<?php
$auteur = get_post_meta(get_the_ID(), 'Auteur', true);

if ($auteur) {
    echo 'Auteur : ' . $auteur;
}
?>

Dans cet exemple, nous utilisons get_post_meta() pour récupérer la valeur du champ personnalisé “Réalisateur” pour le modèle de page pour le CPT (Custom Post Type) film en cours d’affichage, et nous l’affichons ensuite dans le thème.

Paramètres :

• $post_id (int) : l’ID de la publication pour laquelle vous souhaitez récupérer les valeurs des champs personnalisés. Vous pouvez récupérer l’ID de la publication active grâce à la fonction get_the_ID().
• $key (string) : (optionnel) le nom (clé) du champ personnalisé que vous souhaitez récupérer. Si cette valeur est omise, la fonction renverra un tableau associatif contenant toutes les clés et leurs valeurs pour la publication donnée.
• $single (bool) : (optionnel) détermine si la fonction doit renvoyer une seule valeur (true) ou un tableau de valeurs (false) lorsque plusieurs valeurs sont associées à une même clé. Par défaut, la valeur est false, ce qui signifie que la fonction renverra un tableau de valeurs.

Retour :

• Si $key est spécifié et qu’une seule valeur est associée à la clé dans la base de données, la fonction renverra cette valeur.
• Si $key est spécifié et plusieurs valeurs sont associées à la clé, la fonction renverra un tableau de valeurs.
• Si $key est omis, la fonction renverra un tableau associatif contenant toutes les clés et leurs valeurs pour la publication donnée.

Remarque : get_post_meta() peut être utilisé en dehors e la boucle WordPress.