Kowal Custom Tab - instalação e configuração

Requisitos

• Magento 2.4 ou mais recente.
• Acesso à CLI do Magento.
• Composer configurado para descarregar pacotes privados Kowal.
• Módulo base kowal/base instalado.
• Permissões de administrador para o painel Magento.

Instalação através do Composer

Adicione o repositório do pacote:

composer config repositories.custom.tab vcs https://github.com/kowalco/magento-2-custom-tab

Se o repositório exigir autenticação, configure o token:

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

Instale o módulo:

composer require kowal/module-customtab

Execute a atualização do Magento:

php bin/magento setup:upgrade

No ambiente de produção, execute a compilação DI e a implementação dos recursos estáticos de acordo com o processo do projeto:

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

Limpe a cache:

php bin/magento cache:flush

Verificação da instalação

Verifique se o módulo está ativo:

php bin/magento module:status Kowal_CustomTab

Se o módulo estiver inativo, ative-o:

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

Configuração do módulo

No painel Magento, aceda a:

Stores > Configuration > Kowal > Custom Tab

Defina a opção Enable module como Yes e, em seguida, guarde a configuração e limpe a cache, se o Magento o solicitar.

Gestão de separadores

No painel de administração, aceda a:

Kowal > Custom Tabs > Custom Tab

Clique em Add new CustomTab para criar um novo separador.

Preencha os campos:

• Name - nome do separador visível no frontend.
• Field type - tipo da origem do conteúdo.
• Attribute code - atributo de produto a partir do qual deve ser obtido o conteúdo do separador.
• Status - estado do separador.
• Sort Order - ordem de apresentação do separador.

Guarde o separador.

Tradução do nome do separador

O nome predefinido do separador é guardado para store_id = 0.

Para adicionar uma tradução para um Store View específico:

1. Abra um separador existente para edição.
2. Utilize o seletor Store View na área superior direita do formulário.
3. Selecione o Store View para o qual pretende alterar o nome.
4. Desmarque Use Default Value no campo Name.
5. Introduza o nome do separador para a versão linguística selecionada.
6. Guarde o formulário.

Se Use Default Value permanecer selecionado, o módulo utilizará o valor predefinido de store_id = 0.

Funcionamento no frontend

O módulo adiciona separadores à secção de detalhes do produto. O separador aparece apenas quando o produto tem um valor preenchido no atributo indicado na configuração do separador.

Para o nome do separador, o módulo aplica fallback:

1. Nome para o Store View atual.
2. Nome predefinido de store_id = 0.
3. Valor da tabela principal de separadores, mantido para compatibilidade.

O conteúdo do separador é filtrado pelo mecanismo CMS do Magento, pelo que pode conter tags HTML e widgets suportados pelo Magento.

Atualização de uma instalação existente

Após atualizar o módulo para uma versão com suporte multilingue, execute:

php bin/magento setup:upgradephp bin/magento cache:flush

A nova tabela de valores por Store View será adicionada pelo esquema declarativo do Magento. Após a primeira gravação de um separador existente, o seu nome predefinido também será persistido como registo store_id = 0.

Resolução de problemas

Se o separador não aparecer no frontend:

• Verifique se o módulo está ativado na configuração.
• Verifique se o separador tem Status definido como Yes.
• Verifique se o produto tem um valor preenchido no atributo indicado no campo Attribute code.
• Limpe a cache do Magento.
• Certifique-se de que o layout do tema continua a renderizar o bloco product.info.details.

Se a tradução do nome não aparecer no frontend:

• Verifique se está a editar o Store View correto.
• Verifique se Use Default Value está desmarcado para o campo Name.
• Guarde o separador e limpe a cache.