Skip Navigation
9

Finally, after very long (and complex) development, ICanLocalize clients can upgrade WPML to its current version and continue to enjoy a streamlined translation workflow.

What’s Changed in WPML 3.2? (that took so long)

WPML 3.2 includes a complete new interface to translation services. You probably know that now WPML offers more translation options, with great new translation services coming very soon.

This update meant that WPML now communicates with translation services using a different method than before. Instead of working directly with ICanLocalize, WPML communicates with what we call “Translation Proxy”. This middle server is a huge help, as it allows us to monitor the communication and quickly troubleshoot anything that goes wrong. It also means that translation services don’t need to directly communicate with individual WordPress sites (which saves a heap of problems with PHP libraries, compatibility, encoding, etc.).

The problem was, we didn’t have a way to move existing ICanLocalize projects from the ‘old’ way to the new one. Now we do 🙂

How to Update to the Current WPML Version

All WPML sites can now move to the current version. If you are using ICanLocalize, you will see a pretty scary message about having to downgrade. This message is from before the time we had this migration plugin.

Message about incorrect WPML version. Ignore the on-screen instructions.
Message about incorrect WPML version. Ignore the on-screen instructions.

Ignore it. Don’t downgrade WPML and follow the rest of the instructions here.

Go to your WPML.org account and click on Downloads. Scroll all the way to the bottom and download the plugin called Migrate ICanLocalize Translation to WPML 3.2. Install it on your site and activate.

The scary message about having to downgrade will go away. Now, go to the new menu that the plugin created for the migration process.

Go to WPML->Migrate ICanLocalize Translation to WPML 3.2.

Migration plugin admin screen
Migration plugin admin screen

You will see two buttons. First, click to migrate the account to WPML 3.2. This runs almost instantly. Then, click to migrate the jobs.

You should be all set. When you go to WPML->Translation Management->Translators, you should see your current ICL translators selected and completed jobs will appear again in WPML’s Translation Dashboard.

Completed jobs waiting in the Translation Dashboard
Completed jobs waiting in the Translation Dashboard

If there are any problems in this migration process (there should not be), the migration plugin will report them on the screen. Create a new ticket in WPML technical support forum, copy what you see and paste in the forum thread. Be sure to explain what you are doing and what you are seeing.

You no longer need the migration plugin. Go to Plugins and deactivate it. The migration plugin does’t do anything else. Keeping it active will not cause any problems, but it’s not needed for your sites.

The right order to update WPML and WordPress

If you are running an older version of WPML, chances are you are also running an older version of WordPress.

A safe update process will be:

  1. Back up your site’s database
  2. Update ALL of WPML’s components to the current version
  3. Install and run the migration plugin for ICanLocalize clients (obviously, only if you are an ICanLocalize client)
  4. Update WordPress

Automatic Version Update for Everyone

This week, we want to see how this migration process goes, so we’re letting it run on manual mode. We ran comprehensive testing on this process and it’s already running successfully on all our sites too.

Next week, we will finally push automated updates for all existing WPML sites to the current version.

Questions? Suggestions? Ideas? Leave your comments and we’ll get back to you.

How can we make WPML better for you?

Share your thoughts and comments about our plugin, documentation, or videos by booking a Zoom call with Agnes, our Client Advocate. Your feedback matters and helps us improve.

Book a call with Agnes