Kowal Product Info - guide d’installation et de configuration

Prérequis

• Magento 2 avec le module Magento_Catalog activé.
• Accès à la console du serveur.
• Autorisations permettant d’exécuter les commandes bin/magento.
• Accès administrateur au panneau Magento.

Installation via Composer

1. Ajoutez le dépôt du module :

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

2. Si le dépôt est privé, ajoutez le token GitHub :

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

3. Installez le module :

composer require kowal/module-productinfo

4. Activez le module :

php bin/magento module:enable Kowal_ProductInfo

5. Lancez la mise à jour de la base de données :

php bin/magento setup:upgrade

Cette commande ajoutera :

• l’attribut produit kowal_product_info_display,
• les tables kowal_productinfo_icon_group et kowal_productinfo_icon.

6. En mode production, reconstruisez le DI et les ressources statiques :

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

7. Videz le cache :

php bin/magento cache:flush

Installation manuelle

1. Copiez le module dans le répertoire :

app/code/Kowal/ProductInfo

2. Exécutez :

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

3. En mode production, exécutez également :

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

Configuration globale

Panneau d’administration :

Stores > Configuration > Kowal > Product info

Paramètres

La section Ustawienia contrôle le bloc d’icônes de base.

• Wlacz - active ou désactive le bloc de base sur la fiche produit.
• Naglowek nad ikonami - en-tête visible au-dessus de l’ensemble d’icônes de base.

Informations 1-7

Les sections Informacja 1 à Informacja 7 définissent l’ensemble d’icônes de base.

Pour chaque information, vous pouvez définir :

• Ikona - fichier SVG, PNG, JPG, JPEG, GIF ou WEBP,
• Naglowek - texte visible à côté de l’icône,
• Tresc - contenu du tooltip.

Le bloc de base est affiché sur la fiche produit dans la mise en page existante du module.

Groupes d’icônes dynamiques

La section Dynamiczne grupy ikon contrôle la nouvelle fonction d’attribution de groupes d’icônes aux produits.

• Wlacz dynamiczne grupy na karcie produktu - active le rendu des groupes dynamiques sur la PDP.
• Maksymalna liczba grup na produkcie - limite de groupes affichés sur une fiche produit ; 0 signifie aucune limite.

Configuration par produit

L’attribut suivant est disponible dans le formulaire produit :

Obecny blok ikon Product Info

Options :

• Dziedzicz z konfiguracji - le produit utilise le paramètre global Wlacz.
• Wlacz na tym produkcie - le bloc d’icônes de base est affiché même s’il est désactivé globalement.
• Wylacz na tym produkcie - le bloc d’icônes de base est masqué même s’il est activé globalement.

Ce paramètre concerne uniquement le bloc d’icônes de base. Les groupes dynamiques sont gérés séparément.

Gestion des groupes d’icônes dynamiques

Panneau d’administration :

Kowal > Product Info > Grupy ikon

Ajout d’un groupe

1. Cliquez sur Dodaj grupe ikon.
2. Définissez Status.
3. Saisissez Nazwa techniczna.
4. Renseignez éventuellement Naglowek na karcie produktu.
5. Renseignez éventuellement Tooltip grupy.
6. Définissez Priorytet ; une valeur plus faible signifie une position plus élevée sur la fiche produit.
7. Sélectionnez Store View ; All Store Views désigne toutes les vues de boutique.
8. Sélectionnez Typ dopasowania.
9. Complétez SKU ou ID kategorii, conformément au type de correspondance sélectionné.
10. Ajoutez les icônes dans la section Ikony w grupie.
11. Enregistrez le groupe.

Types de correspondance

• SKU lub kategoria - le groupe apparaîtra si le produit correspond par SKU ou par catégorie.
• Tylko SKU - le groupe apparaîtra uniquement pour les produits ayant les SKU indiqués.
• Tylko kategoria - le groupe apparaîtra uniquement pour les produits attribués aux catégories indiquées.

Les SKU et les ID de catégorie peuvent être saisis séparés par des virgules ou avec chaque valeur sur une nouvelle ligne.

Configuration des icônes dans un groupe

Pour chaque icône, vous pouvez définir :

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

Le fichier d’icône importé remplace le chemin ou l’URL saisi manuellement pour la ligne concernée.

Widget CMS/Page Builder

Le module fournit le widget :

Product Info

Le widget affiche l’ensemble d’informations de base depuis la configuration globale dans une mise en page horizontale. Les groupes d’icônes dynamiques sont destinés aux fiches produit et ne sont pas rendus par défaut dans les widgets CMS.

Test après configuration

Après l’installation et la configuration, vérifiez :

1. Un produit avec le paramètre Dziedzicz z konfiguracji.
2. Un produit avec le paramètre Wlacz na tym produkcie.
3. Un produit avec le paramètre Wylacz na tym produkcie.
4. Un produit attribué à une catégorie utilisée dans un groupe dynamique.
5. Un produit avec un SKU spécifique utilisé dans un groupe dynamique.
6. Un produit ne correspondant à aucun groupe dynamique.
7. Les tooltips du bloc de base et des groupes dynamiques.
8. Le bon affichage des icônes après le vidage du cache.

Cache et déploiement des modifications

Après une modification de la configuration, des groupes d’icônes ou des fichiers d’icônes, il est recommandé de vider le cache :

php bin/magento cache:flush

Après des modifications dans les fichiers LESS, JS ou les templates en mode production, vous devez reconstruire les ressources statiques :

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

Désinstallation

Désactivez le module :

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

La suppression des données de la base n’est pas effectuée automatiquement par les commandes ci-dessus. Avant de supprimer manuellement les tables et l’attribut produit, effectuez une sauvegarde de la base de données.