Configuring all the Things (in Drupal 8)

Transcript

1. CONFIGURING ALL CONFIGURING ALL THE THINGS! THE THINGS! By Oliver Davies (@opdavies)
2. CONFIGURATION MANAGEMENT CONFIGURATION MANAGEMENT DRUPAL 8 DRUPAL 8
3. 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
4. WHAT IS WHAT IS CONFIGURATION? CONFIGURATION?
5. 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
6. THE CONFIGURATION MANAGEMENT THE CONFIGURATION MANAGEMENT INITIATIVE INITIATIVE
8. FEATURES FEATURES IN CORE IN CORE
9. FEATURES FEATURES IN CORE IN CORE
10. USING USING CONFIGURATION CONFIGURATION
11. <?php // Drupal 7 variable_set('mymodule_setting', $value); variable_get('mymodule_setting');
12. <?php // Drupal 8 $config = \Drupal::config('site.settings'); $config->get('page.front');
13. <?php class ExampleController { private $config; public function __construct( ConfigFactoryInterface $config_factory ) { $this->config = $config_factory->get('system.site'); } public function index() { $result = $this->config->get('page.front'); ... } }
14. IMPORTING AND EXPORTING IMPORTING AND EXPORTING CONFIGURATION CONFIGURATION
19. $ drush config-export $ drush config-import
20. $ drush config:export $ drush config:import
21. $ drupal config:export $ drupal config:export:single $ drupal config:import
22. <?php // web/sites/default/settings.php ... /** * Change the config export directory to * "/var/www/config/default". */ $config_directories[CONFIG_SYNC_DIRECTORY] = DRUPAL_ROOT . '/../config/default';
23. <?php // web/sites/default/settings.php ... /** * Change the config export directory to * "/var/www/config/default". */ $config_directories['sync'] = DRUPAL_ROOT . '/../config/default';
24. DEMO DEMO
25. OVERRIDING OVERRIDING CONFIGURATION CONFIGURATION
26. <?php // web/sites/default/default.settings.php ... /** * Configuration overrides. */ # $config['system.file']['path']['temporary'] = '/tmp'; # $config['system.site']['name'] = 'My Drupal site'; # $config['system.theme']['default'] = 'stark'; # $config['user.settings']['anonymous'] = 'Visitor';
27. <?php // web/sites/example.settings.local.php ... /** * Show all error messages, with backtrace information. */ $config['system.logging']['error_level'] = 'verbose'; /** * Disable CSS and JS aggregation. */ $config['system.performance']['css']['preprocess'] = FALSE; $config['system.performance']['js']['preprocess'] = FALSE;
28. SPLITTING SPLITTING CONFIGURATION CONFIGURATION
29. DGO.TO/ DGO.TO/CONFIG_SPLIT CONFIG_SPLIT
30. CONFIGURATION SPLIT CONFIGURATION SPLIT Different configuration directories One per 'split' Configuration per environment Active split set in settings.php
33. <?php // web/sites/default/settings.local.php ... /** * Enable the live split. */ $config['config_split.config_split.live']['status'] = TRUE;
34. IGNORING IGNORING CONFIGURATION CONFIGURATION
35. DGO.TO/ DGO.TO/CONFIG_IGNORE CONFIG_IGNORE
37. ADDING CONFIGURATION TO YOUR ADDING CONFIGURATION TO YOUR CUSTOM MODULES CUSTOM MODULES
38. # config/install/override_node_options.settings.yml general_permissions: true specific_permissions: true
39. # 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.'
40. // 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; } ... }
41. // 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); } }
42. // 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; } ...
43. INSTALLING FROM AN EXISTING INSTALLING FROM AN EXISTING CONFIGURATION CONFIGURATION
44. DGO.TO/ DGO.TO/CONFIG_INSTALLER CONFIG_INSTALLER
45. 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
46. CMI CMI 2.0 2.0
47. 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
48. DGO.TO/ DGO.TO/CMI2 CMI2
49. QUESTIONS? QUESTIONS?
50. THANKS! THANKS! @OPDAVIES @OPDAVIES WWW.OLIVERDAVIES.UK WWW.OLIVERDAVIES.UK