Un campo de Grupo agrupa varios campos relacionados en una única unidad organizada. Mientras que un Repeater permite a los editores añadir múltiples filas de datos, un Grupo siempre contiene exactamente un conjunto de subcampos. Es la opción adecuada cuando tienes campos que naturalmente pertenecen juntos y solo aparecen una vez — como un bloque de dirección, una sección de llamada a la acción, o una tarjeta de información de contacto.
Los Grupos sirven para dos propósitos. Primero, organizan la experiencia de edición agrupando visualmente los campos relacionados dentro de un contenedor con borde. Segundo, organizan tu estructura de datos — los campos agrupados se almacenan juntos, lo que facilita el trabajo de tu desarrollador en las plantillas del tema.
Cuándo Usar un Grupo vs. Campos Separados
Puede que te preguntes por qué necesitas Grupos en absoluto. Después de todo, podrías simplemente añadir Calle, Ciudad, Estado y Código Postal como cuatro campos separados en tu grupo de campos. Aquí está la razón por la que los Grupos son mejores:
| Sin un Grupo | Con un Grupo |
|---|---|
| Calle, Ciudad, Estado, Código Postal aparecen como cuatro campos separados mezclados con otros campos | Calle, Ciudad, Estado, Código Postal aparecen dentro de un contenedor “Dirección” con borde, visualmente distintos de otros campos |
Tu desarrollador hace referencia a cada campo individualmente: get_field('street'), get_field('city') | Tu desarrollador hace referencia al grupo: get_field('address') y obtiene los cuatro valores como un array estructurado |
Si tienes una dirección Y una dirección de facturación, los nombres de los campos se confunden: street, billing_street | Anidamiento limpio: address.street y billing_address.street |
| Añadir un nuevo campo relacionado con la dirección significa encontrar el lugar adecuado entre todos los campos | Añadir un nuevo campo dentro del grupo de Dirección mantiene todo junto |
Paso a Paso: Construyendo un Grupo de Información de Contacto
El escenario: Tienes un negocio con múltiples ubicaciones. Cada ubicación es un tipo de publicación personalizada, y cada ubicación necesita información de contacto: número de teléfono, dirección de correo electrónico, horas de oficina y una URL de incrustación de Google Maps. Estas cuatro piezas de datos pertenecen lógicamente juntas como “Información de Contacto.”- Ve a Field Forge > Nuevo Grupo de Campos
- Introduce el título: Detalles de la Ubicación
- Haz clic en Añadir Campo y elige Grupo en la cuadrícula de tipos de campo (bajo “Campos Compuestos,” insignia PRO)
- Configura el Grupo:
– Nombre: contact_information
– Instrucciones: Introduce los detalles de contacto para esta ubicación. Todos los campos se muestran en la barra lateral y pie de página de la ubicación.
– Diseño: Bloque (muestra el grupo como una tarjeta con borde con subcampos dentro)
- Añade subcampos dentro del Grupo:
– Etiqueta: Número de Teléfono
– Nombre: phone_number
– Requerido: Sí
– Marcador de posición: “(555) 123-4567”
– Ancho del Contenedor: 50%
– Haz clic en Añadir Subcampo, elige Correo Electrónico:
– Etiqueta: Dirección de Correo Electrónico
– Nombre: email_address
– Requerido: Sí
– Marcador de posición: “[email protected]”
– Ancho del Contenedor: 50%
– Haz clic en Añadir Subcampo, elige Área de Texto:
– Etiqueta: Horas de Oficina
– Nombre: office_hours
– Instrucciones: Introduce las horas en un formato legible, por ejemplo, “Lun-Vie: 9am-5pm, Sáb: 10am-2pm, Dom: Cerrado”
– Filas: 3
– Ancho del Contenedor: 100%
– Haz clic en Añadir Subcampo, elige URL:
– Etiqueta: Enlace de Google Maps
– Nombre: google_maps_link
– Instrucciones: Pega la URL de Google Maps para esta ubicación. Ve a Google Maps, encuentra la ubicación, haz clic en Compartir y copia el enlace.
– Ancho del Contenedor: 100%
- Ahora añade un segundo campo de Grupo en el mismo grupo de campos para la dirección:
– Etiqueta: Dirección Física
– Nombre: physical_address
– Añade subcampos: Dirección (texto, 100%), Ciudad (texto, 40%), Estado (selección, 30%), Código Postal (texto, 30%)
- Establece la regla de ubicación: Tipo de Publicación es igual a Ubicación
- Haz clic en Guardar Grupo de Campos
[Captura de pantalla: el editor del grupo de campos Detalles de la Ubicación mostrando dos campos de Grupo — “Información de Contacto” con subcampos de teléfono, correo, horas y enlace de mapas, y “Dirección Física” con subcampos de calle, ciudad, estado y código postal organizados en un diseño de múltiples columnas]
Cómo Usan los Editores un Grupo
Cuando un gestor de contenido abre una publicación de Ubicación, ve el metabox “Detalles de la Ubicación” que contiene dos secciones con borde: “Información de Contacto” y “Dirección Física.” Cada sección está claramente etiquetada y contiene su propio conjunto de campos. El editor completa cada campo como cualquier otro campo — no hay un botón “Añadir Fila” porque un Grupo siempre contiene exactamente un conjunto de datos.
La diferencia clave con respecto a los campos regulares es visual: el contenedor con borde deja claro de inmediato qué campos se relacionan con la información de contacto y cuáles se relacionan con la dirección. Sin Grupos, los ocho campos aparecerían como una lista plana, y no sería obvio que Teléfono y Correo pertenecen juntos mientras que Calle y Ciudad pertenecen juntos.
Grupos vs. Repeaters — Una Guía de Decisión
Esta es la pregunta más común de las personas que configuran grupos de campos. Aquí hay un marco de decisión claro:
| Pregúntate a Ti Mismo | Si la Respuesta Es… | Usa |
|---|---|---|
| ¿Cuántos conjuntos de estos datos habrá? | Siempre exactamente uno (una dirección, una CTA) | Grupo |
| ¿Cuántos conjuntos de estos datos habrá? | Varía — podría ser 1, 5 o 50 (miembros del equipo, preguntas frecuentes) | Repeater |
| ¿Pueden los editores añadir más de estos? | No — siempre hay un bloque de información de contacto por ubicación | Grupo |
| ¿Pueden los editores añadir más de estos? | Sí — pueden añadir más miembros del equipo a medida que la empresa crece | Repeater |
| ¿Este dato representa una “sección” o una “lista”? | Una sección (un Hero, una CTA) | Grupo |
| ¿Este dato representa una “sección” o una “lista”? | Una lista (muchas preguntas frecuentes, muchos testimonios) | Repeater |
Anidando Grupos y Repeaters Juntos
Los Grupos y Repeaters funcionan maravillosamente juntos. Aquí hay dos patrones comunes:
Patrón 1: Un Repeater donde cada fila contiene un GrupoUna página de “Servicios” donde cada servicio tiene su propio bloque de precios:
- Servicios (Repeater — múltiples servicios)
– Descripción del Servicio (área de texto)
– Precios (Grupo — un bloque de precios por servicio)
– Precio Mensual (número)
– Precio Anual (número)
– Moneda (selección)
– Incluye Prueba Gratuita (verdadero/falso)
Patrón 2: Un Grupo que contiene un RepeaterUna sección de “Descripción de la Empresa” con un encabezado fijo y una lista variable de logros:
- Descripción de la Empresa (Grupo — una descripción por página)
– Descripción (wysiwyg)
– Imagen de Fondo (imagen)
– Logros Clave (Repeater — múltiples logros)
– Año (texto)
– Título del Logro (texto)
– Descripción (área de texto)
Consejos de Ancho de Contenedor para Grupos
Usa anchos de contenedor en subcampos dentro de un Grupo para crear diseños pulidos, similares a formularios:
| Objetivo de Diseño | Anchos de Subcampo |
|---|---|
| Dos campos uno al lado del otro | 50% + 50% |
| Tres campos en una fila | 33% + 33% + 34% |
| Uno grande, uno pequeño | 70% + 30% |
| Ancho completo debajo de una fila de campos pequeños | Primera fila: 33% + 33% + 34%, siguiente campo: 100% |
> Qué sucede sin PRO: Los campos de Grupo requieren el plan PRO. Sin ellos, añades campos relacionados como campos separados de nivel superior en el grupo de campos. Siguen funcionando funcionalmente, pero pierdes el agrupamiento visual (el contenedor con borde) y la organización estructurada de datos. Para casos simples con 2-3 campos relacionados, esto está bien. Para modelos de datos complejos con múltiples grupos de campos relacionados, los Grupos hacen que la experiencia de edición sea significativamente más limpia.
> Consejo: Nombra tus Grupos claramente. En lugar de “Grupo 1” o “Detalles,” usa nombres específicos como “Información de Contacto,” “Dirección Física,” o “Configuraciones de Llamada a la Acción.” La etiqueta del Grupo aparece como un encabezado de sección en el editor, y nombres claros ayudan a los editores a entender de inmediato para qué es cada sección.
> Error común: Usar un Grupo cuando se necesita un Repeater (o viceversa). Si creas un Grupo para “Miembros del Equipo” pero luego te das cuenta de que cada página necesita múltiples miembros del equipo, tendrás que eliminar el Grupo y recrearlo como un Repeater. Piensa en si los datos se repiten antes de elegir.