Actualizar una opción pública permitida

Las escrituras de opciones son la categoría más estrictamente limitada en el servidor. Solo se pueden escribir cinco opciones, y todo lo demás se rechaza, incluido cualquier elemento que parezca una credencial.

Las cinco opciones que se pueden escribir

Esa es la lista completa. Existe porque se trata de ajustes de presentación con un alcance de impacto acotado, y porque un asistente capaz de escribir opciones arbitrarias podría cambiar casi cualquier cosa de un sitio WordPress.

Un desarrollador puede ampliar la lista mediante un filtro, lo que supone una decisión deliberada de ampliarla para una instalación concreta y no algo que deba hacerse a la ligera.

Su propia barrera

Las escrituras de opciones se rigen por Allow option writes, de forma independiente a Allow content writes. Abrir la barrera del contenido no permite las escrituras de opciones.

La separación es la clave: editar entradas es algo rutinario, cambiar los ajustes de todo el sitio no lo es.

Lo que siempre se rechaza

Con independencia de la lista de permitidas, algunas opciones nunca se pueden escribir: las URL del sitio y de inicio, la versión de la base de datos, los roles de usuario, el cron, las reglas de reescritura, el idioma del sitio, el tema y los plugins activos, y los propios ajustes y claves de POM AI.

También se rechaza cualquier opción cuyo nombre parezca una credencial: nombres que contengan secret, salt, auth key, nonce key, license key, api key, auth token, private key, session token o recovery key.

Por tanto, las herramientas de opciones no pueden utilizarse para leer ni escribir credenciales en la base de datos, que es la principal razón para sentirse cómodo con que existan.

Leer opciones

wp_get_option lee una única opción pública permitida. No están disponibles los volcados genéricos de opciones de plugins. Para POM Theme, utiliza el catálogo de ajustes y los contratos de campos tipados.

La lectura se rige por el ámbito de lectura de contenido, no por la barrera de escritura de opciones.

El flujo de trabajo

1. Lee el valor actual.

Muéstrame la descripción corta actual del sitio.

2. Usa una prueba en seco.

wp_update_option admite dry_run, que devuelve el antes y el después sin escribir:

Usa una prueba en seco para cambiar la descripción corta a «Automatización industrial para fabricantes en crecimiento» y muéstrame el resultado.

3. Escribe y, después, vuelve a leer.

Aplícalo y, a continuación, vuelve a leer la opción.

4. Comprueba el sitio. La descripción corta aparece en la cabecera, en el título del navegador y, a menudo, en los resultados de búsqueda. Observa la página renderizada en lugar de limitarte al valor almacenado.

5. Purga la caché. Estas opciones aparecen en todas las páginas.

Cuáles de las cinco merecen más cuidado

blogname y blogdescription aparecen en los títulos de página, en los feeds, en los correos que envía WordPress y en los resultados de los buscadores. Cambiarlas es una edición pequeña con una superficie amplia.

posts_per_page modifica la paginación en todos los archivos. Si la pones demasiado baja, creas cientos de páginas de paginación; demasiado alta, y las páginas de archivo se vuelven lentas. Comprueba después una página de archivo.

date_format y time_format cambian todas las fechas mostradas del sitio. Confirma que el resultado coincide con las convenciones de configuración regional que espera tu audiencia: un formato que a ti te resulta correcto puede no resultárselo a ellos.

Cuando se rechaza una escritura

Un rechazo aquí suele ser un comportamiento correcto, no un problema que haya que sortear. Si un asistente necesita cambiar una opción que no está en la lista, esa es una tarea para una persona en el administrador de WordPress.

Relacionado

• Herramientas de sitio y menús
• Configurar los ajustes de POM Theme para las opciones del tema, que son independientes
• Límites de MCP