Venir de Magento 2

Le connecteur lit les tables que Magento a gardées stables sur toute la ligne 2.x, sur les deux schémas de base : Open Source, indexé sur les entity id, et Adobe Commerce avec content staging, indexé sur les row id.

Catégories

Chaque catégorie sous la racine de la boutique, en collection : nom, description, position et clé d'URL. La clé d'URL devient l'identifiant de la collection, et les produits conservent leurs rattachements.

Produits

Les produits simples, virtuels et téléchargeables arrivent en un produit à une déclinaison. Un produit configurable arrive en un produit avec une déclinaison par enfant, sur les mêmes axes d'options que ceux utilisés par les clients : une chemise en quatre couleurs et trois tailles est donc un produit avec Couleur et Taille, pas douze produits. Les lots arrivent à leur propre prix et sont signalés pour que vous reconstruisiez les options. Les produits groupés sont ignorés ; leurs membres arrivent de leur côté. Chaque produit apporte son nom, sa clé d'URL, sa description, son SKU, son prix et son prix spécial avec ses dates, sa quantité en stock, actif ou brouillon selon qu'il était activé, et jusqu'à douze images, copiées dans les médias de votre propre boutique pour que plus rien ne pointe vers l'ancien serveur.

Clients

Nom et e-mail, pour qu'une commande retrouve son client et que le client puisse se connecter. Les mots de passe ne peuvent pas être déplacés : chaque client en définit un nouveau avec le lien de réinitialisation à sa première connexion.

Commandes

L'historique des commandes comme archives : numéro, date, client, lignes rapprochées par SKU, totaux, code de réduction, et l'état Magento traduit en un statut, un statut de paiement et un statut de préparation. Rien n'est rejoué. Aucun paiement n'est pris, aucun stock ne bouge et aucun e-mail n'est envoyé, parce que l'argent a changé de mains il y a des années. Les anciens numéros de commande continuent de fonctionner.

Promotions

Les règles de prix panier avec leurs codes, et les règles de prix catalogue, traduites en règles qui continuent de fonctionner plutôt qu'en prix déjà appliqués. Une règle traduisible entièrement arrive telle quelle. Une règle qui a perdu un morceau en route arrive désactivée avec le motif joint, car toutes les façons dont une règle perd une condition la font s'appliquer à plus de cas, jamais à moins.

Pages et blocs CMS

Refaites-les dans l'éditeur, où ils deviennent des sections déplaçables et réutilisables.

Articles de blog, Magefan compris

Pas encore déplacés. Les articles arriveront dans le plugin Blog dans une version ultérieure du connecteur ; d'ici là on les recopie à la main.

Avis, listes d'envies, adresses, consentement newsletter

Le consentement en particulier n'est pas repris, parce qu'importer une case que vous ne pouvez pas prouver est un problème RGPD qui n'attend que d'arriver.

Surcharges par vue de magasin

C'est la portée par défaut qui est lue. Une deuxième langue ou une deuxième vue de magasin est une deuxième boutique, pas une deuxième colonne.

Jeux d'attributs, navigation à facettes, TVA, livraison et réglages de paiement

Se configurent dans le tableau de bord. Les tarifs de livraison, la TVA et vos propres clés de paiement prennent quelques minutes chacun et méritent d'être refaits à neuf.

Réécritures d'URL

La clé d'URL survit en identifiant, donc /wool-coat.html devient /wool-coat. Les redirections personnalisées ne suivent pas.

• Vous êtes administrateur de la boutique WhizzyCommerce qui reçoit le catalogue. Une boutique de démonstration convient ; passer en production plus tard conserve tout.
• Vous pouvez déposer un fichier sur le serveur Magento, en SFTP ou en SSH.
• Le serveur tourne en PHP 8, ce que fait déjà toute installation Magento 2.4.
• Les images produit sont accessibles en HTTPS à l'URL de base de la boutique. Elles sont récupérées là et copiées dans votre nouvelle boutique : une boutique éteinte ou derrière une page de maintenance arrive donc sans photos.
• Du temps. Compter est rapide ; un import réel tourne à quelques minutes par millier de produits, et les images en sont l'essentiel.

1. 1

   Créer une clé d'essai

   Dans le tableau de bord de votre boutique, ouvrez Réglages, Import et appuyez sur Créer une clé de migration, en laissant “Importer pour de vrai” décoché. La clé est affichée une seule fois, vaut 24 heures, ouvre exactement cette boutique, et est consommée quand une passe se termine. Chaque passe, à blanc ou réelle, commence par une clé neuve.

2. 2

   Déposer le connecteur sur votre serveur Magento

   Téléchargez import.php depuis le même écran, ou depuis whizzycommerce.com/connector/magento2, et envoyez-le dans pub/whizzy/import.php. Il trouve app/etc/env.php en remontant depuis l'endroit où il se trouve, gardez-le donc sous pub/. C'est un seul fichier lisible et sans dépendances ; lisez-le avant de l'exécuter, c'est tout l'intérêt qu'il n'y en ait qu'un.

   Ou, en SSH depuis la racine Magento, une seule commande le place au bon endroit :

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

3. 3

   Lancer l'essai à blanc

   Soit dans un navigateur :

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

   soit en SSH depuis la racine Magento :

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

   La sortie défile au fur et à mesure, une ligne par lot. Sur nginx, la voie navigateur répond en général 403 : le nginx.conf.sample de Magento ne passe à PHP que index.php, get.php, static.php et le health check, et refuse tout autre fichier .php. C'est le comportement correct, utilisez donc SSH là. SSH est aussi le meilleur choix au-delà de quelques milliers de produits, parce que la ligne de commande n'a pas de limite de temps d'exécution, contrairement à un onglet.

4. 4

   Lire le rapport

   La passe se termine par un tableau par entité : vus, importés, ignorés, échoués, suivi des premiers problèmes. Un essai à blanc rapporte ce qui se passerait : “importés” y signifie donc “serait importé”.

   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

   Les produits en échec sont les suspects habituels : pas de prix, pas de nom, ou deux produits dont les clés d'URL se normalisent vers le même identifiant. Corrigez-les dans Magento si cela compte, puis créez une autre clé d'essai et relancez jusqu'à ce que les chiffres soient les bons.

5. 5

   Le lancer pour de vrai

   De retour dans Réglages, Import, cochez “Importer pour de vrai” et créez une clé neuve. Lancez la même commande avec. Le tableau de bord liste la passe sous Imports à ce jour et se met à jour à mesure que les lots arrivent ; rechargez pour suivre. Les catégories d'abord, puis les produits, les clients, les commandes et enfin les promotions, puisque chaque passe s'appuie sur les précédentes par identifiant, SKU ou e-mail.

6. 6

   Vérifier la boutique

   • Les produits et les collections, avec déclinaisons, images et stock en place.
   • Les promotions. Toute règle arrivée désactivée porte son motif ; réactivez-la une fois que vous avez lu ce qu'elle a perdu.
   • Les clients, qui définiront un nouveau mot de passe à leur première connexion.
   • Les commandes, en historique : rien à préparer, rien à rembourser, rien à envoyer.
7. 7

   Supprimer le fichier

   rm pub/whizzy/import.php

   Il refuse de tourner sans clé valide et la clé est déjà brûlée, mais un fichier capable de lire votre table clients n'a rien à faire dans un répertoire public.

8. 8

   Puis ouvrir

   Choisissez un thème, ajoutez vos propres clés de paiement, réglez la livraison et la TVA, et pointez votre domaine vers la nouvelle boutique. Rien de ce que vous avez importé ne change à ce moment-là.

Une deuxième passe réelle ignore tout ce qui est déjà là : un produit au même identifiant, un client au même e-mail, une commande au même numéro. Ignoré veut dire laissé tel quel, pas mis à jour. Pour rafraîchir quelque chose qui a changé dans Magento depuis la première passe, retirez-le d'abord de la nouvelle boutique, puis relancez.

Toutes les autres plateformes passent par des tableurs : exportez produits, clients et commandes en CSV, associez les colonnes, essayez à blanc, importez. Les détails sont sur la page des tarifs.