Connexion Drive Excel Product releases

Version: 1.3.12 | License: GPL2+

Conecta Google Drive, selecciona archivos Excel/CSV/Google Sheets, mapea columnas a 16 campos de producto y actualiza productos WooCommerce de forma masiva. Incluye generación de contenido con IA (Kodee/Gemini/Groq), asignación condicional de marca/categoría/atributos, edición manual por fila, cálculos matemáticos con variables de columna, exportación/importación de configuración, selección de formato decimal y delimitador CSV configurable.

✨ Caracteristicas

• 🤖 Generación con IA — Genera nombres, descripciones cortas y descripciones largas mediante Kodee/Gemini/Groq API, con carga por lote uno-por-uno y barra de progreso. Incluye prompt extra por campo con resolución de variables y contexto de marca.
• 🔌 Conexion Google Drive — Autenticacion OAuth 2.0 con refresh token y renovacion automatica.
• 📂 Explorador de Archivos — Navega carpetas de Drive, soporta Excel (.xlsx, .xls), Google Sheets y CSV.
• 🗺️ Mapeo de Columnas — Detecta automaticamente columnas SKU, precio, precio oferta y cantidad. Mapeo separado para actualizar existentes (6 campos: precio, oferta, stock, descripción, desc. corta, nombre) y crear nuevos (16 campos).
• 🎨 Templates Personalizados — Crea nombres y descripciones combinando texto fijo con variables de columna y configuracion (ej: "Reloj {marca} {name}").
• 🧮 Cálculos Matemáticos — Expresiones con {columna}, operadores y números: {precio} * 1.19 para precio + IVA, {cantidad} * {precio} para totales. Disponible en actualización y creación.
• ✏️ Edición Manual — Edita valores directamente en la tabla de preview por fila, disponible tanto en actualización (5 campos) como en creación (16 campos + marca, categoría, atributos). Modo automático cuando la celda está vacía.
• 🏷️ Asignación Condicional — Marca, categoría y atributos con condiciones lógicas por fila: operadores =, !=, <, > y múltiples condiciones por regla (primera coincidencia gana).
• 📂 Categorías Múltiples — Asigna varias categorías a productos nuevos, tanto en configuración de creación como por fila en la tabla de preview.
• 👁️ Vista Previa — Validacion con diffs (antes/despues), imagenes, badges de estado. Resultados en tabs independientes por tipo. Vista previa de categorías y atributos evaluados.
• ⚡ Actualizacion Masiva — Procesa en lotes de 25 con barra de progreso. Actualiza existentes y crea nuevos productos simultaneamente.
• 🎯 Actualizacion Individual — Boton "Procesar" por fila para actualizar un solo producto.
• 🔗 Enlace a Edicion — SKUs y nombres existentes abren el editor de WooCommerce en nueva pestana.
• 💾 Exportar/Importar Configuración — Exporta mapeo, edición manual, datos IA y estado como JSON para usar en otro navegador o sesión.
• 🌐 Formato Decimal — Selecciona coma (formato Latino) o punto (formato US) para interpretación de números.
• 📄 Delimitador CSV — Auto-detectar, coma, punto y coma o tabulación como delimitador de columnas.
• 🛡️ Seguridad — Nonces, capabilities manage_options, sanitizacion de inputs, escapado de outputs.

📋 Requisitos

• WordPress 5.0+
• PHP 7.0+
• WooCommerce 4.0+
• Google Cloud Platform project con Google Drive API habilitada
• PhpSpreadsheet (via Composer)

⚙️ Instalacion

1. Descarga el plugin desde GitHub.
2. Sube la carpeta connexion-drive-exel-product a /wp-content/plugins/.
3. Ejecuta composer install --no-dev --optimize-autoloader dentro del plugin.
4. Activa el plugin desde Plugins de WordPress.
5. Ve a Drive Excel Product > Conectar e ingresa tus credenciales OAuth 2.0 de Google Cloud.

🗂️ Estructura del Plugin

connexion-drive-exel-product/
  index.php                     # Plugin header, constantes, auto-updater
  composer.json                 # Dependencias Composer
  package.json                  # Scripts de release/versionado
  libs/                         # Dependencias (Composer vendor renombrado)
  src/
    _.php                       # Cargador maestro
    api/
      _.php                     # Cargador de API
      drive.php                 # CDEP_DRIVE - OAuth Google Drive, CRUD archivos
      excel.php                 # CDEP_EXCEL - Parseo Excel/CSV con PhpSpreadsheet
      products.php              # CDEP_PRODUCTS - Validacion y actualizacion WooCommerce
    css/
      admin.css                 # Estilos admin (cdep-* clases)
    data/
      _.php                     # Cargador de data
      base.php                  # CDEP_USE_DATA_BASE - CRUD generico wp_options
    js/
      admin.js                  # Frontend JS: OAuth, file browser, mapping, update
    page/
      _.php                     # Cargador de page
      add.php                   # Registro menu + enqueue assets
      sections/
        connect.php             # Config OAuth + estado conexion
        browse.php              # Explorador de archivos Google Drive
        mapping.php             # Mapeo de columnas y campos del producto
        update.php              # (Legacy) Ejecucion de actualizacion masiva
        ia.php                  # Configuraciones IA (Kodee/Gemini/Groq)

🧠 Clases Principales

🖥️ Paginas del Admin

🔌 AJAX Endpoints

| Action | Handler | Proposito | |---|---|---|---| | cdep_save_config | Closure en drive.php:278 | Guarda credenciales OAuth | | cdep_get_auth_url | Closure en drive.php:293 | Obtiene URL de autenticacion Google | | cdep_drive_connect | Closure en drive.php:307 | Intercambia codigo OAuth por tokens | | cdep_drive_disconnect | Closure en drive.php:326 | Elimina tokens y desconecta Drive | | cdep_drive_list | Closure en drive.php:336 | Lista archivos/carpetas en una carpeta de Drive | | cdep_get_cached_data | Closure en drive.php:353 | Obtiene datos parseados en cache | | cdep_refresh_cache | Closure en drive.php:375 | Redescarga archivo y re-parsea (soporta delimiter) | | cdep_reparse_file | Closure en drive.php:456 | Re-parsea archivo temporal con nueva fila de encabezados (soporta delimiter) | | cdep_drive_select_file | Closure en drive.php:511 | Descarga, parsea y cachea archivo seleccionado | | cdep_ai_generate | Closure en products.php:911 | Genera contenido IA para un SKU (name/description/short_description) con prompt extra, resolucion de variables, contexto de marca y deteccion de rate limit | | cdep_update_preview | Closure en products.php:873 | Valida mapeo y genera vista previa con soporte de manual_data, ai_data, calc y decimal_char | | cdep_update_execute | Closure en products.php:1271 | Ejecuta actualizacion por lotes (offset) con soporte de manual_data, ai_data, calc y decimal_char | | cdep_update_batch_skus | Closure en products.php:1307 | Actualiza SKUs especificos por lote (soporta decimal_char) | | cdep_update_single | Closure en products.php:1362 | Actualiza un solo producto por SKU (soporta decimal_char) |

📋 Campos del Producto Soportados

Nota: Para productos existentes se mapean 6 campos (regular_price, sale_price, stock_quantity, description, short_description, product_name) con soporte de cálculos matemáticos, edición manual por fila y generación con IA (description/short_description/product_name). Para productos nuevos se mapean los 16 campos completos más la asignación de marca, categorías múltiples y atributos WooCommerce (con soporte de condiciones lógicas y edición manual).

🔒 Seguridad

• ✅ Todas las peticiones AJAX verifican nonce con check_ajax_referer('cdep_nonce', 'nonce')
• ✅ Todas las operaciones admin verifican current_user_can('manage_options')
• ✅ Input sanitizado con sanitize_text_field(), intval(), sanitize_key(), sanitize_file_name()
• ✅ Output escapado con esc_attr(), esc_html(), esc_url(), esc_textarea()
• ✅ Tokens almacenados en wp_options, no expuestos al frontend
• ✅ Archivos temporales se almacenan en wp_upload_dir() con nombre sanitizado

📦 Constantes Globales

📄 Licencia

GPL2+ — Ver LICENSE para mas detalles.

👤 Developer

• Name: Francisco Blanco
• Website: https://franciscoblanco.vercel.app/
• Email: blancofrancisco34@gmail.com