714 lines
29 KiB
PHP
714 lines
29 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @file
|
||
|
|
*/
|
||
|
|
|
||
|
|
use Drupal\Core\Batch\BatchBuilder;
|
||
|
|
use Drupal\Core\File\Exception\FileException;
|
||
|
|
use Drupal\Core\Hook\Attribute\ProceduralHookScanStop;
|
||
|
|
use Drupal\Core\Language\LanguageInterface;
|
||
|
|
use Drupal\Core\Url;
|
||
|
|
use Drupal\file\FileInterface;
|
||
|
|
use Drupal\locale\Gettext;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Prepare a batch to import all translations.
|
||
|
|
*
|
||
|
|
* @param array $options
|
||
|
|
* An array with options that can have the following elements:
|
||
|
|
* - 'langcode': The language code. Optional, defaults to NULL, which means
|
||
|
|
* that the language will be detected from the name of the files.
|
||
|
|
* - 'overwrite_options': Overwrite options array as defined in
|
||
|
|
* Drupal\locale\PoDatabaseWriter. Optional, defaults to an empty array.
|
||
|
|
* - 'customized': Flag indicating whether the strings imported from $file
|
||
|
|
* are customized translations or come from a community source. Use
|
||
|
|
* LOCALE_CUSTOMIZED or LOCALE_NOT_CUSTOMIZED. Optional, defaults to
|
||
|
|
* LOCALE_NOT_CUSTOMIZED.
|
||
|
|
* - 'finish_feedback': Whether or not to give feedback to the user when the
|
||
|
|
* batch is finished. Optional, defaults to TRUE.
|
||
|
|
* @param bool $force
|
||
|
|
* (optional) Import all available files, even if they were imported before.
|
||
|
|
*
|
||
|
|
* @return array|bool
|
||
|
|
* The batch structure, or FALSE if no files are used to build the batch.
|
||
|
|
*
|
||
|
|
* @todo Integrate with update status to identify projects needed and integrate
|
||
|
|
* l10n_update functionality to feed in translation files alike.
|
||
|
|
* https://www.drupal.org/node/1191488
|
||
|
|
*/
|
||
|
|
#[ProceduralHookScanStop]
|
||
|
|
function locale_translate_batch_import_files(array $options, $force = FALSE) {
|
||
|
|
$options += [
|
||
|
|
'overwrite_options' => [],
|
||
|
|
'customized' => LOCALE_NOT_CUSTOMIZED,
|
||
|
|
'finish_feedback' => TRUE,
|
||
|
|
];
|
||
|
|
|
||
|
|
if (!empty($options['langcode'])) {
|
||
|
|
$langcodes = [$options['langcode']];
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
// If langcode was not provided, make sure to only import files for the
|
||
|
|
// languages we have added.
|
||
|
|
$langcodes = array_keys(\Drupal::languageManager()->getLanguages());
|
||
|
|
}
|
||
|
|
|
||
|
|
$files = locale_translate_get_interface_translation_files([], $langcodes);
|
||
|
|
|
||
|
|
if (!$force) {
|
||
|
|
$result = \Drupal::database()->select('locale_file', 'lf')
|
||
|
|
->fields('lf', ['langcode', 'uri', 'timestamp'])
|
||
|
|
->condition('langcode', $langcodes)
|
||
|
|
->execute()
|
||
|
|
->fetchAllAssoc('uri');
|
||
|
|
foreach ($result as $uri => $info) {
|
||
|
|
if (isset($files[$uri]) && filemtime($uri) <= $info->timestamp) {
|
||
|
|
// The file is already imported and not changed since the last import.
|
||
|
|
// Remove it from file list and don't import it again.
|
||
|
|
unset($files[$uri]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return locale_translate_batch_build($files, $options);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get interface translation files present in the translations directory.
|
||
|
|
*
|
||
|
|
* @param array $projects
|
||
|
|
* (optional) Project names from which to get the translation files and
|
||
|
|
* history. Defaults to all projects.
|
||
|
|
* @param array $langcodes
|
||
|
|
* (optional) Language codes from which to get the translation files and
|
||
|
|
* history. Defaults to all languages.
|
||
|
|
*
|
||
|
|
* @return array
|
||
|
|
* An array of interface translation files keyed by their URI.
|
||
|
|
*/
|
||
|
|
function locale_translate_get_interface_translation_files(array $projects = [], array $langcodes = []): array {
|
||
|
|
\Drupal::moduleHandler()->loadInclude('locale', 'inc', 'locale.compare');
|
||
|
|
$files = [];
|
||
|
|
$projects = $projects ?: array_keys(locale_translation_get_projects());
|
||
|
|
$langcodes = $langcodes ?: array_keys(locale_translatable_language_list());
|
||
|
|
|
||
|
|
// Scan the translations directory for files matching a name pattern
|
||
|
|
// containing a project name and language code: {project}.{langcode}.po or
|
||
|
|
// {project}-{version}.{langcode}.po.
|
||
|
|
// Only files of known projects and languages will be returned.
|
||
|
|
$directory = \Drupal::config('locale.settings')->get('translation.path');
|
||
|
|
$result = [];
|
||
|
|
if (is_dir($directory)) {
|
||
|
|
$result = \Drupal::service('file_system')->scanDirectory($directory, '![a-z_]+(\-[0-9a-z\.\-\+]+|)\.[^\./]+\.po$!', ['recurse' => FALSE]);
|
||
|
|
}
|
||
|
|
|
||
|
|
foreach ($result as $file) {
|
||
|
|
// Update the file object with project name and version from the file name.
|
||
|
|
$file = locale_translate_file_attach_properties($file);
|
||
|
|
if (in_array($file->project, $projects)) {
|
||
|
|
if (in_array($file->langcode, $langcodes)) {
|
||
|
|
$files[$file->uri] = $file;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return $files;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Build a locale batch from an array of files.
|
||
|
|
*
|
||
|
|
* @param array $files
|
||
|
|
* Array of file objects to import.
|
||
|
|
* @param array $options
|
||
|
|
* An array with options that can have the following elements:
|
||
|
|
* - 'langcode': The language code. Optional, defaults to NULL, which means
|
||
|
|
* that the language will be detected from the name of the files.
|
||
|
|
* - 'overwrite_options': Overwrite options array as defined in
|
||
|
|
* Drupal\locale\PoDatabaseWriter. Optional, defaults to an empty array.
|
||
|
|
* - 'customized': Flag indicating whether the strings imported from $file
|
||
|
|
* are customized translations or come from a community source. Use
|
||
|
|
* LOCALE_CUSTOMIZED or LOCALE_NOT_CUSTOMIZED. Optional, defaults to
|
||
|
|
* LOCALE_NOT_CUSTOMIZED.
|
||
|
|
* - 'finish_feedback': Whether or not to give feedback to the user when the
|
||
|
|
* batch is finished. Optional, defaults to TRUE.
|
||
|
|
*
|
||
|
|
* @return array|bool
|
||
|
|
* A batch structure or FALSE if $files was empty.
|
||
|
|
*/
|
||
|
|
function locale_translate_batch_build(array $files, array $options) {
|
||
|
|
$options += [
|
||
|
|
'overwrite_options' => [],
|
||
|
|
'customized' => LOCALE_NOT_CUSTOMIZED,
|
||
|
|
'finish_feedback' => TRUE,
|
||
|
|
];
|
||
|
|
if (count($files)) {
|
||
|
|
$batch_builder = (new BatchBuilder())
|
||
|
|
->setFile(\Drupal::service('extension.list.module')->getPath('locale') . '/locale.bulk.inc')
|
||
|
|
->setTitle(t('Importing interface translations'))
|
||
|
|
->setErrorMessage(t('Error importing interface translations'));
|
||
|
|
foreach ($files as $file) {
|
||
|
|
// We call locale_translate_batch_import for every batch operation.
|
||
|
|
$batch_builder->addOperation('locale_translate_batch_import', [$file, $options]);
|
||
|
|
}
|
||
|
|
// Save the translation status of all files.
|
||
|
|
$batch_builder->addOperation('locale_translate_batch_import_save', []);
|
||
|
|
|
||
|
|
// Add a final step to refresh JavaScript and configuration strings.
|
||
|
|
$batch_builder->addOperation('locale_translate_batch_refresh', []);
|
||
|
|
|
||
|
|
if ($options['finish_feedback']) {
|
||
|
|
$batch_builder->setFinishCallback('locale_translate_batch_finished');
|
||
|
|
}
|
||
|
|
return $batch_builder->toArray();
|
||
|
|
}
|
||
|
|
return FALSE;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Perform interface translation import.
|
||
|
|
*
|
||
|
|
* @param object $file
|
||
|
|
* A file object of the gettext file to be imported. The file object must
|
||
|
|
* contain a language parameter (other than
|
||
|
|
* LanguageInterface::LANGCODE_NOT_SPECIFIED). This is used as the language of
|
||
|
|
* the import.
|
||
|
|
* @param array $options
|
||
|
|
* An array with options that can have the following elements:
|
||
|
|
* - 'langcode': The language code.
|
||
|
|
* - 'overwrite_options': Overwrite options array as defined in
|
||
|
|
* Drupal\locale\PoDatabaseWriter. Optional, defaults to an empty array.
|
||
|
|
* - 'customized': Flag indicating whether the strings imported from $file
|
||
|
|
* are customized translations or come from a community source. Use
|
||
|
|
* LOCALE_CUSTOMIZED or LOCALE_NOT_CUSTOMIZED. Optional, defaults to
|
||
|
|
* LOCALE_NOT_CUSTOMIZED.
|
||
|
|
* - 'message': Alternative message to display during import. Note, this must
|
||
|
|
* be sanitized text.
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* Contains a list of files imported.
|
||
|
|
*/
|
||
|
|
function locale_translate_batch_import($file, array $options, &$context): void {
|
||
|
|
// Merge the default values in the $options array.
|
||
|
|
$options += [
|
||
|
|
'overwrite_options' => [],
|
||
|
|
'customized' => LOCALE_NOT_CUSTOMIZED,
|
||
|
|
];
|
||
|
|
|
||
|
|
if (isset($file->langcode) && $file->langcode != LanguageInterface::LANGCODE_NOT_SPECIFIED) {
|
||
|
|
|
||
|
|
try {
|
||
|
|
if (empty($context['sandbox'])) {
|
||
|
|
$context['sandbox']['parse_state'] = [
|
||
|
|
'filesize' => filesize(\Drupal::service('file_system')->realpath($file->uri)),
|
||
|
|
'chunk_size' => 200,
|
||
|
|
'seek' => 0,
|
||
|
|
];
|
||
|
|
}
|
||
|
|
// Update the seek and the number of items in the $options array.
|
||
|
|
$options['seek'] = $context['sandbox']['parse_state']['seek'];
|
||
|
|
$options['items'] = $context['sandbox']['parse_state']['chunk_size'];
|
||
|
|
$report = Gettext::fileToDatabase($file, $options);
|
||
|
|
// If not yet finished with reading, mark progress based on size and
|
||
|
|
// position.
|
||
|
|
if ($report['seek'] < filesize($file->uri)) {
|
||
|
|
|
||
|
|
$context['sandbox']['parse_state']['seek'] = $report['seek'];
|
||
|
|
// Maximize the progress bar at 95% before completion, the batch API
|
||
|
|
// could trigger the end of the operation before file reading is done,
|
||
|
|
// because of floating point inaccuracies. See
|
||
|
|
// https://www.drupal.org/node/1089472.
|
||
|
|
$context['finished'] = min(0.95, $report['seek'] / filesize($file->uri));
|
||
|
|
if (isset($options['message'])) {
|
||
|
|
$context['message'] = t('@message (@percent%).', ['@message' => $options['message'], '@percent' => (int) ($context['finished'] * 100)]);
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$context['message'] = t('Importing translation file: %filename (@percent%).', ['%filename' => $file->filename, '@percent' => (int) ($context['finished'] * 100)]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
// We are finished here.
|
||
|
|
$context['finished'] = 1;
|
||
|
|
|
||
|
|
// Store the file data for processing by the next batch operation.
|
||
|
|
$file->timestamp = filemtime($file->uri);
|
||
|
|
$context['results']['files'][$file->uri] = $file;
|
||
|
|
$context['results']['languages'][$file->uri] = $file->langcode;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add the reported values to the statistics for this file.
|
||
|
|
// Each import iteration reports statistics in an array. The results of
|
||
|
|
// each iteration are added and merged here and stored per file.
|
||
|
|
if (!isset($context['results']['stats']) || !isset($context['results']['stats'][$file->uri])) {
|
||
|
|
$context['results']['stats'][$file->uri] = [];
|
||
|
|
}
|
||
|
|
foreach ($report as $key => $value) {
|
||
|
|
if (is_numeric($report[$key])) {
|
||
|
|
if (!isset($context['results']['stats'][$file->uri][$key])) {
|
||
|
|
$context['results']['stats'][$file->uri][$key] = 0;
|
||
|
|
}
|
||
|
|
$context['results']['stats'][$file->uri][$key] += $report[$key];
|
||
|
|
}
|
||
|
|
elseif (is_array($value)) {
|
||
|
|
$context['results']['stats'][$file->uri] += [$key => []];
|
||
|
|
$context['results']['stats'][$file->uri][$key] = array_merge($context['results']['stats'][$file->uri][$key], $value);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
catch (Exception) {
|
||
|
|
// Import failed. Store the data of the failing file.
|
||
|
|
$context['results']['failed_files'][] = $file;
|
||
|
|
\Drupal::logger('locale')->notice('Unable to import translations file: @file', ['@file' => $file->uri]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Save data of imported files.
|
||
|
|
*
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* Contains a list of imported files.
|
||
|
|
*/
|
||
|
|
function locale_translate_batch_import_save($context): void {
|
||
|
|
if (isset($context['results']['files'])) {
|
||
|
|
$request_time = \Drupal::time()->getRequestTime();
|
||
|
|
foreach ($context['results']['files'] as $file) {
|
||
|
|
// Update the file history if both project and version are known. This
|
||
|
|
// table is used by the automated translation update function which tracks
|
||
|
|
// translation status of module and themes in the system. Other
|
||
|
|
// translation files are not tracked and are therefore not stored in this
|
||
|
|
// table.
|
||
|
|
if ($file->project && $file->version) {
|
||
|
|
$file->last_checked = $request_time;
|
||
|
|
locale_translation_update_file_history($file);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
$context['message'] = t('Translations imported.');
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Refreshes translations after importing strings.
|
||
|
|
*
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* Contains a list of strings updated and information about the progress.
|
||
|
|
*/
|
||
|
|
function locale_translate_batch_refresh(&$context): void {
|
||
|
|
if (!isset($context['sandbox']['refresh'])) {
|
||
|
|
$strings = $langcodes = [];
|
||
|
|
if (isset($context['results']['stats'])) {
|
||
|
|
// Get list of unique string identifiers and language codes updated.
|
||
|
|
$langcodes = array_unique(array_values($context['results']['languages']));
|
||
|
|
foreach ($context['results']['stats'] as $report) {
|
||
|
|
$strings[] = $report['strings'];
|
||
|
|
}
|
||
|
|
$strings = array_merge(...$strings);
|
||
|
|
}
|
||
|
|
if ($strings) {
|
||
|
|
// Initialize multi-step string refresh.
|
||
|
|
$context['message'] = t('Updating translations for JavaScript and default configuration.');
|
||
|
|
$context['sandbox']['refresh']['strings'] = array_unique($strings);
|
||
|
|
$context['sandbox']['refresh']['languages'] = $langcodes;
|
||
|
|
$context['sandbox']['refresh']['names'] = [];
|
||
|
|
$context['results']['stats']['config'] = 0;
|
||
|
|
$context['sandbox']['refresh']['count'] = count($strings);
|
||
|
|
|
||
|
|
// We will update strings on later steps.
|
||
|
|
$context['finished'] = 0;
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$context['finished'] = 1;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
elseif ($name = array_shift($context['sandbox']['refresh']['names'])) {
|
||
|
|
// Refresh all languages for one object at a time.
|
||
|
|
$count = \Drupal::service('locale.config_manager')
|
||
|
|
->updateConfigTranslations([$name], $context['sandbox']['refresh']['languages']);
|
||
|
|
$context['results']['stats']['config'] += $count;
|
||
|
|
// Inherit finished information from the "parent" string lookup step so
|
||
|
|
// visual display of status will make sense.
|
||
|
|
$context['finished'] = $context['sandbox']['refresh']['names_finished'];
|
||
|
|
$context['message'] = t('Updating default configuration (@percent%).', ['@percent' => (int) ($context['finished'] * 100)]);
|
||
|
|
}
|
||
|
|
elseif (!empty($context['sandbox']['refresh']['strings'])) {
|
||
|
|
// Not perfect but will give some indication of progress.
|
||
|
|
$context['finished'] = 1 - count($context['sandbox']['refresh']['strings']) / $context['sandbox']['refresh']['count'];
|
||
|
|
// Pending strings, refresh 100 at a time, get next pack.
|
||
|
|
$next = array_slice($context['sandbox']['refresh']['strings'], 0, 100);
|
||
|
|
array_splice($context['sandbox']['refresh']['strings'], 0, count($next));
|
||
|
|
// Clear cache and force refresh of JavaScript translations.
|
||
|
|
_locale_refresh_translations($context['sandbox']['refresh']['languages'], $next);
|
||
|
|
// Check whether we need to refresh configuration objects.
|
||
|
|
if ($names = \Drupal::service('locale.config_manager')
|
||
|
|
->getStringNames($next)) {
|
||
|
|
$context['sandbox']['refresh']['names_finished'] = $context['finished'];
|
||
|
|
$context['sandbox']['refresh']['names'] = $names;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$context['message'] = t('Updated default configuration.');
|
||
|
|
$context['finished'] = 1;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_finished().
|
||
|
|
*
|
||
|
|
* Finished callback of system page locale import batch.
|
||
|
|
*
|
||
|
|
* @param bool $success
|
||
|
|
* TRUE if batch successfully completed.
|
||
|
|
* @param array $results
|
||
|
|
* Batch results.
|
||
|
|
*/
|
||
|
|
function locale_translate_batch_finished($success, array $results): void {
|
||
|
|
$logger = \Drupal::logger('locale');
|
||
|
|
if ($success) {
|
||
|
|
$additions = $updates = $deletes = $skips = 0;
|
||
|
|
if (isset($results['failed_files'])) {
|
||
|
|
if (\Drupal::moduleHandler()->moduleExists('dblog') && \Drupal::currentUser()->hasPermission('access site reports')) {
|
||
|
|
$message = \Drupal::translation()->formatPlural(count($results['failed_files']), 'One translation file could not be imported. <a href=":url">See the log</a> for details.', '@count translation files could not be imported. <a href=":url">See the log</a> for details.', [':url' => Url::fromRoute('dblog.overview')->toString()]);
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$message = \Drupal::translation()->formatPlural(count($results['failed_files']), 'One translation file could not be imported. See the log for details.', '@count translation files could not be imported. See the log for details.');
|
||
|
|
}
|
||
|
|
\Drupal::messenger()->addError($message);
|
||
|
|
}
|
||
|
|
if (isset($results['files'])) {
|
||
|
|
$skipped_files = [];
|
||
|
|
// If there are no results and/or no stats (eg. coping with an empty .po
|
||
|
|
// file), simply do nothing.
|
||
|
|
if ($results && isset($results['stats'])) {
|
||
|
|
foreach ($results['stats'] as $filepath => $report) {
|
||
|
|
if ($filepath === 'config') {
|
||
|
|
// Ignore the config entry. It is processed in
|
||
|
|
// locale_config_batch_finished() below.
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
$additions += $report['additions'];
|
||
|
|
$updates += $report['updates'];
|
||
|
|
$deletes += $report['deletes'];
|
||
|
|
$skips += $report['skips'];
|
||
|
|
if ($report['skips'] > 0) {
|
||
|
|
$skipped_files[] = $filepath;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
\Drupal::messenger()->addStatus(\Drupal::translation()->formatPlural(count($results['files']),
|
||
|
|
'One translation file imported. %number translations were added, %update translations were updated and %delete translations were removed.',
|
||
|
|
'@count translation files imported. %number translations were added, %update translations were updated and %delete translations were removed.',
|
||
|
|
['%number' => $additions, '%update' => $updates, '%delete' => $deletes]
|
||
|
|
));
|
||
|
|
$logger->notice('Translations imported: %number added, %update updated, %delete removed.', ['%number' => $additions, '%update' => $updates, '%delete' => $deletes]);
|
||
|
|
|
||
|
|
if ($skips) {
|
||
|
|
if (\Drupal::moduleHandler()->moduleExists('dblog') && \Drupal::currentUser()->hasPermission('access site reports')) {
|
||
|
|
$message = \Drupal::translation()->formatPlural($skips, 'One translation string was skipped because of disallowed or malformed HTML. <a href=":url">See the log</a> for details.', '@count translation strings were skipped because of disallowed or malformed HTML. <a href=":url">See the log</a> for details.', [':url' => Url::fromRoute('dblog.overview')->toString()]);
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$message = \Drupal::translation()->formatPlural($skips, 'One translation string was skipped because of disallowed or malformed HTML. See the log for details.', '@count translation strings were skipped because of disallowed or malformed HTML. See the log for details.');
|
||
|
|
}
|
||
|
|
\Drupal::messenger()->addWarning($message);
|
||
|
|
$logger->warning('@count disallowed HTML string(s) in files: @files.', ['@count' => $skips, '@files' => implode(',', $skipped_files)]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
// Add messages for configuration too.
|
||
|
|
if (isset($results['stats']['config'])) {
|
||
|
|
locale_config_batch_finished($success, $results);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates a file object and populates the timestamp property.
|
||
|
|
*
|
||
|
|
* @param string $filepath
|
||
|
|
* The filepath of a file to import.
|
||
|
|
*
|
||
|
|
* @return object
|
||
|
|
* An object representing the file.
|
||
|
|
*/
|
||
|
|
function locale_translate_file_create($filepath) {
|
||
|
|
$file = new stdClass();
|
||
|
|
$file->filename = \Drupal::service('file_system')->basename($filepath);
|
||
|
|
$file->uri = $filepath;
|
||
|
|
$file->timestamp = filemtime($file->uri);
|
||
|
|
return $file;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Generates file properties from filename and options.
|
||
|
|
*
|
||
|
|
* An attempt is made to determine the translation language, project name and
|
||
|
|
* project version from the file name. Supported file name patterns are:
|
||
|
|
* {project}-{version}.{langcode}.po, {prefix}.{langcode}.po or {langcode}.po.
|
||
|
|
* Alternatively the translation language can be set using the $options.
|
||
|
|
*
|
||
|
|
* @param object $file
|
||
|
|
* A file object of the gettext file to be imported.
|
||
|
|
* @param array $options
|
||
|
|
* An array with options:
|
||
|
|
* - 'langcode': The language code. Overrides the file language.
|
||
|
|
*
|
||
|
|
* @return object
|
||
|
|
* Modified file object.
|
||
|
|
*/
|
||
|
|
function locale_translate_file_attach_properties($file, array $options = []) {
|
||
|
|
// If $file is a file entity, convert it to a stdClass.
|
||
|
|
if ($file instanceof FileInterface) {
|
||
|
|
$file = (object) [
|
||
|
|
'filename' => $file->getFilename(),
|
||
|
|
'uri' => $file->getFileUri(),
|
||
|
|
];
|
||
|
|
}
|
||
|
|
|
||
|
|
// Extract project, version and language code from the file name. Supported:
|
||
|
|
// {project}-{version}.{langcode}.po, {prefix}.{langcode}.po or {langcode}.po
|
||
|
|
preg_match('!
|
||
|
|
( # project OR project and version OR empty (group 1)
|
||
|
|
([a-z_]+) # project name (group 2)
|
||
|
|
\. # .
|
||
|
|
| # OR
|
||
|
|
([a-z_]+) # project name (group 3)
|
||
|
|
\- # -
|
||
|
|
([0-9a-z\.\-\+]+) # version (group 4)
|
||
|
|
\. # .
|
||
|
|
| # OR
|
||
|
|
) # (empty)
|
||
|
|
([^\./]+) # language code (group 5)
|
||
|
|
\. # .
|
||
|
|
po # po extension
|
||
|
|
$!x', $file->filename, $matches);
|
||
|
|
if (isset($matches[5])) {
|
||
|
|
$file->project = $matches[2] . $matches[3];
|
||
|
|
$file->version = $matches[4];
|
||
|
|
$file->langcode = $options['langcode'] ?? $matches[5];
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
$file->langcode = LanguageInterface::LANGCODE_NOT_SPECIFIED;
|
||
|
|
}
|
||
|
|
return $file;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Deletes interface translation files and translation history records.
|
||
|
|
*
|
||
|
|
* @param array $projects
|
||
|
|
* (optional) Project names from which to delete the translation files and
|
||
|
|
* history. Defaults to all projects.
|
||
|
|
* @param array $langcodes
|
||
|
|
* (optional) Language codes from which to delete the translation files and
|
||
|
|
* history. Defaults to all languages.
|
||
|
|
*
|
||
|
|
* @return bool
|
||
|
|
* TRUE if files are removed successfully. FALSE if one or more files could
|
||
|
|
* not be deleted.
|
||
|
|
*/
|
||
|
|
function locale_translate_delete_translation_files(array $projects = [], array $langcodes = []) {
|
||
|
|
$fail = FALSE;
|
||
|
|
locale_translation_file_history_delete($projects, $langcodes);
|
||
|
|
|
||
|
|
// Delete all translation files from the translations directory.
|
||
|
|
if ($files = locale_translate_get_interface_translation_files($projects, $langcodes)) {
|
||
|
|
foreach ($files as $file) {
|
||
|
|
try {
|
||
|
|
\Drupal::service('file_system')->delete($file->uri);
|
||
|
|
}
|
||
|
|
catch (FileException) {
|
||
|
|
$fail = TRUE;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return !$fail;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Builds a locale batch to refresh configuration.
|
||
|
|
*
|
||
|
|
* @param array $options
|
||
|
|
* An array with options that can have the following elements:
|
||
|
|
* - 'finish_feedback': (optional) Whether or not to give feedback to the user
|
||
|
|
* when the batch is finished. Defaults to TRUE.
|
||
|
|
* @param array $langcodes
|
||
|
|
* (optional) Array of language codes. Defaults to all translatable languages.
|
||
|
|
* @param array $components
|
||
|
|
* (optional) Array of component lists indexed by type. If not present or it
|
||
|
|
* is an empty array, it will update all components.
|
||
|
|
* @param bool $update_default_config_langcodes
|
||
|
|
* Determines whether default configuration langcodes should be updated. This
|
||
|
|
* Should only happen during site and extension install.
|
||
|
|
*
|
||
|
|
* @return array
|
||
|
|
* The batch definition.
|
||
|
|
*/
|
||
|
|
function locale_config_batch_update_components(array $options, array $langcodes = [], array $components = [], bool $update_default_config_langcodes = FALSE) {
|
||
|
|
$langcodes = $langcodes ?: array_keys(\Drupal::languageManager()->getLanguages());
|
||
|
|
if ($langcodes && $names = \Drupal::service('locale.config_manager')->getComponentNames($components)) {
|
||
|
|
// If the component list is empty we need to ensure that all configuration
|
||
|
|
// in the default collection is using the site's default langcode.
|
||
|
|
return locale_config_batch_build($names, $langcodes, $options, $update_default_config_langcodes);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates a locale batch to refresh specific configuration.
|
||
|
|
*
|
||
|
|
* @param array $names
|
||
|
|
* List of configuration object names (which are strings) to update.
|
||
|
|
* @param array $langcodes
|
||
|
|
* List of language codes to refresh.
|
||
|
|
* @param array $options
|
||
|
|
* (optional) An array with options that can have the following elements:
|
||
|
|
* - 'finish_feedback': Whether or not to give feedback to the user when the
|
||
|
|
* batch is finished. Defaults to TRUE.
|
||
|
|
* @param bool $update_default_config_langcodes
|
||
|
|
* Determines whether default configuration langcodes should be updated. This
|
||
|
|
* Should only happen during site and extension install.
|
||
|
|
*
|
||
|
|
* @return array
|
||
|
|
* The batch definition.
|
||
|
|
*
|
||
|
|
* @see locale_config_batch_update_config_translations()
|
||
|
|
*/
|
||
|
|
function locale_config_batch_build(array $names, array $langcodes, array $options = [], bool $update_default_config_langcodes = FALSE) {
|
||
|
|
$options += ['finish_feedback' => TRUE];
|
||
|
|
$batch_builder = (new BatchBuilder())
|
||
|
|
->setFile(\Drupal::service('extension.list.module')->getPath('locale') . '/locale.bulk.inc')
|
||
|
|
->setTitle(t('Updating configuration translations'))
|
||
|
|
->setInitMessage(t('Starting configuration update'))
|
||
|
|
->setErrorMessage(t('Error updating configuration translations'));
|
||
|
|
|
||
|
|
if ($update_default_config_langcodes && \Drupal::languageManager()->getDefaultLanguage()->getId() !== 'en') {
|
||
|
|
$batch_builder->addOperation('locale_config_batch_update_default_config_langcodes');
|
||
|
|
}
|
||
|
|
|
||
|
|
// Chunking the array of names into batches of 20 for better performance.
|
||
|
|
$name_chunks = array_chunk($names, 20);
|
||
|
|
|
||
|
|
foreach ($name_chunks as $chunk) {
|
||
|
|
// During installation the caching of configuration objects is disabled so
|
||
|
|
// it is very expensive to initialize the \Drupal::config() object on each
|
||
|
|
// request. We batch a small number of configuration object upgrades
|
||
|
|
// together to improve the overall performance of the process.
|
||
|
|
$batch_builder->addOperation('locale_config_batch_update_config_translations', [$chunk, $langcodes]);
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!empty($options['finish_feedback'])) {
|
||
|
|
$batch_builder->setFinishCallback('locale_config_batch_finished');
|
||
|
|
}
|
||
|
|
return $batch_builder->toArray();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Updates default configuration when new modules or themes are installed.
|
||
|
|
*
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* The batch context.
|
||
|
|
*/
|
||
|
|
function locale_config_batch_update_default_config_langcodes(&$context): void {
|
||
|
|
\Drupal::service('locale.config_manager')->updateDefaultConfigLangcodes();
|
||
|
|
$context['finished'] = 1;
|
||
|
|
$context['message'] = t('Updated default configuration to %langcode', ['%langcode' => \Drupal::languageManager()->getDefaultLanguage()->getId()]);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Updates default configuration when new modules or themes are installed.
|
||
|
|
*
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* The batch context.
|
||
|
|
*
|
||
|
|
* @deprecated in drupal:11.1.0 and is removed from drupal:12.0.0. Use
|
||
|
|
* locale_config_batch_update_default_config_langcodes(&$context) instead.
|
||
|
|
*
|
||
|
|
* @see https://www.drupal.org/node/3475054
|
||
|
|
*/
|
||
|
|
function locale_config_batch_set_config_langcodes(&$context): void {
|
||
|
|
@trigger_error(__METHOD__ . '() is deprecated in drupal:11.1.0 and is removed from drupal:12.0.0. Use locale_config_batch_update_default_config_langcodes() instead. See https://www.drupal.org/node/3475054', E_USER_DEPRECATED);
|
||
|
|
locale_config_batch_update_default_config_langcodes($context);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Performs configuration translation refresh.
|
||
|
|
*
|
||
|
|
* @param array $names
|
||
|
|
* An array of names of configuration objects to update.
|
||
|
|
* @param array $langcodes
|
||
|
|
* (optional) Array of language codes to update. Defaults to all languages.
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* Contains a list of files imported.
|
||
|
|
*
|
||
|
|
* @see locale_config_batch_build()
|
||
|
|
*/
|
||
|
|
function locale_config_batch_update_config_translations(array $names, array $langcodes, &$context): void {
|
||
|
|
if (!isset($context['results']['stats']['config'])) {
|
||
|
|
$context['results']['stats']['config'] = 0;
|
||
|
|
}
|
||
|
|
$context['results']['stats']['config'] += \Drupal::service('locale.config_manager')
|
||
|
|
->updateConfigTranslations($names, $langcodes);
|
||
|
|
foreach ($names as $name) {
|
||
|
|
$context['results']['names'][] = $name;
|
||
|
|
}
|
||
|
|
$context['results']['langcodes'] = $langcodes;
|
||
|
|
$context['finished'] = 1;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_operation().
|
||
|
|
*
|
||
|
|
* Performs configuration translation refresh.
|
||
|
|
*
|
||
|
|
* @param array $names
|
||
|
|
* An array of names of configuration objects to update.
|
||
|
|
* @param array $langcodes
|
||
|
|
* (optional) Array of language codes to update. Defaults to all languages.
|
||
|
|
* @param array|\ArrayAccess $context
|
||
|
|
* Contains a list of files imported.
|
||
|
|
*
|
||
|
|
* @deprecated in drupal:11.1.0 and is removed from drupal:12.0.0. Use
|
||
|
|
* locale_config_batch_update_config_translations($names, $langcodes, $context)
|
||
|
|
* instead.
|
||
|
|
*
|
||
|
|
* @see https://www.drupal.org/node/3475054
|
||
|
|
*/
|
||
|
|
function locale_config_batch_refresh_name(array $names, array $langcodes, &$context): void {
|
||
|
|
@trigger_error(__METHOD__ . '() is deprecated in drupal:11.1.0 and is removed from drupal:12.0.0. Use locale_config_batch_update_config_translations() instead. See https://www.drupal.org/node/3475054', E_USER_DEPRECATED);
|
||
|
|
locale_config_batch_update_config_translations($names, $langcodes, $context);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Implements callback_batch_finished().
|
||
|
|
*
|
||
|
|
* Finishes callback of system page locale import batch.
|
||
|
|
*
|
||
|
|
* @param bool $success
|
||
|
|
* Information about the success of the batch import.
|
||
|
|
* @param array $results
|
||
|
|
* Information about the results of the batch import.
|
||
|
|
*
|
||
|
|
* @see locale_config_batch_build()
|
||
|
|
*/
|
||
|
|
function locale_config_batch_finished($success, array $results): void {
|
||
|
|
if ($success) {
|
||
|
|
$configuration = $results['stats']['config'] ?? 0;
|
||
|
|
if ($configuration) {
|
||
|
|
\Drupal::messenger()->addStatus(t('The configuration was successfully updated. There are %number configuration objects updated.', ['%number' => $configuration]));
|
||
|
|
\Drupal::logger('locale')->notice('The configuration was successfully updated. %number configuration objects updated.', ['%number' => $configuration]);
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
\Drupal::messenger()->addStatus(t('No configuration objects have been updated.'));
|
||
|
|
\Drupal::logger('locale')->warning('No configuration objects have been updated.');
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|