function locale_config_batch_build

Same name in other branches
  1. 8.9.x core/modules/locale/locale.bulk.inc \locale_config_batch_build()
  2. 10 core/modules/locale/locale.bulk.inc \locale_config_batch_build()
  3. 11.x core/modules/locale/locale.bulk.inc \locale_config_batch_build()

Creates a locale batch to refresh specific configuration.

Parameters

array $names: List of configuration object names (which are strings) to update.

array $langcodes: List of language codes to refresh.

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.

bool $update_default_config_langcodes: Determines whether default configuration langcodes should be updated. This Should only happen during site and extension install.

Return value

array The batch definition.

See also

locale_config_batch_refresh_name()

1 call to locale_config_batch_build()
locale_config_batch_update_components in core/modules/locale/locale.bulk.inc
Builds a locale batch to refresh configuration.

File

core/modules/locale/locale.bulk.inc, line 577

Code

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_set_config_langcodes');
    }
    $i = 0;
    $batch_names = [];
    foreach ($names as $name) {
        $batch_names[] = $name;
        $i++;
        // 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.
        if ($i % 20 == 0) {
            $batch_builder->addOperation('locale_config_batch_refresh_name', [
                $batch_names,
                $langcodes,
            ]);
            $batch_names = [];
        }
    }
    if (!empty($batch_names)) {
        $batch_builder->addOperation('locale_config_batch_refresh_name', [
            $batch_names,
            $langcodes,
        ]);
    }
    if (!empty($options['finish_feedback'])) {
        $batch_builder->setFinishCallback('locale_config_batch_finished');
    }
    return $batch_builder->toArray();
}

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