Instrucciones de instalación y configuración

Módulo

Kowal_ProductGallery

Paquete Composer:

kowal/module-product-gallery

Requisitos

Antes de la instalación, asegúrese de que el entorno cumple las siguientes condiciones:

• Magento 2 con el módulo de catálogo activo,
• PHP en una versión compatible con los requisitos del paquete,
• acceso al repositorio Composer o al repositorio Git desde el que se publica el módulo,
• permisos para ejecutar los comandos bin/magento,
• acceso administrativo al panel de Magento para configurar los ajustes.

Instalación mediante Composer

Si el módulo se publica desde un repositorio privado de GitHub, primero añada el repositorio a la configuración de Composer:

composer config repositories.module.kowal.product.gallery vcs https://github.com/kowalco/product-gallery

Si el repositorio requiere autorización, añada el token de acceso de GitHub:

composer config --global --auth github-oauth.github.com 

A continuación, instale el módulo:

composer require kowal/module-product-gallery

Activación del módulo en Magento

Después de instalar el paquete, ejecute el conjunto estándar de comandos de Magento:

bin/magento module:enable Kowal_ProductGallerybin/magento setup:upgradebin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flush

Si la tienda funciona en modo de desarrollo, parte de los comandos puede depender del proceso de despliegue del proyecto. En un entorno de producción se recomienda realizar un deployment completo y estándar de acuerdo con la política del proyecto.

Verificación de la instalación

Después de activar el módulo, compruebe:

1. Si el módulo aparece en la lista:

bin/magento module:status Kowal_ProductGallery

2. Si en la ficha de producto de desktop la galería ha sido sustituida por una cuadrícula de imágenes grandes.

3. Si al hacer clic en una imagen se abre el fullscreen estándar de la galería de Magento.

4. Si la vista móvil permanece sin cambios.

Ubicación de los ajustes en el panel de administración

La configuración del módulo está disponible en:

Stores > Configuration > Catalog > Catalog > Kowal Product Gallery

El acceso a esta sección depende de los permisos ACL asignados al administrador.

Ajustes disponibles

1. Número de columnas de la cuadrícula

Campo:

Número de columnas de la cuadrícula

Descripción:

Define el número de columnas en la cuadrícula de imágenes de producto en desktop.

Recomendación:

• 2 para un diseño clásico y claro,
• valores más altos solo cuando las imágenes de producto sigan siendo suficientemente grandes y legibles.

2. Anchura de la imagen

Campo:

Anchura de la imagen

Descripción:

Define la anchura máxima de la imagen en la cuadrícula de desktop, en píxeles.

Recomendación:

• para imágenes cuadradas, un buen punto de partida es 640.

3. Altura de la imagen

Campo:

Altura de la imagen

Descripción:

Define la altura máxima de la imagen en la cuadrícula de desktop, en píxeles.

Recomendación:

• para imágenes cuadradas, establezca un valor igual a la anchura, por ejemplo 640,
• para imágenes con otras proporciones, ajuste la altura al formato real de los materiales de producto.

Recomendaciones de configuración

• Para un efecto visual coherente, utilice imágenes de producto con proporciones similares.
• Para imágenes cuadradas, establezca los mismos valores de anchura y altura.
• Después de cambiar los tamaños de imagen, pruebe el aspecto de la ficha de producto en varios productos representativos.
• Verifique el funcionamiento para productos simples y configurables.

Regeneración de imágenes tras cambios de tamaño

Si los cambios de configuración o de ajustes de vista requieren refrescar la caché de imágenes del catálogo, ejecute:

bin/magento catalog:images:resize

Cuando termine la regeneración, limpie la caché:

bin/magento cache:clean

Comprobación después del despliegue

Después del despliegue en un entorno de pruebas o de producción, compruebe:

• el aspecto de la galería en desktop,
• la ausencia de regresiones en mobile,
• el funcionamiento del fullscreen al hacer clic en la imagen,
• el funcionamiento de la galería para productos configurables,
• el comportamiento sticky correcto de la columna con la información del producto,
• el tiempo de carga de la ficha de producto y los indicadores básicos de calidad del renderizado.

Observaciones de despliegue más habituales

• Si los cambios no son visibles, primero compruebe la caché y el deployment de recursos estáticos.
• Si la tienda utiliza un tema muy modificado, conviene confirmar la compatibilidad de la plantilla de la galería con el theme activo.
• Si el administrador no ve los ajustes del módulo, compruebe los permisos ACL asignados a su rol.