Capa de Compatibilidad ACF — get_field() Funciona Perfectamente

Qué hay en la capa de compatibilidad

Field Forge implementa estas funciones de ACF de forma nativa:

Funciones de campo principales

“php get_field($field_name, $post_id = null, $format_value = true); the_field($field_name, $post_id = null, $format_value = true); get_fields($post_id = null, $format_value = true); get_field_object($field_name, $post_id = null, $format_value = true, $load_value = true); get_field_objects($post_id = null, $format_value = true, $load_value = true); update_field($field_name, $value, $post_id = null); delete_field($field_name, $post_id = null); “

Funciones de bucle de contenido repetido y flexible

“php have_rows($field_name, $post_id = null); the_row($format_value = false); get_row($format_value = false); get_row_index(); get_row_layout(); reset_rows(); “

Funciones de subcampo (dentro de bucles repetidos / grupos / flexibles)

“php get_sub_field($field_name, $format_value = true); the_sub_field($field_name, $format_value = true); get_sub_field_object($field_name, $format_value = true, $load_value = true); update_sub_field($field_name_or_selector, $value, $post_id = null); “

Funciones de grupo de campos

“php acf_get_field_group($id_or_key); acf_get_field_groups($args = []); acf_get_fields($field_group); “

Compatibilidad de página de opciones

“php // Tanto 'options' como 'option' funcionan get_field('site_logo', 'options'); get_field('site_logo', 'option'); “

Compatibilidad de campos de usuario

“php get_field('bio', 'user_123'); update_field('bio', $new_bio, 'user_123'); “

Registro de bloques de Gutenberg

“php acf_register_block_type([ 'name' => 'hero', 'title' => 'Sección Hero', 'render_callback' => 'render_hero_block', 'category' => 'theme', 'icon' => 'cover-image', ]); “

Cada función anterior funciona idénticamente a ACF. Mismos parámetros, mismos valores de retorno, mismo comportamiento.

---

Cómo funciona

Cuando Field Forge está activo:

1. Las funciones globales de ACF son definidas por Field Forge a través de function_exists() guards
2. Las llamadas se dirigen al almacenamiento de Field Forge (la tabla personalizada wp_fieldforge_values)
3. Los valores de retorno coinciden con el formato de ACF — arreglos, objetos, cadenas, objetos WP_Image / WP_Post / WP_User donde sea apropiado
4. Se respeta el parámetro $format_value — pasar false devuelve valores en bruto, true devuelve valores formateados (igual que ACF)

Si ACF también está activo en el mismo sitio (durante la migración), las funciones de Field Forge no están registradas — ACF tiene prioridad. Después de desactivar ACF, las versiones de Field Forge toman el control. Esto significa que puedes instalar Field Forge junto a ACF sin conflictos durante las pruebas.

---

Por qué esto es importante

Migración sin reescrituras de tema

La mayoría de los plugins “alternativos a ACF” requieren que reescribas cada llamada a get_field() en tu tema para usar su propia API. Para un sitio con 200 archivos de plantilla y más de 500 referencias de campos, esto son semanas de trabajo y un alto riesgo de regresiones.

La capa de compatibilidad de Field Forge reduce la migración a:

1. Instalar Field Forge junto a ACF
2. Ejecutar el importador de grupos de campos + valores
3. Desactivar ACF
4. Probar el sitio — las plantillas deberían renderizarse idénticamente
5. Field Forge ahora está sirviendo los mismos datos que ACF solía servir

Cambios en la plantilla cero. Riesgo cero de “Olvidé actualizar esa plantilla”.

Compatibilidad SCF gratis

Secure Custom Fields (el fork de ACF en WordPress.org creado en octubre de 2024) utiliza las mismas funciones de plantilla que ACF — get_field(), have_rows(), etc. Debido a que la capa de compatibilidad de Field Forge implementa la API de ACF, también funciona para el código SCF. Si estás utilizando SCF y deseas migrar a Field Forge, el mismo proceso, la misma capa de compatibilidad.

Compatibilidad de plugins de terceros

Los plugins que se integran con ACF suelen llamar a las funciones globales de ACF. Ejemplos populares:

• WPGraphQL para ACF — lee acf_get_field_groups() y acf_get_fields()
• Elementor Dynamic Tags — lee get_field() para etiquetas de contenido dinámico
• Beaver Themer — lee get_field() para partes de plantilla
• Integración de ACF de Toolset — lee la API de ACF

La mayoría de estos siguen funcionando cuando cambias de ACF a Field Forge porque la capa de compatibilidad proporciona la misma API.

acf_register_block_type() funciona

La función de registro de bloques de ACF es una de las características más comunes de ACF Pro en las que confían las agencias. Los bloques personalizados de Gutenberg registrados a través de acf_register_block_type() siguen funcionando después de la migración:

“`php // Este código funciona sin cambios con Field Forge activo en lugar de ACF acf_register_block_type([ ‘name’ => ‘feature-card’, ‘title’ => __(‘Tarjeta de Característica’), ‘render_callback’ => ‘my_feature_render_callback’, ‘category’ => ‘theme’, ‘icon’ => ‘star-filled’, ]);

function my_feature_render_callback($block) { $title = get_field(‘title’); // Funciona $icon = get_field(‘icon’); // Funciona // … renderizar HTML } “`

---

Qué NO está en la capa de compatibilidad

Para total transparencia, aquí está lo que Field Forge no replica (aún) de ACF:

• Las pantallas de administración de ACF — Field Forge tiene su propio constructor visual con una interfaz diferente
• Los nombres de hooks y filtros de ACF — Field Forge tiene hooks equivalentes, pero con el prefijo fieldforge/ en lugar de acf/
• API de JavaScript acf.php en la administración — Field Forge tiene su propia API de JS
• Algunos filtros de ACF de nicho (extensiones de tipo de campo) — si dependes de tipos de campo personalizados definidos a través de hooks de ACF, la migración puede requerir pequeños ajustes

Para el 95% de los sitios ACF, ninguna de estas lagunas importa porque los desarrolladores de temas solo utilizan las funciones de plantilla, no las API internas.

---

Confianza en la migración

Debido a que la capa de compatibilidad de ACF está probada contra casos de prueba reales de ACF, sabemos que maneja:

• Campos de texto básico, textarea, número, correo electrónico, URL
• Campos WYSIWYG con HTML
• Campos de imagen y archivo (devuelve arreglos que coinciden con el formato de ACF)
• Campos de selección, radio, casilla de verificación (con el parámetro format_value)
• Campos de selección de fecha y hora
• Campos repetidos con anidamiento arbitrario
• Contenido flexible con múltiples diseños
• Campos de grupo
• Campos de relación y objeto de publicación
• Campos de taxonomía y usuario
• Páginas de opciones (tanto 'options' como 'option' pseudo-IDs)
• Callbacks de acf_register_block_type()
• Parámetro format_value en todas las funciones

Si encuentras un caso donde el comportamiento de nuestra capa de compatibilidad difiere de ACF, es un error que queremos corregir. Envía un correo electrónico al soporte con detalles.

---

¿Listo para migrar sin reescribir tu tema?

Obtén Field Forge — desde $35/año →

La capa de compatibilidad de ACF está en cada versión de Field Forge, incluida la gratuita. La migración desde ACF o SCF toma minutos, no semanas.