109 lines
3.8 KiB
PHP
109 lines
3.8 KiB
PHP
<?php
|
|
|
|
/**
|
|
* @file
|
|
* The API for download and import of translations from remote and local sources.
|
|
*/
|
|
|
|
/**
|
|
* Load the common translation API.
|
|
*/
|
|
// @todo Combine functions differently in files to avoid unnecessary includes.
|
|
// Follow-up issue: https://www.drupal.org/node/1834298.
|
|
require_once __DIR__ . '/locale.translation.inc';
|
|
|
|
/**
|
|
* Builds a batch to check, download and import project translations.
|
|
*
|
|
* @param array $projects
|
|
* Array of project names for which to update the translations. Defaults to
|
|
* all translatable projects.
|
|
* @param array $langcodes
|
|
* Array of language codes. Defaults to all translatable languages.
|
|
* @param array $options
|
|
* Array of import options. See locale_translate_batch_import_files().
|
|
*
|
|
* @return array
|
|
* Batch definition array.
|
|
*/
|
|
function locale_translation_batch_update_build($projects = [], $langcodes = [], $options = []) {
|
|
module_load_include('compare.inc', 'locale');
|
|
$projects = $projects ? $projects : array_keys(locale_translation_get_projects());
|
|
$langcodes = $langcodes ? $langcodes : array_keys(locale_translatable_language_list());
|
|
$status_options = $options;
|
|
$status_options['finish_feedback'] = FALSE;
|
|
|
|
// Check status of local and remote translation files.
|
|
$operations = _locale_translation_batch_status_operations($projects, $langcodes, $status_options);
|
|
// Download and import translations.
|
|
$operations = array_merge($operations, _locale_translation_fetch_operations($projects, $langcodes, $options));
|
|
|
|
$batch = [
|
|
'operations' => $operations,
|
|
'title' => t('Updating translations'),
|
|
'progress_message' => '',
|
|
'error_message' => t('Error importing translation files'),
|
|
'finished' => 'locale_translation_batch_fetch_finished',
|
|
'file' => drupal_get_path('module', 'locale') . '/locale.batch.inc',
|
|
];
|
|
return $batch;
|
|
}
|
|
|
|
/**
|
|
* Builds a batch to download and import project translations.
|
|
*
|
|
* @param array $projects
|
|
* Array of project names for which to check the state of translation files.
|
|
* Defaults to all translatable projects.
|
|
* @param array $langcodes
|
|
* Array of language codes. Defaults to all translatable languages.
|
|
* @param array $options
|
|
* Array of import options. See locale_translate_batch_import_files().
|
|
*
|
|
* @return array
|
|
* Batch definition array.
|
|
*/
|
|
function locale_translation_batch_fetch_build($projects = [], $langcodes = [], $options = []) {
|
|
$projects = $projects ? $projects : array_keys(locale_translation_get_projects());
|
|
$langcodes = $langcodes ? $langcodes : array_keys(locale_translatable_language_list());
|
|
|
|
$batch = [
|
|
'operations' => _locale_translation_fetch_operations($projects, $langcodes, $options),
|
|
'title' => t('Updating translations.'),
|
|
'progress_message' => '',
|
|
'error_message' => t('Error importing translation files'),
|
|
'finished' => 'locale_translation_batch_fetch_finished',
|
|
'file' => drupal_get_path('module', 'locale') . '/locale.batch.inc',
|
|
];
|
|
return $batch;
|
|
}
|
|
|
|
/**
|
|
* Helper function to construct the batch operations to fetch translations.
|
|
*
|
|
* @param array $projects
|
|
* Array of project names for which to check the state of translation files.
|
|
* Defaults to all translatable projects.
|
|
* @param array $langcodes
|
|
* Array of language codes. Defaults to all translatable languages.
|
|
* @param array $options
|
|
* Array of import options.
|
|
*
|
|
* @return array
|
|
* Array of batch operations.
|
|
*/
|
|
function _locale_translation_fetch_operations($projects, $langcodes, $options) {
|
|
$operations = [];
|
|
|
|
foreach ($projects as $project) {
|
|
foreach ($langcodes as $langcode) {
|
|
if (locale_translation_use_remote_source()) {
|
|
$operations[] = ['locale_translation_batch_fetch_download', [$project, $langcode]];
|
|
}
|
|
$operations[] = ['locale_translation_batch_fetch_import', [$project, $langcode, $options]];
|
|
}
|
|
}
|
|
|
|
return $operations;
|
|
}
|