Vir do Magento 2

O conector lê as tabelas que o Magento manteve estáveis em toda a linha 2.x, nos dois esquemas de base de dados: Open Source, indexado por entity id, e Adobe Commerce com content staging, indexado por row id.

Categorias

Todas as categorias abaixo da raiz da loja, como coleções: nome, descrição, posição e chave de URL. A chave de URL passa a ser o identificador da coleção, e os produtos mantêm as ligações às categorias.

Produtos

Produtos simples, virtuais e descarregáveis chegam como um produto com uma variante. Um produto configurável chega como um produto com uma variante por filho, nos mesmos eixos de opção que os compradores usavam, por isso uma camisa em quatro cores e três tamanhos é um produto com Cor e Tamanho, não doze produtos. Os pacotes chegam ao preço próprio e ficam assinalados para reconstruir as opções. Os produtos agrupados são ignorados; os membros vêm por si. Cada produto traz nome, chave de URL, descrição, SKU, preço e preço especial com as datas, quantidade em stock, ativo ou rascunho conforme estivesse ligado ou desligado, e até doze imagens, copiadas para a média da sua própria loja para que nada aponte para o servidor antigo.

Clientes

Nome e e-mail, para que uma encomenda encontre o seu cliente e o cliente possa entrar. As palavras-passe não podem ser movidas, por isso cada cliente define uma nova com o link de reposição na primeira vez que entrar.

Encomendas

O histórico de encomendas como registos: número, data, cliente, linhas associadas por SKU, totais, código de desconto, e o estado da encomenda no Magento traduzido num estado, num estado de pagamento e num estado de expedição. Nada é reexecutado. Não se cobra nada, não se mexe em stock e não se envia nenhum e-mail, porque o dinheiro mudou de mãos há anos. Os números de encomenda antigos continuam a funcionar.

Promoções

Regras de preço de carrinho com os seus códigos, e regras de preço de catálogo, traduzidas em regras que continuam a funcionar em vez de preços já aplicados. Uma regra que pôde ser traduzida por inteiro chega como estava. Uma regra que perdeu uma peça na travessia chega desligada e com o motivo anexado, porque todas as formas de uma regra perder uma condição a fazem aplicar-se a mais, nunca a menos.

Páginas e blocos de CMS

Reconstrua-os no editor, onde passam a ser secções que pode mover e reutilizar.

Artigos de blogue, incluindo Magefan

Ainda não são movidos. Os artigos vão chegar ao plugin Blog numa versão posterior do conector; até lá copiam-se à mão.

Avaliações, listas de desejos, moradas, consentimento de newsletter

O consentimento em particular não é transportado, porque importar uma marcação que não se consegue provar é um problema de RGPD à espera de acontecer.

Sobreposições por store view

É lido o âmbito predefinido. Uma segunda língua ou uma segunda store view é uma segunda loja, não uma segunda coluna.

Conjuntos de atributos, navegação por camadas, impostos, envios e definições de pagamento

Configuram-se no painel. Portes, impostos e as suas próprias chaves de pagamento levam poucos minutos cada e vale a pena fazer de novo.

Reescritas de URL

A chave de URL sobrevive como identificador, por isso /wool-coat.html passa a /wool-coat. Os redirecionamentos personalizados não passam.

• É administrador da loja WhizzyCommerce para onde o catálogo vai. Uma loja de demonstração serve; passar a real mais tarde mantém tudo.
• Consegue pôr um ficheiro no servidor Magento, por SFTP ou SSH.
• O servidor corre PHP 8, o que qualquer instalação Magento 2.4 já faz.
• As imagens dos produtos estão acessíveis por HTTPS no URL base da loja. São buscadas aí e copiadas para a sua nova loja, por isso uma loja desligada ou atrás de uma página de manutenção chega sem fotografias.
• Tempo. Contar é rápido; uma importação a sério anda a poucos minutos por mil produtos, e as imagens são a maior parte disso.

1. 1

   Criar uma chave de ensaio

   No painel da sua loja abra Definições, Importar e carregue em Criar uma chave de migração, deixando “Importar a sério” por marcar. A chave é mostrada uma vez, funciona 24 horas, abre exatamente esta loja, e gasta-se quando uma passagem termina. Todas as passagens, de ensaio ou a sério, começam com uma chave nova.

2. 2

   Pôr o conector no seu servidor Magento

   Descarregue import.php do mesmo ecrã, ou de whizzycommerce.com/connector/magento2, e envie-o para pub/whizzy/import.php. Ele encontra app/etc/env.php subindo a partir de onde está, por isso mantenha-o debaixo de pub/. É um ficheiro legível sem dependências; leia-o antes de o correr, é essa a razão de ser um único ficheiro.

   Ou, por SSH a partir da raiz do Magento, um único comando descarrega-o para o sítio certo:

   mkdir -p pub/whizzy && curl -fsSL https://whizzycommerce.com/connector/magento2 -o pub/whizzy/import.php

3. 3

   Correr o ensaio

   Ou num navegador:

   https://your-shop.com/whizzy/import.php?k=wz_YOUR_KEY

   ou por SSH a partir da raiz do Magento:

   php pub/whizzy/import.php --key=wz_YOUR_KEY

   A saída vai aparecendo, uma linha por lote. Em nginx a via do navegador costuma responder 403: o próprio nginx.conf.sample do Magento só passa index.php, get.php, static.php e o health check ao PHP e nega todos os outros ficheiros .php. É o comportamento correto, por isso aí use SSH. SSH é também a melhor escolha para qualquer coisa acima de alguns milhares de produtos, porque a linha de comandos não tem limite de tempo de execução e um separador do navegador tem.

4. 4

   Ler o relatório

   A passagem termina com uma tabela por entidade: vistos, importados, ignorados, falhados, seguida dos primeiros problemas. Um ensaio relata o que aconteceria, por isso “importados” aqui quer dizer “importaria”.

   products     seen 1240    imported 1231    skipped 0       failed 9
   categories   seen 38      imported 38      skipped 0       failed 0
   customers    seen 4102    imported 4102    skipped 0       failed 0
   orders       seen 9870    imported 9870    skipped 0       failed 0
   promotions   seen 14      imported 14      skipped 0       failed 0
   
   Problems (first 9):
     product    SKU-2231     no variant with a usable price
     product    SKU-0410     missing title

   Os produtos falhados são os suspeitos do costume: sem preço, sem nome, ou dois produtos cujas chaves de URL normalizam para o mesmo identificador. Corrija-os no Magento se importarem, depois crie outra chave de ensaio e corra outra vez até os números serem os que quer.

5. 5

   Correr a sério

   De volta a Definições, Importar, marque “Importar a sério” e crie uma chave nova. Corra o mesmo comando com ela. O painel lista a passagem em Importações até agora e vai atualizando à medida que os lotes chegam; recarregue para ver o progresso. Primeiro as categorias, depois produtos, clientes, encomendas e por fim promoções, já que cada passagem seguinte se refere às anteriores por identificador, SKU ou e-mail.

6. 6

   Verificar a loja

   • Produtos e coleções, com variantes, imagens e stock no sítio.
   • Promoções. Qualquer regra que tenha chegado desligada traz o motivo; ligue-a depois de ler o que perdeu.
   • Clientes, que vão definir uma palavra-passe nova na primeira vez que entrarem.
   • Encomendas, como histórico: nada para expedir, nada para reembolsar, nada para enviar por e-mail.
7. 7

   Apagar o ficheiro

   rm pub/whizzy/import.php

   Recusa correr sem uma chave válida e a chave já está gasta, mas um ficheiro que consegue ler a sua tabela de clientes não tem nada que ficar numa pasta pública.

8. 8

   Depois abrir

   Escolha um tema, ponha as suas chaves de pagamento, defina portes e impostos, e aponte o seu domínio para a nova loja. Nada do que importou muda quando o fizer.

Uma segunda passagem a sério ignora tudo o que já lá está: um produto com o mesmo identificador, um cliente com o mesmo e-mail, uma encomenda com o mesmo número. Ignorado quer dizer deixado em paz, não atualizado. Para atualizar algo que mudou no Magento desde a primeira passagem, retire-o primeiro da nova loja e corra outra vez.

Todas as outras plataformas passam por ficheiros de folha de cálculo: exportar produtos, clientes e encomendas em CSV, mapear as colunas, ensaiar, importar. Os pormenores estão na página de preços.