https://github.com/drupal-composer/drupal-l10n
Composer Plugin for downloading Drupal translation files.
https://github.com/drupal-composer/drupal-l10n
Last synced: about 1 year ago
JSON representation
Composer Plugin for downloading Drupal translation files.
- Host: GitHub
- URL: https://github.com/drupal-composer/drupal-l10n
- Owner: drupal-composer
- Created: 2018-07-02T11:37:33.000Z (almost 8 years ago)
- Default Branch: 2.0.x
- Last Pushed: 2024-09-21T16:27:51.000Z (almost 2 years ago)
- Last Synced: 2025-04-20T20:03:22.910Z (about 1 year ago)
- Language: PHP
- Homepage:
- Size: 146 KB
- Stars: 11
- Watchers: 4
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# drupal-l10n
[](https://github.com/drupal-composer/drupal-l10n/actions/workflows/tests.yml)
Composer plugin for automatically downloading Drupal translation files when
using Composer to manage Drupal projects.
This plugin is useful when you want to package your project and then deploy this
package on a target environment and that this environment does not have access
to a localization server. So you have to prepare the translations before
deploying.
It avoids you to have to put the localization files under your VCS or to have a
local site to download the translations.
## Usage
Run `composer require drupal-composer/drupal-l10n` in your composer project
before installing or updating `drupal/core`.
Once drupal-l10n is required by your project, it will automatically download the
translations files whenever `composer update` download new versions of Drupal
projects installed. It also runs on `composer require` command.
You can manually download the localization files according to your configuration
by using `composer drupal:l10n`.
## Configuration
You can configure the plugin by providing some settings in the `extra` section
of your root `composer.json`.
```json
{
"extra": {
"drupal-l10n": {
"destination": "translations/contrib",
"languages": [
"fr",
"es"
]
}
}
}
```
The `destination` parameter may be used to specify the destination folder of the
translation files. By default the destination is
`sites/default/files/translations`.
The `languages` parameter specify the languages you want to retrieve.
## Drupal configuration
You can say to Drupal to not download translations files by updating your
configuration on the pages:
* `/admin/config/regional/translate/settings`: `Local files only` option
* `/admin/config/media/file-system`: `Interface translations directory` field
or by putting the following lines in your settings.php file:
```php
$config['locale.settings']['translation']['path'] = 'translations/contrib';
$config['locale.settings']['translation']['use_source'] = 'local';
```