Kowal Product Info - instrukcja instalacji i konfiguracji

Wymagania

• Magento 2 z wlaczonym modulem Magento_Catalog.
• Dostep do konsoli serwera.
• Uprawnienia do uruchamiania komend bin/magento.
• Dostep administratora do panelu Magento.

Instalacja przez Composer

1. Dodaj repozytorium modulu:

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

2. Jezeli repozytorium jest prywatne, dodaj token GitHub:

composer config --global --auth github-oauth.github.com <YOUR_TOKEN>

3. Zainstaluj modul:

composer require kowal/module-productinfo

4. Wlacz modul:

php bin/magento module:enable Kowal_ProductInfo

5. Uruchom aktualizacje bazy danych:

php bin/magento setup:upgrade

Ta komenda doda:

• atrybut produktu kowal_product_info_display,
• tabele kowal_productinfo_icon_group i kowal_productinfo_icon.

6. W trybie produkcyjnym przebuduj DI i statyczne zasoby:

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

7. Wyczysc cache:

php bin/magento cache:flush

Instalacja reczna

1. Skopiuj modul do katalogu:

app/code/Kowal/ProductInfo

2. Uruchom:

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

3. W trybie produkcyjnym dodatkowo wykonaj:

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

Konfiguracja globalna

Panel administracyjny:

Stores > Configuration > Kowal > Product info

Ustawienia

Sekcja Ustawienia steruje bazowym blokiem ikon.

• Wlacz - wlacza lub wylacza bazowy blok na karcie produktu.
• Naglowek nad ikonami - naglowek widoczny nad bazowym zestawem ikon.

Informacje 1-7

Sekcje Informacja 1 do Informacja 7 definiuja bazowy zestaw ikon.

Dla kazdej informacji mozna ustawic:

• Ikona - plik SVG, PNG, JPG, JPEG, GIF albo WEBP,
• Naglowek - tekst widoczny przy ikonie,
• Tresc - tresc tooltipa.

Bazowy blok jest wyswietlany na karcie produktu w istniejacym ukladzie modulu.

Dynamiczne grupy ikon

Sekcja Dynamiczne grupy ikon steruje nowa funkcja przypisywania grup ikon do produktow.

• Wlacz dynamiczne grupy na karcie produktu - wlacza renderowanie dynamicznych grup na PDP.
• Maksymalna liczba grup na produkcie - limit grup wyswietlanych na jednej karcie produktu; 0 oznacza brak limitu.

Konfiguracja per produkt

Na formularzu produktu dostepny jest atrybut:

Obecny blok ikon Product Info

Opcje:

• Dziedzicz z konfiguracji - produkt korzysta z globalnego ustawienia Wlacz.
• Wlacz na tym produkcie - bazowy blok ikon jest pokazany nawet wtedy, gdy globalnie jest wylaczony.
• Wylacz na tym produkcie - bazowy blok ikon jest ukryty nawet wtedy, gdy globalnie jest wlaczony.

To ustawienie dotyczy tylko bazowego bloku ikon. Dynamiczne grupy sa zarzadzane osobno.

Zarzadzanie dynamicznymi grupami ikon

Panel administracyjny:

Kowal > Product Info > Grupy ikon

Dodanie grupy

1. Kliknij Dodaj grupe ikon.
2. Ustaw Status.
3. Wpisz Nazwa techniczna.
4. Opcjonalnie wpisz Naglowek na karcie produktu.
5. Opcjonalnie wpisz Tooltip grupy.
6. Ustaw Priorytet; nizsza wartosc oznacza wyzsza pozycje na karcie produktu.
7. Wybierz Store View; All Store Views oznacza wszystkie widoki sklepu.
8. Wybierz Typ dopasowania.
9. Uzupelnij SKU lub ID kategorii, zgodnie z wybranym typem dopasowania.
10. Dodaj ikony w sekcji Ikony w grupie.
11. Zapisz grupe.

Typy dopasowania

• SKU lub kategoria - grupa pojawi sie, jezeli produkt pasuje po SKU albo po kategorii.
• Tylko SKU - grupa pojawi sie tylko dla produktow o wskazanych SKU.
• Tylko kategoria - grupa pojawi sie tylko dla produktow przypisanych do wskazanych kategorii.

SKU i ID kategorii mozna wpisywac po przecinku albo kazda wartosc w nowej linii.

Konfiguracja ikon w grupie

Dla kazdej ikony mozna ustawic:

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

Wgrany plik ikony nadpisuje recznie wpisana sciezke lub URL dla danego wiersza.

Widget CMS/Page Builder

Modul udostepnia widget:

Product Info

Widget wyswietla bazowy zestaw informacji z konfiguracji globalnej w ukladzie poziomym. Dynamiczne grupy ikon sa przeznaczone dla kart produktow i nie sa domyslnie renderowane w widgetach CMS.

Test po konfiguracji

Po instalacji i konfiguracji sprawdz:

1. Produkt z ustawieniem Dziedzicz z konfiguracji.
2. Produkt z ustawieniem Wlacz na tym produkcie.
3. Produkt z ustawieniem Wylacz na tym produkcie.
4. Produkt przypisany do kategorii uzytej w dynamicznej grupie.
5. Produkt z konkretnym SKU uzytym w dynamicznej grupie.
6. Produkt bez dopasowania do zadnej dynamicznej grupy.
7. Tooltipy bazowego bloku i dynamicznych grup.
8. Poprawnosc ikon po wyczyszczeniu cache.

Cache i wdrozenie zmian

Po zmianie konfiguracji, grup ikon albo plikow ikon zalecane jest wyczyszczenie cache:

php bin/magento cache:flush

Po zmianach w plikach LESS, JS albo template'ach w trybie produkcyjnym nalezy przebudowac statyczne zasoby:

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

Odinstalowanie

Wylacz modul:

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

Usuniecie danych z bazy nie jest wykonywane automatycznie przez powyzsze komendy. Przed recznym usuwaniem tabel i atrybutu produktu wykonaj kopie bazy danych.