{"id":233803,"date":"2023-02-23T17:17:00","date_gmt":"2023-02-23T14:17:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233803"},"modified":"2022-11-11T12:30:17","modified_gmt":"2022-11-11T09:30:17","slug":"referencia-completa-para-agregar-grupos-de-campos-personalizados-avanzados-y-campos-por-codigo","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/es\/referencia-completa-para-agregar-grupos-de-campos-personalizados-avanzados-y-campos-por-codigo\/","title":{"rendered":"Referencia completa para agregar grupos de campos personalizados avanzados y campos por c\u00f3digo"},"content":{"rendered":"\n

El complemento Campos personalizados avanzados<\/a> (ACF) admite la configuraci\u00f3n completa de campos y grupos mediante c\u00f3digo PHP en su tema o complemento. Los beneficios de hacer esto es que todos sus campos estar\u00e1n disponibles independientemente de la instancia de WordPress en la que est\u00e9 trabajando (por ejemplo, si necesita cambiar entre local, servidor de prueba y servidor en vivo). Puede configurar todos los campos en el administrador de ACF y usar la herramienta de exportaci\u00f3n para exportarlo a PHP.<\/p>\n

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

Sin embargo, si hace esto con frecuencia, puede notar que la exportaci\u00f3n PHP de ACF contiene una gran cantidad de c\u00f3digo que hace que sus archivos PHP sean innecesariamente largos. En algunos casos, es mejor escribir el c\u00f3digo usted mismo, con el m\u00ednimo necesario, para obtener un c\u00f3digo m\u00e1s limpio en su tema o complemento. Esta gu\u00eda tiene como objetivo brindarle una referencia completa sobre c\u00f3mo escribir manualmente agregando campos y grupos ACF en PHP. Tenga en cuenta que no entrar\u00e1 en detalles sobre cada tipo de campo, ya que se supone que ya est\u00e1 familiarizado con los diferentes campos posibles en ACF.<\/p>\n

Pero primero; algunas precauciones<\/h2>\n

Para mantener buenos est\u00e1ndares de c\u00f3digo y garantizar que su sitio de WordPress no se bloquee, siempre debe verificar si las funciones o clases que usa su c\u00f3digo realmente existen. Especialmente cuando se trata de complementos que pueden desactivarse f\u00e1cilmente o ni siquiera instalarse en un sitio, siempre debe envolver el c\u00f3digo espec\u00edfico de su complemento en una prueba if que verifique si las funciones que usa existen, antes de usarlas.<\/p>\n

En cuanto a ACF, puede hacerlo comprobando si existe la clase 'acf'<\/code>o si existe la funci\u00f3n para agregar campos y grupos, 'acf_add_local_field_group'<\/code>. Envuelva cualquiera de ellos alrededor del c\u00f3digo a continuaci\u00f3n.<\/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 agregar metaboxes (grupos) y campos, usamos el gancho llamado acf\/init<\/code>. Dentro de la funci\u00f3n llamamos a la funci\u00f3n acf_add_local_field_group()<\/code>con una matriz como par\u00e1metro. Dentro de esa matriz est\u00e1 la configuraci\u00f3n completa del grupo y todos sus campos. Las m\u00e1s importantes son las claves de matriz 'fields'<\/code>y 'location'<\/code>. Para la clave de matriz 'fields'<\/code>, proporciona la matriz para todos los campos, y para la clave 'location'<\/code>, proporciona la configuraci\u00f3n de d\u00f3nde debe aparecer el metabox. Esta publicaci\u00f3n detallar\u00e1 las posibles opciones que tiene para cada uno de estos a continuaci\u00f3n.<\/p>\n
Esto es lo m\u00ednimo para agregar un grupo, adem\u00e1s de los campos y la ubicaci\u00f3n:<\/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 necesita una clave \u00fanica, pero el nombre real en s\u00ed mismo no importa mucho (para nosotros). Si est\u00e1 agregando m\u00e1s grupos, no olvide cambiar el 'key'<\/code>campo. El t\u00edtulo del metabox se puede establecer en el elemento clave de matriz, lo adivin\u00f3, 'title'<\/code>. Si est\u00e1 agregando varios metaboxes en la misma ubicaci\u00f3n (por ejemplo, en la edici\u00f3n posterior), puede controlar cu\u00e1l viene primero al proporcionar diferentes n\u00fameros en 'menu_order'<\/code>.<\/p>\n
Puede controlar el dise\u00f1o del metabox proporcionando default<\/code>eller seamless<\/code>en formato 'style'<\/code>. Sin embargo, con el nuevo editor de Gutenberg esto tiene mucha menos importancia. Lo mismo ocurre con la clave 'position'<\/code>donde en los viejos tiempos pod\u00edas colocar el metabox debajo del contenido de la publicaci\u00f3n ('normal'<\/code>), al costado ('side'<\/code>) o justo despu\u00e9s del t\u00edtulo de la publicaci\u00f3n ('acf_after_title'<\/code>).<\/p>\n
\u00a1Bien! Profundicemos en los dos elementos m\u00e1s interesantes de la matriz; comenzando con la ubicaci\u00f3n, que define d\u00f3nde aparece el metabox.<\/p>\n
Ubicaci\u00f3n<\/h2>\n
Esto es todo acerca de lo que pones en la llave 'location'<\/code>. Pero antes de analizar las posibles opciones, debemos comprender su estructura de matriz.<\/p>\n
'location'<\/code>acepta una matriz con una matriz de elementos en una matriz! Sostener. S\u00ed, porque es posible proporcionar y combinar la l\u00f3gica AND y OR en la ubicaci\u00f3n (por ejemplo, "mostrar en la edici\u00f3n de publicaciones, pero no si el tipo de publicaci\u00f3n es ‘libro’", o "mostrar en la pantalla de edici\u00f3n de usuarios y tambi\u00e9n crear una nueva pantalla de usuario, pero para ambos casos no si el rol actual es autor"). La forma en que significa si es un AND o un OR es estructurando las matrices. Es mucho m\u00e1s f\u00e1cil mostrar que explicar con palabras:<\/p>\n
As\u00ed es como combina dos elementos de ubicaci\u00f3n con la l\u00f3gica AND (ambos deben ser verdaderos):<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ],\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
Y esto es para combinar ubicaciones con l\u00f3gica OR (solo una debe ser verdadera):<\/p>\n
'location' => [\n    [\n        [\n            \/\/ location 1\n        ]\n    ],\n    [\n        [\n            \/\/ location 2\n        ]\n    ]\n]<\/code><\/pre>\n
\u00bfVer la diferencia?<\/p>\n
Bien, sigamos adelante. Cada opci\u00f3n de ubicaci\u00f3n consta de una matriz de tres elementos; 'param'<\/code>que es donde agregamos todas las diferentes ubicaciones, 'operator'<\/code>, y 'value'<\/code>. El operador es c\u00f3mo comparar el valor, y puede ser '=='<\/code>igual o '!='<\/code>diferente.<\/p>\n
Repasemos las posibles opciones una por una.<\/p>\n
Ubicaci\u00f3n por tipo de publicaci\u00f3n<\/h3>\n
[\n    'param' => 'post_type',\n    'operator' => '==',\n    'value' => 'post'\n]<\/code><\/pre>\n
Establezca el tipo de publicaci\u00f3n que desee en 'value'<\/code>. Tenga en cuenta que no puede proporcionar una matriz de varios tipos de publicaciones, debe combinar varias de estas matrices en una configuraci\u00f3n AND.<\/p>\n
Ubicaci\u00f3n por estado de la publicaci\u00f3n<\/h3>\n
[\n    'param' => 'post_status',\n    'operator' => '==',\n    'value' => 'publish'\n]<\/code><\/pre>\n
Establezca el estado de publicaci\u00f3n deseado como 'value'<\/code>. Nuevamente, tenga en cuenta que no puede proporcionar una matriz de m\u00faltiples estados de publicaci\u00f3n, deber\u00e1 proporcionar cada valor deseado en una configuraci\u00f3n AND u OR.<\/p>\n
Ubicaci\u00f3n por plantilla de p\u00e1gina<\/h3>\n
[\n    'param' => 'page_template',\n    'operator' => '==',\n    'value' => 'template-name.php'\n]<\/code><\/pre>\n
Esto se muestra solo si la p\u00e1gina seleccionada (o el tipo de publicaci\u00f3n personalizada con soporte de plantilla de p\u00e1gina) ha elegido el nombre de plantilla de p\u00e1gina proporcionado.<\/p>\n
Ubicaci\u00f3n por t\u00e9rmino taxon\u00f3mico asignado<\/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
Esta ubicaci\u00f3n es para cuando una publicaci\u00f3n tiene asignado un t\u00e9rmino espec\u00edfico. Deber\u00e1 proporcionar el nombre de la taxonom\u00eda, dos puntos y el slug del t\u00e9rmino como valor.<\/p>\n
Ubicaci\u00f3n por tipo de p\u00e1gina<\/h3>\n
ACF agrupa las propiedades especiales de las p\u00e1ginas como "tipo de p\u00e1gina". Se trata principalmente de si la p\u00e1gina actual es o no una p\u00e1gina principal o secundaria, pero tambi\u00e9n para las p\u00e1ginas de orientaci\u00f3n configuradas como p\u00e1gina principal de WordPress o p\u00e1gina 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
Ubicaci\u00f3n: taxonom\u00eda<\/h3>\n
Una ubicaci\u00f3n para editar o agregar un t\u00e9rmino en una taxonom\u00eda.<\/p>\n
[\n    'param' => 'taxonomy',\n    'operator' => '==',\n    'value' => 'category'  \/\/ Or 'all' for all taxonomies\n]<\/code><\/pre>\n
Proporcione el nombre de la taxonom\u00eda como 'value'<\/code>. Tenga en cuenta que no puede proporcionar una matriz de m\u00faltiples taxonom\u00edas, pero puede proporcionar 'all'<\/code>para orientar todas las taxonom\u00edas.<\/p>\n
Ubicaci\u00f3n: usuario<\/h3>\n
Esta ubicaci\u00f3n es para agregar o editar un perfil de usuario.<\/p>\n
[\n    'param' => 'user_form',\n    'operator' => '==',\n    'value' => 'all'  \/\/ 'edit' || 'register'\n]<\/code><\/pre>\n
Proporcione 'edit<\/code>‘ para apuntar solo a la pantalla de edici\u00f3n de usuarios existentes, 'register'<\/code>para apuntar solo al formulario al registrar un nuevo usuario, o ‘ all'<\/code>para ambos de los anteriores.<\/p>\n
Ubicaci\u00f3n: elemento del men\u00fa<\/h3>\n
Desde ACF 5.6, tambi\u00e9n puede agregar grupos de campos a los elementos del men\u00fa.<\/p>\n
[\n    'param' => 'nav_menu_item',\n    'operator' => '==',\n    'value' => 'all'\n]<\/code><\/pre>\n
Puede configurar value<\/code>para all<\/code>aplicar el grupo a todos los elementos del men\u00fa, o puede especificar men\u00fas por ubicaci\u00f3n (ubicaciones registradas en su tema) o por ID de men\u00fa. Para uso de ubicaci\u00f3n 'location\/<name>'<\/code>, por lo que para una ubicaci\u00f3n llamada ‘ primary<\/code>‘ puede establecer un valor 'location\/primary'<\/code>para aplicar su grupo a un men\u00fa asignado solo a esta ubicaci\u00f3n. Si desea apuntar a un ID de men\u00fa espec\u00edfico, establezca el valor en una cadena de ese ID.<\/p>\n
Ubicaci\u00f3n: widget<\/h3>\n
ACF incluso le proporciona una ubicaci\u00f3n dentro de la configuraci\u00f3n del widget sin modificar el c\u00f3digo central del widget.<\/p>\n
[\n    'param' => 'widget',\n    'operator' => '==',\n    'value' => 'tag_cloud'  \/\/ or 'all' for all widgets\n]<\/code><\/pre>\n
Puede apuntar a todos los widgets con 'all'<\/code>como 'value'<\/code>, o apuntar a un widget espec\u00edfico. Necesitar\u00e1 saber el "ID interno" del widget con el que est\u00e1n registrados.<\/p>\n
Ubicaci\u00f3n: p\u00e1gina de opciones de ACF (solo Pro)<\/h3>\n
Con ACF Pro puede usar ACF para configurar p\u00e1ginas de administraci\u00f3n personalizadas.<\/p>\n
[\n    'param' => 'options_page',\n    'operator' => '==',\n    'value' => 'acf-options-myoptionspage'\n]<\/code><\/pre>\n
Proporcione el nombre que estableci\u00f3 en acf_add_options_page<\/code>‘s menu_slug<\/code>as 'value'<\/code>.<\/p>\n
Ubicaci\u00f3n: bloque (solo Pro 5.8+)<\/h3>\n
ACF Pro (5.8+) tiene una funci\u00f3n para agregar bloques de Gutenberg con campos de ACF y controlar su salida con PHP. Bastante ingenioso para aquellos que a\u00fan no se han sumergido en agregar bloques personalizados de Gutenberg y el Javascript requerido.<\/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
Ahora estamos entrando en la parte m\u00e1s interesante; los campos mismos. ACF ofrece una (realmente) amplia gama de tipos de campo, y lo reiterar\u00e9; esta gu\u00eda no le muestra qu\u00e9 es cada campo y c\u00f3mo funcionan o c\u00f3mo se ven.<\/p>\n
En la matriz principal que proporciona 'fields'<\/code>, acf_add_local_field_group()<\/code>proporciona una matriz donde cada campo es su propia matriz.<\/p>\n
El m\u00ednimo absoluto requerido para cada campo es el siguiente: un \u00fanico 'key'<\/code>que puede ser cualquier cosa que desee y probablemente nunca necesite consultarlo. Tambi\u00e9n necesita 'name'<\/code>cu\u00e1l es la clave meta (publicaci\u00f3n, usuario, t\u00e9rmino) en la que se guarda el valor del campo, y esta es la clave a la que se referir\u00e1 cuando obtenga el valor de los campos. Debe proporcionar un 'label'<\/code>y finalmente el crucial 'type'<\/code>que define qu\u00e9 tipo de campo estamos manejando. El resto de los campos depende de 'type'<\/code>como veremos cuando analicemos cada tipo de campo a continuaci\u00f3n.<\/p>\n
Este es el c\u00f3digo esqueleto para agregar un 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
Tenga en cuenta que necesitar\u00e1 lo anterior para cada campo, pero para no repetir el mismo c\u00f3digo, cada tipo de campo a continuaci\u00f3n solo incluir\u00e1 'type'<\/code>y cualquier otro elemento necesario para ese tipo de campo.<\/p>\n
Campo: entrada de texto<\/h3>\n
El campo m\u00e1s simple de todos. Todo lo que realmente necesitamos es:<\/p>\n
[\n    'type' => 'text',\n]<\/code><\/pre>\n
Pero para personalizar a\u00fan m\u00e1s su entrada de texto, tambi\u00e9n puede proporcionar cualquiera de los siguientes:<\/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: \u00e1rea de texto<\/h3>\n
[\n    'type' => 'textarea',\n    'rows' => 5,\n    'new_lines' => 'wpautop',  \/\/ 'br' || ''\n    'default_value' => 'Default value',\n]<\/code><\/pre>\n
Campo: Control deslizante de rango<\/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: Contrase\u00f1a<\/h3>\n
Igual que la entrada de texto, excepto que todo lo que escriba en \u00e9l se cubrir\u00e1 con * como es de esperar en un campo de contrase\u00f1a.<\/p>\n
[\n    'type' => 'password',\n    'prepend' => 'Prepend text',\n    'append' => 'Appended text',\n]<\/code><\/pre>\n
Campo: Imagen<\/h3>\n
Selecci\u00f3n de una sola imagen.<\/p>\n
[\n    'type' => 'image',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n    'preview_size' => 'thumbnail',\n]<\/code><\/pre>\n
Campo: Archivo<\/h3>\n
Similar a la imagen de arriba, excepto que no muestra una vista previa del archivo.<\/p>\n
[\n    'type' => 'file',\n    'return_format' => 'array',  \/\/ 'id' || 'url'\n]<\/code><\/pre>\n
Tambi\u00e9n puede proporcionarlo 'mime_types' => '',<\/code>y configurarlo, por ejemplo, 'pdf,docx'<\/code>para que solo permita archivos PDF y DOCX.<\/p>\n
Campo: Editor WYSIWYG<\/h3>\n
WYSIWYG es un editor de "Lo que ves es lo que obtienes", con el que est\u00e1bamos familiarizados antes de que llegara 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
El par\u00e1metro 'media_upload'<\/code>y 'delay'<\/code>puede ser 1 (verdadero) o 0 (falso).<\/p>\n
Campo: Seleccionar<\/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: casilla de verificaci\u00f3n<\/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
Tenga en cuenta que 'default_value'<\/code>puede ser una matriz de m\u00faltiples opciones.<\/p>\n
Campo: Bot\u00f3n de opci\u00f3n<\/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
La configuraci\u00f3n 'other_choice'<\/code>en verdadero agrega un bot\u00f3n de opci\u00f3n adicional con la etiqueta "Otro" con una entrada de texto donde el usuario puede escribir algo.<\/p>\n
Campo: Verdadero\/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
El 'ui_on_text'<\/code>y 'ui_off_text'<\/code>solo es v\u00e1lido si 'ui'<\/code>es 1, ya que est\u00e1n definiendo lo que deber\u00eda aparecer en el selector de interfaz de usuario especial.<\/p>\n
Campo: Enlace<\/h3>\n
Le da un bot\u00f3n para ingresar un enlace, ya sea escribiendo o eligiendo contenido en su sitio de WordPress (debe estar familiarizado al agregar un enlace en el editor normal de WordPress).<\/p>\n
[\n    'type' => 'link',\n    'return_format' => 'url',  \/\/ 'array'\n]<\/code><\/pre>\n
Campo: Publicar objeto<\/h3>\n
Da un cuadro de selecci\u00f3n donde puede elegir contenido de WordPress. La selecci\u00f3n le permite buscar escribiendo y todo el contenido se divide por tipo de publicaci\u00f3n. Puede permitir que se elijan varias publicaciones o solo una.<\/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: Relaci\u00f3n<\/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: Elija t\u00e9rminos en una taxonom\u00eda<\/h3>\n
El selector de t\u00e9rminos de taxonom\u00eda tiene cuatro "modos" o tipos diferentes donde dos de ellos permiten m\u00faltiples opciones.<\/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: Seleccionar usuario<\/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
Tenga en cuenta que debe proporcionar una clave API de GoogleMaps v\u00e1lida a ACF para que este campo funcione, as\u00ed:<\/p>\n
add_filter('acf\/fields\/google_map\/api', function($api) {\n    $api['key'] = 'YOURAPIKEY';\n    return $api;\n});<\/code><\/pre>\n
Campo: Selector de fecha<\/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: Selector de fecha y 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: Selector de tiempo<\/h3>\n
[\n    'type' => 'time_picker',\n    'display_format' => 'H:i',\n    'return_format' => H:i',\n]<\/code><\/pre>\n
Campo: Selector de color<\/h3>\n
[\n    'type' => 'color_picker',\n    'default_value' => '',  \/\/ or any hex code, e.g. '#FFFFFF'\n]<\/code><\/pre>\n
Campo: Galer\u00eda (solo 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 especiales de campos.<\/h3>\n
ACF tambi\u00e9n ofrece algunos tipos de campos que no guardan un valor per se, pero son m\u00e1s para fines organizacionales. Para todos estos establecidos 'name'<\/code>en una cadena vac\u00eda.<\/p>\n
Mensaje HTML<\/h4>\n
Si necesita simplemente imprimir algo de HTML sin que realmente guarde un valor, puede 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 (solo ACF Pro)<\/h4>\n
Un repetidor contiene una serie de campos que se pueden repetir.<\/p>\n
[\n    'type' => 'repeater',\n    'layout' => 'table',  \/\/ 'block' || 'row'\n    'button_label' => __('Add new', 'txtdomain'),\n    'sub_fields' => [],\n]<\/code><\/pre>\n
El elemento sub_fields<\/code>espera una matriz de campos, tal como configur\u00f3 los campos arriba.<\/p>\n
Conclusi\u00f3n<\/h2>\n
Esta no es una gu\u00eda exhaustiva, ya que ACF ofrece una amplia gama de opciones y personalizaciones. Pero deber\u00eda cubrir las opciones m\u00e1s utilizadas y los casos de uso personalizados. Personalmente, me encuentro refiri\u00e9ndome a esto con bastante frecuencia cada vez que agrego campos ACF para clientes. E incluso para las opciones m\u00e1s extra\u00f1as, esta gu\u00eda es suficiente para no tener que inflar mis archivos PHP con el c\u00f3digo de exportaci\u00f3n de ACF. \u00a1Espero que esto haya sido \u00fatil para ti tambi\u00e9n!<\/p>\n
Fuente de grabaci\u00f3n:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Una referencia completa sobre c\u00f3mo configurar bien los campos y grupos de campos personalizados avanzados por c\u00f3digo PHP en lugar de pegar c\u00f3digo inflado de la herramienta de exportaci\u00f3n ACF PHP.<\/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":[892,892,810,716,716,1110,810,840,840,861,861],"tags":[1172],"class_list":["post-233803","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo","category-complementos","category-desarrollador","category-n-a","category-tutoriales","category-wordpress-2","tag-affiai-es"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233803","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/comments?post=233803"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233803\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media\/224889"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media?parent=233803"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/categories?post=233803"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/tags?post=233803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}