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:

Receberá por e-mail, após a compra, os dados de acesso ao repositório Composer, ou seja, o endereço de e-mail do cliente e o token de licença. Também estão disponíveis no painel do cliente depois de iniciar sessão em kowal.store. Substitua TWOJ_EMAIL_KLIENTA pelo endereço de e-mail da sua conta e TWOJ_TOKEN pelo token recebido. Execute os comandos no diretório raiz do Magento.

composer config repositories.kowal composer https://repo.kowal.store

2. Configure os dados de acesso ao repositório Composer Kowal:

composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

3. Instale o módulo:

composer require kowal/module-productinfo

4. Ative o módulo:

php bin/magento module:enable Kowal_ProductInfo

5. Execute a atualização 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 base de ícones.

• Wlacz - ativa ou desativa o bloco base na ficha do produto.
• Naglowek nad ikonami - cabeçalho visível acima do conjunto base de ícones.

Informações 1-7

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

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 base é apresentado na ficha do produto no layout existente do módulo.

Grupos dinâmicos de ícones

A secção Dynamiczne grupy ikon controla a nova função 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 ficha 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 base de ícones é apresentado mesmo quando está desativado globalmente.
• Wylacz na tym produkcie - o bloco base de ícones fica oculto mesmo quando está ativado globalmente.

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

Gestão dos 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 ficha do 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 será apresentado se o produto corresponder por SKU ou por categoria.
• Tylko SKU - o grupo será apresentado apenas para produtos com os SKU indicados.
• Tylko kategoria - o grupo será apresentado apenas para produtos atribuídos às categorias indicadas.

Os SKU e ID de categoria podem ser introduzidos separados por vírgulas ou 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 linha em questão.

Widget CMS/Page Builder

O módulo disponibiliza o widget:

Product Info

O widget apresenta o conjunto base de informações da configuração global num layout horizontal. Os grupos dinâmicos de ícones destinam-se às fichas de produto e, por predefinição, não são renderizados 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 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, deve 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 de segurança da base de dados.