Páginas de Opciones — Configuraciones Globales (PRO)

Los grupos de campos regulares adjuntan datos a publicaciones o páginas individuales — una sección de héroe en la página Acerca de, detalles del producto en una publicación de producto, una biografía en el perfil de un miembro del equipo. Pero cierta información no pertenece a ninguna publicación en particular. Pertenece a todo el sitio. El número de teléfono de tu empresa aparece en el encabezado y pie de página de cada página. Tus enlaces de redes sociales aparecen en el pie de página y en la página de contacto. Un banner de anuncio global se extiende por la parte superior de cada pantalla. ¿Dónde gestionas estos datos?

Las Páginas de Opciones resuelven este problema. Una Página de Opciones es una pantalla de administración dedicada — visible en el menú lateral de WordPress — donde los gestores de contenido ingresan datos globales que están disponibles en todas partes. No está vinculada a una publicación o página. Está vinculada al propio sitio.

Casos de Uso Comunes para Páginas de Opciones

Paso a Paso: Crear una Página de Opciones “Configuraciones del Sitio” Completa

> Tres formas de crear una Página de Opciones en Field Forge:

>

> 1. Interfaz de Administración (recomendado para gestores de contenido) — ve a Field Forge > Páginas de Opciones y haz clic en Agregar Nueva Página de Opciones. Completa el Título de la Página, Slug del Menú, Capacidad, Página Padre, Icono, Posición. Guarda. El elemento del menú aparece inmediatamente en la barra lateral de administración de WordPress. Puedes editar o eliminar suavemente la página más tarde desde la misma lista.

> 2. Registro automático desde un grupo de campos — si un grupo de campos tiene una regla de ubicación Options Page == , Field Forge registra automáticamente un elemento de menú de nivel superior con el título del grupo. Sin código, sin pasos adicionales de administración. Útil cuando la página existe solo para albergar un grupo de campos.

> 3. Fragmento de PHP — llama a fieldforge_add_options_page([...]) (o el compatible con ACF acf_add_options_page([...])) desde el functions.php de tu tema. Usa esto cuando quieras que el registro de la página viva junto al resto del código de tu tema (para que se despliegue con el tema).

>

> Las tres aproximaciones coexisten — puedes mezclar y combinar. La interfaz de administración lista páginas de cada fuente, pero solo las páginas registradas en la base de datos tienen acciones de editar/eliminar; las páginas registradas en PHP son de solo lectura en la interfaz (cámbialas en el código).

#### Parte 1a (recomendado): Crear la Página de Opciones en la Interfaz de Administración

1. Ve a Field Forge > Páginas de Opciones
2. Haz clic en Agregar Nueva Página de Opciones
3. Completa el formulario:

– Título del Menú: “Configuraciones del Sitio” (o deja en blanco para reutilizar el título de la página)

– Slug del Menú: configuraciones-del-sitio (generado automáticamente del título — mantenlo en minúsculas, con guiones)

– Página Padre: “(menú de nivel superior)”

– Capacidad: manage_options (solo Administrador)

– Posición: 80 (ordena el menú en la barra lateral de WordPress)

– Icono: dashicons-admin-generic (o cualquier nombre de Dashicons)

– Texto del Botón de Actualización / Mensaje Actualizado: personaliza si deseas que el botón de guardar o el aviso de éxito digan algo diferente a “Guardar Opciones” / “Opciones guardadas.”

1. Haz clic en Guardar Página de Opciones
2. El elemento del menú “Configuraciones del Sitio” aparece inmediatamente en la barra lateral de WordPress. Haz clic en él — la página está vacía por ahora (sin grupo de campos vinculado aún). Eso viene después.

#### Parte 1b (alternativa): omitir la Parte 1a y dejar que el grupo de campos se registre automáticamente

Si prefieres el flujo más simple donde el título del grupo de campos se convierte en la etiqueta del menú, omite completamente la Parte 1a. La regla de ubicación del grupo de campos (sección siguiente) registrará automáticamente un elemento de menú utilizando el título del grupo. No obtienes la interfaz de Editar / Eliminar para esa página, pero ahorras un paso de administración.

#### Parte 2: Crear el Grupo de Campos que Alimentará la Página de Opciones

1. Ve a Field Forge > Nuevo Grupo de Campos
2. Ingresa el título: Información de la Empresa (esto se convierte en el encabezado del grupo de campos dentro de la Página de Opciones; si omitiste la Parte 1a, esto también se convierte en la etiqueta del menú)
3. Agrega tus campos:

– Imagen — Etiqueta: Logo de la Empresa, Nombre: company_logo, Instrucciones: “Sube tu logo. Recomendado: SVG o PNG con fondo transparente, al menos 200px de ancho.”

– Texto — Etiqueta: Nombre de la Empresa, Nombre: company_name, Requerido: Sí

– Texto — Etiqueta: Número de Teléfono, Nombre: phone_number, Marcador de posición: “(555) 123-4567”, Contenedor: 50%

– Correo Electrónico — Etiqueta: Dirección de Correo Electrónico, Nombre: email_address, Contenedor: 50%

– Área de Texto — Etiqueta: Dirección de la Oficina, Nombre: office_address, Filas: 3

– Campo de Pestaña — Etiqueta: “Redes Sociales” (crea una segunda pestaña)

– URL — Etiqueta: URL de Facebook, Nombre: facebook_url, Marcador de posición: “https://facebook.com/tuempresa”, Contenedor: 50%

– URL — Etiqueta: URL de Twitter/X, Nombre: twitter_url, Contenedor: 50%

– URL — Etiqueta: URL de Instagram, Nombre: instagram_url, Contenedor: 50%

– URL — Etiqueta: URL de LinkedIn, Nombre: linkedin_url, Contenedor: 50%

– URL — Etiqueta: URL de YouTube, Nombre: youtube_url, Contenedor: 50%

– Campo de Pestaña — Etiqueta: “Barra de Anuncios”

– Verdadero/Falso — Etiqueta: Mostrar Anuncio, Nombre: show_announcement, Predeterminado: No, Instrucciones: “Activa esto para mostrar un banner de anuncio global en la parte superior de cada página.”

– Texto — Etiqueta: Texto del Anuncio, Nombre: announcement_text, Marcador de posición: “¡Estamos contratando! Consulta nuestra página de carreras.”

– URL — Etiqueta: Enlace del Anuncio, Nombre: announcement_link

– Selector de Color — Etiqueta: Color de Fondo del Anuncio, Nombre: announcement_bg_color, Predeterminado: #2563EB

1. Desplázate hacia abajo hasta Reglas de Ubicación
2. Establece: Página de Opciones es igual a un slug como configuraciones-del-sitio (esto se convierte en el slug de la página del menú — mantenlo corto y en minúsculas)
3. Haz clic en Guardar Grupo de Campos
4. El nuevo elemento del menú aparece en la barra lateral de WordPress con el título de tu grupo de campos (“Información de la Empresa”) como la etiqueta del menú

> ¿Quieres una etiqueta de menú, icono o posición diferente? Agrega un pequeño fragmento a tu functions.php del tema. El slug debe coincidir con lo que configuraste en la regla de ubicación:

>

> add_action('init', function () {
>     if (function_exists('fieldforge_add_options_page')) {
>         fieldforge_add_options_page([
>             'page_title' => 'Configuraciones del Sitio',
>             'menu_title' => 'Configuraciones del Sitio',
>             'menu_slug'  => 'configuraciones-del-sitio',  // coincide con la regla de ubicación
>             'icon_url'   => 'dashicons-admin-generic',
>             'position'   => 80,
>         ]);
>     }
> });
>

#### Parte 2: Completar las Configuraciones del Sitio

1. Haz clic en el nuevo elemento del menú (“Configuraciones del Sitio” / “Información de la Empresa”) en la barra lateral de administración de WordPress
2. Verás el grupo de campos “Información de la Empresa” con tres pestañas: General, Redes Sociales y Barra de Anuncios
3. En la pestaña General: sube tu logo, ingresa el nombre de la empresa, teléfono, correo electrónico y dirección
4. Cambia a la pestaña de Redes Sociales: pega las URL de tus perfiles de redes sociales
5. Cambia a la pestaña de Barra de Anuncios: activa “Mostrar Anuncio” a Sí, escribe el texto del anuncio, pega un enlace y elige un color de fondo
6. Haz clic en Guardar Cambios (el botón en la parte inferior de la Página de Opciones)

[Captura de pantalla: la Página de Opciones de Configuraciones del Sitio en la administración, mostrando la pestaña General con campos completados — logo subido, nombre de la empresa, teléfono, correo electrónico y dirección ingresados]

Los datos ahora están guardados y disponibles en todo el sitio. Tu desarrollador extrae estos valores en cualquier plantilla — el encabezado, pie de página, página de contacto, barra de anuncios o marcado de esquema.

Editar o Eliminar una Página de Opciones

Las páginas creadas a través de la interfaz de administración (“fuente DB” en la lista) pueden ser editadas o eliminadas en cualquier momento:

• Editar: abre Field Forge > Páginas de Opciones, haz clic en el icono de lápiz junto a la fila. Cambia el título, la etiqueta del menú, la capacidad, el padre, el icono, la posición, el texto del botón o el mensaje de éxito. Guarda. El cambio se refleja en la barra lateral de WordPress inmediatamente en la siguiente carga de la página de administración.
• Eliminar suavemente: haz clic en el icono de papelera. La fila permanece en la base de datos con status = deleted pero el elemento del menú desaparece. Los grupos de campos vinculados a esa página dejan de mostrarse en la administración hasta que lo restaures.
• Restaurar: las filas eliminadas suavemente muestran un icono de restaurar (deshacer) en su columna de acciones. Un clic devuelve la página al estado activo.

Las páginas desde código PHP (fieldforge_add_options_page()) o registradas automáticamente desde una regla de ubicación de grupo de campos se listan para visibilidad pero son de solo lectura en la interfaz — cámbialas editando la fuente.

Creando Sub-Páginas para Mejor Organización

Si tienes muchas configuraciones globales, puedes organizarlas en una página padre con páginas hijas. La interfaz de administración soporta esto directamente — al agregar o editar una página, establece el menú desplegable Página Padre a “Field Forge”, “Configuraciones”, “Apariencia”, “Herramientas”, o cualquier otro menú de nivel superior de WordPress. La página se convierte en una hija de esa página padre.

Para un control más granular (slug padre personalizado, creación por lotes), un fragmento en functions.php aún funciona:

add_action('init', function () {
    if (!function_exists('fieldforge_add_options_page')) return;

    // Padre
    fieldforge_add_options_page([
        'page_title' => 'Configuraciones del Sitio',
        'menu_title' => 'Configuraciones del Sitio',
        'menu_slug'  => 'configuraciones-del-sitio',
        'icon_url'   => 'dashicons-admin-generic',
    ]);

    // Hijos — nota que `parent_slug` coincide con el `menu_slug` del padre
    foreach ([
        'general'      => 'General',
        'social-media' => 'Redes Sociales',
        'appearance'   => 'Apariencia',
        'integrations' => 'Integraciones',
    ] as $slug => $title) {
        fieldforge_add_options_page([
            'page_title'  => $title,
            'menu_title'  => $title,
            'menu_slug'   => $slug,
            'parent_slug' => 'configuraciones-del-sitio',
        ]);
    }
});

Luego crea un grupo de campos por cada slug hijo, con Options Page == general / social-media / etc. como la regla de ubicación. En la barra lateral de administración, estos aparecen como sub-elementos indentados bajo “Configuraciones del Sitio.”

Quién Puede Editar Páginas de Opciones

Por defecto, solo los usuarios con el rol de Administrador pueden acceder a las Páginas de Opciones. Esto se controla mediante la configuración de “Capacidad” al crear la página. Si deseas que los Editores también gestionen la configuración del sitio, cambia la capacidad a edit_posts — pero ten cuidado al otorgar acceso amplio a la configuración del sitio.

> Qué sucede sin PRO: Las Páginas de Opciones son exclusivamente una característica PRO. Sin ellas, los datos a nivel de sitio tendrían que almacenarse en una página “Configuración” oculta, en el Personalizador de WordPress, o codificados de forma rígida en los archivos del tema. Ninguno de estos enfoques proporciona a los gestores de contenido la pantalla de administración limpia y dedicada que ofrece una Página de Opciones. Si tu sitio necesita alguna configuración global que gestionen personas no desarrolladoras, esta característica por sí sola justifica la actualización a PRO.

> Consejo: Las Páginas de Opciones son ideales para datos que cambian infrecuentemente — números de teléfono, URLs de redes sociales, horarios comerciales. Si los datos cambian a diario (como un anuncio), combínalo con un interruptor Verdadero/Falso para que los editores puedan mostrar u ocultar rápidamente sin eliminar y volver a escribir el contenido.

> Error común: Crear demasiadas Páginas de Opciones y perder la pista de dónde se encuentran las configuraciones. Comienza con una página “Configuración del Sitio” y utiliza Pestañas dentro del grupo de campos para organizar diferentes categorías de configuraciones. Solo crea páginas separadas cuando las configuraciones sean realmente no relacionadas (por ejemplo, “Configuración del Sitio” para información de la empresa y “Analíticas” para códigos de seguimiento).