Installatie- en configuratiehandleiding

Module

Kowal_ProductGallery

Composer-pakket:

kowal/module-product-gallery

Vereisten

Controleer vóór de installatie of de omgeving aan de volgende voorwaarden voldoet:

• Magento 2 met een actieve catalogusmodule,
• PHP in een versie die compatibel is met de vereisten van het pakket,
• toegang tot een Composer-repository of Git-repository van waaruit de module wordt gepubliceerd,
• rechten om bin/magento-commando's uit te voeren,
• beheerderstoegang tot het Magento-paneel om instellingen te configureren.

Installatie via Composer

Als de module vanuit een private GitHub-repository wordt gepubliceerd, voeg dan eerst de repository toe aan de Composer-configuratie:

composer config repositories.module.kowal.product.gallery vcs https://github.com/kowalco/product-gallery

Als de repository autorisatie vereist, voeg dan een GitHub access token toe:

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

Installeer vervolgens de module:

composer require kowal/module-product-gallery

Activering van de module in Magento

Voer na de installatie van het pakket de standaardset Magento-commando's uit:

bin/magento module:enable Kowal_ProductGallerybin/magento setup:upgradebin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flush

Als de webshop in developer mode draait, kunnen sommige commando's afhankelijk zijn van het deploymentproces van het project. In een productieomgeving wordt aanbevolen een volledige standaarddeployment uit te voeren volgens het projectbeleid.

Verificatie van de installatie

Controleer na het activeren van de module:

1. Of de module zichtbaar is in de lijst:

bin/magento module:status Kowal_ProductGallery

2. Of op de desktop-productpagina de galerij is vervangen door een grid met grote afbeeldingen.

3. Of een klik op een afbeelding de standaard Magento-galerij in fullscreen opent.

4. Of de mobiele weergave ongewijzigd is gebleven.

Locatie van de instellingen in het beheerpaneel

De moduleconfiguratie is beschikbaar in:

Stores > Configuration > Catalog > Catalog > Kowal Product Gallery

Toegang tot deze sectie hangt af van de ACL-rechten die aan de administrator zijn toegewezen.

Beschikbare instellingen

1. Aantal kolommen in de grid

Veld:

Aantal kolommen in de grid

Beschrijving:

Bepaalt het aantal kolommen in de desktop-grid met productafbeeldingen.

Aanbeveling:

• 2 voor een klassieke, overzichtelijke lay-out,
• hogere waarden alleen als de productafbeeldingen nog steeds groot en duidelijk genoeg blijven.

2. Afbeeldingsbreedte

Veld:

Afbeeldingsbreedte

Beschrijving:

Definieert de maximale breedte van de afbeelding in de desktop-grid, in pixels.

Aanbeveling:

• voor vierkante afbeeldingen is 640 een goed uitgangspunt.

3. Afbeeldingshoogte

Veld:

Afbeeldingshoogte

Beschrijving:

Definieert de maximale hoogte van de afbeelding in de desktop-grid, in pixels.

Aanbeveling:

• stel voor vierkante afbeeldingen een waarde in die gelijk is aan de breedte, bijvoorbeeld 640,
• pas voor afbeeldingen met andere verhoudingen de hoogte aan op het werkelijke formaat van het productmateriaal.

Configuratie-aanbevelingen

• Gebruik productafbeeldingen met vergelijkbare verhoudingen voor een consistent visueel effect.
• Stel voor vierkante afbeeldingen dezelfde waarden in voor breedte en hoogte.
• Test na het wijzigen van de afbeeldingsformaten het uiterlijk van de productpagina op enkele representatieve producten.
• Controleer de werking voor eenvoudige en configureerbare producten.

Afbeeldingen opnieuw opbouwen na formaatwijzigingen

Als wijzigingen in de configuratie of view-instellingen een vernieuwing van de cache van catalogusafbeeldingen vereisen, voer dan uit:

bin/magento catalog:images:resize

Maak na het voltooien van het opnieuw opbouwen de cache leeg:

bin/magento cache:clean

Controle na deployment

Controleer na deployment naar de test- of productieomgeving:

• het uiterlijk van de galerij op desktop,
• dat er geen regressies zijn op mobile,
• de werking van fullscreen na een klik op een afbeelding,
• de werking van de galerij voor configureerbare producten,
• de correcte sticky-werking van de kolom met productinformatie,
• de laadtijd van de productpagina en de basisindicatoren voor renderkwaliteit.

Meest voorkomende aandachtspunten bij deployment

• Als wijzigingen niet zichtbaar zijn, controleer dan eerst de cache en de deployment van statische resources.
• Als de webshop een sterk aangepaste theme gebruikt, is het verstandig om de compatibiliteit van het galerijsjabloon met het actieve theme te bevestigen.
• Als de administrator de module-instellingen niet ziet, controleer dan de toegewezen ACL-rechten voor zijn rol.