Instalação
Ligue a sua loja Magento ao Fullmetrix passo a passo, da obtenção do código até à confirmação da ligação, com o que faz cada comando.
Esta página segue a ordem real da ligação. As partes marcadas para o seu programador podem ser reencaminhadas tal como estão. Reserve alguns minutos para a instalação no servidor e depois um tempo de importação que depende do volume da sua loja.
Tenha duas coisas prontas
O nome da pessoa que pode instalar um módulo no seu servidor Magento (programador, agência ou fornecedor de alojamento), e o acesso à administração do Magento com o menu Marketing. Verifique também a compatibilidade da sua loja.
Obtenha o seu código de ligação
O código de ligação liga a sua loja à sua organização no Fullmetrix. Tem este aspeto, FMTX-7K4M-Q2HD-9WXR. Funciona uma só vez. Assim que uma loja o aceita, não pode ser usado noutro sítio.
Durante o assistente de configuração
Crie a organização e defina o essencial
No ecrã Bem-vindo ao Fullmetrix, escreva um nome em Nome da loja e clique em Criar e continuar. No ecrã Definições básicas, escolha o seu Fuso horário e a sua Moeda e clique em Guardar e continuar, ou em Ignorar este passo para o fazer mais tarde em Geral.
Escolha o Magento
No ecrã Liga a sua loja, clique na linha Magento, identificada por Magento 2.4.4+ / Adobe Commerce. O Fullmetrix mostra A gerar código de ligação... durante um segundo.
Copie o comando e o código
O ecrã mostra duas caixas numeradas.
- Instalar a extensão contém o comando de instalação. O botão à direita copia-o e mostra Comando copiado.
- Liga a sua loja contém o seu código de ligação. Um clique copia-o e mostra Copiado.
Por baixo destas caixas, o painel À espera da ligação ao plugin pede-lhe que deixe a página aberta. Atualiza-se sozinho assim que a sua loja aceita o código.
Pode fechar a página e voltar mais tarde. Quando voltar a iniciar sessão no Fullmetrix, o assistente retoma no mesmo ponto com o mesmo código. A ligação Mudar de plataforma leva-o de volta à lista se escolheu a plataforma errada.
A partir das Definições
Se já concluiu o assistente, ou se está a adicionar uma loja, abra Definições e depois o separador Integrações. Na categoria Comércio eletrónico, clique em Ligar no cartão Loja de comércio eletrónico, ou no mosaico Adicionar uma loja se já houver uma loja ligada. Na janela Ligar uma plataforma, escolha Magento.
A janela mostra o Código de ligação com um botão de cópia, o comando de instalação, uma ligação Transferir plugin e uma ligação Enviar instruções ao meu programador.
Entregue a instalação ao seu programador
Envie as instruções por e-mail
Na janela Ligar uma plataforma, clique em Enviar instruções ao meu programador. Escreva o endereço dele em E-mail do programador e clique em Enviar instruções. A mensagem Instruções enviadas para seguida do endereço confirma o envio.
O seu programador recebe um e-mail com os comandos a executar, o seu código de ligação e o caminho para o menu Fullmetrix no Magento. Esta ligação não é oferecida no assistente de configuração. Durante o assistente, copie o comando e o código e envie-os por si.
O código é confidencial
Qualquer pessoa que tenha o seu código pode ligar-lhe uma loja. Envie-o apenas a quem instala o módulo e não o publique num pedido de suporte público nem numa captura de ecrã partilhada.
O que lhe pode dizer
O módulo é um pacote público do Composer chamado fullmetrix/magento-connector. Instala-se como qualquer módulo do Magento 2, com o processo de implementação habitual da loja. Acrescenta o menu Marketing e depois Fullmetrix à administração e precisa do cron do Magento.
Instale o módulo (para o seu programador)
Execute todos os comandos a partir da pasta raiz do projeto Magento, com o utilizador de sistema que costuma executar o Composer e o bin/magento. Tenha uma cópia de segurança recente e a sua janela de lançamento habitual.
composer require fullmetrix/magento-connector:^1.1
bin/magento module:enable Fullmetrix_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushEis o que faz cada linha.
| Comando | O que faz |
|---|---|
composer require fullmetrix/magento-connector:^1.1 | Transfere a última versão 1.x do módulo para o projeto e acrescenta-o a composer.json e composer.lock |
bin/magento module:enable Fullmetrix_Connector | Ativa o módulo no Magento |
bin/magento setup:upgrade | Regista o módulo e cria a sua tabela de fila na base de dados |
bin/magento setup:di:compile | Regenera o código compilado do Magento. Necessário quando a loja funciona em modo de produção. |
bin/magento cache:flush | Limpa a cache para que o menu Fullmetrix apareça na administração |
Não salte a compilação em modo de produção
Numa loja em modo de produção, esquecer o setup:di:compile depois de instalar ou atualizar o módulo causa erros, incluindo no checkout. Se o seu processo de implementação também implementa ficheiros estáticos, siga-o como habitualmente.
Para verificar se o módulo está ativado, o seu programador executa este comando.
bin/magento module:status Fullmetrix_ConnectorA resposta tem de indicar que o módulo está ativado.
Verifique o cron
O módulo envia as alterações ao Fullmetrix todos os minutos através do cron do Magento, num grupo de tarefas separado chamado fullmetrix. O cron do Magento tem por isso de estar instalado e a funcionar. Se o seu crontab só executa explicitamente alguns grupos de tarefas, acrescente este à lista.
bin/magento cron:run --group=fullmetrixInstale a partir do ficheiro zip
Se não for possível usar o Composer no servidor, a ligação Transferir plugin na janela Ligar uma plataforma fornece o módulo como ficheiro zip. Extraia o conteúdo para app/code/Fullmetrix/Connector e execute depois os mesmos comandos a partir de module:enable. As atualizações serão então manuais, substituindo essa pasta.
Cole o código no Magento
Esta parte faz-se na administração do Magento. Pode fazê-la por si depois de o módulo estar instalado.
Abra a página do Fullmetrix
No menu esquerdo da administração, clique em Marketing e depois em Fullmetrix. Se a entrada não aparecer, termine a sessão na administração e inicie-a de novo. Se continuar em falta, veja Resolução de problemas.

Escolha a vista da loja
A página resume os três passos da ligação. Na lista Store view, escolha a vista a ligar. Cada linha mostra o site e depois a vista, por exemplo Main Website / Default Store View. Só são oferecidas as vistas ativas.
A vista que escolher importa, porque só são importadas as encomendas feitas nessa vista. Define também o endereço, a moeda e o idioma da loja enviados ao Fullmetrix. Se tiver dúvidas, leia a secção sobre a vista da loja em Compatibilidade.
Cole o código e ligue
Cole o seu código em Connection code e clique em Connect. Maiúsculas ou minúsculas e espaços à volta do código não importam.

Leia a confirmação
O Magento mostra a mensagem de sucesso Store connected to Fullmetrix. The first sync starts automatically. A página mostra agora um selo Connected, o código em modo só de leitura, a linha Store view com o nome da vista e uma ligação Open the Fullmetrix dashboard.
Se aparecer em vez disso uma mensagem vermelha que começa por Échec de la connexion (falha da ligação), o motivo segue-se logo a seguir. Os motivos possíveis estão explicados em Resolução de problemas.

Ligue a partir da linha de comandos
O seu programador também pode fazer este passo no servidor. A opção --store-id indica o número da vista da loja. Sem ela, é usada a vista por defeito.
bin/magento fullmetrix:connect FMTX-XXXX-XXXX-XXXX --store-id=1Acompanhe a importação
Volte ao Fullmetrix. Durante o assistente, o painel passa a Plugin ligado e o ecrã avança sozinho para Preparar o seu espaço de trabalho. Uma barra de progresso acompanha a importação das suas encomendas, produtos, clientes e histórico de receitas. O botão Vai ao painel de controlo na mesma deixa-o entrar na aplicação sem esperar, enquanto a importação continua em segundo plano.
A partir das Definições, a janela fecha-se com a mensagem Importação iniciada e o cartão do Magento mostra Importação em curso com uma percentagem.
Do lado do Magento, a caixa Sync activity acompanha a mesma importação. Mostra Waiting for sync, depois Sync in progress e depois Sync complete com o número de itens importados por tipo.
Verifique se tudo funciona
- No Fullmetrix, abra Definições e depois Integrações. O cartão do Magento mostra o endereço da loja, um ponto verde e a linha Última sincronização.
- Faça uma encomenda de teste ou edite um produto e aguarde depois dois ou três minutos. A alteração aparece no Fullmetrix graças ao cron.
- Abra a sua loja, navegue por algumas páginas e verifique depois a receção de eventos em Script de rastreio.
Se os dados não circularem, comece pelo cron, como explicado em Resolução de problemas.
Atualize o módulo
Quando for lançada uma nova versão, o seu programador obtém-na com o Composer e volta a executar os mesmos passos de implementação.
composer update fullmetrix/magento-connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushA ligação é mantida durante uma atualização. Não há nenhum código a introduzir de novo.