wc_create_product_attribute: crear un atributo de producto
Crea un nuevo atributo global para la tienda: una estructura a nivel de tienda, no algo vinculado a un único producto.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
name |
Sí | La etiqueta visible |
slug |
No | El identificador interno; se deriva del nombre si se omite |
type |
No | Cómo se eligen los valores; por defecto select |
order_by |
No | Cómo se ordenan los términos; por defecto menu_order |
has_archives |
No | Si el atributo obtiene páginas de archivo públicas |
dry_run |
No | Informar sin crear |
La respuesta es attribute_id.
Permisos
Allow WooCommerce catalog writes abierto, más manage_woocommerce o edit_products.
Comprueba si ya existe
Nada impide los duplicados. «Colour» y «Color», o «Size» creado dos veces, existirán ambos, cada uno con su propia lista de términos separada, y los productos se repartirán entre ellos.
Deshacer eso después significa editar a mano cada producto afectado.
Lista los atributos de la tienda y dime si ya existe algo parecido. No lo crees todavía.
Crea un atributo vacío
El atributo se crea sin términos, y ninguna herramienta MCP puede añadir términos. Alguien tiene que abrir Productos → Atributos en el administrador de WordPress y añadir los valores.
Así que esta herramienta completa un tercio del trabajo:
- Crear el atributo — aquí.
- Añadir sus términos — solo administrador.
- Adjuntarlo a productos —
wc_set_product_attributes.
Un asistente que crea un atributo y pasa directamente a las variaciones las construirá contra una lista de términos vacía, y todas ellas resultarán imposibles de seleccionar. Espera tener que salir de la conversación y terminar el paso 2 a mano.
has_archives publica URLs
Activar los archivos da al atributo páginas públicas — una por término — que los motores de búsqueda pueden indexar. Es una decisión sobre la estructura pública de la tienda y su SEO, no un detalle.
Déjalo desactivado salvo que alguien haya decidido que esas páginas deben existir. Activarlo después es fácil; retirar URLs ya indexadas no lo es.
El slug es permanente en la práctica
Pasa a formar parte del nombre subyacente de la taxonomía, al que las variaciones y los datos de producto almacenados hacen referencia. Renombrarlo después desde el administrador es posible, pero disruptivo.
Eligelo deliberadamente, y pásalo de forma explícita en lugar de dejar que se derive de una etiqueta que podría reformularse más tarde.
order_by controla la presentación en la tienda
Decide cómo se listan los términos en el selector del producto — el menu_order manual por defecto, en lugar de alfabéticamente. Afecta solo a la presentación y puede cambiarse en cualquier momento.
La ejecución en seco
Devuelve la carga exacta que enviaría, incluido el slug que derivó y los valores por defecto que rellenó. Merece la pena usarla precisamente porque esos valores por defecto son invisibles de otro modo:
Haz una ejecución en seco creando un atributo «Material» y muéstrame el slug y el tipo que usaría.
Si la herramienta da error de inmediato
pom_ai_mcp_wc_attribute_api_missing significa que la API de atributos de WooCommerce no está disponible en esta instalación. No es un problema de permisos ni algo que puedas sortear reintentando: el atributo tiene que crearse desde el administrador.
Después de crear
- Lista los atributos y confirma el nuevo ID.
- Añade sus términos en el administrador de WordPress.
- Lista los términos para confirmar que son visibles para MCP.
- Solo entonces adjúntalo a un producto.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Puerta de escritura del catálogo cerrada |
pom_ai_mcp_wc_attribute_api_missing |
La API de atributos de WooCommerce no está disponible |
pom_ai_mcp_wc_forbidden |
Falta una capacidad de la tienda |
| Ahora existen dos atributos similares | Los duplicados no se evitan |
| El atributo no tiene valores | Es esperable; añade los términos en el administrador |
| Aparecieron páginas públicas inesperadas | Se activó has_archives |
Relacionado
wc_get_product_attributes— comprueba primero los duplicadoswc_get_attribute_termswc_set_product_attributes
Permisos de objeto
El acceso al catálogo por sí solo no autoriza todos los objetos. Las actualizaciones y las lecturas privadas comprueban el objeto seleccionado; las operaciones de variación también comprueban su producto padre. La eliminación requiere capacidades de borrado. Crear un cupón requiere capacidades de creación y publicación de cupones; crear un atributo global requiere manage_product_terms. Cada escritura usa el flujo de trabajo de aprobación.