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(1w ago)81.5k[1 issues](https://github.com/raph-topo/wp-translations/issues)GPL-3.0-or-laterPHPCI passing

Since Aug 10Pushed 1w 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 1w ago

READMEChangelog (8)Dependencies (4)Versions (16)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 97% of packages

Maintenance95

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 75.7% 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

12d 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 (81 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 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

[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)[drupal-composer/drupal-l10n

Composer Plugin for downloading Drupal translation files

11341.8k](/packages/drupal-composer-drupal-l10n)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[bjornjohansen/wplang

Composer plugin to download translation files from wordpress.org

2149.4k](/packages/bjornjohansen-wplang)

PHPackages © 2026

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