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.3k↓45%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 1mo 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 89% of packages

Maintenance48

Moderate activity, may be stable

Popularity21

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity69

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

383d 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

[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.

2994.3M16](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M446](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)[olvlvl/composer-attribute-collector

A convenient and near zero-cost way to retrieve targets of PHP 8 attributes

184108.8k8](/packages/olvlvl-composer-attribute-collector)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)

PHPackages © 2026

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