Páginas de Opciones de WordPress — Campos Personalizados a Nivel de Sitio | Field Forge - Campos personalizados, diseñados para la velocidad
Descargar Iniciar sesión

Páginas de Opciones de WordPress — Campos Personalizados a Nivel de Sitio

Para qué sirven las páginas de opciones

No todos los datos de campos personalizados pertenecen a una entrada. Algunos datos son realmente a nivel de sitio:

  • Información de la empresa — nombre, dirección, teléfono, correo electrónico, número de IVA
  • URLs de redes sociales — Facebook, Instagram, Twitter/X, LinkedIn, YouTube
  • CTAs globales — botones de “Suscribirse al boletín”, “Reservar una llamada”, “Obtener un presupuesto” utilizados en las plantillas
  • Imágenes predeterminadas — imagen destacada de reserva, imagen predeterminada de Open Graph, héroe de la página 404
  • Banderas de características — “mostrar popup de boletín”, “activar el interruptor de modo oscuro”
  • Contenido de marca — eslóganes, declaración de misión, descripción sobre
  • Contenido del pie de página — derechos de autor, enlaces legales, información de soporte

Sin páginas de opciones, almacenarías estos datos en las opciones de WordPress (get_option('company_name')), lo que significa cadenas en bruto sin interfaz de administración y sin seguridad de tipo. Con las páginas de opciones, obtienes una interfaz de campo personalizado adecuada y valores tipados.


Registrando una página de opciones

En Field Forge, registra una página de opciones con una llamada a función en el functions.php de tu tema o en un plugin:

php if (function_exists('fieldforge_add_options_page')) { fieldforge_add_options_page([ 'page_title' => 'Configuración del Sitio', 'menu_title' => 'Configuración del Sitio', 'menu_slug' => 'configuracion-del-sitio', 'capability' => 'manage_options', 'icon_url' => 'dashicons-admin-generic', 'position' => 80, ]); }

Un nuevo elemento de menú aparece en el administrador de WordPress. Cuando haces clic en él, ves una pantalla de edición donde Field Forge renderiza los campos personalizados asignados a esta página de opciones a través de reglas de ubicación.

Páginas secundarias

Puedes registrar páginas secundarias bajo un padre para organizar configuraciones relacionadas:

“`php fieldforge_add_options_sub_page([ ‘page_title’ => ‘Configuración del Encabezado’, ‘menu_title’ => ‘Encabezado’, ‘parent_slug’ => ‘configuracion-del-sitio’, ]);

fieldforge_add_options_sub_page([ ‘page_title’ => ‘Configuración del Pie de Página’, ‘menu_title’ => ‘Pie de Página’, ‘parent_slug’ => ‘configuracion-del-sitio’, ]); “`

Las páginas secundarias aparecen anidadas bajo “Configuración del Sitio” en el menú de administración.


Asignando grupos de campos a páginas de opciones

Después de registrar una página de opciones, crea un grupo de campos en el constructor visual de Field Forge y establece las reglas de ubicación:

Reglas de Ubicación: La Página de Opciones es igual a "configuracion-del-sitio"

Cualquier campo en este grupo aparece en la página de opciones de Configuración del Sitio. Crea tantos grupos de campos como desees por página de opciones, divídelos lógicamente (por ejemplo, “Información de la Empresa”, “Perfiles Sociales”, “Contenido del Pie de Página”).


Código de plantilla

Accede a los valores de la página de opciones con la misma función get_field() que usas para los metadatos de las entradas, pero pasa 'options' como el segundo argumento:

“`php // Sintaxis compatible con ACF $company_name = get_field(‘company_name’, ‘options’); $company_phone = get_field(‘phone’, ‘options’); $facebook_url = get_field(‘facebook_url’, ‘options’);

// Tanto ‘options’ como ‘option’ funcionan como pseudo-IDs $logo = get_field(‘site_logo’, ‘option’); // Mismo resultado “`

En las plantillas:

php


La misma sintaxis funciona en sitios de ACF, SCF y Field Forge. La portabilidad del código entre los tres plugins es intencionada: si alguna vez necesitas cambiar entre ellos, tu tema no se romperá.


Almacenamiento

Los valores de la página de opciones se almacenan en una tabla dedicada: wp_fieldforge_options. Separada de los valores de campos de entradas, separada de la tabla nativa de wp_options de WordPress.

¿Por qué una tabla separada?

  • Separación limpia — páginas de opciones vs campos de entradas vs opciones del núcleo de WordPress son conceptualmente diferentes
  • Rendimiento — índices dedicados para búsquedas rápidas de páginas de opciones
  • Aislamiento — otros plugins que escriben en wp_options no afectan los datos de opciones de Field Forge
  • Operaciones masivas — exportar/importar todos los datos de la página de opciones es una única consulta a la tabla

Múltiples páginas de opciones

Puedes registrar tantas páginas de opciones como necesite tu sitio:

“`php // Branding a nivel de sitio fieldforge_add_options_page([ ‘page_title’ => ‘Configuración de Marca’, ‘menu_slug’ => ‘configuracion-de-marca’, ]);

// Configuración de marketing fieldforge_add_options_page([ ‘page_title’ => ‘Marketing’, ‘menu_slug’ => ‘marketing’, ]);

// Desarrollador / avanzado fieldforge_add_options_page([ ‘page_title’ => ‘Configuración del Desarrollador’, ‘menu_slug’ => ‘configuracion-del-desarrollador’, ‘capability’ => ‘manage_options’, // solo para administradores ]); “`

Cada página de opciones tiene sus propios grupos de campos, sus propios requisitos de capacidad y su propia colocación en el menú.


Migrando desde las páginas de opciones de ACF

Las páginas de opciones de ACF se importan automáticamente mediante la herramienta de migración de ACF de Field Forge. Después de la importación:

  • Las páginas de opciones se registran a través de la función de Field Forge (puedes necesitar actualizar tu llamada en functions.php)
  • Se preservan todas las asignaciones de grupos de campos
  • Todos los valores de opciones existentes se migran a la tabla de almacenamiento de Field Forge
  • El código de plantilla que utiliza get_field('name', 'options') sigue funcionando a través de la capa de compatibilidad de ACF

La mayoría de los sitios completan la migración de páginas de opciones sin cambios en las plantillas.

Consulta la guía de migración completa →


Acceso a la API REST

Los valores de la página de opciones se exponen en la API REST de Field Forge:

GET /wp-json/fieldforge/v1/options/{page-slug}

Devuelve un objeto con todos los valores de campo para la página de opciones especificada. Perfecto para sitios de WordPress sin cabeza que necesitan configuraciones globales del sitio en un frontend de JavaScript.

Para los usuarios de WPGraphQL, las páginas de opciones también se registran automáticamente como tipos de GraphQL cuando el plugin WPGraphQL está activo.


¿Listo para añadir páginas de opciones?

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

Las páginas de opciones están incluidas en cada plan de pago.

Asistente de IA de Forge En línea

¡Hola! Soy el asistente de IA de Field Forge. Pregúntame lo que quieras sobre el plugin — configuración, funciones, resolución de problemas o desarrollo.

Ahora mismo
Con la tecnología de Forge AI · Explorar documentación