{"id":234260,"date":"2023-02-23T17:22:00","date_gmt":"2023-02-23T14:22:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=234260"},"modified":"2022-11-12T02:37:24","modified_gmt":"2022-11-11T23:37:24","slug":"reference-complete-pour-lajout-de-groupes-de-champs-personnalises-avances-et-de-champs-par-code","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/reference-complete-pour-lajout-de-groupes-de-champs-personnalises-avances-et-de-champs-par-code\/","title":{"rendered":"R\u00e9f\u00e9rence compl\u00e8te pour l’ajout de groupes de champs personnalis\u00e9s avanc\u00e9s et de champs par code"},"content":{"rendered":"\n

Le plugin Advanced Custom Fields<\/a> (ACF) prend enti\u00e8rement en charge la configuration des champs et des groupes par code PHP dans votre th\u00e8me ou plugin. L’avantage de cela est que tous vos champs seront disponibles quelle que soit l’instance WordPress sur laquelle vous travaillez (par exemple, si vous devez basculer entre le serveur local, le serveur de test et le serveur en direct). Vous pouvez configurer tous les champs dans l’administrateur d’ACF et utiliser l’outil d’exportation pour l’exporter vers PHP.<\/p>\n

\"R\u00e9f\u00e9rence<\/a><\/p>\n

Cependant, si vous le faites fr\u00e9quemment, vous remarquerez peut-\u00eatre que l’exportation PHP d’ACF contient beaucoup de code, ce qui rend vos fichiers PHP inutilement longs. Dans certains cas, il est pr\u00e9f\u00e9rable d’\u00e9crire le code vous-m\u00eame, avec le strict minimum n\u00e9cessaire, pour un code plus propre dans votre th\u00e8me ou plugin. Ce guide vise \u00e0 vous fournir une r\u00e9f\u00e9rence compl\u00e8te sur la fa\u00e7on d’\u00e9crire manuellement l’ajout de champs et de groupes ACF en PHP. Veuillez noter qu’il n’entrera pas dans les d\u00e9tails de chaque type de champ car il suppose que vous \u00eates d\u00e9j\u00e0 familiaris\u00e9 avec les diff\u00e9rents champs possibles dans ACF.<\/p>\n

Mais d’abord; quelques pr\u00e9cautions<\/h2>\n

Pour maintenir de bonnes normes de code et vous assurer que votre site WordPress ne plantera pas, vous devez toujours v\u00e9rifier si les fonctions ou les classes que votre code utilise existent r\u00e9ellement. Surtout quand il s’agit de plugins qui peuvent \u00eatre facilement d\u00e9sactiv\u00e9s ou m\u00eame pas install\u00e9s sur un site, vous devez toujours envelopper votre code sp\u00e9cifique au plugin dans un test if qui v\u00e9rifie si les fonctions que vous utilisez existent, avant de les utiliser.<\/p>\n

Quant \u00e0 ACF, vous pouvez le faire en v\u00e9rifiant si la classe 'acf'<\/code>existe ou si la fonction d’ajout de champs et de groupes, 'acf_add_local_field_group'<\/code>, existe. Enveloppez l’un ou l’autre de ceux autour du code ci-dessous.<\/p>\n

if (function_exists('acf_add_local_field_group')) {\n    \/\/ Your ACF specific code here\n}\n\/\/ OR:\nif (class_exists('acf')) {\n    \/\/ Your ACF specific code here\n}<\/code><\/pre>\n
Code squelette<\/h2>\n
Pour ajouter des bo\u00eetes m\u00e9ta (groupes) et des champs, nous utilisons le crochet nomm\u00e9 acf\/init<\/code>. A l’int\u00e9rieur de la fonction, nous appelons la fonction acf_add_local_field_group()<\/code>avec un tableau comme param\u00e8tre. \u00c0 l’int\u00e9rieur de ce tableau se trouve la configuration compl\u00e8te du groupe et de tous ses champs. Les plus importantes sont les cl\u00e9s de tableau 'fields'<\/code>et 'location'<\/code>. Pour la cl\u00e9 de tableau, 'fields'<\/code>vous fournissez le tableau pour tous les champs, et pour la cl\u00e9 'location'<\/code>, vous fournissez les param\u00e8tres de l’endroit o\u00f9 la m\u00e9tabox doit appara\u00eetre. Cet article d\u00e9taillera les options possibles que vous avez pour chacun de ces \u00e9l\u00e9ments ci-dessous.<\/p>\n
C’est le strict minimum pour ajouter un groupe, mis \u00e0 part les champs et l’emplacement\u00a0:<\/p>\n
add_action('acf\/init', function() {\n    acf_add_local_field_group([\n        'key' => 'group_my_fields',\n        'title' => __('My fields', 'txtdomain'),\n        'label_placement' => 'top',\n        'menu_order' => 0,\n        'style' => 'default',\n        'position' => 'normal',\n        'fields' => [],\n        'location' => [],\n    ]);\n});<\/code><\/pre>\n
Chaque groupe a besoin d’une cl\u00e9 unique, mais le nom lui-m\u00eame n’a pas beaucoup d’importance (pour nous). Si vous ajoutez d’autres groupes, n’oubliez pas de modifier le 'key'<\/code>champ. Le titre de la m\u00e9tabox peut \u00eatre d\u00e9fini dans l’\u00e9l\u00e9ment cl\u00e9 du tableau, vous l’avez devin\u00e9, 'title'<\/code>. Si vous ajoutez plusieurs m\u00e9taboxes au m\u00eame emplacement (par exemple en post-\u00e9dition), vous pouvez contr\u00f4ler laquelle vient en premier en fournissant des num\u00e9ros diff\u00e9rents dans 'menu_order'<\/code>.<\/p>\n
Vous pouvez contr\u00f4ler la conception de la m\u00e9tabox en fournissant soit default<\/code>eller seamless<\/code>dans 'style'<\/code>. Cependant, avec le nouvel \u00e9diteur Gutenberg, cela a beaucoup moins d’importance. Il en va de m\u00eame pour la cl\u00e9 'position'<\/code>o\u00f9, autrefois, vous pouviez positionner la m\u00e9tabox sous le contenu du message ('normal'<\/code>), sur le c\u00f4t\u00e9 ('side'<\/code>) ou juste apr\u00e8s le titre du message ('acf_after_title'<\/code>).<\/p>\n
Tr\u00e8s bien! Plongeons-nous dans les deux \u00e9l\u00e9ments les plus int\u00e9ressants du tableau\u00a0; en commen\u00e7ant par l’emplacement – qui d\u00e9finit o\u00f9 la m\u00e9tabox appara\u00eet.<\/p>\n
Emplacement<\/h2>\n
Tout d\u00e9pend de ce que vous mettez dans la cl\u00e9 'location'<\/code>. Mais avant d’examiner les options possibles, nous devons comprendre sa structure de tableau.<\/p>\n
'location'<\/code>accepte un tableau avec un tableau d’\u00e9l\u00e9ments dans un tableau\u00a0! Tenir bon. Oui, car il est possible de fournir et de combiner la logique ET et OU \u00e0 l’emplacement (par exemple "afficher dans la publication mais pas si le type de publication est ‘livre’", ou "afficher dans l’\u00e9cran d’\u00e9dition de l’utilisateur et \u00e9galement cr\u00e9er un nouvel \u00e9cran utilisateur mais pour les deux cas pas si le r\u00f4le actuel est auteur"). La fa\u00e7on dont vous signifiez s’il s’agit d’un ET ou d’un OU consiste \u00e0 structurer les tableaux. C’est beaucoup plus facile \u00e0 montrer qu’\u00e0 expliquer avec des mots\u00a0:<\/p>\n
Voici comment vous combinez deux \u00e9l\u00e9ments de localisation avec la logique ET (les deux doivent \u00eatre vrais) :<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ],\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
Et c’est pour combiner des emplacements avec la logique OU (un seul doit \u00eatre vrai):<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ]\n    ],\n    [\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
Regarde la diff\u00e9rence?<\/p>\n
OK, passons \u00e0 autre chose. Chaque option d’emplacement se compose d’un tableau de trois \u00e9l\u00e9ments\u00a0; 'param'<\/code>c’est l\u00e0 que nous ajoutons tous les diff\u00e9rents emplacements, 'operator'<\/code>, et 'value'<\/code>. L’op\u00e9rateur est de savoir comment comparer la valeur, et il peut \u00eatre '=='<\/code>\u00e9gal ou '!='<\/code>non \u00e9gal \u00e0.<\/p>\n
Passons en revue les options possibles une par une.<\/p>\n
Localisation par type de poste<\/h3>\n
[\n    'param' => 'post_type',\n    'operator' => '==',\n    'value' => 'post'\n]<\/code><\/pre>\n
D\u00e9finissez le type de publication souhait\u00e9 dans 'value'<\/code>. Gardez \u00e0 l’esprit que vous ne pouvez pas fournir un tableau de plusieurs types de publication, vous devez combiner plusieurs de ces tableaux dans une configuration ET.<\/p>\n
Localisation par statut de poste<\/h3>\n
[\n    'param' => 'post_status',\n    'operator' => '==',\n    'value' => 'publish'\n]<\/code><\/pre>\n
D\u00e9finissez le statut de publication souhait\u00e9 sur 'value'<\/code>. Encore une fois, gardez \u00e0 l’esprit que vous ne pouvez pas fournir un tableau de plusieurs statuts de publication, vous devrez fournir chaque valeur souhait\u00e9e dans une configuration AND ou OR.<\/p>\n
Emplacement par mod\u00e8le de page<\/h3>\n
[\n    'param' => 'page_template',\n    'operator' => '==',\n    'value' => 'template-name.php'\n]<\/code><\/pre>\n
Cela ne s’affiche que si la page s\u00e9lectionn\u00e9e (ou le type de publication personnalis\u00e9 avec prise en charge du mod\u00e8le de page) a choisi le nom de mod\u00e8le de page fourni.<\/p>\n
Emplacement par terme de taxonomie attribu\u00e9<\/h3>\n
\/\/ Post category only\n[\n    'param' => 'post_category',\n    'operator' => '==',\n    'value' => 'category:some-category-slug'\n]\n\/\/ Any taxonomy\n[\n    'param' => 'post_taxonomy',\n    'operator' => '==',\n    'value' => 'my_custom_taxonomy:some-category-slug'  \/\/ <taxonomy name>:<term slug>\n]<\/code><\/pre>\n
Cet emplacement est utilis\u00e9 lorsqu’un message est associ\u00e9 \u00e0 un terme sp\u00e9cifique. Vous devrez fournir le nom de la taxonomie, deux-points et le slug du terme comme valeur.<\/p>\n
Emplacement par type de page<\/h3>\n
ACF regroupe les propri\u00e9t\u00e9s sp\u00e9ciales des pages en \u00abtype de page \u00bb. Il s’agit principalement de savoir si la page actuelle est ou non une page parent ou enfant, mais aussi de cibler des pages d\u00e9finies comme page d’accueil WordPress ou page de blog.<\/p>\n
\/\/ Front page\n[\n    'param' => 'page_type',\n    'operator' => '==',\n    'value' => 'front_page'\n]\n\/\/ Posts page\n[\n    'param' => 'page_type',\n    'operator' => '==',\n    'value' => 'posts_page'\n]\n\/\/ Top level page only\n[\n    'param' => 'page_type',\n    'operator' => '==',\n    'value' => 'top_level'\n]\n\/\/ Top level page that has children\n[\n    'param' => 'page_type',\n    'operator' => '==',\n    'value' => 'parent'\n]\n\/\/ Children level pages\n[\n    'param' => 'page_type',\n    'operator' => '==',\n    'value' => 'children'\n]<\/code><\/pre>\n
Emplacement\u00a0: taxonomie<\/h3>\n
Emplacement \u00e0 utiliser lors de la modification ou de l’ajout d’un terme dans une taxonomie.<\/p>\n
[\n    'param' => 'taxonomy',\n    'operator' => '==',\n    'value' => 'category'  \/\/ Or 'all' for all taxonomies\n]<\/code><\/pre>\n
Indiquez le nom de la taxonomie sous la forme 'value'<\/code>. Gardez \u00e0 l’esprit que vous ne pouvez pas fournir un tableau de plusieurs taxonomies, mais vous pouvez fournir 'all'<\/code>pour cibler toutes les taxonomies.<\/p>\n
Emplacement\u00a0: utilisateur<\/h3>\n
Cet emplacement permet d’ajouter ou de modifier un profil d’utilisateur.<\/p>\n
[\n    'param' => 'user_form',\n    'operator' => '==',\n    'value' => 'all'  \/\/ 'edit' || 'register'\n]<\/code><\/pre>\n
Indiquez 'edit<\/code>‘ pour cibler uniquement l’\u00e9cran de modification des utilisateurs existants, 'register'<\/code>pour cibler uniquement le formulaire lors de l’enregistrement d’un nouvel utilisateur, ou ‘ all'<\/code>pour les deux \u00e9l\u00e9ments ci-dessus.<\/p>\n
Emplacement\u00a0: \u00e9l\u00e9ment de menu<\/h3>\n
Depuis ACF 5.6, vous pouvez \u00e9galement ajouter des groupes de champs aux \u00e9l\u00e9ments de menu.<\/p>\n
[\n    'param' => 'nav_menu_item',\n    'operator' => '==',\n    'value' => 'all'\n]<\/code><\/pre>\n
Vous pouvez configurer value<\/code>pour all<\/code>appliquer le groupe \u00e0 tous les \u00e9l\u00e9ments de menu, ou vous pouvez sp\u00e9cifier des menus soit par emplacement (emplacements enregistr\u00e9s dans votre th\u00e8me) soit par ID de menu. Pour l’utilisation de l’emplacement 'location\/<name>'<\/code>– ainsi, pour un emplacement nomm\u00e9 ‘ primary<\/code>‘, vous pouvez d\u00e9finir la valeur sur 'location\/primary'<\/code>pour appliquer votre groupe \u00e0 un menu attribu\u00e9 \u00e0 cet emplacement uniquement. Si vous souhaitez cibler un ID de menu sp\u00e9cifique, d\u00e9finissez la valeur sur une cha\u00eene de cet ID.<\/p>\n
Emplacement: Widget<\/h3>\n
ACF vous fournit m\u00eame un emplacement dans les param\u00e8tres du widget sans modifier le code du widget principal.<\/p>\n
[\n    'param' => 'widget',\n    'operator' => '==',\n    'value' => 'tag_cloud'  \/\/ or 'all' for all widgets\n]<\/code><\/pre>\n
Vous pouvez cibler tous les widgets avec 'all'<\/code>as 'value'<\/code>ou cibler un widget sp\u00e9cifique. Vous aurez besoin de conna\u00eetre \u00abl’ID interne\u00bb du widget avec lequel ils sont enregistr\u00e9s.<\/p>\n
Emplacement\u00a0: page Options ACF (Pro uniquement)<\/h3>\n
Avec ACF Pro, vous pouvez utiliser ACF pour configurer des pages d’administration personnalis\u00e9es.<\/p>\n
[\n    'param' => 'options_page',\n    'operator' => '==',\n    'value' => 'acf-options-myoptionspage'\n]<\/code><\/pre>\n
Indiquez le nom que vous avez d\u00e9fini acf_add_options_page<\/code>dans menu_slug<\/code>as 'value'<\/code>.<\/p>\n
Emplacement\u00a0: bloc (Pro 5.8+ uniquement)<\/h3>\n
ACF Pro (5.8+) a une fonctionnalit\u00e9 pour ajouter des blocs Gutenberg avec des champs d’ACF et contr\u00f4ler sa sortie avec PHP. Assez astucieux pour ceux qui n’ont pas encore plong\u00e9 dans l’ajout de blocs Gutenberg personnalis\u00e9s et du Javascript requis.<\/p>\n
[\n    'param' => 'block',\n    'operator' => '==',\n    'value' => 'acf\/cta'  \/\/ or 'all' for all ACF blocks\n]<\/code><\/pre>\n
\n
Des champs<\/h2>\n
Nous entrons maintenant dans la partie la plus int\u00e9ressante; les champs eux-m\u00eames. ACF propose une (vraiment) large gamme de types de champs, et je le r\u00e9p\u00e8te\u00a0; ce guide ne vous montre pas ce qu’est chaque champ et comment ils fonctionnent ou ressemblent.<\/p>\n
Dans le tableau de base que vous fournissez 'fields'<\/code>, acf_add_local_field_group()<\/code>vous fournissez un tableau o\u00f9 chaque champ est son propre tableau.<\/p>\n
Le minimum absolu requis pour chaque champ est le suivant\u00a0: un unique 'key'<\/code>qui peut \u00eatre tout ce que vous voulez et vous n’aurez probablement jamais besoin de vous y r\u00e9f\u00e9rer. Vous avez \u00e9galement besoin 'name'<\/code>de la cl\u00e9 m\u00e9ta (post, user, term) dans laquelle la valeur du champ est enregistr\u00e9e – et c’est celle \u00e0 laquelle vous vous r\u00e9f\u00e9rerez lors de l’obtention de la valeur des champs. Vous devez fournir un 'label'<\/code>et enfin le crucial 'type'<\/code>qui d\u00e9finit le type de champ que nous traitons. Le reste des champs d\u00e9pend de, 'type'<\/code>comme nous le verrons lorsque nous passerons en revue chaque type de champ ci-dessous.<\/p>\n
Il s’agit du code squelette pour ajouter un champ.<\/p>\n
'fields' = [\n    [\n        'key' => 'field_my_field',\n        'label' => __('My field', 'txtdomain'),\n        'name' => 'my_field',\n        'type' => 'text',\n    ]\n]<\/code><\/pre>\n
Gardez \u00e0 l’esprit que vous aurez besoin de ce qui pr\u00e9c\u00e8de pour chaque champ, mais pour ne pas r\u00e9p\u00e9ter le m\u00eame code, chaque type de champ ci-dessous n’inclura 'type'<\/code>que tous les autres \u00e9l\u00e9ments n\u00e9cessaires pour ce type de champ.<\/p>\n
Champ: Saisie de texte<\/h3>\n
Le champ le plus simple de tous. Tout ce dont nous avons vraiment besoin est :<\/p>\n
[\n    'type' => 'text',\n]<\/code><\/pre>\n
Mais pour personnaliser davantage votre saisie de texte, vous pouvez \u00e9galement fournir l’un des \u00e9l\u00e9ments suivants\u00a0:<\/p>\n
[\n    'default_value' => 'Default value',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Champ: Saisie num\u00e9rique<\/h3>\n
[\n    'type' => 'number',\n    'min' => 0,\n    'max' => 100,\n    'step' => 1,\n    'default_value' => 'Default value',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Champ\u00a0: zone de texte<\/h3>\n
[\n    'type' => 'textarea',\n    'rows' => 5,\n    'new_lines' => 'wpautop',  \/\/ 'br' || ''\n    'default_value' => 'Default value',\n]<\/code><\/pre>\n
Champ\u00a0: Curseur de plage<\/h3>\n
[\n    'type' => 'range',\n    'min' => 0,\n    'max' => 100,\n    'step' => 1,\n    'default_value' => 50,\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Champ\u00a0: Mot de passe<\/h3>\n
Identique \u00e0 la saisie de texte, sauf que tout ce que vous y tapez sera couvert de * comme vous vous en doutez dans un champ de mot de passe.<\/p>\n
[\n    'type' => 'password',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Champ\u00a0: Image<\/h3>\n
S\u00e9lection d’une seule image.<\/p>\n
[\n    'type' => 'image',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n    'preview_size' => 'thumbnail',\n]<\/code><\/pre>\n
Champ\u00a0: Fichier<\/h3>\n
Similaire \u00e0 l’image ci-dessus, sauf qu’elle ne pr\u00e9visualise pas le fichier.<\/p>\n
[\n    'type' => 'file',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n]<\/code><\/pre>\n
Vous pouvez \u00e9galement le fournir 'mime_types' => '',<\/code>et le d\u00e9finir, par exemple, 'pdf,docx'<\/code>pour autoriser uniquement les fichiers PDF et DOCX.<\/p>\n
Champ\u00a0: \u00c9diteur WYSIWYG<\/h3>\n
WYSIWYG est un \u00e9diteur \u00abWhat You See Is What You Get\u00bb \u2013 celui que nous connaissions avant l’arriv\u00e9e de Gutenberg (TinyMCE).<\/p>\n
[\n    'type' => 'wysiwyg',\n    'tabs' => 'all',  \/\/ 'visual' || 'text'\n    'toolbar' => 'full',  \/\/ 'basic'\n    'media_upload' => 1,\n    'delay' => 0,\n]<\/code><\/pre>\n
Le param\u00e8tre 'media_upload'<\/code>et 'delay'<\/code>peut \u00eatre 1 (vrai) ou 0 (faux).<\/p>\n
Champ: S\u00e9lectionnez<\/h3>\n
[\n    'type' => 'select',\n    'allow_null' => 1,\n    'multiple' => 0,\n    'ui' => 1,\n    'return_format' => 'value',  \/\/ 'array' || 'label'\n    'choices' => [\n        'red' => __('Red color', 'txtdomain'),\n        'blue' => __('Blue color', 'txtdomain')\n    ],\n    'default_value' => 'red',\n]<\/code><\/pre>\n
Champ: Case \u00e0 cocher<\/h3>\n
[\n    'type' => 'checkbox',\n    'layout' => 'horizontal',  \/\/ 'vertical'\n    'toggle' => 0,\n    'return_format' => 'value',  \/\/ 'array' || 'label'\n    'choices' => [\n        'red' => __('Red color', 'txtdomain'),\n        'blue' => __('Blue color', 'txtdomain')\n    ],\n    'default_value' => ['red'],\n    'allow_custom' => 1,\n    'save_custom' => 0,\n]<\/code><\/pre>\n
Notez qu’il 'default_value'<\/code>peut s’agir d’un tableau de choix multiples.<\/p>\n
Champ: bouton radio<\/h3>\n
[\n    'type' => 'radio',\n    'layout' => 'horizontal',  \/\/ 'vertical'\n    'allow_null' => 0,\n    'return_format' => 'value',  \/\/ 'array' || 'label'\n    'choices' => [\n        'red' => __('Red color', 'txtdomain'),\n        'blue' => __('Blue color', 'txtdomain')\n    ],\n    'default_value' => 'red',\n    'other_choice' => 1,\n    'save_other_choice' => 0,\n]<\/code><\/pre>\n
Le r\u00e9glage 'other_choice'<\/code>sur true ajoute un bouton radio suppl\u00e9mentaire intitul\u00e9 "Autre" avec une entr\u00e9e de texte o\u00f9 l’utilisateur peut taper quelque chose.<\/p>\n
Champ: vrai\/faux (bascule)<\/h3>\n
[\n    'type' => 'true_false',\n    'message' => __('Text after toggler', 'txtdomain'),\n    'default_value' => 1,\n    'ui' => 1,\n    'ui_on_text' => __('Yes', 'txtdomain'),\n    'ui_off_text' => __('No', 'txtdomain'),\n]<\/code><\/pre>\n
Le 'ui_on_text'<\/code>et 'ui_off_text'<\/code>n’est valide que si 'ui'<\/code>vaut 1, car ils d\u00e9finissent ce qui doit appara\u00eetre sur le basculeur sp\u00e9cial de l’interface utilisateur.<\/p>\n
Champ: Lien<\/h3>\n
Vous donne un bouton pour entrer un lien, soit en tapant, soit en choisissant parmi le contenu de votre site WordPress (devrait \u00eatre familier avec l’ajout d’un lien dans l’\u00e9diteur WordPress normal).<\/p>\n
[\n    'type' => 'link',\n    'return_format' => 'url',  \/\/ 'array'\n]<\/code><\/pre>\n
Champ\u00a0: Publier un objet<\/h3>\n
Donne une bo\u00eete de s\u00e9lection o\u00f9 vous pouvez choisir parmi le contenu WordPress. La s\u00e9lection vous permet de rechercher en tapant et tout le contenu est divis\u00e9 par type de publication. Vous pouvez autoriser la s\u00e9lection de plusieurs publications ou d’une seule.<\/p>\n
[\n    'type' => 'post_object',\n    'allow_null' => 1,\n    'multiple' => 0,\n    'return_format' => 'object',  \/\/ 'id'\n    'post_type' => '',  \/\/ or array of post types e.g. ['post', 'page']\n    'taxonomy' => '',  \/\/ or array of terms e.g. ['category:term-slug']\n]<\/code><\/pre>\n
Champ\u00a0: Relation<\/h3>\n
[\n    'type' => 'relationship',\n    'return_format' => 'object',  \/\/ 'id'\n    'post_type' => '',  \/\/ or array of post types e.g. ['post', 'page']\n    'taxonomy' => '',  \/\/ or array of terms e.g. ['category:term-slug']\n    'elements' => ['featured_image'],  \/\/ or ''\n    'filters' => ['search', 'post_type', 'taxonomy'],\n]<\/code><\/pre>\n
Champ\u00a0: choisir des termes dans une taxonomie<\/h3>\n
Le s\u00e9lecteur de termes de taxonomie a quatre "modes" ou types diff\u00e9rents o\u00f9 deux d’entre eux permettent des choix multiples.<\/p>\n
[\n    'type' => 'taxonomy',\n    'return_format' => 'object',  \/\/ 'id'\n    'taxonomy' => 'category',\n    'field_type' => 'select',  \/\/ 'checkbox' || 'radio' || 'multi_select'\n    'add_term' => 0,\n    'save_terms' => 0,\n]<\/code><\/pre>\n
Champ\u00a0: s\u00e9lectionnez l’utilisateur<\/h3>\n
[\n    'type' => 'user',\n    'return_format' => 'array',  \/\/ 'object' || 'id\n    'role' => '',  \/\/ or array of roles, e.g. ['author']\n    'allow_null' => 1,\n    'multiple' => 0,\n]<\/code><\/pre>\n
Champ: Google Maps<\/h3>\n
[\n    'type' => 'google_map',\n    'center_lat' => '59.917',\n    'center_lng' => '10.727',\n    'zoom' => 14,\n    'height' => 350,\n]<\/code><\/pre>\n
Gardez \u00e0 l’esprit que vous devez fournir une cl\u00e9 d’API GoogleMaps valide \u00e0 ACF pour que ce champ fonctionne, comme ceci\u00a0:<\/p>\n
add_filter('acf\/fields\/google_map\/api', function($api) {\n    $api['key'] = 'YOURAPIKEY';\n    return $api;\n});<\/code><\/pre>\n
Champ\u00a0: S\u00e9lecteur de date<\/h3>\n
[\n    'type' => 'date_picker',\n    'display_format' => 'd\/m\/Y',\n    'return_format' => 'Y-m-d',\n    'first_day' => 1,\n]<\/code><\/pre>\n
Champ\u00a0: S\u00e9lecteur de date et d’heure<\/h3>\n
[\n    'type' => 'date_time_picker',\n    'display_format' => 'd\/m\/Y H:i:s',\n    'return_format' => 'Y-m-d H:i:s',\n    'first_day' => 1,\n]<\/code><\/pre>\n
Champ\u00a0: S\u00e9lecteur de temps<\/h3>\n
[\n    'type' => 'time_picker',\n    'display_format' => 'H:i',\n    'return_format' => H:i',\n]<\/code><\/pre>\n
Champ: S\u00e9lecteur de couleurs<\/h3>\n
[\n    'type' => 'color_picker',\n    'default_value' => '',  \/\/ or any hex code, e.g. '#FFFFFF'\n]<\/code><\/pre>\n
Champ: Galerie (ACF Pro uniquement)<\/h3>\n
[\n    'type' => 'gallery',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n    'preview_size' => 'thumbnail',\n    'insert' => 'append',  \/\/ 'prepend'\n]<\/code><\/pre>\n
Types de champs sp\u00e9ciaux<\/h3>\n
ACF propose \u00e9galement certains types de champs qui n’enregistrent pas de valeur en soi, mais ils sont davantage destin\u00e9s \u00e0 des fins organisationnelles. Pour tous ceux-ci, d\u00e9finissez 'name'<\/code>une cha\u00eene vide.<\/p>\n
Message HTML<\/h4>\n
Si vous avez simplement besoin d’imprimer du code HTML sans enregistrer de valeur, vous pouvez utiliser type 'message'<\/code>.<\/p>\n
[\n    'type' => 'message',\n    'message' => '<p>Your HTML here<\/p>',\n    'new_lines' => 'wpautop',\n    'esc_html' => 0,\n]<\/code><\/pre>\n
R\u00e9p\u00e9teur (ACF Pro uniquement)<\/h4>\n
Un r\u00e9p\u00e9teur contient un tableau de champs qui peuvent \u00eatre r\u00e9p\u00e9t\u00e9s.<\/p>\n
[\n    'type' => 'repeater',\n    'layout' => 'table',  \/\/ 'block' || 'row'\n    'button_label' => __('Add new', 'txtdomain'),\n    'sub_fields' => [],\n]<\/code><\/pre>\n
L’\u00e9l\u00e9ment sub_fields<\/code>attend un tableau de champs, tout comme vous avez configur\u00e9 les champs ci-dessus.<\/p>\n
Conclusion<\/h2>\n
Il ne s’agit en aucun cas d’un guide exhaustif, car ACF propose un large \u00e9ventail d’options et de personnalisations. Mais il devrait couvrir les options les plus utilis\u00e9es et les cas d’utilisation personnalis\u00e9s. Personnellement, je me r\u00e9f\u00e8re assez souvent \u00e0 cela chaque fois que j’ajoute des champs ACF pour les clients. Et m\u00eame pour les options les plus \u00e9tranges, ce guide est suffisant pour que je n’aie pas besoin de gonfler mes fichiers PHP avec le code d’exportation d’ACF. J’esp\u00e8re que cela vous a \u00e9t\u00e9 utile aussi !<\/p>\n
Source d’enregistrement:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Une r\u00e9f\u00e9rence compl\u00e8te sur la fa\u00e7on de bien configurer les champs et les groupes de champs personnalis\u00e9s avanc\u00e9s par code PHP au lieu de coller du code gonfl\u00e9 \u00e0 partir de l’outil d’exportation PHP ACF.<\/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":[893,893,717,717,1110,811,811,841,841,862,862],"tags":[1167],"class_list":["post-234260","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","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\/234260","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=234260"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234260\/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=234260"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=234260"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=234260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}