PHPackages                             wpnx-io/wp-translations - 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. [Utility & Helpers](/categories/utility)
4. /
5. wpnx-io/wp-translations

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

wpnx-io/wp-translations
=======================

Composer plugin to download translation files from wordpress.org

v4.0.0(1y ago)11.8k↓21.7%GPL-3.0-or-laterPHPCI passing

Since Aug 10Pushed 1y agoCompare

[ Source](https://github.com/wpnx-io/wp-translations)[ Packagist](https://packagist.org/packages/wpnx-io/wp-translations)[ RSS](/packages/wpnx-io-wp-translations/feed)WikiDiscussions main Synced 3d ago

READMEChangelogDependencies (2)Versions (13)Used By (0)

WP Translations
===============

[](#wp-translations)

[![Packagist Version](https://camo.githubusercontent.com/92adbb832fc5a10d06a0a5d037d0e361dac46765bcb7f0affb8d76460d127797/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/92adbb832fc5a10d06a0a5d037d0e361dac46765bcb7f0affb8d76460d127797/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77706e782d696f2f77702d7472616e736c6174696f6e73)[![Packagist Stars](https://camo.githubusercontent.com/9168f3bfee19ba3999e6a84584df56b32e299831afa49e58d036add2d2cd3459/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/9168f3bfee19ba3999e6a84584df56b32e299831afa49e58d036add2d2cd3459/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f77706e782d696f2f77702d7472616e736c6174696f6e73)[![Packagist Downloads](https://camo.githubusercontent.com/fcae2feeb0dd30d81bc44b8284e21999886d10b2236dd0481500f90b0e2e555f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/fcae2feeb0dd30d81bc44b8284e21999886d10b2236dd0481500f90b0e2e555f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77706e782d696f2f77702d7472616e736c6174696f6e73)[![GitHub last commit](https://camo.githubusercontent.com/7fefa266357b3800d2a44f90473ab49657e4ea95f8a32dca7ce0ab34fae8cbb8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/7fefa266357b3800d2a44f90473ab49657e4ea95f8a32dca7ce0ab34fae8cbb8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f77706e782d696f2f77702d7472616e736c6174696f6e73)[![PHP Composer](https://github.com/wpnx-io/wp-translations/workflows/PHP%20Composer/badge.svg?branch=master)](https://github.com/wpnx-io/wp-translations/workflows/PHP%20Composer/badge.svg?branch=master)[![GitHub issues](https://camo.githubusercontent.com/32c11dfed3aebe426a308812aa1b1c2443b8ffe2dcda65c7eaa2d365103b6d59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/32c11dfed3aebe426a308812aa1b1c2443b8ffe2dcda65c7eaa2d365103b6d59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f77706e782d696f2f77702d7472616e736c6174696f6e73)[![GitHub pull requests](https://camo.githubusercontent.com/34f91bb116423b9e9e0e732caa288fd8cd396800b0897a907c176f202930d54e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d70722f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/34f91bb116423b9e9e0e732caa288fd8cd396800b0897a907c176f202930d54e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d70722f77706e782d696f2f77702d7472616e736c6174696f6e73)[![License](https://camo.githubusercontent.com/126462623615743bd5172ad35407c25cd3fb45df934a8a6c0e797743740383d9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f77706e782d696f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/126462623615743bd5172ad35407c25cd3fb45df934a8a6c0e797743740383d9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f77706e782d696f2f77702d7472616e736c6174696f6e73)

Composer plugin to download translation files for WordPress core, plugins and themes from wordpress.org.

Optimized for the [Roots](https://roots.io/) stack, particularly Bedrock, but can be adapted to other setups based on Composer.

Supports Composer v2 (only).

Instructions are given relative to the Bedrock root folder, usually `site`.

Installation
------------

[](#installation)

Add the following settings to `composer.json`:

```
{
    "extra": {
        "wordpress-translations": [ "fr_FR" ],
        "wordpress-translations-dir": "web/app/languages"
    }
}
```

The [Translate WordPress](https://make.wordpress.org/polyglots/teams/) page lists available locales (column *WP Locale*)

Install WP Translations with:

```
$ composer require wpnx-io/wp-translations
```

Usage
-----

[](#usage)

Composer will try to install translations from through the WordPress.org API every time you install or update a package — for this package only.

**Commit the translation files** (`web/app/languages/{.,themes,plugins}/*{.mo,.po}`) and deploy them to staging and production.

From time to time, you might want to get rid of old translation files (plugins that were uninstalled, etc.) To do that, you must delete `web/app/languages` and follow *Extant projects* hereunder.

Extant projects
---------------

[](#extant-projects)

To force-update translations for already installed packages, delete the contents of the following folders:

- `web/wp`
- `web/app/plugins`, except the file `web/app/plugins/.gitkeep`

Run `composer update`.

Credits
-------

[](#credits)

This package was started by [Angry Creative](https://github.com/Angrycreative/composer-plugin-language-update), has been rewritten by [Bjørn Johansen](https://github.com/bjornjohansen/wplang), integrates compatibility changes made by [Mirai](https://github.com/mirai-wordpress/wplang) and was updated to support Composer v2.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance45

Moderate activity, may be stable

Popularity22

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 75.5% 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 ~223 days

Recently: every ~406 days

Total

12

Last Release

430d ago

Major Versions

0.1.1 → 1.0.02020-05-25

1.0.0 → 2.0.02020-05-25

2.0.1 → v3.0.02020-11-19

v3.1.2 → v4.0.02025-05-01

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/578548?v=4)[TSURU](/maintainers/ttsuru)[@ttsuru](https://github.com/ttsuru)

---

Top Contributors

[![raph-topo](https://avatars.githubusercontent.com/u/53143154?v=4)](https://github.com/raph-topo "raph-topo (77 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![raulillana](https://avatars.githubusercontent.com/u/1171669?v=4)](https://github.com/raulillana "raulillana (6 commits)")[![bjornjohansen](https://avatars.githubusercontent.com/u/399136?v=4)](https://github.com/bjornjohansen "bjornjohansen (2 commits)")[![eugene-melnik](https://avatars.githubusercontent.com/u/3146851?v=4)](https://github.com/eugene-melnik "eugene-melnik (1 commits)")[![burnedram](https://avatars.githubusercontent.com/u/1688771?v=4)](https://github.com/burnedram "burnedram (1 commits)")[![SeifertDaniel](https://avatars.githubusercontent.com/u/9882400?v=4)](https://github.com/SeifertDaniel "SeifertDaniel (1 commits)")[![ttsuru](https://avatars.githubusercontent.com/u/578548?v=4)](https://github.com/ttsuru "ttsuru (1 commits)")

### Embed Badge

![Health badge](/badges/wpnx-io-wp-translations/health.svg)

```
[![Health](https://phpackages.com/badges/wpnx-io-wp-translations/health.svg)](https://phpackages.com/packages/wpnx-io-wp-translations)
```

###  Alternatives

[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M1.0k](/packages/symfony-runtime)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5445.2M564](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M203](/packages/drupal-core-project-message)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

3014.6M26](/packages/vaimo-composer-patches)[sandersander/composer-link

Adds ability to link local packages for development with composer

98457.9k](/packages/sandersander-composer-link)[phpro/grumphp-shim

GrumPHP Phar distribution

294.7M340](/packages/phpro-grumphp-shim)

PHPackages © 2026

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