Google Product Images for WooCommerce

Plugin de WordPress para buscar y asignar imágenes a productos WooCommerce utilizando Google Custom Search API.

Desarrollado por: Manuel Oliva
Licencia: GPL v2 or later
Versión: 1.0.6

Características

• � Asignación automática al guardar: Las imágenes se asignan automáticamente cuando guardas un producto sin imagen (¡Nuevo en v1.0.6!)
• �🔍 Búsqueda de imágenes por nombre o SKU: Busca imágenes en Google usando el nombre del producto, SKU o ambos.
• 🤖 Asignación masiva: Asigna imágenes automáticamente a productos sin imagen en lote.
• ⚡ Asignación rápida: Un clic para buscar y asignar la primera imagen.
• ✋ Asignación manual: Busca y selecciona manualmente las mejores imágenes para cada producto.
• 🎨 Interfaz intuitiva: Panel de administración fácil de usar integrado en WordPress.
• 📦 Meta box en productos: Busca y asigna imágenes directamente desde la página de edición del producto.
• ⚙️ Configuración flexible: Configura tu API Key de Google y personaliza las opciones de búsqueda.
• 📊 Gestión de productos: Filtra productos con o sin imágenes y visualízalos en una cuadrícula.

Requisitos

• WordPress 5.0 o superior
• WooCommerce 3.0 o superior (probado hasta 10.3.4)
• PHP 7.2 o superior
• Google Custom Search API Key
• Google Custom Search Engine ID

Instalación

1. Descarga o clona este repositorio en la carpeta de plugins de WordPress:

   wp-content/plugins/google-product-images/

2. Activa el plugin desde el panel de administración de WordPress en Plugins > Plugins instalados.

3. Verifica que WooCommerce esté instalado y activado.

Configuración

Paso 1: Obtener Google API Key

1. Ve a Google Cloud Console
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilita "Custom Search API" en la biblioteca de APIs
4. Ve a Credenciales y crea una nueva API Key
5. Copia la API Key generada

Paso 2: Crear Motor de Búsqueda Personalizado

1. Ve a Programmable Search Engine
2. Haz clic en "Agregar"
3. Configura tu motor de búsqueda:
   • Sitios a buscar: Selecciona "Buscar en toda la web"
   • Nombre: Ponle un nombre descriptivo
4. Una vez creado, ve a Panel de control > Configuración
5. Activa "Búsqueda de imágenes"
6. Copia el "ID del motor de búsqueda" (Search Engine ID)

Paso 3: Configurar el Plugin

1. En WordPress, ve a Product Images > Configuración
2. Ingresa tu API Key de Google
3. Ingresa tu ID del Motor de Búsqueda
4. Selecciona el método de búsqueda:
   • Nombre del producto: Busca usando solo el nombre
   • SKU del producto: Busca usando solo el SKU
   • Nombre y SKU: Busca usando ambos campos
5. Configura el número de resultados por búsqueda (1-10)
6. Haz clic en Guardar cambios

Uso

Búsqueda Manual de Imágenes

1. Ve a Product Images > Productos
2. Verás una lista de todos tus productos WooCommerce
3. Haz clic en "Buscar Imágenes" en cualquier producto
4. El sistema buscará automáticamente usando el nombre/SKU del producto
5. Revisa los resultados y haz clic en "Asignar" en la imagen deseada
6. La imagen se descargará y se asignará automáticamente al producto

Asignación Automática Masiva

1. Ve a Product Images > Productos
2. (Opcional) Filtra para mostrar solo productos sin imagen
3. Haz clic en "Asignación Automática"
4. Selecciona el número de productos a procesar
5. Haz clic en "Iniciar Proceso"
6. El sistema buscará y asignará automáticamente la primera imagen encontrada para cada producto

Filtros Disponibles

• Todos los productos: Muestra todos los productos
• Sin imagen: Muestra solo productos sin imagen destacada

Limitaciones de la API Gratuita

La API gratuita de Google Custom Search tiene las siguientes limitaciones:

• 100 búsquedas por día
• Máximo 10 resultados por búsqueda

⚠️ Recomendación: Procesa productos en lotes pequeños (10-20) para no exceder el límite diario.

Estructura del Plugin

google-product-images/
├── admin/
│   ├── products-page.php      # Página de gestión de productos
│   └── settings-page.php      # Página de configuración
├── assets/
│   ├── css/
│   │   └── admin-style.css    # Estilos del plugin
│   └── js/
│       └── admin-script.js    # JavaScript y AJAX
├── includes/
│   └── class-google-search-api.php  # Clase para Google API
├── google-product-images.php  # Archivo principal del plugin
└── README.md                  # Este archivo

Funciones Principales

Clase Principal: Google_Product_Images

• Gestiona la inicialización del plugin
• Registra menús y submenús
• Maneja peticiones AJAX
• Integra estilos y scripts

Clase API: GPI_Google_Search_API

• search_images($query, $num): Busca imágenes en Google
• get_search_term_for_product($product): Obtiene el término de búsqueda según configuración
• auto_assign_images($limit): Asigna imágenes automáticamente en lote
• assign_image_to_product($product_id, $image_url): Descarga y asigna una imagen a un producto

Solución de Problemas

Error: "La API de Google no está configurada"

• Verifica que hayas ingresado correctamente tu API Key y el ID del motor de búsqueda en la página de configuración.

Error: "Error 403 - Forbidden"

• Verifica que hayas habilitado la API de Custom Search en Google Cloud Console.
• Asegúrate de que tu API Key no tenga restricciones que bloqueen las peticiones.

Error: "Requests from referer are blocked"

Este es un error común y fácil de solucionar:

1. Ve a https://programmablesearchengine.google.com/
2. Selecciona tu motor de búsqueda
3. Ve a Setup > Advanced
4. Cambia a "Any site can use this search engine"
5. Guarda y espera 2-3 minutos
6. Prueba de nuevo

📚 Ver solución detallada: TROUBLESHOOTING-REFERER.md

Error: "No se encontraron imágenes"

• El término de búsqueda puede ser muy específico o no tener resultados.
• Intenta cambiar la configuración de búsqueda entre Nombre/SKU.
• Busca manualmente con un término personalizado.

Error: "Límite de búsquedas excedido"

• Has alcanzado el límite de 100 búsquedas diarias de la API gratuita.
• Espera 24 horas o considera actualizar a un plan de pago de Google.

Las imágenes no se descargan

• Verifica los permisos de la carpeta wp-content/uploads/
• Algunas URLs de imágenes pueden estar protegidas o no ser accesibles.
• Intenta con otra imagen de los resultados.

Seguridad

• ✅ Verificación de nonce en todas las peticiones AJAX
• ✅ Sanitización de entradas del usuario
• ✅ Verificación de permisos (manage_options)
• ✅ Protección contra acceso directo a archivos
• ✅ Escape de salidas HTML

Compatibilidad

• WordPress: 5.0+
• WooCommerce: 3.0+ (probado hasta 10.3.4)
• PHP: 7.2+
• Navegadores: Chrome, Firefox, Safari, Edge (últimas versiones)
• Compatible con HPOS (High-Performance Order Storage)
• Compatible con Custom Order Tables de WooCommerce

Changelog

Versión 1.0.4 - Noviembre 2025

• ✨ Agregado meta box en página de edición de productos individuales
• ✨ Búsqueda y asignación directa desde el editor de productos
• 🔧 Mejorada integración con WooCommerce
• 📚 Documentación ampliada

Versión 1.0.3 - Noviembre 2025

• ✨ Agregada funcionalidad de asignación rápida (un clic)
• 🔧 Optimización del consumo de API (1 vs 10 resultados)
• 🎨 Mejoras en la interfaz de usuario

Versión 1.0.2 - Noviembre 2025

• ✅ Declaración de compatibilidad con HPOS
• 🔧 Soporte para Custom Order Tables de WooCommerce

Versión 1.0.1 - Noviembre 2025

• ✅ Compatibilidad con WooCommerce 10.3.4
• 🔧 Validación mejorada de productos

Versión 1.0.0 - Noviembre 2025

• 🎉 Lanzamiento inicial
• 🔍 Búsqueda de imágenes por nombre o SKU
• ✋ Asignación manual de imágenes
• 🤖 Asignación automática en lote
• 🎨 Interfaz de administración completa
• ⚙️ Configuración de Google Custom Search API

Licencia

GPL v2 or later

Este plugin es software libre: puedes redistribuirlo y/o modificarlo bajo los términos de la Licencia Pública General GNU publicada por la Free Software Foundation, ya sea la versión 2 de la Licencia, o cualquier versión posterior.

Este plugin se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA; incluso sin la garantía implícita de COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Ver la Licencia Pública General GNU para más detalles.

Ver archivo LICENSE.txt para el texto completo de la licencia.

Autor

Desarrollado por: Manuel Oliva
Versión actual: 1.0.4
Fecha de lanzamiento: Noviembre 2025

Soporte

Para reportar errores, solicitar nuevas funcionalidades o obtener ayuda:

• 📧 Email: soporte@example.com
• 📚 Documentación: Ver archivos .md en el plugin
• 🐛 Issues: Contacta con el desarrollador

Créditos

Desarrollado para facilitar la gestión de imágenes de productos en tiendas WooCommerce.

Tecnologías utilizadas:

• WordPress Plugin API
• WooCommerce Integration
• Google Custom Search API
• PHP 7.2+
• JavaScript (jQuery)
• CSS3

Agradecimientos especiales:

• Comunidad de WordPress
• Equipo de WooCommerce
• Google Cloud Platform
• Contribuidores de código abierto

---

Nota importante: Este plugin utiliza Google Custom Search API, un servicio de terceros. Los usuarios deben:

• Obtener sus propias credenciales de API
• Cumplir con los Términos de Servicio de Google
• Verificar los derechos de uso de las imágenes encontradas
• Respetar las limitaciones de la API gratuita (100 búsquedas/día)

Descargo de responsabilidad: El desarrollador no se hace responsable del uso indebido de las imágenes encontradas. Es responsabilidad del usuario verificar los derechos de autor y licencias de las imágenes antes de usarlas en su tienda.

---

Copyright © 2025 Manuel Oliva. Todos los derechos reservados bajo GPL v2.