wp_update_post_meta: actualiza un campo personalizado permitido
Usa esta operación para un campo de contenido identificado. Quedan excluidos el almacenamiento interno del plugin, las credenciales, los ajustes de permisos, la configuración de scripts y las claves que empiezan por un guion bajo. Una clave vacía u omitida nunca devuelve un volcado de metadatos.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
post_id |
Sí | ID de la entrada de destino |
key |
Sí | Una clave de campo permitida |
value |
Sí | Nuevo valor del campo |
dry_run |
No | Las vistas previas JSON true sin escribir |
Requisitos
El usuario autenticado debe poder editar la entrada de destino y acceder a estos metadatos. La escritura también requiere Allow content writes y el ámbito de escritura correspondiente.
Una clave debe ser un campo personalizado POM Theme habilitado para ese tipo de contenido, o un campo registrado en WordPress expuesto a través de REST. El destino debe ser contenido admitido en este sitio. Los administradores del sitio pueden inspeccionar las definiciones de campos en la interfaz de administración nativa; no adivines claves internas.
Uso y verificación
- Identifica el campo a partir de su definición nativa admitida.
- Lee esa clave explícita en la entrada prevista.
- Previsualiza la operación, aplícala dentro del ámbito solicitado y vuelve a leer el campo.
La sanitización de WordPress y la política HTML KSES de la instalación se aplican al valor, incluidas las cadenas dentro de campos estructurados. Vuelve a leer el valor almacenado; updated: false puede significar que ya era idéntico.
pom_ai_mcp_meta_denied significa que la clave, el destino o el permiso de metadatos están fuera de esta operación. Usa herramientas específicas para SEO, imágenes destacadas, diseños y asignación de scripts. Un error de control de escritura o de capacidad requiere que el propietario del sitio conceda el acceso previsto. Los cambios de campos no son un mecanismo de deshacer para todo el sitio; conserva el valor anterior cuando la recuperación sea importante.
Relacionado: seguridad y acceso de MCP.