Kowal Product Info - instruções de instalação e configuração

Requisitos

• Magento 2 com o módulo Magento_Catalog ativado.
• Acesso à consola do servidor.
• Permissões para executar comandos bin/magento.
• Acesso de administrador ao painel Magento.

Instalação através do Composer

1. Adicione o repositório do módulo:

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

2. Se o repositório for privado, adicione um token GitHub:

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

3. Instale o módulo:

composer require kowal/module-productinfo

4. Ative o módulo:

php bin/magento module:enable Kowal_ProductInfo

5. Execute as atualizações da base de dados:

php bin/magento setup:upgrade

Este comando adiciona:

• o atributo de produto kowal_product_info_display,
• as tabelas kowal_productinfo_icon_group e kowal_productinfo_icon.

6. Em modo de produção, reconstrua o DI e os recursos estáticos:

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

7. Limpe a cache:

php bin/magento cache:flush

Instalação manual

1. Copie o módulo para o diretório:

app/code/Kowal/ProductInfo

2. Execute:

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

3. Em modo de produção, execute adicionalmente:

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

Configuração global

Painel de administração:

Stores > Configuration > Kowal > Product info

Definições

A secção Ustawienia controla o bloco de ícones de base.

• Wlacz - ativa ou desativa o bloco de base na página de produto.
• Naglowek nad ikonami - título visível acima do conjunto de ícones de base.

Informações 1-7

As secções de Informacja 1 a Informacja 7 definem o conjunto de ícones de base.

Para cada informação, é possível definir:

• Ikona - ficheiro SVG, PNG, JPG, JPEG, GIF ou WEBP,
• Naglowek - texto visível junto ao ícone,
• Tresc - conteúdo do tooltip.

O bloco de base é apresentado na página de produto no layout existente do módulo.

Grupos dinâmicos de ícones

A secção Dynamiczne grupy ikon controla a nova funcionalidade de atribuição de grupos de ícones a produtos.

• Wlacz dynamiczne grupy na karcie produktu - ativa a renderização de grupos dinâmicos na PDP.
• Maksymalna liczba grup na produkcie - limite de grupos apresentados numa página de produto; 0 significa sem limite.

Configuração por produto

No formulário do produto está disponível o atributo:

Obecny blok ikon Product Info

Opções:

• Dziedzicz z konfiguracji - o produto utiliza a definição global Wlacz.
• Wlacz na tym produkcie - o bloco de ícones de base é mostrado mesmo quando está desativado globalmente.
• Wylacz na tym produkcie - o bloco de ícones de base fica oculto mesmo quando está ativado globalmente.

Esta definição aplica-se apenas ao bloco de ícones de base. Os grupos dinâmicos são geridos separadamente.

Gestão de grupos dinâmicos de ícones

Painel de administração:

Kowal > Product Info > Grupy ikon

Adicionar um grupo

1. Clique em Dodaj grupe ikon.
2. Defina Status.
3. Introduza Nazwa techniczna.
4. Opcionalmente, introduza Naglowek na karcie produktu.
5. Opcionalmente, introduza Tooltip grupy.
6. Defina Priorytet; um valor mais baixo significa uma posição mais alta na página de produto.
7. Selecione Store View; All Store Views significa todas as vistas da loja.
8. Selecione Typ dopasowania.
9. Preencha SKU ou ID kategorii, de acordo com o tipo de correspondência selecionado.
10. Adicione ícones na secção Ikony w grupie.
11. Guarde o grupo.

Tipos de correspondência

• SKU lub kategoria - o grupo aparece se o produto corresponder por SKU ou por categoria.
• Tylko SKU - o grupo aparece apenas para produtos com os SKU indicados.
• Tylko kategoria - o grupo aparece apenas para produtos atribuídos às categorias indicadas.

Os SKU e ID de categorias podem ser introduzidos separados por vírgulas ou com cada valor numa nova linha.

Configuração dos ícones no grupo

Para cada ícone, é possível definir:

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

O ficheiro de ícone carregado substitui o caminho ou URL introduzido manualmente para a respetiva linha.

Widget CMS/Page Builder

O módulo disponibiliza o widget:

Product Info

O widget apresenta o conjunto de informações de base da configuração global num layout horizontal. Os grupos dinâmicos de ícones destinam-se às páginas de produto e não são renderizados por defeito em widgets CMS.

Teste após a configuração

Após a instalação e configuração, verifique:

1. Produto com a definição Dziedzicz z konfiguracji.
2. Produto com a definição Wlacz na tym produkcie.
3. Produto com a definição Wylacz na tym produkcie.
4. Produto atribuído à categoria utilizada no grupo dinâmico.
5. Produto com um SKU específico utilizado no grupo dinâmico.
6. Produto sem correspondência com qualquer grupo dinâmico.
7. Tooltips do bloco de base e dos grupos dinâmicos.
8. Correção dos ícones após limpar a cache.

Cache e implementação de alterações

Após alterar a configuração, grupos de ícones ou ficheiros de ícones, recomenda-se limpar a cache:

php bin/magento cache:flush

Após alterações em ficheiros LESS, JS ou templates em modo de produção, é necessário reconstruir os recursos estáticos:

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

Desinstalação

Desative o módulo:

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

A remoção dos dados da base de dados não é efetuada automaticamente pelos comandos acima. Antes de remover manualmente as tabelas e o atributo de produto, faça uma cópia da base de dados.