PHPackages                             raph-topo/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. [Localization & i18n](/categories/localization)
4. /
5. raph-topo/wp-translations

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

raph-topo/wp-translations
=========================

Composer plugin to download translation files from wordpress.org

v3.1.4(1mo ago)71.6k[1 issues](https://github.com/raph-topo/wp-translations/issues)GPL-3.0-or-laterPHPCI passing

Since Aug 10Pushed 2w ago1 watchersCompare

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

READMEChangelog (8)Dependencies (4)Versions (17)Used By (0)

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

[](#wp-translations)

[![Packagist Version](https://camo.githubusercontent.com/60880821f4d5d9a81a0af4ee8419f2db8f0688c9d16ff6849f631a8821102dea/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/60880821f4d5d9a81a0af4ee8419f2db8f0688c9d16ff6849f631a8821102dea/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![Packagist Stars](https://camo.githubusercontent.com/996f17888b4b1545b9a29d23b10ed6744901ba75b29da00f69e0ac5d9e5b3747/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/996f17888b4b1545b9a29d23b10ed6744901ba75b29da00f69e0ac5d9e5b3747/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![Packagist Downloads](https://camo.githubusercontent.com/ca1e150d2d7e1604e9ca9fb502ed7f5d9ecdfea4238ea0f16ee55c0ecd00827c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/ca1e150d2d7e1604e9ca9fb502ed7f5d9ecdfea4238ea0f16ee55c0ecd00827c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![GitHub last commit](https://camo.githubusercontent.com/34b92c1a9180cd9426c813a37940063b0242f3ddd7b6c9ca82b7cecf7c163aa8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/34b92c1a9180cd9426c813a37940063b0242f3ddd7b6c9ca82b7cecf7c163aa8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![PHP Composer](https://github.com/raph-topo/wp-translations/workflows/PHP%20Composer/badge.svg?branch=main)](https://github.com/raph-topo/wp-translations/workflows/PHP%20Composer/badge.svg?branch=main)[![GitHub issues](https://camo.githubusercontent.com/63ff74513285407fc194c0b8844f3708fc3586a6c8cd4f59b40571f66ef66ef0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/63ff74513285407fc194c0b8844f3708fc3586a6c8cd4f59b40571f66ef66ef0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![GitHub pull requests](https://camo.githubusercontent.com/98a519d9b83d9086e20d147277f87e1643678c0e6bed7175e22a56667e409915/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d70722f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/98a519d9b83d9086e20d147277f87e1643678c0e6bed7175e22a56667e409915/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d70722f726170682d746f706f2f77702d7472616e736c6174696f6e73)[![License](https://camo.githubusercontent.com/ff991fccc398c7f84b3f8f3e6863466e69f196091f66d79b5b10bbfc7b02d58c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f726170682d746f706f2f77702d7472616e736c6174696f6e73)](https://camo.githubusercontent.com/ff991fccc398c7f84b3f8f3e6863466e69f196091f66d79b5b10bbfc7b02d58c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f726170682d746f706f2f77702d7472616e736c6174696f6e73)

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 raph-topo/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

53

—

FairBetter than 96% of packages

Maintenance91

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 75.2% 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 ~235 days

Recently: every ~453 days

Total

13

Last Release

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

### Community

Maintainers

![](https://www.gravatar.com/avatar/7443f0abae25279f2b7a07e213037aea868eb440188391d93eeaac1754216618?d=identicon)[raph-topo](/maintainers/raph-topo)

---

Top Contributors

[![raph-topo](https://avatars.githubusercontent.com/u/53143154?v=4)](https://github.com/raph-topo "raph-topo (82 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (16 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)")

---

Tags

composerinternationalizationrootswordpress

### Embed Badge

![Health badge](/badges/raph-topo-wp-translations/health.svg)

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

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)[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.

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

Adds a message after Composer installation.

2124.7M203](/packages/drupal-core-project-message)[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)