{"id":234278,"date":"2023-02-27T15:56:00","date_gmt":"2023-02-27T12:56:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=234278"},"modified":"2022-11-12T03:24:42","modified_gmt":"2022-11-12T00:24:42","slug":"codage-pour-les-champs-personnalises-avances-une-introduction","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/codage-pour-les-champs-personnalises-avances-une-introduction\/","title":{"rendered":"Codage pour les champs personnalis\u00e9s avanc\u00e9s\u00a0: une introduction"},"content":{"rendered":"\n

Advanced Custom Fields<\/a> (ACF) est un plugin WordPress qui est un excellent outil pour configurer une m\u00e9ta de publication personnalis\u00e9e. Il vous permet de cr\u00e9er et de configurer facilement des m\u00e9ta-bo\u00eetes complexes et conviviales avec toutes sortes de champs et de param\u00e8tres pour les types de publication, la taxonomie, les \u00e9crans utilisateur et les pages d’options. Et c’est super convivial pour les d\u00e9veloppeurs.<\/p>\n

Maintenant, vous pouvez configurer manuellement vos propres bo\u00eetes m\u00e9ta ou param\u00e8tres, mais pour des param\u00e8tres plus complexes, cela vous oblige \u00e0 coder un peu, y compris le style, Javascript, la validation et la sauvegarde de la gestion. Imaginez par exemple \u00e9crire manuellement un r\u00e9p\u00e9teur avec un groupe de param\u00e8tres, une multi-s\u00e9lection de messages par une certaine requ\u00eate. Ou la gestion de l’affichage des param\u00e8tres qui d\u00e9pendent de certaines variables telles que le terme ou le mod\u00e8le de page attribu\u00e9 (ce qui n\u00e9cessite Javascript). Advanced Custom Fields g\u00e8re tout cela, et il le fait magnifiquement.<\/p>\n

Gardez \u00e0 l’esprit que les champs personnalis\u00e9s avanc\u00e9s ne produiront aucune de vos m\u00e9ta personnalis\u00e9es dans vos mod\u00e8les. La sortie ou l’ex\u00e9cution de quelque chose en fonction des champs et des param\u00e8tres configur\u00e9s avec ACF est \u00e0 vous, en tant que d\u00e9veloppeur, de g\u00e9rer. Mais cela se fait facilement en utilisant l’une des m\u00e9thodes d’ACF. Il est \u00e9galement bon de savoir qu’ACF utilise la m\u00e9ta-fonctionnalit\u00e9 principale de WordPress (publication, terme, utilisateur). Cela signifie qu’il enregistre en fait, par exemple, les param\u00e8tres des publications en tant que post-m\u00e9ta – que vous pouvez obtenir en utilisant des fonctions de base telles que get_post_meta()<\/code>.<\/p>\n

Les champs personnalis\u00e9s avanc\u00e9s sont disponibles en version gratuite<\/a> et en version Pro payante<\/a>. La version gratuite est plus que suffisante pour la plupart des cas, mais dans la version Pro, vous obtenez des fonctionnalit\u00e9s suppl\u00e9mentaires telles qu’un champ de r\u00e9p\u00e9teur, un champ de galerie, des blocs Gutenberg (voir plus loin) et la possibilit\u00e9 d’utiliser ACF pour configurer votre propre administrateur personnalis\u00e9 pages d’options. ACF est \u00e9galement si populaire que vous pouvez facilement trouver des extensions<\/a> de haute qualit\u00e9 pour tout ce que le noyau ACF ne couvre pas lui-m\u00eame.<\/p>\n

Champs personnalis\u00e9s avanc\u00e9s: La partie admin<\/h2>\n

Lorsque vous installez le plug-in Advanced Custom Fields, vous obtenez un nouveau menu d’administration pour "Custom Fields". C’est l\u00e0 que vous pouvez configurer et configurer vos "m\u00e9ta-bo\u00eetes" ou groupes de param\u00e8tres.<\/p>\n

Au sein d’un groupe, vous pouvez configurer autant de champs que vous le souhaitez de diff\u00e9rents types. Les plus courants sont la saisie de texte, la zone de texte, l’\u00e9diteur de texte enrichi, le fichier, l’image, le vrai\/faux (bascule), les cases \u00e0 cocher, les boutons radio et la case de s\u00e9lection. Les autres m\u00e9thodes courantes sont les multiples fa\u00e7ons de choisir les publications, de choisir la taxonomie, de s\u00e9lectionner les utilisateurs, le s\u00e9lecteur de date, le s\u00e9lecteur de couleur, Google Maps et bien d’autres. Selon le type de champ que vous choisissez, vous obtenez une gamme d’options suppl\u00e9mentaires pour personnaliser le champ. Vous pouvez \u00e9galement ajouter une logique conditionnelle \u00e0 n’importe quel champ. La logique conditionnelle permet de masquer ou d’afficher des champs en fonction d’autres options au sein du groupe.<\/p>\n

Pour chaque groupe de param\u00e8tres, vous pouvez d\u00e9finir dans quels cas ces param\u00e8tres doivent appara\u00eetre. Par exemple, lors de la modification de publications, d’un terme de taxonomie ou de la modification d’un utilisateur. Vous pouvez personnaliser davantage la visibilit\u00e9 de vos param\u00e8tres, par exemple sur le type de publication. Ou si un article a un certain terme ou un mod\u00e8le de page qui lui est attribu\u00e9, si un article est par un certain auteur, si le r\u00f4le de l’utilisateur est tel ou tel, le r\u00f4le de l’utilisateur actuellement connect\u00e9 ou si la page est une page parent ou non. Vous pouvez \u00e9galement personnaliser l’endroit o\u00f9 la m\u00e9ta-bo\u00eete doit appara\u00eetre. Cependant, cette fonctionnalit\u00e9 est quelque peu r\u00e9duite maintenant avec le nouvel \u00e9diteur Gutenberg.<\/p>\n

\"Codage<\/a><\/p>\n

Mise en place d’un groupe<\/p>\n

\"Codage<\/a><\/p>\n

Param\u00e8tres pour un seul champ<\/p>\n

Champs personnalis\u00e9s avanc\u00e9s\u00a0: la partie code<\/h2>\n

Examinons la partie la plus int\u00e9ressante\u00a0: comment utiliser les champs personnalis\u00e9s avanc\u00e9s par code. Comme mentionn\u00e9 pr\u00e9c\u00e9demment, ACF est super convivial pour les d\u00e9veloppeurs et offre un large \u00e9ventail de personnalisations.<\/p>\n

Obtenir des valeurs et les afficher dans vos mod\u00e8les se fait facilement en utilisant les m\u00e9thodes d’ACF. Par exemple the_field('your_meta_key')<\/code>pour l’\u00e9cho directement ou get_field('your_meta_key')<\/code>pour le stocker dans une variable PHP. Fournissez l’ID de publication comme deuxi\u00e8me argument si vous devez r\u00e9cup\u00e9rer des donn\u00e9es en dehors de la boucle. Tr\u00e8s facile. Vous pouvez utiliser get_post_meta()<\/code>, mais il est recommand\u00e9 d’utiliser les m\u00e9thodes d’ACF, car ACF peut transformer la valeur en quelque chose de plus significatif avant de vous la renvoyer.<\/p>\n

Une autre chose dont vous devez \u00eatre conscient est l’outil d’exportation d’ACF. Vous pouvez exporter les groupes cr\u00e9\u00e9s dans deux formats\u00a0; soit un fichier JSON t\u00e9l\u00e9chargeable, soit du code PHP pur. Le fichier JSON est utile si vous avez besoin d’exporter des param\u00e8tres entre des serveurs de test et en direct, ou un autre WordPress. L’export en PHP pur vous donne la possibilit\u00e9 de le coller directement dans vos fichiers PHP de th\u00e8me ou de plugin.<\/p>\n

Comme vous pourriez en conclure; vous pouvez utiliser le code PHP, soit en l’\u00e9crivant manuellement, soit en l’exportant apr\u00e8s les avoir configur\u00e9s dans l’administrateur, pour ajouter vos groupes et vos champs. Cela permet plus de contr\u00f4le et des moyens de g\u00e9n\u00e9rer des choix personnalis\u00e9s.<\/p>\n

Mais attendez, il y a plus! ACF propose \u00e9galement un large \u00e9ventail d’actions et de filtres pour personnaliser davantage les champs ou leurs valeurs. Il existe des crochets pour l’enregistrement ou le rendu d’un champ ainsi que des crochets pour enregistrer des groupes par code (mentionn\u00e9s ci-dessus) et des filtres pour personnaliser les valeurs, les param\u00e8tres ou les choix du champ avant l’enregistrement ou avant le rendu. Vous pouvez \u00e9galement sp\u00e9cifier si le filtre doit affecter tous les champs, les champs d’un certain type ou les champs d’une certaine cl\u00e9 m\u00e9ta. Tous les crochets et filtres sont pr\u00e9fix\u00e9s par acf\/<\/code>.<\/p>\n

Consultez la page de documentation d’ACF<\/a>; cliquez sur ‘Fonctions’, ‘Actions’ ou ‘Filtres’ pour un aper\u00e7u. Vous trouverez \u00e9galement d’excellents tutoriels et guides sur ce site.<\/p>\n

Une note sur les champs personnalis\u00e9s avanc\u00e9s et Gutenberg<\/h2>\n

Cr\u00e9er des blocs Gutenberg personnalis\u00e9s est pour le moment assez intimidant. La documentation n’est pas tout \u00e0 fait en place, des modifications y sont souvent apport\u00e9es et le codage n\u00e9cessite pas mal de connaissances en Javascript. De pr\u00e9f\u00e9rence, vous avez besoin de connaissances sur React et comment configurer un compilateur \u00e0 partir de JSX\/ES6 avec webpack et Babel.<\/p>\n

Cependant, dans la version 5.8, ACF Pro a introduit<\/a> une fonctionnalit\u00e9 permettant de configurer un groupe de champs en tant que bloc Gutenberg – vous permettant d’ajouter des blocs personnalis\u00e9s uniquement avec du code ACF et PHP. Aucune connaissance Javascript n\u00e9cessaire !<\/p>\n

Tout ce que vous avez \u00e0 faire est de configurer les groupes en admin ou par code comme d’habitude. Mais ensuite d\u00e9finir leur emplacement comme bloc Gutenberg. Il ne reste plus qu’\u00e0 ajouter du code PHP pour les enregistrer en tant que bloc Gutenberg personnalis\u00e9 avec acf_register_block()<\/code>. Pour cette fonction, vous d\u00e9finissez un rappel vers une fonction PHP ou un fichier de mod\u00e8le responsable du rendu de la sortie du bloc. Vous \u00e9crivez cette fonction ou cette partie de mod\u00e8le enti\u00e8rement en PHP et utilisez des m\u00e9thodes famili\u00e8res telles que get_field()<\/code>l’obtention des valeurs de param\u00e8tre.<\/p>\n

\"Codage<\/a><\/p>\n

A quoi ressemble un bloc ACF dans l’\u00e9diteur Gutenberg<\/p>\n

Restez \u00e0 l’\u00e9coute dans la cat\u00e9gorie Champs personnalis\u00e9s avanc\u00e9s<\/a> pour des tutoriels sur l’utilisation de ce plugin\u00a0!<\/p>\n

Source d’enregistrement: awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"

Ce guide pour les d\u00e9butants examine le plugin WordPress Advanced Custom Fields (ACF) et comment vous, en tant que d\u00e9veloppeur, pouvez l’utiliser.<\/p>\n","protected":false},"author":1,"featured_media":224889,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[915,893,893,717,717,915,1110,811,811,841,841,862,862],"tags":[1167],"class_list":["post-234278","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-autre","category-code-2","category-developpeur","category-n-a","category-plugins-2","category-tutoriels","category-wordpress-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234278","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=234278"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234278\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/224889"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=234278"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=234278"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=234278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}