New! – Get the brand new version MultilingualPress 3.3

MultilingualPress 2 to 3 Migration Tool

This tool provides you a fast and easy solution to migrate your WordPress Multisite content from MultilingualPress version 2 (MLP 2) to version 3 (MLP 3).

Please note: This is an alpha version and will be improved after some testing. Please do not use this on a live system.
 
You can help us to improve the tool by sending us possible problems you discover via support@multilingualpress.org or on Github.

If you prefer to manually migrate from MLP 2 to MLP 3, you can follow this tutorial.

The following documentation shows the essential steps to install and use the MultilingualPress 2 to 3 Migration Tool

Requirements for MultilingualPress 2 to 3 Migration Tool

In order to perform a migration of your Multisite Network from MLP 2 to the new Version MLP 3, you need:

  • An installed version of WordPress Multisite with WordPress 4.8 or above.
  • An installed and activated version of MLP 2.
  • WP-CLI has to be installed in order to execute the MLP 2 to MLP 3 migration tool via WP-CLI command line. If you need help, follow this tutorial for WP-CLI installation.

Please note: Before proceeding, we strongly recommend a full backup including all the files and the database of your Multisite Network.

Setting the environment

  1. Go to: My SitesNetwork AdminPlugins and Update MLP 2 to the latest version (2.11.3 or above) if needed.

    Select the Menu Plugins via Network Admin WordPress Backend
    Select the Menu Plugins via Network Admin WordPress Backend
  2. Download and Install the latest version of MLP 3 (3.2.0 or above). If you need help, see this tutorial.

    Please note: Don’t activate the MLP 3 Plugin yet.

  3. Download the MultilingualPress 2 to 3 Migration Tool on Github. The latest version of the migration tool can be downloaded from this link.
    Go to releases and download the zip file of the latest version.

    Release-Button on Github for MLP2 to MLP 3 Migration Tool
    Click the Releases Tab on the Tools Github page
  4. Install the MultilingualPress 2 to 3 Migration Tool on WordPress:
    • Go to My SitesNetwork AdminPlugins and press the button Add New.
    • Select Upload Plugin and upload the Plugin zip file from your computer.
    • Press Install Now.
    • After installation completed, click Network Activate to activate the plugin across your Multisite environment.
  5. Go to: My SitesNetwork AdminPlugins and Network Deactivate MLP 2.

    Network Deactivation MLP 2
    Network Deactivate MLP 2
  6. Network Activate MLP 3.

 

Executing the migration

  1. Run the tool via the command line of your system (Windows: cmd.exe; Mac: Terminal) by entering the following instruction:
    wp mlp2to3 all
  2. The above command will perform all the needed action to achieve the migration from MLP 2 to MLP 3. A process bar will be visible during migration.
  3. You can also execute only a specific task:
    Refer to the online help to see which tasks are available by using the command:

    wp mlp2to3 --help
  4. When the migration is completed: Check that the site is working properly and no errors occur.

    Please note: In case of an error, contact our Support.

  5. If the previous step was successful: Uninstall MLP2 by going to My SitesNetwork AdminPlugins and Delete.
  6. Network Deactivate and Delete the Migration Plugin.

 


Build the perfect multilingual webshop with WooCommerce and our plugins MultilingualPress and OneStock!