Migratie van Shopify naar PrestaShop: volledige gids

Overzicht

dfmigrateshopify importeert een volledige Shopify-winkel in PrestaShop 8 of 9: producten met varianten en afbeeldingen, klanten met adressen, historische bestellingen, collecties die categorieën worden, 301-omleidingen en klantreviews. De module werkt aan Shopify-zijde alleen-lezen: er wordt niets weggeschreven en niets aan de bronwinkel gewijzigd.

Installatie

1. PrestaShop-backoffice → Modules → Modulebeheer → Een module uploaden.
2. Kies het bestand dfmigrateshopify.zip en installeer het.
3. Er verschijnt een nieuw scherm onder Geavanceerde parameters → Shopify-migratie.

De installatie maakt 4 tabellen aan met het voorvoegsel dfmigshop_: mapping (de koppelingen tussen Shopify en PrestaShop), log, redirect en job.

Het Shopify-token aanmaken

In het beheer van uw Shopify-bronwinkel:

1. Settings → Apps and sales channels → Develop apps → Create an app.
2. Tabblad Configuration → Admin API integration → Configure.
3. Vink de scopes aan: read_products, read_inventory, read_product_listings, read_customers, read_orders en read_content.
4. Installeer de app in de winkel en kopieer het Admin API access token (dat met shpat_ begint).

Verbinding

In het tabblad Verbinding van de module vult u het domein in (mijn-winkel.myshopify.com, zonder https://), het token, en de API-versie (standaard 2024-10). Klik op De verbinding testen: de naam van de winkel hoort in het groen te verschijnen.

Configuratie

• Batchgrootte: het aantal items dat per AJAX-aanroep wordt verwerkt (standaard 50, maximaal 250). Verlaag die als uw hosting traag is.
• De afbeeldingen downloaden: zet dat uit voor een snelle testmigratie zonder afbeeldingen.
• Concepten: de Shopify-producten met de status draft wel of niet importeren.
• Standaard bovenliggende categorie: de Shopify-collecties komen onder die categorie te staan.
• Vervoerder en betaalmodule: die worden aan de geïmporteerde bestellingen toegekend.
• Statuskoppeling: koppel elke Shopify-status (pending, paid, fulfilled, delivered, cancelled, refunded) aan een besteltoestand van PrestaShop.

De migratie starten

Volg in het tabblad Migratie deze volgorde:

1. Tellen: controleert de verbinding en toont de aantallen.
2. Custom collecties en daarna Smart collecties: maakt de categorieën aan.
3. Producten met varianten en afbeeldingen: de langste stap. De Shopify-varianten worden attribuutcombinaties, elke variant krijgt haar afbeelding, en de merken worden uit het veld vendor aangemaakt.
4. Klanten: met automatische ontdubbeling op e-mailadres. Er wordt een willekeurig wachtwoord toegekend: vraag uw klanten « Wachtwoord vergeten » te gebruiken.
5. Bestellingen: pas na de producten en de klanten. De referentie krijgt de vorm SH-{nummer}.
6. 301-omleidingen: haalt de URL Redirects van Shopify op. De omleidingen voor producten en collecties zijn in de vorige stappen al automatisch aangemaakt.

De reviews importeren

Shopify heeft geen native API voor reviews. Exporteer een CSV uit uw toepassing (Judge.me, Loox, Yotpo, de Product Reviews app en dergelijke) en importeer dat bestand in het tabblad Reviews. De module herkent uw backend automatisch: dfreviews (dat voorgaat) of productcomments.

Verwachte kolommen (hoofdletterongevoelig, met , of ; als scheidingsteken): product_handle of shopify_product_id of sku, email, reviewer_name, rating, title, body, created_at en verified.

301-omleidingen

Elk verzoek aan de frontzijde loopt langs de hook actionDispatcherBefore: komt de gevraagde URL overeen met een geregistreerde bron (bijvoorbeeld /products/mijn-product), dan gaat de bezoeker met een 301 naar de overeenkomstige PrestaShop-URL. Er is geen enkele Apache- of Nginx-configuratie nodig. In het tabblad 301-omleidingen exporteert u de volledige lijst als CSV.

Koppelingen en opnieuw starten

Het tabblad Koppelingen toont per soort bron hoeveel items er zijn geïmporteerd. De knop Legen wist de koppelingen van één soort: de items blijven in PrestaShop staan, maar een nieuwe migratie importeert ze als nieuw (met mogelijke dubbels, dus gebruik die knop bewust).

Problemen oplossen

• Fout 429 of 503: de module vangt de rate limit van Shopify zelf op (met een nieuwe poging die de header Retry-After respecteert). U hoeft niets te doen.
• Trage migratie: verlaag de batchgrootte, of zet het downloaden van de afbeeldingen uit voor een eerste testronde.
• Fouten in het logboek: het tabblad Logboeken toont elke fout met de betrokken bron en de Shopify-identificatie. Los de oorzaak op en start de stap opnieuw: alleen de mislukte items worden opnieuw verwerkt.
• Prijzen van de historische bestellingen: de bestellingen komen binnen als boekhoudkundig archief; de totalen van Shopify blijven behouden zoals zij zijn, zonder herberekening van de PrestaShop-belastingen.

Verwijderen

Bij het verwijderen verdwijnen de 4 tabellen van de module en de hooks. De geïmporteerde producten, klanten, bestellingen en categorieën blijven staan. De 301-omleidingen werken niet meer, want die worden door de module uitgeleverd.