class Layout in Layout 8.2

Layout plugin derivative definition.

Derivatives are an associative array keyed by 'provider__layoutname' where provider is the module or theme name and layoutname is the .yml filename, such as 'bartik__page' or 'layout__one-col'. The values of the array are associative arrays themselves with metadata about the layout such as 'template', 'css', 'admin css' and so on.

Hierarchy

• class \Drupal\layout\Plugin\Derivative\Layout extends \Drupal\Component\Plugin\Derivative\DerivativeBase

2 string references to 'Layout'

layout.info.yml in ./layout.info.yml

layout.info.yml

LayoutDerivativesTest::getInfo in lib/Drupal/layout/Tests/LayoutDerivativesTest.php

File

lib/Drupal/layout/Plugin/Derivative/Layout.php, line 23

Definition of Drupal\layout\Plugin\Derivative\Layout.

Namespace

Drupal\layout\Plugin\Derivative

class Layout extends DerivativeBase {

  /**
   * Layout derivative type.
   *
   * Defines the subdirectory under ./layout where layout metadata is loooked
   * for. Overriding implementations should change this to look for other
   * types in a different subdirectory.
   *
   * @var string
   */
  protected $type = 'static';

  /**
   * {@inheritdoc}
   */
  public function getDerivativeDefinitions(array $base_plugin_definition) {
    $available_layout_providers = array();

    // Add all modules as possible layout providers.
    // @todo Inject the module handler.
    foreach (\Drupal::moduleHandler()
      ->getModuleList() as $module => $filename) {
      $available_layout_providers[$module] = array(
        'type' => 'module',
        'provider' => $module,
        'dir' => dirname($filename),
      );
    }

    // Add all themes as possible layout providers.
    foreach (list_themes() as $theme_id => $theme) {
      $available_layout_providers[$theme_id] = array(
        'type' => 'theme',
        'provider' => $theme->name,
        'dir' => drupal_get_path('theme', $theme->name),
      );
    }
    foreach ($available_layout_providers as $provider) {

      // Looks for layouts in the 'layout' directory under the module/theme.
      // There could be subdirectories under there with one layout defined
      // in each.
      $dir = $provider['dir'] . DIRECTORY_SEPARATOR . 'layouts' . DIRECTORY_SEPARATOR . $this->type;
      if (file_exists($dir)) {
        $this
          ->iterateDirectories($dir, $provider);
      }
    }
    return parent::getDerivativeDefinitions($base_plugin_definition);
  }

  /**
   * Finds layout definitions by looking for layout metadata.
   */
  protected function iterateDirectories($dir, $provider) {
    $directories = new DirectoryIterator($dir);
    foreach ($directories as $fileinfo) {
      if ($fileinfo
        ->isDir() && !$fileinfo
        ->isDot()) {

        // Keep discovering in subdirectories to arbitrary depth.
        $this
          ->iterateDirectories($fileinfo
          ->getPathname(), $provider);
      }
      elseif ($fileinfo
        ->isFile() && pathinfo($fileinfo
        ->getFilename(), PATHINFO_EXTENSION) == 'yml') {

        // Declarative layout definitions are defined with a .yml file in a
        // layout subdirectory. This provides all information about the layout
        // such as layout markup template and CSS and JavaScript files to use.
        $directory = new FileStorage($fileinfo
          ->getPath());
        $key = $provider['provider'] . '__' . $fileinfo
          ->getBasename('.yml');
        $this->derivatives[$key] = $directory
          ->read($fileinfo
          ->getBasename('.yml'));
        $this->derivatives[$key]['theme'] = $key;
        $this->derivatives[$key]['path'] = $fileinfo
          ->getPath();
        $this->derivatives[$key]['provider'] = $provider;

        // If the layout author didn't specify a template name, assume the same
        // name as the yml file.
        if (!isset($this->derivatives[$key]['template'])) {
          $this->derivatives[$key]['template'] = $fileinfo
            ->getBasename('.yml');
        }
      }
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Layout::$type	protected	property	Layout derivative type.
Layout::getDerivativeDefinitions	public	function
Layout::iterateDirectories	protected	function	Finds layout definitions by looking for layout metadata.