PHPackages                             wppack/translations-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. wppack/translations-installer

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

wppack/translations-installer
=============================

Composer plugin that downloads WordPress core, plugin and theme translations from wordpress.org as packages are installed or updated.

v1.1.0(1mo ago)0276↓74.5%3GPL-2.0-or-laterPHPPHP ^8.2CI passing

Since Jul 14Pushed 1mo agoCompare

[ Source](https://github.com/wppack-io/translations-installer)[ Packagist](https://packagist.org/packages/wppack/translations-installer)[ RSS](/packages/wppack-translations-installer/feed)WikiDiscussions 1.x Synced 1w ago

READMEChangelogDependencies (10)Versions (7)Used By (3)

WPPack Translations Installer
=============================

[](#wppack-translations-installer)

[![CI](https://camo.githubusercontent.com/3e8156610e1745e103b09addd158439656fde5da44e76daaa17804c2fc07600c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f77707061636b2d696f2f7472616e736c6174696f6e732d696e7374616c6c65722f63692e796d6c3f6272616e63683d312e78)](https://github.com/wppack-io/translations-installer/actions/workflows/ci.yml)[![License: GPL-2.0-or-later](https://camo.githubusercontent.com/43a510dd0989747b1c3997cb691eaef0adc0f48c2ba392da31b012ef9030bf23/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c2d2d322e302d2d6f722d2d6c617465722d626c75652e737667)](LICENSE)[![PHP Version](https://camo.githubusercontent.com/c2588b5670f2c910b8cc849ace22a22efda8956b7c2f797d11d2096bbfc7b1f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242342e737667)](https://php.net)

[日本語版 README](README.ja.md)

Composer plugin that downloads translation files for WordPress core, plugins and themes from wordpress.org, as the packages are installed or updated.

A fork of [bjornjohansen/wplang](https://github.com/bjornjohansen/wplang), brought into the WPPack package family.

Supports Composer v2 only. Requires PHP 8.2+ and `ext-zip`.

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

[](#installation)

Add the configuration to `composer.json` (paths are relative to the project root, i.e. the directory holding `composer.json`):

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

Then:

```
$ composer require wppack/translations-installer
```

Composer asks to trust the plugin on first install; allow it (or pre-seed `config.allow-plugins`):

```
{
    "config": {
        "allow-plugins": {
            "wppack/translations-installer": true
        }
    }
}
```

Usage
-----

[](#usage)

Nothing to run: whenever a package of type `wordpress-core`, `wordpress-plugin` or `wordpress-theme` is installed or updated, the matching language packs are fetched from the wordpress.org translations API and unpacked into the configured directory — core at its root, plugins and themes under `plugins/` and `themes/`, the same layout WordPress itself uses under `wp-content/languages`.

The core package is not tied to `roots/wordpress`: any package that declares `"type": "wordpress-core"` (e.g. `roots/wordpress`, `johnpbloch/wordpress-core`) is picked up. Core translations are looked up on wordpress.org by version only, so the package name does not matter.

Packages that have no translations for the configured locales print a note and are skipped; the install itself never fails because of translations.

Commands
--------

[](#commands)

Language packs on wordpress.org are often updated *after* a package release, so the plugin also ships two commands that can be run at any time:

```
$ composer translations:update
```

Downloads translations for every installed WordPress package. Only locales that are missing locally or outdated on wordpress.org are fetched; current ones are skipped. Failures are reported per package and never fail the command.

```
$ composer translations:status
```

Read-only report of every package × locale: `Up to date`, `Outdated` (local and remote timestamps shown), `Missing` or `Not available`. Exits with code 1 when anything can be updated, so it doubles as a CI freshness check:

```
$ composer translations:status
wpackagist-plugin/query-monitor
  - ja     Up to date (2026-07-03 14:02:39)
  - fr_FR  Outdated   (local 2026-01-15 10:00:00 → remote 2026-06-20 09:14:31)
All translations are up to date.
```

### How freshness is decided

[](#how-freshness-is-decided)

The wordpress.org API reports an `updated` timestamp per language pack; the installed `.po` file carries the same timestamp in its `PO-Revision-Date`header. The plugin compares the two — the same mechanism WordPress core uses for its own language pack updates. There is no state file: the installed files are the record, so deleting a `.po` simply causes that locale to be re-downloaded. Downloads always unpack the full pack (`.po`, `.mo` and `.l10n.php`).

The same check runs in the install/update hooks, so unchanged translations are not re-downloaded there either.

Credits
-------

[](#credits)

This package was started by Angry Creative, has been rewritten by Bjørn Johansen, integrates compatibility changes made by Mirai and was updated to support Composer v2. The WPPack edition modernizes the codebase for PHP 8.2+.

License
-------

[](#license)

GPL-2.0-or-later

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance91

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity50

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 ~1 days

Total

7

Last Release

45d ago

### Community

Maintainers

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

---

Top Contributors

[![ttsuru](https://avatars.githubusercontent.com/u/578548?v=4)](https://github.com/ttsuru "ttsuru (18 commits)")

---

Tags

wordpressi18ntranslationscomposer-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/wppack-translations-installer/health.svg)

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

###  Alternatives

[punic/punic

PHP-Unicode CLDR

1543.1M34](/packages/punic-punic)[erag/laravel-lang-sync-inertia

A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications.

6036.2k](/packages/erag-laravel-lang-sync-inertia)

PHPackages © 2026

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