Instrucțiuni de instalare și configurare
Modul
Kowal_ProductGallery
Pachet Composer:
kowal/module-product-gallery
Cerințe
Înainte de instalare, asigurați-vă că mediul îndeplinește următoarele condiții:
- Magento 2 cu modulul catalog activ,
- PHP într-o versiune compatibilă cu cerințele pachetului,
- acces la depozitul Composer sau la depozitul Git din care este publicat modulul,
- permisiuni pentru rularea comenzilor
bin/magento, - acces administrativ la panoul Magento pentru configurarea setărilor.
Instalare prin Composer
Dacă modulul este publicat dintr-un depozit GitHub privat, adăugați mai întâi depozitul în configurația Composer:
composer config repositories.module.kowal.product.gallery vcs https://github.com/kowalco/product-galleryDacă depozitul necesită autorizare, adăugați token-ul de acces GitHub:
composer config --global --auth github-oauth.github.com Apoi instalați modulul:
composer require kowal/module-product-galleryActivarea modulului în Magento
După instalarea pachetului, executați setul standard de comenzi Magento:
bin/magento module:enable Kowal_ProductGallerybin/magento setup:upgradebin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushDacă magazinul funcționează în modul developer, o parte dintre comenzi poate depinde de procesul de deployment al proiectului. În mediul de producție se recomandă efectuarea unui deployment standard complet, conform politicii proiectului.
Verificarea instalării
După activarea modulului, verificați:
- Dacă modulul este vizibil în listă:
bin/magento module:status Kowal_ProductGalleryDacă pe pagina de produs desktop galeria a fost înlocuită cu o grilă de imagini mari.
Dacă un clic pe imagine deschide fullscreen-ul standard al galeriei Magento.
Dacă vizualizarea mobilă a rămas neschimbată.
Locația setărilor în panoul de administrare
Configurarea modulului este disponibilă în:
Stores > Configuration > Catalog > Catalog > Kowal Product Gallery
Accesul la această secțiune depinde de permisiunile ACL atribuite administratorului.
Setări disponibile
1. Numărul de coloane ale grilei
Câmp:
Numărul de coloane ale grilei
Descriere:
Determină numărul de coloane din grila desktop a imaginilor de produs.
Recomandare:
2pentru un aspect clasic și clar,- valori mai mari doar atunci când imaginile de produs rămân suficient de mari și clare.
2. Lățimea imaginii
Câmp:
Lățimea imaginii
Descriere:
Definește lățimea maximă a imaginii în grila desktop, în pixeli.
Recomandare:
- pentru imaginile pătrate, un bun punct de plecare este
640.
3. Înălțimea imaginii
Câmp:
Înălțimea imaginii
Descriere:
Definește înălțimea maximă a imaginii în grila desktop, în pixeli.
Recomandare:
- pentru imaginile pătrate, setați o valoare egală cu lățimea, de exemplu
640, - pentru imaginile cu alte proporții, ajustați înălțimea la formatul real al materialelor de produs.
Recomandări de configurare
- Pentru un efect vizual coerent, utilizați imagini de produs cu proporții similare.
- Pentru imaginile pătrate, setați aceleași valori pentru lățime și înălțime.
- După modificarea dimensiunilor imaginilor, testați aspectul paginii de produs pe câteva produse reprezentative.
- Verificați funcționarea pentru produse simple și configurabile.
Regenerarea imaginilor după modificarea dimensiunilor
Dacă modificările de configurare sau ale setărilor de vizualizare necesită reîmprospătarea cache-ului imaginilor din catalog, rulați:
bin/magento catalog:images:resizeDupă finalizarea regenerării, curățați cache-ul:
bin/magento cache:cleanVerificare după deployment
După deployment în mediul de test sau de producție, verificați:
- aspectul galeriei pe desktop,
- absența regresiilor pe mobile,
- funcționarea fullscreen-ului după clic pe imagine,
- funcționarea galeriei pentru produsele configurable,
- corectitudinea comportamentului sticky al coloanei cu informații despre produs,
- timpul de încărcare al paginii de produs și indicatorii de bază ai calității randării.
Cele mai frecvente observații de deployment
- Dacă modificările nu sunt vizibile, verificați mai întâi cache-ul și deployment-ul resurselor statice.
- Dacă magazinul folosește o temă puternic modificată, merită confirmată compatibilitatea șablonului galeriei cu tema activă.
- Dacă administratorul nu vede setările modulului, verificați permisiunile ACL atribuite rolului său.


