Composer plugin to download translation files for WordPress core, plugins and themes from wordpress.org.
Optimized for the Roots 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
.
Add the following settings to composer.json
:
{
"extra": {
"wordpress-translations": [ "fr_FR" ],
"wordpress-translations-dir": "web/app/languages"
}
}
The Translate WordPress page lists available locales (column WP Locale)
Install WP Translations with:
$ composer require raph-topo/wp-translations
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.
To force-update translations for already installed packages, delete the contents of the following folders:
web/wp
web/app/plugins
, except the fileweb/app/plugins/.gitkeep
Run composer update
.
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.