Actualités WEB et WordPress, thèmes, plugins. Ici, nous partageons des conseils et les meilleures solutions de sites Web.

Codage pour les champs personnalisés avancés : une introduction

44

Advanced Custom Fields (ACF) est un plugin WordPress qui est un excellent outil pour configurer une méta de publication personnalisée. Il vous permet de créer et de configurer facilement des méta-boîtes complexes et conviviales avec toutes sortes de champs et de paramètres pour les types de publication, la taxonomie, les écrans utilisateur et les pages d’options. Et c’est super convivial pour les développeurs.

Maintenant, vous pouvez configurer manuellement vos propres boîtes méta ou paramètres, mais pour des paramètres plus complexes, cela vous oblige à coder un peu, y compris le style, Javascript, la validation et la sauvegarde de la gestion. Imaginez par exemple écrire manuellement un répéteur avec un groupe de paramètres, une multi-sélection de messages par une certaine requête. Ou la gestion de l’affichage des paramètres qui dépendent de certaines variables telles que le terme ou le modèle de page attribué (ce qui nécessite Javascript). Advanced Custom Fields gère tout cela, et il le fait magnifiquement.

Gardez à l’esprit que les champs personnalisés avancés ne produiront aucune de vos méta personnalisées dans vos modèles. La sortie ou l’exécution de quelque chose en fonction des champs et des paramètres configurés avec ACF est à vous, en tant que développeur, de gérer. Mais cela se fait facilement en utilisant l’une des méthodes d’ACF. Il est également bon de savoir qu’ACF utilise la méta-fonctionnalité principale de WordPress (publication, terme, utilisateur). Cela signifie qu’il enregistre en fait, par exemple, les paramètres des publications en tant que post-méta – que vous pouvez obtenir en utilisant des fonctions de base telles que get_post_meta().

Les champs personnalisés avancés sont disponibles en version gratuite et en version Pro payante. La version gratuite est plus que suffisante pour la plupart des cas, mais dans la version Pro, vous obtenez des fonctionnalités supplémentaires telles qu’un champ de répéteur, un champ de galerie, des blocs Gutenberg (voir plus loin) et la possibilité d’utiliser ACF pour configurer votre propre administrateur personnalisé pages d’options. ACF est également si populaire que vous pouvez facilement trouver des extensions de haute qualité pour tout ce que le noyau ACF ne couvre pas lui-même.

Champs personnalisés avancés: La partie admin

Lorsque vous installez le plug-in Advanced Custom Fields, vous obtenez un nouveau menu d’administration pour "Custom Fields". C’est là que vous pouvez configurer et configurer vos "méta-boîtes" ou groupes de paramètres.

Au sein d’un groupe, vous pouvez configurer autant de champs que vous le souhaitez de différents types. Les plus courants sont la saisie de texte, la zone de texte, l’éditeur de texte enrichi, le fichier, l’image, le vrai/faux (bascule), les cases à cocher, les boutons radio et la case de sélection. Les autres méthodes courantes sont les multiples façons de choisir les publications, de choisir la taxonomie, de sélectionner les utilisateurs, le sélecteur de date, le sélecteur de couleur, Google Maps et bien d’autres. Selon le type de champ que vous choisissez, vous obtenez une gamme d’options supplémentaires pour personnaliser le champ. Vous pouvez également ajouter une logique conditionnelle à n’importe quel champ. La logique conditionnelle permet de masquer ou d’afficher des champs en fonction d’autres options au sein du groupe.

Pour chaque groupe de paramètres, vous pouvez définir dans quels cas ces paramètres doivent apparaître. 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é de vos paramètres, par exemple sur le type de publication. Ou si un article a un certain terme ou un modèle de page qui lui est attribué, si un article est par un certain auteur, si le rôle de l’utilisateur est tel ou tel, le rôle de l’utilisateur actuellement connecté ou si la page est une page parent ou non. Vous pouvez également personnaliser l’endroit où la méta-boîte doit apparaître. Cependant, cette fonctionnalité est quelque peu réduite maintenant avec le nouvel éditeur Gutenberg.

Codage pour les champs personnalisés avancés : une introduction

Mise en place d’un groupe

Codage pour les champs personnalisés avancés : une introduction

Paramètres pour un seul champ

Champs personnalisés avancés : la partie code

Examinons la partie la plus intéressante : comment utiliser les champs personnalisés avancés par code. Comme mentionné précédemment, ACF est super convivial pour les développeurs et offre un large éventail de personnalisations.

Obtenir des valeurs et les afficher dans vos modèles se fait facilement en utilisant les méthodes d’ACF. Par exemple the_field('your_meta_key')pour l’écho directement ou get_field('your_meta_key')pour le stocker dans une variable PHP. Fournissez l’ID de publication comme deuxième argument si vous devez récupérer des données en dehors de la boucle. Très facile. Vous pouvez utiliser get_post_meta(), mais il est recommandé d’utiliser les méthodes d’ACF, car ACF peut transformer la valeur en quelque chose de plus significatif avant de vous la renvoyer.

Une autre chose dont vous devez être conscient est l’outil d’exportation d’ACF. Vous pouvez exporter les groupes créés dans deux formats ; soit un fichier JSON téléchargeable, soit du code PHP pur. Le fichier JSON est utile si vous avez besoin d’exporter des paramètres entre des serveurs de test et en direct, ou un autre WordPress. L’export en PHP pur vous donne la possibilité de le coller directement dans vos fichiers PHP de thème ou de plugin.

Comme vous pourriez en conclure; vous pouvez utiliser le code PHP, soit en l’écrivant manuellement, soit en l’exportant après les avoir configurés dans l’administrateur, pour ajouter vos groupes et vos champs. Cela permet plus de contrôle et des moyens de générer des choix personnalisés.

Mais attendez, il y a plus! ACF propose également un large éventail 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és ci-dessus) et des filtres pour personnaliser les valeurs, les paramètres ou les choix du champ avant l’enregistrement ou avant le rendu. Vous pouvez également spécifier si le filtre doit affecter tous les champs, les champs d’un certain type ou les champs d’une certaine clé méta. Tous les crochets et filtres sont préfixés par acf/.

Consultez la page de documentation d’ACF; cliquez sur ‘Fonctions’, ‘Actions’ ou ‘Filtres’ pour un aperçu. Vous trouverez également d’excellents tutoriels et guides sur ce site.

Une note sur les champs personnalisés avancés et Gutenberg

Créer des blocs Gutenberg personnalisés est pour le moment assez intimidant. La documentation n’est pas tout à fait en place, des modifications y sont souvent apportées et le codage nécessite pas mal de connaissances en Javascript. De préférence, vous avez besoin de connaissances sur React et comment configurer un compilateur à partir de JSX/ES6 avec webpack et Babel.

Cependant, dans la version 5.8, ACF Pro a introduit une fonctionnalité permettant de configurer un groupe de champs en tant que bloc Gutenberg – vous permettant d’ajouter des blocs personnalisés uniquement avec du code ACF et PHP. Aucune connaissance Javascript nécessaire !

Tout ce que vous avez à faire est de configurer les groupes en admin ou par code comme d’habitude. Mais ensuite définir leur emplacement comme bloc Gutenberg. Il ne reste plus qu’à ajouter du code PHP pour les enregistrer en tant que bloc Gutenberg personnalisé avec acf_register_block(). Pour cette fonction, vous définissez un rappel vers une fonction PHP ou un fichier de modèle responsable du rendu de la sortie du bloc. Vous écrivez cette fonction ou cette partie de modèle entièrement en PHP et utilisez des méthodes familières telles que get_field()l’obtention des valeurs de paramètre.

Codage pour les champs personnalisés avancés : une introduction

A quoi ressemble un bloc ACF dans l’éditeur Gutenberg

Restez à l’écoute dans la catégorie Champs personnalisés avancés pour des tutoriels sur l’utilisation de ce plugin !

Source d’enregistrement: awhitepixel.com

This website uses cookies to improve your experience. We'll assume you're ok with this, but you can opt-out if you wish. Accept Read More