# INSTRUCCIONES DE USO - Sincronizador de Precios Variables
## Importadora Blas y Compañía (ImBlasco)

---

## 📋 ¿Qué hace este script?

Este script detecta y corrige automáticamente productos variables en WooCommerce donde el precio del producto padre no coincide con el precio de sus variaciones.

**Problema detectado:** Producto muestra $3.990 en la página, pero la variación real cuesta $4.490.

---

## 🚀 INSTALACIÓN Y USO

### Paso 1: Subir el archivo
1. Conecta por FTP/SFTP a tu servidor
2. Sube el archivo `sincronizar-precios-variables.php` a la **raíz de tu WordPress** (mismo nivel que wp-config.php)

### Paso 2: Ejecutar en modo REPORTE (solo ver, no modifica nada)
1. Abre tu navegador
2. Ve a: `https://imblasco.cl/sincronizar-precios-variables.php`
3. El script escaneará todos los productos variables (~7000 productos)
4. Te mostrará:
   - Cuántos productos tienen discrepancia
   - Tabla detallada con precios incorrectos
   - Diferencias de precios

**Este paso NO modifica nada, solo genera un reporte**

### Paso 3: Revisar el reporte
- Revisa la tabla de productos con problema
- Puedes exportar el reporte a CSV para tener un respaldo
- Verifica que las correcciones propuestas sean correctas

### Paso 4: Ejecutar CORRECCIÓN (modifica los precios)
1. En la misma página, haz clic en el botón verde "✅ Corregir Todos los Productos"
2. Confirma la acción
3. El script:
   - Sincronizará el precio padre con el precio mínimo de las variaciones
   - Te mostrará cuántos productos fueron corregidos
   - Reportará cualquier error

### Paso 5: IMPORTANTE - Seguridad
**Elimina o renombra el archivo inmediatamente después de usarlo:**
```bash
# Opción 1: Eliminar
rm sincronizar-precios-variables.php

# Opción 2: Renombrar (para uso futuro)
mv sincronizar-precios-variables.php sincronizar-precios-variables-DESACTIVADO.php
```

---

## 🔍 CARACTERÍSTICAS DEL SCRIPT

### ✅ Funciones principales:
- Escanea todos los productos variables
- Detecta discrepancias de precio automáticamente
- Sincroniza precios con las variaciones
- Genera reportes detallados
- Exporta a CSV
- Interfaz visual moderna y clara

### 🛡️ Seguridad:
- Requiere usuario administrador de WordPress
- Verifica permisos de WooCommerce
- Solo funciona con usuarios autenticados
- Código auditado y seguro

### 📊 Información mostrada:
- Total de productos variables
- Productos con discrepancia
- Precio actual del padre vs. precio de variaciones
- Diferencia en pesos
- Número de variaciones por producto
- Tiempo de ejecución

---

## 🎯 EJEMPLO DE USO

### Antes de ejecutar:
- Producto ID 13698 (Mochila E45)
  - Precio padre: $3.990
  - Precio variación: $4.490
  - **Discrepancia: $500**

### Después de ejecutar:
- Producto ID 13698 (Mochila E45)
  - Precio padre: $4.490 ✅
  - Precio variación: $4.490 ✅
  - **Sincronizado correctamente**

---

## ⚠️ RECOMENDACIONES

### Antes de ejecutar la corrección:
1. ✅ **Haz un backup de tu base de datos**
2. ✅ Ejecuta primero en modo REPORTE
3. ✅ Revisa la lista de productos que se corregirán
4. ✅ Exporta el reporte a CSV como respaldo

### Durante la ejecución:
- El proceso puede tardar 1-2 minutos con 7000 productos
- No cierres la ventana del navegador
- No recargues la página

### Después de la corrección:
1. ✅ Verifica algunos productos en el frontend
2. ✅ Limpia el caché (WP, tema, Cloudflare)
3. ✅ Elimina el archivo PHP del servidor
4. ✅ Guarda el reporte CSV para referencia

---

## 🔧 PARÁMETROS OPCIONALES

Puedes modificar el comportamiento añadiendo parámetros a la URL:

### Limitar cantidad de productos (para pruebas):
```
https://imblasco.cl/sincronizar-precios-variables.php?limite=100
```
Esto procesará solo los primeros 100 productos variables.

### Modo reporte (por defecto):
```
https://imblasco.cl/sincronizar-precios-variables.php?modo=reporte
```

### Modo corrección:
```
https://imblasco.cl/sincronizar-precios-variables.php?modo=corregir
```

### Exportar a CSV:
```
https://imblasco.cl/sincronizar-precios-variables.php?modo=exportar
```

---

## 📞 SOPORTE

Si encuentras algún problema:
1. Verifica que WordPress y WooCommerce estén actualizados
2. Asegúrate de tener permisos de administrador
3. Revisa los logs de PHP si hay errores
4. Contacta al desarrollador si persisten los problemas

---

## 📝 NOTAS TÉCNICAS

### Cómo funciona:
1. El script consulta todos los productos tipo "variable"
2. Para cada producto obtiene su precio regular
3. Obtiene los precios de todas sus variaciones activas
4. Compara el precio padre con el mínimo de las variaciones
5. Si hay discrepancia, lo marca como "problema"
6. En modo corrección, usa la función nativa `$producto->sync('price')`
7. Guarda los cambios en la base de datos

### Base de datos afectada:
- Tabla: `wp_postmeta`
- Meta keys: `_price`, `_regular_price`
- No afecta: stock, descripciones, imágenes, categorías

### Compatibilidad:
- WordPress: 5.0+
- WooCommerce: 3.0+
- PHP: 7.0+
- Probado en: PHP 7.4, 8.0, 8.1

---

## ✅ CHECKLIST DE USO

- [ ] Backup de base de datos realizado
- [ ] Archivo subido a la raíz de WordPress
- [ ] Usuario administrador autenticado
- [ ] Ejecutado en modo REPORTE primero
- [ ] Reporte CSV exportado
- [ ] Lista de productos revisada
- [ ] Modo CORREGIR ejecutado
- [ ] Productos verificados en frontend
- [ ] Caché limpiado
- [ ] Archivo PHP eliminado del servidor
- [ ] Reporte guardado para referencia

---

**Desarrollado por:** Carlos Madrid
**Para:** Importadora Blas y Compañía (ImBlasco)
**Fecha:** Febrero 2026
**Versión:** 1.0