Instruções de instalação e configuração

Módulo

Kowal_ProductGallery

Pacote Composer:

kowal/module-product-gallery

Requisitos

Antes da instalação, certifique-se de que o ambiente cumpre as seguintes condições:

• Magento 2 com o módulo de catálogo ativo,
• PHP numa versão compatível com os requisitos do pacote,
• acesso ao repositório Composer ou ao repositório Git a partir do qual o módulo é publicado,
• permissões para executar comandos bin/magento,
• acesso administrativo ao painel do Magento para configurar as definições.

Instalação através do Composer

Se o módulo for publicado a partir de um repositório privado GitHub, adicione primeiro o repositório à configuração do Composer:

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

Se o repositório exigir autorização, adicione o token de acesso GitHub:

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

Em seguida, instale o módulo:

composer require kowal/module-product-gallery

Ativação do módulo no Magento

Após a instalação do pacote, execute o conjunto padrão de comandos do Magento:

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

Se a loja funcionar em modo de desenvolvimento, alguns comandos podem depender do processo de deployment do projeto. Em ambiente de produção, recomenda-se a execução de um deployment padrão completo em conformidade com a política do projeto.

Verificação da instalação

Após ativar o módulo, verifique:

1. Se o módulo está visível na lista:

bin/magento module:status Kowal_ProductGallery

2. Se, na página de produto em desktop, a galeria foi substituída por uma grelha de imagens grandes.

3. Se clicar na imagem abre o fullscreen padrão da galeria do Magento.

4. Se a vista móvel permaneceu inalterada.

Localização das definições no painel de administração

A configuração do módulo está disponível em:

Stores > Configuration > Catalog > Catalog > Kowal Product Gallery

O acesso a esta secção depende das permissões ACL atribuídas ao administrador.

Definições disponíveis

1. Número de colunas da grelha

Campo:

Número de colunas da grelha

Descrição:

Define o número de colunas na grelha de imagens do produto em desktop.

Recomendação:

• 2 para um layout clássico e legível,
• valores mais altos apenas quando as imagens de produto continuarem adequadamente grandes e legíveis.

2. Largura da imagem

Campo:

Largura da imagem

Descrição:

Define a largura máxima da imagem na grelha de desktop, em píxeis.

Recomendação:

• para imagens quadradas, um bom ponto de partida é 640.

3. Altura da imagem

Campo:

Altura da imagem

Descrição:

Define a altura máxima da imagem na grelha de desktop, em píxeis.

Recomendação:

• para imagens quadradas, defina um valor igual à largura, por exemplo 640,
• para imagens com outras proporções, ajuste a altura ao formato real dos materiais de produto.

Recomendações de configuração

• Para um efeito visual consistente, utilize imagens de produto com proporções semelhantes.
• Para imagens quadradas, defina os mesmos valores de largura e altura.
• Após alterar os tamanhos das imagens, teste o aspeto da página do produto em vários produtos representativos.
• Verifique o funcionamento para produtos simples e configuráveis.

Regeneração de imagens após alterações de tamanho

Se as alterações de configuração ou das definições de visualização exigirem a atualização da cache das imagens do catálogo, execute:

bin/magento catalog:images:resize

Após concluir a regeneração, limpe a cache:

bin/magento cache:clean

Controlo após o deployment

Após o deployment para o ambiente de teste ou produção, verifique:

• o aspeto da galeria em desktop,
• a ausência de regressões no mobile,
• o funcionamento do fullscreen ao clicar na imagem,
• o funcionamento da galeria para produtos configuráveis,
• a correção do comportamento sticky da coluna com informações do produto,
• o tempo de carregamento da página do produto e os indicadores básicos de qualidade de renderização.

Observações de deployment mais frequentes

• Se as alterações não forem visíveis, verifique primeiro a cache e o deployment dos recursos estáticos.
• Se a loja utilizar um tema fortemente modificado, vale a pena confirmar a compatibilidade do template da galeria com o theme ativo.
• Se o administrador não vir as definições do módulo, verifique as permissões ACL atribuídas ao respetivo perfil.