Resolução de problemas
Resolva problemas do plugin Sylius, desde uma instalação falhada até uma importação que não termina.
Comece sempre por verificações que não alteram nada. Não clique em Disconnect no Sylius, nem em Desligar no Fullmetrix, para "recomeçar do zero". No Sylius, desligar corta a ligação e o código não pode ser reutilizado. No Fullmetrix, elimina os dados importados.
Várias verificações desta página dizem respeito ao código do projeto. Passe-as ao seu programador, com a hora e a mensagem exata do problema.
O Composer recusa instalar o plugin
O seu programador executa este comando para descobrir o que o bloqueia.
composer why-not fullmetrix/sylius-plugin '*'As causas habituais são uma versão do PHP inferior à 8.1, uma extensão cURL ou JSON em falta, ou uma versão do Sylius, do Symfony ou do Doctrine fora da lista em Compatibilidade. Resolve as dependências na sua máquina e implementa depois o ficheiro composer.lock resultante. Copiar a pasta vendor/ de uma máquina para outra é má ideia se as versões do PHP forem diferentes.
O Symfony não carrega o plugin
Se bin/console cache:clear falhar ou não existir nenhuma rota Fullmetrix, verifique se config/bundles.php contém esta linha.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],O seu programador executa então composer dump-autoload e limpa a cache com o mesmo ambiente do site em produção. Com vários servidores, verifica cada um deles.
A página Fullmetrix não aparece na administração
- Abra diretamente o endereço
/admin/fullmetrixda sua loja com uma conta de administrador. Se a página aparecer, só falta o menu, muitas vezes por causa de um menu de administração ou de um tema personalizados. - Se o endereço devolver um erro 404, as rotas não estão importadas. O seu programador verifica o ficheiro
config/routes/fullmetrix.yamle executa depoisbin/console debug:router fullmetrix_admin_connection, que tem de mostrar a rota. - Limpa a cache e a página é recarregada.
A migração falha
- Faça uma cópia de segurança da base de dados antes de tentar de novo.
- O seu programador verifica
bin/console doctrine:migrations:statuse o primeiro erro mostrado. - Verifica se o utilizador da base de dados tem autorização para criar tabelas.
- Não cria as tabelas à mão nem marca a migração como executada sem perceber o erro.
Mensagens de erro de ligação
Quando a ligação falha, a página mostra Connection failed seguido de um motivo. Alguns motivos voltam em francês. São citados abaixo tal como aparecem.
| Motivo mostrado | O que significa | O que fazer |
|---|---|---|
invalid_code_format | O código não tem o formato FMTX-XXXX-XXXX-XXXX | Copie-o de novo a partir do Fullmetrix. Nunca contém as letras O e I nem os algarismos 0 e 1. |
storage_failed | O plugin não conseguiu guardar as suas definições | A migração provavelmente não foi executada. O seu programador executa bin/console doctrine:migrations:migrate. |
| Code de connexion introuvable | Este código não existe no Fullmetrix | Copie de novo o código mostrado na sua organização, sem carateres a mais |
| Plateforme incorrecte pour ce code | O código foi criado para outra plataforma | No Fullmetrix, volte à escolha da plataforma, escolha Sylius, copie o código mostrado e tente de novo |
| Ce code est déjà associé à un autre site | Uma loja já aceitou este código | Veja a secção seguinte |
| Trop de tentatives, réessayez dans quelques minutes. | Demasiadas tentativas num curto espaço de tempo | Aguarde dez minutos antes de tentar de novo |
| Cette boutique est déjà connectée à une autre Organization. | A loja já pertence a outra organização do Fullmetrix | Use essa organização, ou remova primeiro a loja dela |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | O período de teste gratuito já foi usado para esta loja | É necessária uma subscrição, veja Faturação |
invalid_response, register_failed ou uma mensagem de rede | O servidor não conseguiu contactar corretamente o Fullmetrix | O seu programador verifica se o PHP consegue abrir ligações HTTPS de saída para fullmetrix.com (firewall, proxy, DNS, certificados) |
Não partilhe um código ativo
O código é um segredo. Se enviar uma captura de ecrã da página Fullmetrix no Sylius, oculte totalmente o campo Connection code.
O código está "already associated with another site"
Um código só funciona uma vez. Esta mensagem, Ce code est déjà associé à un autre site, aparece quando tenta de novo com um código que já foi aceite, por exemplo depois de clicar em Disconnect no Sylius, ou se outra instalação (um site de teste, por exemplo) o usou primeiro.
Se o cartão da loja no Fullmetrix ainda funciona, não há nada a fazer. Se desligou a loja no Sylius e quer voltar a ligá-la, precisa de um novo código. Abra Definições e depois Integrações, clique em Desligar no cartão do Sylius, confirme e adicione depois a loja de novo para obter um código novo. Isto apaga os dados importados no Fullmetrix, que são depois importados de novo a partir da sua loja.
Ligado, mas a importação não termina
- No Sylius, abra Marketing e depois Fullmetrix e veja a caixa Sync activity. Anote se mostra Waiting for sync, Sync in progress ou Sync complete.
- Leia a caixa Recent activity. Uma linha
sync_errorcontém a causa do erro. Anote-a antes de clicar em Clear logs. - No Fullmetrix, leia o cartão do Sylius em Definições e depois Integrações. A mensagem A última sincronização não conseguiu aceder à sua loja significa que o Fullmetrix não conseguiu chamar o seu site.
- O seu programador verifica se os endereços
/fullmetrix/api/passam pelo proxy, pela cache e pela firewall. Se usa o Cloudflare, siga Cloudflare e firewalls. - Consulta os registos do PHP e do servidor web à hora do problema e verifica se todos os servidores executam a mesma versão do plugin.
Depois de um erro, o botão Sincronizar dá lugar a Retomar e Repor. Depois de corrigida a causa, clique em Retomar para continuar de onde a importação parou. Se Retomar não for proposto, clique em Repor, que volta a pôr o progresso a zero e reinicia a sincronização sem eliminar as encomendas já importadas. Os outros estados do cartão estão descritos em Estado da sincronização.
O endereço da loja está errado no Fullmetrix
O cartão mostra o endereço que o plugin enviou quando ligou. Se for um endereço interno, um endereço HTTP ou outro domínio, a administração foi aberta com esse endereço, ou o Symfony não confia no proxy que está à frente do site. O seu programador corrige a configuração do proxy. Para registar o endereço certo, é preciso depois voltar a ligar a loja com um novo código, como explicado acima.
O rastreio de visitantes não recebe nada
- Verifique se a página Fullmetrix no Sylius continua a mostrar Connected.
- Teste numa página pública da loja, e não na administração.
- Limpe qualquer cache de páginas que esteja à frente do site.
- Faça o seu teste depois de aceitar os cookies, se existir um banner de consentimento.
- Verifique a receção em Script de rastreio.
Contactar o suporte
Se o problema persistir, contacte-nos com o seguinte.
- O endereço público da loja e o nome da sua organização no Fullmetrix.
- As versões do Sylius, do plugin, do PHP, do Symfony e do Doctrine.
- A mensagem exata, a hora a que apareceu e o fuso horário.
- O resultado de
bin/console debug:router fullmetrix_admin_connection. - Uma captura de ecrã das caixas Sync activity e Recent activity, com o código oculto.
Nunca envie uma palavra-passe, um código de ligação nem um extrato da sua base de dados de produção.