config.admin.inc

Admin page callbacks for the config module.

File

drupal/core/modules/config/config.admin.inc
View source
<?php

/**
 * @file
 * Admin page callbacks for the config module.
 */
use Drupal\Core\Config\StorageInterface;

/**
 * Helper function to construct the storage changes in a configuration synchronization form.
 *
 * @param array $form
 *   The form structure to add to. Passed by reference.
 * @param array $form_state
 *   The current state of the form. Passed by reference.
 * @param Drupal\Core\Config\StorageInterface $source_storage
 *   The source storage to retrieve differences from.
 * @param Drupal\Core\Config\StorageInterface $target_storage
 *   The target storage to compare differences to.
 */
function config_admin_sync_form(array &$form, array &$form_state, StorageInterface $source_storage, StorageInterface $target_storage) {
  $source_list = $source_storage
    ->listAll();
  if (empty($source_list)) {
    $form['no_changes'] = array(
      '#markup' => t('There is no configuration to import.'),
    );
    return $form;
  }
  $config_changes = config_sync_get_changes($source_storage, $target_storage);
  if (empty($config_changes)) {
    $form['no_changes'] = array(
      '#markup' => t('There are no configuration changes.'),
    );
    return $form;
  }
  foreach ($config_changes as $config_change_type => $config_files) {
    if (empty($config_files)) {
      continue;
    }

    // @todo A table caption would be more appropriate, but does not have the
    //   visual importance of a heading.
    $form[$config_change_type]['heading'] = array(
      '#theme' => 'html_tag__h3',
      '#tag' => 'h3',
    );
    switch ($config_change_type) {
      case 'create':
        $form[$config_change_type]['heading']['#value'] = format_plural(count($config_files), '@count new', '@count new');
        break;
      case 'change':
        $form[$config_change_type]['heading']['#value'] = format_plural(count($config_files), '@count changed', '@count changed');
        break;
      case 'delete':
        $form[$config_change_type]['heading']['#value'] = format_plural(count($config_files), '@count removed', '@count removed');
        break;
    }
    $form[$config_change_type]['list'] = array(
      '#theme' => 'table',
      '#header' => array(
        'Name',
      ),
    );
    foreach ($config_files as $config_file) {
      $form[$config_change_type]['list']['#rows'][] = array(
        $config_file,
      );
    }
  }
}

/**
 * Form constructor for configuration import form.
 *
 * @see config_admin_import_form_submit()
 * @see config_import()
 */
function config_admin_import_form($form, &$form_state) {

  // Retrieve a list of differences between last known state and active store.
  $source_storage = drupal_container()
    ->get('config.storage.staging');
  $target_storage = drupal_container()
    ->get('config.storage');
  config_admin_sync_form($form, $form_state, $source_storage, $target_storage);
  $form['actions'] = array(
    '#type' => 'actions',
  );
  $form['actions']['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Import all'),
  );
  return $form;
}

/**
 * Form submission handler for config_admin_import_form().
 */
function config_admin_import_form_submit($form, &$form_state) {
  if (!lock()
    ->lockMayBeAvailable(CONFIG_IMPORT_LOCK)) {
    drupal_set_message(t('Another request may be synchronizing configuration already.'));
  }
  else {
    if (config_import()) {

      // Once a sync completes, we empty the staging directory. This prevents
      // changes from being accidentally overwritten by stray files getting
      // imported later.
      $source_storage = drupal_container()
        ->get('config.storage.staging');
      foreach ($source_storage
        ->listAll() as $name) {
        $source_storage
          ->delete($name);
      }
      drupal_flush_all_caches();
      drupal_set_message(t('The configuration was imported successfully.'));
    }
    else {
      drupal_set_message(t('The import failed due to an error. Any errors have been logged.'), 'error');
    }
  }
}

Functions

Namesort descending Description
config_admin_import_form Form constructor for configuration import form.
config_admin_import_form_submit Form submission handler for config_admin_import_form().
config_admin_sync_form Helper function to construct the storage changes in a configuration synchronization form.