Composer Auto Language Updates

This package will automatically update translations for WordPress core, themes & plugins when you install or update them via composer.*, _(*1)

Made with :heart: by Angry Creative in Sweden., _(*2)

* This only works if the translations are available via the WordPress API., _(*3)

Installation instructions

1. Add this repository as a composer dependency

First, add this .git repo to the repositories array in your sites main composer.json file., _(*4)

{
  "type": "git",
  "url": "https://github.com/Angrycreative/composer-plugin-language-update.git"
}

2. Require the package.

Run composer require Angrycreative/composer-plugin-language-update:"*"., _(*5)

3. Define the languages used on your site and the path to your wp-content directory.

This can be done by adding the following parameters to the extras object in your sites' main composer.json file., _(*6)

"extra": {
  "wordpress-languages": [ "sv_SE", "en_GB", "da_DK" ],
  "wordpress-path-to-content-dir": "public/wp-content"
 }

(We need to add a list of locales manually as this operation cannot rely on having a connection to the database available)., _(*7)

4. Add the required composer install hooks.

Add the following lines to the scripts section of your composer.json., _(*8)

"scripts": {
  "post-package-install": [
    "AngryCreative\\PostUpdateLanguageUpdate::install_t10ns"
  ],
  "post-package-update": [
    "AngryCreative\\PostUpdateLanguageUpdate::update_t10ns"
  ]
}

That's it. Next time you run a composer update|install the translations for the relevant packages will be installed automatically., _(*9)

Tests

If you're testing, this package must be installed as a part of WordPress installation. You should ideally remove the entire wp-content/languages directory, so as to make sure the package behaves as expected., _(*10)

Obviously you should probably do this on seperate branch, so you don't remove t10ns accidentaly when you run the tests., _(*11)

cd into the packagage directory and run composer test., _(*12)

You may need to run the tests as root to avoid permissions errors when creating the directories., _(*13)

WTF?

I can haz missing translation plz?

This only works if the t10ns are found on the WordPress API, eg. https://api.wordpress.org/translations/plugins/1.0/?slug=redirection&version=2.7.3, _(*14)