Actualizar un término de taxonomía

wp_update_term cambia solo los campos suministrados en un término. Renombrar conserva su slug a menos que pases explícitamente uno nuevo. Las asignaciones de entradas existentes permanecen vinculadas al término.

Argumentos

Se requiere al menos un campo editable. Las imágenes y el orden requieren POM Theme activo. Los IDs de adjuntos se resuelven a las mismas URLs de imagen que usa el editor nativo de términos. Los demás términos no se renumeran cuando cambia order.

Aplicar un cambio

1. Lee wp_get_term con la taxonomía y el ID exactos.
2. Previsualiza los campos suministrados usando dry_run: true y el expected_revision actual.
3. Inspecciona before, los valores propuestos de fields y pom. Si cambias un slug o un padre, ten en cuenta los enlaces públicos del archivo.
4. Envía la escritura y aprueba su revisión.
5. Repite la solicitud idéntica con approval_id. Inspecciona complete, failed_fields y el term devuelto, y luego vuelve a leerlo.

La capacidad de gestión de la taxonomía y edit_term para ese término son obligatorias, junto con los ámbitos de escritura de contenido y la puerta de escritura de contenido. Una revisión obsoleta se rechaza. Un fallo de almacenamiento de metadatos puede dejar un resultado parcial; inspecciona el término devuelto en lugar de reintentar a ciegas.

Para una limpieza solo de nombre, usa wp_rename_terms de la referencia de taxonomía. No acepta campos de slug ni de imagen y puede renombrar hasta 50 términos con una sola aprobación. Para varias posiciones, usa wp_reorder_terms.

Los enlaces de idioma y traducción se leen para las comprobaciones de revisión y se conservan mediante estas operaciones. No se reasignan en una actualización de término. Las traducciones que ya comparten un slug pueden renombrarse de forma independiente manteniendo ese slug compartido. Un slug explícitamente diferente sigue sujeto a las comprobaciones de colisión de WordPress.