Home » How to Download and Install WPML and Receive Automated Updates

How to Download and Install WPML and Receive Automated Updates

August 28th, 2012 by Amir

WPML includes its own automatic update and install process. After you install the base WPML plugin once, you can auto-install its components and receive upgrades directly to the WordPress admin.

First time WPML installation

The first time you use WPML, you need to manually download it and install. Then, register to receive automated updates to future versions.

  1. Log in to your WPML.org account.
  2. Go to the Downloads section.
  3. Download the WPML components that you need. You will receive a ZIP file for each one of WPML’s components.

    download-wpml

  4. In the WordPress admin, go to Plugins -> new -> Upload and upload the ZIP files that you downloaded.

    upload-plugin

    Alternatively, if you cannot upload plugins directly to WordPress:

    • Unzip each file. A directory will be created.
    • Upload the unzipped directories to your site’s ‘wp-contents/plugins’ directory.
  5. Log in to your site, go to Plugins and enable them.
  6. Follow WPML’s setup wizard to add languages to your site.

Done with the first-time installation? Remember to register WPML to receive automated updates to future versions.

Updating WPML manually (for WPML before 3.1.7)

For sites that have WPML before 3.1.7, you need to update manually. After this manual update, you can register WPML and receive automated updates to future versions.

For manual updates, follow these steps:

  1. Ensure that you have a database backup for the site. You can back-up your database using plugins like Duplicator, BackupBuddy or by taking a database dump using your hosting control panel.
  2. Log in to your WPML.org account.
  3. Go to the Downloads section.
  4. Download the WPML components that you need. You will receive a ZIP file for each one of WPML’s components.

    download-wpml

  5. Deactivate the current WPML version that you are using. Be sure to deactivate WPML and all its components. Otherwise, the installation files may be locked and not writeable. Don’t worry, your translations are not going to be modified.

    deactivate-plugin

  6. Delete the plugin, so that you can install the new version.
    delete-plugin

    Note: if you cannot delete from inside WordPress, use an FTP program to delete the folders of WPML and its components from wp-content/plugins.

  7. If you have our old ‘Installer’ plugin, deactivate it and remove from the wp-content/plugins directory. The new WPML versions include the automated installer component.
  8. In the WordPress admin, go to Plugins -> new -> Upload and upload the ZIP files that you downloaded.

    upload-plugin

    Alternatively, if you cannot upload plugins directly to WordPress:

    • Unzip each file. A directory will be created.
    • Upload the unzipped directories to your site’s ‘wp-contents/plugins’ directory and overwrite the existing folders for WPML and its components.
  9. Log in to your site, go to Plugins and activate WPML and its components.

When you are done and have the current version of WPML, remember to register WPML to receive automated updates to future versions.

Registering WPML to receive automatic updates (available as of WPML 3.1.7)

Registering WPML allows you to receive automatic updates, directly to the WordPress admin. Once WPML is registered, updates for WPML will appear exactly like updates for plugins that come from wordpress.org.

You need to register WPML on every site that you run it, so that you receive these updates. You can register as many sites as you need.

To register WPML, to the Plugins admin page. You will see a message asking you to register WPML.

Registration message on the plugins admin page

Registration message on the plugins admin page

* Don’t see the registration link for WPML? It means that you are using an older version that didn’t have it yet. No worries, download and install WPML manually, from your wpml.org account. You will only need to do this once. Next updates will arrive automatically.

Follow the link to buy/register and you will see WPML’s info box:

Purchase and registration options

Purchase and registration options

If you haven’t yet purchased WPML, you can do that right from within the WordPress admin. If you have a WPML account, click on the ‘Register WPML’ button.

Click to register this site

Click to register this site

Click where it says WPML account. This will take you to your account and auto-register your site. You will need to confirm that you’re adding this site. Then, you will see the key to activate WPML on the site. Copy your site-key. You can select it by double clicking on the text and copying to the clipboard (CTRL-C).

Your site key is ready. Copy it, so you can paste back in WordPress.

Your site key is ready. Copy it, so you can paste back in WordPress.

Now, return to your WordPress site and enter this site key. Click OK to complete the registration.

Paste the site-key and click OK to complete the registration.

Paste the site-key and click OK to complete the registration.

You will see a list of WPML components which are available for you to install.

Install additional WPML components

Install additional WPML components

Select the checkboxes next to the components that you need. If you also want to activate the plugins immediately, also select the checkbox ‘Activate after download’. Then, click on the ‘Download’ button. If you don’t choose the option to activate, these components will be downloaded and installed onto your WordPress site and you can activate them later from the Plugins page.

From now, you will receive updates to WPML and its components automatically to the site that you just registered.

Registration FAQ

How many sites can I register WPML on?

You can register WPML on all your sites and sites that you build for your clients.

Can others reuse my site-keys to register WPML on other websites?

No, each site-key is unique for the website you registered.

Can I stop automatic updates for any site?

You control which sites can get automatic updates from your account. You can always visit ‘My sites’ and delete site keys.

What do I need to do when the site’s URL changes?

When sites move (happens when you move from development to production) they get a new home URL. You need to register the site again to keep receiving updates for WPML. If you moved the site by copying the database, go to Plugins->Add new->Commercial and click on Unregister WPML from this site.

Unregister WPML

Unregister WPML

Then, click again on Register WPML and complete the registration for the site, in its new URL.

Receiving automated updates for WPML

If you have installed WPML 3.1.7 or later and have registered it in your site, you will receive updates automatically.

Whenever a new version of WPML is available, you will see notices on the WordPress dashboard. Notices appear in the Updates and Plugins sections. Follow either to receive your updates.

WPML updates will appear like any other WordPress updates in your admin dashboard

WPML updates will appear like any other WordPress updates in your admin dashboard

  1. Click on the Plugins admin screen.
  2. Click on Updates available.
  3. Next to each of WPML’s components, click on the Update now link. Be sure to update all WPML components that you are using, starting with the main plugin.

    update-now

When you update WPML, your content (including translations) doesn’t change.

We recommend backing up your database before performing any updates. This includes WordPress, your theme and plugins. To make a database backup, you can use plugins like Duplicator and BackupBuddy. You can also take a database dump using your hosting control panel.


Need an account? Buy WPML