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
- Añade el repositorio del módulo:
composer config repositories.product.info vcs https://github.com/kowalco/product-info
- Si el repositorio es privado, añade un token de GitHub:
composer config --global --auth github-oauth.github.com
- Instala el módulo:
composer require kowal/module-productinfo
- Activa el módulo:
php bin/magento module:enable Kowal_ProductInfo
- 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.
- En modo producción, recompila DI y los recursos estáticos:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
- Limpia la caché:
php bin/magento cache:flush
Instalación manual
- Copia el módulo en el directorio:
app/code/Kowal/ProductInfo
- Ejecuta:
php bin/magento module:enable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush
- 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.
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
- Haz clic en
Dodaj grupe ikon. - Configura
Status. - Introduce
Nazwa techniczna. - Opcionalmente, introduce
Naglowek na karcie produktu. - Opcionalmente, introduce
Tooltip grupy. - Configura
Priorytet; un valor más bajo significa una posición más alta en la ficha de producto. - Selecciona
Store View; All Store Views significa todas las vistas de tienda. - Selecciona
Typ dopasowania. - Completa
SKU o ID kategorii, según el tipo de coincidencia seleccionado. - Añade iconos en la sección
Ikony w grupie. - 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:
- Producto con el ajuste
Dziedzicz z konfiguracji. - Producto con el ajuste
Wlacz na tym produkcie. - Producto con el ajuste
Wylacz na tym produkcie. - Producto asignado a la categoría utilizada en el grupo dinámico.
- Producto con un SKU concreto utilizado en el grupo dinámico.
- Producto sin coincidencia con ningún grupo dinámico.
- Tooltips del bloque básico y de los grupos dinámicos.
- 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.