Herramientas de taxonomía de WordPress

Gestiona categorías, etiquetas y taxonomías personalizadas con las mismas herramientas en una conexión directa al sitio o a través de la puerta de enlace de la red multisitio.

Leer términos y revisiones

wp_get_terms requiere taxonomy. Los campos opcionales son per_page (1–100, por defecto 50), page (por defecto 1), search, hide_empty, parent y language. Los resultados se ordenan por el ID del término, de modo que al renombrar no se mueven los registros entre páginas. Sigue next_page hasta que sea null. Añadir o eliminar términos durante un inventario puede afectar igualmente a la paginación.

Omite language para incluir todos los idiomas. Un filtro de idioma requiere que ese idioma esté instalado. Cada elemento incluye id, taxonomy, name, slug, description, parent, language, translations, count, las URL de las imágenes POM y la posición bajo pom, y revision. Los campos de traducción se rellenan cuando la integración de traducción del sitio los proporciona.

wp_get_term toma taxonomy y term_id y devuelve la misma instantánea detallada. Usa su revision como expected_revision para una actualización o eliminación. Se requiere la capacidad de gestión propia de la taxonomía, incluidos los nombres de capacidad personalizados.

Lotes solo de nombres y solo de orden

wp_rename_terms acepta taxonomy y changes, con 1–50 filas que contienen solo term_id, name y expected_revision. No acepta slugs ni otros campos editables. Previsualiza todas las filas antes de ejecutarse y comprueba que el slug, el padre, la descripción, los campos POM y los enlaces de idioma de cada término permanezcan sin cambios.

wp_reorder_terms usa filas que contienen term_id, order y expected_revision. Las posiciones más bajas aparecen primero en el orden de términos POM. Solo cambian las posiciones proporcionadas; los demás términos no se renumeran automáticamente. POM Theme debe estar activo.

Ambos admiten dry_run y el flujo de trabajo compartido de aprobación del usuario. Inspecciona complete y cada fila de results. Los hooks o las ediciones concurrentes pueden interrumpir un lote después de que las filas anteriores hayan tenido éxito. Lee los términos afectados antes de preparar otro lote.

Referencia de herramientas

• wp_get_taxonomies: descubre las taxonomías de contenido públicas o visibles para el editor y si el usuario actual puede gestionarlas.
• wp_get_categories: listado compacto de categorías.
• wp_get_tags: listado compacto de etiquetas.
• wp_count_terms: cuenta los términos.
• wp_create_term: crea un término.
• wp_update_term: edita nombres, slugs, descripciones, padres, imágenes POM y orden.
• wp_delete_term: elimina en la revisión actual.
• wp_add_post_terms: asigna términos a una entrada; reemplaza sus términos a menos que append: true.
• wp_get_term_meta: lee un campo de metadatos permitido.
• wp_update_term_meta: actualiza un campo de metadatos permitido.
• wp_delete_term_meta: elimina un campo de metadatos permitido.

Las herramientas compactas de categorías/etiquetas conservan su forma de respuesta existente. Usa wp_get_terms para la paginación, la jerarquía, el idioma y la información de revisión. Las herramientas de metadatos conservan su propia lista de campos permitidos; usa los campos de término tipados para las miniaturas, los fondos y la posición de POM.

Relacionado: Organizar taxonomías, revisar y aprobar escrituras.