Plugin IA - Visualizador de Logos en Prendas (Serigrafía)

Interfaz de carga de logo/diseño, visualización en tiempo real sobre prendas 3D, selector de colores, galería de prendas y sistema de comentarios/anotaciones. Configuración de API Key y URL de IA.

Description

• Interfaz de carga de logo/diseño (PNG, SVG, JPG)
• Visualización en tiempo real del logo sobre prendas
• Selector interactivo de colores de prenda
• Galería de prendas base (camisetas, hoodies, bolsas, gorras)
• Sistema de comentarios/anotaciones en el diseño
• Configuración en WooCommerce: API Key y URL del servicio de IA (tipo Cursor/OpenAI)

Installation

1. Sube la carpeta del plugin a /wp-content/plugins/ o instala desde el panel de WordPress.
2. Activa el plugin desde el menú 'Plugins'.
3. Asegúrate de tener WooCommerce instalado y activado.
4. Ve a WooCommerce → Configuración → pestaña "IA / Visualizador" y configura API Key y URL de IA.
5. En un producto, marca "Visualizador de logos" y guarda.
6. Crea una página con el shortcode [ia_visualizador_logos] y opcionalmente asígnala en el producto.

Shortcode

[ia_visualizador_logos product_id="123" prendas="camiseta,hoodie,bolsa,gorra"]

• product_id: ID del producto WooCommerce (opcional).
• prendas: lista de tipos de prenda separados por coma (opcional).

Frequently Asked Questions

¿Necesito una API de IA?

Puedes usar el visualizador sin API para subir logos y previsualizar en prendas. La API Key y URL son para futuras funciones de IA (sugerencias, análisis, etc.).

Changelog

1.0.45

• «Quitar logo» (delante): deja la previsualización vacía y sin logo en 2D/3D; ya no vuelve a mostrar el logo por defecto (comportamiento alineado con el logo trasero).

1.0.44

• Mockup 2D: botones −/+ de tamaño del logo encima de cada miniatura (delante / detrás), sin texto «Tamaño logo…». Gorra: columna trasera oculta con el bloque mockup; vista una sola columna centrada.

1.0.43

• Camiseta espalda 3D: espejo horizontal en UV del map y bump (repeat.x = -1, offset.x = 1) además de quitar el espejo solo en canvas; corrige texto al revés (p. ej. GNITSET → TESTING) al ver la espalda desde fuera.

1.0.42

• Camiseta 3D: logo de espalda con la misma orientación de lectura que el delantero (textura decal/bump con espejo horizontal en canvas solo para el decal trasero).

1.0.41

• Visor 3D: junto a zoom se muestran dos líneas en radianes — «Cámara» (cambia al orbitar) y «Prenda» (rotación del modelo GLB, equivalente a rootRotationEuler en código).

1.0.40

• Gorra: otro paso igual en Y (-0,32 → -0,27 rad); mismo incremento que 1.0.39.

1.0.39

• Gorra: rotación base Y de -0,37 a -0,32 rad (un paso pequeño hacia la derecha en la vista por defecto).

1.0.38

• Gorra (decal): proyector del decal con la misma extensión en X e Y para que el mapeo UV sea isótropo; el logo ya se dibuja con proporción correcta en el canvas — evita que círculos/logos se vean aplastados u ovalados en 3D.

1.0.37

• Mockup 2D: marco azul con 8 controles (4 esquinas + 4 lados) para escalar el logo de forma controlada, sincronizado con el 3D; estilos tipo editor; arrastre de posición no entra en conflicto con redimensionar.

1.0.36

• Calidad logo en 3D: texturas sin mipmaps + filtro Linear + anisotropía; más píxeles útiles en decal (0,96); canvas imageSmoothing high; resolución por defecto 2048 px; pixel ratio hasta 2,5.

1.0.35

• Gorra: logo centrado por defecto (50/50 textura → centro del área roja); menos offset Y 2D→3D; cámara/orbita frontal más simétrica.

1.0.34

• Tamaño de logo: botones +/− para delante y detrás (camiseta); solo delante en gorra.
• 3D: escalado independiente frente/espalda en decals; mockup 2D sincronizado (ancho/alto + arrastre de posición).
• Redimensión arrastrando la esquina inferior derecha del marco azul en el mockup 2D.
• Carrito: campo opcional ia_visualizador_logo_size_back y etiquetas en checkout.

1.0.33

• Gorra: zona roja de edición 2D ampliada ~30% (mismo mapeo a textura 3D).

1.0.32

• Gorra 3D: ajuste fino de orientación inicial (roll Z + yaw Y) para vista frontal más recta.

1.0.31

• Ampliada la zona roja del mockup 2D para gorra (mejor precisión de colocación).
• Cambio aislado a gorra; camiseta y resto sin modificaciones.

1.0.30

• Para categoría gorra se fuerza una sola zona/logo (delante).
• Se ocultan panel y carga trasera en gorra y no se guardan datos de logo back para esa prenda.

1.0.29

• Ajuste de inicio de gorra para vista frontal más recta (cámara + target).
• Micro-corrección de rotación raíz del modelo de gorra, aislada por objeto.

1.0.28

• Corrección de guía roja (hover) en gorra: ahora se alinea con la posición/tamaño real del logo proyectado.
• Cambio aislado a gorra, sin impacto en camiseta/botella.

1.0.27

• Corregida duplicación de logo en gorra (evita doble decal al cargar GLB).
• Movimiento de coordenadas en gorra restaurado a comportamiento natural (sin inversión).

1.0.26

• Inversión aislada de coordenadas para gorra (X/Y) en el mapeo 2D↔3D.
• El movimiento del logo en gorra ahora se comporta “al revés” según referencia, sin afectar camiseta/botella.

1.0.25

• Ajuste fino de vista inicial de gorra para coincidir con referencia frontal.
• Target de órbita aislado por prenda (camiseta/gorra/botella) para mantener desarrollos independientes.

1.0.24

• Arquitectura por prenda en 3D: configuración aislada para camiseta, gorra y botella.
• Presets de cámara, decal, modelo y normalización desacoplados por objeto para evitar regresiones cruzadas.
• Preparado para añadir nuevos objetos sin tocar la lógica de los ya estables.

1.0.23

• Corrección de orientación inicial de gorra en 3D (vista frontal real).
• Ajuste de proyección del logo en gorra al panel frontal.
• Se conserva la orientación original del GLB de gorra para evitar inversión.

1.0.22

• Ajuste de cámara inicial para gorra: ahora inicia en vista frontal (no cenital).
• Presets de vista independientes para gorra, manteniendo intactos los de camiseta.

1.0.21

• Separación de medidas de referencia por prenda (camiseta y gorra) en 2D/UV.
• Estructura extensible de perfiles para añadir nuevos objetos sin romper cálculos existentes.
• Conserva intacta la lógica de camiseta y aplica ajustes independientes para gorra.

1.0.20

• Adaptación de gorra 3D: nuevo modelo adapted/gorra_logo_zone.glb generado desde Blender.
• Mejora de zona de impresión para gorra y ajuste del guardado de coordenadas exactas en el configurador.
• Ocultado temporal del botón "Generar con IA" en frontend.

1.0.17

• Corrección de inicio: vista frontal estable (cámara y modelo GLB ajustado).
• Mejoras visuales: panel de impresión centrado en camisetas oscuras y logo más homogéneo.
• Etiqueta de actualización del visualizador con fecha y hora.
• Botón IA actualizado a texto "Generar con IA".

1.0.1

• Logs de depuración para el flujo logo 3D (prefijo [IA3D]).

1.0.18

• Soporte de dos logos (delante/trasera) con carga separada y arrastre independiente.
• Amplía la zona de diseño 2D y la proyección 3D del logo en el modelo GLB.

1.0.19

• Guardar también la posición final (delante y trasera) en el pedido.

1.0.0

• Lanzamiento inicial.
• Configuración API Key y URL en WooCommerce.
• Shortcode del visualizador.
• Integración con productos y carrito.