{"id":233869,"date":"2023-02-23T17:31:00","date_gmt":"2023-02-23T14:31:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233869"},"modified":"2022-11-11T12:53:38","modified_gmt":"2022-11-11T09:53:38","slug":"referencia-completa-para-adicionar-grupos-de-campos-personalizados-avancados-e-campos-por-codigo","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/referencia-completa-para-adicionar-grupos-de-campos-personalizados-avancados-e-campos-por-codigo\/","title":{"rendered":"Refer\u00eancia completa para adicionar grupos de campos personalizados avan\u00e7ados e campos por c\u00f3digo"},"content":{"rendered":"\n

O plugin Advanced Custom Fields<\/a> (ACF) suporta a configura\u00e7\u00e3o completa de campos e grupos por c\u00f3digo PHP em seu tema ou plugin. Os benef\u00edcios de fazer isso \u00e9 que todos os seus campos estar\u00e3o dispon\u00edveis independentemente da inst\u00e2ncia do WordPress em que voc\u00ea est\u00e1 trabalhando (por exemplo, se voc\u00ea precisar alternar entre local, servidor de teste e servidor ativo). Voc\u00ea pode configurar todos os campos no admin do ACF e usar a ferramenta de exporta\u00e7\u00e3o para export\u00e1-los para PHP.<\/p>\n

\"Refer\u00eancia<\/a><\/p>\n

No entanto, se voc\u00ea fizer isso com frequ\u00eancia, poder\u00e1 notar que a exporta\u00e7\u00e3o PHP do ACF cont\u00e9m muito c\u00f3digo, tornando seus arquivos PHP desnecessariamente longos. Em alguns casos, \u00e9 melhor escrever o c\u00f3digo voc\u00ea mesmo, com o m\u00ednimo necess\u00e1rio, para um c\u00f3digo mais limpo em seu tema ou plugin. Este guia tem como objetivo fornecer uma refer\u00eancia completa sobre como escrever manualmente a adi\u00e7\u00e3o de campos e grupos ACF em PHP. Observe que ele n\u00e3o entrar\u00e1 em detalhes sobre cada tipo de campo, pois pressup\u00f5e que voc\u00ea j\u00e1 esteja familiarizado com os diferentes campos poss\u00edveis no ACF.<\/p>\n

Mas primeiro; algumas precau\u00e7\u00f5es<\/h2>\n

Para manter bons padr\u00f5es de c\u00f3digo e garantir que seu site WordPress n\u00e3o falhe, voc\u00ea deve sempre verificar se as fun\u00e7\u00f5es ou classes que seu c\u00f3digo est\u00e1 usando realmente existem. Especialmente quando se trata de plugins que podem ser facilmente desativados ou nem mesmo instalados em um site, voc\u00ea deve sempre envolver o c\u00f3digo espec\u00edfico do plugin em um teste if que verifica se as fun\u00e7\u00f5es que voc\u00ea usa existem, antes de us\u00e1-las.<\/p>\n

Quanto ao ACF voc\u00ea pode fazer isso verificando se a classe 'acf'<\/code>existe ou se a fun\u00e7\u00e3o para adicionar campos e grupos, 'acf_add_local_field_group'<\/code>, existe. Enrole qualquer um deles ao redor do c\u00f3digo abaixo.<\/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
C\u00f3digo esqueleto<\/h2>\n
Para adicionar meta caixas (grupos) e campos, usamos o gancho chamado acf\/init<\/code>. Dentro da fun\u00e7\u00e3o chamamos a fun\u00e7\u00e3o acf_add_local_field_group()<\/code>com um array como par\u00e2metro. Dentro dessa matriz est\u00e1 a configura\u00e7\u00e3o completa do grupo e todos os seus campos. Os mais importantes s\u00e3o as chaves de matriz 'fields'<\/code>e 'location'<\/code>. Para chave de matriz 'fields'<\/code>voc\u00ea fornece a matriz para todos os campos e para a chave 'location'<\/code>voc\u00ea fornece as configura\u00e7\u00f5es de onde a metabox deve aparecer. Este post entrar\u00e1 em detalhes de quais op\u00e7\u00f5es poss\u00edveis voc\u00ea tem para cada uma delas abaixo.<\/p>\n
Este \u00e9 o m\u00ednimo para adicionar um grupo, al\u00e9m dos campos e local:<\/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
Cada grupo precisa de uma chave \u00fanica, mas o nome real em si n\u00e3o importa muito (para n\u00f3s). Se voc\u00ea estiver adicionando mais grupos, n\u00e3o se esque\u00e7a de alterar o 'key'<\/code>campo. O t\u00edtulo da metabox pode ser definido no elemento-chave do array, voc\u00ea adivinhou, 'title'<\/code>. Se voc\u00ea estiver adicionando v\u00e1rias metaboxes no mesmo local (por exemplo, na p\u00f3s-edi\u00e7\u00e3o), voc\u00ea pode controlar o que vem primeiro fornecendo n\u00fameros diferentes em 'menu_order'<\/code>.<\/p>\n
Voc\u00ea pode controlar o design da metabox fornecendo um default<\/code>eller seamless<\/code>em 'style'<\/code>. No entanto, com o novo editor Gutenberg, isso tem um significado muito menor. O mesmo vale para a chave 'position'<\/code>onde antigamente voc\u00ea podia posicionar a metabox abaixo do conte\u00fado do post ('normal'<\/code>), ao lado ('side'<\/code>) ou logo ap\u00f3s o t\u00edtulo do post ('acf_after_title'<\/code>).<\/p>\n
Tudo bem! Vamos mergulhar nos dois elementos mais interessantes do array; come\u00e7ando com a localiza\u00e7\u00e3o \u2013 que define onde a metabox aparece.<\/p>\n
Localiza\u00e7\u00e3o<\/h2>\n
Isso \u00e9 tudo sobre o que voc\u00ea coloca na chave 'location'<\/code>. Mas antes de olharmos para as op\u00e7\u00f5es poss\u00edveis, precisamos entender sua estrutura de matriz.<\/p>\n
'location'<\/code>aceita um array com um array de elementos em um array! Resistir. Sim, porque \u00e9 poss\u00edvel fornecer e combinar a l\u00f3gica AND e OR no local (por exemplo, "mostrar na edi\u00e7\u00e3o de postagem, mas n\u00e3o se o tipo de postagem for ‘livro’", ou "mostrar na tela de edi\u00e7\u00e3o do usu\u00e1rio e tamb\u00e9m criar uma nova tela de usu\u00e1rio, mas para ambos os casos not if current role is author"). A maneira como voc\u00ea indica se \u00e9 um AND ou OR \u00e9 estruturando os arrays. \u00c9 muito mais f\u00e1cil mostrar do que explicar em palavras:<\/p>\n
\u00c9 assim que voc\u00ea combina dois elementos de localiza\u00e7\u00e3o com l\u00f3gica AND (ambos devem ser verdadeiros):<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ],\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
E isso \u00e9 para combinar locais com l\u00f3gica OR (apenas um precisa ser verdadeiro):<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ]\n    ],\n    [\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
Veja a diferen\u00e7a?<\/p>\n
Certo, vamos seguir em frente. Cada op\u00e7\u00e3o de localiza\u00e7\u00e3o consiste em uma matriz de tr\u00eas elementos; 'param'<\/code>que \u00e9 onde adicionamos todos os locais diferentes 'operator'<\/code>, e 'value'<\/code>. Operador \u00e9 como comparar o valor, podendo ser '=='<\/code>igual ou '!='<\/code>n\u00e3o igual a.<\/p>\n
Vamos examinar as op\u00e7\u00f5es poss\u00edveis, uma por uma.<\/p>\n
Localiza\u00e7\u00e3o por tipo de postagem<\/h3>\n
[\n    'param' => 'post_type',\n    'operator' => '==',\n    'value' => 'post'\n]<\/code><\/pre>\n
Defina o tipo de postagem desejado em 'value'<\/code>. Tenha em mente que voc\u00ea n\u00e3o pode fornecer uma matriz de v\u00e1rios tipos de postagem, voc\u00ea precisa combinar v\u00e1rias dessas matrizes em uma configura\u00e7\u00e3o AND.<\/p>\n
Localiza\u00e7\u00e3o por status de postagem<\/h3>\n
[\n    'param' => 'post_status',\n    'operator' => '==',\n    'value' => 'publish'\n]<\/code><\/pre>\n
Defina o status de postagem desejado como 'value'<\/code>. Novamente, lembre-se de que voc\u00ea n\u00e3o pode fornecer uma matriz de v\u00e1rios status de postagem, voc\u00ea precisar\u00e1 fornecer cada valor desejado em uma configura\u00e7\u00e3o AND ou OR.<\/p>\n
Localiza\u00e7\u00e3o por modelo de p\u00e1gina<\/h3>\n
[\n    'param' => 'page_template',\n    'operator' => '==',\n    'value' => 'template-name.php'\n]<\/code><\/pre>\n
Isso \u00e9 exibido apenas se a p\u00e1gina selecionada (ou tipo de postagem personalizado com suporte a modelo de p\u00e1gina) tiver escolhido o nome do modelo de p\u00e1gina fornecido.<\/p>\n
Localiza\u00e7\u00e3o por termo de taxonomia atribu\u00eddo<\/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
Este local \u00e9 para quando um post tem um termo espec\u00edfico atribu\u00eddo a ele. Voc\u00ea precisar\u00e1 fornecer o nome da taxonomia, dois pontos e o slug do termo como valor.<\/p>\n
Localiza\u00e7\u00e3o por tipo de p\u00e1gina<\/h3>\n
O ACF agrupa propriedades especiais para p\u00e1ginas como “tipo de p\u00e1gina”. Preocupa-se principalmente se a p\u00e1gina atual \u00e9 ou n\u00e3o uma p\u00e1gina pai ou filha, mas tamb\u00e9m para direcionar p\u00e1ginas definidas como p\u00e1gina inicial do WordPress ou p\u00e1gina do 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
Local: taxonomia<\/h3>\n
Um local para editar ou adicionar um termo em uma taxonomia.<\/p>\n
[\n    'param' => 'taxonomy',\n    'operator' => '==',\n    'value' => 'category'  \/\/ Or 'all' for all taxonomies\n]<\/code><\/pre>\n
Forne\u00e7a o nome da taxonomia como 'value'<\/code>. Lembre-se de que voc\u00ea n\u00e3o pode fornecer uma matriz de v\u00e1rias taxonomias, mas pode fornecer 'all'<\/code>para segmentar todas as taxonomias.<\/p>\n
Local: usu\u00e1rio<\/h3>\n
Este local \u00e9 para adicionar ou editar um perfil de usu\u00e1rio.<\/p>\n
[\n    'param' => 'user_form',\n    'operator' => '==',\n    'value' => 'all'  \/\/ 'edit' || 'register'\n]<\/code><\/pre>\n
Forne\u00e7a 'edit<\/code>‘ para direcionar apenas a tela de edi\u00e7\u00e3o de usu\u00e1rios existentes, 'register'<\/code>para direcionar apenas o formul\u00e1rio ao registrar um novo usu\u00e1rio ou ‘ all'<\/code>para ambos os itens acima.<\/p>\n
Local: item de menu<\/h3>\n
Desde o ACF 5.6, voc\u00ea tamb\u00e9m pode adicionar grupos de campos aos itens de menu.<\/p>\n
[\n    'param' => 'nav_menu_item',\n    'operator' => '==',\n    'value' => 'all'\n]<\/code><\/pre>\n
Voc\u00ea pode definir value<\/code>para all<\/code>aplicar o grupo a todos os itens de menu ou pode especificar menus por local (locais registrados em seu tema) ou por ID de menu. Para uso de local 'location\/<name>'<\/code>\u2013 portanto, para um local chamado ‘ primary<\/code>‘, voc\u00ea pode definir o valor 'location\/primary'<\/code>para aplicar seu grupo a um menu atribu\u00eddo apenas a este local. Se voc\u00ea deseja segmentar um ID de menu espec\u00edfico, defina o valor para uma string desse ID.<\/p>\n
Local: widget<\/h3>\n
O ACF ainda fornece uma localiza\u00e7\u00e3o dentro das configura\u00e7\u00f5es do widget sem modificar o c\u00f3digo principal do widget.<\/p>\n
[\n    'param' => 'widget',\n    'operator' => '==',\n    'value' => 'tag_cloud'  \/\/ or 'all' for all widgets\n]<\/code><\/pre>\n
Voc\u00ea pode segmentar todos os widgets com 'all'<\/code>as 'value'<\/code>ou segmentar um widget espec\u00edfico. Voc\u00ea precisar\u00e1 saber o “ID interno” do widget com o qual eles est\u00e3o registrados.<\/p>\n
Local: p\u00e1gina de op\u00e7\u00f5es do ACF (somente Pro)<\/h3>\n
Com o ACF Pro, voc\u00ea pode usar o ACF para configurar p\u00e1ginas de administra\u00e7\u00e3o personalizadas.<\/p>\n
[\n    'param' => 'options_page',\n    'operator' => '==',\n    'value' => 'acf-options-myoptionspage'\n]<\/code><\/pre>\n
Forne\u00e7a o nome que voc\u00ea definiu em acf_add_options_page<\/code>‘s menu_slug<\/code>as 'value'<\/code>.<\/p>\n
Localiza\u00e7\u00e3o: bloco (somente Pro 5.8+)<\/h3>\n
O ACF Pro (5.8+) possui um recurso para adicionar blocos Gutenberg com campos do ACF e controlar sua sa\u00edda com PHP. Muito bacana para aqueles que ainda n\u00e3o mergulharam na adi\u00e7\u00e3o de blocos personalizados do Gutenberg e o Javascript necess\u00e1rio.<\/p>\n
[\n    'param' => 'block',\n    'operator' => '==',\n    'value' => 'acf\/cta'  \/\/ or 'all' for all ACF blocks\n]<\/code><\/pre>\n
\n
Campos<\/h2>\n
Agora estamos entrando na parte mais interessante; os pr\u00f3prios campos. ACF oferece uma gama (realmente) ampla de tipos de campo, e vou reiterar; este guia n\u00e3o mostra o que \u00e9 cada campo e como eles funcionam ou se parecem.<\/p>\n
Na matriz principal que voc\u00ea fornece 'fields'<\/code>, acf_add_local_field_group()<\/code>voc\u00ea fornece uma matriz em que cada campo \u00e9 sua pr\u00f3pria matriz.<\/p>\n
O m\u00ednimo absoluto necess\u00e1rio para cada campo \u00e9 o seguinte: um exclusivo 'key'<\/code>que pode ser o que voc\u00ea quiser e voc\u00ea provavelmente nunca precisar\u00e1 consult\u00e1-lo. Voc\u00ea tamb\u00e9m precisa de 'name'<\/code>qual \u00e9 a meta-chave (post, user, term) na qual o valor do campo \u00e9 salvo \u2013 e \u00e9 a que voc\u00ea ir\u00e1 se referir ao obter o valor dos campos. Voc\u00ea deve fornecer um 'label'<\/code>e, finalmente, o crucial 'type'<\/code>que define qual tipo de campo estamos lidando. O restante dos campos depende de 'type'<\/code>como veremos quando passarmos por cada tipo de campo abaixo.<\/p>\n
Este \u00e9 o c\u00f3digo de esqueleto para adicionar um campo.<\/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
Tenha em mente que voc\u00ea precisar\u00e1 do acima para cada campo, mas para n\u00e3o repetir o mesmo c\u00f3digo, cada tipo de campo abaixo incluir\u00e1 apenas 'type'<\/code>e quaisquer outros elementos necess\u00e1rios para esse tipo de campo.<\/p>\n
Campo: entrada de texto<\/h3>\n
O campo mais simples de todos. Tudo o que realmente precisamos \u00e9:<\/p>\n
[\n    'type' => 'text',\n]<\/code><\/pre>\n
Mas para personalizar ainda mais sua entrada de texto, voc\u00ea tamb\u00e9m pode fornecer qualquer um dos seguintes:<\/p>\n
[\n    'default_value' => 'Default value',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Campo: Entrada de n\u00famero<\/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
Campo: Textarea<\/h3>\n
[\n    'type' => 'textarea',\n    'rows' => 5,\n    'new_lines' => 'wpautop',  \/\/ 'br' || ''\n    'default_value' => 'Default value',\n]<\/code><\/pre>\n
Campo: controle deslizante de alcance<\/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
Campo: Senha<\/h3>\n
Igual \u00e0 entrada de texto, exceto que qualquer coisa que voc\u00ea digitar ser\u00e1 coberta com * como seria de esperar em um campo de senha.<\/p>\n
[\n    'type' => 'password',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Campo: Imagem<\/h3>\n
Sele\u00e7\u00e3o de imagem \u00fanica.<\/p>\n
[\n    'type' => 'image',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n    'preview_size' => 'thumbnail',\n]<\/code><\/pre>\n
Campo: Arquivo<\/h3>\n
Semelhante \u00e0 imagem acima, exceto que n\u00e3o visualiza o arquivo.<\/p>\n
[\n    'type' => 'file',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n]<\/code><\/pre>\n
Voc\u00ea tamb\u00e9m pode fornecer 'mime_types' => '',<\/code>e configur\u00e1-lo para, por exemplo, 'pdf,docx'<\/code>permitir apenas arquivos PDF e DOCX.<\/p>\n
Campo: Editor WYSIWYG<\/h3>\n
WYSIWYG \u00e9 um editor “What You See Is What You Get” \u2013 aquele com o qual est\u00e1vamos familiarizados antes da chegada 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
O par\u00e2metro 'media_upload'<\/code>e 'delay'<\/code>pode ser 1 (verdadeiro) ou 0 (falso).<\/p>\n
Campo: Selecione<\/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
Campo: caixa de sele\u00e7\u00e3o<\/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
Observe que 'default_value'<\/code>pode ser uma matriz de v\u00e1rias op\u00e7\u00f5es.<\/p>\n
Campo: Bot\u00e3o de r\u00e1dio<\/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
Definir 'other_choice'<\/code>como true adiciona um bot\u00e3o de op\u00e7\u00e3o extra chamado "Outro" com uma entrada de texto onde o usu\u00e1rio pode digitar algo.<\/p>\n
Campo: Verdadeiro\/Falso (alternar)<\/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
O 'ui_on_text'<\/code>e 'ui_off_text'<\/code>s\u00f3 \u00e9 v\u00e1lido se 'ui'<\/code>for 1, pois eles est\u00e3o definindo o que deve aparecer no alternador especial da interface do usu\u00e1rio.<\/p>\n
Campo: Link<\/h3>\n
D\u00e1 a voc\u00ea um bot\u00e3o para inserir um link, digitando ou escolhendo o conte\u00fado do seu site WordPress (deve estar familiarizado com a adi\u00e7\u00e3o de um link no editor normal do WordPress).<\/p>\n
[\n    'type' => 'link',\n    'return_format' => 'url',  \/\/ 'array'\n]<\/code><\/pre>\n
Campo: Postar Objeto<\/h3>\n
D\u00e1 uma caixa de sele\u00e7\u00e3o onde voc\u00ea pode escolher entre o conte\u00fado do WordPress. O select permite pesquisar digitando e todo o conte\u00fado \u00e9 dividido por tipo de postagem. Voc\u00ea pode permitir que v\u00e1rias postagens sejam escolhidas ou apenas uma.<\/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
Campo: Relacionamento<\/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
Campo: Escolher termos em uma taxonomia<\/h3>\n
O seletor de termos de taxonomia tem quatro “modos” ou tipos diferentes, onde dois deles permitem v\u00e1rias escolhas.<\/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
Campo: Selecionar usu\u00e1rio<\/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
Campo: 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
Lembre-se de que voc\u00ea precisa fornecer uma chave de API do GoogleMaps v\u00e1lida ao ACF para que esse campo funcione, assim:<\/p>\n
add_filter('acf\/fields\/google_map\/api', function($api) {\n    $api['key'] = 'YOURAPIKEY';\n    return $api;\n});<\/code><\/pre>\n
Campo: DataPicker<\/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
Campo: seletor de data e hora<\/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
Campo: selecionador de tempo<\/h3>\n
[\n    'type' => 'time_picker',\n    'display_format' => 'H:i',\n    'return_format' => H:i',\n]<\/code><\/pre>\n
Campo: Colorpicker<\/h3>\n
[\n    'type' => 'color_picker',\n    'default_value' => '',  \/\/ or any hex code, e.g. '#FFFFFF'\n]<\/code><\/pre>\n
Campo: Galeria (somente ACF Pro)<\/h3>\n
[\n    'type' => 'gallery',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n    'preview_size' => 'thumbnail',\n    'insert' => 'append',  \/\/ 'prepend'\n]<\/code><\/pre>\n
Tipos especiais de campos<\/h3>\n
O ACF tamb\u00e9m oferece alguns tipos de campo que n\u00e3o economizam valor per se, mas s\u00e3o mais para fins organizacionais. Para tudo isso, defina 'name'<\/code>como uma string vazia.<\/p>\n
Mensagem HTML<\/h4>\n
Se voc\u00ea precisar simplesmente imprimir algum HTML sem salvar um valor, voc\u00ea pode usar 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
Repetidor (somente ACF Pro)<\/h4>\n
Um repetidor cont\u00e9m uma matriz de campos que podem ser repetidos.<\/p>\n
[\n    'type' => 'repeater',\n    'layout' => 'table',  \/\/ 'block' || 'row'\n    'button_label' => __('Add new', 'txtdomain'),\n    'sub_fields' => [],\n]<\/code><\/pre>\n
O elemento sub_fields<\/code>espera uma matriz de campos, assim como voc\u00ea configurou os campos acima.<\/p>\n
Conclus\u00e3o<\/h2>\n
Este n\u00e3o \u00e9 de forma alguma um guia exaustivo, pois o ACF oferece uma ampla gama de op\u00e7\u00f5es e personaliza\u00e7\u00f5es. Mas deve abranger as op\u00e7\u00f5es mais usadas e casos de uso personalizados. Pessoalmente, me vejo me referindo a isso com bastante frequ\u00eancia sempre que adiciono campos ACF para clientes. E mesmo para as op\u00e7\u00f5es mais estranhas, este guia \u00e9 suficiente para que eu n\u00e3o precise inchar meus arquivos PHP com o c\u00f3digo de exporta\u00e7\u00e3o do ACF. Espero que isso tenha sido \u00fatil para voc\u00ea tamb\u00e9m!<\/p>\n
Fonte de grava\u00e7\u00e3o:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Uma refer\u00eancia completa sobre como configurar campos e grupos de campos personalizados avan\u00e7ados por c\u00f3digo PHP em vez de colar c\u00f3digo inchado da ferramenta de exporta\u00e7\u00e3o 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":[898,898,722,722,1110,816,816,846,846,867,867],"tags":[1170],"class_list":["post-233869","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-n-a","category-plug-ins","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233869","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=233869"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233869\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/224889"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=233869"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=233869"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=233869"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}