wp_update_option: actualiza una opción permitida
Escribe una opción de WordPress, a partir de una lista de permitidas de cinco.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
option |
Sí | El nombre de la opción |
value |
Sí | El nuevo valor |
dry_run |
No | Informa sin escribir |
Permisos
Allow option writes abierto — su propia puerta, separada de las escrituras de contenido — y la capacidad manage_options.
Abrir la puerta de contenido no permite las escrituras de opciones. Esa separación existe porque editar una entrada afecta a una entrada, y cambiar una opción afecta al sitio.
Qué se puede escribir
| Opción | Es |
|---|---|
blogname |
El título del sitio |
blogdescription |
La descripción corta |
posts_per_page |
Cuántas entradas muestra un archivo |
date_format |
Formato de visualización de la fecha |
time_format |
Formato de visualización de la hora |
Cinco, y nada más. Cualquier otra cosa se rechaza con pom_ai_mcp_option_denied, incluidas las opciones que son legibles — admin_email y timezone_string se pueden leer, pero no escribir.
La protección de nombres sensibles se aplica por encima, de modo que las credenciales y las opciones estructurales del núcleo se rechazan en cualquier caso.
El filtro pom_ai_mcp_writable_options puede restringir estas cinco opciones. No puede añadir el registro de usuarios, los roles, las credenciales ni otros ajustes al catálogo de escritura.
La simulación es una comparación real
A diferencia de la mayoría de las herramientas de escritura del servidor MCP, esta devuelve un before y un after auténticos:
Usa una simulación para cambiar la descripción corta y muéstrame el antes y el después.
Úsala siempre. Estos son valores de todo el sitio y la comparación cuesta una llamada.
posts_per_page está validada
El valor se limita entre 1 y 500. Enviar algo fuera de ese rango produce un resultado limitado en lugar de un error, así que lee la respuesta en lugar de dar por hecho que tu número se almacenó.
Considera también el efecto antes de cambiarlo: gobierna la paginación en todos los archivos del sitio. Ponerlo muy bajo crea cientos de páginas de paginación; ponerlo muy alto hace que las páginas de archivo sean lentas.
Cada una de las cinco tiene una superficie amplia
blogname aparece en los títulos de página, las pestañas del navegador, los feeds, los correos que envía WordPress y los resultados de búsqueda.
blogdescription aparece en la cabecera de la mayoría de los temas, en los feeds y, a menudo, como meta descripción alternativa.
posts_per_page cambia la paginación de todos los archivos.
date_format y time_format cambian cada fecha mostrada en el sitio. Comprueba que el resultado coincide con las convenciones que espera tu audiencia — un formato que a ti te resulta natural puede no resultárselo a ellos.
Ninguna de estas es una edición pequeña. Las cinco son cosas que un visitante ve.
Sin historial de revisiones
Las opciones no tienen revisiones. El valor antiguo se pierde salvo que lo registres.
Muéstrame la descripción corta actual y luego cámbiala.
El before de la simulación también te da el valor antiguo en la respuesta, y merece la pena conservarlo.
Después de escribir
- Vuélvelo a leer.
- Mira el sitio renderizado — la cabecera, un título de página, un archivo.
- Purga la caché. Estos valores aparecen en cada página, de modo que una caché obsoleta hace que un cambio correcto parezca roto.
Qué devuelve
Si la actualización se realizó correctamente. Al igual que con las escrituras de meta, WordPress no informa de ningún cambio cuando el nuevo valor es igual al antiguo, de modo que un resultado falso puede significar «ya es correcto».
Problemas habituales
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Allow option writes está cerrada |
pom_ai_mcp_option_denied |
No está en la lista de escribibles, o la protección la ha detectado |
pom_ai_mcp_forbidden |
No hay manage_options |
posts_per_page no es lo que enviaste |
Limitado a 1–500 |
| Un resultado falso | El valor ya era idéntico |
| El sitio parece sin cambios | La caché no se purgó |
Relacionado
wp_get_option— lee antes de escribir- Actualiza un ajuste público permitido
- Configura los ajustes de POM Theme para las opciones del tema