Resolução de problemas

Registe o erro exato, a hora e o fuso horário, as versões do plugin, Sylius e PHP e o commit da implementação antes de alterar a instalação.

O Composer não consegue instalar o pluginCopy Anchor Link

1. Execute composer why-not fullmetrix/sylius-plugin '*' para identificar a dependência em conflito.
2. Confirme que utiliza PHP 8.1 ou posterior e as extensões cURL e JSON.
3. Confirme que o projeto usa versões compatíveis do Sylius, Symfony e Doctrine.
4. Verifique se o Composer consegue autenticar-se no repositório que disponibiliza o pacote Fullmetrix.
5. Altere primeiro a dependência num ambiente de desenvolvimento e implemente depois o ficheiro de bloqueio resultante.

O Symfony não consegue carregar FullmetrixPluginCopy Anchor Link

• Confirme esta entrada em config/bundles.php:

Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],

• Execute composer dump-autoload depois de confirmar que o pacote existe em vendor/fullmetrix/sylius-plugin.
• Limpe a cache com o mesmo APP_ENV utilizado pela aplicação Web.
• Em vários nós, verifique o pacote e a configuração em cada nó.

O Fullmetrix não aparece no menuCopy Anchor Link

1. Confirme a entrada do bundle e a importação de rotas indicadas no guia de instalação.
2. Execute bin/console debug:router fullmetrix_admin_connection.
3. Limpe a cache da aplicação.
4. Abra diretamente /admin/fullmetrix com uma sessão de administrador Sylius iniciada.
5. Se a rota direta funcionar, inspecione listeners personalizados do menu administrativo ou temas que substituam o menu Sylius.

A migração falhaCopy Anchor Link

• Faça uma nova cópia de segurança antes de tentar novamente.
• Execute bin/console doctrine:migrations:status e analise o primeiro erro da base de dados.
• Confirme que o utilizador da base de dados de implementação pode criar e alterar tabelas.
• Não crie manualmente as tabelas do plugin sem uma análise da incompatibilidade do esquema pelo suporte Fullmetrix.
• Não marque uma migração falhada como executada apenas para desbloquear a implementação.

O código de ligação é rejeitadoCopy Anchor Link

• Gere o código na organização e plataforma Fullmetrix pretendidas.
• Copie o valor FMTX-… completo, sem espaços ou pontuação.
• Não reutilize um código criado para outro CMS ou outra organização.
• Confirme que o URL público da loja está correto e acessível através de HTTPS.
• Verifique HTTPS de saída, DNS, proxy e certificados CA no ambiente PHP.
• Volte ao Fullmetrix e crie uma nova ligação pendente apenas depois de confirmar que a tentativa anterior não foi aceite.

Ligado, mas a importação não terminaCopy Anchor Link

1. Mantenha a página de ligação do Fullmetrix aberta até esta detetar o plugin.
2. Em Marketing > Fullmetrix, verifique se o estado é Waiting for sync, Sync in progress ou Sync complete.
3. Consulte Recent activity para encontrar sync_error; não limpe o registo antes de guardar a mensagem.
4. Confirme que o Fullmetrix consegue aceder às rotas públicas /fullmetrix/api/* através de qualquer proxy ou WAF.
5. Consulte os registos do PHP e do servidor Web no mesmo instante.
6. Confirme que todos os nós da aplicação partilham a base de dados e executam a mesma versão do plugin.

O acompanhamento da loja está ausenteCopy Anchor Link

• Confirme que o plugin continua a apresentar Connected.
• Abra uma página pública da loja, não uma rota administrativa ou da API.
• Verifique o código-fonte da página e o registo de rede do navegador para encontrar o monitor Fullmetrix.
• Analise o gestor de consentimento, a Política de Segurança de Conteúdos, o proxy, a cache e as personalizações do tema.
• Limpe as caches da loja após uma implementação sem eliminar a atividade Fullmetrix antes de registar o problema.

Informações a enviar ao suporteCopy Anchor Link

Envie os seguintes elementos sem palavras-passe, códigos ou segredos de ligação, dados de clientes ou conteúdo da base de dados de produção:

• URL público da loja e ID ou slug da organização Fullmetrix
• Versões do Sylius, plugin Fullmetrix, PHP, Symfony e Doctrine
• Erro exato, data e hora, fuso horário e commit da implementação
• Saída de debug:router fullmetrix_admin_connection
• Estado atual e mensagem ocultada da atividade recente
• Código de estado relevante do proxy ou servidor Web

Antes de remover a integração, leia Desligar e desinstalar.