Chris@0: <?php
Chris@0: 
Chris@0: /**
Chris@0:  * @file
Chris@0:  * Provides hook implementations for Layout Discovery.
Chris@0:  */
Chris@0: 
Chris@0: use Drupal\Core\Render\Element;
Chris@0: use Drupal\Core\Template\Attribute;
Chris@0: 
Chris@0: /**
Chris@0:  * Implements hook_help().
Chris@0:  */
Chris@0: function layout_discovery_help($route_name) {
Chris@0:   switch ($route_name) {
Chris@0:     case 'help.page.layout_discovery':
Chris@0:       $output = '<h3>' . t('About') . '</h3>';
Chris@0:       $output .= '<p>' . t('Layout Discovery allows modules or themes to register layouts, and for other modules to list the available layouts and render them.') . '</p>';
Chris@0:       $output .= '<p>' . t('For more information, see the <a href=":layout-discovery-documentation">online documentation for the Layout Discovery module</a>.', [':layout-discovery-documentation' => 'https://www.drupal.org/docs/8/api/layout-api']) . '</p>';
Chris@0:       return $output;
Chris@0:   }
Chris@0: }
Chris@0: 
Chris@0: /**
Chris@0:  * Implements hook_theme().
Chris@0:  */
Chris@0: function layout_discovery_theme() {
Chris@0:   return \Drupal::service('plugin.manager.core.layout')->getThemeImplementations();
Chris@0: }
Chris@0: 
Chris@0: /**
Chris@0:  * Prepares variables for layout templates.
Chris@0:  *
Chris@0:  * @param array &$variables
Chris@0:  *   An associative array containing:
Chris@0:  *   - content: An associative array containing the properties of the element.
Chris@0:  *     Properties used: #settings, #layout.
Chris@0:  */
Chris@0: function template_preprocess_layout(&$variables) {
Chris@0:   $variables['settings'] = isset($variables['content']['#settings']) ? $variables['content']['#settings'] : [];
Chris@0:   $variables['layout'] = isset($variables['content']['#layout']) ? $variables['content']['#layout'] : [];
Chris@0: 
Chris@0:   // Create an attributes variable for each region.
Chris@0:   foreach (Element::children($variables['content']) as $name) {
Chris@0:     if (!isset($variables['content'][$name]['#attributes'])) {
Chris@0:       $variables['content'][$name]['#attributes'] = [];
Chris@0:     }
Chris@0:     $variables['region_attributes'][$name] = new Attribute($variables['content'][$name]['#attributes']);
Chris@0:   }
Chris@0: }