Referencia de herramientas de sitio y navegación de WordPress
Doce herramientas que cubren tres áreas: información y opciones del sitio, menús de navegación y metadatos SEO.
Sitio y opciones
| Herramienta | Qué hace | Escritura |
|---|---|---|
wp_get_site_info |
Metadatos públicos del sitio | |
wp_get_option |
Lee una opción de la lista de permitidas | |
| Ajustes de plugins admitidos | Usa contratos de funciones; los volcados genéricos de opciones no están disponibles | |
wp_update_option |
Escribe una opción de la lista de permitidas | Sí |
Menús de navegación
| Herramienta | Qué hace | Escritura |
|---|---|---|
wp_get_menus |
Lista los menús | |
wp_get_menu_items |
Lista los elementos de un menú | |
wp_create_menu_item |
Añade un elemento | Sí |
wp_update_menu_item |
Cambia un elemento | Sí |
wp_delete_menu_item |
Elimina un elemento | Sí |
wp_reorder_menu_items |
Cambia el orden | Sí |
Metadatos SEO
| Herramienta | Qué hace | Escritura |
|---|---|---|
wp_get_seo_meta |
Lee los campos de Yoast y Rank Math | |
wp_update_seo_meta |
Los escribe | Sí |
Tres modelos de permisos distintos
Este es el capítulo donde más divergen los permisos, así que conviene dejarlo claro desde el principio.
| Área | Capacidad | Puerta de escritura |
|---|---|---|
| Información del sitio | Ninguna | — |
| Lecturas de opciones | manage_options para ajustes de plugins; ninguna para wp_get_option |
— |
| Escrituras de opciones | manage_options |
Allow option writes |
| Menús | edit_theme_options |
Allow content writes |
| Metadatos SEO | edit_post en la entrada |
Allow content writes |
Las escrituras de opciones son las únicas herramientas de los grupos de WordPress que quedan detrás de la puerta de opción en lugar de la puerta de contenido. Esa separación es deliberada: editar una entrada es rutinario, cambiar un ajuste de todo el sitio no lo es.
Los menús quedan detrás de edit_theme_options, una exigencia mayor que editar entradas — conviene recordarlo al elegir qué usuario aprueba una autorización OAuth.
Las opciones tienen una lista de permitidas muy estricta
Solo se puede leer un puñado de opciones, y se pueden escribir aún menos. Todo lo demás se rechaza, y cualquier opción cuyo nombre parezca una credencial se rechaza de todos modos.
Consulta wp_get_option y wp_update_option para ver las listas exactas.
Los menús aparecen en todas las páginas
Un error en un menú se hace visible en todo el sitio en cuestión de segundos, lo que hace que leer antes de escribir sea aquí más valioso que en cualquier otra parte de los grupos de WordPress.
Los menús también son jerárquicos, y el listado de elementos sí informa de parent — a diferencia de los listados de taxonomías, que no informan de jerarquía alguna. Úsalo.
Eliminar un elemento de menú es permanente: no va a la papelera.
Los campos SEO son por entrada, no ajustes del sitio
A pesar de encontrarse en este capítulo, las herramientas SEO operan sobre los metadatos de una única entrada. Están agrupadas aquí porque pertenecen a la misma preocupación de «cómo se presenta el sitio».
Escriben tanto los campos de Yoast como los de Rank Math sin comprobar qué plugin está activo — consulta wp_update_seo_meta.
Relacionado
- Editar un menú de navegación
- Actualizar un ajuste público permitido
- Configurar los ajustes de POM Theme para las opciones del tema, que son independientes