wc_get_attribute_terms: listar los términos de un atributo

Lista los valores que ofrece un atributo global: las tallas, los colores, los materiales.

Argumentos

Permisos

mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_products.

Qué devuelve

items, cada uno con id, name y slug.

El slug es el que importa para el trabajo con variaciones: es el valor que entra en el mapa de attributes de una variación. El name es para las personas.

Se incluyen los términos que no tienen productos asociados, así que esta es la lista completa del vocabulario, no solo lo que está en uso ahora mismo.

Una lista vacía es ambigua

Obtienes items: [], sin error, cuando:

• el atributo realmente no tiene términos todavía;
• el attribute_id no corresponde a ningún atributo.

La herramienta no distingue entre ambos casos. Confirma el ID con wc_get_product_attributes antes de concluir que un atributo está vacío: un ID mal escrito tiene exactamente el mismo aspecto que un atributo recién creado que nadie ha rellenado.

Los atributos recién creados empiezan vacíos

Crea el atributo global, actualiza el descubrimiento en una nueva petición y después crea sus valores con wp_create_term usando su taxonomía registrada pa_. Las herramientas de términos requieren la puerta de escritura de contenido y las capacidades de la taxonomía. Cada creación necesita aprobación.

Los slugs deben coincidir exactamente

El mapa de attributes de una variación se compara con estos slugs. Las coincidencias aproximadas no avisan:

• large no es l
• dark-blue no es darkblue
• una etiqueta que el asistente ha deducido («Extra Large») no es un slug

Obtén la lista, usa los slugs literalmente y no dejes nunca que una variación se construya a partir de un valor adivinado.

Lista los términos del atributo 3 y muéstrame los slugs exactamente como están almacenados.

Los atributos personalizados no están aquí

Esta herramienta lee solo los términos de los atributos globales. Un producto que usa atributos personalizados por producto tiene sus valores almacenados en el producto, y los lees a través de wc_get_product.

Cómo usarla bien

Antes de construir variaciones:

Muéstrame los términos de los atributos Talla y Color con sus slugs.

Comprobando la cobertura:

El producto 219 tiene 8 variaciones. Dados los términos de sus atributos, ¿qué combinaciones faltan?

Esa pregunta solo puede responderse con este listado, y detecta el hueco que notan los clientes: una combinación anunciada en la página del producto que no se puede seleccionar.

Problemas habituales

Relacionado

• wc_get_product_attributes — obtén primero los IDs
• wc_set_product_attributes — asocia términos a un producto
• wc_create_variation