diff core/modules/locale/locale.fetch.inc @ 0:c75dbcec494b

Initial commit from drush-created site

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/core/modules/locale/locale.fetch.inc	Thu Jul 05 14:24:15 2018 +0000
@@ -0,0 +1,108 @@
+<?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;
+}