Kowal Product Info - instrucciones de instalación y configuración

Requisitos

• Magento 2 con el módulo Magento_Catalog activado.
• Acceso a la consola del servidor.
• Permisos para ejecutar comandos bin/magento.
• Acceso de administrador al panel de Magento.

Instalación mediante Composer

1. Añade el repositorio del módulo:

composer config repositories.product.info vcs https://github.com/kowalco/product-info

2. Si el repositorio es privado, añade un token de GitHub:

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

3. Instala el módulo:

composer require kowal/module-productinfo

4. Activa el módulo:

php bin/magento module:enable Kowal_ProductInfo

5. Ejecuta la actualización de la base de datos:

php bin/magento setup:upgrade

Este comando añadirá:

• el atributo de producto kowal_product_info_display,
• las tablas kowal_productinfo_icon_group y kowal_productinfo_icon.

6. En modo producción, recompila DI y los recursos estáticos:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy

7. Limpia la caché:

php bin/magento cache:flush

Instalación manual

1. Copia el módulo en el directorio:

app/code/Kowal/ProductInfo

2. Ejecuta:

php bin/magento module:enable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush

3. En modo producción, ejecuta además:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy

Configuración global

Panel de administración:

Stores > Configuration > Kowal > Product info

Ajustes

La sección Ustawienia controla el bloque básico de iconos.

• Wlacz - activa o desactiva el bloque básico en la ficha de producto.
• Naglowek nad ikonami - encabezado visible sobre el conjunto básico de iconos.

Información 1-7

Las secciones de Informacja 1 a Informacja 7 definen el conjunto básico de iconos.

Para cada información se puede configurar:

• Ikona - archivo SVG, PNG, JPG, JPEG, GIF o WEBP,
• Naglowek - texto visible junto al icono,
• Tresc - contenido del tooltip.

El bloque básico se muestra en la ficha de producto con el diseño existente del módulo.

Grupos dinámicos de iconos

La sección Dynamiczne grupy ikon controla la nueva función de asignación de grupos de iconos a productos.

• Wlacz dynamiczne grupy na karcie produktu - activa el renderizado de grupos dinámicos en la PDP.
• Maksymalna liczba grup na produkcie - límite de grupos mostrados en una ficha de producto; 0 significa sin límite.

Configuración por producto

En el formulario de producto está disponible el atributo:

Obecny blok ikon Product Info

Opciones:

• Dziedzicz z konfiguracji - el producto utiliza el ajuste global Wlacz.
• Wlacz na tym produkcie - el bloque básico de iconos se muestra incluso cuando está desactivado globalmente.
• Wylacz na tym produkcie - el bloque básico de iconos queda oculto incluso cuando está activado globalmente.

Este ajuste afecta solo al bloque básico de iconos. Los grupos dinámicos se gestionan por separado.

Gestión de grupos dinámicos de iconos

Panel de administración:

Kowal > Product Info > Grupy ikon

Añadir un grupo

1. Haz clic en Dodaj grupe ikon.
2. Configura Status.
3. Introduce Nazwa techniczna.
4. Opcionalmente, introduce Naglowek na karcie produktu.
5. Opcionalmente, introduce Tooltip grupy.
6. Configura Priorytet; un valor más bajo significa una posición más alta en la ficha de producto.
7. Selecciona Store View; All Store Views significa todas las vistas de tienda.
8. Selecciona Typ dopasowania.
9. Completa SKU o ID kategorii, según el tipo de coincidencia seleccionado.
10. Añade iconos en la sección Ikony w grupie.
11. Guarda el grupo.

Tipos de coincidencia

• SKU lub kategoria - el grupo aparecerá si el producto coincide por SKU o por categoría.
• Tylko SKU - el grupo aparecerá solo para productos con los SKU indicados.
• Tylko kategoria - el grupo aparecerá solo para productos asignados a las categorías indicadas.

Los SKU y los ID de categoría pueden introducirse separados por comas o cada valor en una línea nueva.

Configuración de iconos en el grupo

Para cada icono se puede configurar:

• Status,
• Sort order,
• Tytul,
• Plik ikony,
• Sciezka lub URL ikony,
• Tooltip,
• Usun ikone.

El archivo de icono cargado sobrescribe la ruta o URL introducida manualmente para esa fila.

Widget CMS/Page Builder

El módulo proporciona el widget:

Product Info

El widget muestra el conjunto básico de información de la configuración global en un diseño horizontal. Los grupos dinámicos de iconos están destinados a las fichas de producto y no se renderizan por defecto en widgets CMS.

Prueba tras la configuración

Después de la instalación y configuración, comprueba:

1. Producto con el ajuste Dziedzicz z konfiguracji.
2. Producto con el ajuste Wlacz na tym produkcie.
3. Producto con el ajuste Wylacz na tym produkcie.
4. Producto asignado a la categoría utilizada en el grupo dinámico.
5. Producto con un SKU concreto utilizado en el grupo dinámico.
6. Producto sin coincidencia con ningún grupo dinámico.
7. Tooltips del bloque básico y de los grupos dinámicos.
8. Corrección de los iconos después de limpiar la caché.

Caché e implementación de cambios

Después de cambiar la configuración, los grupos de iconos o los archivos de iconos, se recomienda limpiar la caché:

php bin/magento cache:flush

Después de cambios en archivos LESS, JS o templates en modo producción, hay que recompilar los recursos estáticos:

php bin/magento setup:static-content:deployphp bin/magento cache:flush

Desinstalación

Desactiva el módulo:

php bin/magento module:disable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush

La eliminación de datos de la base de datos no se realiza automáticamente mediante los comandos anteriores. Antes de eliminar manualmente las tablas y el atributo de producto, realiza una copia de seguridad de la base de datos.