fullmetrixDocs

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

  1. Abra diretamente o endereço /admin/fullmetrix da 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.
  2. Se o endereço devolver um erro 404, as rotas não estão importadas. O seu programador verifica o ficheiro config/routes/fullmetrix.yaml e executa depois bin/console debug:router fullmetrix_admin_connection, que tem de mostrar a rota.
  3. 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:status e 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 mostradoO que significaO que fazer
invalid_code_formatO código não tem o formato FMTX-XXXX-XXXX-XXXXCopie-o de novo a partir do Fullmetrix. Nunca contém as letras O e I nem os algarismos 0 e 1.
storage_failedO plugin não conseguiu guardar as suas definiçõesA migração provavelmente não foi executada. O seu programador executa bin/console doctrine:migrations:migrate.
Code de connexion introuvableEste código não existe no FullmetrixCopie de novo o código mostrado na sua organização, sem carateres a mais
Plateforme incorrecte pour ce codeO código foi criado para outra plataformaNo Fullmetrix, volte à escolha da plataforma, escolha Sylius, copie o código mostrado e tente de novo
Ce code est déjà associé à un autre siteUma loja já aceitou este códigoVeja a secção seguinte
Trop de tentatives, réessayez dans quelques minutes.Demasiadas tentativas num curto espaço de tempoAguarde 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 FullmetrixUse 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 redeO servidor não conseguiu contactar corretamente o FullmetrixO 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

  1. 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.
  2. Leia a caixa Recent activity. Uma linha sync_error contém a causa do erro. Anote-a antes de clicar em Clear logs.
  3. 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.
  4. 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.
  5. 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.

Nesta página