PHPackages                             lucguerraz/wpml-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. lucguerraz/wpml-installer

ActiveComposer-plugin[Localization & i18n](/categories/localization)

lucguerraz/wpml-installer
=========================

A composer plugin to make installing wpml.org plugins with composer easy. Your subscription info will be read from environment variables, will only be transmitted to WPML and will not be displayed in composer.lock.

1.0.2(8mo ago)43.4k↓26.9%3[1 PRs](https://github.com/lucguerraz/wpml-installer/pulls)GPL-2.0-onlyPHPPHP >=8.0

Since Jan 12Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/lucguerraz/wpml-installer)[ Packagist](https://packagist.org/packages/lucguerraz/wpml-installer)[ Docs](https://github.com/lucguerraz/wpml-installer)[ RSS](/packages/lucguerraz-wpml-installer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (3)Versions (5)Used By (0)

WPML Installer for composer
===========================

[](#wpml-installer-for-composer)

A composer plugin to make installing [wpml.org](https://wpml.org) plugins with composer easy. Your subscription info will be read from environment variables or from a `.env` file, will only be transmitted to WPML and will not be displayed in `composer.lock`.

This composer plugin does not provide any WPML code. The WPML plugins will be downloaded directly from wpml.org

Usage
-----

[](#usage)

#### 1. Add our [composer repository for WPML packages](https://github.com/lucguerraz/wpml-packages) to the `repositories` section of your `composer.json` file or define the packages ad-hoc

[](#1-add-our-composer-repository-for-wpml-packages-to-the-repositories-section-of-your-composerjson-file-or-define-the-packages-ad-hoc)

```
{
  "type": "composer",
  "url": "https://lucguerraz.github.io/wpml-packages/"
}

```

This installs the package as `wordpress-plugin` type and requires [`composer/installers`](https://packagist.org/packages/composer/installers), so you can install the plugins in the correct location.

This repository provides the latest versions of the WPML plugins. If you want a specific version you can define the packages ad-hoc and just require `lucguerraz/wpml-installer`. A little bit like this:

```
{
  "type": "package",
  "package": {
    "name": "wpml/sitepress-multilingual-cms",
    "version": "1.0.0",
    "type": "wordpress-plugin",
    "dist": {
        "type": "zip",
        "url": "https://wpml.org/?download=6088&version=1.0.0"
    },
    "require": {
        "lucguerraz/wpml-installer": "^1.0",
        "composer/installers": "~1.0"
    }
  }
}

```

When you request an older version you must be sure than WPML still provides a download otherwise this won't work

### 2. Save your WPML user id and subscription key to environment variables or to a `.env` file

[](#2-save-your-wpml-user-id-and-subscription-key-to-environment-variables-or-to-a-env-file)

We do not provide any WPML code, the plugins are downloaded directly from WPML servers. Because of this we need your WPML subscription info to be able to download them. Your subscription info is stored in environment variables or a `.env` file, is only transmitted to WPML and will not show up in `composer.lock`.

You can get your user id and subscription key from a WPML provided download link, that you can get from your [WPML dashboard](https://wpml.org/account/downloads/). It will look like this: `https://wpml.org/?download=6088&user_id=XXXXX&subscription_key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&version=4.5.14`

#### Using environment variables

[](#using-environment-variables)

Save the `user_id` parameter in the `WPML_USER_ID` environment variable and the `subscription_key` parameter in the `WPML_SUBSCRIPTION_KEY` environment variable.

#### Using a `.env` file

[](#using-a-env-file)

Add the `user_id` parameter with the `WPML_USER_ID` key and the `subscription_key` parameter with the `WPML_SUBSCRIPTION_KEY` key to your `.env` file. The `.env` file must be in the same directory as your `composer.json` file for it work.

### 3. Require a WPML plugin

[](#3-require-a-wpml-plugin)

`composer require wpml/sitepress-multilingual-cms`

Acknowledgments
---------------

[](#acknowledgments)

This composer plugin was created to add support to installing WPML with composer v2. It was heavily inspired by [`pernod-ricard-brandcos/wpml-installer`](https://bitbucket.org/pernod-ricard-brandcos/wpml-installer) and [`enelogic/wpml-installer`](https://github.com/enelogic/wpml-installer).

Disclaimer
----------

[](#disclaimer)

This project is not affiliated with WPML in any way, we do not provide any WPML code, all plugins are directly downloaded from wpml.org, your subscription info will be injected dynamically into the download link, your subscription info will only be transmitted to WPML and will not be displayed in `composer.lock`

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance58

Moderate activity, may be stable

Popularity29

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~319 days

Total

4

Last Release

266d ago

Major Versions

0.1 → 1.02025-01-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/55530568?v=4)[Luc Guerraz](/maintainers/lucguerraz)[@lucguerraz](https://github.com/lucguerraz)

---

Top Contributors

[![lucguerraz](https://avatars.githubusercontent.com/u/55530568?v=4)](https://github.com/lucguerraz "lucguerraz (19 commits)")

---

Tags

composermultilangwordpresswpwpmlcomposerwordpressmultilingualwpwpml

### Embed Badge

![Health badge](/badges/lucguerraz-wpml-installer/health.svg)

```
[![Health](https://phpackages.com/badges/lucguerraz-wpml-installer/health.svg)](https://phpackages.com/packages/lucguerraz-wpml-installer)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[ffraenz/private-composer-installer

A composer install helper for private packages

2331.7M5](/packages/ffraenz-private-composer-installer)[philippbaschke/acf-pro-installer

An install helper for Advanced Custom Fields PRO

283724.6k](/packages/philippbaschke-acf-pro-installer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)