Instruções de instalação, configuração e implementação do módulo Kowal TrustedUs

Objetivo do módulo

Kowal TrustedUs é um módulo universal para Magento 2 destinado a apresentar empresas, clientes, parceiros, fornecedores, marcas e estudos de caso na loja.

O módulo pode ser utilizado como:

• secção 'Confiaram em nós',
• lista de parceiros ou fornecedores,
• portefólio de projetos realizados,
• base de estudos de caso,
• secção que mostra aplicações de produtos,
• ferramenta para reforçar as ligações internas na loja.

Após a expansão mais recente, os widgets podem encaminhar para páginas internas de estudo de caso, por exemplo:

/trusted-us/vitcas

Nessa página são apresentados os registos do mesmo grupo e os produtos associados aos mesmos.

Requisitos

Antes da instalação, certifique-se de que a loja cumpre os requisitos:

• funciona em Magento 2,
• tem acesso ao Composer,
• tem acesso ao repositório do módulo,
• tem configurados os dados de acesso ao repositório Composer Kowal,
• permite executar comandos bin/magento,
• tem uma cópia de segurança do código e da base de dados antes da implementação em produção.

Instalação através do Composer

1. Adicionar o repositório Composer

No diretório raiz do Magento, execute:

Receberá por e-mail, após a compra, os dados de acesso ao repositório Composer, endereço de e-mail do cliente e token de licença. Também estão disponíveis no painel do cliente após 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. Adicionar o token de acesso

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

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

3. Instalação do módulo

composer require kowal/module-trustedus

4. Ativação do módulo

Nome do módulo Magento:

Kowal_TrustedUs

Ative o módulo:

php bin/magento module:enable Kowal_TrustedUs

5. Atualização do esquema da base de dados

php bin/magento setup:upgrade

Este comando irá criar ou atualizar as tabelas do módulo, incluindo o campo group_slug utilizado para as páginas internas de estudo de caso.

6. Limpeza da cache

php bin/magento cache:flush

Instalação em modo de produção

No ambiente de produção, recomenda-se o processo de implementação padrão do Magento.

Sequência de exemplo:

composer require kowal/module-trustedusphp bin/magento module:enable Kowal_TrustedUsphp bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Se a loja tiver o seu próprio pipeline CI/CD, os passos acima devem ser ajustados ao processo de implementação da loja.

Atualização de uma instalação existente

Se o módulo já estiver instalado, atualize-o através do Composer:

composer update kowal/module-trustedus

Em seguida, execute:

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

Em modo de produção:

php bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Configuração no painel de administração

Aceder à lista de empresas

Após a instalação, aceda no painel Magento a:

Content -> Zaufali nam -> Firmy

Consoante a configuração do menu, a entrada também pode estar disponível na secção:

Trusted Us -> Firmy

Adicionar uma empresa ou estudo de caso

Ao adicionar uma nova entrada, preencha os dados básicos:

• Nome da empresa - nome do cliente, parceiro, fornecedor, marca ou projeto.
• Endereço da página (URL) - endereço externo opcional; atualmente, os widgets criam ligações internas se a entrada tiver um slug de grupo definido.
• Grupo de estudo de caso / slug de URL - slug global utilizado para agrupar entradas e criar a ligação interna.
• Nome do projeto - título da realização ou do estudo de caso descritivo.
• Descrição breve do projeto - conteúdo apresentado junto à entrada.
• Ícone - logótipo da empresa ou da marca.
• Ativa - determina se a entrada é visível no frontend.
• Mostrar no widget de empresas em destaque - determina se a entrada será incluída no widget em destaque.
• Ordem - ordenação das entradas.
• Produtos - produtos associados à entrada.

Configuração do agrupamento e das ligações internas

O campo Grupo de estudo de caso / slug de URL serve para juntar várias entradas da mesma empresa numa única página interna.

Exemplo:

vitcas

Todas as entradas ativas com o mesmo slug ficarão visíveis na página:

/trusted-us/vitcas

Se introduzir um valor com espaços ou letras maiúsculas, o módulo irá guardá-lo como um slug seguro.

Exemplo:

Tandem Baits

será guardado como:

tandem-baits

Configuração dos produtos relacionados

Na secção Produtos / módulos relacionados, selecione os produtos que devem ser atribuídos a determinada empresa, realização ou estudo de caso.

Estas associações são utilizadas em dois locais:

• na ficha de produto, onde o módulo pode mostrar empresas ou realizações relacionadas,
• na página de estudo de caso /trusted-us/{slug}, onde os produtos são apresentados numa grelha semelhante à grelha de categorias de produtos.

Configuração do widget padrão

Na edição de uma página CMS, página inicial, landing page ou bloco CMS, adicione o widget:

Kowal: Zaufali nam

Parâmetros disponíveis:

• Título - cabeçalho da secção.
• Limite - número máximo de entradas apresentadas.
• Mostrar o nome do projeto - define se o nome do projeto deve estar visível por baixo do logótipo.

Se a entrada tiver o campo group_slug preenchido, ao clicar no logótipo o utilizador é encaminhado para a página interna:

/trusted-us/{slug}

Se group_slug estiver vazio, a entrada permanece sem ligação.

Configuração do widget de empresas em destaque

Na edição CMS, adicione o widget:

Kowal: Zaufali nam - wyróżnione firmy

Parâmetros disponíveis:

• Cabeçalho - texto principal da secção.
• Limite - número máximo de entradas apresentadas.

O widget mostra apenas entradas ativas que têm assinalada a opção:

Pokaż w widgecie wyróżnionych firm

Tal como o widget padrão, pode criar ligações para páginas internas de estudo de caso com base no campo group_slug.

Secção na ficha de produto

Se o produto tiver empresas ou estudos de caso atribuídos, o módulo pode apresentar automaticamente uma secção na ficha de produto.

A secção apresenta:

• logótipo da empresa,
• nome da empresa,
• nome do projeto,
• descrição breve do projeto.

Isto permite mostrar a utilização real do produto e reforçar a credibilidade da oferta.

Páginas de estudo de caso

As páginas de estudo de caso estão disponíveis no endereço:

/trusted-us/{slug}

Exemplo:

/trusted-us/vitcas

Na página são apresentados:

• todas as entradas ativas com o mesmo group_slug,
• descrições dos estudos de caso,
• logótipo da empresa,
• produtos atribuídos a cada entrada,
• grelha de produtos semelhante à grelha de categorias.

Estas páginas aumentam o número de ligações internas e criam um percurso adicional:

widget -> case study -> produkt

Suporte para múltiplas store views

O módulo suporta conteúdos dependentes da store view para os campos:

• nome do projeto,
• descrição breve do projeto.

Os campos globais, como o nome da empresa, logótipo, estado de atividade, ordenação, produtos relacionados e group_slug, são comuns a toda a entrada.

Diretório de media

Os logótipos são guardados no diretório:

pub/media/kowal/trustedus/

Antes da implementação, certifique-se de que o diretório pub/media é corretamente partilhado ou sincronizado entre ambientes, caso a loja funcione numa arquitetura multi-servidor.

Checklist de implementação

Antes da implementação:

• faça uma cópia de segurança da base de dados,
• faça uma cópia de segurança do código ou certifique-se de que a implementação pode ser recriada a partir do repositório,
• verifique o acesso ao repositório Composer,
• verifique o endereço de e-mail do cliente e o token de licença para o repositório Composer Kowal,
• planeie uma janela de implementação se a loja estiver em produção.

Após a implementação:

• execute setup:upgrade,
• limpe a cache,
• em modo de produção, execute a compilação DI e o deployment de static content,
• verifique se o módulo está ativo,
• adicione ou edite uma empresa de teste,
• defina group_slug,
• atribua um produto,
• adicione o widget numa página CMS de teste,
• clique no logótipo e verifique a página /trusted-us/{slug},
• verifique se a grelha de produtos apresenta os produtos atribuídos ao estudo de caso,
• verifique a ficha de produto com as entradas atribuídas.

Comandos de diagnóstico

Verificação do estado do módulo:

php bin/magento module:status Kowal_TrustedUs

Verificação da lista de módulos Kowal:

php bin/magento module:status | grep Kowal

Limpeza da cache:

php bin/magento cache:flush

Recompilação DI:

php bin/magento setup:di:compile

Problemas mais frequentes

O widget não liga à página de estudo de caso

Verifique se a entrada tem o campo preenchido:

Grupa case study / slug URL

Um elemento sem group_slug não é ligado à página interna.

A página /trusted-us/{slug} não funciona

Verifique:

• se existe uma entrada ativa com o respetivo group_slug,
• se foi executado setup:upgrade,
• se a cache foi limpa,
• se o módulo Kowal_TrustedUs está ativo.

Os produtos não aparecem na página de estudo de caso

Verifique:

• se os produtos estão atribuídos à entrada da empresa,
• se os produtos estão ativos,
• se os produtos estão visíveis no catálogo ou no motor de pesquisa,
• se os produtos estão disponíveis na store view atual.

As alterações não são visíveis após a implementação

Limpe a cache do Magento:

php bin/magento cache:flush

Em modo de produção, execute também:

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

Desinstalação

Desativação do módulo:

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

Remoção do pacote Composer:

composer remove kowal/module-trustedus

Antes de remover o módulo da produção, deve verificar se a loja não utiliza widgets, blocos CMS ou conteúdos dependentes do módulo.