diff --git a/src/documentation/10.woocommerce-v6.0.md b/src/documentation/10.woocommerce-v6.0.md new file mode 100644 index 00000000..8682ee7b --- /dev/null +++ b/src/documentation/10.woocommerce-v6.0.md @@ -0,0 +1,131 @@ +--- +title: WooCommerce Version 6 +languages: + - nl: documentatie/10.woocommerce-v6.0.html +--- + + + + + + + +## Introduction + +Version 6 of the MyParcel plugin for WooCommerce has been rebuilt from the ground up. In September 2026, v6 replaces the current version 4 in the WordPress plugin store, and everyone switches through the regular plugin update. Want to stay ahead of any issues? Install v6 manually now, that way we at MyParcel can really take the time to help you if you run into anything. + +On this page you'll read what changes compared to version 4, and you'll walk through the migration step by step. + +::: note +Because v6 is a complete rebuild, the settings have been reorganized as well. The plugin migrates your v4 settings automatically where possible, but go through all settings after installation to check that everything is set up correctly and works as expected. +::: + +## What's different in v6? + +The plugin has been rewritten from scratch on the MyParcel platform (PDK). You'll notice it everywhere: a new settings page, support for the latest WooCommerce technology, and carrier capabilities that come straight from the MyParcel API. Version 4 only receives maintenance, all new functionality lands in v6. + +| | Version 4 | Version 6 | +| --------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | +| **Foundation** | Own codebase from 2020 | Fully rewritten on the MyParcel PDK platform | +| **Settings** | Spread across multiple screens | 1 new settings page, organized per carrier | +| **Carriers and shipment options** | Built in, plugin update required for every change | Capabilities come from the MyParcel API, existing options are unlocked automatically, new carriers and options arrive with plugin updates | +| **Checkout** | Classic checkout only | Classic checkout and the new WooCommerce blocks checkout | +| **Order storage (HPOS)** | Limited | Full support for High-Performance Order Storage | +| **Order grid** | Can slow down with many orders | Faster, without separate database queries per order | +| **Product settings** | Limited per-product configuration | Extensive shipping settings per product | +| **New functionality** | Bug fixes only | All new development | + +## When do you switch? + +- **Now (recommended)**, install v6 manually using the step-by-step guide below. You pick the moment, test at your own pace, and our support team has all the time for you. +- **September 2026**, v6 lands in the WordPress plugin store and replaces version 4. Everyone then switches through the regular plugin update. + +## Step-by-step: from v4 to v6 + +### Step 1: Make a backup + +Make a full backup of your website and database before you start. If anything goes wrong, you can restore everything in one go. + +### Step 2: Test on a staging environment first + +Run the migration on a test or staging environment first, not directly on your live shop. That way you see exactly what the new settings look like, and you test the entire order flow without any risk to your customers. No staging environment? Most hosting providers offer one, ask your host or developer. + +### Step 3: Download the latest v6 release + +1. Go to the [releases page on GitHub]. +2. Pick the latest v6 version (at the top of the list). +3. Under _Assets_, download the plugin's zip file. + +### Step 4: Install the plugin manually + +1. In WordPress, go to `Plugins > Add New Plugin > Upload Plugin`. +2. Select the downloaded zip file and click **Install Now**. +3. WordPress recognizes that the MyParcel plugin is already installed and asks whether you want to replace the current version. Choose **Replace current with uploaded**. +4. After installation, click **Activate Plugin**. + +The plugin migrates your existing settings, orders and labels automatically. Your API key stays connected, your order history and created shipments remain in place. + +::: note +Using the Belgian SendMyParcel plugin? The upgrade to v6 involves a plugin rename, so the steps above don't apply 1-on-1. Contact our support before migrating, we'll guide you through the switch. +::: + +### Step 5: Go through all your settings + +Open `WooCommerce > MyParcel` and check every part of the new settings page. Pay attention to at least: + +- **Connection**, is the plugin connected to your MyParcel account? +- **General**, order statuses, automatic export and label format +- **Carriers**, are all your carriers enabled, with the right shipment options (signature, insurance, age check)? +- **Checkout**, delivery options, pickup locations and the costs per delivery option +- **Product settings**, per-product overrides (for example mailbox parcel or country of origin) +- **Emails**, Track & Trace link in the order confirmation + +### Step 6: Test the complete order flow + +1. Place a test order in your checkout and check that the delivery options show up correctly. +2. Export the order to MyParcel and print the label. +3. Check that the Track & Trace link appears in the email to your customer. +4. Using the WooCommerce blocks checkout? Test that separately as well. + +::: note +Whether test labels incur costs differs per carrier. For most carriers nothing is charged as long as the label isn't scanned, but digital stamps, for example, are charged immediately. +::: + +### Step 7: Repeat the steps on your live shop + +Everything working on your staging environment? Then run steps 1 and 3 through 6 on your production environment. Plan the switch at a quiet moment, and go through the settings and a test order there too. + +## Something not working? + +- **Back to v4**, restore your backup, or reinstall the latest v4 release from the [releases page on GitHub]. Your shipments remain available in your [Backoffice]. +- **Need help?**, contact our support team by phone, chat or WhatsApp. Especially during this period, we take the time for your migration. + +## Frequently asked questions + +### Do I have to switch now? + +You don't have to, but you can. In September 2026, v6 lands in the WordPress plugin store and everyone switches through the regular update. Switch manually now and you pick the moment yourself, test at your own pace, and our support team can help you 1-on-1 if needed. + +### Do my orders and labels remain? + +Yes. Your order history, created shipments and labels stay in place. The plugin migrates your data and settings automatically during the update. + +### Do I need to enter my API key again? + +No, your connection to MyParcel remains. After installation, do check that the plugin is still connected to your MyParcel account. + +### Why do you recommend a staging environment? + +Version 6 has been completely rewritten, with a new layout for all settings. On a staging environment you see exactly what changes, and you test the checkout, export and emails without your customers noticing anything. + +### Can I stay on v4? + +Version 4 only receives maintenance and security updates. New carriers, shipment options and functionality only come to v6. And from September 2026, v6 is the version in the WordPress plugin store. + +## Contribute to the plugin + +See [CONTRIBUTING.md]. + +[Backoffice]: https://backoffice.myparcel.nl/ +[CONTRIBUTING.md]: https://github.com/myparcelnl/woocommerce/blob/main/CONTRIBUTING.md +[releases page on GitHub]: https://github.com/myparcelnl/woocommerce/releases diff --git a/src/nl/documentatie/10.woocommerce-v5.0.md b/src/nl/documentatie/10.woocommerce-v5.0.md index 1fad9861..b7d39634 100644 --- a/src/nl/documentatie/10.woocommerce-v5.0.md +++ b/src/nl/documentatie/10.woocommerce-v5.0.md @@ -3,7 +3,7 @@ title: WooCommerce Versie 5 --- - + diff --git a/src/nl/documentatie/10.woocommerce-v6.0.md b/src/nl/documentatie/10.woocommerce-v6.0.md new file mode 100644 index 00000000..5cbdd3a1 --- /dev/null +++ b/src/nl/documentatie/10.woocommerce-v6.0.md @@ -0,0 +1,131 @@ +--- +title: WooCommerce Versie 6 +languages: + - en: documentation/10.woocommerce-v6.0.html +--- + + + + + + + +## Introductie + +Versie 6 van de MyParcel-plugin voor WooCommerce is volledig opnieuw gebouwd. In september 2026 vervangt v6 de huidige versie 4 in de WordPress-pluginstore en stapt iedereen via de reguliere plugin-update over. Wil je problemen vóór zijn? Installeer v6 dan nu alvast handmatig, dan nemen wij vanuit MyParcel echt de tijd voor je als je ergens tegenaan loopt. + +Op deze pagina lees je wat er verandert ten opzichte van versie 4 en doorloop je stap voor stap de overstap. + +::: note +Omdat v6 volledig opnieuw is opgezet, zijn ook de instellingen opnieuw ingedeeld. De plugin zet je v4-instellingen zoveel mogelijk automatisch over, maar loop na de installatie alle instellingen na om te controleren of alles goed staat en naar behoren werkt. +::: + +## Wat is er anders in v6? + +De plugin is van de grond af opnieuw geschreven op het MyParcel-platform (PDK). Dat merk je overal: een nieuwe instellingenpagina, ondersteuning voor de nieuwste WooCommerce-technieken en vervoerdersmogelijkheden die rechtstreeks uit de MyParcel API komen. Versie 4 krijgt alleen nog onderhoud, alle nieuwe functionaliteiten komen in v6. + +| | Versie 4 | Versie 6 | +| -------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | +| **Basis** | Eigen codebasis uit 2020 | Volledig herschreven op het MyParcel PDK-platform | +| **Instellingen** | Verspreid over meerdere schermen | 1 nieuwe instellingenpagina, overzichtelijk per vervoerder | +| **Vervoerders en verzendopties** | Vast ingebouwd, update nodig voor elke wijziging | Mogelijkheden komen uit de MyParcel API, bestaande opties worden automatisch vrijgeschakeld, nieuwe vervoerders en opties komen mee met plugin-updates | +| **Checkout** | Alleen de klassieke checkout | Klassieke checkout én de nieuwe WooCommerce blocks-checkout | +| **Orderopslag (HPOS)** | Beperkt | Volledige ondersteuning voor High-Performance Order Storage | +| **Ordergrid** | Kan traag worden bij veel orders | Sneller, zonder losse databasequery's per order | +| **Productinstellingen** | Beperkt per product in te stellen | Uitgebreide verzendinstellingen per product | +| **Nieuwe functionaliteiten** | Alleen bugfixes | Alle nieuwe ontwikkelingen | + +## Wanneer stap je over? + +- **Nu (aanbevolen)**, installeer v6 handmatig via het stappenplan hieronder. Je bepaalt zelf het moment, test rustig mee en onze support heeft alle tijd voor je. +- **September 2026**, v6 komt in de WordPress-pluginstore en vervangt versie 4. Iedereen stapt dan via de reguliere plugin-update over. + +## Stappenplan: van v4 naar v6 + +### Stap 1: Maak een back-up + +Maak een volledige back-up van je website én database voordat je begint. Gaat er iets mis, dan zet je alles in 1 keer terug. + +### Stap 2: Test eerst op een testomgeving + +Voer de overstap eerst uit op een test- of stagingomgeving, niet direct op je live shop. Zo zie je precies hoe de nieuwe instellingen eruitzien en test je de hele bestelflow zonder risico voor je klanten. Heb je geen testomgeving? De meeste hostingpartijen bieden er 1 aan, vraag ernaar bij je hoster of ontwikkelaar. + +### Stap 3: Download de nieuwste v6-release + +1. Ga naar de [releases-pagina op GitHub]. +2. Kies de nieuwste v6-versie (bovenaan de lijst). +3. Download onder _Assets_ het zip-bestand van de plugin. + +### Stap 4: Installeer de plugin handmatig + +1. Ga in WordPress naar `Plugins > Nieuwe plugin > Plugin uploaden`. +2. Kies het gedownloade zip-bestand en klik op **Nu installeren**. +3. WordPress herkent dat de MyParcel-plugin al is geïnstalleerd en vraagt of je de huidige versie wilt vervangen. Kies **Vervang huidige door geüploade versie**. +4. Klik na de installatie op **Plugin activeren**. + +De plugin zet je bestaande instellingen, orders en labels automatisch over. Je API key blijft gekoppeld, je orderhistorie en aangemaakte zendingen blijven gewoon staan. + +::: note +Gebruik je de Belgische SendMyParcel-plugin? De overstap naar v6 gaat gepaard met een naamswijziging van de plugin, waardoor de stappen hierboven niet 1-op-1 gelden. Neem vóór de overstap contact op met onze support, we helpen je door de overstap heen. +::: + +### Stap 5: Loop al je instellingen na + +Open `WooCommerce > MyParcel` en controleer alle onderdelen van de nieuwe instellingenpagina. Let in elk geval op: + +- **Koppeling**, staat de plugin gekoppeld met je MyParcel-account? +- **Algemeen**, orderstatussen, automatische export en labelformaat +- **Vervoerders**, staan al je vervoerders aan, met de juiste verzendopties (handtekening, verzekering, leeftijdscheck)? +- **Checkout**, bezorgopties, afhaallocaties en de kosten per bezorgoptie +- **Productinstellingen**, afwijkende instellingen per product (bijvoorbeeld brievenbuspakket of land van herkomst) +- **E-mails**, Track & Trace-link in de orderbevestiging + +### Stap 6: Test de volledige bestelflow + +1. Plaats een testorder in je checkout en controleer of de bezorgopties goed worden getoond. +2. Exporteer de order naar MyParcel en print het label. +3. Controleer of de Track & Trace-link in de e-mail naar de klant staat. +4. Gebruik je de blocks-checkout van WooCommerce? Test die dan ook apart. + +::: note +Of testlabels kosten met zich meebrengen verschilt per vervoerder. Bij de meeste vervoerders betaal je niets zolang het label niet wordt gescand, maar digitale postzegels worden bijvoorbeeld direct in rekening gebracht. +::: + +### Stap 7: Herhaal de stappen op je live shop + +Werkt alles op je testomgeving? Voer dan stap 1 en 3 t/m 6 uit op je productieomgeving. Plan de overstap op een rustig moment en loop ook daar de instellingen en een testorder na. + +## Iets werkt niet? + +- **Terug naar v4**, zet je back-up terug, of installeer de laatste v4-release opnieuw via de [releases-pagina op GitHub]. Je zendingen blijven bewaard in je [Backoffice]. +- **Hulp nodig?**, neem contact op met onze support via telefoon, chat of WhatsApp. Juist in deze periode nemen we de tijd voor je overstap. + +## Veelgestelde vragen + +### Moet ik nu al overstappen? + +Het hoeft niet, het mag. In september 2026 komt v6 in de WordPress-pluginstore en stapt iedereen via de reguliere update over. Stap je nu alvast handmatig over, dan kies je zelf het moment en test je rustig mee, en kan onze support je 1-op-1 helpen als dat nodig is. + +### Blijven mijn orders en labels bestaan? + +Ja. Je orderhistorie, aangemaakte zendingen en labels blijven staan. De plugin zet je gegevens en instellingen tijdens de update automatisch over. + +### Moet ik mijn API key opnieuw invoeren? + +Nee, je koppeling met MyParcel blijft bestaan. Controleer na de installatie wel of de plugin nog gekoppeld is met je MyParcel-account. + +### Waarom raden jullie een testomgeving aan? + +Versie 6 is volledig opnieuw geschreven, met een nieuwe indeling van alle instellingen. Op een testomgeving zie je precies wat er verandert en test je de checkout, export en e-mails zonder dat je klanten er iets van merken. + +### Kan ik op v4 blijven? + +Versie 4 krijgt alleen nog onderhoud en beveiligingsupdates. Nieuwe vervoerders, verzendopties en functionaliteiten komen alleen naar v6. Vanaf september 2026 is v6 bovendien de versie in de WordPress-pluginstore. + +## Bijdragen aan de plugin + +Zie [CONTRIBUTING.md]. + +[Backoffice]: https://backoffice.myparcel.nl/ +[CONTRIBUTING.md]: https://github.com/myparcelnl/woocommerce/blob/main/CONTRIBUTING.md +[releases-pagina op GitHub]: https://github.com/myparcelnl/woocommerce/releases