locale.fetch.inc

Same filename in other branches
  1. 9 core/modules/locale/locale.fetch.inc
  2. 10 core/modules/locale/locale.fetch.inc
  3. 11.x core/modules/locale/locale.fetch.inc

The API for download and import of translations from remote and local sources.

File

core/modules/locale/locale.fetch.inc

View source
<?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;
}

Functions

Title Deprecated Summary
locale_translation_batch_fetch_build Builds a batch to download and import project translations.
locale_translation_batch_update_build Builds a batch to check, download and import project translations.
_locale_translation_fetch_operations Helper function to construct the batch operations to fetch translations.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.