Kowal Product Info - instrucțiuni de instalare și configurare

Cerințe

• Magento 2 cu modulul Magento_Catalog activat.
• Acces la consola serverului.
• Permisiuni pentru rularea comenzilor bin/magento.
• Acces de administrator la panoul Magento.

Instalare prin Composer

1. Adăugați repository-ul modulului:

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

2. Dacă repository-ul este privat, adăugați tokenul GitHub:

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

3. Instalați modulul:

composer require kowal/module-productinfo

4. Activați modulul:

php bin/magento module:enable Kowal_ProductInfo

5. Rulați actualizarea bazei de date:

php bin/magento setup:upgrade

Această comandă va adăuga:

• atributul de produs kowal_product_info_display,
• tabelele kowal_productinfo_icon_group și kowal_productinfo_icon.

6. În modul de producție, reconstruiți DI și resursele statice:

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

7. Goliți cache-ul:

php bin/magento cache:flush

Instalare manuală

1. Copiați modulul în directorul:

app/code/Kowal/ProductInfo

2. Rulați:

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

3. În modul de producție, executați suplimentar:

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

Configurare globală

Panoul de administrare:

Stores > Configuration > Kowal > Product info

Setări

Secțiunea Ustawienia controlează blocul de pictograme de bază.

• Wlacz - activează sau dezactivează blocul de bază pe pagina produsului.
• Naglowek nad ikonami - antetul vizibil deasupra setului de bază de pictograme.

Informații 1-7

Secțiunile Informacja 1 până la Informacja 7 definesc setul de bază de pictograme.

Pentru fiecare informație se poate seta:

• Ikona - fișier SVG, PNG, JPG, JPEG, GIF sau WEBP,
• Naglowek - textul vizibil lângă pictogramă,
• Tresc - conținutul tooltipului.

Blocul de bază este afișat pe pagina produsului în layoutul existent al modulului.

Grupuri dinamice de pictograme

Secțiunea Dynamiczne grupy ikon controlează noua funcție de atribuire a grupurilor de pictograme către produse.

• Wlacz dynamiczne grupy na karcie produktu - activează randarea grupurilor dinamice pe PDP.
• Maksymalna liczba grup na produkcie - limita grupurilor afișate pe o singură pagină de produs; 0 înseamnă fără limită.

Configurare per produs

În formularul produsului este disponibil atributul:

Obecny blok ikon Product Info

Opțiuni:

• Dziedzicz z konfiguracji - produsul folosește setarea globală Wlacz.
• Wlacz na tym produkcie - blocul de pictograme de bază este afișat chiar dacă este dezactivat global.
• Wylacz na tym produkcie - blocul de pictograme de bază este ascuns chiar dacă este activat global.

Această setare se aplică doar blocului de pictograme de bază. Grupurile dinamice sunt gestionate separat.

Gestionarea grupurilor dinamice de pictograme

Panoul de administrare:

Kowal > Product Info > Grupy ikon

Adăugarea unui grup

1. Faceți clic pe Dodaj grupe ikon.
2. Setați Status.
3. Introduceți Nazwa techniczna.
4. Opțional, introduceți Naglowek na karcie produktu.
5. Opțional, introduceți Tooltip grupy.
6. Setați Priorytet; o valoare mai mică înseamnă o poziție mai înaltă pe pagina produsului.
7. Selectați Store View; All Store Views înseamnă toate vizualizările magazinului.
8. Selectați Typ dopasowania.
9. Completați SKU sau ID kategorii, conform tipului de potrivire selectat.
10. Adăugați pictograme în secțiunea Ikony w grupie.
11. Salvați grupul.

Tipuri de potrivire

• SKU lub kategoria - grupul va apărea dacă produsul se potrivește după SKU sau după categorie.
• Tylko SKU - grupul va apărea doar pentru produsele cu SKU-urile indicate.
• Tylko kategoria - grupul va apărea doar pentru produsele atribuite categoriilor indicate.

SKU-urile și ID-urile de categorie pot fi introduse separate prin virgulă sau fiecare valoare pe o linie nouă.

Configurarea pictogramelor din grup

Pentru fiecare pictogramă se poate seta:

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

Fișierul de pictogramă încărcat suprascrie calea sau URL-ul introdus manual pentru rândul respectiv.

Widget CMS/Page Builder

Modulul pune la dispoziție widgetul:

Product Info

Widgetul afișează setul de bază de informații din configurația globală într-un layout orizontal. Grupurile dinamice de pictograme sunt destinate paginilor de produs și nu sunt randate implicit în widgeturile CMS.

Test după configurare

După instalare și configurare, verificați:

1. Produsul cu setarea Dziedzicz z konfiguracji.
2. Produsul cu setarea Wlacz na tym produkcie.
3. Produsul cu setarea Wylacz na tym produkcie.
4. Produsul atribuit categoriei utilizate în grupul dinamic.
5. Produsul cu un SKU concret utilizat în grupul dinamic.
6. Produsul fără potrivire cu niciun grup dinamic.
7. Tooltipurile blocului de bază și ale grupurilor dinamice.
8. Corectitudinea pictogramelor după golirea cache-ului.

Cache și implementarea modificărilor

După modificarea configurației, a grupurilor de pictograme sau a fișierelor de pictograme, se recomandă golirea cache-ului:

php bin/magento cache:flush

După modificări în fișierele LESS, JS sau template-uri în modul de producție, trebuie reconstruite resursele statice:

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

Dezinstalare

Dezactivați modulul:

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

Ștergerea datelor din bază nu este efectuată automat de comenzile de mai sus. Înainte de ștergerea manuală a tabelelor și a atributului de produs, creați o copie de siguranță a bazei de date.