Change record status: 
Project: 
Introduced in branch: 
8.x
Introduced in version: 
8.x-dev
Description: 

Now that we have a new configuration management system in Drupal, it's important to extend the benefits of that system to Drupal distribution developers. We also need ensure that distributions can be used to install drupal with automated tools.

API changes

  1. The optional 'exclusive' (Boolean) flag and the optional 'distribution_name' property in installation profile .info.yml files have been replaced with the 'distribution' property:

    Drupal 7

    distribution_name = Commerce Kickstart
    exclusive = 1
    

    Drupal 8

    distribution:
      name: Commerce Kickstart
    

    Note: The install.php?profile= URL query parameter can still be used to manually override the automatically preselected installation profile.

  2. The behavior of the installer when multiple exclusive/distribution profiles are discovered has been changed:

    • In Drupal 7, if the installer discovered multiple 'exclusive' profiles, then no profile was preselected.
    • In Drupal 8, if the installer discovers multiple 'distribution' profiles, then the first discovered is preselected and others are ignored.
  3. Distribution installation profiles are now able to override further aspects of the installer environment:

    distribution:
      name: Commerce Kickstart
      install:
        # Theme to use in the installer.
        theme: commerce_kickstart_admin
    
  4. Distribution installation profiles now fully participate in the entire early installer environment (as if they would be a regular module).

    This means that the installation profile can implement any kind of module hook.

Impacts: 
Site builders, administrators, editors
Module developers