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

Requisitos

• Magento 2 con el móduloMagento_Catalog.
• Acceso a la consola del servidor.
• Permisos para ejecutar comandosbin/magento.
• Acceso de administrador al panel de Magento.

Instalación mediante Composer

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

Recibirás por e-mail los datos de acceso al repositorio Composer, dirección de e-mail del cliente y token de licencia, tras la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de correo electrónico de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.

composer config repositories.kowal composer https://repo.kowal.store

composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"

composer require kowal/module-productinfo

php bin/magento module:enable Kowal_ProductInfo

php bin/magento setup:upgrade

Este comando añadirá:

• el atributo de productokowal_product_info_display,
• las tablaskowal_productinfo_icon_groupykowal_productinfo_icon.

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

php bin/magento cache:flush

Instalación manual

1. Copia el módulo al directorio:

app/code/Kowal/ProductInfo

php bin/magento module:enable Kowal_ProductInfo
php bin/magento setup:upgrade
php bin/magento cache:flush

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

Configuración global

Panel de administración:

Stores > Configuration > Kowal > Product info

Ajustes

La secciónUstawieniacontrola el bloque base de iconos.

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

Información 1-7

Las secciones deInformacja 1aInformacja 7definen el conjunto base 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 base se muestra en la ficha de producto dentro del diseño existente del módulo.

Grupos dinámicos de iconos

La secciónDynamiczne grupy ikoncontrola la nueva función de asignación de grupos de iconos a productos.

• Wlacz dynamiczne grupy na karcie produktu- activa la renderización de grupos dinámicos en la PDP.
• Maksymalna liczba grup na produkcie- límite de grupos mostrados en una sola ficha de producto;0significa 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 globalWlacz.
• Wlacz na tym produkcie- el bloque base de iconos se muestra incluso cuando está desactivado globalmente.
• Wylacz na tym produkcie- el bloque base de iconos queda oculto incluso cuando está activado globalmente.

Este ajuste se aplica solo al bloque base 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 enDodaj grupe ikon.
2. ConfiguraStatus.
3. IntroduceNazwa techniczna.
4. Opcionalmente, introduceNaglowek na karcie produktu.
5. Opcionalmente, introduceTooltip grupy.
6. ConfiguraPriorytet; un valor más bajo significa una posición más alta en la ficha de producto.
7. SeleccionaStore View;All Store Viewssignifica todas las vistas de tienda.
8. SeleccionaTyp dopasowania.
9. CompletaSKUoID kategorii, de acuerdo con el tipo de coincidencia seleccionado.
10. Añade iconos en la secciónIkony 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 se pueden introducir 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 subido 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 base de información de la configuración global en un diseño horizontal. Los grupos dinámicos de iconos están pensados para fichas de producto y no se renderizan por defecto en los widgets CMS.

Prueba tras la configuración

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

1. Un producto con el ajusteDziedzicz z konfiguracji.
2. Un producto con el ajusteWlacz na tym produkcie.
3. Un producto con el ajusteWylacz na tym produkcie.
4. Un producto asignado a la categoría utilizada en el grupo dinámico.
5. Un producto con el SKU concreto utilizado en el grupo dinámico.
6. Un producto sin coincidencia con ningún grupo dinámico.
7. Los tooltips del bloque base y de los grupos dinámicos.
8. La corrección de los iconos después de limpiar la caché.

Caché y despliegue 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 realizar cambios en archivos LESS, JS o templates en modo producción, es necesario reconstruir los recursos estáticos:

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

Desinstalación

Desactiva el módulo:

php bin/magento module:disable Kowal_ProductInfo
php bin/magento setup:upgrade
php 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, haz una copia de seguridad de la base de datos.