CONFIGURING ALL CONFIGURING ALL THE THINGS! THE THINGS! By Oliver Davies (@opdavies)

CONFIGURATION MANAGEMENT CONFIGURATION MANAGEMENT DRUPAL 8 DRUPAL 8

Web Developer, System Administrator Senior Developer at Microserve Part-time freelancer Acquia certified Drupal 8 Grand Master Drupal 7 and 8 core contributor @opdavies www.oliverdavies.uk

WHAT IS WHAT IS CONFIGURATION? CONFIGURATION?

WHAT IS CONFIGURATION? WHAT IS CONFIGURATION? Site settings (site name, front page path) Content types URL alias patterns API keys Date formats Which modules are enabled Block placements Field configuration and storage Paragraphs Image styles Taxonomy vocabularies User roles and permissions Views

THE CONFIGURATION MANAGEMENT THE CONFIGURATION MANAGEMENT INITIATIVE INITIATIVE

No content

FEATURES FEATURES IN CORE IN CORE

FEATURES FEATURES IN CORE IN CORE

USING USING CONFIGURATION CONFIGURATION

get('page.front');

config = $config_factory->get('system.site'); } public function index() { $result = $this->config->get('page.front'); ... } }

IMPORTING AND EXPORTING IMPORTING AND EXPORTING CONFIGURATION CONFIGURATION

No content

No content

No content

No content

$ drush config-export $ drush config-import

$ drush config:export $ drush config:import

$ drupal config:export $ drupal config:export:single $ drupal config:import

DEMO DEMO

OVERRIDING OVERRIDING CONFIGURATION CONFIGURATION

SPLITTING SPLITTING CONFIGURATION CONFIGURATION

DGO.TO/ DGO.TO/CONFIG_SPLIT CONFIG_SPLIT

CONFIGURATION SPLIT CONFIGURATION SPLIT Different configuration directories One per 'split' Configuration per environment Active split set in settings.php

No content

No content

IGNORING IGNORING CONFIGURATION CONFIGURATION

DGO.TO/ DGO.TO/CONFIG_IGNORE CONFIG_IGNORE

No content

ADDING CONFIGURATION TO YOUR ADDING CONFIGURATION TO YOUR CUSTOM MODULES CUSTOM MODULES

# config/install/override_node_options.settings.yml general_permissions: true specific_permissions: true

# config/schema/override_node_options.schema.yml override_node_options.settings: type: config_object label: 'Override Node Options settings' mapping: general_permissions: type: boolean label: 'Use general permissions.' specific_permissions: type: boolean label: 'Use content type specific permissions.'

// src/Form/SettingsForm.php class SettingsForm extends ConfigFormBase { ... public function buildForm(array $form, FormStateInterface $form_state) { $form = parent::buildForm($form, $form_state); $config = $this->config('override_node_options.settings'); $form['general_permissions'] = [ '#type' => 'checkbox', '#title' => $this->t('General permissions, across all node types'), '#default_value' => $config->get('general_permissions'), ]; $form['specific_permissions'] = [ '#type' => 'checkbox', '#title' => $this->t('Specific permissions, for each individual node type'), '#default_value' => $config->get('specific_permissions'), ]; return $form; } ... }

// src/Form/SettingsForm.php class SettingsForm extends ConfigFormBase { ... public function submitForm(array &$form, FormStateInterface $form_state) { parent::submitForm($form, $form_state); $this->config('override_node_options.settings') ->set('general_permissions', $form_state->getValue('general_permissions')) ->set('specific_permissions', $form_state->getValue('specific_permissions')) ->save(TRUE); } }

// src/NodePermissions.php class NodePermissions { ... public function nodeTypePermissions() { $permissions = []; $config = \Drupal::config('override_node_options.settings'); if ($config->get('general_permissions')) { $this->addGeneralPermissions($permissions); } if ($config->get('specific_permissions')) { $this->addSpecificPermissions($permissions); } return $permissions; } ...

INSTALLING FROM AN EXISTING INSTALLING FROM AN EXISTING CONFIGURATION CONFIGURATION

DGO.TO/ DGO.TO/CONFIG_INSTALLER CONFIG_INSTALLER

The Configuration Installer project provides a means to install a Drupal 8 site using existing configuration. This is not a module, Configuration Installer is an installation profile that loads configuration from a specified folder to 'install' the site. This is not a real installation profile either, it helps to install a real installation profile (e.g. minimal) along with an existing set of configuration

CMI CMI 2.0 2.0

Drupal 8's built-in config system is a HUGE step forward. However, now that the community has a couple of years of building Drupal 8 sites behind them, various limitations have surfaced: various common workflows are not natively supported; core's config APIs have missing functionality. While many of these problems have contrib workarounds, often these solutions can conflict with one another, and there's no one set of best practices that works for all

DGO.TO/ DGO.TO/CMI2 CMI2

QUESTIONS? QUESTIONS?

THANKS! THANKS! @OPDAVIES @OPDAVIES WWW.OLIVERDAVIES.UK WWW.OLIVERDAVIES.UK